Struct ExtendedErrorCode

pub struct ExtendedErrorCode(/* private fields */);

Extended DNS error codes.

A complementary data can be put in EDNS opt, providing additional information about the cause of DNS errors. Defined in RFC 8914. Current registered values can be found in IANA registry.

Implementations

impl ExtendedErrorCode

pub const OTHER: ExtendedErrorCode = _

The error in question falls into a category that does not match known extended error codes. Implementations SHOULD include an EXTRA-TEXT value to augment this error code with additional information.

pub const UNSUPPORTED_DNSKEY_ALGORITHM: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but a DNSKEY RRset contained only unsupported DNSSEC algorithms.

pub const UNSUPPORTED_DS_DIGEST_TYPE: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but a DS RRset contained only unsupported Digest Types.

pub const STALE_ANSWER: ExtendedErrorCode = _

The resolver was unable to resolve the answer within its time limits and decided to answer with previously cached data instead of answering with an error. This is typically caused by problems communicating with an authoritative server, possibly as result of a denial of service (DoS) attack against another network. (See also Code 19.)

pub const FORGED_ANSWER: ExtendedErrorCode = _

For policy reasons (legal obligation or malware filtering, for instance), an answer was forged. Note that this should be used when an answer is still provided, not when failure codes are returned instead. See Blocked (15), Censored (16), and Filtered (17) for use when returning other response codes.

pub const DNSSEC_INDETERMINATE: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but validation ended in the Indeterminate state RFC 4035.

pub const DNSSEC_BOGUS: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but validation ended in the Bogus state.

pub const SIGNATURE_EXPIRED: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but no signatures are presently valid and some (often all) are expired.

pub const SIGNATURE_NOT_YET_VALID: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but no signatures are presently valid and at least some are not yet valid.

pub const DNSKEY_MISSING: ExtendedErrorCode = _

A DS record existed at a parent, but no supported matching DNSKEY record could be found for the child.

pub const RRSIGS_MISSING: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but no RRSIGs could be found for at least one RRset where RRSIGs were expected.

pub const NO_ZONE_KEY_BIT_SET: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but no Zone Key Bit was set in a DNSKEY.

pub const NSEC_MISSING: ExtendedErrorCode = _

The resolver attempted to perform DNSSEC validation, but the requested data was missing and a covering NSEC or NSEC3 was not provided.

pub const CACHED_ERROR: ExtendedErrorCode = _

The resolver is returning the SERVFAIL RCODE from its cache.

pub const NOT_READY: ExtendedErrorCode = _

The server is unable to answer the query, as it was not fully functional when the query was received.

pub const BLOCKED: ExtendedErrorCode = _

The server is unable to respond to the request because the domain is on a blocklist due to an internal security policy imposed by the operator of the server resolving or forwarding the query.

pub const CENSORED: ExtendedErrorCode = _

The server is unable to respond to the request because the domain is on a blocklist due to an external requirement imposed by an entity other than the operator of the server resolving or forwarding the query. Note that how the imposed policy is applied is irrelevant (in-band DNS filtering, court order, etc.).

pub const FILTERED: ExtendedErrorCode = _

The server is unable to respond to the request because the domain is on a blocklist as requested by the client. Functionally, this amounts to “you requested that we filter domains like this one.”

pub const PROHIBITED: ExtendedErrorCode = _

An authoritative server or recursive resolver that receives a query from an “unauthorized” client can annotate its REFUSED message with this code. Examples of “unauthorized” clients are recursive queries from IP addresses outside the network, blocklisted IP addresses, local policy, etc.

pub const STALE_NXDOMAIN_ANSWER: ExtendedErrorCode = _

The resolver was unable to resolve an answer within its configured time limits and decided to answer with a previously cached NXDOMAIN answer instead of answering with an error. This may be caused, for example, by problems communicating with an authoritative server, possibly as result of a denial of service (DoS) attack against another network. (See also Code 3.)

pub const NOT_AUTHORITATIVE: ExtendedErrorCode = _

An authoritative server that receives a query with the Recursion Desired (RD) bit clear, or when it is not configured for recursion for a domain for which it is not authoritative, SHOULD include this EDE code in the REFUSED response. A resolver that receives a query with the RD bit clear SHOULD include this EDE code in the REFUSED response.

pub const NOT_SUPPORTED: ExtendedErrorCode = _

The requested operation or query is not supported.

pub const NO_REACHABLE_AUTHORITY: ExtendedErrorCode = _

The resolver could not reach any of the authoritative name servers (or they potentially refused to reply).

pub const NETWORK_ERROR: ExtendedErrorCode = _

An unrecoverable error occurred while communicating with another server.

pub const INVALID_DATA: ExtendedErrorCode = _

The authoritative server cannot answer with data for a zone it is otherwise configured to support. Examples of this include its most recent zone being too old or having expired.

pub const INVALID_QUERY_TYPE: ExtendedErrorCode = _

The requested resource record type should not appear in a query.

impl ExtendedErrorCode

pub const COMPOSE_LEN: u16 = 2u16

pub const fn from_int(value: u16) -> Self

Returns a value from its raw integer value.

pub const fn to_int(self) -> u16

Returns the raw integer value for a value.

pub fn from_mnemonic(m: &[u8]) -> Option<Self>

Returns a value from a well-defined mnemonic.

pub const fn to_mnemonic(self) -> Option<&'static [u8]>

Returns the mnemonic for this value if there is one.

This will also return a mnemonic if a well-defined variant is hidden in a Int variant.

pub fn parse<'a, Octs: AsRef<[u8]> + ?Sized>( parser: &mut Parser<'a, Octs>, ) -> Result<Self, ParseError>

pub fn compose<Target: OctetsBuilder + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

impl ExtendedErrorCode

pub fn from_bytes(bytes: &[u8]) -> Option<Self>

impl ExtendedErrorCode

pub fn scan<S: Scanner>(scanner: &mut S) -> Result<Self, S::Error>

Trait Implementations

impl Clone for ExtendedErrorCode

fn clone(&self) -> ExtendedErrorCode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ExtendedErrorCode

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

Formats the value using the given formatter.

impl Display for ExtendedErrorCode

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

Formats the value using the given formatter.

impl<'a> From<&'a ExtendedErrorCode> for u16

fn from(value: &'a ExtendedErrorCode) -> Self

Converts to this type from the input type.

impl<Octs> From<ExtendedErrorCode> for ExtendedError<Octs>

fn from(code: ExtendedErrorCode) -> Self

Converts to this type from the input type.

impl From<ExtendedErrorCode> for u16

fn from(value: ExtendedErrorCode) -> Self

Converts to this type from the input type.

impl From<u16> for ExtendedErrorCode

fn from(value: u16) -> Self

Converts to this type from the input type.

impl FromStr for ExtendedErrorCode

type Err = FromStrError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for ExtendedErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ExtendedErrorCode

fn cmp(&self, other: &ExtendedErrorCode) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ExtendedErrorCode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for ExtendedErrorCode

fn partial_cmp(&self, other: &ExtendedErrorCode) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for ExtendedErrorCode

impl Eq for ExtendedErrorCode

impl StructuralPartialEq for ExtendedErrorCode