.TH svwaitdown 8
.SH NAME
svwaitdown \- waits for services controlled by supervise(8) to be down
.SH SYNOPSIS
.B svwaitdown
[
.B \-v
] [
.B \-k
] [
.B \-t
.I sec
]
.I services
.SH DESCRIPTION
.I services
consists of one or more arguments. Each
.I service
directory must start with a slash.
.P
.B svwaitdown
sends each
.I service
given at the command line the ``down'' command, and waits for it to become
down.
The
.I services
given at the command line must be controlled by
.BR supervise (8).
.P
.B svwaitdown
blocks, limited by a
.IR timeout ,
until all
.I services
are down or reports errors.
.SH OPTIONS
.TP
.B \-v
verbose. Print verbose messages to stderr.
.TP
.B \-t \fIsec
Set the timeout for waiting for
.I services
to become down to
.I sec
seconds.
.I sec
must be between 2 and 6000. Default is 600 (10 minutes).
.TP
.B \-k
Kill. If the timeout is reached before all
.I services
are down, tell the
.BR supervise (8)
processes to send the
.I services
a KILL signal.
.TP
.B \-x
Exit. Send each
.I service
the ``exit'' command additionally to the ``down'' command, and wait for the
corresponding
.BR runsv (8)
processes to exit instead for the
.I services
to be down.
This option should only be used by
.BR runit (8)
in stage 3 when
.BR runsvdir (8)
is already stopped.

.SH EXIT CODES
.B svwaitdown
returns 0 as soon as all
.I services
are down.
.P
If a
.I service
is usually controlled by
.BR supervise (8),
but no
.BR supervise (8)
process is currently running,
.B svwaitdown
treats this
.I service
as if it would be down.
.P
For each
.I service
that causes an error while checking,
.B svwaitdown
increases the exit code by one and exits non zero. The maximum is 100.
.P
.B svwaitdown
returns 111 if the timeout
.I sec
was reached.
.SH SEE ALSO
svwaitdown(8),
runsv(8),
runsvctrl(8),
runsvstat(8),
runsvdir(8),
runsvchdir(8),
runit(8),
runit-init(8),
supervise(8),
svscan(8)
.P
 http://smarden.org/runit/
 http://cr.yp.to/daemontools.html
.SH AUTHOR
Gerrit Pape <pape@smarden.org>