Enum RecursorError 

#[non_exhaustive]
pub enum RecursorError {
    MaxRecordLimitExceeded {
        count: usize,
        record_type: RecordType,
    },
    Message(&'static str),
    Msg(String),
    Negative(AuthorityData),
    ForwardNS(Arc<[ForwardNSData]>),
    Io(Error),
    Net(NetError),
    Timeout,
    RecursionLimitExceeded {
        count: usize,
    },
}

Available on crate feature recursor only.

The error kind for errors that get returned in the crate

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.

MaxRecordLimitExceeded

Maximum record limit was exceeded

Fields

count: usize

number of records

record_type: RecordType

The record type that triggered the 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

Negative(AuthorityData)

Upstream DNS authority returned an empty RRset

ForwardNS(Arc<[ForwardNSData]>)

Upstream DNS authority returned a referral to another set of nameservers in the form of additional NS records.

Io(Error)

An error got returned from IO

Net(NetError)

An error got returned by the hickory-proto crate

Timeout

A request timed out

RecursionLimitExceeded

Could not fetch all records because a recursion limit was exceeded

Fields

count: usize

Number of queries that were made

Implementations

impl RecursorError

pub fn recursion_exceeded(limit: u8, depth: u8, name: &Name) -> Result<(), Self>

Test if the recursion depth has been exceeded, and return an error if it has.

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

Returns the SOA record, if the error contains one

pub fn is_no_records_found(&self) -> bool

Returns true if no records were returned

pub fn is_nx_domain(&self) -> bool

Returns true if the domain does not exist

pub fn is_timeout(&self) -> bool

Returns true if a query timed out

Trait Implementations

impl Clone for RecursorError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecursorError

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

Formats the value using the given formatter.

impl Display for RecursorError

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

Formats the value using the given formatter.

impl Error for RecursorError

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 RecursorError

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

Converts to this type from the input type.

impl From<Error> for RecursorError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<NetError> for RecursorError

fn from(e: NetError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for RecursorError

fn from(e: ProtoError) -> Self

Converts to this type from the input type.

impl From<RecursorError> for NetError

fn from(e: RecursorError) -> Self

Converts to this type from the input type.

impl From<String> for RecursorError

fn from(msg: String) -> Self

Converts to this type from the input type.