stado service list
Invocation
stado service list [OPTIONS]Purpose
Every registry-managed service across all hosts, with its state. Answered from the latest health beacons, so it costs no ssh and reports on hosts that are not currently reachable. A host that has published no beacon reports `unknown`, which is deliberately not the same answer as `missing`. `OBSERVED` is a different question from `STATE` and is answered by a different party. `STATE` is what the host says about its own unit; `OBSERVED` is when anybody last went and looked at the service from outside. A host with a closed lid publishes no beacon and says nothing, so `STATE` goes quiet rather than wrong -- and quiet is what read as fine for twelve days. `never` in this column means no machine has ever confirmed this service from any vantage. `--unowned` answers the opposite question: which product processes are running that no launchd job or systemd unit owns. Two `stado agent` processes ran that way for four days, executing a binary older than the one on disk, and every answer in this group was about declared units and so said nothing about them. `--undeclared` answers the third question, which had no answer at all: which units launchd has LOADED that the registry does not declare. Neither of the other two can see one — `list` walks the document and asks the host about each entry, `--unowned` walks the processes and asks launchd who owns them, and a loaded job the document never heard of is in neither set. charless-mac-mini ran three queue agents at once in that blind spot for seven days.
Required inputs and options
| Input or option | Contract |
|---|---|
--unowned | Report the product processes no unit owns instead of the declared managed set. This is the one question in this group the beacons cannot answer -- an unowned process is by definition in nobody's declaration -- so it costs one read-only ssh per kind=local host |
--undeclared | Report the launchd jobs a host has loaded under this fleet's own label prefix that the registry does not declare. One read-only `launchctl list` per kind=local host |
--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
- This is the one question in this group the beacons cannot answer -- an unowned process is by definition in nobody's declaration -- so it costs one read-only ssh per kind=local host
- 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.