Struct trust_dns::rr::Record

pub struct Record { /* fields omitted */ }

Resource records are storage value in DNS, into which all key/value pair data is stored.

RFC 1035, DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION, November 1987

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                     /
    /                                               /
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+

Methods

impl Record

pub fn new() -> Record

Creates a default record, use the setters to build a more useful object.

There are no optional elements in this object, defaults are an empty name, type A, class IN, ttl of 0 and the 0.0.0.0 ip address.

pub fn with(name: Name, rr_type: RecordType, ttl: u32) -> Record

Create a record with the specified initial values.

Arguments

• name - name of the resource records
• rr_type - the record type
• ttl - time-to-live is the amount of time this record should be cached before refreshing

pub fn from_rdata(name: Name, ttl: u32, rdata: RData) -> Record

Create a record with the specified initial values.

Arguments

• name - name of the resource records
• ttl - time-to-live is the amount of time this record should be cached before refreshing
• rdata - record data to associate with the Record

pub fn set_name(&mut self, name: Name) -> &mut Record

NAME            a domain name to which this resource record pertains.

pub fn set_rr_type(&mut self, rr_type: RecordType) -> &mut Record

TYPE            two octets containing one of the RR type codes.  This
                field specifies the meaning of the data in the RDATA
                field.

pub fn set_record_type(&mut self, rr_type: RecordType) -> &mut Record

TYPE            two octets containing one of the RR type codes.  This
                field specifies the meaning of the data in the RDATA
                field.

pub fn set_dns_class(&mut self, dns_class: DNSClass) -> &mut Record

CLASS           two octets which specify the class of the data in the
                RDATA field.

pub fn set_ttl(&mut self, ttl: u32) -> &mut Record

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.

pub fn set_rdata(&mut self, rdata: RData) -> &mut Record

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.

pub fn name(&self) -> &Name

Returns the name of the record

pub fn rr_type(&self) -> RecordType

Returns the type of the RData in the record

pub fn record_type(&self) -> RecordType

Returns the type of the RecordData in the record

pub fn dns_class(&self) -> DNSClass

Returns the DNSClass of the Record, generally IN fro internet

pub fn ttl(&self) -> u32

Returns the time-to-live of the record, for caching purposes

pub fn rdata(&self) -> &RData

Returns the Record Data, i.e. the record information

pub fn rdata_mut(&mut self) -> &mut RData

Returns a mutable reference to the Record Data

pub fn unwrap_rdata(self) -> RData

Returns the RData consuming the Record

Trait Implementations

impl<'a> From<&'a Edns> for Record

fn from(value: &'a Edns) -> Record

This returns a Resource Record that is formatted for Edns(0). Note: the rcode_high value is only part of the rcode, the rest is part of the base

impl From<Record> for RecordSet

fn from(record: Record) -> RecordSet

Performs the conversion.

impl<'a> From<&'a Record> for Edns

fn from(value: &'a Record) -> Edns

Performs the conversion.

impl Default for Record

fn default() -> Record

Returns the "default value" for a type.

impl Clone for Record

fn clone(&self) -> Record

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Eq for Record

impl PartialEq<Record> for Record

fn eq(&self, other: &Record) -> bool

Equality or records, as defined by RFC 2136, DNS Update, April 1997

  1.1.1. Two RRs are considered equal if their NAME, CLASS, TYPE,
  RDLENGTH and RDATA fields are equal.  Note that the time-to-live
  (TTL) field is explicitly excluded from the comparison.

  1.1.2. The rules for comparison of character strings in names are
  specified in [RFC1035 2.3.3]. i.e. case insensitive

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl BinEncodable for Record

fn emit(&self, encoder: &mut BinEncoder) -> Result<(), ProtoError>

Write the type to the stream

fn to_bytes(&self) -> Result<Vec<u8>, ProtoError>

Returns the object in binary form

impl PartialOrd<Record> for Record

fn partial_cmp(&self, other: &Record) -> Option<Ordering>

Canonical ordering as defined by RFC 4034, DNSSEC Resource Records, March 2005

6.2.  Canonical RR Form

   For the purposes of DNS security, the canonical form of an RR is the
   wire format of the RR where:

   1.  every domain name in the RR is fully expanded (no DNS name
       compression) and fully qualified;

   2.  all uppercase US-ASCII letters in the owner name of the RR are
       replaced by the corresponding lowercase US-ASCII letters;

   3.  if the type of the RR is NS, MD, MF, CNAME, SOA, MB, MG, MR, PTR,
       HINFO, MINFO, MX, HINFO, RP, AFSDB, RT, SIG, PX, NXT, NAPTR, KX,
       SRV, DNAME, A6, RRSIG, or NSEC, all uppercase US-ASCII letters in
       the DNS names contained within the RDATA are replaced by the
       corresponding lowercase US-ASCII letters;

   4.  if the owner name of the RR is a wildcard name, the owner name is
       in its original unexpanded form, including the "*" label (no
       wildcard substitution); and

   5.  the RR's TTL is set to its original value as it appears in the
       originating authoritative zone or the Original TTL field of the
       covering RRSIG RR.

#[must_use] fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use] fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use] fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use] fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl IntoRecordSet for Record

fn into_record_set(self) -> RecordSet

Deprecated:

use From/Into

Performs the conversion to a RecordSet

impl<'r> BinDecodable<'r> for Record

fn read(decoder: &mut BinDecoder<'r>) -> Result<Record, ProtoError>

parse a resource record line example: WARNING: the record_bytes is 100% consumed and destroyed in this parsing process

fn from_bytes(bytes: &'r [u8]) -> Result<Self, ProtoError>

Returns the object in binary form

impl Debug for Record

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

Formats the value using the given formatter.

impl Ord for Record

fn cmp(&self, other: &Record) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.