Struct tracing_core::stdlib::os::linux::process::PidFd

pub struct PidFd {
    inner: FileDesc,
}

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

Available on Linux only.

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 take_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
    .take_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: FileDesc

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

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.