Module reap 

Child reaping + orphan discipline. RFC 0003 §pid1-orphan.

Two responsibilities:

1. Subreaper / PID-1 discipline. PR_SET_CHILD_SUBREAPER makes grandchildren orphaned by a dying subagent reparent to us, not host init — so the whole tree stays in agentd’s reaping domain. When agentd is PID 1 (a bare container), the same applies natively.
2. Reaping. Each active Supervisor tick drains the process-global reaper (reaper::reap_and_dispatch), whose reap_pending here is the single waitpid(-1, WNOHANG) loop — looped because SIGCHLD does not queue, so one signal may cover several exits. The SIGCHLD self-pipe (signals.rs) is only a promptness hint; correctness does not depend on it.

The exit-status decode (classify_status) is pure and unit-tested; the waitpid loop itself is a thin libc wrapper exercised by the reactor.

Structs

Reaped

A reaped child: its pid and how it ended.

Enums

WaitOutcome

How a child process ended.

Functions

classify_status

Decode a raw waitpid status into a WaitOutcome. Pure — uses the libc WIF* macros so the encoding stays correct per platform.

is_init

Are we PID 1 (running as a bare container’s init)? Then we must reap all orphans, and our own death takes the tree with us.

set_child_subreaper

Become a subreaper so orphaned grandchildren reparent to us. Returns true on success (Linux ≥ 3.4). Best-effort: a failure just means orphans go to init, which PDEATHSIG already guards against.