# COURIERLOGGER - Courier syslog wrapper - man(1) - [phpMan]


*Source: tldr-pages*

---

[_COURIERLOGGER_(1)](https://www.chedong.com/phpMan.php/man/COURIERLOGGER/1/markdown)                       Double Precision, Inc.                       [_COURIERLOGGER_(1)](https://www.chedong.com/phpMan.php/man/COURIERLOGGER/1/markdown)

## 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 **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_ 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. 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 the courierlogger process (as determined by examining the
           contents of the file specified by **pid**), which will in turn send a SIGHUP to its child
           program. Does nothing if courierlogger is not running.

               **Note**
               program must be originally started with the **respawn **option if sending it a SIGHUP
               causes it to terminate.
           The same thing may be accomplished by sending SIGHUP 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 with SIGKILL.

       -user=_user_, -group=_group_
           If running as root, change credentials to the given user and/or group, which may be given
           as names or numeric ids.

           When running a child program, it is started _before_ privileges are dropped (unless the
           **-droproot **option is also given). This gives a means of starting a child as root so it can
           bind to a privileged port, but still have courierlogger run as a non-root user. For the
           **-stop **and **-restart **options to work, you should configure the child program to drop its
           privileges to the same userid too.

### -droproot
           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 **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 **reads message from standard input,
           and automatically terminates when standard input is closed.

## SEE ALSO
       [**couriertcpd**(1)](https://www.chedong.com/phpMan.php/man/couriertcpd/1/markdown)[1], your syslog man page.

## NOTES
        1. [**couriertcpd**(1)](https://www.chedong.com/phpMan.php/man/couriertcpd/1/markdown)
           [set $man.base.url.for.relative.links]/couriertcpd.html

Double Precision, Inc.                       05/21/2021                             [_COURIERLOGGER_(1)](https://www.chedong.com/phpMan.php/man/COURIERLOGGER/1/markdown)