4 stable releases

1.2.0 May 22, 2024
1.1.0 May 13, 2024
1.0.1 Apr 8, 2024

#819 in Asynchronous

Download history 43/week @ 2024-06-08 49/week @ 2024-06-15 21/week @ 2024-06-22 1/week @ 2024-06-29 6/week @ 2024-07-06 6/week @ 2024-07-13 1/week @ 2024-07-20 3/week @ 2024-07-27 19/week @ 2024-08-10 25/week @ 2024-08-17 25/week @ 2024-08-24 29/week @ 2024-08-31 16/week @ 2024-09-07 27/week @ 2024-09-14 37/week @ 2024-09-21

110 downloads per month
Used in 12 crates (3 directly)

MIT license

13KB
194 lines

async-send-fd

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

Crates.io MIT licensed Build Status

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

Dependencies

~2–12MB
~141K SLoC