Struct DnsExchange

pub struct DnsExchange { /* private fields */ }

This is a generic Exchange implemented over multiplexed DNS connection providers.

The underlying DnsRequestSender is expected to multiplex any I/O connections. DnsExchange assumes that the underlying stream is responsible for this.

Implementations

impl DnsExchange

pub fn from_stream<S, TE>(stream: S) -> (Self, DnsExchangeBackground<S, TE>)

where S: DnsRequestSender + 'static + Send + Unpin,

Initializes a TcpStream with an existing tcp::TcpStream.

This is intended for use with a TcpListener and Incoming.

Arguments

• stream - the established IO stream for communication

pub fn from_stream_with_receiver<S, TE>( stream: S, receiver: Receiver<OneshotDnsRequest>, sender: BufDnsRequestStreamHandle, ) -> (Self, DnsExchangeBackground<S, TE>)

where S: DnsRequestSender + 'static + Send + Unpin,

Wraps a stream where a sender and receiver have already been established

pub fn connect<F, S, TE>(connect_future: F) -> DnsExchangeConnect<F, S, TE>

where F: Future<Output = Result<S, ProtoError>> + 'static + Send + Unpin, S: DnsRequestSender + 'static + Send + Unpin, TE: Time + Unpin,

Returns a future, which itself wraps a future which is awaiting connection.

The connect_future should be lazy.

pub fn error<F, S, TE>(error: ProtoError) -> DnsExchangeConnect<F, S, TE>

where F: Future<Output = Result<S, ProtoError>> + 'static + Send + Unpin, S: DnsRequestSender + 'static + Send + Unpin, TE: Time + Unpin,

Returns a future that returns an error immediately.

Trait Implementations

impl Clone for DnsExchange

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DnsHandle for DnsExchange

type Response = DnsExchangeSend

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

fn send<R: Into<DnsRequest> + Unpin + Send + 'static>( &self, request: R, ) -> Self::Response

Send a message via the channel in the client

fn is_verifying_dnssec(&self) -> bool

Only returns true if and only if this DNS handle is validating DNSSEC.

fn is_using_edns(&self) -> bool

Allow for disabling EDNS

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

A classic DNS query