Enum DecodeError 

#[non_exhaustive]
pub enum DecodeError {
    EdnsNameNotRoot(Box<Name>),
    #[non_exhaustive]
    IncorrectRDataLengthRead {
        read: usize,
        len: usize,
    },
    InsufficientBytes,
    InvalidEmptyRecord,
    InvalidPreviousIndex,
    PointerNotPriorToLabel {
        idx: usize,
        ptr: u16,
    },
    LabelBytesTooLong(usize),
    UnrecognizedLabelCode(u8),
    DomainNameTooLong(usize),
    LabelOverlapsWithOther {
        label: usize,
        other: usize,
    },
    UnknownDigestAlgorithm(u8),
    UnknownDnsClassStr(String),
    UnknownDnsClassValue(u16),
    UnknownRecordTypeStr(String),
    UnknownRecordTypeValue(u16),
    UnrecognizedNsec3Flags(u8),
    UnrecognizedCsyncFlags(u16),
    UnknownNsec3HashAlgorithm(u8),
    RecordAfterSig,
    RecordNotInAdditionalSection(RecordType),
    DuplicateEdns,
    SvcParamsOutOfOrder,
    SvcParamMissingValue,
    NsecBitmapOutOfBounds,
    CaaTagInvalid,
    NaptrFlagsInvalid,
    UnknownAddressFamily(u16),
    Utf8(FromUtf8Error),
}

An error that can occur deep in a decoder This type is kept very small so that function that use it inline often

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.

EdnsNameNotRoot(Box<Name>)

EDNS resource record label is not the root label, although required

#[non_exhaustive]

IncorrectRDataLengthRead

The length of rdata read was not as expected

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

read: usize

The amount of read data

len: usize

The expected length of the data

InsufficientBytes

Insufficient data in the buffer for a read operation

InvalidEmptyRecord

Invalid record with data length 0 in non-update message

InvalidPreviousIndex

slice_from was called with an invalid index

PointerNotPriorToLabel

Pointer points to an index within or after the current name

Fields

idx: usize

index of the label containing this pointer

ptr: u16

location to which the pointer is directing

LabelBytesTooLong(usize)

Label bytes exceeded the limit of 63

UnrecognizedLabelCode(u8)

An unrecognized label code was found

DomainNameTooLong(usize)

A domain name was too long

LabelOverlapsWithOther

Overlapping labels

Fields

label: usize

Start of the label that is overlaps

other: usize

Start of the other label

UnknownDigestAlgorithm(u8)

An unknown digest algorithm was found

UnknownDnsClassStr(String)

An unknown dns class was found

UnknownDnsClassValue(u16)

An unknown dns class value was found

UnknownRecordTypeStr(String)

An unknown record type string was found

UnknownRecordTypeValue(u16)

An unknown record type value was found

UnrecognizedNsec3Flags(u8)

Unrecognized nsec3 flags were found

UnrecognizedCsyncFlags(u16)

Unrecognized csync flags were found

UnknownNsec3HashAlgorithm(u8)

An unknown algorithm type was found

RecordAfterSig

A record appeared after TSIG or SIG(0)

RecordNotInAdditionalSection(RecordType)

A record type was found outside the additional section

DuplicateEdns

More than one EDNS record was found

SvcParamsOutOfOrder

SvcParams were not in strictly increasing order

SvcParamMissingValue

An SvcParam was expected to contain at least one value

NsecBitmapOutOfBounds

NSEC or NSEC3 bitmap data was out of bounds

CaaTagInvalid

CAA tag was invalid (length or characters out of bounds)

NaptrFlagsInvalid

NAPTR flags contained characters outside [a-zA-Z0-9]

UnknownAddressFamily(u16)

An unknown address family was found

Utf8(FromUtf8Error)

Invalid UTF-8 data

Trait Implementations

impl Clone for DecodeError

fn clone(&self) -> DecodeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecodeError

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

Formats the value using the given formatter.

impl Display for DecodeError

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

Formats the value using the given formatter.

impl Error for DecodeError

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<DecodeError> for ParseError

fn from(e: DecodeError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for ProtoError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for DecodeError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.