Enum tor_dirmgr::state::PendingNetDir

enum PendingNetDir {
    Partial(PartialNetDir),
    Yielding {
        netdir: Option<NetDir>,
        collected_microdescs: Vec<Microdesc>,
        missing_microdescs: HashSet<MdDigest>,
        replace_dir_time: SystemTime,
    },
    Dummy,
}

Information about a network directory that might not be ready to become the current network directory.

Variants

Partial(PartialNetDir)

A NetDir for which we have a consensus, but not enough microdescriptors.

Yielding

A NetDir we’re either trying to get our caller to replace, or that the caller has already taken from us.

After the netdir gets taken, the collected_microdescs and missing_microdescs fields get used. Before then, we just do operations on the netdir.

Fields

netdir: Option<NetDir>

The actual netdir. This starts out as Some, but our caller can take() it from us.

collected_microdescs: Vec<Microdesc>

Microdescs we have collected in order to yield to our caller.

missing_microdescs: HashSet<MdDigest>

Which microdescs we need for the netdir that either is or used to be in netdir.

NOTE(eta): This MUST always match the netdir’s own idea of which microdescs we need. We do this by copying the netdir’s missing microdescs into here when we instantiate it. (This code assumes that it doesn’t add more needed microdescriptors later!)

replace_dir_time: SystemTime

The time at which we should renew this netdir, assuming we have driven it to a “usable” state.

Dummy

A dummy value, so we can use mem::replace.

Implementations

impl PendingNetDir

fn upgrade_if_necessary(&mut self)

If this PendingNetDir is Partial and could not be partial, upgrade it.

Trait Implementations

impl Clone for PendingNetDir

fn clone(&self) -> PendingNetDir

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PendingNetDir

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl MdReceiver for PendingNetDir

fn missing_microdescs(&self) -> Box<dyn Iterator<Item = &MdDigest> + '_>

Return an iterator over the digests for all of the microdescriptors that this netdir is missing.

fn add_microdesc(&mut self, md: Microdesc) -> bool

Add a microdescriptor to this netdir, if it was wanted.

fn n_missing(&self) -> usize

Return the number of missing microdescriptors.