tokio-send-fd

⚠️This crate is deprecated. Use async-send-fd instead.

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 test_raw_fd.rs and test_tokio_stream.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.