stado service restart
Invocation
stado service restart [OPTIONS] <NAME>Purpose
Restart one managed unit, without a full host-recovery pass. The command answers when the restarted unit serves the port the service directory declares for it (SERVING `serving`), or with the unit's own reason it cannot: its port is held by another job, launchd holds no process for it, it died and launchd started another one, or its process settled on other ports than the declared one (`not_serving`, exit non-zero). A unit with no declared port answers `no_declared_port` at the kickstart. Elapsed time alone never ends it.
Required inputs and options
| Input or option | Contract |
|---|---|
<NAME> | Service name, or the host's own name for the unit |
--host <HOST> | Restrict to one registry host; omit to restart it everywhere it is managed. Naming the machine that runs the command finds the unit in its last-known-good registry copy, not through the object API |
--take-over-listener <TAKE_OVER_LISTENER> | Optional loopback URL whose stale listener is stopped before restart |
--recovery-unit <RECOVERY_UNIT> | Exact per-login recovery label to stop before listener takeover |
--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.