Struct libp2p::dns::Transport

pub struct Transport<T, R> { /* private fields */ }

A Transport for performing DNS lookups when dialing Multiaddresses. You shouldn’t need to use this type directly. Use tokio::Transport or [async_std::Transport] instead.

Implementations

impl<T> Transport<T, AsyncResolver<GenericConnector<TokioRuntimeProvider>>>

pub fn system( inner: T, ) -> Result<Transport<T, AsyncResolver<GenericConnector<TokioRuntimeProvider>>>, Error>

Creates a new Transport from the OS’s DNS configuration and defaults.

pub fn custom( inner: T, cfg: ResolverConfig, opts: ResolverOpts, ) -> Result<Transport<T, AsyncResolver<GenericConnector<TokioRuntimeProvider>>>, Error>

Creates a Transport with a custom resolver configuration and options.

Trait Implementations

impl<T, R> Debug for Transport<T, R>

where T: Debug, R: Debug,

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

Formats the value using the given formatter.

impl<T, R> Transport for Transport<T, R>

where T: Transport + Send + Unpin + 'static, <T as Transport>::Error: Send, <T as Transport>::Dial: Send, R: Clone + Send + Sync + Resolver + 'static,

type Output = <T as Transport>::Output

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

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

An error that occurred during connection setup.

type ListenerUpgrade = MapErr<<T as Transport>::ListenerUpgrade, fn(_: <T as Transport>::Error) -> <Transport<T, R> 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) -> <Transport<T, R> as Transport>::Error>, Pin<Box<dyn Future<Output = Result<<Transport<T, R> as Transport>::Output, <Transport<T, R> as Transport>::Error>> + Send>>>

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

fn listen_on( &mut self, id: ListenerId, addr: Multiaddr, ) -> Result<(), TransportError<<Transport<T, R> as Transport>::Error>>

Listens on the given Multiaddr for inbound connections with a provided ListenerId.

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

Remove a listener.

fn dial( &mut self, addr: Multiaddr, ) -> Result<<Transport<T, R> as Transport>::Dial, TransportError<<Transport<T, R> as Transport>::Error>>

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

fn dial_as_listener( &mut self, addr: Multiaddr, ) -> Result<<Transport<T, R> as Transport>::Dial, TransportError<<Transport<T, R> as Transport>::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 Transport<T, R>>, cx: &mut Context<'_>, ) -> Poll<TransportEvent<<Transport<T, R> as Transport>::ListenerUpgrade, <Transport<T, R> as Transport>::Error>>

Poll for TransportEvents.

fn map<F, O>(self, f: F) -> Map<Self, F>

where Self: Sized, 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 Self: Sized, 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 Self: Sized, 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 Self: Sized, C: FnOnce(Self::Output, ConnectedPoint) -> F, F: TryFuture<Ok = O>, <F as TryFuture>::Error: Error + 'static,

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

fn upgrade(self, version: Version) -> Builder<Self>

where Self: Sized, Self::Error: 'static,

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