Enum NetError 

#[non_exhaustive]
pub enum NetError {
    BadTransactionId,
    Busy,
    Dns(DnsError),
    Message(&'static str),
    Msg(String),
    ParseInt(ParseIntError),
    NoConnections,
    Proto(ProtoError),
    Io(Arc<Error>),
    Timeout,
    QueryCaseMismatch,
}

The error type for network protocol errors (UDP, TCP, QUIC, H2, H3)

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.

BadTransactionId

A UDP response was received with an incorrect transaction id, likely indicating a cache-poisoning attempt.

Busy

The underlying resource is too busy

This is a signal that an internal resource is too busy. The intended action should be tried again, ideally after waiting for a little while for the situation to improve. Alternatively, the action could be tried on another resource (for example, in a name server pool).

Dns(DnsError)

Semantic DNS errors

Message(&'static str)

An error with an arbitrary message, referenced as &’static str

Msg(String)

An error with an arbitrary message, stored as String

ParseInt(ParseIntError)

Unable to parse header value as number

NoConnections

No connections available

Proto(ProtoError)

Protocol error from higher layers

Io(Arc<Error>)

An error got returned from IO

Timeout

A request timed out

QueryCaseMismatch

Case randomization is enabled, and a server did not echo a query name back with the same case.

Implementations

impl NetError

pub fn is_nx_domain(&self) -> bool

Returns true if the domain does not exist

pub fn is_no_records_found(&self) -> bool

Returns true if the error represents NoRecordsFound

pub fn into_soa(self) -> Option<Box<Record<SOA>>>

Returns the SOA record, if the error contains one

Trait Implementations

impl Clone for NetError

fn clone(&self) -> NetError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetError

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

Formats the value using the given formatter.

impl Display for NetError

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

Formats the value using the given formatter.

impl Error for NetError

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<&'static str> for NetError

fn from(msg: &'static str) -> NetError

Converts to this type from the input type.

impl From<DnsError> for NetError

fn from(source: DnsError) -> NetError

Converts to this type from the input type.

impl From<Error> for NetError

fn from(e: Error) -> NetError

Converts to this type from the input type.

impl From<NetError> for DnsResponseStream

fn from(e: NetError) -> DnsResponseStream

Converts to this type from the input type.

impl From<NoRecords> for NetError

fn from(no_records: NoRecords) -> NetError

Converts to this type from the input type.

impl From<ParseIntError> for NetError

fn from(source: ParseIntError) -> NetError

Converts to this type from the input type.

impl From<ProtoError> for NetError

fn from(source: ProtoError) -> NetError

Converts to this type from the input type.

impl From<String> for NetError

fn from(msg: String) -> NetError

Converts to this type from the input type.