4 logger: Send messages to system log
logger is a program to send entries to system log. It
provides a shell command interface similar to the system log module.
See Syslog, for
details.
logger [option...] [message]
- -4
- --ipv4
- Use IPv4 as transport when logging to a host. The default behaviour
is to use whatever IP version that matches the host.
- -6
- --ipv6
- Use IPv6 as transport when logging to a host. The option is present
also on systems without support for IPv6, but will then issue a warning
and then fall back to IPv4 when delivering the message.
Both options are most influencial when the target host is named using
a symbolic name, but numerical addresses for host or source must also
match if either of --ipv4 or --ipv6 is stated.
- -i[pid]
- --id=[pid]
- Add process ID to each message. If pid is not supplied, use the
process ID of the logger process with each line. Notice, that
pid is an optional argument. When supplied to the -i
option, it must follow the ‘i’ letter immediately, without any
separating whitespace. When supplied to the --id form, it
must be separated from it by exactly one equals sign.
- -h host
- --host=host
- Send messages to the given host or socket. The host argument
can be either a local UNIX socket name (starting with a dash ‘/’),
or:
host[:port]
where host is the remote host name or IP address, and the
optional port is a decimal port number or symbolic service
name from /etc/services. If port is not specified,
the port number corresponding to the ‘syslog’ service is used.
If a numerical IPv6 address is given without a port specification,
then the address must be enclosed within brackets (like [::1]).
- -S addr
- --source=addr
- Supply the source IP address for INET connections. This option is
useful in conjunction with --host (see above). The kind of
address specified here (IPv4 or IPv6) will propagate to influence
the resolution of the host address, if it is a symbolic name.
- -s
- --stderr
- Log the message to standard error, as well as the system log.
- -f file
- --file=file
- Log the content of the specified file. If file is ‘-’ the
standard input is assumed.
- -p priority
- --priority=priority
- 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 at the informational
level in the ‘local3’ facility. The default is
‘user.notice’.
The actual list of supported facilities and levels is system specific.
- -t tag
- --tag=tag
- Mark every line in the log with the specified tag.
The options are followed by the message which should be written to the
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.
The following examples illustrate the usage of the logger
command:
- Log the message ‘System rebooted’ to the local syslog.
Use default facility and priority:
logger System rebooted
- Run command and send its error output to the channel
‘local0.err’. Mark each message with tag ‘cmd’:
command 2>&1 | logger -p local0.notice -t cmd
- Log each line from file warnings to channel
‘daemon.warn’ on host ‘logger.runasimi.org’,
using the source IP ‘10.10.10.1’:
logger -p daemon.warn -h logger.runasimi.org -S 10.10.10.1 --file
warnings