From: Fredrik Tolf <fredrik@dolda2000.com>
Date: Fri, 11 Feb 2011 00:50:07 +0000 (+0100)
Subject: doc: Added manpage for errlogger.
X-Git-Tag: 0.6~4
X-Git-Url: http://www.dolda2000.com/gitweb/?p=ashd.git;a=commitdiff_plain;h=8724418706e39fc81f5f863cb628beedea13bd9d

doc: Added manpage for errlogger.
---

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 47e0dad..e018ed8 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,6 +1,6 @@
 dist_man1_MANS =	callcgi.1 dirplex.1 htparser.1 patplex.1 sendfile.1 \
 			userplex.1 htls.1 callscgi.1 accesslog.1 htextauth.1 \
-			callfcgi.1 multifscgi.1
+			callfcgi.1 multifscgi.1 errlogger.1
 
 dist_man7_MANS = ashd.7
 
diff --git a/doc/errlogger.doc b/doc/errlogger.doc
new file mode 100644
index 0000000..efe4a3d
--- /dev/null
+++ b/doc/errlogger.doc
@@ -0,0 +1,59 @@
+errlogger(1)
+============
+
+NAME
+----
+errlogger - Redirect standard error of a program to the system log
+
+SYNOPSIS
+--------
+*errlogger* [*-h*] [*-n* 'NAME'] [*-f* 'FACILITY'] [*-p* 'PRIORITY'] 'PROGRAM' ['ARGS'...]
+
+DESCRIPTION
+-----------
+
+*errlogger* starts the given 'PROGRAM' with its standard error
+connected to a (write-only) pipe, the other end of which *errlogger*
+will read lines from. Every line so read will be logged to the system
+log.
+
+The utility of *errlogger* is in the ability to log error messages
+from programs connected to no other saved output, such as programs
+started by *ashd*(7) in daemon mode.
+
+*errlogger* will exit as soon as it reads end-of-file on its end of
+the pipe; that is, when the write-end of the pipe is closed, which
+will usually happen when the program exits.
+
+OPTIONS
+-------
+
+*-h*::
+
+	Print a brief help message to standard output and exit.
+
+*-n* 'NAME'::
+
+	Use 'NAME' as the log identification. If not given, 'PROGRAM'
+	will be used by default.
+
+*-f* 'FACILITY'::
+
+	Log to the given log facility, which may be any of *auth*,
+	*authpriv*, *cron*, *daemon*, *ftp*, *kern*, *lpr*, *mail*,
+	*news*, *user*, *uucp* or *local0* through *local7*. By
+	default, *daemon* is used.
+
+*-p* 'PRIORITY'::
+
+	Log at the given log priority, which may be any of *emerg*,
+	*alert*, *crit*, *err*, *warning*, *notice*, *info* or
+	*debug*. By default, *warning* is used.
+
+AUTHOR
+------
+Fredrik Tolf <fredrik@dolda2000.com>
+
+SEE ALSO
+--------
+*syslog*(3), *ashd*(7)