#pidfd #linux #syscall #descriptors #passing


Binding to and a wrapper for the pidfd_getfd syscall

4 releases

0.2.2 Jul 10, 2023
0.2.1 Aug 14, 2021
0.2.0 Aug 14, 2021
0.1.0 Aug 6, 2021

#238 in Unix APIs


62 lines


pidfd_getfd on crates.io Latest documentation on docs.rs License information for pidfd-getfd

This crate provides a direct binding to the pidfd_getfd syscall along with a slightly more convenient wrapper, get_file_from_pidfd. This also contains an extension trait for pidfd::PidFd and std's PidFd (currently only available on nightly rustc) which provides access to get_file_from_pidfd via PidFdExt::get_file().

Note that pidfds are currently only supported on Linux 5.6 or later, thus this crate will only work on Linux. If any other platform gains support for pidfds, please let me know through an issue or pull request!

Please note that this crate has not been thoroughly tested. Viewer discretion is advised.


use pidfd_getfd::{get_file_from_pidfd, GetFdFlags};
use std::{
    io::{self, Read},

let pidfd: RawFd = /* ... */;
let target_fd: RawFd = /* ... */;
let mut file = get_file_from_pidfd(pidfd, target_fd, GetFdFlags::empty())?;
let mut buf = Vec::new();
file.read_to_end(&mut buf)?;
println!("{:#?}", buf);

Using pidfd:

use pidfd::PidFd;
use pidfd_getfd::{GetFdFlags, PidFdExt};
use std::process::Command;

let child = Command::new("/usr/bin/foo").spawn().expect("failed to run `foo`");
let pidfd = PidFd::from_std_checked(&child)?;
let file_from_child = pidfd.get_file(1, GetFdFlags::empty())?;

Using nightly rustc:


use pidfd_getfd::{GetFdFlags, PidFdExt};
use std::{
    os::linux::process::{ChildExt, CommandExt},

let child = Command::new("/usr/bin/foo")
    .expect("failed to run `foo`");

let file_from_child = child.pidfd()?.get_file(1, GetFdFlags::empty())?;