Enum tor_dirmgr::Error

#[non_exhaustive]
pub enum Error {
    Unwanted(&'static str),
    NetDirOlder,
    NoDownloadSupport,
    CacheCorruption(&'static str),
    SqliteError(Arc<Error>),
    UnrecognizedSchema,
    DirectoryNotPresent,
    UnrecognizedAuthorities,
    ManagerDropped,
    CantAdvanceState,
    StorageError(String),
    ConsensusDiffError(Error),
    BadUtf8FromDirectory(FromUtf8Error),
    BadUtf8InCache(Utf8Error),
    BadHexInCache(FromHexError),
    NetDocError {
        source: DocSource,
        cause: Error,
    },
    ConsensusInvalid {
        source: DocSource,
        cause: Error,
    },
    UntimelyObject(TimeValidityError),
    DirClientError(Error),
    SignatureError(Arc<Error>),
    IOError(Arc<Error>),
    OfflineMode,
    CachePermissions(Error),
    Spawn {
        spawning: &'static str,
        cause: Arc<SpawnError>,
    },
    ExternalDirProvider {
        cause: Arc<dyn Error + Send + Sync + 'static>,
        kind: ErrorKind,
    },
    Bug(Bug),
}

An error originated by the directory manager code

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.

Unwanted(&'static str)

We received a document we didn’t want at all.

NetDirOlder

The NetDir we downloaded is older than the one we already have.

NoDownloadSupport

This DirMgr doesn’t support downloads.

CacheCorruption(&'static str)

We couldn’t read something from disk that we should have been able to read.

SqliteError(Arc<Error>)

rusqlite gave us an error.

UnrecognizedSchema

A schema version that says we can’t read it.

DirectoryNotPresent

User requested an operation that required a usable bootstrapped directory, but we didn’t have one.

UnrecognizedAuthorities

A consensus document is signed by an unrecognized authority set.

ManagerDropped

A directory manager has been dropped; background tasks can exit too.

CantAdvanceState

We made a bunch of attempts, but weren’t unable to advance the state of a download.

StorageError(String)

Blob storage error

ConsensusDiffError(Error)

An error given by the consensus diff crate.

BadUtf8FromDirectory(FromUtf8Error)

Invalid UTF8 in directory response.

BadUtf8InCache(Utf8Error)

Invalid UTF8 from our cache.

BadHexInCache(FromHexError)

Invalid hexadecimal value in the cache.

NetDocError

Fields

source: DocSource

Where the document came from.

cause: Error

What error we got.

An error given by the network document crate.

ConsensusInvalid

Fields

source: DocSource

Where the document came from.

cause: Error

What error we got.

An error indicating that the consensus could not be validated.

This kind of error is only returned during the certificate fetching state; it indicates that a consensus which previously seemed to be plausible has turned out to be wrong after we got the certificates.

UntimelyObject(TimeValidityError)

An error caused by an expired or not-yet-valid object.

DirClientError(Error)

An error given by dirclient

SignatureError(Arc<Error>)

An error given by the checkable crate.

IOError(Arc<Error>)

An IO error occurred while manipulating storage on disk.

OfflineMode

An attempt was made to bootstrap a DirMgr created in offline mode.

CachePermissions(Error)

A problem with file permissions on our cache directory.

Spawn

Fields

spawning: &'static str

What we were trying to spawn

cause: Arc<SpawnError>

What happened when we tried to spawn it

Unable to spawn task

ExternalDirProvider

Fields

cause: Arc<dyn Error + Send + Sync + 'static>

What happened

kind: ErrorKind

The kind

Other error from an external directory provider

Bug(Bug)

A programming problem, either in our code or the code calling it.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Bug> for Error

fn from(source: Bug) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<TimeValidityError> for Error

fn from(source: TimeValidityError) -> Self

Converts to this type from the input type.

impl HasKind for Error

fn kind(&self) -> ErrorKind

Return the kind of this error.