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.
-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, --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 (depre‐
cated synonym for err), info, notice, panic (deprecated synonym for
emerg), warning, warn (deprecated synonym for warning). For the prior‐
ity 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 ALSOsyslog(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)