blob: dabe28eb373325f4538db1b08f2777d9ed8e9ff1 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
<HTML>
<HEAD>
<TITLE>svwaitup(8) manual page</TITLE>
</HEAD>
<BODY bgcolor=white>
<a href="http://smarden.org/pape/">G. Pape</a><br><A HREF="index.html">runit</A><hr><P>
<H2><A NAME="sect0">Name</A></H2>
svwaitup - waits for services controlled by <I>supervise(8)</I> to be up
<H2><A NAME="sect1">Synopsis</A></H2>
<B>svwaitup</B>
[ <B>-v</B> ] [ <B>-s</B> <I>sec</I> ] <I>services</I>
<H2><A NAME="sect2">Description</A></H2>
<I>services</I> consist of one or more arguments.
Each <I>service</I> directory must start with a slash. <P>
<B>svwaitup</B> checks each <I>service</I>
given at the command line for being at least the specified number of seconds
<I>sec</I> up. The <I>services</I> given at the command line must be controlled by <B><I>supervise</B>(8)</I>.
<P>
<B>svwaitup</B> blocks until all <I>services</I> were up and running at least <I>sec</I> seconds
when <B>svwaitup</B> was checking or reports errors.
<H2><A NAME="sect3">Options</A></H2>
<DL>
<DT><B>-v</B> </DT>
<DD>verbose. Print verbose
messages to stderr. </DD>
<DT><B>-s <I>sec</B> </I></DT>
<DD>Set the minimum number of seconds each <I>service</I>
has to be up to <I>sec</I> seconds. <I>sec</I> must be between 2 and 600. Default is 2.
</DD>
</DL>
<H2><A NAME="sect4">Exit Codes</A></H2>
<B>svwaitup</B> returns 0 as soon as all <I>services</I> were at least <I>sec</I>
seconds up. <P>
<B>Note</B>: If <B>svwaitup</B> exits 0, it does not guarantee that all <I>services</I>
are actually running. A <I>service</I> could have crashed immediatly after <B>svwaitup</B>
was successfully checking it to be up <I>sec</I> seconds. <I>services</I> should be designed
not to rely on <B>svwaitup</B> to resolve dependencies. <P>
For each <I>service</I> that is
down and not requested to become up, or that causes an error while checking
(e.g. <B><I>supervise</B>(8)</I> is not running), <B>svwaitup</B> increases the exit code by one
and exits non zero. The maximum is 100. <P>
<B>svwaitup</B> returns 111 on error.
<H2><A NAME="sect5">See
Also</A></H2>
<I>svwaitdown(8)</I>, <I>runit(8)</I>, <I>runit-init(8)</I>, <I>runsvdir(8)</I>, <I>runsv(8)</I>, <I>supervise(8)</I>,
<I>svscan(8)</I> <P>
<I>http://smarden.org/runit/</I><BR>
<I>http://cr.yp.to/daemontools.html</I><BR>
<H2><A NAME="sect6">Author</A></H2>
Gerrit Pape <pape@smarden.org> <P>
<HR><P>
<A NAME="toc"><B>Table of Contents</B></A><P>
<UL>
<LI><A NAME="toc0" HREF="#sect0">Name</A></LI>
<LI><A NAME="toc1" HREF="#sect1">Synopsis</A></LI>
<LI><A NAME="toc2" HREF="#sect2">Description</A></LI>
<LI><A NAME="toc3" HREF="#sect3">Options</A></LI>
<LI><A NAME="toc4" HREF="#sect4">Exit Codes</A></LI>
<LI><A NAME="toc5" HREF="#sect5">See Also</A></LI>
<LI><A NAME="toc6" HREF="#sect6">Author</A></LI>
</UL>
</BODY></HTML>
|
