Struct trust_dns_proto::xfer::DnsExchange

#[must_use = "futures do nothing unless polled"]pub struct DnsExchange { /* fields omitted */ }

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.

Trait Implementations

impl Clone for DnsExchange

fn clone(&self) -> Self

Returns a copy of the value.

pub 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 future, this should resolve to the Response message

type Error = ProtoError

Error of the response, generally this will be ProtoError

fn send<R: Into<DnsRequest> + Unpin + Send + 'static>(
    &mut 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 lookup(&mut self, query: Query, options: DnsRequestOptions) -> Self::Response

A classic DNS query