circuitbuild.h 4.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  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 circuitbuild.h
  8. * \brief Header file for circuitbuild.c.
  9. **/
  10. #ifndef TOR_CIRCUITBUILD_H
  11. #define TOR_CIRCUITBUILD_H
  12. int route_len_for_purpose(uint8_t purpose, extend_info_t *exit_ei);
  13. char *circuit_list_path(origin_circuit_t *circ, int verbose);
  14. char *circuit_list_path_for_controller(origin_circuit_t *circ);
  15. void circuit_log_path(int severity, unsigned int domain,
  16. origin_circuit_t *circ);
  17. void circuit_rep_hist_note_result(origin_circuit_t *circ);
  18. origin_circuit_t *origin_circuit_init(uint8_t purpose, int flags);
  19. origin_circuit_t *circuit_establish_circuit(uint8_t purpose,
  20. extend_info_t *exit,
  21. int flags);
  22. struct circuit_guard_state_t *origin_circuit_get_guard_state(
  23. origin_circuit_t *circ);
  24. int circuit_handle_first_hop(origin_circuit_t *circ);
  25. void circuit_n_chan_done(channel_t *chan, int status,
  26. int close_origin_circuits);
  27. int inform_testing_reachability(void);
  28. int circuit_timeout_want_to_count_circ(const origin_circuit_t *circ);
  29. int circuit_send_next_onion_skin(origin_circuit_t *circ);
  30. void circuit_note_clock_jumped(int seconds_elapsed);
  31. int circuit_extend(cell_t *cell, circuit_t *circ);
  32. int circuit_init_cpath_crypto(crypt_path_t *cpath,
  33. const char *key_data, size_t key_data_len,
  34. int reverse, int is_hs_v3);
  35. struct created_cell_t;
  36. int circuit_finish_handshake(origin_circuit_t *circ,
  37. const struct created_cell_t *created_cell);
  38. int circuit_truncated(origin_circuit_t *circ, crypt_path_t *layer,
  39. int reason);
  40. int onionskin_answer(or_circuit_t *circ,
  41. const struct created_cell_t *created_cell,
  42. const char *keys, size_t keys_len,
  43. const uint8_t *rend_circ_nonce);
  44. MOCK_DECL(int, circuit_all_predicted_ports_handled, (time_t now,
  45. int *need_uptime,
  46. int *need_capacity));
  47. int circuit_append_new_exit(origin_circuit_t *circ, extend_info_t *info);
  48. int circuit_extend_to_new_exit(origin_circuit_t *circ, extend_info_t *info);
  49. void onion_append_to_cpath(crypt_path_t **head_ptr, crypt_path_t *new_hop);
  50. extend_info_t *extend_info_new(const char *nickname,
  51. const char *rsa_id_digest,
  52. const ed25519_public_key_t *ed_id,
  53. crypto_pk_t *onion_key,
  54. const curve25519_public_key_t *ntor_key,
  55. const tor_addr_t *addr, uint16_t port);
  56. extend_info_t *extend_info_from_node(const node_t *r, int for_direct_connect);
  57. extend_info_t *extend_info_dup(extend_info_t *info);
  58. void extend_info_free_(extend_info_t *info);
  59. #define extend_info_free(info) \
  60. FREE_AND_NULL(extend_info_t, extend_info_free_, (info))
  61. int extend_info_addr_is_allowed(const tor_addr_t *addr);
  62. int extend_info_supports_tap(const extend_info_t* ei);
  63. int extend_info_supports_ntor(const extend_info_t* ei);
  64. int circuit_can_use_tap(const origin_circuit_t *circ);
  65. int circuit_has_usable_onion_key(const origin_circuit_t *circ);
  66. int extend_info_has_preferred_onion_key(const extend_info_t* ei);
  67. const uint8_t *build_state_get_exit_rsa_id(cpath_build_state_t *state);
  68. const node_t *build_state_get_exit_node(cpath_build_state_t *state);
  69. const char *build_state_get_exit_nickname(cpath_build_state_t *state);
  70. struct circuit_guard_state_t;
  71. const node_t *choose_good_entry_server(uint8_t purpose,
  72. cpath_build_state_t *state,
  73. struct circuit_guard_state_t **guard_state_out);
  74. void circuit_upgrade_circuits_from_guard_wait(void);
  75. #ifdef CIRCUITBUILD_PRIVATE
  76. STATIC circid_t get_unique_circ_id_by_chan(channel_t *chan);
  77. STATIC int new_route_len(uint8_t purpose, extend_info_t *exit_ei,
  78. smartlist_t *nodes);
  79. MOCK_DECL(STATIC int, count_acceptable_nodes, (smartlist_t *nodes));
  80. #if defined(ENABLE_TOR2WEB_MODE) || defined(TOR_UNIT_TESTS)
  81. STATIC const node_t *pick_tor2web_rendezvous_node(router_crn_flags_t flags,
  82. const or_options_t *options);
  83. unsigned int cpath_get_n_hops(crypt_path_t **head_ptr);
  84. #endif /* defined(ENABLE_TOR2WEB_MODE) || defined(TOR_UNIT_TESTS) */
  85. #endif /* defined(CIRCUITBUILD_PRIVATE) */
  86. #endif /* !defined(TOR_CIRCUITBUILD_H) */