CLI reference / resolver / status

stado resolver status

Invocation

stado resolver status [OPTIONS]

Purpose

Whether this host's resolver is ready, and why not when it is not. A subcommand rather than another endpoint on the resolver's own API, for one reason: the question is asked when the resolver is DOWN. On 2026-08-19 this host's resolver sat in a launchd restart loop holding a dead ssh control socket, and an answer served on `api_bind` would have been unreachable for exactly the window an operator needed it. This reads the registry and the state `serve` publishes to [`state_path`], so it answers with the resolver stopped, and exits non-zero when the answer is not `ready` so a unit or a script can act on it. The live process's own `/health` remains where a workload checks a resolver it is already talking to.

Required inputs and options

Input or optionContract
--target <TARGET>Registry target whose resolver to report on. Defaults to the target the published state names, then to this host's identity
--jsonEmit machine-readable output

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.