Struct libp2p_yamux::Yamux

pub struct Yamux<S>(_);

A Yamux connection.

This implementation isn’t capable of detecting when the underlying socket changes its address, and no StreamMuxerEvent::AddressChange event is ever emitted.

Implementations

impl<C> Yamux<Incoming<C>> where
    C: AsyncRead + AsyncWrite + Send + Unpin + 'static, 

pub fn new(io: C, cfg: Config, mode: Mode) -> Self

Create a new Yamux connection.

impl<C> Yamux<LocalIncoming<C>> where
    C: AsyncRead + AsyncWrite + Unpin + 'static, 

pub fn local(io: C, cfg: Config, mode: Mode) -> Self

Create a new Yamux connection (which is ).

Trait Implementations

impl<S> Debug for Yamux<S>

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

Formats the value using the given formatter.

impl<S> StreamMuxer for Yamux<S> where
    S: Stream<Item = Result<Stream, YamuxError>> + Unpin, 

type Substream = Stream

Type of the object that represents the raw substream where data can be read and written.

type OutboundSubstream = OpenSubstreamToken

Future that will be resolved when the outgoing substream is open.

type Error = YamuxError

Error type of the muxer

fn poll_event(
    &self,
    c: &mut Context<'_>
) -> Poll<Result<StreamMuxerEvent<Self::Substream>, YamuxError>>

Polls for a connection-wide event.

fn open_outbound(&self) -> Self::OutboundSubstream

Opens a new outgoing substream, and produces the equivalent to a future that will be resolved when it becomes available.

fn poll_outbound(
    &self,
    c: &mut Context<'_>,
    _: &mut OpenSubstreamToken
) -> Poll<Result<Self::Substream, YamuxError>>

Polls the outbound substream.

fn destroy_outbound(&self, _: Self::OutboundSubstream)

Destroys an outbound substream future. Use this after the outbound substream has finished, or if you want to interrupt it.

fn read_substream(
    &self,
    c: &mut Context<'_>,
    s: &mut Self::Substream,
    b: &mut [u8]
) -> Poll<Result<usize, YamuxError>>

Reads data from a substream. The behaviour is the same as futures::AsyncRead::poll_read.

fn write_substream(
    &self,
    c: &mut Context<'_>,
    s: &mut Self::Substream,
    b: &[u8]
) -> Poll<Result<usize, YamuxError>>

Write data to a substream. The behaviour is the same as futures::AsyncWrite::poll_write.

fn flush_substream(
    &self,
    c: &mut Context<'_>,
    s: &mut Self::Substream
) -> Poll<Result<(), YamuxError>>

Flushes a substream. The behaviour is the same as futures::AsyncWrite::poll_flush.

fn shutdown_substream(
    &self,
    c: &mut Context<'_>,
    s: &mut Self::Substream
) -> Poll<Result<(), YamuxError>>

Attempts to shut down the writing side of a substream. The behaviour is similar to AsyncWrite::poll_close.

fn destroy_substream(&self, _: Self::Substream)

Destroys a substream.

fn close(&self, c: &mut Context<'_>) -> Poll<Result<(), YamuxError>>

Closes this StreamMuxer.

fn flush_all(&self, _: &mut Context<'_>) -> Poll<Result<(), YamuxError>>

Flush this StreamMuxer.

pub fn is_remote_acknowledged(&self) -> bool

👎 Deprecated:

This method is unused and will be removed in the future

Returns true if the remote has shown any sign of activity after the muxer has been open.