Struct Resolver 

pub struct Resolver<P>
where
    P: ConnectionProvider,
{ /* private fields */ }

An asynchronous resolver for DNS generic over async Runtimes.

The lookup methods on Resolver spawn background tasks to perform queries. The futures returned by a Resolver and the corresponding background tasks need not be spawned on the same executor, or be in the same thread.

NOTE If lookup futures returned by a Resolver and the background tasks are spawned on two separate CurrentThread executors, one thread cannot run both executors simultaneously, so the run or block_on functions will cause the thread to deadlock. If both the background work and the lookup futures are intended to be run on the same thread, they should be spawned on the same executor.

Implementations

impl Resolver<TokioRuntimeProvider>

pub fn builder_tokio() -> Result<ResolverBuilder<TokioRuntimeProvider>, NetError>

Constructs a new Tokio based Resolver with the system configuration.

This will use /etc/resolv.conf on Unix OSes and the registry on Windows.

impl<R> Resolver<R>

where R: ConnectionProvider,

pub fn builder(provider: R) -> Result<ResolverBuilder<R>, NetError>

Constructs a new Resolver via ResolverBuilder with the operating system’s configuration.

To use this with Tokio, see TokioResolver::builder_tokio instead.

This will use /etc/resolv.conf on Unix OSes and the registry on Windows.

pub fn builder_with_config( config: ResolverConfig, provider: R, ) -> ResolverBuilder<R>

Construct a new Resolver via ResolverBuilder with the provided configuration.

pub fn set_hosts(&mut self, hosts: Arc<Hosts>)

Customizes the static hosts used in this resolver.

pub async fn lookup( &self, name: impl IntoName, record_type: RecordType, ) -> Result<Lookup, NetError>

Generic lookup for any RecordType

WARNING this interface may change in the future, see if one of the specializations would be better.

Arguments

• name - name of the record to lookup, if name is not a valid domain name, an error will be returned
• record_type - type of record to lookup, all RecordData responses will be filtered to this type

Returns

pub async fn lookup_ip(&self, host: impl IntoName) -> Result<LookupIp, NetError>

Performs a dual-stack DNS lookup for the IP for the given hostname.

See the configuration and options parameters for controlling the way in which A(Ipv4) and AAAA(Ipv6) lookups will be performed. For the least expensive query a fully-qualified-domain-name, FQDN, which ends in a final ., e.g. www.example.com., will only issue one query. Anything else will always incur the cost of querying the ResolverConfig::domain and ResolverConfig::search.

Arguments

• host - string hostname, if this is an invalid hostname, an error will be returned.

pub fn clear_lookup_cache(&self, name: impl IntoName, record_type: RecordType)

Clear the cache for a specific lookup

Arguments

• name - name of the record to clear
• record_type - type of record to clear

pub async fn reverse_lookup( &self, query: impl IntoName, ) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn ipv4_lookup( &self, query: impl IntoName, ) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn ipv6_lookup( &self, query: impl IntoName, ) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn mx_lookup(&self, query: impl IntoName) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn ns_lookup(&self, query: impl IntoName) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn smimea_lookup( &self, query: impl IntoName, ) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn soa_lookup(&self, query: impl IntoName) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn srv_lookup(&self, query: impl IntoName) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn tlsa_lookup( &self, query: impl IntoName, ) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn txt_lookup(&self, query: impl IntoName) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub async fn cert_lookup( &self, query: impl IntoName, ) -> Result<Lookup, NetError>

Performs a lookup for the associated type.

hint queries that end with a ‘.’ are fully qualified names and are cheaper lookups

Arguments

• query - a string which parses to a domain name, failure to parse will return an error

pub fn clear_cache(&self)

Flushes/Removes all entries from the cache

pub fn options(&self) -> &ResolverOpts

Read the options for this resolver.

Trait Implementations

impl<P> Clone for Resolver<P>

where P: Clone + ConnectionProvider,

fn clone(&self) -> Resolver<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P> Debug for Resolver<P>

where P: ConnectionProvider,

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

Formats the value using the given formatter.

impl From<Resolver<TokioRuntimeProvider>> for HickoryDnsResolver

fn from(value: Resolver<TokioRuntimeProvider>) -> HickoryDnsResolver

Converts to this type from the input type.