cpath_build_state_t Struct Reference

#include <or.h>

Data Fields
int	desired_path_len
extend_info_t *	chosen_exit
int	need_uptime
int	need_capacity
int	is_internal
int	onehop_tunnel
crypt_path_t *	pending_final_cpath
int	failure_count
time_t	expiry_time

---

Detailed Description

Information used to build a circuit.

---

Field Documentation

int cpath_build_state_t::desired_path_len

Intended length of the final circuit.

Referenced by circuit_append_new_exit(), circuit_list_path_impl(), onion_extend_cpath(), and onion_pick_cpath_exit().

extend_info_t* cpath_build_state_t::chosen_exit

How to extend to the planned exit node.

Referenced by _circuit_mark_for_close(), build_state_get_exit_nickname(), build_state_get_exit_router(), circuit_append_new_exit(), circuit_free(), circuit_is_acceptable(), connection_ap_fail_onehop(), connection_ap_process_end_not_open(), find_intro_circuit(), handle_control_attachstream(), onion_extend_cpath(), onion_pick_cpath_exit(), rend_client_introduction_acked(), rend_client_send_introduction(), rend_service_launch_establish_intro(), and rend_service_relaunch_rendezvous().

int cpath_build_state_t::need_uptime

Whether every node in the circ must have adequate uptime.

Referenced by choose_good_middle_server(), choose_random_entry(), circuit_find_to_cannibalize(), circuit_is_acceptable(), circuit_list_path_impl(), circuit_predict_and_launch_new(), circuit_stream_is_being_handled(), onion_pick_cpath_exit(), and origin_circuit_init().

int cpath_build_state_t::need_capacity

Whether every node in the circ must have adequate capacity.

Referenced by choose_good_middle_server(), choose_random_entry(), circuit_find_to_cannibalize(), onion_pick_cpath_exit(), and origin_circuit_init().

int cpath_build_state_t::is_internal

Whether the last hop was picked with exiting in mind.

Referenced by circuit_find_to_cannibalize(), circuit_is_acceptable(), circuit_list_path_impl(), circuit_predict_and_launch_new(), circuit_stream_is_being_handled(), onion_pick_cpath_exit(), origin_circuit_init(), and warn_if_last_router_excluded().

int cpath_build_state_t::onehop_tunnel

Did we pick this as a one-hop tunnel (not safe for other conns)? These are for encrypted connections that exit to this router, not for arbitrary exits from the circuit.

Referenced by circuit_expire_building(), circuit_handle_first_hop(), circuit_is_acceptable(), circuit_predict_and_launch_new(), circuit_send_next_onion_skin(), circuit_stream_is_being_handled(), connection_ap_handshake_send_begin(), onion_pick_cpath_exit(), origin_circuit_init(), and warn_if_last_router_excluded().

crypt_path_t* cpath_build_state_t::pending_final_cpath

The crypt_path_t to append after rendezvous: used for rendezvous.

Referenced by circuit_free(), rend_client_receive_rendezvous(), rend_service_introduce(), rend_service_relaunch_rendezvous(), and rend_service_rendezvous_has_opened().

int cpath_build_state_t::failure_count

How many times has building a circuit for this task failed?

Referenced by rend_service_relaunch_rendezvous().

time_t cpath_build_state_t::expiry_time

At what time should we give up on this task?

Referenced by rend_service_introduce(), and rend_service_relaunch_rendezvous().

---

The documentation for this struct was generated from the following file:

• or.h