LOGGER

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FACILITIES AND LEVELS
EXAMPLES
SEE ALSO
STANDARDS
AVAILABILITY

NAME

logger − a shell command interface to the syslog(3) system log module

SYNOPSIS

logger [options] [message]

DESCRIPTION

logger makes entries in the system log. It provides a shell command interface to the syslog(3) system log module.

OPTIONS

−n, −−server server

Write to the specified remote syslog server instead of to the builtin syslog routines. Unless −−udp or −−tcp is specified the logger will first try to use UDP, but if it fails a TCP connection is attempted.

−d, −−udp

Use datagram (UDP) only. By default the connection is tried to syslog port defined in /etc/services, which is often 514.

−T, −−tcp

Use stream (TCP) only. By default the connection is tried to syslog-conn port defined in /etc/services, which is often 601.

−P, −−port port

Use the specified port.

−i, −−id

Log the process ID of the logger process with each line.

−f, −−file file

Log the contents of the specified file. This option cannot be combined with a command-line message.

−h, −−help

Display a help text and exit.

−p, −−priority priority

Enter the message into the log with the specified priority. The priority may be specified numerically or as a facility.level pair. For example, -p local3.info logs the message as informational in the local3 facility. The default is user.notice.

−s, −−stderr

Output the message to standard error as well as to the system log.

−t, −−tag tag

Mark every line to be logged with the specified tag.

−u, −−socket socket

Write to the specified socket instead of to the builtin syslog routines.

−V, −−version

Display version information and exit.

−−

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.

FACILITIES AND LEVELS

Valid facility names are:

Valid level names are:

For the priority order and intended purposes of these facilities and levels, see syslog(3).

EXAMPLES

logger System rebooted
logger −p local0.notice −t HOSTIDM −f /dev/idmc
logger −n loghost.example.com System rebooted

SEE ALSO

syslog(3), syslogd(8)

STANDARDS

The logger command is expected to be IEEE Std 1003.2 ("POSIX.2") compatible.

AVAILABILITY

The logger command is part of the util-linux package and is available from Linux Kernel Archive.