#include <circuitpadding.h>

Data Fields
const char *	name

circpad_machine_num_t	machine_num

unsigned	machine_index: 1

unsigned	should_negotiate_end: 1

unsigned	is_origin_side: 1

unsigned	target_hopnum: 3

unsigned	manage_circ_lifetime: 1

circpad_machine_conditions_t	conditions

uint16_t	allowed_padding_count

uint8_t	max_padding_percent

circpad_state_t *	states

circpad_statenum_t	num_states

Detailed Description

Global state machine structure from the consensus

Definition at line 624 of file circuitpadding.h.

Field Documentation

◆ allowed_padding_count

uint16_t allowed_padding_count

How many padding cells can be sent before we apply overhead limits? XXX: Note that we can only allow up to 64k of padding cells on an otherwise quiet circuit. Is this enough? It's 33MB.

Definition at line 665 of file circuitpadding.h.

Referenced by circpad_machine_client_hide_intro_circuits(), circpad_machine_client_hide_rend_circuits(), circpad_machine_reached_padding_limit(), circpad_machine_relay_hide_intro_circuits(), and circpad_machine_relay_hide_rend_circuits().

◆ conditions

circpad_machine_conditions_t conditions

This machine only kills fascists if the following conditions are met.

Definition at line 660 of file circuitpadding.h.

Referenced by circpad_machine_client_hide_intro_circuits(), circpad_machine_client_hide_rend_circuits(), circpad_machine_conditions_apply(), circpad_machine_conditions_keep(), circpad_machine_relay_hide_intro_circuits(), and circpad_machine_relay_hide_rend_circuits().

◆ is_origin_side

unsigned is_origin_side

Origin side or relay side

Definition at line 640 of file circuitpadding.h.

Referenced by circpad_machine_client_hide_intro_circuits(), circpad_machine_client_hide_rend_circuits(), circpad_machine_relay_hide_intro_circuits(), circpad_machine_relay_hide_rend_circuits(), and circpad_machine_spec_transitioned_to_end().

◆ machine_index

unsigned machine_index

Which machine index slot should this machine go into in the array on the circuit_t

Definition at line 633 of file circuitpadding.h.

Referenced by circpad_machine_spec_transitioned_to_end().

◆ machine_num

circpad_machine_num_t machine_num

Global machine number

Definition at line 629 of file circuitpadding.h.

Referenced by circpad_machine_client_hide_intro_circuits(), circpad_machine_client_hide_rend_circuits(), circpad_machine_relay_hide_intro_circuits(), circpad_machine_relay_hide_rend_circuits(), circpad_machine_spec_transitioned_to_end(), circpad_shutdown_old_machines(), and free_circ_machineinfos_with_machine_num().

◆ manage_circ_lifetime

unsigned manage_circ_lifetime

If this flag is enabled, don't close circuits that use this machine even if another part of Tor wants to close this circuit.

If this flag is set, the circuitpadding subsystem will close circuits the moment the machine transitions to the END state, and only if the circuit has already been asked to be closed by another part of Tor.

Circuits that should have been closed but were kept open by a padding machine are re-purposed to CIRCUIT_PURPOSE_C_CIRCUIT_PADDING, hence machines should take that purpose into account if they are filtering circuits by purpose.

Definition at line 657 of file circuitpadding.h.

Referenced by circpad_machine_client_hide_intro_circuits(), and circpad_marked_circuit_for_padding().

◆ max_padding_percent

uint8_t max_padding_percent

Padding percent cap: Stop padding if we exceed this percent overhead. 0 means no limit. Overhead is defined as percent of total traffic, so that we can use 0..100 here. This is the same definition as used in Prop#265.

Definition at line 671 of file circuitpadding.h.

Referenced by circpad_machine_client_hide_intro_circuits(), circpad_machine_client_hide_rend_circuits(), circpad_machine_reached_padding_limit(), circpad_machine_relay_hide_intro_circuits(), and circpad_machine_relay_hide_rend_circuits().