tor  master
circuitbuild.h
Go to the documentation of this file.
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 
12 #ifndef TOR_CIRCUITBUILD_H
13 #define TOR_CIRCUITBUILD_H
14 
15 int route_len_for_purpose(uint8_t purpose, extend_info_t *exit_ei);
16 char *circuit_list_path(origin_circuit_t *circ, int verbose);
18 void circuit_log_path(int severity, unsigned int domain,
19  origin_circuit_t *circ);
20 origin_circuit_t *origin_circuit_init(uint8_t purpose, int flags);
22  extend_info_t *exit,
23  int flags);
24 struct circuit_guard_state_t *origin_circuit_get_guard_state(
25  origin_circuit_t *circ);
27 void circuit_n_chan_done(channel_t *chan, int status,
28  int close_origin_circuits);
32 void circuit_note_clock_jumped(int64_t seconds_elapsed, bool was_idle);
33 int circuit_extend(cell_t *cell, circuit_t *circ);
35  const char *key_data, size_t key_data_len,
36  int reverse, int is_hs_v3);
37 struct created_cell_t;
39  const struct created_cell_t *created_cell);
41  int reason);
43  const struct created_cell_t *created_cell,
44  const char *keys, size_t keys_len,
45  const uint8_t *rend_circ_nonce);
46 MOCK_DECL(int, circuit_all_predicted_ports_handled, (time_t now,
47  int *need_uptime,
48  int *need_capacity));
49 
52 void onion_append_to_cpath(crypt_path_t **head_ptr, crypt_path_t *new_hop);
53 extend_info_t *extend_info_new(const char *nickname,
54  const char *rsa_id_digest,
55  const ed25519_public_key_t *ed_id,
56  crypto_pk_t *onion_key,
57  const curve25519_public_key_t *ntor_key,
58  const tor_addr_t *addr, uint16_t port);
59 extend_info_t *extend_info_from_node(const node_t *r, int for_direct_connect);
62 #define extend_info_free(info) \
63  FREE_AND_NULL(extend_info_t, extend_info_free_, (info))
65 int extend_info_supports_tap(const extend_info_t* ei);
66 int extend_info_supports_ntor(const extend_info_t* ei);
67 int circuit_can_use_tap(const origin_circuit_t *circ);
68 int circuit_has_usable_onion_key(const origin_circuit_t *circ);
69 int extend_info_has_preferred_onion_key(const extend_info_t* ei);
73 
74 struct circuit_guard_state_t;
75 
76 const node_t *choose_good_entry_server(uint8_t purpose,
77  cpath_build_state_t *state,
78  struct circuit_guard_state_t **guard_state_out);
80 
81 #ifdef CIRCUITBUILD_PRIVATE
83 STATIC int new_route_len(uint8_t purpose, extend_info_t *exit_ei,
84  smartlist_t *nodes);
85 MOCK_DECL(STATIC int, count_acceptable_nodes, (smartlist_t *nodes));
86 
87 STATIC int onion_extend_cpath(origin_circuit_t *circ);
88 
89 STATIC int
91  int is_hs_v3_rp_circuit);
92 
93 #if defined(ENABLE_TOR2WEB_MODE) || defined(TOR_UNIT_TESTS)
94 STATIC const node_t *pick_tor2web_rendezvous_node(router_crn_flags_t flags,
95  const or_options_t *options);
96 unsigned int cpath_get_n_hops(crypt_path_t **head_ptr);
97 
98 #endif /* defined(ENABLE_TOR2WEB_MODE) || defined(TOR_UNIT_TESTS) */
99 
100 #endif /* defined(CIRCUITBUILD_PRIVATE) */
101 
102 #endif /* !defined(TOR_CIRCUITBUILD_H) */
103 
Definition: or.h:3657
Definition: or.h:3476
Definition: or.h:2504
int circuit_append_new_exit(origin_circuit_t *circ, extend_info_t *info)
Definition: circuitbuild.c:2345
Definition: or.h:2928
int circuit_send_next_onion_skin(origin_circuit_t *circ)
Definition: circuitbuild.c:901
Definition: crypto_ed25519.h:23
void extend_info_free_(extend_info_t *info)
Definition: circuitbuild.c:2925
Definition: or.h:1177
Definition: address.h:56
int circuit_finish_handshake(origin_circuit_t *circ, const created_cell_t *reply)
Definition: circuitbuild.c:1363
void circuit_upgrade_circuits_from_guard_wait(void)
Definition: circuitbuild.c:3068
const uint8_t * build_state_get_exit_rsa_id(cpath_build_state_t *state)
Definition: circuitbuild.c:2965
int circuit_truncated(origin_circuit_t *circ, crypt_path_t *layer, int reason)
Definition: circuitbuild.c:1421
char * circuit_list_path(origin_circuit_t *circ, int verbose)
Definition: circuitbuild.c:322
struct circuit_guard_state_t * origin_circuit_get_guard_state(origin_circuit_t *circ)
Definition: circuitbuild.c:492
MOCK_DECL(int, router_have_minimum_dir_info,(void))
Definition: container.h:18
STATIC int onion_pick_cpath_exit(origin_circuit_t *circ, extend_info_t *exit_ei, int is_hs_v3_rp_circuit)
Definition: circuitbuild.c:2294
origin_circuit_t * circuit_establish_circuit(uint8_t purpose, extend_info_t *exit, int flags)
Definition: circuitbuild.c:463
int circuit_init_cpath_crypto(crypt_path_t *cpath, const char *key_data, size_t key_data_len, int reverse, int is_hs_v3)
Definition: circuitbuild.c:1343
char * circuit_list_path_for_controller(origin_circuit_t *circ)
Definition: circuitbuild.c:331
extend_info_t * extend_info_new(const char *nickname, const char *rsa_id_digest, const ed25519_public_key_t *ed_id, crypto_pk_t *onion_key, const curve25519_public_key_t *ntor_key, const tor_addr_t *addr, uint16_t port)
Definition: circuitbuild.c:2819
void onion_append_to_cpath(crypt_path_t **head_ptr, crypt_path_t *new_hop)
Definition: circuitbuild.c:2426
int circuit_timeout_want_to_count_circ(const origin_circuit_t *circ)
Definition: circuitbuild.c:804
int circuit_extend_to_new_exit(origin_circuit_t *circ, extend_info_t *info)
Definition: circuitbuild.c:2366
const char * build_state_get_exit_nickname(cpath_build_state_t *state)
Definition: circuitbuild.c:2977
STATIC circid_t get_unique_circ_id_by_chan(channel_t *chan)
Definition: circuitbuild.c:110
origin_circuit_t * origin_circuit_init(uint8_t purpose, int flags)
Definition: circuitbuild.c:437
void circuit_note_clock_jumped(int64_t seconds_elapsed, bool was_idle)
Definition: circuitbuild.c:1138
int onionskin_answer(or_circuit_t *circ, const created_cell_t *created_cell, const char *keys, size_t keys_len, const uint8_t *rend_circ_nonce)
Definition: circuitbuild.c:1467
int circuit_extend(cell_t *cell, circuit_t *circ)
Definition: circuitbuild.c:1177
Definition: crypto_curve25519.h:24
int circuit_handle_first_hop(origin_circuit_t *circ)
Definition: circuitbuild.c:502
Definition: or.h:3059
int extend_info_addr_is_allowed(const tor_addr_t *addr)
Definition: circuitbuild.c:2986
int inform_testing_reachability(void)
Definition: circuitbuild.c:737
uint32_t circid_t
Definition: or.h:1030
Definition: crypto_rsa.c:41
extend_info_t * extend_info_dup(extend_info_t *info)
Definition: circuitbuild.c:2936
const node_t * build_state_get_exit_node(cpath_build_state_t *state)
Definition: circuitbuild.c:2954
router_crn_flags_t
Definition: or.h:5463
void circuit_log_path(int severity, unsigned int domain, origin_circuit_t *circ)
Definition: circuitbuild.c:341
Definition: or.h:2986
const node_t * choose_good_entry_server(uint8_t purpose, cpath_build_state_t *state, struct circuit_guard_state_t **guard_state_out)
Definition: circuitbuild.c:2675
STATIC int new_route_len(uint8_t purpose, extend_info_t *exit_ei, smartlist_t *nodes)
Definition: circuitbuild.c:1649
void circuit_n_chan_done(channel_t *chan, int status, int close_origin_circuits)
Definition: circuitbuild.c:590
STATIC int onion_extend_cpath(origin_circuit_t *circ)
Definition: circuitbuild.c:2741
Definition: channel.h:41
Definition: or.h:2838
Definition: onion.h:70
int route_len_for_purpose(uint8_t purpose, extend_info_t *exit_ei)
Definition: circuitbuild.c:1559
Definition: or.h:3256
extend_info_t * extend_info_from_node(const node_t *r, int for_direct_connect)
Definition: circuitbuild.c:2853