Struct Rcode

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

DNS Response Codes.

The response code of a response indicates what happend on the server when trying to answer the query. The code is a 4 bit value and part of the header of a DNS message.

This response was defined as part of RFC 1035. Later, RFC 2671 defined an extended response code of 12 bits using the lower four bits from the header and eight additional bits stored in the OPT pseudo-record. The type OptRcode represents this extended response code. A third response code, now 16 bit wide, was defined for the transaction authentication mechansim (TSIG) in [RFC 2845] and is represented by TsigRcode.

All three codes share the same name space. Their values are defined in one registry, IANA DNS RCODEs. This type is complete as of 2019-01-28.

Implementations

impl Rcode

pub const NOERROR: Self

No error condition.

(Otherwise known as success.)

Defined in RFC 1035.

pub const FORMERR: Self

Format error.

The name server was unable to interpret the query.

Defined in RFC 1035.

pub const SERVFAIL: Self

Server failure.

The name server was unable to process this query due to a problem with the name server.

Defined in RFC 1035.

pub const NXDOMAIN: Self

Name error.

The domain name given in the query does not exist at the name server.

Defined in RFC 1035.

pub const NOTIMP: Self

Not implemented.

The name server does not support the requested kind of query.

Defined in RFC 1035.

pub const REFUSED: Self

Query refused.

The name server refused to perform the operation requested by the query for policy reasons.

Defined in RFC 1035.

pub const YXDOMAIN: Self

Name exists when it should not.

Returned for an UPDATE query when a domain requested to not exist does in fact exist.

Returned when resolving a DNAME redirection when the resulting name exceeds the length of 255 octets.

Defined in RFC 2136 for the UPDATE query and RFC 6672 for DNAME redirection.

pub const YXRRSET: Self

RR set exists when it should not.

Returned for an UPDATE query when an RRset requested to not exist does in fact exist.

Defined in RFC 2136.

pub const NXRRSET: Self

RR set that should exist does not.

Returned for an UPDATE query when an RRset requested to exist does not.

Defined in RFC 2136.

pub const NOTAUTH: Self

Server not authoritative for zone or client not authorized.

Returned for an UPDATE query when the server is not an authoritative name server for the requested domain.

Returned for queries using TSIG when authorisation failed.

Defined in RFC 2136 for UPDATE and RFC 2845 for TSIG.

pub const NOTZONE: Self

Name not contained in zone.

A name used in the prerequisite or update section is not within the zone given in the zone section.

Defined in RFC 2136.

impl Rcode

pub const fn checked_from_int(value: u8) -> Option<Self>

Creates an rcode from an integer, returning None if invalid.

The rcode is valid if the upper four bits of value are all zero.

pub const fn masked_from_int(value: u8) -> Self

Creates an rcode from an integer, only considering the lower four bits.

This function will ignore the upper four bit of value.

pub const fn to_int(self) -> u8

Returns the integer value for this rcode.

Only the lower 4 bits of the returned octet are used by the rcode. The upper four bits are always zero.

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

Returns the mnemonic for this value if there is one.

Trait Implementations

impl Clone for Rcode

fn clone(&self) -> Rcode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Rcode

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

Formats the value using the given formatter.

impl Display for Rcode

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

Formats the value using the given formatter.

impl From<Rcode> for OptRcode

fn from(value: Rcode) -> OptRcode

Converts to this type from the input type.

impl From<Rcode> for TsigRcode

fn from(value: Rcode) -> TsigRcode

Converts to this type from the input type.

impl From<Rcode> for u8

fn from(value: Rcode) -> u8

Converts to this type from the input type.

impl FromStr for Rcode

type Err = ()

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 Rcode

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 Rcode

fn cmp(&self, other: &Rcode) -> 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 Rcode

fn eq(&self, other: &Rcode) -> 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 Rcode

fn partial_cmp(&self, other: &Rcode) -> 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 TryFrom<u8> for Rcode

type Error = InvalidRcode

The type returned in the event of a conversion error.

fn try_from(value: u8) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Rcode

impl Eq for Rcode

impl StructuralPartialEq for Rcode