Struct UnknownRecordData

pub struct UnknownRecordData<Octs> { /* private fields */ }

A type for parsing any type of record data.

This type accepts any record type and stores the plain, unparsed record data as an octets sequence.

Because some record types allow compressed domain names in their record data, this type cannot be used safely with these record types. For these record types, the structure of the content needs to be known.

RFC 3597 limits the types for which compressed names are allowed in the record data to those defined in RFC 1035 itself. Specific types for all these record types exist in domain::rdata::rfc1035.

Ultimately, you should only use this type for record types for which there is no implementation available in this crate. The two types AllRecordData and ZoneRecordData provide a convenient way to always use the correct record data type.

Implementations

impl<Octs> UnknownRecordData<Octs>

pub fn from_octets(rtype: Rtype, data: Octs) -> Result<Self, LongRecordData>

where Octs: AsRef<[u8]>,

Creates generic record data from a bytes value contain the data.

pub fn rtype(&self) -> Rtype

Returns the record type this data is for.

pub fn data(&self) -> &Octs

Returns a reference to the record data.

pub fn scan<S: Scanner<Octets = Octs>>( rtype: Rtype, scanner: &mut S, ) -> Result<Self, S::Error>

where Octs: AsRef<[u8]>,

Scans the record data.

This isn’t implemented via Scan, because we need the record type.

pub fn scan_without_marker<S: Scanner<Octets = Octs>>( rtype: Rtype, scanner: &mut S, ) -> Result<Self, S::Error>

where Octs: AsRef<[u8]>,

Scans the record data assuming that the marker has been skipped.

pub fn parse_any_rdata<'a, SrcOcts>( rtype: Rtype, parser: &mut Parser<'a, SrcOcts>, ) -> Result<Self, ParseError>

where SrcOcts: Octets<Range<'a> = Octs> + ?Sized + 'a,

Parses any record type as unknown record data.

This is an associated function rather than an impl of ParseAnyRecordData because some record types must not be parsed as unknown data as they can contain compressed domain names.

Trait Implementations

impl<Octs, Other> CanonicalOrd<UnknownRecordData<Other>> for UnknownRecordData<Octs>

where Octs: AsRef<[u8]>, Other: AsRef<[u8]>,

fn canonical_cmp(&self, other: &UnknownRecordData<Other>) -> Ordering

Returns the canonical ordering between self and other.

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

Returns whether self is canonically less than other.

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

Returns whether self is canonically less than or equal to other.

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

Returns whether self is canonically greater than other.

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

Returns whether self is canonically greater than or equal to other.

impl<Octs: Clone> Clone for UnknownRecordData<Octs>

fn clone(&self) -> UnknownRecordData<Octs>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Octs: AsRef<[u8]>> ComposeRecordData for UnknownRecordData<Octs>

fn rdlen(&self, _compress: bool) -> Option<u16>

Returns the length of the record data if available.

fn compose_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the wire format of the record data into target.

fn compose_canonical_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the canonical wire format of the record data into target.

fn compose_len_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the record data prefixed with its length.

fn compose_canonical_len_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the record data prefixed with its length.

impl<Octs: AsRef<[u8]>> Debug for UnknownRecordData<Octs>

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

Formats the value using the given formatter.

impl<Octs: AsRef<[u8]>> Display for UnknownRecordData<Octs>

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

Formats the value using the given formatter.

impl<O, N> From<UnknownRecordData<O>> for AllRecordData<O, N>

fn from(value: UnknownRecordData<O>) -> Self

Converts to this type from the input type.

impl<O, N> From<UnknownRecordData<O>> for ZoneRecordData<O, N>

fn from(value: UnknownRecordData<O>) -> Self

Converts to this type from the input type.

impl<Octs, SrcOcts> OctetsFrom<UnknownRecordData<SrcOcts>> for UnknownRecordData<Octs>

where Octs: OctetsFrom<SrcOcts>,

type Error = <Octs as OctetsFrom<SrcOcts>>::Error

fn try_octets_from( source: UnknownRecordData<SrcOcts>, ) -> Result<Self, Self::Error>

Performs the conversion.

impl<Octs: AsRef<[u8]>> Ord for UnknownRecordData<Octs>

fn cmp(&self, other: &Self) -> 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<'a, Octs: Octets + ?Sized> ParseRecordData<'a, Octs> for UnknownRecordData<Octs::Range<'a>>

fn parse_rdata( rtype: Rtype, parser: &mut Parser<'a, Octs>, ) -> Result<Option<Self>, ParseError>

Parses the record data.

impl<Octs, Other> PartialEq<UnknownRecordData<Other>> for UnknownRecordData<Octs>

where Octs: AsRef<[u8]>, Other: AsRef<[u8]>,

fn eq(&self, other: &UnknownRecordData<Other>) -> 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<Octs, Other> PartialOrd<UnknownRecordData<Other>> for UnknownRecordData<Octs>

where Octs: AsRef<[u8]>, Other: AsRef<[u8]>,

fn partial_cmp(&self, other: &UnknownRecordData<Other>) -> 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<Octs: AsRef<[u8]>> RecordData for UnknownRecordData<Octs>

fn rtype(&self) -> Rtype

Returns the record type associated with this record data instance.

impl<Octs: AsRef<[u8]>> Eq for UnknownRecordData<Octs>