Struct tor_circmgr::hspool::pool::Pool

pub(super) struct Pool {
    circuits: Vec<HsCircStub>,
    stub_target: usize,
    ext_stub_target: usize,
    have_been_exhausted: bool,
    have_been_under_highwater: bool,
    last_changed_target: Option<Instant>,
    mode: VanguardMode,
}

Available on crate feature hs-common only.

A collection of circuits used to fulfil onion-service-related requests.

Fields

circuits: Vec<HsCircStub>

The collection of circuits themselves, in no particular order.

stub_target: usize

The number of SHORT elements that we would like to have in our pool.

ext_stub_target: usize

The number of EXTENDED elements that we would like to have in our pool.

have_been_exhausted: bool

True if we have exhausted our pool since the last time we decided whether to change our target level.

have_been_under_highwater: bool

True if we have been under 4/5 of our target since the last time we decided whether to change it.

last_changed_target: Option<Instant>

Last time when we changed our target size.

mode: VanguardMode

The kind of vanguards that are in use.

All the circuits from circuits use the type of vanguards specified here.

Implementations

impl Pool

pub(super) fn insert(&mut self, circ: HsCircStub)

Add circ to this pool

pub(super) fn retain<F>(&mut self, f: F)

where F: FnMut(&HsCircStub) -> bool,

Remove every circuit from this pool for which f returns false.

pub(super) fn very_low(&self) -> bool

Return true if we are very low on circuits and should build more immediately.

pub(super) fn circs_to_launch(&self) -> CircsToLaunch

Return a CircsToLaunch describing the circuits we would currently like to launch.

fn stubs_to_launch(&self) -> usize

Return the number of SHORT circuits we would currently like to launch.

fn ext_stubs_to_launch(&self) -> usize

Return the number of EXTENDED circuits we would currently like to launch.

fn target(&self) -> usize

Return the total number of circuits we would like to launch.

We do not discard when we are above this threshold, but we do try to build when we are low.

pub(super) fn take_one_where<R, F>( &mut self, rng: &mut R, f: F, prefs: &HsCircPrefs ) -> Option<HsCircStub>

where R: Rng, F: Fn(&HsCircStub) -> bool,

If there is any circuit in this pool for which f returns true and that satisfies all of the specified HsCircPrefs, return one such circuit at random, and remove it from the pool.

If none of the circuits satisfy prefs, return a randomly selected circuit for which f returns true, and remove it from the pool.

pub(super) fn update_target_size(&mut self, now: Instant)

Update the target sizes for our pool.

This updates our target numbers of SHORT and EXTENDED circuits.

pub(super) fn reconfigure_vanguards( &mut self, config: &VanguardConfig ) -> Result<(), ReconfigureError>

Available on crate feature vanguards only.

Handle vanguard configuration changes.

If new config has a different [VanguardMode] enabled, this empties the circuit pool.

pub(super) fn vanguards_enabled(&self) -> bool

Returns true if vanguards are enabled.

Trait Implementations

impl Default for Pool

fn default() -> Self

Returns the “default value” for a type.