G. Pape
runit

Name

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

Synopsis

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

Description

services consists of one or more arguments, each argument naming a service directory.

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

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

Exit Codes

svwaitdown returns 0 as soon as all services are down.

If a service is usually controlled by runsv (8), but no supervisor process is currently running in the directory, 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 on error, or if the timeout sec was reached.

See Also

sv(8), runsv(8), chpst(8), svlogd(8), runit(8), runit-init(8), runsvdir(8), runsvchdir(8), svwaitup(8)

http://smarden.org/runit/

Author

Gerrit Pape <pape@smarden.org>


Table of Contents