SYNOPSIS
[-d fd:level ] [-f facility ] [-p pidfile ] cmd [args... ]-f list
-l
-V | -h
DESCRIPTION
The 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 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, 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, 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
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.