[ashd.git] / doc / errlogger.doc

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)
Commit	Line	Data
	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)