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 const fn to_mnemonic_str(self) -> Option<&'static str>

Returns the mnemonic as a &str for this value if there is one

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 duplicate 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 ZonefileFmt for TsigRcode

fn fmt(&self, p: &mut impl Formatter) -> Result

Format the item as zonefile fmt into a fmt::Formatter

fn display_zonefile( &self, display_kind: DisplayKind, ) -> ZoneFileDisplay<'_, Self>

Display the item as a zonefile

impl Copy for TsigRcode

impl Eq for TsigRcode

impl StructuralPartialEq for TsigRcode