NAME¶
stdsyslog
—
log a program's output to the system log
SYNOPSIS¶
stdsyslog |
[ -d
fd:level ]
[-f
facility ]
[-p
pidfile ]
cmd
[args... ] |
DESCRIPTION¶
The
stdsyslog
utility executes a program,
reads everything that it outputs to a set of file descriptors (by default the
standard output and standard error streams) and logs it to the system log.
The
stdsyslog
utility may be passed the
following options:
-d
- Specify the level for messages on a file descriptor; may (and probably
should) be used more than once. If no
-d
options are specified,
stdsyslog
will assume “-d 1:info
-d 2:err”, i.e. log the program's standard output using the
“info” level and the errors using the “err”
one.
-f
- Specify the syslog facility to use, or “list” for a list of
the available values. If not specified,
stdsyslog
will use the
“daemon” facility.
-h
- Display program usage information and exit.
-l
- List the available syslog levels.
-p
- Specify the file to write the child process ID to.
-V
- Display program version information and exit.
EXAMPLES¶
The following examples are shown as given to the shell.
Log the string “information” to the “daemon:info”
syslog facility:
stdsyslog echo
information
Log the string “error” to the “local4:err” facility:
stdsyslog -f local4 sh -c 'echo error
1>&2'
Run the “sprog” program with two arguments, “some”
and “args”, store its process ID into the
sprog.pid file and log the messages
appearing on its standard output to “daemon:info” and the ones
on its standard error stream to “daemon:err”:
stdsyslog -p sprog.pid -d 1:info -d
2:crit sprog some args
SEE ALSO¶
logger(1),
syslog(3)
TODO¶
Planned or at least possible enhancements:
- *
- Command-line flags to specify openlog(3)
options.
- *
- Command-line flags to specify patterns for text appearing on some file
descriptors for possibly logging with another priority, e.g. lines
appearing on the standard error stream starting with “DBG:”
should be logged with the debug priority.