View source for Mailutils logger

The <tt>mailutils logger</tt> 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 <tt>--file</tt> 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 <tt>--syslog</tt> command line option. In that case <tt>mailutils</tt> uses facility <tt>user</tt> and priority <tt>err</tt>.  You can change this by using the <tt>--priority</tt> (<tt>-p</tt>) option.  Its argument is either a syslog facility name or facility and severity names separated by a dot.  Thus, the following invocation will use facility <tt>auth</tt>, severity <tt>info</tt>:

  mailutils logger --priority auth.info

The syslog tag can be set using the <tt>--tag</tt> (<tt>-t</tt>) option:

  mailutils logger --tag myprog

The default tag is <tt>mu-logger</tt>.

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

Finally, the <tt>--locus</tt> (<tt>-l</tt>) 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.rc:34 Suspicious statement

will send the following to the log:

  mailutils-logger: mailutils.rc:34: Suspicious statement

== See also ==
* [[mailutils (utility)]]

[[Category:utilities]]