#socketpair #io #tcp-stream

socketpair

Cross-platform socketpair functionality

34 releases (19 breaking)

0.19.6 Mar 7, 2025
0.19.5 Mar 29, 2024
0.19.4 Dec 30, 2023
0.19.3 Jun 28, 2023
0.6.1 Mar 4, 2021

#276 in Rust patterns

Download history 2326/week @ 2024-12-08 1012/week @ 2024-12-15 402/week @ 2024-12-22 1495/week @ 2024-12-29 2034/week @ 2025-01-05 3161/week @ 2025-01-12 1610/week @ 2025-01-19 1914/week @ 2025-01-26 2857/week @ 2025-02-02 1850/week @ 2025-02-09 2533/week @ 2025-02-16 3223/week @ 2025-02-23 6124/week @ 2025-03-02 6473/week @ 2025-03-09 6082/week @ 2025-03-16 4887/week @ 2025-03-23

23,733 downloads per month
Used in 15 crates (6 directly)

Apache-2.0…

50KB
1K SLoC

socketpair

Cross-platform socketpair functionality

Github Actions CI Status crates.io page docs.rs docs

This crate wraps socketpair with AF_UNIX platforms, and emulates this interface using CreateNamedPipe on Windows.

It has a "stream" interface, which corresponds to SOCK_STREAM and PIPE_TYPE_BYTE, and a "seqpacket" interface, which corresponds to SOCK_SEQPACKET and PIPE_TYPE_MESSAGE.

Example

let (mut a, mut b) = socketpair_stream()?;

writeln!(a, "hello world")?;

let mut buf = [0_u8; 4096];
let n = b.read(&mut buf)?;
assert_eq!(str::from_utf8(&buf[..n]).unwrap(), "hello world\n");

Support for async-std and tokio is temporarily disabled until those crates contain the needed implementations of the I/O safety traits.

Dependencies

~2–14MB
~189K SLoC