Struct domain::resolv::stub::StubResolver

pub struct StubResolver { /* private fields */ }

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>

Performs an SRV lookup using this resolver.

See the documentation for the lookup_srv function for details.

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

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 = Dname<SmallVec<[u8; 24]>>

type Iter = SearchIter<'a>

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

Returns an iterator over the search suffixes.