Enum ResolveError 

#[non_exhaustive]
pub enum ResolveError {
    DnsLookup(String),
    NoValidEntries {
        domain: String,
        invalid_entries: Vec<InvalidEntry>,
    },
}

Errors returned by SCION DNS resolution.

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.

DnsLookup(String)

The lookup itself failed, for example on a timeout, a network error, or a server failure. A retry may succeed.

NoValidEntries

The lookup completed without producing a usable SCION address: the TXT records that exist do not parse as TSAR entries, the name has no TXT records, or the name does not exist. A retry does not help for as long as the answer stays valid.

Fields

domain: String

Domain name that was looked up.

invalid_entries: Vec<InvalidEntry>

Invalid entries encountered during parsing or TXT decoding. Empty when the lookup returned no TXT records to parse.

Implementations

impl ResolveError

pub fn is_transient(&self) -> bool

Returns whether the failure is transient, so that a retry may help.

Prefer this over matching the variants: the enum is #[non_exhaustive], and a new variant would silently fall into a caller’s wildcard arm.

Trait Implementations

impl Debug for ResolveError

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

Formats the value using the given formatter.

impl Display for ResolveError

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

Formats the value using the given formatter.

impl Error for ResolveError

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 PartialEq for ResolveError

fn eq(&self, other: &ResolveError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ResolveError