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

#192 in Unix APIs

Download history 2908/week @ 2023-06-07 3491/week @ 2023-06-14 2951/week @ 2023-06-21 2140/week @ 2023-06-28 3326/week @ 2023-07-05 3655/week @ 2023-07-12 3441/week @ 2023-07-19 2710/week @ 2023-07-26 3599/week @ 2023-08-02 2758/week @ 2023-08-09 4641/week @ 2023-08-16 4568/week @ 2023-08-23 4622/week @ 2023-08-30 5493/week @ 2023-09-06 5765/week @ 2023-09-13 4988/week @ 2023-09-20

22,115 downloads per month
Used in 4 crates (3 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

~39KB