Struct domain::resolv::stub::StubResolver

pub struct StubResolver { /* private fields */ }

Available on crate feature resolv only.

A DNS stub resolver.

This type collects all information making it possible to start DNS queries. You can create a new resolver using the system’s configuration using the new associate function or using your own configuration with from_conf.

Stub resolver values can be cloned relatively cheaply as they keep all information behind an arc.

If you want to run a single query or lookup on a resolver synchronously, you can do so simply by using the run or run_with_conf associated functions.

Implementations

impl StubResolver

pub fn new() -> Self

Creates a new resolver using the system’s default configuration.

pub fn from_conf(conf: ResolvConf) -> Self

Creates a new resolver using the given configuraiton.

pub fn options(&self) -> &ResolvOptions

pub async fn query<N: ToName, Q: Into<Question<N>>>( &self, question: Q ) -> Result<Answer, Error>

impl StubResolver

pub async fn lookup_addr( &self, addr: IpAddr ) -> Result<FoundAddrs<&Self>, Error>

pub async fn lookup_host( &self, qname: impl ToName ) -> Result<FoundHosts<&Self>, Error>

pub async fn search_host( &self, qname: impl ToRelativeName ) -> Result<FoundHosts<&Self>, Error>

pub async fn lookup_srv( &self, service: impl ToRelativeName, name: impl ToName, fallback_port: u16 ) -> Result<Option<FoundSrvs>, SrvError>

Performs an SRV lookup using this resolver.

See the documentation for the lookup_srv function for details.

impl StubResolver

pub fn run<R, T, E, F>(op: F) -> R::Output

where R: Future<Output = Result<T, E>> + Send + 'static, E: From<Error>, F: FnOnce(StubResolver) -> R + Send + 'static,

Available on crate feature resolv-sync only.

Synchronously perform a DNS operation atop a standard resolver.

This associated functions removes almost all boiler plate for the case that you want to perform some DNS operation, either a query or lookup, on a resolver using the system’s configuration and wait for the result.

The only argument is a closure taking a reference to a StubResolver and returning a future. Whatever that future resolves to will be returned.

pub fn run_with_conf<R, T, E, F>(conf: ResolvConf, op: F) -> R::Output

where R: Future<Output = Result<T, E>> + Send + 'static, E: From<Error>, F: FnOnce(StubResolver) -> R + Send + 'static,

Available on crate feature resolv-sync only.

Synchronously perform a DNS operation atop a configured resolver.

This is like run but also takes a resolver configuration for tailor-making your own resolver.

Trait Implementations

impl Debug for StubResolver

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

Formats the value using the given formatter.

impl Default for StubResolver

fn default() -> Self

Returns the “default value” for a type.

impl<'a> Resolver for &'a StubResolver

type Octets = Bytes

type Answer = Answer

The answer returned by a query.

type Query = Pin<Box<dyn Future<Output = Result<Answer, Error>> + Send + 'a>>

The future resolving into an answer.

fn query<N, Q>(&self, question: Q) -> Self::Query

where N: ToName, Q: Into<Question<N>>,

Returns a future answering a question.

impl<'a> SearchNames for &'a StubResolver

type Name = Name<SmallVec<[u8; 24]>>

type Iter = SearchIter<'a>

fn search_iter(&self) -> Self::Iter

Returns an iterator over the search suffixes.