Enum Error

#[non_exhaustive]
pub enum Error {
    UnusableTarget(Bug),
    PendingFailed {
        peer: LoggedChanTarget,
    },
    ChanTimeout {
        peer: LoggedChanTarget,
    },
    Proto {
        source: Error,
        peer: LoggedChanTarget,
        clock_skew: Option<ClockSkew>,
    },
    Io {
        peer: Option<BoxSensitive<BridgeAddr>>,
        action: &'static str,
        source: Arc<Error>,
    },
    ChannelBuild {
        addresses: Vec<(Sensitive<SocketAddr>, Arc<Error>)>,
    },
    Spawn {
        spawning: &'static str,
        cause: Arc<SpawnError>,
    },
    MissingId,
    IdentityConflict,
    NoSuchTransport(TransportId),
    RequestCancelled,
    Proxy(ProxyError),
    Pt(Arc<dyn AbstractPtError>),
    Memquota(Error),
    Internal(Bug),
}

An error returned by a channel manager.

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.

UnusableTarget(Bug)

A ChanTarget was given for which no channel could be built.

PendingFailed

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

Fields

peer: LoggedChanTarget

Who we were talking to

ChanTimeout

It took too long for us to establish this connection.

Fields

peer: LoggedChanTarget

Who we were trying to talk to

Proto

A protocol error while making a channel

Fields

source: Error

The underlying error

peer: LoggedChanTarget

Who we were trying to talk to

clock_skew: Option<ClockSkew>

An authenticated ClockSkew (if available) that we received from the peer.

Io

Network IO error or TLS error

Fields

peer: Option<BoxSensitive<BridgeAddr>>

Who we were talking to

action: &'static str

What we were doing

source: Arc<Error>

What happened. Might be some TLS library error wrapped up in io::Error

ChannelBuild

Failed to build a channel, after trying multiple addresses.

Fields

addresses: Vec<(Sensitive<SocketAddr>, Arc<Error>)>

The list of addresses we tried to connect to, coupled with the error we encountered connecting to each one.

Spawn

Unable to spawn task

Fields

spawning: &'static str

What we were trying to spawn.

cause: Arc<SpawnError>

What happened when we tried to spawn it.

MissingId

A relay did not have the set of identity keys that we expected.

(Currently, tor-chanmgr only works on relays that have at least one recognized identity key.)

IdentityConflict

A successful relay channel had one of the identity keys we wanted, but not the other(s).

This means that (assuming the relay is well behaved), we will not find the ID combination we want.

NoSuchTransport(TransportId)

Tried to connect via a transport that we don’t support.

RequestCancelled

An attempt to open a channel failed because it was cancelled or superseded by another request or configuration change.

Proxy(ProxyError)

We tried to create a channel through a proxy, and encountered an error.

Pt(Arc<dyn AbstractPtError>)

An error occurred in a pluggable transport manager.

We can’t know the type, because any pluggable transport manager implementing AbstractPtMgr can be used. However, if you’re using Arti in the standard configuration, this will be tor-ptmgr’s PtError.

Memquota(Error)

Memory quota error

Internal(Bug)

An internal error of some kind that should never occur.

Implementations

impl Error

pub fn clock_skew(&self) -> Option<ClockSkew>

Return the clock skew information from this error (or from an internal error).

Only returns the clock skew information if it is authenticated.

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)>

Returns the lower-level source of this error, if any.

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

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

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(_: ByRelayIdsError) -> 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(_: ListByRelayIdsError) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<T>> for Error

fn from(_: PoisonError<T>) -> Error

Converts to this type from the input type.

impl From<ProxyError> for Error

fn from(source: ProxyError) -> Self

Converts to this type from the input type.

impl HasKind for Error

fn kind(&self) -> ErrorKind

Return the kind of this error.

impl HasRetryTime for Error

fn retry_time(&self) -> RetryTime

Return the time when the operation that gave this error can be retried.

fn abs_retry_time<F>(&self, now: Instant, choose_delay: F) -> AbsRetryTime

where F: FnOnce() -> Duration, Self: Sized,

Return an absolute retry when the operation that gave this error can be retried.