Enum tor_chanmgr::Error

#[non_exhaustive]
pub enum Error {
    UnusableTarget(Bug),
    PendingFailed,
    ChanTimeout,
    Proto {
        source: Error,
        clock_skew: Option<ClockSkew>,
    },
    Io {
        peer: SocketAddr,
        action: &'static str,
        source: Arc<Error>,
    },
    ChannelBuild {
        addresses: Vec<(SocketAddr, Arc<Error>)>,
    },
    Spawn {
        spawning: &'static str,
        cause: Arc<SpawnError>,
    },
    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.

ChanTimeout

It took too long for us to establish this connection.

Proto

Fields

source: Error

The underlying error

clock_skew: Option<ClockSkew>

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

A protocol error while making a channel

Io

Fields

peer: SocketAddr

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

Network IO error or TLS error

ChannelBuild

Fields

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

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

Failed to build a channel, after trying multiple addresses.

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

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

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<T> From<PoisonError<T>> for Error

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

Converts to this type from the input type.

impl From<TimeoutError> for Error

fn from(_: TimeoutError) -> Error

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, 

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