Enum DnsRecord

pub enum DnsRecord {
    A(DnsName, Ipv4Addr),
    AAAA(DnsName, Ipv6Addr),
    CNAME(DnsName, DnsName),
    Unknown(DnsName, DnsType),
}

4.1.3. Resource record format

The answer, authority, and additional sections all share the same format: a variable number of resource records, where the number of records is specified in the corresponding count field in the header. Each resource record has the following format:

                                1  1  1  1  1  1
  0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|                                               |
/                                               /
/                      NAME                     /
|                                               |
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|                      TYPE                     |
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|                     CLASS                     |
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|                      TTL                      |
|                                               |
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
|                   RDLENGTH                    |
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--|
/                     RDATA                     /
/                                               /
+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+

where:

• NAME: a domain name to which this resource record pertains.
• TYPE: two octets containing one of the RR type codes. This field specifies the meaning of the data in the RDATA field.
• CLASS: two octets which specify the class of the data in the RDATA field.
• TTL: a 32 bit unsigned integer that specifies the time interval (in seconds) that the resource record may be cached before it should be discarded. Zero values are interpreted to mean that the RR can only be used for the transaction in progress, and should not be cached.
• RDLENGTH: an unsigned 16 bit integer that specifies the length in octets of the RDATA field.
• RDATA: a variable length string of octets that describes the resource. The format of this information varies according to the TYPE and CLASS of the resource record. For example, the if the TYPE is A and the CLASS is IN, the RDATA field is a 4 octet ARPA Internet address.

https://datatracker.ietf.org/doc/html/rfc1035#section-4.1.3

Variants

A(DnsName, Ipv4Addr)

AAAA(DnsName, Ipv6Addr)

CNAME(DnsName, DnsName)

Unknown(DnsName, DnsType)

Implementations

impl DnsRecord

pub fn read_rdata<const N: usize>( buf: &mut FixedBuf<N>, ) -> Result<FixedBuf<65535>, DnsError>

Errors

Returns an error when buf does not contain a valid resource record.

pub fn write_rdata<const N: usize>( bytes: &[u8], out: &mut FixedBuf<N>, ) -> Result<(), DnsError>

Errors

Returns an error when buf is full or bytes is longer than 65,535 bytes.

pub fn new_a(name: &str, ipv4_addr: &str) -> Result<Self, String>

Errors

Returns an error when name is not a valid DNS name or ipv4_addr is not a valid IPv4 address.

pub fn new_aaaa(name: &str, ipv6_addr: &str) -> Result<Self, String>

Errors

Returns an error when name is not a valid DNS name or ipv6_addr is not a valid IPv6 address.

pub fn new_cname(name: &str, target: &str) -> Result<Self, String>

Errors

Returns an error when name or target are not both valid DNS names.

pub fn name(&self) -> &DnsName

pub fn typ(&self) -> DnsType

pub fn read<const N: usize>(buf: &mut FixedBuf<N>) -> Result<Self, DnsError>

Errors

Returns an error when buf does not contain a valid resource record.

pub fn write<const N: usize>( &self, out: &mut FixedBuf<N>, ) -> Result<(), DnsError>

Errors

Returns an error when buf is full.

Trait Implementations

impl Clone for DnsRecord

fn clone(&self) -> DnsRecord

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DnsRecord

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

Formats the value using the given formatter.

impl Hash for DnsRecord

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 DnsRecord

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

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

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

impl StructuralPartialEq for DnsRecord