huschi.net

LOGGER(1)                        User Commands                       LOGGER(1)

NAME
       logger - a shell command interface to the syslog(3) system log module
SYNOPSIS
       logger [options] [message]
DESCRIPTION
       logger  makes  entries  in the system log.  It provides a shell command
       interface to the syslog(3) system log module.
OPTIONS
       -n, --server server
              Write to the specified remote syslog server instead  of  to  the
              builtin syslog routines.  Unless --udp or --tcp is specified the
              logger will first try to use UDP, but if it fails a TCP  connec-
              tion is attempted.
       -d, --udp
              Use  datagram (UDP) only.  By default the connection is tried to
              syslog port defined in /etc/services, which is often 514.
       -T, --tcp
              Use stream (TCP) only.  By default the connection  is  tried  to
              syslog-conn port defined in /etc/services, which is often 601.
       -P, --port port
              Use  the specified port.  When this option is not specified, the
              port defaults to syslog for udp and to syslog-conn for tcp  con-
              nections.
       -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.
       -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  informa-
              tional in the local3 facility.  The default is user.notice.
       -S, --size size
              Sets  the  maximum  permitted message size. The default is 1KiB,
              which is the limit traditionally used and specified in RFC 3164.
              When selecting a maximum message size, it is important to ensure
              that the receiver supports the max size as well, otherwise  mes-
              sages may become truncated.
       -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.   The
              default  tag  is  the name of the user logged in on the terminal
              (or a user name based on effective user ID).
       -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.
FACILITIES AND LEVELS
       Valid facility names are:
              auth
              authpriv   for security information of a sensitive nature
              cron
              daemon
              ftp
              kern       cannot be generated from userspace process, automatically converted to user
              lpr
              mail
              news
              syslog
              user
              uucp
              local0
                to
              local7
              security   deprecated synonym for auth
       Valid level names are:
              emerg
              alert
              crit
              err
              warning
              notice
              info
              debug
              panic     deprecated synonym for emerg
              error     deprecated synonym for err
              warn      deprecated synonym for warning
       For  the  priority  order and intended purposes of these facilities and
       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")  com-
       patible.
AVAILABILITY
       The  logger  command is part of the util-linux package and is available
       from Linux Kernel  Archive  <ftp://ftp.kernel.org/pub/linux/utils/util-
       linux/>.

util-linux                        April 2013                         LOGGER(1)