Enum tor_proto::Error

source · [−]
#[non_exhaustive]
pub enum Error {

Show 23 variants    BytesErr(Error),
    ChanIoErr(Arc<Error>),
    HandshakeIoErr(Arc<Error>),
    CellErr(Error),
    InvalidOutputLength,
    NoSuchHop,
    BadCellAuth,
    BadCircHandshake,
    HandshakeProto(String),
    HandshakeCertsExpired {
        expired_by: Duration,
    },
    ChanProto(String),
    CircProto(String),
    ChannelClosed,
    CircuitClosed,
    IdRangeFull,
    CircRefused(&'static str),
    BadStreamAddress,
    EndReceived(EndReason),
    NotConnected,
    StreamProto(String),
    ChanMismatch(String),
    Bug(Bug),
    ResolveError(ResolveError),

}
Expand description

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)

This enum is marked as 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)

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

ChanIoErr(Arc<Error>)

An error that occurred from the io system when using a channel.

HandshakeIoErr(Arc<Error>)

An error from the io system that occurred when trying to connect a channel.

CellErr(Error)

An error occurred in the cell-handling layer.

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.

BadCellAuth

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

BadCircHandshake

A circuit-extension handshake failed.

HandshakeProto(String)

Handshake protocol violation.

HandshakeCertsExpired

Fields

expired_by: Duration

For how long has the circuit been expired?

Handshake broken, maybe due to clock skew.

(If the problem can’t be due to clock skew, we return HandshakeProto instead.)

ChanProto(String)

Protocol violation at the channel level, other than at the handshake stage.

CircProto(String)

Protocol violation at the circuit level

ChannelClosed

Channel is closed.

CircuitClosed

Circuit is closed.

IdRangeFull

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

CircRefused(&'static str)

Couldn’t extend a circuit because the extending relay or the target relay refused our request.

BadStreamAddress

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

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

Stream protocol violation

ChanMismatch(String)

Channel does not match target

Bug(Bug)

There was a programming error somewhere in our code, or the calling code.

ResolveError(ResolveError)

Remote DNS lookup failed.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Formats the value using the given formatter. Read more

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

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

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

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

Read more
👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Converts to this type from the input type.

Converts to this type from the input type.

Converts to this type from the input type.

Converts to this type from the input type.

Return the kind of this error.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Should always be Self

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

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

Uses borrowed data to replace owned data, usually by cloning. Read more

Converts the given value to a String. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more