/usr/share/doc/mailutils-doc/mailutils.html/mu-logger.html is in mailutils-doc 1:2.99.99-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Published by the Free Software Foundation,
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301, USA
Copyright (C) 1999-2004, 2008-2012, 2014-2015 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover, and no Back-Cover texts.
A copy of the license is included in the section entitled "GNU Free
Documentation License". -->
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Mailutils Manual: mu logger</title>
<meta name="description" content="GNU Mailutils Manual: mu logger">
<meta name="keywords" content="GNU Mailutils Manual: mu logger">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="mu.html#mu" rel="up" title="mu">
<link href="mu-pop.html#mu-pop" rel="next" title="mu pop">
<link href="Dbm-Exit-Codes.html#Dbm-Exit-Codes" rel="prev" title="Dbm Exit Codes">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="mu-logger"></a>
<div class="header">
<p>
Next: <a href="mu-pop.html#mu-pop" accesskey="n" rel="next">mu pop</a>, Previous: <a href="mu-dbm.html#mu-dbm" accesskey="p" rel="prev">mu dbm</a>, Up: <a href="mu.html#mu" accesskey="u" rel="up">mu</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="mu-logger-1"></a>
<h4 class="subsection">2.17.12 mu logger</h4>
<p>The <code>mu logger</code> tool logs information using Mailutils log facility.
</p>
<p>Syntax:
</p>
<div class="example">
<pre class="example">mu logger [<var>options</var>] [<var>message</var>]
</pre></div>
<p>The <var>message</var> 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 <samp>--file</samp> option is given) and sends them to log:
</p>
<div class="example">
<pre class="example"># Send text to log
$ mu logger I am here
# Log each line from file.txt
$ mu logger --file file.txt
# Read stdin and log it:
$ mu logger
</pre></div>
<p>The default logging channel is bound to standard error. To bind it to
syslog, use the <samp>--syslog</samp> command line option. In that case
<code>mu</code> uses facility ‘<samp>user</samp>’ and priority ‘<samp>err</samp>’. You
can change this by using the <samp>--priority</samp> (<samp>-p</samp>) 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 ‘<samp>auth</samp>’, severity ‘<samp>info</samp>’:
</p>
<div class="example">
<pre class="example">mu logger --priority auth.info
</pre></div>
<p>The syslog tag can be set using the <samp>--tag</samp> (<samp>-t</samp>) option:
</p>
<div class="example">
<pre class="example">mu logger --tag myprog
</pre></div>
<p>The default tag is ‘<samp>mu-logger</samp>’.
</p>
<p>The <samp>--severity</samp> (<samp>-s</samp>) option sets the Mailutils
severity level. Its argument can be any of the following:
‘<samp>debug</samp>’, ‘<samp>info</samp>’, ‘<samp>notice</samp>’, ‘<samp>warning</samp>’,
‘<samp>error</samp>’, ‘<samp>crit</samp>’, ‘<samp>alert</samp>’, ‘<samp>emerg</samp>’.
</p>
<p>Finally, the <samp>--locus</samp> (<samp>-l</samp>) option binds log messages
to a location in a file. Its argument has the following syntax:
</p>
<div class="example">
<pre class="example"><var>file</var>:<var>line</var>[:<var>col</var>]
</pre></div>
<p>where <var>file</var> is the file name, <var>line</var> is the line number and
optional <var>col</var> is the column number in that file.
</p>
<p>For example, the following invocation:
</p>
<div class="example">
<pre class="example">mu logger --locus mailutils.rc:34 Suspicious statement
</pre></div>
<p>will send the following to the log:
</p>
<div class="example">
<pre class="example">mu-logger: mailutils.rc:34: Suspicious statement
</pre></div>
<hr>
<div class="header">
<p>
Next: <a href="mu-pop.html#mu-pop" accesskey="n" rel="next">mu pop</a>, Previous: <a href="mu-dbm.html#mu-dbm" accesskey="p" rel="prev">mu dbm</a>, Up: <a href="mu.html#mu" accesskey="u" rel="up">mu</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|