xref: /illumos-gate/usr/src/man/man1b/logger.1b (revision 9174bfaa08ca3aa4c0a12e840c4bd4f2570237a0)
te
Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved. Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software
License Agreement specifies the terms and conditions for redistribution.
LOGGER 1B "Sep 14, 1992"
NAME
logger - add entries to the system log
SYNOPSIS

/usr/ucb/logger [-f filename] [-i] [-p priority] [-t tag] mm
 [message]...
DESCRIPTION

The logger utility provides a method for adding one-line entries to the system log file from the command line. One or more message arguments can be given on the command line, in which case each is logged immediately. If message is unspecified, either the file indicated with -f or the standard input is added to the log. Otherwise, a filename 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: -i

Log the process ID of the logger process with each line.

-f filename

Use the contents of filename as the message to log.

-p priority

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

-t tag

Mark each line added to the log with the specified tag.

EXAMPLES

Example 1 Logging a message

The command:

example% logger System rebooted

will log the message `System rebooted' to the facility at priority notice to be treated by syslogd as other messages to the facility notice are.

Example 2 Logging messages from a file

The command:

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

will read from the file /dev/idmc and will log each line in that file as a message with the tag `HOSTIDM' at priority notice to be treated by syslogd as other messages to the facility local0 are.

SEE ALSO

syslog (3C), attributes (7), syslogd (8)