This file is indexed.

/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> &nbsp; [<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 &lsquo;<samp>user</samp>&rsquo; and priority &lsquo;<samp>err</samp>&rsquo;.  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 &lsquo;<samp>auth</samp>&rsquo;, severity &lsquo;<samp>info</samp>&rsquo;: 
</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 &lsquo;<samp>mu-logger</samp>&rsquo;.
</p>
<p>The <samp>--severity</samp> (<samp>-s</samp>) option sets the Mailutils
severity level.  Its argument can be any of the following:
&lsquo;<samp>debug</samp>&rsquo;, &lsquo;<samp>info</samp>&rsquo;, &lsquo;<samp>notice</samp>&rsquo;, &lsquo;<samp>warning</samp>&rsquo;,
&lsquo;<samp>error</samp>&rsquo;, &lsquo;<samp>crit</samp>&rsquo;, &lsquo;<samp>alert</samp>&rsquo;, &lsquo;<samp>emerg</samp>&rsquo;. 
</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> &nbsp; [<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>