Struct ConnectFailure

pub struct ConnectFailure {
    declined: Vec<(ConnPtDescription, ConnectError)>,
    final_desc: Option<ConnPtDescription>,
    pub(crate) final_error: ConnectError,
}

A set of errors encountered while trying to connect to the Arti process

Fields

declined: Vec<(ConnPtDescription, ConnectError)>

A list of all the declined connect points we encountered, and how they failed.

final_desc: Option<ConnPtDescription>

A description of where we found the final error (if it’s an abort.)

final_error: ConnectError

The final error explaining why we couldn’t connect.

This is either an abort, an AllAttemptsDeclined, or an error that prevented the search process from even beginning.

Implementations

impl ConnectFailure

pub fn fatal_error_origin(&self) -> Option<&ConnPtDescription>

If this attempt failed because of a fatal error that made a connect point attempt abort, return a description of the origin of that connect point.

pub fn declined_attempt_outcomes( &self, ) -> impl Iterator<Item = (&ConnPtDescription, &ConnectError)>

For each connect attempt that failed nonfatally, return a description of the origin of that connect point, and the error that caused it to fail.

pub fn display_verbose(&self) -> ConnectFailureVerboseFmt<'_>

Return a helper type to format this error, and all of its internal errors recursively.

Unlike tor_error::Report, this method includes not only fatal errors, but also information about connect attempts that failed nonfatally.

Trait Implementations

impl Clone for ConnectFailure

fn clone(&self) -> ConnectFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectFailure

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

Formats the value using the given formatter.

impl Display for ConnectFailure

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

Formats the value using the given formatter.

impl Error for ConnectFailure

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 IntoFfiError for ConnectFailure

fn status(&self) -> FfiStatus

Return the status

fn as_error(&self) -> Option<&(dyn StdError + 'static)>

Return this type as an Error, if it is one.

fn message(&self) -> String

Return a message for this error.

fn os_error_code(&self) -> Option<i32>

Return the OS error code (if any) underlying this error.

fn into_error_response(self) -> Option<ErrorResponse>

Consume this error and return an ErrorResponse