commit d495de788e217de78ca37094de63fe7e5b23c1e1
parent 6fdac06ef08f12cd3c0ea5baa1e61ea2d543e91d
Author: Gerrit Pape <pape@smarden.org>
Date: Sun, 30 Jul 2006 05:05:56 +0000
html.
date.
Diffstat:
3 files changed, 44 insertions(+), 33 deletions(-)
diff --git a/doc/runsv.8.html b/doc/runsv.8.html
@@ -21,6 +21,12 @@ exists, <b>runsv</b> starts ./finish. If ./finish doesn’t exist or ./finis
<b>runsv</b> restarts ./run. <p>
If ./run or ./finish exit immediately, <b>runsv</b> waits a
second before starting ./finish or restarting ./run. <p>
+Two arguments are given
+to ./finish. The first one is ./run’s exit code, or -1 if ./run didn’t exit normally.
+The second one is the least significant byte of the exit status as determined
+by <i><b>waitpid</b>(2)</i>; for instance it is 0 if ./run exited normally, and the signal
+number if ./run was terminated by a signal. If <b>runsv</b> cannot start ./run for
+some reason, the exit code is 111 and the status is 0. <p>
If the file <i>service</i>/down
exists, <b>runsv</b> does not start ./run immediately. The control interface (see
below) can be used to start the service and to give other commands to <b>runsv</b>.
diff --git a/doc/svlogd.8.html b/doc/svlogd.8.html
@@ -11,7 +11,7 @@
<h2><a name='sect0'>Name</a></h2>
svlogd - runit’s service logging daemon
<h2><a name='sect1'>Synopsis</a></h2>
-<b>svlogd</b> [-ttv] [-r <i>c]</i> [-R
+<b>svlogd</b> [-tttv] [-r <i>c]</i> [-R
<i>xyz]</i> [-l <i>len]</i> [-b <i>buflen]</i> <i>logs</i>
<h2><a name='sect2'>Description</a></h2>
<i>logs</i> consists of one or more arguments,
@@ -187,50 +187,55 @@ error. </dd>
UTC timestamp of the form YYYY-MM-DD_HH:MM:SS.xxxxx when writing to <i>log</i> or
to standard error. </dd>
+<dt><b>-ttt</b> </dt>
+<dd>timestamp. Prefix each selected line with a human
+readable, sortable UTC timestamp of the form YYYY-MM-DDTHH:MM:SS.xxxxx when
+writing to <i>log</i> or to standard error. </dd>
+
<dt><b>-r <i>c</b> </i></dt>
-<dd>replace. <i>c</i> must be a single character. Replace non-printable
-characters in log messages with <i>c</i>. Characters are replaced before pattern
-matching is applied. </dd>
+<dd>replace. <i>c</i> must be a single character.
+Replace non-printable characters in log messages with <i>c</i>. Characters are replaced
+before pattern matching is applied. </dd>
<dt><b>-R <i>xyz</b> </i></dt>
-<dd>replace charset. Additionally to non-printable
-characters, replace all characters found in <i>xyz</i> with <i>c</i> (default ‘‘_’’). </dd>
+<dd>replace charset. Additionally to
+non-printable characters, replace all characters found in <i>xyz</i> with <i>c</i> (default
+‘‘_’’). </dd>
-<dt><b>-l <i>len</b>
-</i></dt>
-<dd>line length. Pattern matching applies to the first <i>len</i> characters of a log
-message only. Default is 1000. </dd>
+<dt><b>-l <i>len</b> </i></dt>
+<dd>line length. Pattern matching applies to the first <i>len</i> characters
+of a log message only. Default is 1000. </dd>
<dt><b>-b <i>buflen</b> </i></dt>
-<dd>buffer size. Set the size of the buffer
-<b>svlogd</b> uses when reading from standard input and writing to <i>logs</i> to <i>buflen</i>.
-Default is 1024. <i>buflen</i> must be greater than <i>len</i>. </dd>
+<dd>buffer size. Set the size
+of the buffer <b>svlogd</b> uses when reading from standard input and writing
+to <i>logs</i> to <i>buflen</i>. Default is 1024. <i>buflen</i> must be greater than <i>len</i>. </dd>
<dt><b>-v</b> </dt>
-<dd>verbose. Print verbose
-messages to standard error. </dd>
+<dd>verbose.
+Print verbose messages to standard error. </dd>
</dl>
<h2><a name='sect9'>Signals</a></h2>
-If <b>svlogd</b> is sent a HUP signal, it closes
-and reopens all <i>logs</i>, and updates their configuration according to <i>log/config</i>.
-If <b>svlogd</b> has trouble opening a log directory, it prints a warning, and
-discards this log directory. If <b>svlogd</b> is unable to open all log directories
-given at the command line, it exits with an error. <p>
-If <b>svlogd</b> is sent a TERM
-signal, or if it sees end-of-file on standard input, it stops reading standard
-input, processes the data in the buffer, waits for all <i>processor</i> subprocesses
-to finish if any, and exits 0 as soon as possible. <p>
-If <b>svlogd</b> is sent an
-ALRM signal, it forces log file rotation for all <i>logs</i> with a non empty
-<i>current</i> log file.
+If <b>svlogd</b> is sent a HUP
+signal, it closes and reopens all <i>logs</i>, and updates their configuration
+according to <i>log/config</i>. If <b>svlogd</b> has trouble opening a log directory,
+it prints a warning, and discards this log directory. If <b>svlogd</b> is unable
+to open all log directories given at the command line, it exits with an
+error. <p>
+If <b>svlogd</b> is sent a TERM signal, or if it sees end-of-file on standard
+input, it stops reading standard input, processes the data in the buffer,
+waits for all <i>processor</i> subprocesses to finish if any, and exits 0 as soon
+as possible. <p>
+If <b>svlogd</b> is sent an ALRM signal, it forces log file rotation
+for all <i>logs</i> with a non empty <i>current</i> log file.
<h2><a name='sect10'>See Also</a></h2>
-<i>sv(8)</i>, <i>runsv(8)</i>, <i>chpst(8)</i>, <i>runit(8)</i>, <i>runit-init(8)</i>,
-<i>runsvdir(8)</i>, <i>runsvchdir(8)</i> <p>
-<i>http://smarden.org/runit/</i>
+<i>sv(8)</i>, <i>runsv(8)</i>,
+<i>chpst(8)</i>, <i>runit(8)</i>, <i>runit-init(8)</i>, <i>runsvdir(8)</i>, <i>runsvchdir(8)</i> <p>
+<i>http://smarden.org/runit/</i>
+
<h2><a name='sect11'>Author</a></h2>
-Gerrit Pape <pape@smarden.org>
-<p>
+Gerrit Pape <pape@smarden.org> <p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
diff --git a/package/CHANGES b/package/CHANGES
@@ -1,5 +1,5 @@
1.7.0
-
+Sun, 30 Jul 2006 12:10:24 +0000
* svlogd.c, fmt_ptime.*, man/svlogd.8: new option -ttt: prefix log
messages with sortable UTC timestamp YYYY-MM-DDTHH:MM:SS.xxxxx.
* runsv.c, runsv.8: give two arguments to ./finish: exit code and exit
