FreeBSD manual
download PDF document: logger.1.pdf
LOGGER(1) FreeBSD General Commands Manual LOGGER(1)
NAME
logger - make entries in the system log
SYNOPSIS
logger [-46Ais] [-f file] [-H hostname] [-h host] [-P port] [-p pri]
[-S addr:port] [-t tag] [message ...]
DESCRIPTION
The logger utility provides a shell command interface to the syslog(3)
system log module.
The following options are available:
-4 Force logger to use IPv4 addresses only.
-6 Force logger to use IPv6 addresses only.
-A By default, logger tries to send the message to only one address,
even if the host has more than one A or AAAA record. If this
option is specified, logger tries to send the message to all
addresses.
-i Log the process id of the logger process with each line. This
flag is ignored and the process id is always logged. See also
-t.
-s Log the message to standard error, as well as the system log.
-f file
Read the contents of the specified file into syslog. This option
is ignored when a message is also specified.
-H hostname
Set the hostname in the header of the message to specified value.
If not specified, host part of gethostname(3) will be used.
-h host
Send the message to the remote system host instead of logging it
locally. Note that logger currently supports AF_INET (IPv4),
AF_INET6 (IPv6), and AF_LOCAL (Unix-domain socket) address
families. The following address formats are valid in host:
AF_INET 192.168.2.1
AF_INET6 2001:db8::1
AF_LOCAL /var/run/log
-P port
Send the message to the specified port number on a remote system,
which can be specified as a service name or as a decimal number.
The default is "syslog". If an unknown service name is used,
logger prints a warning and falls back to port 514.
-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 informational
level in the local3 facility. The default is "user.notice".
default of current login name. Use -t tag[N] to insert specific
decimal process id instead of id of logger.
message
Write the message to log; if not specified, and the -f flag is
not provided, standard input is logged.
EXIT STATUS
The logger utility exits 0 on success, and >0 if an error occurs.
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 IEEE Std 1003.2 ("POSIX.2")
compatible.
FreeBSD 14.0-RELEASE-p11 July 3, 2023 FreeBSD 14.0-RELEASE-p11