#include <or_circuit_st.h>

Data Fields
circuit_t	base_

struct onion_queue_t *	onionqueue_entry

struct workqueue_entry_t *	workqueue_entry

circid_t	p_circ_id

cell_queue_t	p_chan_cells

channel_t *	p_chan

edge_connection_t *	n_streams

edge_connection_t *	resolving_streams

relay_crypto_t	crypto

struct or_circuit_t *	rend_splice

char	rend_circ_nonce [DIGEST_LEN]

unsigned int	remaining_relay_early_cells: 4

unsigned int	already_received_introduce1: 1

unsigned int	circuit_carries_hs_traffic_stats: 1

uint32_t	processed_cells

uint64_t	total_cell_waiting_time

unsigned int	introduce2_dos_defense_enabled: 1

unsigned int	introduce2_dos_defense_explicit: 1

token_bucket_ctr_t	introduce2_bucket

Detailed Description

An or_circuit_t holds information needed to implement a circuit at an OR.

Definition at line 21 of file or_circuit_st.h.

Field Documentation

◆ circuit_carries_hs_traffic_stats

unsigned int circuit_carries_hs_traffic_stats

If set, this circuit carries HS traffic. Consider it in any HS statistics.

Definition at line 64 of file or_circuit_st.h.

◆ crypto

relay_crypto_t crypto

Cryptographic state used for encrypting and authenticating relay cells to and from this hop.

Definition at line 46 of file or_circuit_st.h.

Referenced by relay_encrypt_cell_inbound().

◆ introduce2_bucket

token_bucket_ctr_t introduce2_bucket

INTRODUCE2 cell bucket controlling how much can go on this circuit. Only used if this is a service introduction circuit at the intro point (purpose = CIRCUIT_PURPOSE_INTRO_POINT).

Definition at line 86 of file or_circuit_st.h.

◆ introduce2_dos_defense_enabled

unsigned int introduce2_dos_defense_enabled

If set, the DoS defenses are enabled on this circuit meaning that the introduce2_bucket is initialized and used.

Definition at line 77 of file or_circuit_st.h.

Referenced by hs_dos_can_send_intro2(), hs_dos_setup_default_intro2_defenses(), and update_intro_circuits().

◆ introduce2_dos_defense_explicit

unsigned int introduce2_dos_defense_explicit

If set, the DoS defenses were explicitly enabled through the ESTABLISH_INTRO cell extension. If unset, the consensus is used to learn if the defenses can be enabled or not.

Definition at line 81 of file or_circuit_st.h.

◆ n_streams

edge_connection_t* n_streams

Linked list of Exit streams associated with this circuit.

Definition at line 39 of file or_circuit_st.h.

Referenced by circuit_expire_old_circuits_serverside(), and set_streams_blocked_on_circ().

◆ onionqueue_entry

struct onion_queue_t* onionqueue_entry

Pointer to an entry on the onion queue, if this circuit is waiting for a chance to give an onionskin to a cpuworker. Used only in onion.c

Definition at line 26 of file or_circuit_st.h.

Referenced by onion_pending_remove().

◆ p_chan

channel_t* p_chan

The channel that is previous in this circuit.

Definition at line 37 of file or_circuit_st.h.

Referenced by channel_flush_from_first_active_circuit(), channel_note_destroy_not_pending(), channel_note_destroy_pending(), circuit_about_to_free_atexit(), circuit_clear_cell_queue(), circuit_expire_old_circuits_serverside(), circuit_set_p_circid_chan(), circuitmux_attach_circuit(), circuitmux_detach_circuit(), circuitmux_find_map_entry(), format_cell_stats(), and update_circuit_on_cmux_().

◆ p_chan_cells

cell_queue_t p_chan_cells

Queue of cells waiting to be transmitted on p_conn.

Definition at line 35 of file or_circuit_st.h.

Referenced by append_cell_to_circuit_queue(), channel_flush_from_first_active_circuit(), circuit_clear_cell_queue(), circuit_resume_edge_reading_helper(), circuitmux_attach_circuit(), dump_cell_pool_usage(), and n_cells_in_circ_queues().

◆ p_circ_id

circid_t p_circ_id

The circuit_id used in the previous (backward) hop of this circuit.

Definition at line 33 of file or_circuit_st.h.

Referenced by channel_note_destroy_not_pending(), channel_note_destroy_pending(), circuit_dump_by_conn(), circuit_set_p_circid_chan(), circuitmux_attach_circuit(), circuitmux_detach_circuit(), circuitmux_find_map_entry(), and format_cell_stats().

◆ processed_cells

uint32_t processed_cells

Number of cells that were removed from circuit queue; reset every time when writing buffer stats to disk.

Definition at line 68 of file or_circuit_st.h.

Referenced by rep_hist_buffer_stats_add_circ().

◆ remaining_relay_early_cells

unsigned int remaining_relay_early_cells

How many more relay_early cells can we send on this circuit, according to the specification?

Definition at line 57 of file or_circuit_st.h.

◆ rend_circ_nonce

char rend_circ_nonce[DIGEST_LEN]

Stores KH for the handshake.

Definition at line 53 of file or_circuit_st.h.

◆ rend_splice

struct or_circuit_t* rend_splice

Points to spliced circuit if purpose is REND_ESTABLISHED, and circuit is not marked for close.

Definition at line 50 of file or_circuit_st.h.

Referenced by circuit_expire_old_circuits_serverside().

◆ resolving_streams

edge_connection_t* resolving_streams

Linked list of Exit streams associated with this circuit that are still being resolved.

Definition at line 42 of file or_circuit_st.h.

Referenced by circuit_expire_old_circuits_serverside(), and circuit_free_all().

◆ total_cell_waiting_time

uint64_t total_cell_waiting_time

Total time in milliseconds that cells spent in both app-ward and exit-ward queues of this circuit; reset every time when writing buffer stats to disk.

Definition at line 73 of file or_circuit_st.h.