Enum tor_proto::Error

#[non_exhaustive]
pub enum Error {
    BytesErr(Error),
    IoErr(Arc<Error>),
    CellErr(Error),
    MissingKey,
    InvalidOutputLength,
    NoSuchHop,
    InternalError(String),
    BadCellAuth,
    BadHandshake,
    ChanProto(String),
    CircProto(String),
    CircDestroy(String),
    ChannelClosed,
    CircuitClosed,
    StreamEnded,
    IdRangeFull,
    CircExtend(&'static str),
    BadStreamAddress,
    EndReceived(EndReason),
    NotConnected,
    StreamProto(String),
    ChanMismatch(String),
    BadConfig(String),
    ResolveError(String),
}

An error type for the tor-proto crate.

This type should probably be split into several. There’s more than one kind of error that can occur while doing something with the Tor protocol.

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.

BytesErr(Error)

Tuple Fields

0: Error

An error that occurred in the tor_bytes crate while decoding an object.

IoErr(Arc<Error>)

Tuple Fields

0: Arc<Error>

An error that occurred from the io system.

CellErr(Error)

Tuple Fields

0: Error

An error occurred in the cell-handling layer.

MissingKey

Somebody asked for a key that we didn’t have.

InvalidOutputLength

We tried to produce too much output for some function.

NoSuchHop

We tried to encrypt a message to a hop that wasn’t there.

InternalError(String)

Tuple Fields

0: String

There was a programming error somewhere in the code.

BadCellAuth

The authentication information on this cell was completely wrong, or the cell was corrupted.

BadHandshake

A circuit-extension handshake failed.

ChanProto(String)

Tuple Fields

0: String

Protocol violation at the channel level

CircProto(String)

Tuple Fields

0: String

Protocol violation at the circuit level

CircDestroy(String)

Tuple Fields

0: String

Circuit destroyed or channel closed.

ChannelClosed

Channel is closed.

CircuitClosed

Circuit is closed.

StreamEnded

Stream has ended.

IdRangeFull

Can’t allocate any more circuit or stream IDs on a channel.

CircExtend(&'static str)

Tuple Fields

0: &'static str

Couldn’t extend a circuit.

BadStreamAddress

Tried to make or use a stream to an invalid destination address.

EndReceived(EndReason)

Tuple Fields

0: EndReason

Received an End cell from the other end of a stream.

NotConnected

Stream was already closed when we tried to use it.

StreamProto(String)

Tuple Fields

0: String

Stream protocol violation

ChanMismatch(String)

Tuple Fields

0: String

Channel does not match target

BadConfig(String)

Tuple Fields

0: String

Tried to configure an impossible value

ResolveError(String)

Tuple Fields

0: String

Remote DNS lookup failed.

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

fn from(source: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.