stado service retire
Invocation
stado service retire [OPTIONS] --host <HOST> <UNIT>Purpose
Remove a service from management: bootout/disable and forget. Unit files are left on disk. Retiring is a management decision, not a deletion. On Linux, systemctl mask and the following is-active read must prove the unit is no longer running. A failed mask, active or transitioning state, or unreadable answer refuses to forget the declaration and reports the observed scope and systemctl result. The unit is stopped first; the managed record and every service directory route on this host whose `managed_service` names it, by service name or unit id, are then withdrawn in one versioned registry write. A route whose replacement catalog unit is declared on the same host is handed to that unit instead. A failed stop leaves the declaration and routes untouched.
Required inputs and options
| Input or option | Contract |
|---|---|
<UNIT> | launchd label or systemd unit name, as the host knows it |
--host <HOST> | Registry host that runs it |
--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.