G. Pape
runit

Name

svwaitdown - waits for services controlled by runsv(8) or supervise(8) to be down

Synopsis

svwaitdown [ -v ] [ -k ] [ -t sec ] services

Description

services consists of one or more arguments. Each service directory must start with a slash.

svwaitdown sends each service given at the command line the ‘‘down’’ command, and waits for it to become down. The services given at the command line must be controlled by runsv(8), or supervise(8).

svwaitdown blocks, limited by a timeout, until all services are down or reports errors.

Options

-v
verbose. Print verbose messages to stderr.
-t sec
Set the timeout for waiting for services to become down to sec seconds. sec must be between 2 and 6000. Default is 600 (10 minutes).
-k
Kill. If the timeout is reached before all services are down, tell the runsv(8) processes to send the services a KILL signal.
-x
Exit. Send each service the ‘‘exit’’ command additionally to the ‘‘down’’ command, and wait for the corresponding runsv(8) processes to exit instead for the services to be down. This option should only be used by runit(8) in stage 3 when runsvdir(8) is already stopped.

Exit Codes

svwaitdown returns 0 as soon as all services are down.

If a service is usually controlled by runsv (8) or supervise(8), but no supervisor process is currently running, svwaitdown treats this service as if it would be down.

For each service that causes an error while checking, svwaitdown increases the exit code by one and exits non zero. The maximum is 100.

svwaitdown returns 111 if the timeout sec was reached.

See Also

svwaitup(8), runsv(8), runsvctrl(8), runsvstat(8), chpst(8), svlogd(8), runit(8), runit-init(8), runsvdir(8), runsvchdir(8), utmpset(8)

http://smarden.org/runit/
http://cr.yp.to/daemontools.html

Author

Gerrit Pape <pape@smarden.org>


Table of Contents