Trait UnixStreamExt 

pub trait UnixStreamExt {
    // Required methods
    fn send_fds(&self, data: &[u8], fds: &[impl AsFd]) -> Result<usize>;
    fn recv_fds<const N: usize>(&self) -> Result<ReceivedFds>;
    fn recv_fds_into<const N: usize>(
        &self,
        data_buf: &mut [u8],
    ) -> Result<(usize, Vec<OwnedFd>)>;
}

Extension trait for UnixStream adding fd-passing convenience methods.

Required Methods

fn send_fds(&self, data: &[u8], fds: &[impl AsFd]) -> Result<usize>

Send data plus borrowed file descriptors over the stream.

Caller retains ownership of the fds.

fn recv_fds<const N: usize>(&self) -> Result<ReceivedFds>

Receive data and up to N file descriptors.

Allocates an internal 4 KiB data buffer plus an oversized cmsg buffer that prevents kernel-level fd leaks. Surplus fds beyond N are closed automatically.

fn recv_fds_into<const N: usize>( &self, data_buf: &mut [u8], ) -> Result<(usize, Vec<OwnedFd>)>

Like recv_fds but writes data into a caller-supplied buffer. Returns (bytes_read, fds).

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl UnixStreamExt for UnixStream

fn send_fds(&self, data: &[u8], fds: &[impl AsFd]) -> Result<usize>

fn recv_fds<const N: usize>(&self) -> Result<ReceivedFds>

fn recv_fds_into<const N: usize>( &self, data_buf: &mut [u8], ) -> Result<(usize, Vec<OwnedFd>)>

Implementors