manpage svwait* added.

cleanup.

4 files changed, 166 insertions, 5 deletions

diff --git a/man/runit-init.8 b/man/runit-init.8
index aa113ef..0e3ea3f 100644
--- a/man/runit-init.8
+++ b/man/runit-init.8
@@ -1,6 +1,6 @@
 .TH runit-init 8
 .SH NAME
-init \- the UNIX process no 1
+init \- a UNIX process no 1
 .SH SYNOPSIS
 .B init
 [ 0 | 6 ]
@@ -41,8 +41,10 @@ files are touched. Then a CONT signal is sent to
 .B runit-init
 returns 111 on error, 0 in all other cases.
 .SH SEE ALSO
-runit(8)
-
+runit(8),
+svwaitdown(8),
+svwaitup(8)
+.P
 http://smarden.org/runit/
 .SH AUTHOR
 Gerrit Pape <pape@smarden.org>
diff --git a/man/runit.8 b/man/runit.8
index 8e79c71..1e624c8 100644
--- a/man/runit.8
+++ b/man/runit.8
@@ -61,8 +61,10 @@ if
 .B runit
 receives an INT signal, a ctrl-alt-del keyboard request is triggered.
 .SH SEE ALSO
-runit-init(8)
-
+runit-init(8),
+svwaitdown(8),
+svwaitup(8)
+.P
 http://smarden.org/runit/
 .SH AUTHOR
 Gerrit Pape <pape@smarden.org>
diff --git a/man/svwaitdown.8 b/man/svwaitdown.8
new file mode 100644
index 0000000..5f3edc2
--- /dev/null
+++ b/man/svwaitdown.8
@@ -0,0 +1,84 @@
+.TH svwaitdown 8
+.SH NAME
+svwaitdown \- waits for services controlled by supervise(8) to be down
+.SH SYNOPSIS
+.B svwaitdown
+[
+.B \-v
+]
+[
+.B \-t
+.I sec
+]
+.I services
+.SH DESCRIPTION
+.I services
+consist of one or more arguments.
+.P
+.B svwaitdown
+checks each
+.I service
+given at the command line for being 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).
+.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
+svwaitup(8),
+supervise(8),
+svscan(8),
+runit(8),
+runit-init(8)
+.P
+ http://smarden.org/runit/
+ http://cr.yp.to/daemontools.html
+.SH AUTHOR
+Gerrit Pape <pape@smarden.org>
diff --git a/man/svwaitup.8 b/man/svwaitup.8
new file mode 100644
index 0000000..dea7691
--- /dev/null
+++ b/man/svwaitup.8
@@ -0,0 +1,73 @@
+.TH svwaitup 8
+.SH NAME
+svwaitup \- waits for services controlled by supervise(8) to be up
+.SH SYNOPSIS
+.B svwaitup
+[
+.B \-v
+]
+[
+.B \-s
+.I sec
+]
+.I services
+.SH DESCRIPTION
+.I services
+consist of one or more arguments.
+.P
+.B svwaitup
+checks each
+.I service
+given at the command line for being at least the specified number of seconds
+.I sec
+up. The
+.I services
+given at the command line must be controlled by
+.BR supervise (8).
+.P
+.B svwaitup
+blocks until all services are running the requested number of seconds or
+reports errors.
+.SH OPTIONS
+.TP
+.B \-v
+verbose. Print verbose messages to stderr.
+.TP
+.B \-s \fIsec
+Set the number of seconds the
+.I services
+have to be up to
+.I sec
+seconds.
+.I sec
+must be between 2 and 600. Default is 2.
+.SH EXIT CODES
+.B svwaitup
+returns 0 as soon as all
+.I services
+are at least
+.I sec
+seconds up.
+.P
+For each
+.I service
+that is down and not requested to become up, or that causes an error while
+checking (e.g.
+.BR supervise (8)
+is not running),
+.B svwaitup
+increases the exit code by one and exits non zero. The maximum is 100.
+.P
+.B svwaitup
+returns 111 on error.
+.SH SEE ALSO
+svwaitdown(8),
+supervise(8),
+svscan(8),
+runit(8),
+runit-init(8)
+.P
+ http://smarden.org/runit/
+ http://cr.yp.to/daemontools.html
+.SH AUTHOR
+Gerrit Pape <pape@smarden.org>