Struct HickoryDnsResolver 

pub struct HickoryDnsResolver { /* private fields */ }

Wrapper around an AsyncResolver, which implements the Resolve trait.

Typical use involves instantiating using the Default implementation and then resolving using methods or trait implementations.

The default initialization uses a shared underlying AsyncResolver. If a thread local resolver is required use thread_resolver() to build a resolver with an independently instantiated internal AsyncResolver.

Implementations

impl HickoryDnsResolver

pub fn shared() -> Self

Returns an instance of the shared resolver.

pub async fn resolve_str( &self, name: &str, ) -> Result<impl Iterator<Item = IpAddr> + use<>, ResolveError>

Attempt to resolve a domain name to a set of [‘IpAddr’]s

pub fn thread_resolver() -> Self

Create a (lazy-initialized) resolver that is not shared across threads.

pub fn use_system_resolver(&self)

Swap the primary internal resolver to the system resolver rather than the configured custom resolver.

pub fn use_configured_resolver(&self)

Swap the primary internal resolver to the configured custom resolver rather than the system resolver.

pub fn clear_preresolve(&self)

Clear entries from the static table that would return entries during the pre-resolve stage. This means that all lookups will attempt to use the network resolver again before the static table is consulted.

Entries elevated to pre-resolve from fallback (added from default or using [set_fallback]) will have their cache timeout cleared. Entries added directly to pre-resolve (using [Self::set_static_preresolve`]) will be removed.

pub fn get_static_fallbacks(&self) -> Option<HashMap<String, Vec<IpAddr>>>

Get the current map of hostnames to addresses used in the fallback static lookup stage if one exists.

pub fn set_fallback_addrs(&mut self, addrs: HashMap<String, Vec<IpAddr>>)

Set (or overwrite) the map of addresses used in the fallback static hostname lookup

pub fn get_static_preresolve(&self) -> Option<HashMap<String, Vec<IpAddr>>>

Get the current map of hostnames to addresses used in the preresolve static lookup stage if one exists.

pub fn set_static_preresolve(&mut self, addrs: HashMap<String, Vec<IpAddr>>)

Set (or overwrite) the map of addresses used in the preresolve static hostname lookup

pub fn all_configured_name_servers(&self) -> Vec<NameServerConfig>

Get the list of currently available nameserver configs.

pub fn active_name_servers(&self) -> Vec<NameServerConfig>

Get the list of currently used nameserver configs.

pub async fn trial_nameservers(&self)

Do a trial resolution using each nameserver individually to test which are working and which fail to complete a lookup. This will always try the full set of default configured resolvers.

Trait Implementations

impl Clone for HickoryDnsResolver

fn clone(&self) -> HickoryDnsResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HickoryDnsResolver

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

Formats the value using the given formatter.

impl Default for HickoryDnsResolver

fn default() -> Self

Returns the “default value” for a type.

impl Resolve for HickoryDnsResolver

fn resolve(&self, name: Name) -> Resolving

Performs DNS resolution on a Name. The return type is a future containing an iterator of SocketAddr.