Struct domain_resolv::stub::StubResolver

pub struct StubResolver { /* fields omitted */ }

A DNS stub resolver.

This type collects all information making it possible to start DNS queries. You can create a new resoler 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>

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>> + 'a>>

The future resolving into an answer.

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

Returns a future answering a question.

impl<'a> SearchNames for &'a StubResolver

type Name = SearchSuffix

type Iter = SearchIter<'a>

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

Returns an iterator over the search suffixes.