4 stable releases

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

#842 in Asynchronous

Download history 3/week @ 2024-07-29 29/week @ 2024-08-12 22/week @ 2024-08-19 34/week @ 2024-08-26 15/week @ 2024-09-02 20/week @ 2024-09-09 25/week @ 2024-09-16 47/week @ 2024-09-23 18/week @ 2024-09-30 36/week @ 2024-10-14 7/week @ 2024-10-21 12/week @ 2024-10-28 26/week @ 2024-11-04

81 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–11MB
~138K SLoC