psendfile: Fixed missing include.
[ashd.git] / doc / errlogger.doc
1 errlogger(1)
2 ============
3
4 NAME
5 ----
6 errlogger - Redirect standard error of a program to the system log
7
8 SYNOPSIS
9 --------
10 *errlogger* [*-h*] [*-n* 'NAME'] [*-f* 'FACILITY'] [*-p* 'PRIORITY'] 'PROGRAM' ['ARGS'...]
11
12 DESCRIPTION
13 -----------
14
15 *errlogger* starts the given 'PROGRAM' with its standard error
16 connected to a (write-only) pipe, the other end of which *errlogger*
17 will read lines from. Every line so read will be logged to the system
18 log.
19
20 The utility of *errlogger* is in the ability to log error messages
21 from programs connected to no other saved output, such as programs
22 started by *ashd*(7) in daemon mode.
23
24 *errlogger* will exit as soon as it reads end-of-file on its end of
25 the pipe; that is, when the write-end of the pipe is closed, which
26 will usually happen when the program exits.
27
28 OPTIONS
29 -------
30
31 *-h*::
32
33         Print a brief help message to standard output and exit.
34
35 *-n* 'NAME'::
36
37         Use 'NAME' as the log identification. If not given, 'PROGRAM'
38         will be used by default.
39
40 *-f* 'FACILITY'::
41
42         Log to the given log facility, which may be any of *auth*,
43         *authpriv*, *cron*, *daemon*, *ftp*, *kern*, *lpr*, *mail*,
44         *news*, *user*, *uucp* or *local0* through *local7*. By
45         default, *daemon* is used.
46
47 *-p* 'PRIORITY'::
48
49         Log at the given log priority, which may be any of *emerg*,
50         *alert*, *crit*, *err*, *warning*, *notice*, *info* or
51         *debug*. By default, *warning* is used.
52
53 AUTHOR
54 ------
55 Fredrik Tolf <fredrik@dolda2000.com>
56
57 SEE ALSO
58 --------
59 *syslog*(3), *ashd*(7)