Struct DnsQueryResult 

pub struct DnsQueryResult {
    pub name: String,
    pub record_type: RecordType,
    pub server: Option<String>,
    pub answered_locally: bool,
    pub status: DnsStatus,
    pub flags: Vec<String>,
    pub answers: Vec<DnsRecord>,
    pub authority: Vec<DnsRecord>,
    pub failed_types: Vec<FailedType>,
    pub wildcard: Option<WildcardProbe>,
    pub query_time_ms: u64,
}

A full DNS query result, the way dig reports it.

Built by DnsResolver::query. A negative answer is a result, not an error: NXDOMAIN, NODATA (NOERROR with no records of the type), SERVFAIL and REFUSED all come back as a DnsQueryResult with that status. An Err means there is no response to report: invalid input (a malformed name, a bare-domain SRV query), a nameserver that was refused (a private or reserved address) or did not resolve, or a transport failure (timeout, no connection).

Fields

name: String

The normalized name that was queried (for an IP-literal PTR query, the reverse-DNS name).

record_type: RecordType

server: Option<String>

The nameserver spec the caller passed (as given), or None for the default upstream (Google Public DNS) — and None when no server was asked at all (answered_locally).

answered_locally: bool

True when no query was sent: the name is under a special-use zone (RFC 6761) that the resolver answers itself — localhost, 127.in-addr.arpa and 1.0…0.ip6.arpa with loopback answers (NODATA for other types), invalid and onion with NXDOMAIN. server is then None, flags empty and wildcard None.

status: DnsStatus

flags: Vec<String>

Header flags as dig prints them, lowercase, in dig’s order: qr aa tc rd ra ad cd — the ones the response header set, whatever its status.

Empty only for an answer no server gave (answered_locally): seer never invents flags, nor passes on the header hickory makes up for its own answer.

answers: Vec<DnsRecord>

The ANSWER section in order: the CNAME chain first, then the records of the requested type — every record under its real owner name. MX records are ordered by preference, as resolve orders them. For ANY: all sub-query answers merged in the ANY type order, identical records deduplicated.

A negative answer lists its chain too: NXDOMAIN beside a CNAME chain means the chain’s last target does not exist (RFC 6604 §2), and NODATA that the target has no records of the type — the queried name exists, since it owns the first CNAME.

authority: Vec<DnsRecord>

The AUTHORITY section as the server sent it: for a negative answer the SOA of the zone that gave it, when the server sent one; for a referral the NS records of the zone it refers to (referral_zone); beside an answer, whatever the server added (an authoritative server may list its zone’s NS records). An ANY answer with records carries none (see answers).

failed_types: Vec<FailedType>

For ANY: the types whose sub-query failed — no server responded, or it could not be sent — so the merged answer says nothing about them. Empty for any other type and when every sub-query was answered (omitted from the serialized form then).

wildcard: Option<WildcardProbe>

Wildcard probe outcome; None when the probe was not run or did not complete.

query_time_ms: u64

Wall-clock time of the main query in milliseconds.

Implementations

impl DnsQueryResult

pub fn is_nodata(&self) -> bool

NOERROR with no answer of the requested type (for ANY: no answers at all) — the name exists, without records of the type. A referral is not NODATA (referral_zone).

pub fn referral_zone(&self) -> Option<&str>

The zone this response refers the query to, when it is a referral rather than an answer: NOERROR with no answer of the requested type, the AA (authoritative) flag clear, NS records in AUTHORITY and no SOA there (RFC 2308 §2.2) — the zone is the NS records’ owner.

A server that is neither authoritative for the name nor recursive (an @server serving only a parent zone) answers this way, pointing at the servers of the zone below it. Unlike NODATA, a referral says nothing about whether the name exists. An authoritative response is never a referral, even with its own zone’s NS records in AUTHORITY beside an unfollowed CNAME.

pub fn cname_chain(&self) -> impl Iterator<Item = &DnsRecord>

The CNAME records at the front of answers.

pub fn records(&self) -> impl Iterator<Item = &DnsRecord>

The answers that are not part of the CNAME chain (for a CNAME query: the CNAME itself).

Trait Implementations

impl Clone for DnsQueryResult

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DnsQueryResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DnsQueryResult

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DnsQueryResult

impl PartialEq for DnsQueryResult

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DnsQueryResult

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DnsQueryResult