 |
Click this button to go to the index for this section. |
logger(1)
NAME
logger - Makes entries in the system log
SYNOPSIS
/usr/bin/logger [-f file] [-i] [-p[facility.]priority] [-t tag]
[message...]
logger [-b] [message...]
STANDARDS
Interfaces documented on this reference page conform to industry standards
as follows:
logger: XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
OPTIONS
-b [DIGITAL] Logs the informational message to the binary event logger
instead of the syslog() subroutine and enters information in the binary
event log file. The uerf command with the -r 250 option reports the
informational messages that are in the binary event log file, which is
used for system maintenance and troubleshooting. The -b option cannot
be used with any other options.
-f file
[DIGITAL] Logs all lines in file.
-i [DIGITAL] Logs the process ID (PID) of the logger process with each
line.
-p [facility.]priority
[DIGITAL] Enters the message with the specified priority and, if
specified, from the specified facility.
[DIGITAL] You can specify priority as either an alphabetic string or
its integer equivalent. You can specify the following values for the
priority variable:
panic
[DIGITAL] (0)
emerg
[DIGITAL] The system is unusable. (0)
alert
[DIGITAL] Action must be taken immediately. (1)
crit
[DIGITAL] Critical conditions. (2)
err [DIGITAL] Error conditions. (3)
error
[DIGITAL] (3)
warn
[DIGITAL] (4)
warning
[DIGITAL] Warning conditions. (4)
notice
[DIGITAL] Normal but significant condition. (5)
info
[DIGITAL] Informational. (6)
debug
[DIGITAL] Debug-level messages. (7)
[DIGITAL] You can also specify a value for the facility variable,
which indicates the source of the event. You can specify facility as
either an alphabetic string or its integer equivalent. The integer
values appear in parentheses. You can specify the following values for
the facility variable:
kern
[DIGITAL] Kernel messages. (0)
user
[DIGITAL] Random user-level messages. (8)
mail
[DIGITAL] Mail system. (16)
daemon
[DIGITAL] System daemons. (24)
auth
[DIGITAL] Security/authorization messages. (32)
security
[DIGITAL] (32)
syslog
[DIGITAL] Messages syslogd generates internally. (40)
lpr [DIGITAL] Line printer subsystem. (48)
news
[DIGITAL] Network news subsystem. (56)
uucp
[DIGITAL] UUCP subsystem. (64)
cron
[DIGITAL] Clock daemon. (72)
local1
[DIGITAL] (128)
local1
[DIGITAL] (136)
local2
[DIGITAL] (144)
local3
[DIGITAL] (152)
local4
[DIGITAL] (160)
local5
[DIGITAL] (168)
local6
[DIGITAL] (176)
local7
[DIGITAL] (184)
-t tag
[DIGITAL] Precedes each entry in the log with tag.
OPERANDS
message
You can specify the message to be used for entries on the command line
or with the -f file option, which specifies that each line in file be
logged as an entry. If you do not specify message or -f, logger reads
standard input.
DESCRIPTION
The logger command makes the specified entries in the system log file.
The logger command provides a program and shell script interface to the
syslog() subroutine. The file in which entries are made depends on the
current system log configuration; see syslog and syslogd for more
information.
NOTES
The effects of the environment variable LC_MESSAGES apply only to
diagnostic messages generated by logger, and not to any messages written by
the use of the command.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
EXAMPLES
1. To log the system reboot, including the process ID of the process
running logger, enter:
logger -i System rebooted
2. To log each line in the file build.events with the tag trial build
preceding them, enter:
logger -f build.events -t "trial build"
3. The following commands are equivalent and enter events of warning
priority to the log:
logger -p warning
logger -p 4
4. The following commands are equivalent and enter events from the daemon
facility of warning priority:
logger -p daemon.warning
logger -p 24.4
5. To specify the debug priority with a priority name, enter:
logger -p debug my message
To specify the debug priority with a priority number, enter:
logger -p 7 my message
6. To specify both debug priority and the user facility, enter:
logger -p user.debug my message
To specify the same facility/priority pair using numeric values,
enter:
logger -p 8.7 my message
You can also combine alphabetic and numeric specifications:
logger -p user.7 my message
logger -p 8.debug my message
ENVIRONMENT VARIABLES
The following environment variables affect the execution of logger:
LANG
Provides a default value for the internationalization variables that
are unset or null. If LANG is unset or null, the corresponding value
from the default locale is used. If any of the internationalization
variables contain an invalid setting, the utility behaves as if none of
the variables had been defined.
LC_ALL
If set to a non-empty string value, overrides the values of all the
other internationalization variables.
LC_CTYPE
Determines the locale for the interpretation of sequences of bytes of
text data as characters (for example, single-byte as opposed to multi-
byte characters in arguments).
LC_MESSAGES
Determines the locale for the format and contents of diagnostic
messages written to standard error.
NLSPATH
Determines the location of message catalogues for the processing of
LC_MESSAGES.
SEE ALSO
Commands: binlogd(8), syslogd(8), uerf(8)
Functions: syslog(3)
Standards: standards(5)