Enum hickory_server::authority::AuthLookup

pub enum AuthLookup {
    Empty,
    Records {
        answers: LookupRecords,
        additionals: Option<LookupRecords>,
    },
    SOA(LookupRecords),
    AXFR {
        start_soa: LookupRecords,
        records: LookupRecords,
        end_soa: LookupRecords,
    },
}

The result of a lookup on an Authority

Lifetimes

• 'c - the catalogue lifetime
• 'r - the recordset lifetime, subset of ’c
• 'q - the queries lifetime

Variants

Empty

No records

Records

Fields

answers: LookupRecords

Authoritative answers

additionals: Option<LookupRecords>

Optional set of LookupRecords

Records

SOA(LookupRecords)

Soa only differs from Records in that the lifetime on the name is from the authority, and not the query

AXFR

Fields

start_soa: LookupRecords

The first SOA record in an AXFR response

records: LookupRecords

The records to return

end_soa: LookupRecords

The last SOA record of an AXFR (matches the first)

An axfr starts with soa, chained to all the records, then another soa…

Implementations

impl AuthLookup

pub fn answers( answers: LookupRecords, additionals: Option<LookupRecords> ) -> Self

Construct an answer with additional section

pub fn is_empty(&self) -> bool

Returns true if either the associated Records are empty, or this is a NameExists or NxDomain

pub fn was_empty(&self) -> bool

This is an NxDomain or NameExists, and has no associated records

this consumes the iterator, and verifies it is empty

pub fn iter(&self) -> AuthLookupIter<'_>

Conversion to an iterator

pub fn unwrap_records(self) -> LookupRecords

Does not panic, but will return no records if it is not of that type

pub fn take_additionals(&mut self) -> Option<LookupRecords>

Takes the additional records, leaving behind None

Trait Implementations

impl Debug for AuthLookup

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

Formats the value using the given formatter.

impl Default for AuthLookup

fn default() -> Self

Returns the “default value” for a type.

impl From<LookupRecords> for AuthLookup

fn from(lookup: LookupRecords) -> Self

Converts to this type from the input type.

impl<'a> IntoIterator for &'a AuthLookup

type Item = &'a Record

The type of the elements being iterated over.

type IntoIter = AuthLookupIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl LookupObject for AuthLookup

fn is_empty(&self) -> bool

Returns true if either the associated Records are empty, or this is a NameExists or NxDomain

fn iter<'a>(&'a self) -> Box<dyn Iterator<Item = &'a Record> + Send + 'a>

Conversion to an iterator

fn take_additionals(&mut self) -> Option<Box<dyn LookupObject>>

For CNAME and similar records, this is an additional set of lookup records