Router descriptor structure. More...

#include "feature/nodelist/signed_descriptor_st.h"

Data Structures
struct	routerinfo_t

Macros
#define	ROUTER_PURPOSE_GENERAL 0

#define	ROUTER_PURPOSE_CONTROLLER 1

#define	ROUTER_PURPOSE_BRIDGE 2

#define	ROUTER_PURPOSE_UNKNOWN 255

Detailed Description

Router descriptor structure.

Definition in file routerinfo_st.h.

Macro Definition Documentation

◆ ROUTER_PURPOSE_BRIDGE

#define ROUTER_PURPOSE_BRIDGE 2

Tor should use this router only for bridge positions in circuits: we got it via a directory request from the bridge itself, or a bridge authority.

Definition at line 114 of file routerinfo_st.h.

Referenced by authdir_mode_handles_descs(), connection_dir_client_request_failed(), dir_fetch_type(), dir_routerdesc_download_failed(), directory_handle_command_post(), directory_request_set_router_purpose(), dirserv_compute_performance_thresholds(), dirserv_orconn_tls_done(), dirserv_set_bridges_running(), dirserv_test_reachability(), fetch_bridge_descriptors(), handle_get_descriptor(), launch_direct_bridge_descriptor_fetch(), learned_bridge_descriptor(), purpose_needs_anonymity(), router_add_to_routerlist(), router_build_fresh_unsigned_routerinfo(), router_purpose_from_string(), router_purpose_to_string(), router_upload_dir_desc_to_dirservers(), and routerlist_descriptors_added().

◆ ROUTER_PURPOSE_CONTROLLER

#define ROUTER_PURPOSE_CONTROLLER 1

Tor should avoid using this router for circuit-building: we got it from a controller. If the controller wants to use it, it'll have to ask for it by identity.

Definition at line 110 of file routerinfo_st.h.

Referenced by router_purpose_from_string(), and router_purpose_to_string().

◆ ROUTER_PURPOSE_GENERAL

#define ROUTER_PURPOSE_GENERAL 0

Tor can use this router for general positions in circuits; we got it from a directory server as usual, or we're an authority and a server uploaded it.

Definition at line 106 of file routerinfo_st.h.

Referenced by authdir_mode_handles_descs(), connection_edge_process_relay_cell_not_open(), dirclient_dump_total_dls(), directory_handle_command_post(), directory_request_new(), directory_request_set_router_purpose(), dirserv_add_multiple_descriptors(), dirvote_compute_consensuses(), dirvote_perform_vote(), handle_control_postdescriptor(), initiate_descriptor_downloads(), load_downloaded_routers(), node_get_purpose(), nodelist_set_consensus(), router_add_to_routerlist(), router_build_fresh_unsigned_routerinfo(), router_parse_entry_from_string(), router_purpose_from_string(), router_purpose_to_string(), router_upload_dir_desc_to_dirservers(), routerlist_insert_old(), routerlist_remove(), routerlist_replace(), signed_descriptor_from_routerinfo(), update_consensus_bootstrap_attempt_downloads(), and update_consensus_networkstatus_downloads().

◆ ROUTER_PURPOSE_UNKNOWN

#define ROUTER_PURPOSE_UNKNOWN 255

Tor should not use this router; it was marked in cached-descriptors with a purpose we didn't recognize.

Definition at line 117 of file routerinfo_st.h.

Referenced by handle_control_postdescriptor(), networkstatus_getinfo_by_purpose(), router_parse_entry_from_string(), and router_purpose_from_string().