hickory_resolver::lookup

Struct Lookup

pub struct Lookup { /* private fields */ }

Expand description

Result of a DNS query when querying for any record type supported by the Hickory DNS Proto library.

For IP resolution see LookupIp, as it has more features for A and AAAA lookups.

Implementations§

impl Lookup

pub fn from_rdata(query: Query, rdata: RData) -> Self

Return new instance with given rdata and the maximum TTL.

pub fn new_with_max_ttl(query: Query, records: Arc<[Record]>) -> Self

Return new instance with given records and the maximum TTL.

pub fn new_with_deadline( query: Query, records: Arc<[Record]>, valid_until: Instant, ) -> Self

Return a new instance with the given records and deadline.

pub fn query(&self) -> &Query

Returns a reference to the Query that was used to produce this result.

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

Returns an iterator over the data of all records returned during the query.

It may include additional record types beyond the queried type, e.g. CNAME.

pub fn dnssec_iter(&self) -> DnssecIter<'_> ⓘ

Available on crate feature dnssec only.

Returns a borrowed iterator of the returned data wrapped in a dnssec Proven type

pub fn record_iter(&self) -> LookupRecordIter<'_> ⓘ

Returns an iterator over all records returned during the query.

It may include additional record types beyond the queried type, e.g. CNAME.

pub fn dnssec_record_iter(&self) -> DnssecLookupRecordIter<'_> ⓘ

Available on crate feature dnssec only.

Returns a borrowed iterator of the returned records wrapped in a dnssec Proven type

pub fn valid_until(&self) -> Instant

Returns the Instant at which this Lookup is no longer valid.

pub fn records(&self) -> &[Record]

Returns an slice over all records that were returned during the query, this can include additional record types beyond the queried type, e.g. CNAME.

pub fn extend_records(&mut self, other: Vec<Record>)

Add new records to this lookup, without creating a new Lookup

Trait Implementations§

impl Clone for Lookup

fn clone(&self) -> Lookup

Returns a copy of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl Debug for Lookup

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

Formats the value using the given formatter. Read more

impl From<CertLookup> for Lookup

fn from(revlookup: CertLookup) -> Self

Converts to this type from the input type.

impl From<Ipv4Lookup> for Lookup

fn from(revlookup: Ipv4Lookup) -> Self

Converts to this type from the input type.

impl From<Ipv6Lookup> for Lookup

fn from(revlookup: Ipv6Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for CertLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for Ipv4Lookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for Ipv6Lookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for LookupIp

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for MxLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for NsLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for ReverseLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for SoaLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for SrvLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for TlsaLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<Lookup> for TxtLookup

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<LookupIp> for Lookup

fn from(lookup: LookupIp) -> Self

Converts to this type from the input type.

impl From<MxLookup> for Lookup

fn from(revlookup: MxLookup) -> Self

Converts to this type from the input type.

impl From<NsLookup> for Lookup

fn from(revlookup: NsLookup) -> Self

Converts to this type from the input type.

impl From<ReverseLookup> for Lookup

fn from(revlookup: ReverseLookup) -> Self

Converts to this type from the input type.

impl From<SoaLookup> for Lookup

fn from(revlookup: SoaLookup) -> Self

Converts to this type from the input type.

impl From<TlsaLookup> for Lookup

fn from(revlookup: TlsaLookup) -> Self

Converts to this type from the input type.

impl From<TxtLookup> for Lookup

fn from(revlookup: TxtLookup) -> Self

Converts to this type from the input type.

impl IntoIterator for Lookup

fn into_iter(self) -> Self::IntoIter

This is not a free conversion, because the RDatas are cloned.

type Item = RData

The type of the elements being iterated over.

type IntoIter = LookupIntoIter

Which kind of iterator are we turning this into?

impl PartialEq for Lookup

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

Tests for self and other values to be equal, and is used by ==.

1.0.0 · Source§

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 Eq for Lookup

impl StructuralPartialEq for Lookup

Auto Trait Implementations§

impl Freeze for Lookup

impl RefUnwindSafe for Lookup

impl Send for Lookup

impl Sync for Lookup

impl Unpin for Lookup

impl UnwindSafe for Lookup

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dst: *mut T)

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

Performs copy-assignment from self to dst. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more