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: ToDname, 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 ToDname
) -> Result<FoundHosts<&Self>, Error>

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

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

impl StubResolver

pub fn run<R, F>(op: F) -> R::Outputwhere
    R: Future + Send + 'static,
    R::Output: Send + 'static,
    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, F>(conf: ResolvConf, op: F) -> R::Outputwhere
    R: Future + Send + 'static,
    R::Output: Send + 'static,
    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 Clone for StubResolver

fn clone(&self) -> StubResolver

Returns a copy of the value.

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

Performs copy-assignment from source.

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, Global>>

The future resolving into an answer.

fn query<N, Q>(&self, question: Q) -> Self::Querywhere
    N: ToDname,
    Q: Into<Question<N>>,

Returns a future answering a question.

impl<'a> SearchNames for &'a StubResolver

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

type Iter = SearchIter<'a>

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

Returns an iterator over the search suffixes.