CLI reference / host / gates

stado host gates

Invocation

stado host gates [OPTIONS] <HOST>

Purpose

Report HOST's measured disk space, its published memory refusal and the watermarks behind it, the published admission decision and the source, duration and error of every diagnostic read. Read-only. Each registry, host, storage, capacity and queue read has a ten-second budget. Completed readings survive failures; incomplete reports use claiming=null and never turn missing space into a full disk. A host whose own declaration refuses placement for memory pressure reports `memory_pressure_active` as a blocker with the reading and both watermarks beside it.

Required inputs and options

Input or optionContract
<HOST>Positional input; required or optional as shown in the invocation.
--jsonEmit the gates as JSON

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

  • 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.