Enum tor_ptmgr::err::PtError

#[non_exhaustive]
pub enum PtError {
    Timeout,
    ClientTransportsUnsupported(Vec<String>),
    TransportGaveError {
        transport: String,
        message: String,
    },
    ChildProtocolViolation(String),
    ProtocolViolation(String),
    UnsupportedVersion,
    ProxyError(String),
    ChildGone,
    ChildReadFailed(Arc<Error>),
    ChildSpawnFailed {
        path: PathBuf,
        error: Arc<Error>,
    },
    IpcParseFailed {
        line: String,
        error: String,
    },
    StatedirCreateFailed {
        path: PathBuf,
        error: Arc<Error>,
    },
    PathExpansionFailed {
        path: CfgPath,
        error: CfgPathError,
    },
    NotAFile {
        path: PathBuf,
    },
    Spawn {
        cause: Arc<SpawnError>,
    },
    UnconfiguredTransportDueToConcurrentReconfiguration,
    Internal(Bug),
}

An error spawning or managing a pluggable transport.

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.

Timeout

We failed to launch a set of pluggable transports in the provided deadline.

ClientTransportsUnsupported(Vec<String>)

A PT binary does not support a set of pluggable transports.

TransportGaveError

A PT binary failed to launch a pluggable transport, and reported an error message.

Fields

transport: String

The transport that failed.

message: String

The failure message.

ChildProtocolViolation(String)

A pluggable transport binary failed to understand us.

ProtocolViolation(String)

A pluggable transport binary violated the protocol.

UnsupportedVersion

A pluggable transport binary doesn’t support version 1 of the IPC protocol.

ProxyError(String)

A pluggable transport binary couldn’t use the provided proxy URI.

ChildGone

A pluggable transport binary quit or was stopped.

ChildReadFailed(Arc<Error>)

An error was encountered communicating with a pluggable transport binary. The PT is no longer usable.

ChildSpawnFailed

We couldn’t spawn a pluggable transport binary as a child process.

Fields

path: PathBuf

The binary path we tried to execute.

error: Arc<Error>

The I/O error returned.

IpcParseFailed

We failed to parse something a pluggable transport sent us.

Fields

line: String

The offending line.

error: String

The error encountered parsing it.

StatedirCreateFailed

We couldn’t create a state directory.

Fields

path: PathBuf

The offending path.

error: Arc<Error>

The error encountered.

PathExpansionFailed

We couldn’t expand a path.

Fields

path: CfgPath

The offending path.

error: CfgPathError

The error encountered.

NotAFile

A binary path does not have the syntax of a file name.

For example, it ends in a slash, indicating a directory.

Fields

path: PathBuf

The offending path.

Spawn

Unable to spawn reactor task.

Fields

cause: Arc<SpawnError>

What happened when we tried to spawn it.

UnconfiguredTransportDueToConcurrentReconfiguration

The requested transport was found to be missing due to racing with reconfiguration

Internal(Bug)

The pluggable transport reactor failed.

Trait Implementations

impl Clone for PtError

fn clone(&self) -> PtError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PtError

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

Formats the value using the given formatter.

impl Display for PtError

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

Formats the value using the given formatter.

impl Error for PtError

fn source(&self) -> Option<&(dyn Error + 'static)>

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<Bug> for PtError

fn from(source: Bug) -> Self

Converts to this type from the input type.

impl HasKind for PtError

fn kind(&self) -> ErrorKind

Return the kind of this error.

impl HasRetryTime for PtError

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, Self: Sized,

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

impl AbstractPtError for PtError