/usr/share/doc/valgrind/html/lk-manual.html is in valgrind 1:3.10~20140411-0ubuntu1.
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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>13. Lackey: an example tool</title>
<link rel="stylesheet" type="text/css" href="vg_basic.css">
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Valgrind Documentation">
<link rel="up" href="manual.html" title="Valgrind User Manual">
<link rel="prev" href="bbv-manual.html" title="12. BBV: an experimental basic block vector generation tool">
<link rel="next" href="nl-manual.html" title="14. Nulgrind: the minimal Valgrind tool">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div><table class="nav" width="100%" cellspacing="3" cellpadding="3" border="0" summary="Navigation header"><tr>
<td width="22px" align="center" valign="middle"><a accesskey="p" href="bbv-manual.html"><img src="images/prev.png" width="18" height="21" border="0" alt="Prev"></a></td>
<td width="25px" align="center" valign="middle"><a accesskey="u" href="manual.html"><img src="images/up.png" width="21" height="18" border="0" alt="Up"></a></td>
<td width="31px" align="center" valign="middle"><a accesskey="h" href="index.html"><img src="images/home.png" width="27" height="20" border="0" alt="Up"></a></td>
<th align="center" valign="middle">Valgrind User Manual</th>
<td width="22px" align="center" valign="middle"><a accesskey="n" href="nl-manual.html"><img src="images/next.png" width="18" height="21" border="0" alt="Next"></a></td>
</tr></table></div>
<div class="chapter">
<div class="titlepage"><div><div><h1 class="title">
<a name="lk-manual"></a>13. Lackey: an example tool</h1></div></div></div>
<div class="toc">
<p><b>Table of Contents</b></p>
<dl class="toc">
<dt><span class="sect1"><a href="lk-manual.html#lk-manual.overview">13.1. Overview</a></span></dt>
<dt><span class="sect1"><a href="lk-manual.html#lk-manual.options">13.2. Lackey Command-line Options</a></span></dt>
</dl>
</div>
<p>To use this tool, you must specify
<code class="option">--tool=lackey</code> on the Valgrind
command line.</p>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="lk-manual.overview"></a>13.1. Overview</h2></div></div></div>
<p>Lackey is a simple Valgrind tool that does various kinds of basic
program measurement. It adds quite a lot of simple instrumentation to the
program's code. It is primarily intended to be of use as an example tool,
and consequently emphasises clarity of implementation over
performance.</p>
</div>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="lk-manual.options"></a>13.2. Lackey Command-line Options</h2></div></div></div>
<p>Lackey-specific command-line options are:</p>
<div class="variablelist">
<a name="lk.opts.list"></a><dl class="variablelist">
<dt>
<a name="opt.basic-counts"></a><span class="term">
<code class="option">--basic-counts=<no|yes> [default: yes] </code>
</span>
</dt>
<dd>
<p>When enabled, Lackey prints the following statistics and
information about the execution of the client program:</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>The number of calls to the function specified by the
<code class="option">--fnname</code> option (the default is
<code class="computeroutput">main</code>).
If the program has had its symbols stripped, the count will always
be zero.</p></li>
<li class="listitem"><p>The number of conditional branches encountered and the
number and proportion of those taken.</p></li>
<li class="listitem"><p>The number of superblocks entered and completed by the
program. Note that due to optimisations done by the JIT, this
is not at all an accurate value.</p></li>
<li class="listitem"><p>The number of guest (x86, amd64, ppc, etc.) instructions and IR
statements executed. IR is Valgrind's RISC-like intermediate
representation via which all instrumentation is done.
</p></li>
<li class="listitem"><p>Ratios between some of these counts.</p></li>
<li class="listitem"><p>The exit code of the client program.</p></li>
</ol></div>
</dd>
<dt>
<a name="opt.detailed-counts"></a><span class="term">
<code class="option">--detailed-counts=<no|yes> [default: no] </code>
</span>
</dt>
<dd><p>When enabled, Lackey prints a table containing counts of loads,
stores and ALU operations, differentiated by their IR types.
The IR types are identified by their IR name ("I1", "I8", ... "I128",
"F32", "F64", and "V128").</p></dd>
<dt>
<a name="opt.trace-mem"></a><span class="term">
<code class="option">--trace-mem=<no|yes> [default: no] </code>
</span>
</dt>
<dd><p>When enabled, Lackey prints the size and address of almost every
memory access made by the program. See the comments at the top of
the file <code class="computeroutput">lackey/lk_main.c</code> for details
about the output format, how it works, and inaccuracies in the address
trace. Note that this option produces immense amounts of output.</p></dd>
<dt>
<a name="opt.trace-superblocks"></a><span class="term">
<code class="option">--trace-superblocks=<no|yes> [default: no] </code>
</span>
</dt>
<dd><p>When enabled,
Lackey prints out the address of every superblock
(a single entry, multiple exit, linear chunk of code) executed by the
program. This is primarily of interest to Valgrind developers. See
the comments at the top of the file
<code class="computeroutput">lackey/lk_main.c</code> for details about
the output format. Note that this option produces large amounts of
output.</p></dd>
<dt>
<a name="opt.fnname"></a><span class="term">
<code class="option">--fnname=<name> [default: main] </code>
</span>
</dt>
<dd><p>Changes the function for which calls are counted when
<code class="option">--basic-counts=yes</code> is specified.</p></dd>
</dl>
</div>
</div>
</div>
<div>
<br><table class="nav" width="100%" cellspacing="3" cellpadding="2" border="0" summary="Navigation footer">
<tr>
<td rowspan="2" width="40%" align="left">
<a accesskey="p" href="bbv-manual.html"><< 12. BBV: an experimental basic block vector generation tool</a> </td>
<td width="20%" align="center"><a accesskey="u" href="manual.html">Up</a></td>
<td rowspan="2" width="40%" align="right"> <a accesskey="n" href="nl-manual.html">14. Nulgrind: the minimal Valgrind tool >></a>
</td>
</tr>
<tr><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td></tr>
</table>
</div>
</body>
</html>
|