Struct ProcessIdentity 

pub struct ProcessIdentity {
    pub pid: u32,
    pub start_key: u64,
}

A process identity that survives PID reuse.

start_key is an opaque, platform-supplied value derived from the process start time. It is deliberately not a SystemTime: on Linux it comes from field 22 of /proc/<pid>/stat in clock ticks since boot, and on macOS from the kp_proc.p_starttime timeval. Both are stable for the life of the process and change on reuse, which is the only property this type needs.

Two identities compare equal only when both the PID and the start key match, which is what makes crate::model::ProcessIdentity safe to attach to a pending signal (§6.2, §15.1).

Fields

pid: u32

The OS process identifier.

start_key: u64

An opaque platform value that changes when this PID is reused.

Implementations

impl ProcessIdentity

pub const fn new(pid: u32, start_key: u64) -> Self

Builds an identity from a PID and a platform start key.

pub const fn is_reuse_of(&self, other: &Self) -> bool

Whether other is the same PID but a different process.

The signal path calls this after re-reading the live process table: a true result means the PID was reused and the pending action must abort rather than signal an unrelated process (§6.2).

Trait Implementations

impl Clone for ProcessIdentity

fn clone(&self) -> ProcessIdentity

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ProcessIdentity

impl Debug for ProcessIdentity

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

Formats the value using the given formatter.

impl Display for ProcessIdentity

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

Renders just the PID: the start key is an internal correctness device and would be noise in the UI.

impl Eq for ProcessIdentity

impl Hash for ProcessIdentity

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ProcessIdentity

fn cmp(&self, other: &ProcessIdentity) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ProcessIdentity

fn eq(&self, other: &ProcessIdentity) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for ProcessIdentity

fn partial_cmp(&self, other: &ProcessIdentity) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for ProcessIdentity