summary refs log tree commit diff
path: root/doc/runsvdir.8.html
diff options
context:
space:
mode:
authorGerrit Pape <pape@smarden.org>2002-09-25 10:17:58 +0000
committerGerrit Pape <pape@smarden.org>2002-09-25 10:17:58 +0000
commitb832b6d7c3800714d328e955eb13f975b389693e (patch)
tree92b6ef6691693e64c96b4c50bc2a92aa7d6bff0e /doc/runsvdir.8.html
parent3467ac501986b1afb28e69352c4368637aba67d6 (diff)
downloadrunit-b832b6d7c3800714d328e955eb13f975b389693e.tar.gz
runit-b832b6d7c3800714d328e955eb13f975b389693e.tar.xz
runit-b832b6d7c3800714d328e955eb13f975b389693e.zip
new.
Diffstat (limited to 'doc/runsvdir.8.html')
-rw-r--r--doc/runsvdir.8.html55
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/runsvdir.8.html b/doc/runsvdir.8.html
new file mode 100644
index 0000000..e2b0010
--- /dev/null
+++ b/doc/runsvdir.8.html
@@ -0,0 +1,55 @@
+
+
+
+<HTML>
+<HEAD>
+<TITLE>runsvdir(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>
+runsvdir - starts and monitors a collection of <I>runsv(8)</I> processes 
+<H2><A NAME="sect1">Synopsis</A></H2>
+<B>runsvdir</B>
+<I>dir</I> [ <I>log</I> ] 
+<H2><A NAME="sect2">Description</A></H2>
+<I>dir</I> must be a directory. <I>log</I> is a space holder for
+a readproctitle log and must be at least seven characters long. <P>
+<B>runsvdir</B>
+starts a <B><I>runsv</B>(8)</I> process for each subdirectory in <I>dir</I>, up to a limit of
+1000 subdirectories. <B>runsvdir</B> skips subdirectory names starting with dots.
+<B><I>runsv</B>(8)</I> must be in <B>runsvdir</B>'s PATH. <P>
+At least every five seconds, <B>runsvdir</B>
+checks if <I>dir</I> has changed. If it sees a new subdirectory in <I>dir</I>, it starts
+a new <B><I>runsv</B>(8)</I> process. If it sees an old sudirectory where a <B><I>runsv</B>(8)</I> process
+has exited, it restarts the <B><I>runsv</B>(8)</I> process. If <B>runsvdir</B> sees a subdirectory
+being removed that was previously there, it sends the corresponding <B><I>runsv</B>(8)</I>
+process a TERM signal, stops monitoring this process, and so does not restart
+the <B><I>runsv</B>(8)</I> process if it exits. <P>
+If the <I>log</I> argument is given to <B>runsvdir</B>,
+all output to standard error is redirected to this <I>log</I>, which is similar
+to the <B><I>readproctitle</B>(8)</I> log. To see the most recent error messages, use
+a process-listing tool such as <B><I>ps</B>(1)</I>. <B>runsvdir</B> writes a dot to the readproctitle
+log every 15 minutes so that old error messages expire. <P>
+Normally <B>runsvdir</B>
+is started by <B><I>runit</B>(8)</I> in stage 2. 
+<H2><A NAME="sect3">See Also</A></H2>
+<I>runit(8)</I>, <I>runit-init(8)</I>, <I>runsv(8)</I>,
+<I>readproctitle(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="sect4">Author</A></H2>
+Gerrit Pape &lt;pape@smarden.org&gt; <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">See Also</A></LI>
+<LI><A NAME="toc4" HREF="#sect4">Author</A></LI>
+</UL>
+</BODY></HTML>