Adding `async_send_fd` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add async-send-fd

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

async-send-fd = "1.2.0"

The async_send_fd library will be automatically available globally. Read the async_send_fd library documentation.

Back to the crate overview.

Readme

async-send-fd

A library for sending and receiving Unix file descriptors over async UnixStream connections.

Overview

The crate is a library for sending and receiving Unix file descriptors over Tokio or Smol UnixStream connections. You can send RawFd or UnixStream using provided interfaces.

See test_smol_stream.rs or test_tokio_stream.rs for code examples.

Creating tokio::net::UnixStream from RawFd

If you make a Tokio UnixStream from a raw file descriptor made by an OS call (e.g. UnixStream::pair), you must make it set_nonblocking(true), otherwise receivers scheduler will block writing into the socket ⚠️

Smol UnixStream does it automatically if created using UnixStream::from(Async::new(stream))

Transfering socket pair ownership

Note: the library closes Tokio stream if sent into another process.

Features

tokio - for Tokio support
smol - for Smol support

Adding async_send_fd library as a dependency

Adding `async_send_fd` library as a dependency