GNU Mailutils
	General-Purpose Mail Package	Official GNU Software

• Main
• Downloads
• Documentation
• Wiki

3.20.13 mailutils logger

The mailutils logger tool logs information using Mailutils log facility.

Syntax:

mailutils logger [options] [message]

The message argument, if supplied, gives the text to log. If not supplied, the utility reads lines of text from standard input or a file (if the --file option is given) and sends them to log:

# Send text to log
$ mailutils logger I am here
# Log each line from file.txt
$ mailutils logger --file file.txt
# Read stdin and log it:
$ mailutils logger

The default logging channel is bound to standard error. To bind it to syslog, use the --syslog command line option. In that case mailutils uses facility ‘user’ and priority ‘err’. You can change this by using the --priority (-p) option. Its argument is either a syslog facility name or facility and severity names separated by a dot. For example, the following invocation will use facility ‘auth’, severity ‘info’:

mailutils logger --priority auth.info

The syslog tag can be set using the --tag (-t) option:

mailutils logger --tag myprog

The default tag is ‘mu-logger’.

The --severity (-s) option sets the Mailutils severity level. Its argument can be any of the following: ‘debug’, ‘info’, ‘notice’, ‘warning’, ‘error’, ‘crit’, ‘alert’, ‘emerg’.

Finally, the --locus (-l) option binds log messages to a location in a file. Its argument has the following syntax:

file:line[:col]

where file is the file name, line is the line number and optional col is the column number in that file.

For example, the following invocation:

mailutils logger --locus mailutils.conf:34 Suspicious statement

will send the following to the log:

mu-logger: mailutils.conf:34: Suspicious statement