Struct libp2p_dns::GenDnsConfig

pub struct GenDnsConfig<T, C, P>where
    C: DnsHandle<Error = ResolveError>,
    P: ConnectionProvider<Conn = C>,{ /* private fields */ }

A Transport wrapper for performing DNS lookups when dialing Multiaddresses.

Trait Implementations

impl<T, C, P> Debug for GenDnsConfig<T, C, P>where
    C: DnsHandle<Error = ResolveError>,
    P: ConnectionProvider<Conn = C>,
    T: Debug,

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

Formats the value using the given formatter.

impl<T, C, P> Transport for GenDnsConfig<T, C, P>where
    T: Transport + Send + Unpin + 'static,
    T::Error: Send,
    T::Dial: Send,
    C: DnsHandle<Error = ResolveError>,
    P: ConnectionProvider<Conn = C>,

type Output = <T as Transport>::Output

The result of a connection setup process, including protocol upgrades.

type Error = DnsErr<<T as Transport>::Error>

An error that occurred during connection setup.

type ListenerUpgrade = MapErr<<T as Transport>::ListenerUpgrade, fn(<T as Transport>::Error) -> <GenDnsConfig<T, C, P> as Transport>::Error>

A pending Output for an inbound connection, obtained from the Transport stream.

type Dial = Either<MapErr<<T as Transport>::Dial, fn(<T as Transport>::Error) -> <GenDnsConfig<T, C, P> as Transport>::Error>, Pin<Box<dyn Future<Output = Result<<GenDnsConfig<T, C, P> as Transport>::Output, <GenDnsConfig<T, C, P> as Transport>::Error>> + Send + 'static, Global>>>

A pending Output for an outbound connection, obtained from dialing.

fn listen_on(
    &mut self,
    addr: Multiaddr
) -> Result<ListenerId, TransportError<Self::Error>>

Listens on the given [Multiaddr] for inbound connections.

fn remove_listener(&mut self, id: ListenerId) -> bool

Remove a listener.

fn dial(
    &mut self,
    addr: Multiaddr
) -> Result<Self::Dial, TransportError<Self::Error>>

Dials the given [Multiaddr], returning a future for a pending outbound connection.

fn dial_as_listener(
    &mut self,
    addr: Multiaddr
) -> Result<Self::Dial, TransportError<Self::Error>>

As Transport::dial but has the local node act as a listener on the outgoing connection.

fn address_translation(
    &self,
    server: &Multiaddr,
    observed: &Multiaddr
) -> Option<Multiaddr>

Performs a transport-specific mapping of an address observed by a remote onto a local listen address to yield an address for the local node that may be reachable for other peers.

fn poll(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<TransportEvent<Self::ListenerUpgrade, Self::Error>>

Poll for TransportEvents.

fn map<F, O>(self, f: F) -> Map<Self, F>where
    F: FnOnce(Self::Output, ConnectedPoint) -> O,

Applies a function on the connections created by the transport.

fn map_err<F, E>(self, f: F) -> MapErr<Self, F>where
    F: FnOnce(Self::Error) -> E,

Applies a function on the errors generated by the futures of the transport.

fn or_transport<U>(self, other: U) -> OrTransport<Self, U>where
    U: Transport,
    <U as Transport>::Error: 'static,

Adds a fallback transport that is used when encountering errors while establishing inbound or outbound connections.

fn and_then<C, F, O>(self, f: C) -> AndThen<Self, C>where
    C: FnOnce(Self::Output, ConnectedPoint) -> F,
    F: TryFuture<Ok = O>,
    <F as TryFuture>::Error: 'static + Error,

Applies a function producing an asynchronous result to every connection created by this transport.

fn upgrade(self, version: Version) -> Builder<Self>where
    Self::Error: 'static,

Begins a series of protocol upgrades via an upgrade::Builder.