NAME

       logger — a shell command interface to the syslog(3) system log module

SYNOPSIS

       logger [-dhisV] [-f file] [-n server] [-P port] [-p pri] [-t tag] [-u socket] [message]

DESCRIPTION

       logger  makes  entries  in the system log.  It provides a shell command interface to the syslog(3) system
       log module.

       Options:

       -d, --udp
                Use datagram (UDP) instead of the default stream connection (TCP).

       -i, --id
                Log the process ID of the logger process with each line.

       -f, --file file
                Log the contents of the specified file.  This option cannot  be  combined  with  a  command-line
                message.

       -h, --help
                Display a help text and exit.

       -n, --server server
                Write to the specified remote syslog server using UDP instead of to the builtin syslog routines.

       -P, --port port
                Use the specified UDP port.  The default port number is 514.

       -p, --priority priority
                Enter  the  message  into  the  log  with the specified priority.  The priority may be specified
                numerically or as a facility.level pair.  For  example,  -p  local3.info  logs  the  message  as
                informational in the local3 facility.  The default is user.notice.

       -s, --stderr
                Output the message to standard error as well as to the system log.

       -t, --tag tag
                Mark every line to be logged with the specified tag.

       -u, --socket socket
                Write to the specified socket instead of to the builtin syslog routines.

       -V, --version
                Display version information and exit.

       --       End the argument list. This is to allow the message to start with a hyphen (-).

       message  Write  the  message to log; if not specified, and the -f flag is not provided, standard input is
                logged.

       The logger utility exits 0 on success, and >0 if an error occurs.

       Valid facility names are: auth, authpriv (for security information of a sensitive nature), cron,  daemon,
       ftp,  kern  (can't  be  generated  from  user process), lpr, mail, news, security (deprecated synonym for
       auth), syslog, user, uucp, and local0 to local7, inclusive.

       Valid level names are: alert, crit, debug, emerg, err, error (deprecated synonym for err), info,  notice,
       panic  (deprecated  synonym for emerg), warning, warn (deprecated synonym for warning).  For the priority
       order and intended purposes of these levels, see syslog(3).

EXAMPLES

             logger System rebooted

             logger -p local0.notice -t HOSTIDM -f /dev/idmc

             logger -n loghost.example.com System rebooted

SEE ALSO

       syslog(3), syslogd(8)

STANDARDS

       The logger command is expected to be IEEE Std 1003.2 (“POSIX.2”) compatible.

AVAILABILITY

       The   logger   command   is   part   of    the    util-linux    package    and    is    available    from
       ftp://ftp.kernel.org/pub/linux/utils/util-linux/.

util-linux                                       August 2011                                         LOGGER(1)()