commit 0aa60b9e1e38b2ec81cd0e0b57ff1bc7cc8f85ff
parent c001fb3ab33c9ffa8ea7e62c58696132c2234c8c
Author: Gerrit Pape <pape@smarden.org>
Date: Sun, 30 Dec 2001 10:38:12 +0000
svwaitup: race condition documented.
deb: svwait*.8 installed.
Diffstat:
2 files changed, 29 insertions(+), 7 deletions(-)
diff --git a/debian/rules b/debian/rules
@@ -115,7 +115,7 @@ binary-arch: build install
dh_testroot
# dh_installdebconf
dh_installdocs
- dh_installman man/runit*.8
+ dh_installman man/runit*.8 man/svwait*.8
dh_installchangelogs
dh_link
dh_strip
diff --git a/man/svwaitup.8 b/man/svwaitup.8
@@ -26,17 +26,22 @@ 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.
+blocks until all
+.I services
+were up and running at least
+.I sec
+seconds when
+.B svwautup
+was checking 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
+Set the minimum number of seconds each
+.I service
+has to be up to
.I sec
seconds.
.I sec
@@ -45,10 +50,27 @@ must be between 2 and 600. Default is 2.
.B svwaitup
returns 0 as soon as all
.I services
-are at least
+were at least
.I sec
seconds up.
.P
+.BR Note :
+If
+.B svwaitup
+exits 0, it does not guarantee that all
+.I services
+are actually running. A
+.I service
+could have crashed immediatly after
+.B svwaitup
+was successfully checking it to be up
+.I sec
+seconds.
+.I services
+should be designed not to rely on
+.B svwaitup
+to resolve dependencies.
+.P
For each
.I service
that is down and not requested to become up, or that causes an error while
