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 */
9 * \brief Header file for nodelist.c.
12 #ifndef TOR_NODELIST_H
13 #define TOR_NODELIST_H
15 #define node_assert_ok(n) STMT_BEGIN { \
16 tor_assert((n)->ri || (n)->rs); \
19 MOCK_DECL(node_t
*, node_get_mutable_by_id
,(const char *identity_digest
));
20 MOCK_DECL(const node_t
*, node_get_by_id
, (const char *identity_digest
));
21 node_t
*node_get_mutable_by_ed25519_id(const ed25519_public_key_t
*ed_id
);
22 MOCK_DECL(const node_t
*, node_get_by_ed25519_id
,
23 (const ed25519_public_key_t
*ed_id
));
25 #define NNF_NO_WARN_UNNAMED (1u<<0)
27 const node_t
*node_get_by_hex_id(const char *identity_digest
,
29 node_t
*nodelist_set_routerinfo(routerinfo_t
*ri
, routerinfo_t
**ri_old_out
);
30 node_t
*nodelist_add_microdesc(microdesc_t
*md
);
31 void nodelist_set_consensus(networkstatus_t
*ns
);
32 void nodelist_ensure_freshness(networkstatus_t
*ns
);
33 int nodelist_probably_contains_address(const tor_addr_t
*addr
);
35 void nodelist_remove_microdesc(const char *identity_digest
, microdesc_t
*md
);
36 void nodelist_remove_routerinfo(routerinfo_t
*ri
);
37 void nodelist_purge(void);
38 smartlist_t
*nodelist_find_nodes_with_microdesc(const microdesc_t
*md
);
40 void nodelist_free_all(void);
41 void nodelist_assert_ok(void);
43 MOCK_DECL(const node_t
*, node_get_by_nickname
,
44 (const char *nickname
, unsigned flags
));
45 void node_get_verbose_nickname(const node_t
*node
,
46 char *verbose_name_out
);
47 void node_get_verbose_nickname_by_id(const char *id_digest
,
48 char *verbose_name_out
);
49 int node_is_dir(const node_t
*node
);
50 int node_has_any_descriptor(const node_t
*node
);
51 int node_has_preferred_descriptor(const node_t
*node
,
52 int for_direct_connect
);
53 int node_get_purpose(const node_t
*node
);
54 #define node_is_bridge(node) \
55 (node_get_purpose((node)) == ROUTER_PURPOSE_BRIDGE)
56 int node_is_me(const node_t
*node
);
57 int node_exit_policy_rejects_all(const node_t
*node
);
58 int node_exit_policy_is_exact(const node_t
*node
, sa_family_t family
);
59 smartlist_t
*node_get_all_orports(const node_t
*node
);
60 int node_allows_single_hop_exits(const node_t
*node
);
61 const char *node_get_nickname(const node_t
*node
);
62 const char *node_get_platform(const node_t
*node
);
63 uint32_t node_get_prim_addr_ipv4h(const node_t
*node
);
64 void node_get_address_string(const node_t
*node
, char *cp
, size_t len
);
65 long node_get_declared_uptime(const node_t
*node
);
66 const smartlist_t
*node_get_declared_family(const node_t
*node
);
67 const ed25519_public_key_t
*node_get_ed25519_id(const node_t
*node
);
68 int node_ed25519_id_matches(const node_t
*node
,
69 const ed25519_public_key_t
*id
);
70 int node_supports_ed25519_link_authentication(const node_t
*node
,
71 int compatible_with_us
);
72 int node_supports_v3_hsdir(const node_t
*node
);
73 int node_supports_ed25519_hs_intro(const node_t
*node
);
74 int node_supports_v3_rendezvous_point(const node_t
*node
);
75 const uint8_t *node_get_rsa_id_digest(const node_t
*node
);
77 int node_has_ipv6_addr(const node_t
*node
);
78 int node_has_ipv6_orport(const node_t
*node
);
79 int node_has_ipv6_dirport(const node_t
*node
);
80 /* Deprecated - use node_ipv6_or_preferred or node_ipv6_dir_preferred */
81 #define node_ipv6_preferred(node) node_ipv6_or_preferred(node)
82 int node_ipv6_or_preferred(const node_t
*node
);
83 void node_get_prim_orport(const node_t
*node
, tor_addr_port_t
*ap_out
);
84 void node_get_pref_orport(const node_t
*node
, tor_addr_port_t
*ap_out
);
85 void node_get_pref_ipv6_orport(const node_t
*node
, tor_addr_port_t
*ap_out
);
86 int node_ipv6_dir_preferred(const node_t
*node
);
87 void node_get_prim_dirport(const node_t
*node
, tor_addr_port_t
*ap_out
);
88 void node_get_pref_dirport(const node_t
*node
, tor_addr_port_t
*ap_out
);
89 void node_get_pref_ipv6_dirport(const node_t
*node
, tor_addr_port_t
*ap_out
);
90 int node_has_curve25519_onion_key(const node_t
*node
);
91 const curve25519_public_key_t
*node_get_curve25519_onion_key(
94 MOCK_DECL(smartlist_t
*, nodelist_get_list
, (void));
96 /* Temporary during transition to multiple addresses. */
97 void node_get_addr(const node_t
*node
, tor_addr_t
*addr_out
);
98 #define node_get_addr_ipv4h(n) node_get_prim_addr_ipv4h((n))
100 void nodelist_refresh_countries(void);
101 void node_set_country(node_t
*node
);
102 void nodelist_add_node_and_family(smartlist_t
*nodes
, const node_t
*node
);
103 int nodes_in_same_family(const node_t
*node1
, const node_t
*node2
);
105 const node_t
*router_find_exact_exit_enclave(const char *address
,
107 int node_is_unreliable(const node_t
*router
, int need_uptime
,
108 int need_capacity
, int need_guard
);
109 int router_exit_policy_all_nodes_reject(const tor_addr_t
*addr
, uint16_t port
,
111 void router_set_status(const char *digest
, int up
);
112 int addrs_in_same_network_family(const tor_addr_t
*a1
,
113 const tor_addr_t
*a2
);
115 /** router_have_minimum_dir_info tests to see if we have enough
116 * descriptor information to create circuits.
117 * If there are exits in the consensus, we wait until we have enough
118 * info to create exit paths before creating any circuits. If there are
119 * no exits in the consensus, we wait for enough info to create internal
120 * paths, and should avoid creating exit paths, as they will simply fail.
121 * We make sure we create all available circuit types at the same time. */
122 MOCK_DECL(int, router_have_minimum_dir_info
,(void));
124 /** Set to CONSENSUS_PATH_EXIT if there is at least one exit node
125 * in the consensus. We update this flag in compute_frac_paths_available if
126 * there is at least one relay that has an Exit flag in the consensus.
127 * Used to avoid building exit circuits when they will almost certainly fail.
128 * Set to CONSENSUS_PATH_INTERNAL if there are no exits in the consensus.
129 * (This situation typically occurs during bootstrap of a test network.)
130 * Set to CONSENSUS_PATH_UNKNOWN if we have never checked, or have
131 * reason to believe our last known value was invalid or has expired.
134 /* we haven't checked yet, or we have invalidated our previous check */
135 CONSENSUS_PATH_UNKNOWN
= -1,
136 /* The consensus only has internal relays, and we should only
137 * create internal paths, circuits, streams, ... */
138 CONSENSUS_PATH_INTERNAL
= 0,
139 /* The consensus has at least one exit, and can therefore (potentially)
140 * create exit and internal paths, circuits, streams, ... */
141 CONSENSUS_PATH_EXIT
= 1
142 } consensus_path_type_t
;
144 MOCK_DECL(consensus_path_type_t
, router_have_consensus_path
, (void));
146 void router_dir_info_changed(void);
147 const char *get_dir_info_status_string(void);
148 int count_loading_descriptors_progress(void);
150 #ifdef NODELIST_PRIVATE
152 #ifdef TOR_UNIT_TESTS
155 node_set_hsdir_index(node_t
*node
, const networkstatus_t
*ns
);
157 #endif /* defined(TOR_UNIT_TESTS) */
159 #endif /* defined(NODELIST_PRIVATE) */
161 MOCK_DECL(int, get_estimated_address_per_node
, (void));
163 #endif /* !defined(TOR_NODELIST_H) */