Enum NetError 

#[non_exhaustive]
pub enum NetError {
    Busy,
    Decode(Arc<ToStrError>),
    Dns(DnsError),
    H2(Arc<Error>),
    H3(Arc<StreamError>),
    Message(&'static str),
    Msg(String),
    ParseInt(ParseIntError),
    NoConnections,
    Proto(ProtoError),
    Io(Arc<Error>),
    Timeout,
    QuinnConnect(ConnectError),
    QuinnConnection(ConnectionError),
    QuinnWriteError(WriteError),
    QuinnReadError(ReadExactError),
    QuinnStreamError(ClosedStream),
    QuinnConfigError(ConfigError),
    QuinnTlsConfigError(NoInitialCipherSuite),
    QuinnUnknownStreamError,
    QuicMessageIdNot0(u16),
    RustlsError(Error),
    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.

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).

Decode(Arc<ToStrError>)

Available on crate features __https or __h3 only.

Unable to decode HTTP header value to string

Dns(DnsError)

Semantic DNS errors

H2(Arc<Error>)

Available on crate feature __https only.

An HTTP/2 related error

H3(Arc<StreamError>)

Available on crate feature __h3 only.

An HTTP/3 related error

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

QuinnConnect(ConnectError)

Available on crate feature __quic only.

A Quinn (Quic) connection error occurred

QuinnConnection(ConnectionError)

Available on crate feature __quic only.

A Quinn (QUIC) connection error occurred

QuinnWriteError(WriteError)

Available on crate feature __quic only.

A Quinn (QUIC) write error occurred

QuinnReadError(ReadExactError)

Available on crate feature __quic only.

A Quinn (QUIC) read error occurred

QuinnStreamError(ClosedStream)

Available on crate feature __quic only.

A Quinn (QUIC) stream error occurred

QuinnConfigError(ConfigError)

Available on crate feature __quic only.

A Quinn (QUIC) configuration error occurred

QuinnTlsConfigError(NoInitialCipherSuite)

Available on crate feature __quic only.

QUIC TLS config must include an AES-128-GCM cipher suite

QuinnUnknownStreamError

Available on crate feature __quic only.

Unknown QUIC stream used

QuicMessageIdNot0(u16)

Available on crate feature __quic only.

A quic message id should always be 0

RustlsError(Error)

Available on crate feature __tls only.

A Rustls error occurred

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

Formats the value using the given formatter.

impl Display for NetError

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

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) -> Self

Converts to this type from the input type.

impl From<ClosedStream> for NetError

fn from(source: ClosedStream) -> Self

Converts to this type from the input type.

impl From<ConfigError> for NetError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<ConnectError> for NetError

fn from(source: ConnectError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for NetError

fn from(source: ConnectionError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for NetError

fn from(e: DecodeError) -> Self

Converts to this type from the input type.

impl From<DnsError> for NetError

fn from(source: DnsError) -> Self

Converts to this type from the input type.

impl From<Error> for NetError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for NetError

Available on crate feature __https only.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for NetError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<NetError> for DnsResponseStream

fn from(e: NetError) -> Self

Converts to this type from the input type.

impl From<NoInitialCipherSuite> for NetError

fn from(source: NoInitialCipherSuite) -> Self

Converts to this type from the input type.

impl From<NoRecords> for NetError

fn from(no_records: NoRecords) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for NetError

fn from(source: ParseIntError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for NetError

fn from(source: ProtoError) -> Self

Converts to this type from the input type.

impl From<ReadExactError> for NetError

fn from(source: ReadExactError) -> Self

Converts to this type from the input type.

impl From<StreamError> for NetError

Available on crate feature __h3 only.

fn from(e: StreamError) -> Self

Converts to this type from the input type.

impl From<String> for NetError

fn from(msg: String) -> Self

Converts to this type from the input type.

impl From<ToStrError> for NetError

Available on crate features __https or __h3 only.

fn from(e: ToStrError) -> Self

Converts to this type from the input type.

impl From<WriteError> for NetError

fn from(source: WriteError) -> Self

Converts to this type from the input type.