Enum DnsError 

#[non_exhaustive]
pub enum DnsError {
    Timeout {
        meta: Meta,
    },
    NoResponse {
        meta: Meta,
    },
    ResolveBoth {
        ipv4: Box<DnsError>,
        ipv6: Box<DnsError>,
        meta: Meta,
    },
    MissingHost {
        meta: Meta,
    },
    Resolve {
        source: AnyError,
        meta: Meta,
    },
    InvalidResponse {
        meta: Meta,
    },
    NxDomain {
        meta: Meta,
    },
}

Potential errors related to DNS operations.

Distinct, matchable causes have their own variant, such as Self::NxDomain (a nameserver reported the name does not exist, unlike a transient transport or timeout failure). Any other cause is reported as Self::Resolve, whose [AnyError] source carries the underlying error.

The resolver backing this crate is an implementation detail and its error types are not part of the public API. If you depend on n0-dns-resolver directly and need the exact reason, downcast a Self::Resolve source:

if let DnsError::Resolve { source, .. } = &err {
    if let Some(inner) = source.downcast_ref::<n0_dns_resolver::Error>() {
        // match on `inner` for the specific failure
    }
}

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

Fields

meta: Meta

Captured call-site metadata

NoResponse

Fields

meta: Meta

Captured call-site metadata

ResolveBoth

Fields

ipv4: Box<DnsError>

ipv6: Box<DnsError>

meta: Meta

Captured call-site metadata

MissingHost

Fields

meta: Meta

Captured call-site metadata

Resolve

A resolution failure not covered by another variant.

Downcast the source (see the type-level docs) to recover the specific cause.

Fields

source: AnyError

meta: Meta

Captured call-site metadata

InvalidResponse

Fields

meta: Meta

Captured call-site metadata

NxDomain

The domain name does not exist (NXDOMAIN).

A nameserver authoritatively reported that the name does not exist, as opposed to a transient transport or timeout failure, so retrying will not make the lookup succeed.

Fields

meta: Meta

Captured call-site metadata

Trait Implementations

impl Debug for DnsError

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

Formats the value using the given formatter.

impl Display for DnsError

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

Formats the value using the given formatter.

impl Error for DnsError

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<AnyError> for DnsError

fn from(source: AnyError) -> Self

Converts to this type from the input type.

impl From<DnsError> for AnyError

fn from(value: DnsError) -> AnyError

Converts to this type from the input type.

impl From<DnsError> for LookupError

fn from(source: DnsError) -> Self

Converts to this type from the input type.

impl StackError for DnsError

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

Returns this error as a std error reference.

fn into_std(self: Box<Self>) -> Box<dyn Error + Send + Sync>

Returns this error as a std error.

fn as_dyn(&self) -> &dyn StackError

Returns this error as a dyn StackError.

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

Returns the next source in the chain, if any.

fn meta(&self) -> Option<&Meta>

Returns metadata captured at creation time, if available.

fn source(&self) -> Option<ErrorRef<'_>>

Returns the next source in the chain, if any.

fn is_transparent(&self) -> bool

Returns whether this error is transparent and should be skipped in reports.

fn as_ref(&self) -> ErrorRef<'_>

Returns this error as an [ErrorRef].

fn stack(&self) -> Chain<'_>

Returns an iterator over this error followed by its sources.

fn sources(&self) -> Chain<'_>

Returns an iterator over sources of this error (skipping self).

fn report(&self) -> Report<'_>

Returns a [Report] to output the error with configurable formatting.