control.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292
  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-2016, 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. int connection_control_finished_flushing(control_connection_t *conn);
  24. int connection_control_reached_eof(control_connection_t *conn);
  25. void connection_control_closed(control_connection_t *conn);
  26. int connection_control_process_inbuf(control_connection_t *conn);
  27. #define EVENT_AUTHDIR_NEWDESCS 0x000D
  28. #define EVENT_NS 0x000F
  29. int control_event_is_interesting(int event);
  30. int control_event_circuit_status(origin_circuit_t *circ,
  31. circuit_status_event_t e, int reason);
  32. int control_event_circuit_purpose_changed(origin_circuit_t *circ,
  33. int old_purpose);
  34. int control_event_circuit_cannibalized(origin_circuit_t *circ,
  35. int old_purpose,
  36. const struct timeval *old_tv_created);
  37. int control_event_stream_status(entry_connection_t *conn,
  38. stream_status_event_t e,
  39. int reason);
  40. int control_event_or_conn_status(or_connection_t *conn,
  41. or_conn_status_event_t e, int reason);
  42. int control_event_bandwidth_used(uint32_t n_read, uint32_t n_written);
  43. int control_event_stream_bandwidth(edge_connection_t *edge_conn);
  44. int control_event_stream_bandwidth_used(void);
  45. int control_event_circ_bandwidth_used(void);
  46. int control_event_conn_bandwidth(connection_t *conn);
  47. int control_event_conn_bandwidth_used(void);
  48. int control_event_circuit_cell_stats(void);
  49. int control_event_tb_empty(const char *bucket, uint32_t read_empty_time,
  50. uint32_t write_empty_time,
  51. int milliseconds_elapsed);
  52. void control_event_logmsg(int severity, uint32_t domain, const char *msg);
  53. int control_event_descriptors_changed(smartlist_t *routers);
  54. int control_event_address_mapped(const char *from, const char *to,
  55. time_t expires, const char *error,
  56. const int cached);
  57. int control_event_or_authdir_new_descriptor(const char *action,
  58. const char *desc,
  59. size_t desclen,
  60. const char *msg);
  61. int control_event_my_descriptor_changed(void);
  62. int control_event_network_liveness_update(int liveness);
  63. int control_event_networkstatus_changed(smartlist_t *statuses);
  64. int control_event_newconsensus(const networkstatus_t *consensus);
  65. int control_event_networkstatus_changed_single(const routerstatus_t *rs);
  66. int control_event_general_status(int severity, const char *format, ...)
  67. CHECK_PRINTF(2,3);
  68. int control_event_client_status(int severity, const char *format, ...)
  69. CHECK_PRINTF(2,3);
  70. int control_event_server_status(int severity, const char *format, ...)
  71. CHECK_PRINTF(2,3);
  72. int control_event_general_error(const char *format, ...)
  73. CHECK_PRINTF(1,2);
  74. int control_event_client_error(const char *format, ...)
  75. CHECK_PRINTF(1,2);
  76. int control_event_server_error(const char *format, ...)
  77. CHECK_PRINTF(1,2);
  78. int control_event_guard(const char *nickname, const char *digest,
  79. const char *status);
  80. int control_event_conf_changed(const smartlist_t *elements);
  81. int control_event_buildtimeout_set(buildtimeout_set_event_t type,
  82. const char *args);
  83. int control_event_signal(uintptr_t signal);
  84. int init_control_cookie_authentication(int enabled);
  85. char *get_controller_cookie_file_name(void);
  86. smartlist_t *decode_hashed_passwords(config_line_t *passwords);
  87. void disable_control_logging(void);
  88. void enable_control_logging(void);
  89. void monitor_owning_controller_process(const char *process_spec);
  90. int control_event_bootstrap(bootstrap_status_t status, int progress);
  91. MOCK_DECL(void, control_event_bootstrap_problem,(const char *warn,
  92. int reason,
  93. or_connection_t *or_conn));
  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 rend_data_t *rend_query,
  101. const char *desc_id_base32,
  102. const char *hs_dir);
  103. void control_event_hs_descriptor_created(const char *service_id,
  104. const char *desc_id_base32,
  105. int replica);
  106. void control_event_hs_descriptor_upload(const char *service_id,
  107. const char *desc_id_base32,
  108. const char *hs_dir);
  109. void control_event_hs_descriptor_receive_end(const char *action,
  110. const char *onion_address,
  111. const rend_data_t *rend_data,
  112. const char *id_digest,
  113. const char *reason);
  114. void control_event_hs_descriptor_upload_end(const char *action,
  115. const char *onion_address,
  116. const char *hs_dir,
  117. const char *reason);
  118. void control_event_hs_descriptor_received(const char *onion_address,
  119. const rend_data_t *rend_data,
  120. const char *id_digest);
  121. void control_event_hs_descriptor_uploaded(const char *hs_dir,
  122. const char *onion_address);
  123. void control_event_hs_descriptor_failed(const rend_data_t *rend_data,
  124. const char *id_digest,
  125. const char *reason);
  126. void control_event_hs_descriptor_upload_failed(const char *hs_dir,
  127. const char *onion_address,
  128. const char *reason);
  129. void control_event_hs_descriptor_content(const char *onion_address,
  130. const char *desc_id,
  131. const char *hsdir_fp,
  132. const char *content);
  133. void control_free_all(void);
  134. #ifdef CONTROL_PRIVATE
  135. /* Recognized asynchronous event types. It's okay to expand this list
  136. * because it is used both as a list of v0 event types, and as indices
  137. * into the bitfield to determine which controllers want which events.
  138. */
  139. /* This bitfield has no event zero 0x0000 */
  140. #define EVENT_MIN_ 0x0001
  141. #define EVENT_CIRCUIT_STATUS 0x0001
  142. #define EVENT_STREAM_STATUS 0x0002
  143. #define EVENT_OR_CONN_STATUS 0x0003
  144. #define EVENT_BANDWIDTH_USED 0x0004
  145. #define EVENT_CIRCUIT_STATUS_MINOR 0x0005
  146. #define EVENT_NEW_DESC 0x0006
  147. #define EVENT_DEBUG_MSG 0x0007
  148. #define EVENT_INFO_MSG 0x0008
  149. #define EVENT_NOTICE_MSG 0x0009
  150. #define EVENT_WARN_MSG 0x000A
  151. #define EVENT_ERR_MSG 0x000B
  152. #define EVENT_ADDRMAP 0x000C
  153. /* Exposed above */
  154. // #define EVENT_AUTHDIR_NEWDESCS 0x000D
  155. #define EVENT_DESCCHANGED 0x000E
  156. /* Exposed above */
  157. // #define EVENT_NS 0x000F
  158. #define EVENT_STATUS_CLIENT 0x0010
  159. #define EVENT_STATUS_SERVER 0x0011
  160. #define EVENT_STATUS_GENERAL 0x0012
  161. #define EVENT_GUARD 0x0013
  162. #define EVENT_STREAM_BANDWIDTH_USED 0x0014
  163. #define EVENT_CLIENTS_SEEN 0x0015
  164. #define EVENT_NEWCONSENSUS 0x0016
  165. #define EVENT_BUILDTIMEOUT_SET 0x0017
  166. #define EVENT_GOT_SIGNAL 0x0018
  167. #define EVENT_CONF_CHANGED 0x0019
  168. #define EVENT_CONN_BW 0x001A
  169. #define EVENT_CELL_STATS 0x001B
  170. #define EVENT_TB_EMPTY 0x001C
  171. #define EVENT_CIRC_BANDWIDTH_USED 0x001D
  172. #define EVENT_TRANSPORT_LAUNCHED 0x0020
  173. #define EVENT_HS_DESC 0x0021
  174. #define EVENT_HS_DESC_CONTENT 0x0022
  175. #define EVENT_NETWORK_LIVENESS 0x0023
  176. #define EVENT_MAX_ 0x0023
  177. /* sizeof(control_connection_t.event_mask) in bits, currently a uint64_t */
  178. #define EVENT_CAPACITY_ 0x0040
  179. /* If EVENT_MAX_ ever hits 0x0040, we need to make the mask into a
  180. * different structure, as it can only handle a maximum left shift of 1<<63. */
  181. #if EVENT_MAX_ >= EVENT_CAPACITY_
  182. #error control_connection_t.event_mask has an event greater than its capacity
  183. #endif
  184. #define EVENT_MASK_(e) (((uint64_t)1)<<(e))
  185. #define EVENT_MASK_NONE_ ((uint64_t)0x0)
  186. #define EVENT_MASK_ABOVE_MIN_ ((~((uint64_t)0x0)) << EVENT_MIN_)
  187. #define EVENT_MASK_BELOW_MAX_ ((~((uint64_t)0x0)) \
  188. >> (EVENT_CAPACITY_ - EVENT_MAX_ \
  189. - EVENT_MIN_))
  190. #define EVENT_MASK_ALL_ (EVENT_MASK_ABOVE_MIN_ \
  191. & EVENT_MASK_BELOW_MAX_)
  192. /* Used only by control.c and test.c */
  193. STATIC size_t write_escaped_data(const char *data, size_t len, char **out);
  194. STATIC size_t read_escaped_data(const char *data, size_t len, char **out);
  195. #ifdef TOR_UNIT_TESTS
  196. MOCK_DECL(STATIC void,
  197. send_control_event_string,(uint16_t event, const char *msg));
  198. MOCK_DECL(STATIC void,
  199. queue_control_event_string,(uint16_t event, char *msg));
  200. void control_testing_set_global_event_mask(uint64_t mask);
  201. #endif
  202. /** Helper structure: temporarily stores cell statistics for a circuit. */
  203. typedef struct cell_stats_t {
  204. /** Number of cells added in app-ward direction by command. */
  205. uint64_t added_cells_appward[CELL_COMMAND_MAX_ + 1];
  206. /** Number of cells added in exit-ward direction by command. */
  207. uint64_t added_cells_exitward[CELL_COMMAND_MAX_ + 1];
  208. /** Number of cells removed in app-ward direction by command. */
  209. uint64_t removed_cells_appward[CELL_COMMAND_MAX_ + 1];
  210. /** Number of cells removed in exit-ward direction by command. */
  211. uint64_t removed_cells_exitward[CELL_COMMAND_MAX_ + 1];
  212. /** Total waiting time of cells in app-ward direction by command. */
  213. uint64_t total_time_appward[CELL_COMMAND_MAX_ + 1];
  214. /** Total waiting time of cells in exit-ward direction by command. */
  215. uint64_t total_time_exitward[CELL_COMMAND_MAX_ + 1];
  216. } cell_stats_t;
  217. void sum_up_cell_stats_by_command(circuit_t *circ,
  218. cell_stats_t *cell_stats);
  219. void append_cell_stats_by_command(smartlist_t *event_parts,
  220. const char *key,
  221. const uint64_t *include_if_non_zero,
  222. const uint64_t *number_to_include);
  223. void format_cell_stats(char **event_string, circuit_t *circ,
  224. cell_stats_t *cell_stats);
  225. STATIC char *get_bw_samples(void);
  226. STATIC crypto_pk_t *add_onion_helper_keyarg(const char *arg, int discard_pk,
  227. const char **key_new_alg_out,
  228. char **key_new_blob_out,
  229. char **err_msg_out);
  230. STATIC rend_authorized_client_t *
  231. add_onion_helper_clientauth(const char *arg, int *created, char **err_msg_out);
  232. STATIC void getinfo_helper_downloads_networkstatus(
  233. const char *flavor,
  234. download_status_t **dl_to_emit,
  235. const char **errmsg);
  236. STATIC void getinfo_helper_downloads_cert(
  237. const char *fp_sk_req,
  238. download_status_t **dl_to_emit,
  239. smartlist_t **digest_list,
  240. const char **errmsg);
  241. STATIC void getinfo_helper_downloads_desc(
  242. const char *desc_req,
  243. download_status_t **dl_to_emit,
  244. smartlist_t **digest_list,
  245. const char **errmsg);
  246. STATIC void getinfo_helper_downloads_bridge(
  247. const char *bridge_req,
  248. download_status_t **dl_to_emit,
  249. smartlist_t **digest_list,
  250. const char **errmsg);
  251. STATIC int getinfo_helper_downloads(
  252. control_connection_t *control_conn,
  253. const char *question, char **answer,
  254. const char **errmsg);
  255. #endif
  256. #endif