X-Git-Url: https://git.hcoop.net/hcoop/debian/courier-authlib.git/blobdiff_plain/ac40fd9eb9d1980c90dc009d526a23ead1ec0f76..refs/tags/upstream/0.63.0:/liblog/courierlogger.html diff --git a/liblog/courierlogger.html b/liblog/courierlogger.html index 8222d60..29a7e39 100644 --- a/liblog/courierlogger.html +++ b/liblog/courierlogger.html @@ -1,12 +1,12 @@ -courierlogger

Name

courierlogger — Courier syslog wrapper

Synopsis

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

DESCRIPTION

-courierlogger + program [argument...]] | [-stop] | [-restart]]

DESCRIPTION

+courierlogger is a wrapper that captures another process's error messages, and forwards them to the system logging facility, @@ -15,13 +15,13 @@ 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. +courierlogger's standard input.

  3. Alternatively, -courierlogger +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

+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. @@ -32,7 +32,7 @@ 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 +Save courierlogger's process ID in filename. The -pid option is required when -start, @@ -40,15 +40,15 @@ The -pid option is required when -restart are given. If -pid is given without any of these, -start is assumed.

-start

Run as a daemon. The pid option is required. -courierlogger will quietly terminate if another -courierlogger process is already running. +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 +courierlogger itself will terminate when program finishes running. Use respawn to restart it instead.

-restart

Send a SIGHUP signal to the courierlogger process @@ -60,7 +60,7 @@ Does nothing if courierlogger is not running.

respawn option if sending it a SIGHUP causes it to terminate.

The same thing may be accomplished by sending SIGHUP -to courierlogger itself.

-stop

+to courierlogger itself.

-stop

Send a SIGTERM signal to courierlogger, which in turn forwards it on to program. If program does not terminate in 8 seconds, kill it @@ -78,12 +78,12 @@ Drop root privileges before starting the child process. The -user and -group options specify the non-privileges userid and groupid. Without the -droproot option the child process remains -a root process, and only the parent courierlogger +a root process, and only the parent courierlogger process drops root privileges.

program [ argument ] ...

If a program is given program will be started as a child process of -courierlogger, capturing its standard error. -Otherwise, courierlogger +courierlogger, capturing its standard error. +Otherwise, courierlogger reads message from standard input, and automatically terminates when -standard input is closed.

SEE ALSO

-couriertcpd(1), your syslog man page.

+standard input is closed.

SEE ALSO

+couriertcpd(1), your syslog man page.