COURIERLOGGER(1)

NAME
courierlogger - Courier syslog wrapper

SYNOPSIS
courierlogger [ -name=title ] [ -facility=subsystem ] [ -pid=filename ] [ [ -respawn ] -start program [ argument ... ] | -stop | -restart ]

DESCRIPTION

courierlogger is a wrapper that captures another process's error messages, and forwards them to the system logging facility, ``syslog''.

There are two ways to use courierlogger:

1.  Use the shell to pipe another command's standard error, and/or its standard output, to courierlogger's standard input.

2.  Alternatively, courierlogger itself can start another process, and arrange to have its standard error captured.

In either case, each read line of text is sent as a syslog message.

OPTIONS

-name=title
    Use title for sending messages to syslog. title should be the application's name.

-facility=subsystem
    Use subsystem for classifying messages. Your syslog facility uses subsystem to determine which log messages are recorded in which log files. The currently defined subsystems are:

    •   auth

    •   authpriv

    •   console

    •   cron

    •   daemon

    •   ftp

    •   kern

    •   lpr

    •   mail

    •   news

    •   security

    •   user

    •   uucp

    •   local0

    •   local1

    •   local2

    •   local3

    •   local4

    •   local5

    •   local6

    •   local7

    Note: Not all of the above facility names are implemented on every system. Check your system's syslog documentation for information on which facility names are allowed, and which log files record the corresponding messages for each facility.

-pid=filename
    Save courierlogger's process ID in filename. The -pid option is required when -start, -stop, -restart.

-start program [argument...]
    Start program, and capture its standard error. Otherwise, courierlogger reads message from standard input, and automatically terminated when standard input is closed. If the start option is given program will be started as a child process of courierlogger, capturing its standard error. The pid option is required. courierlogger will quietly terminate if another courierlogger process is already running. This is used to make sure that only one instance of program is running at the same time. Specify a different filename with pid to start a second copy of program.

-respawn
    Restart program if it terminates. Normally courierlogger itself will terminate when program finishes running. Use respawn to restart it instead.

-restart
    Send a SIGHUP signal to program. Does nothing if program is not running (as determined by examining the contents of the file specified by pid).

    Note: program must be originally started with the respawn option.
The same thing may be accomplished by sending SIGHUP to courierlogger itself.

-stop
    Send a SIGTERM signal to program. If program does not terminate in ten seconds, kill it with SIGKILL. Does nothing if program is not running in the first place (as determined by examining the contents of the file specified by pid).

SEE ALSO

couriertcpd(1), your syslog man page.