Enum tor_guardmgr::PickGuardError

#[non_exhaustive]
pub enum PickGuardError {
    AllGuardsDown {
        retry_at: Option<Instant>,
    },
    NoGuardsUsable,
    AllFallbacksDown {
        retry_at: Option<Instant>,
    },
    NoCandidatesAvailable,
    Internal(Bug),
}

A error caused by a failure to pick a guard.

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.

AllGuardsDown

Fields

retry_at: Option<Instant>

The next time at which any guard will be retriable.

All members of the current sample were down.

NoGuardsUsable

Some guards were running, but all of them were either blocked on pending circuits at other guards, unusable for the provided purpose, or filtered out.

AllFallbacksDown

Fields

retry_at: Option<Instant>

The next time at which any fallback directory will back available.

We have no usable fallback directories.

NoCandidatesAvailable

Tried to select guards or fallbacks from an empty list.

Internal(Bug)

An internal programming error occurred.

Trait Implementations

impl Clone for PickGuardError

fn clone(&self) -> PickGuardError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PickGuardError

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

Formats the value using the given formatter.

impl Display for PickGuardError

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

Formats the value using the given formatter.

impl Error for PickGuardError

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

fn from(source: Bug) -> Self

Converts to this type from the input type.

impl HasKind for PickGuardError

fn kind(&self) -> ErrorKind

Return the kind of this error.

impl HasRetryTime for PickGuardError

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, 

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