Imported Upstream version 0.63.0
[hcoop/debian/courier-authlib.git] / liblog / courierlogger.html
index 8222d60..29a7e39 100644 (file)
@@ -1,12 +1,12 @@
 <?xml version="1.0"?>
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>courierlogger</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.72.0"/><link rel="start" href="#courierlogger" title="courierlogger"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>courierlogger</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"/><link rel="start" href="#courierlogger" title="courierlogger"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
 
 Copyright 1998 - 2007 Double Precision, Inc.  See COPYING for distribution
 information.
 
 --></head><body><div class="refentry" lang="en" xml:lang="en"><a id="courierlogger" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>courierlogger — Courier syslog wrapper</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">courierlogger</code>  [-name=<em class="replaceable"><code>title</code></em>] [-facility=<em class="replaceable"><code>subsystem</code></em>] [-pid=<em class="replaceable"><code>filename</code></em>] [-user=<em class="replaceable"><code>user</code></em>] [-group=<em class="replaceable"><code>group</code></em>] [-droproot] [[[-respawn]  [-start]
-             <em class="replaceable"><code>program</code></em>  [argument...]] |  [-stop] |  [-restart]]</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id282594" shape="rect"> </a><h2>DESCRIPTION</h2><p>
-<span><strong class="command">courierlogger</strong></span>
+             <em class="replaceable"><code>program</code></em>  [argument...]] |  [-stop] |  [-restart]]</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id499646" shape="rect"> </a><h2>DESCRIPTION</h2><p>
+<span class="command"><strong>courierlogger</strong></span>
 is a wrapper that captures
 another process's error messages, and forwards them
 to the system logging facility,
@@ -15,13 +15,13 @@ There are two ways to use courierlogger:
 </p><div class="orderedlist"><ol type="1"><li><p>
 Use the shell to pipe another command's standard error, and/or its standard
 output, to
-<span><strong class="command">courierlogger</strong></span>'s standard input.</p></li><li><p>
+<span class="command"><strong>courierlogger</strong></span>'s standard input.</p></li><li><p>
 Alternatively,
-<span><strong class="command">courierlogger</strong></span>
+<span class="command"><strong>courierlogger</strong></span>
 itself can start another process, and arrange to have its standard error
 captured.</p></li></ol></div><p>
     </p><p>
-In either case, each read line of text is sent as a syslog message.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id282654" shape="rect"> </a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-name=<em class="replaceable"><code>title</code></em></span></dt><dd><p>
+In either case, each read line of text is sent as a syslog message.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id499706" shape="rect"> </a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-name=<em class="replaceable"><code>title</code></em></span></dt><dd><p>
 Use <em class="replaceable"><code>title</code></em> for sending messages to syslog.
 <em class="replaceable"><code>title</code></em> should be the application's name.</p></dd><dt><span class="term">-facility=<em class="replaceable"><code>subsystem</code></em></span></dt><dd><p>
 Use <em class="replaceable"><code>subsystem</code></em> for classifying messages.
@@ -32,7 +32,7 @@ Not all of the above facility names are implemented on every system.
 Check your system's syslog documentation for information on which facility
 names are allowed, and which log files record the corresponding messages
 for each facility.</p></div></dd><dt><span class="term">-pid=<em class="replaceable"><code>filename</code></em></span></dt><dd><p>
-Save <span><strong class="command">courierlogger</strong></span>'s
+Save <span class="command"><strong>courierlogger</strong></span>'s
 process ID in <em class="replaceable"><code>filename</code></em>.
 The <em class="parameter"><code>-pid</code></em> option is required when
 <em class="parameter"><code>-start</code></em>,
@@ -40,15 +40,15 @@ The <em class="parameter"><code>-pid</code></em> option is required when
 <em class="parameter"><code>-restart</code></em> are given. If <em class="parameter"><code>-pid</code></em>
 is given without any of these, <em class="parameter"><code>-start</code></em> is assumed.</p></dd><dt><span class="term">-start</span></dt><dd><p>
 Run as a daemon. The <code class="option">pid</code> option is required.
-<span><strong class="command">courierlogger</strong></span> will quietly terminate if another
-<span><strong class="command">courierlogger</strong></span> process is already running.
+<span class="command"><strong>courierlogger</strong></span> will quietly terminate if another
+<span class="command"><strong>courierlogger</strong></span> process is already running.
 This is used to make sure that only one instance of
 <code class="filename">program</code> is running at the same time.
 Specify a different filename with <code class="option">pid</code> to start a second
 copy of <code class="filename">program</code>.</p></dd><dt><span class="term">-respawn</span></dt><dd><p>
 Restart <code class="filename">program</code> if it terminates.
 Normally
-<span><strong class="command">courierlogger</strong></span> itself will terminate when
+<span class="command"><strong>courierlogger</strong></span> itself will terminate when
 <code class="filename">program</code> finishes running.
 Use <code class="option">respawn</code> to restart it instead.</p></dd><dt><span class="term">-restart</span></dt><dd><p>
 Send a <code class="literal">SIGHUP</code> signal to the courierlogger process
@@ -60,7 +60,7 @@ Does nothing if courierlogger is not running.</p><div class="note" style="margin
 <code class="option">respawn</code> option if sending it a <code class="literal">SIGHUP</code>
 causes it to terminate.</p></div><p>
 The same thing may be accomplished by sending <code class="literal">SIGHUP</code>
-to <span><strong class="command">courierlogger</strong></span> itself.</p></dd><dt><span class="term">-stop</span></dt><dd><p>
+to <span class="command"><strong>courierlogger</strong></span> itself.</p></dd><dt><span class="term">-stop</span></dt><dd><p>
 Send a <code class="literal">SIGTERM</code> signal to courierlogger, which in turn
 forwards it on to <code class="filename">program</code>.
 If <code class="filename">program</code> does not terminate in 8 seconds, kill it
@@ -78,12 +78,12 @@ Drop root privileges before starting the child process.
 The <code class="option">-user</code> and <code class="option">-group</code> options specify
 the non-privileges userid and groupid.
 Without the <code class="option">-droproot</code> option the child process remains
-a root process, and only the parent <span><strong class="command">courierlogger</strong></span>
+a root process, and only the parent <span class="command"><strong>courierlogger</strong></span>
 process drops root privileges.</p></dd><dt><span class="term"><em class="replaceable"><code>program</code></em> [ argument ] ... </span></dt><dd><p>
 If a program is given <code class="filename">program</code>
 will be started as a child process of
-<span><strong class="command">courierlogger</strong></span>, capturing its standard error.
-Otherwise, <span><strong class="command">courierlogger</strong></span>
+<span class="command"><strong>courierlogger</strong></span>, capturing its standard error.
+Otherwise, <span class="command"><strong>courierlogger</strong></span>
 reads message from standard input, and automatically terminates when
-standard input is closed.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id325631" shape="rect"> </a><h2>SEE ALSO</h2><p>
-<a href="couriertcpd.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">couriertcpd</span>(1)</span></a>, your syslog man page.</p></div></div></body></html>
+standard input is closed.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id544484" shape="rect"> </a><h2>SEE ALSO</h2><p>
+<a class="ulink" href="couriertcpd.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">couriertcpd</span>(1)</span></a>, your syslog man page.</p></div></div></body></html>