/usr/share/doc/mailutils-doc/mailutils.html/Logging-and-Debugging.html is in mailutils-doc 1:3.4-1.
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 | <!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-2017 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.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Logging and Debugging (GNU Mailutils Manual)</title>
<meta name="description" content="Logging and Debugging (GNU Mailutils Manual)">
<meta name="keywords" content="Logging and Debugging (GNU Mailutils Manual)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<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="sieve-interpreter.html#sieve-interpreter" rel="up" title="sieve interpreter">
<link href="Extending-Sieve.html#Extending-Sieve" rel="next" title="Extending Sieve">
<link href="Sieve-Configuration.html#Sieve-Configuration" rel="prev" title="Sieve Configuration">
<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="Logging-and-Debugging"></a>
<div class="header">
<p>
Next: <a href="Extending-Sieve.html#Extending-Sieve" accesskey="n" rel="next">Extending Sieve</a>, Previous: <a href="Sieve-Configuration.html#Sieve-Configuration" accesskey="p" rel="prev">Sieve Configuration</a>, Up: <a href="sieve-interpreter.html#sieve-interpreter" accesskey="u" rel="up">sieve interpreter</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="Logging-and-debugging"></a>
<h4 class="subsubsection">3.9.1.3 Logging and debugging</h4>
<p>The default behavior of <code>sieve</code> is to remain silent about
anything except errors. However, it is sometimes necessary to see
which actions are executed and on which messages. This is particularly
useful when debugging the sieve scripts. The <samp>--verbose</samp>
(<samp>-v</samp>) option outputs log of every action executed.
</p>
<p>Option <samp>--debug</samp> allows to produce even more detailed debugging
information. This option takes an argument specifying the
debugging level to be enabled. The argument can consist of the
following letters:
</p>
<dl compact="compact">
<dt>‘<samp>t</samp>’</dt>
<dd><p>This flag enables sieve tracing. It means that every test will be logged
when executed.
</p>
</dd>
<dt>‘<samp>T</samp>’</dt>
<dd><p>This flag enables debugging of underlying <code>mailutils</code> library.
</p>
</dd>
<dt>‘<samp>P</samp>’</dt>
<dd><p>Trace network protocols: produces log of network transactions executed
while running the script.
</p>
</dd>
<dt>‘<samp>g</samp>’</dt>
<dd><p>Enable main parser traces. This is useful for debugging the sieve grammar.
</p>
</dd>
<dt>‘<samp>i</samp>’</dt>
<dd><p>Trace the program instructions. It is the most extensive debugging
level. It produces the full execution log of a sieve program, showing
each instruction and states of the sieve machine. It is only useful
for debugging the code generator.
</p></dd>
</dl>
<p><em>Note</em>, that there should be no whitespace
between the short variant of the option (<samp>-d</samp>), and its
argument. Similarly, when using long option (<samp>--debug</samp>),
its argument must be preceded by equal sign.
</p>
<p>If the argument to <samp>--debug</samp> is omitted, it defaults to
‘<samp>TPt</samp>’.
</p>
<p>Option <samp>--dump</samp> produces the disassembled dump of the compiled
sieve program.
</p>
<p>By default <code>sieve</code> outputs all diagnostics on standard error and verbose
logs on standard output. This behaviour is changed when
<samp>--log-facility</samp> is given in the command line (see <i>logging</i>).
This option causes <code>sieve</code> to output its diagnostics to
the given syslog facility.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Extending-Sieve.html#Extending-Sieve" accesskey="n" rel="next">Extending Sieve</a>, Previous: <a href="Sieve-Configuration.html#Sieve-Configuration" accesskey="p" rel="prev">Sieve Configuration</a>, Up: <a href="sieve-interpreter.html#sieve-interpreter" accesskey="u" rel="up">sieve interpreter</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>
|