stado service verify
Invocation
stado service verify [OPTIONS]Purpose
Go to each consumer and check the endpoint it is told to use, and that the thing answering is the service that was declared. `list` reports what hosts say about their units. This reports whether the directory's addresses answer, from the machines that must call them -- the one question every other check in this binary skips. States are `observed`, `unreachable`, `misowned` for a port a different declared unit is holding, `standby_serving` for a standby host whose own declared unit answers on its standby address (a second copy beside the active host, probed and owner-checked from that standby host), and `unverified` for a probe that could not run or a standby address that is silent or answered by some other listener; the last is never folded into the others. `misowned` exists because an answer was once the whole of `observed`'s evidence. On the service's active host the port's owner is resolved by launchd label through the same reader `service serving` uses, so a declaration pointing at a port another job holds is a failure here rather than a green row. Other hosts reach the service through their own resolver adapter and are not judged on ownership, because that socket is owned by the resolver by design. Exits non-zero on `unreachable`, `misowned` and `standby_serving`, counted separately: the first usually means the service needs attention, the second means the declaration does, the third means a standby unit is running; the service reconciler's next pass stops that declared managed service on its host, leaving it enabled (outcome action `stop_standby`).
Required inputs and options
| Input or option | Contract |
|---|---|
--host <HOST> | Check one host's declarations instead of the whole fleet |
--local | Probe from this machine only, without using the fleet channel. This is the mode the installed probe helper runs |
--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
- 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.