Enum ProcessIdentityError 

pub enum ProcessIdentityError {
    MalformedStat {
        pid: i64,
    },
    Io {
        pid: i64,
        error: Error,
    },
    UnsupportedPlatform,
    CurrentUnavailable,
    ProcMismatch {
        procfs: i64,
        own: u32,
    },
    BootUnavailable,
    ScopeUnavailable,
}

What: Why a birth identity could not be decided. Absence (the process exited) is not an error; these are states the incumbent also throws on. Why: A lock acquirer that cannot tell whether an owner lives must stop, not guess.

In TS you’d write (pseudocode):

class ProcessIdentityError extends TypeError {}

Variants

MalformedStat

/proc/<pid>/stat has no ) or no start-time field.

Fields

pid: i64

The process whose record was read.

Io

The record could not be read for a reason other than the process being gone.

Fields

pid: i64

The process whose record was read.

error: Error

The operating system’s refusal.

UnsupportedPlatform

This platform has no identity source.

CurrentUnavailable

The current process has no identity, so it cannot own a lock.

ProcMismatch

The /proc this process sees describes another PID namespace: its own record carries another PID than the one the process has, so a PID read there names the wrong process.

Fields

procfs: i64

The PID in the record /proc/self/stat gave.

own: u32

The PID the operating system gave this process.

BootUnavailable

The boot ID of the host cannot be read, so a marker could not be told from one of another boot.

ScopeUnavailable

The PID namespace of this process cannot be read, so a marker could not say which numbering its PID belongs to.

Trait Implementations

impl Debug for ProcessIdentityError

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

Formats the value using the given formatter.

impl Display for ProcessIdentityError

What: Human-readable text for each failure. Why: Diagnostics name the process and the reason in plain words.

In TS you’d write (pseudocode):

error.message

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

Writes one sentence naming the process and what went wrong.