Provided by: bsdutils_2.20.1-1ubuntu3_i386 bug

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/.