CLI reference / release / host-state

stado release host-state

Invocation

stado release host-state [OPTIONS] --host <HOST>

Purpose

Read or converge the versions a host declares

Required inputs and options

Input or optionContract
--host <HOST>Command option; required or optional as shown in the invocation.
--binary <BINARY>Limit the report to one declared binary
--applyDeliver host-behind versions; refuses to downgrade a host-ahead binary
--jsonCommand option; required or optional as shown in the invocation.

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

Refusals

  • Deliver host-behind versions; refuses to downgrade a host-ahead binary
  • 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.