Difference between revisions of "Mailutils logger"

From Mailutils
Jump to navigationJump to search
m
 
Line 28: Line 28:
 
Finally, the <tt>--locus</tt> (<tt>-l</tt>) option binds log messages to a location in a file.  Its argument has the following syntax:
 
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'']
+
   ''file'':''line''[.''col''][-[''file'':]''line''[.''col'']]
  
 
where ''file'' is the file name, ''line'' is the line number and optional ''col'' is the column number in that file.
 
where ''file'' is the file name, ''line'' is the line number and optional ''col'' is the column number in that file.

Latest revision as of 18:20, 15 June 2017

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. Thus, 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 strings: 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][-[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