Struct TsigRcode

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

Response codes for transaction authentication (TSIG).

TSIG and TKEY resource records contain a 16 bit wide error field whose values are an extension of the standard DNS Rcode. While it was intended to also share the same space with the extended response codes used by EDNS (see OptRcode), both used the value 16. To allow distinguish between the two uses of this value, we have two separate types.

The values for all three response code types are defined in the IANA DNS RCODEs registry. This type is complete as of 2019-01-28.

Implementations

impl TsigRcode

pub const NOERROR: TsigRcode = _

No error condition.

(Otherwise known as success.)

Defined in RFC 1035.

pub const FORMERR: TsigRcode = _

Format error.

The name server was unable to interpret the query.

Defined in RFC 1035.

pub const SERVFAIL: TsigRcode = _

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: TsigRcode = _

Name error.

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

Defined in RFC 1035.

pub const NOTIMP: TsigRcode = _

Not implemented.

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

Defined in RFC 1035.

pub const REFUSED: TsigRcode = _

Query refused.

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

Defined in RFC 1035.

pub const YXDOMAIN: TsigRcode = _

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: TsigRcode = _

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: TsigRcode = _

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: TsigRcode = _

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: TsigRcode = _

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.

pub const BADSIG: TsigRcode = _

TSIG signature failure.

The TSIG signature fails to verify.

Defined in RFC 2845.

pub const BADKEY: TsigRcode = _

Key not recognized.

The server did not recognize the key used for generating the signature.

Defined in RFC 2845.

pub const BADTIME: TsigRcode = _

Signature out of time window.

The server time was outside the time interval specified by the request.

Defined in RFC 2845.

pub const BADMODE: TsigRcode = _

Bad TKEY mode.

The mode field in a TKEY resource record contained a mode not supported by the server.

Defined in RFC 2930.

pub const BADNAME: TsigRcode = _

Duplicate key name.

In TKEY records, when establishing a new key, the name used already exists at the server or when deleting a key, a key of this name does not exist.

Defined in RFC 2930.

pub const BADALG: TsigRcode = _

Algorithm not supported.

The value is defined in RFC 2930 but never actually explained. Presumably, it will be returned when the algorithm field of a TKEY record contains a value not supported by the server.

pub const BADTRUNC: TsigRcode = _

Bad truncation.

A TSIG record was received with a MAC too short for the local policy in force.

Defined in RFC 4635.

pub const BADCOOKIE: TsigRcode = _

Bad or missing server cookie.

The request contained a COOKIE option either without a server cookie or with a server cookie that did not validate.

Defined in RFC 7873.

impl TsigRcode

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 TsigRcode

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

impl TsigRcode

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

Trait Implementations

impl Clone for TsigRcode

fn clone(&self) -> TsigRcode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TsigRcode

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

Formats the value using the given formatter.

impl Display for TsigRcode

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

Formats the value using the given formatter.

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

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

Converts to this type from the input type.

impl From<OptRcode> for TsigRcode

fn from(value: OptRcode) -> TsigRcode

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<TsigRcode> for u16

fn from(value: TsigRcode) -> Self

Converts to this type from the input type.

impl From<u16> for TsigRcode

fn from(value: u16) -> Self

Converts to this type from the input type.

impl FromStr for TsigRcode

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 TsigRcode

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 TsigRcode

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

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

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

impl Eq for TsigRcode

impl StructuralPartialEq for TsigRcode