10 releases (5 breaking)

0.6.3 Sep 20, 2023
0.6.1 Oct 11, 2022
0.5.0 Jul 3, 2021
0.3.0 Oct 5, 2020
0.2.0 Jun 27, 2020

#380 in Unix APIs

Download history 14924/week @ 2025-03-10 13760/week @ 2025-03-17 15717/week @ 2025-03-24 17362/week @ 2025-03-31 20900/week @ 2025-04-07 31226/week @ 2025-04-14 31111/week @ 2025-04-21 30602/week @ 2025-04-28 28464/week @ 2025-05-05 30462/week @ 2025-05-12 29602/week @ 2025-05-19 30545/week @ 2025-05-26 38196/week @ 2025-06-02 32649/week @ 2025-06-09 30731/week @ 2025-06-16 34960/week @ 2025-06-23

137,412 downloads per month
Used in 6 crates (4 directly)

BSD-2-Clause

15KB
141 lines

filedesc docs tests

This crate exposes a single type: FileDesc, which acts as a thin wrapper around open file descriptors. The wrapped file descriptor is closed when the wrapper is dropped.

You can call FileDesc::new() with any type that implements IntoRawFd, or duplicate the file descriptor of a type that implements AsRawFd with duplicate_from, or directly from a raw file descriptor with from_raw_fd() and duplicate_raw_fd(). Wrapped file descriptors can also be duplicated with the duplicate() function.

Close-on-exec

Whenever the library duplicates a file descriptor, it tries to set the close-on-exec flag atomically. On platforms where this is not supported, the library falls back to setting the flag non-atomically. When an existing file descriptor is wrapped, the close-on-exec flag is left as it was.

You can also check or set the close-on-exec flag with the get_close_on_exec() and set_close_on_exec functions.

Example

use filedesc::FileDesc;
let fd = unsafe { FileDesc::from_raw_fd(raw_fd) };
let duplicated = unsafe { fd.duplicate()? };
assert_eq!(duplicated.get_close_on_exec()?, true);

duplicated.set_close_on_exec(false)?;
assert_eq!(duplicated.get_close_on_exec()?, false);

Dependencies

~43KB