LOGGER
Section: User Commands (1)
Index
Return to Main Contents
BSD mandoc
BSD 4.3
NAME
logger
- a shell command interface to the syslog(3) system log module
SYNOPSIS
logger
[-isd
]
[-f file
]
[-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:
- -i
-
Log the process id of the logger process
with each line.
- -s
-
Log the message to standard error, as well as the system log.
- -f file
-
Log the specified file.
- -p pri
-
Enter the message with the specified priority.
The priority may be specified numerically or as a ``facility.level''
pair.
For example, ``-p local3.info'' logs the message(s) as
info rmational
level in the
local3
facility.
The default is ``user.notice.''
- -t tag
-
Mark every line in the log with the specified
tag
- -u sock
-
Write to socket as specified with
socket
instead of builtin syslog routines.
- -d
-
Use a datagram instead of a stream connection to this socket.
- --
-
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, 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
SEE ALSO
syslog(3),
syslogd(8)
STANDARDS
The
logger
command is expected to be
St -p1003.2
compatible.
AVAILABILITY
The logger command is part of the util-linux-ng package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.