Enum ConnectError

#[non_exhaustive]
pub enum ConnectError {
    BadEnvironment,
    CannotParse(LoadError),
    CannotResolvePath(CfgPathError),
    CannotResolveConnectPoint(ResolveError),
    CannotConnect(ConnectError),
    InvalidBanner,
    AllAttemptsDeclined,
    RelativeConnectFile,
    AuthenticationFailed(ErrorResponse),
    AuthenticationNotSupported,
    BadMessage(Arc<Error>),
    ProtoError(ProtoError),
    ServerAddressMismatch {
        ours: String,
        theirs: String,
    },
    CookieMismatch,
    LoadCookie(CookieAccessError),
}

An error while trying to connect to the Arti process.

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.

BadEnvironment

Unable to parse connect points from an environment variable.

CannotParse(LoadError)

We were unable to load and/or parse a given connect point.

CannotResolvePath(CfgPathError)

The path used to specify a connect file couldn’t be resolved.

CannotResolveConnectPoint(ResolveError)

A parsed connect point couldn’t be resolved.

CannotConnect(ConnectError)

IO error while connecting to Arti.

InvalidBanner

Opened a connection, but didn’t get a banner message.

(This isn’t a BadMessage, since it is likelier to represent something that isn’t pretending to be Arti at all than it is to be a malfunctioning Arti.)

AllAttemptsDeclined

All attempted connect points were declined, and none were aborted.

RelativeConnectFile

A connect file or directory was given as a relative path. (Only absolute paths are supported).

AuthenticationFailed(ErrorResponse)

One of our authentication messages received an error.

AuthenticationNotSupported

The connect point uses an RPC authentication type we don’t support.

BadMessage(Arc<Error>)

We couldn’t decode one of the responses we got.

ProtoError(ProtoError)

A protocol error occurred during negotiations.

ServerAddressMismatch

The server thinks it is listening on an address where we don’t expect to find it. This can be misconfiguration or an attempted MITM attack.

Fields

ours: String

The address we think the server has

theirs: String

The address that the server says it has.

CookieMismatch

The server tried to prove knowledge of a cookie file, but its proof was incorrect.

LoadCookie(CookieAccessError)

We were unable to access the configured cookie file.

Trait Implementations

impl Clone for ConnectError

fn clone(&self) -> ConnectError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConnectError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ConnectError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ConnectError

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

fn from(source: ConnectError) -> Self

Converts to this type from the input type.

impl From<CookieAccessError> for ConnectError

fn from(source: CookieAccessError) -> Self

Converts to this type from the input type.

impl From<LoadError> for ConnectError

fn from(source: LoadError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for ConnectError

fn from(source: ProtoError) -> Self

Converts to this type from the input type.

impl From<ResolveError> for ConnectError

fn from(source: ResolveError) -> Self

Converts to this type from the input type.

impl HasClientErrorAction for ConnectError

fn client_action(&self) -> ClientErrorAction

Return the action that an RPC client should take based on this error.