CLI reference / host / gates

stado host gates

Invocation

stado host gates [OPTIONS] <HOST>

Purpose

Report HOST's measured disk space against the disk-full rule, the published admission decision and the source, duration and error of every diagnostic read. Read-only. Each registry, host, storage, capacity and queue read retains its result or concrete error. Elapsed time is recorded, not used to end a read. Completed readings survive failures; incomplete reports use claiming=null.

Required inputs and options

Input or optionContract
<HOST>Positional input; required or optional as shown in the invocation.
--jsonEmit the gates as JSON
--require-diskExit on whether the volume is under the disk-full threshold instead of on `claiming`

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.