stado service reap
Invocation
stado service reap [OPTIONS] --host <HOST> --command <COMMAND>Purpose
Required inputs and options
| Input or option | Contract |
|---|---|
--host <HOST> | Registry host to reap. Required: this signals processes |
--command <COMMAND> | The exact program being de-duplicated, as a substring of its command line -- for example `stado agent --target charless-mac-mini`. Required, and deliberately not defaulted: a fleet-wide reap on that host proposed ending `skarbiec serve`, `stado dashboard`, `stado resolver serve` and the Weles API server, because launchd holds a pid for only some declared labels and everything else read as undeclared |
--apply | Send SIGTERM to the rows a declared label does not hold. Without it those rows read `would_end`; a `kept` row is never signalled with or without this flag, and is reported so the program a declared label is running can be named |
--json | Command option; required or optional as shown in the invocation. |
Output and state effect
It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.
Refusals
- Required: this signals processes
- Required, and deliberately not defaulted: a fleet-wide reap on that host proposed ending `skarbiec serve`, `stado dashboard`, `stado resolver serve` and the Weles API server, because launchd holds a pid for only some declared labels and everything else read as undeclared
- Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.