Trait ByteStream 

pub trait ByteStream:
    AsyncRead
    + AsyncWrite
    + Send
    + Sync
    + Unpin {
    // Required methods
    fn peer_endpoint(&self) -> Option<Endpoint>;
    fn local_endpoint(&self) -> Option<Endpoint>;

    // Provided method
    fn peer_certificates(&self) -> Option<Vec<CertificateDer<'static>>> { ... }
}

Byte-oriented bidirectional stream.

Implemented by TCP, TLS, Unix, and QUIC streams. Extends AsyncRead + AsyncWrite for compatibility with IO libraries. Use framed() to convert into a FramedConn with a codec.

Required Methods

fn peer_endpoint(&self) -> Option<Endpoint>

Remote peer address, if available.

fn local_endpoint(&self) -> Option<Endpoint>

Local address, if available.

Provided Methods

fn peer_certificates(&self) -> Option<Vec<CertificateDer<'static>>>

Peer certificate chain when the underlying transport authenticates the peer with X.509 (TLS, QUIC). Returns None for plain TCP/Unix and other unauthenticated transports.

Trait Implementations

impl ClientLayer<Box<dyn ByteStream>, Box<dyn ByteStream>> for Socks5Layer

async fn handshake( &self, stream: Box<dyn ByteStream>, ) -> Result<Box<dyn ByteStream>>

impl ClientLayer<Box<dyn ByteStream>, Box<dyn ByteStream>> for TlsLayer

async fn handshake( &self, stream: Box<dyn ByteStream>, ) -> Result<Box<dyn ByteStream>>

impl<C> ClientLayer<Box<dyn ByteStream>, WsConn<C>> for WsLayer<C>

where C: Codec<Message> + Clone + Send + Sync + 'static, C::Message: Send + Sync + 'static, C::Error: From<Error> + Into<Error> + Send + Sync,

async fn handshake(&self, stream: Box<dyn ByteStream>) -> Result<WsConn<C>>

impl ServerLayer<Box<dyn ByteStream>, Box<dyn ByteStream>> for TlsLayer

async fn handshake( &self, stream: Box<dyn ByteStream>, ) -> Result<Box<dyn ByteStream>>

impl<C> ServerLayer<Box<dyn ByteStream>, WsConn<C>> for WsLayer<C>

where C: Codec<Message> + Clone + Send + Sync + 'static, C::Message: Send + Sync + 'static, C::Error: From<Error> + Into<Error> + Send + Sync,

async fn handshake(&self, stream: Box<dyn ByteStream>) -> Result<WsConn<C>>

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl ByteStream for QuicBiStream

impl ByteStream for TcpByteStream

impl ByteStream for TlsByteStream

impl ByteStream for UnixByteStream