Struct PidFd 

#[repr(transparent)]
pub struct PidFd {
    inner: PidFd,
}

🔬This is a nightly-only experimental API. (linux_pidfd)

This type represents a file descriptor that refers to a process.

A PidFd can be obtained by setting the corresponding option on Command with create_pidfd. Subsequently, the created pidfd can be retrieved from the Child by calling pidfd or into_pidfd.

Example:

#![feature(linux_pidfd)]
use std::os::linux::process::{CommandExt, ChildExt};
use std::process::Command;

let mut child = Command::new("echo")
    .create_pidfd(true)
    .spawn()
    .expect("Failed to spawn child");

let pidfd = child
    .into_pidfd()
    .expect("Failed to retrieve pidfd");

// The file descriptor will be closed when `pidfd` is dropped.

Refer to the man page of pidfd_open(2) for further details.

Fields

inner: PidFd

🔬This is a nightly-only experimental API. (linux_pidfd)

Implementations

impl PidFd

pub fn kill(&self) -> Result<(), Error>

🔬This is a nightly-only experimental API. (linux_pidfd)

Forces the child process to exit.

Unlike Child::kill it is possible to attempt to kill reaped children since PidFd does not suffer from pid recycling races. But doing so will return an Error.

pub fn wait(&self) -> Result<ExitStatus, Error>

🔬This is a nightly-only experimental API. (linux_pidfd)

Waits for the child to exit completely, returning the status that it exited with.

Unlike Child::wait it does not ensure that the stdin handle is closed.

Additionally on kernels prior to 6.15 only the first attempt to reap a child will return an ExitStatus, further attempts will return an Error.

pub fn try_wait(&self) -> Result<Option<ExitStatus>, Error>

🔬This is a nightly-only experimental API. (linux_pidfd)

Attempts to collect the exit status of the child if it has already exited.

On kernels prior to 6.15, and unlike Child::try_wait, only the first attempt to reap a child will return an ExitStatus, further attempts will return an Error.

Trait Implementations

impl AsFd for PidFd

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor.

impl AsRawFd for PidFd

fn as_raw_fd(&self) -> i32

Extracts the raw file descriptor.

impl Debug for PidFd

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<OwnedFd> for PidFd

fn from(fd: OwnedFd) -> PidFd

Converts to this type from the input type.

impl From<PidFd> for OwnedFd

fn from(pid_fd: PidFd) -> OwnedFd

Converts to this type from the input type.

impl FromRawFd for PidFd

unsafe fn from_raw_fd(fd: i32) -> PidFd

Constructs a new instance of Self from the given raw file descriptor.

impl IntoRawFd for PidFd

fn into_raw_fd(self) -> i32

Consumes this object, returning the raw underlying file descriptor.