logger(1) User Commands logger(1)NAME
logger - add entries to the system log
SYNOPSIS
logger [-i] [-f file] [-p priority] [-t tag] [message] ...
DESCRIPTION
The logger command provides a method for adding one-line entries to the system log file from the command line. One or more message argu-
ments can be given on the command line, in which case each is logged immediately. If this is unspecified, either the file indicated with -f
or the standard input is added to the log. Otherwise, a file can be specified, in which case each line in the file is logged. If neither
is specified, logger reads and logs messages on a line-by-line basis from the standard input.
OPTIONS
The following options are supported:
-ffile Uses the contents of file as the message to log.
-i Logs the process ID of the logger process with each line.
-ppriority Enters the message with the specified priority. The message priority can be specified numerically, or as a facility.level
pair. For example, `-p local3.info' assigns the message priority to the info level in the local3 facility. The default
priority is user.notice.
-ttag Marks each line added to the log with the specified tag.
OPERANDS
The following operand is supported:
message One of the string arguments whose contents are concatenated together, in the order specified, separated by single space
characters.
EXAMPLES
Example 1: Examples of the logger command
The following example:
example% logger System rebooted
logs the message `System rebooted' to the default priority level notice to be treated by syslogd as are other messages to the facility
user.
The next example:
example% logger -p local0.notice -t HOSTIDM -f /dev/idmc
reads from the file /dev/idmc and logs each line in that file as a message with the tag `HOSTIDM' at priority level notice to be treated by
syslogd as are other messages to the facility local0.
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables that affect the execution of logger: LANG, LC_ALL, LC_CTYPE, LC_MES-
SAGES, and NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWcsu |
+-----------------------------+-----------------------------+
|Interface Stability |Standard |
+-----------------------------+-----------------------------+
SEE ALSO mailx(1), write(1), syslogd(1M), syslog(3C), attributes(5), environ(5), standards(5)SunOS 5.10 1 Feb 1995 logger(1)
Check Out this Related Man Page
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 log-
ger will first try to use UDP, but if it fails a TCP connection 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 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 Linux Kernel Archive <ftp://ftp.kernel.org/pub/linux/utils/util-
linux/>.
util-linux April 2013 LOGGER(1)