Enum DirBlockage

#[non_exhaustive]
pub enum DirBlockage {
    Stalled,
    TooManyErrors,
    TooManyResets,
}

A reported diagnostic for what kind of trouble we’ve seen while trying to bootstrap a directory.

These blockages types are not yet terribly specific: if you encounter one, it’s probably a good idea to check the logs to see what’s really going on.

If you encounter connection blockage and directory blockage at the same time, the connection blockage is almost certainly the real problem.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Stalled

We’ve been downloading information without error, but we haven’t actually been getting anything that we want.

This might indicate that there’s a problem with information propagating through the Tor network, or it might indicate that a bogus consensus or a bad clock has tricked us into asking for something that nobody has.

TooManyErrors

We’ve gotten a lot of errors without making forward progress on our bootstrap attempt.

This might indicate that something’s wrong with the Tor network, or that there’s something buggy with our ability to handle directory responses. It might also indicate a malfunction on our directory guards, or a bug on our retry logic.

TooManyResets

We’ve reset our bootstrap attempt a lot of times.

This either indicates that we have been failing a lot for one of the other reasons above, or that we keep getting served a consensus which turns out, upon trying to fetch certificates, not to be usable. It can also indicate a bug in our retry logic.

Trait Implementations

impl Clone for DirBlockage

fn clone(&self) -> DirBlockage

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DirBlockage

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

Formats the value using the given formatter.

impl Display for DirBlockage

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

Formats the value using the given formatter.