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)