hickory_proto::xfer::retry_dns_handle

Struct RetryDnsHandle

Source
pub struct RetryDnsHandle<H>
where H: DnsHandle + Unpin + Send,
{ /* private fields */ }
Expand description

Can be used to reattempt queries if they fail

Note: this does not reattempt queries that fail with a negative response. For example, if a query gets a NODATA response from a name server, the query will not be retried. It only reattempts queries that effectively failed to get a response, such as queries that resulted in IO or timeout errors.

Whether an error is retryable by the RetryDnsHandle is determined by the RetryableError trait.

note Current value of this is not clear, it may be removed

Implementations§

Source§

impl<H> RetryDnsHandle<H>
where H: DnsHandle + Unpin + Send,

Source

pub fn new(handle: H, attempts: usize) -> Self

Creates a new Client handler for reattempting requests on failures.

§Arguments
  • handle - handle to the dns connection
  • attempts - number of attempts before failing

Trait Implementations§

Source§

impl<H> Clone for RetryDnsHandle<H>
where H: DnsHandle + Unpin + Send + Clone,

Source§

fn clone(&self) -> RetryDnsHandle<H>

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<H> DnsHandle for RetryDnsHandle<H>
where H: DnsHandle + Send + Unpin + 'static,

Source§

type Response = Pin<Box<dyn Stream<Item = Result<DnsResponse, ProtoError>> + Send + Unpin>>

The associated response from the response stream, this should resolve to the Response messages
Source§

fn send<R: Into<DnsRequest>>(&self, request: R) -> Self::Response

Send a message via the channel in the client Read more
Source§

fn is_verifying_dnssec(&self) -> bool

Only returns true if and only if this DNS handle is validating DNSSEC. Read more
Source§

fn is_using_edns(&self) -> bool

Allow for disabling EDNS
Source§

fn lookup(&self, query: Query, options: DnsRequestOptions) -> Self::Response

A classic DNS query Read more

Auto Trait Implementations§

§

impl<H> Freeze for RetryDnsHandle<H>
where H: Freeze,

§

impl<H> RefUnwindSafe for RetryDnsHandle<H>
where H: RefUnwindSafe,

§

impl<H> Send for RetryDnsHandle<H>

§

impl<H> Sync for RetryDnsHandle<H>

§

impl<H> Unpin for RetryDnsHandle<H>

§

impl<H> UnwindSafe for RetryDnsHandle<H>
where H: UnwindSafe,

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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<T> ToOwned for T
where T: Clone,

Source§

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

Source§

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

Source§

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.
Source§

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

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> MaybeSendSync for T