control.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326
  1. /* Copyright (c) 2001 Matej Pfajfar.
  2. * Copyright (c) 2001-2004, Roger Dingledine.
  3. * Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
  4. * Copyright (c) 2007-2017, The Tor Project, Inc. */
  5. /* See LICENSE for licensing information */
  6. /**
  7. * \file control.h
  8. * \brief Header file for control.c.
  9. **/
  10. #ifndef TOR_CONTROL_H
  11. #define TOR_CONTROL_H
  12. void control_initialize_event_queue(void);
  13. void control_update_global_event_mask(void);
  14. void control_adjust_event_log_severity(void);
  15. void control_ports_write_to_file(void);
  16. /** Log information about the connection <b>conn</b>, protecting it as with
  17. * CONN_LOG_PROTECT. Example:
  18. *
  19. * LOG_FN_CONN(conn, (LOG_DEBUG, "Socket %d wants to write", conn->s));
  20. **/
  21. #define LOG_FN_CONN(conn, args) \
  22. CONN_LOG_PROTECT(conn, log_fn args)
  23. #define CC_LOCAL_FD_IS_OWNER (1u<<0)
  24. #define CC_LOCAL_FD_IS_AUTHENTICATED (1u<<1)
  25. int control_connection_add_local_fd(tor_socket_t sock, unsigned flags);
  26. int connection_control_finished_flushing(control_connection_t *conn);
  27. int connection_control_reached_eof(control_connection_t *conn);
  28. void connection_control_closed(control_connection_t *conn);
  29. int connection_control_process_inbuf(control_connection_t *conn);
  30. #define EVENT_NS 0x000F
  31. int control_event_is_interesting(int event);
  32. void control_per_second_events(void);
  33. int control_any_per_second_event_enabled(void);
  34. int control_event_circuit_status(origin_circuit_t *circ,
  35. circuit_status_event_t e, int reason);
  36. int control_event_circuit_purpose_changed(origin_circuit_t *circ,
  37. int old_purpose);
  38. int control_event_circuit_cannibalized(origin_circuit_t *circ,
  39. int old_purpose,
  40. const struct timeval *old_tv_created);
  41. int control_event_stream_status(entry_connection_t *conn,
  42. stream_status_event_t e,
  43. int reason);
  44. int control_event_or_conn_status(or_connection_t *conn,
  45. or_conn_status_event_t e, int reason);
  46. int control_event_bandwidth_used(uint32_t n_read, uint32_t n_written);
  47. int control_event_stream_bandwidth(edge_connection_t *edge_conn);
  48. int control_event_stream_bandwidth_used(void);
  49. int control_event_circ_bandwidth_used(void);
  50. int control_event_conn_bandwidth(connection_t *conn);
  51. int control_event_conn_bandwidth_used(void);
  52. int control_event_circuit_cell_stats(void);
  53. void control_event_logmsg(int severity, uint32_t domain, const char *msg);
  54. void control_event_logmsg_pending(void);
  55. int control_event_descriptors_changed(smartlist_t *routers);
  56. int control_event_address_mapped(const char *from, const char *to,
  57. time_t expires, const char *error,
  58. const int cached);
  59. int control_event_my_descriptor_changed(void);
  60. int control_event_network_liveness_update(int liveness);
  61. int control_event_networkstatus_changed(smartlist_t *statuses);
  62. int control_event_newconsensus(const networkstatus_t *consensus);
  63. int control_event_networkstatus_changed_single(const routerstatus_t *rs);
  64. int control_event_general_status(int severity, const char *format, ...)
  65. CHECK_PRINTF(2,3);
  66. int control_event_client_status(int severity, const char *format, ...)
  67. CHECK_PRINTF(2,3);
  68. int control_event_server_status(int severity, const char *format, ...)
  69. CHECK_PRINTF(2,3);
  70. int control_event_general_error(const char *format, ...)
  71. CHECK_PRINTF(1,2);
  72. int control_event_client_error(const char *format, ...)
  73. CHECK_PRINTF(1,2);
  74. int control_event_server_error(const char *format, ...)
  75. CHECK_PRINTF(1,2);
  76. int control_event_guard(const char *nickname, const char *digest,
  77. const char *status);
  78. int control_event_conf_changed(const smartlist_t *elements);
  79. int control_event_buildtimeout_set(buildtimeout_set_event_t type,
  80. const char *args);
  81. int control_event_signal(uintptr_t signal);
  82. int init_control_cookie_authentication(int enabled);
  83. char *get_controller_cookie_file_name(void);
  84. smartlist_t *decode_hashed_passwords(config_line_t *passwords);
  85. void disable_control_logging(void);
  86. void enable_control_logging(void);
  87. void monitor_owning_controller_process(const char *process_spec);
  88. int control_event_bootstrap(bootstrap_status_t status, int progress);
  89. MOCK_DECL(void, control_event_bootstrap_prob_or,(const char *warn,
  90. int reason,
  91. or_connection_t *or_conn));
  92. void control_event_bootstrap_problem(const char *warn, const char *reason,
  93. const connection_t *conn, int dowarn);
  94. void control_event_clients_seen(const char *controller_str);
  95. void control_event_transport_launched(const char *mode,
  96. const char *transport_name,
  97. tor_addr_t *addr, uint16_t port);
  98. const char *rend_auth_type_to_string(rend_auth_type_t auth_type);
  99. MOCK_DECL(const char *, node_describe_longname_by_id,(const char *id_digest));
  100. void control_event_hs_descriptor_requested(const char *onion_address,
  101. rend_auth_type_t auth_type,
  102. const char *id_digest,
  103. const char *desc_id,
  104. const char *hsdir_index);
  105. void control_event_hs_descriptor_created(const char *onion_address,
  106. const char *desc_id,
  107. int replica);
  108. void control_event_hs_descriptor_upload(const char *onion_address,
  109. const char *desc_id,
  110. const char *hs_dir,
  111. const char *hsdir_index);
  112. void control_event_hs_descriptor_upload_end(const char *action,
  113. const char *onion_address,
  114. const char *hs_dir,
  115. const char *reason);
  116. void control_event_hs_descriptor_uploaded(const char *hs_dir,
  117. const char *onion_address);
  118. /* Hidden service v2 HS_DESC specific. */
  119. void control_event_hsv2_descriptor_failed(const rend_data_t *rend_data,
  120. const char *id_digest,
  121. const char *reason);
  122. void control_event_hsv2_descriptor_received(const char *onion_address,
  123. const rend_data_t *rend_data,
  124. const char *id_digest);
  125. /* Hidden service v3 HS_DESC specific. */
  126. void control_event_hsv3_descriptor_failed(const char *onion_address,
  127. const char *desc_id,
  128. const char *hsdir_id_digest,
  129. const char *reason);
  130. void control_event_hsv3_descriptor_received(const char *onion_address,
  131. const char *desc_id,
  132. const char *hsdir_id_digest);
  133. void control_event_hs_descriptor_upload_failed(const char *hs_dir,
  134. const char *onion_address,
  135. const char *reason);
  136. void control_event_hs_descriptor_content(const char *onion_address,
  137. const char *desc_id,
  138. const char *hsdir_fp,
  139. const char *content);
  140. void control_free_all(void);
  141. #ifdef CONTROL_PRIVATE
  142. /* Recognized asynchronous event types. It's okay to expand this list
  143. * because it is used both as a list of v0 event types, and as indices
  144. * into the bitfield to determine which controllers want which events.
  145. */
  146. /* This bitfield has no event zero 0x0000 */
  147. #define EVENT_MIN_ 0x0001
  148. #define EVENT_CIRCUIT_STATUS 0x0001
  149. #define EVENT_STREAM_STATUS 0x0002
  150. #define EVENT_OR_CONN_STATUS 0x0003
  151. #define EVENT_BANDWIDTH_USED 0x0004
  152. #define EVENT_CIRCUIT_STATUS_MINOR 0x0005
  153. #define EVENT_NEW_DESC 0x0006
  154. #define EVENT_DEBUG_MSG 0x0007
  155. #define EVENT_INFO_MSG 0x0008
  156. #define EVENT_NOTICE_MSG 0x0009
  157. #define EVENT_WARN_MSG 0x000A
  158. #define EVENT_ERR_MSG 0x000B
  159. #define EVENT_ADDRMAP 0x000C
  160. /* There was an AUTHDIR_NEWDESCS event, but it no longer exists. We
  161. can reclaim 0x000D. */
  162. #define EVENT_DESCCHANGED 0x000E
  163. /* Exposed above */
  164. // #define EVENT_NS 0x000F
  165. #define EVENT_STATUS_CLIENT 0x0010
  166. #define EVENT_STATUS_SERVER 0x0011
  167. #define EVENT_STATUS_GENERAL 0x0012
  168. #define EVENT_GUARD 0x0013
  169. #define EVENT_STREAM_BANDWIDTH_USED 0x0014
  170. #define EVENT_CLIENTS_SEEN 0x0015
  171. #define EVENT_NEWCONSENSUS 0x0016
  172. #define EVENT_BUILDTIMEOUT_SET 0x0017
  173. #define EVENT_GOT_SIGNAL 0x0018
  174. #define EVENT_CONF_CHANGED 0x0019
  175. #define EVENT_CONN_BW 0x001A
  176. #define EVENT_CELL_STATS 0x001B
  177. /* UNUSED : 0x001C */
  178. #define EVENT_CIRC_BANDWIDTH_USED 0x001D
  179. #define EVENT_TRANSPORT_LAUNCHED 0x0020
  180. #define EVENT_HS_DESC 0x0021
  181. #define EVENT_HS_DESC_CONTENT 0x0022
  182. #define EVENT_NETWORK_LIVENESS 0x0023
  183. #define EVENT_MAX_ 0x0023
  184. /* sizeof(control_connection_t.event_mask) in bits, currently a uint64_t */
  185. #define EVENT_CAPACITY_ 0x0040
  186. /* If EVENT_MAX_ ever hits 0x0040, we need to make the mask into a
  187. * different structure, as it can only handle a maximum left shift of 1<<63. */
  188. #if EVENT_MAX_ >= EVENT_CAPACITY_
  189. #error control_connection_t.event_mask has an event greater than its capacity
  190. #endif
  191. #define EVENT_MASK_(e) (((uint64_t)1)<<(e))
  192. #define EVENT_MASK_NONE_ ((uint64_t)0x0)
  193. #define EVENT_MASK_ABOVE_MIN_ ((~((uint64_t)0x0)) << EVENT_MIN_)
  194. #define EVENT_MASK_BELOW_MAX_ ((~((uint64_t)0x0)) \
  195. >> (EVENT_CAPACITY_ - EVENT_MAX_ \
  196. - EVENT_MIN_))
  197. #define EVENT_MASK_ALL_ (EVENT_MASK_ABOVE_MIN_ \
  198. & EVENT_MASK_BELOW_MAX_)
  199. /* Used only by control.c and test.c */
  200. STATIC size_t write_escaped_data(const char *data, size_t len, char **out);
  201. STATIC size_t read_escaped_data(const char *data, size_t len, char **out);
  202. #ifdef TOR_UNIT_TESTS
  203. MOCK_DECL(STATIC void,
  204. send_control_event_string,(uint16_t event, const char *msg));
  205. MOCK_DECL(STATIC void,
  206. queue_control_event_string,(uint16_t event, char *msg));
  207. void control_testing_set_global_event_mask(uint64_t mask);
  208. #endif /* defined(TOR_UNIT_TESTS) */
  209. /** Helper structure: temporarily stores cell statistics for a circuit. */
  210. typedef struct cell_stats_t {
  211. /** Number of cells added in app-ward direction by command. */
  212. uint64_t added_cells_appward[CELL_COMMAND_MAX_ + 1];
  213. /** Number of cells added in exit-ward direction by command. */
  214. uint64_t added_cells_exitward[CELL_COMMAND_MAX_ + 1];
  215. /** Number of cells removed in app-ward direction by command. */
  216. uint64_t removed_cells_appward[CELL_COMMAND_MAX_ + 1];
  217. /** Number of cells removed in exit-ward direction by command. */
  218. uint64_t removed_cells_exitward[CELL_COMMAND_MAX_ + 1];
  219. /** Total waiting time of cells in app-ward direction by command. */
  220. uint64_t total_time_appward[CELL_COMMAND_MAX_ + 1];
  221. /** Total waiting time of cells in exit-ward direction by command. */
  222. uint64_t total_time_exitward[CELL_COMMAND_MAX_ + 1];
  223. } cell_stats_t;
  224. void sum_up_cell_stats_by_command(circuit_t *circ,
  225. cell_stats_t *cell_stats);
  226. void append_cell_stats_by_command(smartlist_t *event_parts,
  227. const char *key,
  228. const uint64_t *include_if_non_zero,
  229. const uint64_t *number_to_include);
  230. void format_cell_stats(char **event_string, circuit_t *circ,
  231. cell_stats_t *cell_stats);
  232. STATIC char *get_bw_samples(void);
  233. /* ADD_ONION secret key to create an ephemeral service. The command supports
  234. * multiple versions so this union stores the key and passes it to the HS
  235. * subsystem depending on the requested version. */
  236. typedef union add_onion_secret_key_t {
  237. /* Hidden service v2 secret key. */
  238. crypto_pk_t *v2;
  239. /* Hidden service v3 secret key. */
  240. ed25519_secret_key_t *v3;
  241. } add_onion_secret_key_t;
  242. STATIC int add_onion_helper_keyarg(const char *arg, int discard_pk,
  243. const char **key_new_alg_out,
  244. char **key_new_blob_out,
  245. add_onion_secret_key_t *decoded_key,
  246. int *hs_version, char **err_msg_out);
  247. STATIC rend_authorized_client_t *
  248. add_onion_helper_clientauth(const char *arg, int *created, char **err_msg_out);
  249. STATIC int getinfo_helper_onions(
  250. control_connection_t *control_conn,
  251. const char *question,
  252. char **answer,
  253. const char **errmsg);
  254. STATIC void getinfo_helper_downloads_networkstatus(
  255. const char *flavor,
  256. download_status_t **dl_to_emit,
  257. const char **errmsg);
  258. STATIC void getinfo_helper_downloads_cert(
  259. const char *fp_sk_req,
  260. download_status_t **dl_to_emit,
  261. smartlist_t **digest_list,
  262. const char **errmsg);
  263. STATIC void getinfo_helper_downloads_desc(
  264. const char *desc_req,
  265. download_status_t **dl_to_emit,
  266. smartlist_t **digest_list,
  267. const char **errmsg);
  268. STATIC void getinfo_helper_downloads_bridge(
  269. const char *bridge_req,
  270. download_status_t **dl_to_emit,
  271. smartlist_t **digest_list,
  272. const char **errmsg);
  273. STATIC int getinfo_helper_downloads(
  274. control_connection_t *control_conn,
  275. const char *question, char **answer,
  276. const char **errmsg);
  277. STATIC int getinfo_helper_dir(
  278. control_connection_t *control_conn,
  279. const char *question, char **answer,
  280. const char **errmsg);
  281. STATIC int getinfo_helper_current_time(
  282. control_connection_t *control_conn,
  283. const char *question, char **answer,
  284. const char **errmsg);
  285. #endif /* defined(CONTROL_PRIVATE) */
  286. #endif /* !defined(TOR_CONTROL_H) */