logger1
Make entries in the system log
Usage
logger [-46Ais]
[-f
file]
[-H
hostname]
[-h
host]
[-P
port]
[-p
pri]
[-S
addr:port]
[-t
tag]
[message ...]
Overview
The logger utility provides a shell command interface to the syslog(3) system log module.
The following options are available:
-
-4 -
Force
loggerto use IPv4 addresses only. -
-6 -
Force
loggerto use IPv6 addresses only. -
-A -
By default,
loggertries 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,loggertries 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
loggercurrently 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,
loggerprints 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, “
-plocal3.info” logs the message(s) as informational level in the local3 facility. The default is “user.notice”. -
-S addr:port -
Specify source address and/or source port when using
-hoption. The same address will be used for all of the remote addresses when-Aflag is enabled. Note that a numeric IPv6 address in addr must be enclosed with “[” and “]”. -
-t tag -
Mark every line in the log with the specified tag rather than the default of current login name. Use
-ttag[N] to insert specific decimal process id instead of id oflogger. - message
-
Write the message to log; if not specified, and the
-fflag 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
Releases
87 releases since FreeBSD 2.0.5-RELEASE; the text changed 46 times.
- 2.0.5–2.2.2
- 2.2.5–3.5.1
- 4.0
- 4.1
- 4.1.1–4.2
- 4.3
- 4.4–4.6.2
- 4.7–4.8
- 4.9–4.11
- 5.0
- 5.1–5.2.1
- 5.3–5.5
- 6.0–6.1
- 6.2–6.3
- 6.4
- 7.0
- 7.1
- 7.2
- 7.3
- 7.4
- 8.0
- 8.1
- 8.2
- 8.3
- 8.4
- 9.0
- 9.1
- 9.2
- 9.3
- 10.0
- 10.1
- 10.2
- 10.3
- 10.4
- 11.0
- 11.1
- 11.2
- 11.3
- 11.4
- 12.0
- 12.1
- 12.2
- 12.3
- 12.4
- 13.0–13.2
- 13.3–14.5
- 15.0–16.0
-4 since FreeBSD 4.3-RELEASE;
-6 since FreeBSD 4.3-RELEASE;
-A since FreeBSD 4.3-RELEASE;
-H since FreeBSD 12.0-RELEASE;
-P since FreeBSD 6.2-RELEASE;
-S since FreeBSD 12.0-RELEASE;
-h since FreeBSD 4.1.1-RELEASE.