Documentation
¶
Overview ¶
Package procsig delivers signals to agent processes guarded by their start epoch (DDR-5, GAPI-DIV-016): a signal aimed at a dead process whose PID was recycled must never hit the new occupant. Linux-only by design (operator decision 2026-07-28) - delivery uses pidfd_open + pidfd_send_signal with no fallback; non-Linux builds compile but refuse to deliver.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ( // ErrStaleEpoch: the process at this PID is not the one the caller // meant (start epoch mismatch - the PID was recycled). ErrStaleEpoch = errors.New("procsig: stale start epoch, refusing delivery") // ErrProcessGone: no process holds this PID. ErrProcessGone = errors.New("procsig: process gone") // ErrUnsupported: signal delivery is Linux-only. ErrUnsupported = errors.New("procsig: signal delivery is linux-only") )
Typed delivery failures. Errors are data; there is deliberately no retry on ErrStaleEpoch - a stale epoch means the target is gone and the orchestrator must re-resolve, not hammer a recycled PID.
Functions ¶
func Signal ¶
Signal delivers sig to pid if and only if the process's start epoch matches. The check-pin-recheck order makes it race-free: the epoch is checked, the process is pinned with pidfd_open, and the epoch is re-checked while pinned - a PID recycled between the first check and the pin shows a different epoch on the recheck and is refused. The signal then goes to the pinned process via pidfd_send_signal, never to a raw PID.
func StartEpoch ¶
StartEpoch returns the process's start time in clock ticks since boot (/proc/<pid>/stat field 22). Recorded at spawn, it uniquely identifies a PID incarnation on one boot of one node.
Types ¶
type ProcessIdentity ¶
ProcessIdentity is the mutable runtime locator of a process: the PID plus the two fields that disambiguate a PID across recycling and namespaces (DDR-3/4/5). It travels in gossip, never in Raft.
func Identify ¶
func Identify(pid int) (ProcessIdentity, error)
Identify captures a process's runtime locator: pid, start epoch, and pid-namespace inode (/proc/<pid>/ns/pid). Nodes call this after spawning an instance and publish it over gossip.
Source Files