summary refs log tree commit diff
path: root/man
diff options
context:
space:
mode:
authorGerrit Pape <pape@smarden.org>2001-12-30 10:38:12 +0000
committerGerrit Pape <pape@smarden.org>2001-12-30 10:38:12 +0000
commit713e127fd5bfcdfaabc3dd3c34319fe1778df66c (patch)
tree304a97533480f8311028aca12d75d2f83c7e34e6 /man
parent0768bbac2fe0229d2a42a39953100c10a73a4f1d (diff)
downloadrunit-713e127fd5bfcdfaabc3dd3c34319fe1778df66c.tar.gz
runit-713e127fd5bfcdfaabc3dd3c34319fe1778df66c.tar.xz
runit-713e127fd5bfcdfaabc3dd3c34319fe1778df66c.zip
svwaitup: race condition documented.
deb: svwait*.8 installed.
Diffstat (limited to 'man')
-rw-r--r--man/svwaitup.834
1 files changed, 28 insertions, 6 deletions
diff --git a/man/svwaitup.8 b/man/svwaitup.8
index dea7691..7004f94 100644
--- 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