Enum tor_circmgr::Error

#[non_exhaustive]
pub enum Error {
    NoRelays(String),
    NeedConsensus,
    PendingFailed,
    CircTimeout,
    GuardNotUsable,
    UsageNotSupported(String),
    RequestTimeout,
    RequestFailed(RetryError<Box<Error>>),
    CircCancelled,
    Internal(String),
    ChanFailed(Error),
    Protocol(Error),
    State(Error),
    GuardMgr(GuardMgrError),
    Guard(PickGuardError),
    ExpiredConsensus,
}

An error returned while looking up or building a circuit

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.

NoRelays(String)

Tuple Fields

0: String

No suitable relays for a request

NeedConsensus

We need to have a consensus directory to build this kind of circuits, and we only got a list of fallbacks.

PendingFailed

We were waiting on a pending circuit, but it didn’t succeed.

CircTimeout

A circuit build took too long to finish.

GuardNotUsable

We started building a circuit on a guard, but later decided not to use that guard.

UsageNotSupported(String)

Tuple Fields

0: String

Tried to take a circuit for a purpose it doesn’t support.

RequestTimeout

A request spent too long waiting for a circuit

RequestFailed(RetryError<Box<Error>>)

Tuple Fields

0: RetryError<Box<Error>>

Unable to get or build a circuit, despite retrying.

CircCancelled

A circuit succeeded, but was cancelled before it could be used.

Circuits can be cancelled either by a call to retire_all_circuits(), or by a configuration change that makes old paths unusable.

Internal(String)

Tuple Fields

0: String

An error caused by a programming issue or a failure in another library that we can’t work around.

ChanFailed(Error)

Tuple Fields

0: Error

Couldn’t get a channel for a circuit.

Protocol(Error)

Tuple Fields

0: Error

Protocol issue while building a circuit.

State(Error)

Tuple Fields

0: Error

Problem loading or storing persistent state.

GuardMgr(GuardMgrError)

Tuple Fields

0: GuardMgrError

Problem creating or updating a guard manager.

Guard(PickGuardError)

Tuple Fields

0: PickGuardError

Problem selecting a guard relay.

ExpiredConsensus

We have an expired consensus

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<Canceled> for Error

fn from(_: Canceled) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<GuardMgrError> for Error

fn from(err: GuardMgrError) -> Error

Performs the conversion.

impl From<PickGuardError> for Error

fn from(source: PickGuardError) -> Self

Performs the conversion.

impl From<SpawnError> for Error

fn from(_: SpawnError) -> Error

Performs the conversion.

impl From<TimeoutError> for Error

fn from(_: TimeoutError) -> Error

Performs the conversion.