summary refs log tree commit diff
path: root/doc/svlogd.8.html
diff options
context:
space:
mode:
authorGerrit Pape <pape@smarden.org>2005-02-13 17:30:32 +0000
committerGerrit Pape <pape@smarden.org>2005-02-13 17:30:32 +0000
commitb7aba731476a3a4b913ea42465cc24182ee8f05b (patch)
tree5ddaac1e346cc050d2eb515bf607bd10c25d25b5 /doc/svlogd.8.html
parent1c173f3538dbe3bdead741cde40ffa60ad562580 (diff)
downloadrunit-b7aba731476a3a4b913ea42465cc24182ee8f05b.tar.gz
runit-b7aba731476a3a4b913ea42465cc24182ee8f05b.tar.xz
runit-b7aba731476a3a4b913ea42465cc24182ee8f05b.zip
* doc/index.html, doc/replaceinit.html: no longer refer to sysvinit's
    shutdown program.
  * man/svlogd.8: svlogd doesn't decrease the number of log files in a log
    directory; with n0 don't remove any log files.
Diffstat (limited to 'doc/svlogd.8.html')
-rw-r--r--doc/svlogd.8.html166
1 files changed, 84 insertions, 82 deletions
diff --git a/doc/svlogd.8.html b/doc/svlogd.8.html
index 0f85815..900a6fc 100644
--- a/doc/svlogd.8.html
+++ b/doc/svlogd.8.html
@@ -46,125 +46,127 @@ or is older than a specified amount of <i>time</i>, <i>current</i> is rotated: <
 <b>svlogd</b>
 closes <i>current</i>, changes permission of <i>current</i> to 0755, renames <i>current</i>
 to @<i>timestamp.s,</i> and starts with a new empty <i>current</i>. If <b>svlogd</b> sees <i>num</i>
-or more old log files in <i>dir</i>, it removes the oldest one. 
+or more old log files in the log directory, it removes the oldest one. Note
+that this doesn&rsquo;t decrease the number of log files if there are already
+more than <i>num</i> log files. 
 <h3><a name='sect5'>Processor</a></h3>
-If <b>svlogd</b>
-is told to process recent log files, it saves <i>current</i> to @<i>timestamp.u,</i> feeds
-@<i>timestamp.u</i> through &lsquo;&lsquo;sh -c "<i>processor</i>"&rsquo;&rsquo; and writes the output to @<i>timestamp.t.</i>
-If the <i>processor</i> finishes successfully, @<i>timestamp.u</i> is deleted and @<i>timestamp.t</i>
-is renamed to @<i>timestamp.s,</i> otherwise @<i>timestamp.t</i> is deleted and the <i>processor</i>
-is started again. <b>svlogd</b> also saves any output that the <i>processor</i> writes
-to file descriptor 5, and makes that output available on file descriptor
-4 when running <i>processor</i> on the next log file rotation. <p>
-A <i>processor</i> is run
-in the background. If <b>svlogd</b> sees a previously started <i>processor</i> still running
-when trying to start a new one for the same <i>log</i>, it blocks until the currently
-running <i>processor</i> has finished successfully. Only the HUP signal works in
-that situation. Note that this may block any program feeding its log data
-to <b>svlogd.</b> 
+If <b>svlogd</b> is told to process recent log
+files, it saves <i>current</i> to @<i>timestamp.u,</i> feeds @<i>timestamp.u</i> through &lsquo;&lsquo;sh -c
+"<i>processor</i>"&rsquo;&rsquo; and writes the output to @<i>timestamp.t.</i> If the <i>processor</i> finishes
+successfully, @<i>timestamp.u</i> is deleted and @<i>timestamp.t</i> is renamed to @<i>timestamp.s,</i>
+otherwise @<i>timestamp.t</i> is deleted and the <i>processor</i> is started again. <b>svlogd</b>
+also saves any output that the <i>processor</i> writes to file descriptor 5, and
+makes that output available on file descriptor 4 when running <i>processor</i>
+on the next log file rotation. <p>
+A <i>processor</i> is run in the background. If <b>svlogd</b>
+sees a previously started <i>processor</i> still running when trying to start
+a new one for the same <i>log</i>, it blocks until the currently running <i>processor</i>
+has finished successfully. Only the HUP signal works in that situation. Note
+that this may block any program feeding its log data to <b>svlogd.</b> 
 <p> 
 <h3><a name='sect6'>Config</a></h3>
-On startup, and after receiving a HUP signal, <b>svlogd</b> checks
-for each <i>log</i> if the configuration file <i>log/config</i> exists, and if so, reads
-the file line by line and adjusts configuration for <i>log</i> as follows: <p>
-If
-the line is empty, less than two characters long, or starts with a &lsquo;&lsquo;#&rsquo;&rsquo;, it
-is ignored. A line of the form 
+On
+startup, and after receiving a HUP signal, <b>svlogd</b> checks for each log directory
+<i>log</i> if the configuration file <i>log/config</i> exists, and if so, reads the file
+line by line and adjusts configuration for <i>log</i> as follows: <p>
+If the line
+is empty, less than two characters long, or starts with a &lsquo;&lsquo;#&rsquo;&rsquo;, it is ignored.
+A line of the form 
 <dl>
 
 <dt>s<i>size</i> </dt>
-<dd>sets the maximum file size of <i>current</i>
-when <b>svlogd</b> should rotate the current log file to <i>size</i> bytes. Default is
-1000000. If <i>size</i> is zero, <b>svlogd</b> doesn&rsquo;t rotate log files. You should set
-<i>size</i> to at least (2 * <i>len</i>). </dd>
+<dd>sets the maximum file size of <i>current</i> when <b>svlogd</b>
+should rotate the current log file to <i>size</i> bytes. Default is 1000000. If
+<i>size</i> is zero, <b>svlogd</b> doesn&rsquo;t rotate log files. You should set <i>size</i> to at
+least (2 * <i>len</i>). </dd>
 
 <dt>n<i>num</i> </dt>
-<dd>sets the maximum number of old log files
-<b>svlogd</b> should maintain to <i>num</i>. If <b>svlogd</b> sees more that <i>num</i> old log files
-in <i>log</i> after log file rotation, it deletes the oldest one. Default is 10.
-</dd>
+<dd>sets the number of old log files <b>svlogd</b> should maintain
+to <i>num</i>. If <b>svlogd</b> sees more that <i>num</i> old log files in <i>log</i> after log file
+rotation, it deletes the oldest one. Default is 10. If <i>num</i> is zero, <b>svlogd</b>
+doesn&rsquo;t remove old log files. </dd>
 
 <dt>N<i>min</i> </dt>
-<dd>sets the minimum number of old log files <b>svlogd</b> should maintain to
-<i>min</i>. <i>min</i> must be less than <i>num</i>. If <i>min</i> is set, and <b>svlogd</b> cannot write to
-<i>current</i> because the filesystem is full, and it sees more than <i>min</i> old log
-files, it deletes the oldest one. </dd>
+<dd>sets the minimum number of old log files
+<b>svlogd</b> should maintain to <i>min</i>. <i>min</i> must be less than <i>num</i>. If <i>min</i> is set,
+and <b>svlogd</b> cannot write to <i>current</i> because the filesystem is full, and
+it sees more than <i>min</i> old log files, it deletes the oldest one. </dd>
 
-<dt>t<i>timeout</i> </dt>
-<dd>sets the maximum age of the <i>current</i>
-log file when <b>svlogd</b> should rotate the current log file to <i>timeout</i> seconds.
-If <i>current</i> is <i>timeout</i> seconds old, and is not empty, <b>svlogd</b> forces log
-file rotation. </dd>
+<dt>t<i>timeout</i>
+</dt>
+<dd>sets the maximum age of the <i>current</i> log file when <b>svlogd</b> should rotate
+the current log file to <i>timeout</i> seconds. If <i>current</i> is <i>timeout</i> seconds old,
+and is not empty, <b>svlogd</b> forces log file rotation. </dd>
 
 <dt>!<i>processor</i> </dt>
-<dd>tells <b>svlogd</b> to feed each recent log file through
-<i>processor</i> (see above) on log file rotation. By default log files are not
-processed. </dd>
+<dd>tells <b>svlogd</b>
+to feed each recent log file through <i>processor</i> (see above) on log file
+rotation. By default log files are not processed. </dd>
 
 <dt>u<i>a.b.c.d[:port]</i> </dt>
-<dd>tells <b>svlogd</b> to transmit the first <i>len</i> characters
-of selected log messages to the IP address <i>a.b.c.d</i>, port number <i>port</i>. If <i>port</i>
-isn&rsquo;t set, the default port for syslog is used (514). <i>len</i> can be set through
-the -l option, see below. If <b>svlogd</b> has trouble sending udp packets, it writes
-error messages to the log directory. Attention: logging through udp is unreliable,
-and should be used in private networks only. </dd>
+<dd>tells <b>svlogd</b>
+to transmit the first <i>len</i> characters of selected log messages to the IP
+address <i>a.b.c.d</i>, port number <i>port</i>. If <i>port</i> isn&rsquo;t set, the default port for syslog
+is used (514). <i>len</i> can be set through the -l option, see below. If <b>svlogd</b>
+has trouble sending udp packets, it writes error messages to the log directory.
+Attention: logging through udp is unreliable, and should be used in private
+networks only. </dd>
 
 <dt>U<i>a.b.c.d[:port]</i> </dt>
-<dd>is the same as
-the <i>u</i> line above, but the log messages are no longer written to the log
-directory, but transmitted through udp only. Error messages from <b>svlogd</b>
-concerning sending udp packages still go to the log directory. </dd>
+<dd>is the same as the <i>u</i> line above, but the log
+messages are no longer written to the log directory, but transmitted through
+udp only. Error messages from <b>svlogd</b> concerning sending udp packages still
+go to the log directory. </dd>
 </dl>
 <p>
-If a line
-starts with a <i>-</i>, <i>+</i>, <i>e</i>, or <i>E</i>, <b>svlogd</b> matches the first <i>len</i> characters of
-each log message against <i>pattern</i> and acts accordingly: 
+If a line starts with a <i>-</i>, <i>+</i>, <i>e</i>, or <i>E</i>, <b>svlogd</b> matches
+the first <i>len</i> characters of each log message against <i>pattern</i> and acts accordingly:
+
 <dl>
 
 <dt>-<i>pattern</i> </dt>
-<dd>the log
-message is deselected. </dd>
+<dd>the log message is deselected. </dd>
 
 <dt>+<i>pattern</i> </dt>
-<dd>the log message is selected. </dd>
+<dd>the log message is selected.
+</dd>
 
 <dt>e<i>pattern</i> </dt>
-<dd>the
-log message is selected to be printed to standard error. </dd>
+<dd>the log message is selected to be printed to standard error. </dd>
 
-<dt>E<i>pattern</i> </dt>
-<dd>the log
-message is deselected to be printed to standard error. </dd>
+<dt>E<i>pattern</i>
+</dt>
+<dd>the log message is deselected to be printed to standard error. </dd>
 </dl>
 <p>
-Initially each line
-is selected to be written to <i>log/current</i>. Deselected log messages are discarded
-from <i>log</i>. Initially each line is deselected to be written to standard err.
-Log messages selected for standard error are written to standard error.
-
+Initially
+each line is selected to be written to <i>log/current</i>. Deselected log messages
+are discarded from <i>log</i>. Initially each line is deselected to be written
+to standard err. Log messages selected for standard error are written to
+standard error. 
 <h2><a name='sect7'>Pattern Matching</a></h2>
-<b>svlogd</b> matches a log message against the string <i>pattern</i>
-as follows: <p>
-<i>pattern</i> is applied to the log message one character by one,
-starting with the first. A character not a star (&lsquo;&lsquo;*&rsquo;&rsquo;) and not a plus (&lsquo;&lsquo;+&rsquo;&rsquo;) matches
-itself. A plus matches the next character in <i>pattern</i> in the log message
-one or more times. A star before the end of <i>pattern</i> matches any string in
-the log message that does not include the next character in <i>pattern</i>. A star
-at the end of <i>pattern</i> matches any string. <p>
-Timestamps optionally added by
-<b>svlogd</b> are not considered part of the log message. 
+<b>svlogd</b> matches a log message against the
+string <i>pattern</i> as follows: <p>
+<i>pattern</i> is applied to the log message one character
+by one, starting with the first. A character not a star (&lsquo;&lsquo;*&rsquo;&rsquo;) and not a plus
+(&lsquo;&lsquo;+&rsquo;&rsquo;) matches itself. A plus matches the next character in <i>pattern</i> in the
+log message one or more times. A star before the end of <i>pattern</i> matches
+any string in the log message that does not include the next character
+in <i>pattern</i>. A star at the end of <i>pattern</i> matches any string. <p>
+Timestamps optionally
+added by <b>svlogd</b> are not considered part of the log message. 
 <h2><a name='sect8'>Options</a></h2>
 
 <dl>
 
 <dt><b>-t</b> </dt>
-<dd>timestamp. Prefix
-each selected line with a precise timestamp (see <i><b>tai64n</b>(8)</i>) when writing
-to <i>log</i> or to standard error. </dd>
+<dd>timestamp.
+Prefix each selected line with a precise timestamp (see <i><b>tai64n</b>(8)</i>) when
+writing to <i>log</i> or to standard error. </dd>
 
 <dt><b>-tt</b> </dt>
-<dd>timestamp. Prefix each selected line with
-a human readable, sortable UTC timestamp of the form YYYY-MM-DD_HH:MM:SS.xxxxx
+<dd>timestamp. Prefix each selected line
+with a human readable, sortable 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>-r <i>c</b> </i></dt>