Struct ProcessHandle 

pub struct ProcessHandle { /* private fields */ }

The OS liveness handle this module hands out.

It is the facade’s handle: the ownership rules that make it trustworthy – a pidfd, a kqueue subscription, an open process handle – belong to the host that issued it, not to this module’s vocabulary. A live reference to another process, good for as long as it is held.

Where the kernel offers one, this holds a pidfd: a PID can be recycled between two questions, but a pidfd cannot, so a handle opened once keeps naming the process it was opened for even after that process exits. Older kernels have no such thing, and there the handle falls back to asking about the PID – which is the best this host can do, not an equivalent.

Implementations

impl ProcessLiveness

pub fn open_for_control( pid: u32, ) -> Result<ProcessLiveness, ProcessInspectError>

Acquire a kernel-pinned handle suitable for identity-safe control.

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

Force termination through the held pidfd, never by reopening the PID.

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

Confirm terminal state through the held pidfd without reopening the PID.

pub fn open(pid: u32) -> Result<ProcessLiveness, ProcessInspectError>

Take a reference to pid, failing if no such process is running.

pub fn pid(&self) -> u32

The process ID this handle was opened for.

pub fn is_alive(&self) -> bool

Whether that process is still running.

Trait Implementations

impl Debug for ProcessLiveness

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

Names the process, not the handle.

The underlying descriptor or handle value is an artefact of this process’s own table; printing it invites a reader to compare two numbers that were never comparable.