tokio-send-fd

A library to send tokio UnixStream and raw file descriptors over tokio UnixStream connections.

Overview

The crate is a library for sending and receiving Unix file descriptors over tokio UnixStream connections. You can transfer RawFd or UnixStream. See testrawfd.rs and testtokiostream.rs for examples.

Creating tokio::net::UnixStream from RawFd

If you want to create tokio UnixStream from a raw file descriptor created by os' UnixStream::pair call, you should make it set_nonblocking(true), otherwise tokio stream will block event in async functions ⚠️

Transfering socket pair ownership

Sending a socket of a socket pair doesn't close the local copy, which leads to having the socket being opened until the sender is shut down. If you want counterparties to detect peer shutdown, you have to close socket pair right after sending a socket to a peer. Use close Posix call.