Struct domain_resolv::stub::resolver::StubResolver

pub struct StubResolver(_);

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.

Methods

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

impl StubResolver

pub fn run<R, F>(op: F) -> Result<R::Item, R::Error> where
    R: Future + Send + 'static,
    R::Item: Send + 'static,
    R::Error: Send + 'static,
    F: FnOnce(StubResolver) -> R + Send + 'static, 

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) -> Result<R::Item, R::Error> where
    R: Future + Send + 'static,
    R::Item: Send + 'static,
    R::Error: Send + 'static,
    F: FnOnce(StubResolver) -> R + Send + 'static, 

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 Resolver for StubResolver

type Answer = Answer

The answer returned by a query.

type Query = Query

The future resolving into an answer.

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

Returns a future answering a question.

fn lookup_addr(&self, addr: IpAddr) -> LookupAddr<Self> where
    Self: Sized, 

fn lookup_host<N: ToDname>(&self, name: &N) -> LookupHost<Self> where
    Self: Sized, 

fn search_host<N>(self, name: N) -> SearchHost<Self, N> where
    Self: Sized + SearchNames,
    N: ToRelativeDname, 

fn lookup_srv<S, N>(
    self,
    service: S,
    name: N,
    fallback_port: u16
) -> LookupSrv<Self, S, N> where
    Self: Sized,
    S: ToRelativeDname + Clone + Send + 'static,
    N: ToDname + Send + 'static, 

impl SearchNames for StubResolver

type Iter = SearchIter

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

Returns an iterator over the search suffixes.

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.