pub struct StubResolver { /* private fields */ }
Available on crate feature resolv only.
Expand description

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§

source§

impl StubResolver

source

pub fn new() -> Self

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

source

pub fn from_conf(conf: ResolvConf) -> Self

Creates a new resolver using the given configuraiton.

source

pub fn options(&self) -> &ResolvOptions

source

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

source§

impl StubResolver

source

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

source

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

source

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

source

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.

source§

impl StubResolver

source

pub fn run<R, F>(op: F) -> R::Output
where 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.

source

pub fn run_with_conf<R, F>(conf: ResolvConf, op: F) -> R::Output
where 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§

source§

impl Clone for StubResolver

source§

fn clone(&self) -> StubResolver

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for StubResolver

source§

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

Formats the value using the given formatter. Read more
source§

impl Default for StubResolver

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl<'a> Resolver for &'a StubResolver

§

type Octets = Bytes

§

type Answer = Answer

The answer returned by a query. Read more
§

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

The future resolving into an answer.
source§

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

Returns a future answering a question. Read more
source§

impl<'a> SearchNames for &'a StubResolver

§

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

§

type Iter = SearchIter<'a>

source§

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

Returns an iterator over the search suffixes.

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Source, Target> OctetsInto<Target> for Source
where Target: OctetsFrom<Source>,

§

type Error = <Target as OctetsFrom<Source>>::Error

source§

fn try_octets_into( self ) -> Result<Target, <Source as OctetsInto<Target>>::Error>

Performs the conversion.
source§

fn octets_into(self) -> Target
where Self::Error: Into<Infallible>,

Performs an infallible conversion.
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V