de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 1 | <?xml version="1.0"?> <!-- -*- sgml -*- --> |
| 2 | <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
| 3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
| 4 | [ <!ENTITY % vg-entities SYSTEM "vg-entities.xml"> %vg-entities; ]> |
| 5 | |
| 6 | |
| 7 | <refentry id="valgrind"> |
| 8 | |
| 9 | <refmeta> |
| 10 | <refentrytitle>VALGRIND</refentrytitle> |
| 11 | <manvolnum>1</manvolnum> |
| 12 | <refmiscinfo>Release &rel-version;</refmiscinfo> |
| 13 | </refmeta> |
| 14 | |
| 15 | <refnamediv> |
| 16 | <refname>valgrind</refname> |
| 17 | <refpurpose>a suite of tools for debugging and profiling programs</refpurpose> |
| 18 | </refnamediv> |
| 19 | |
| 20 | <refsynopsisdiv> |
| 21 | <cmdsynopsis> |
| 22 | <command>valgrind</command> |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame^] | 23 | <arg><replaceable>valgrind-options</replaceable></arg> |
| 24 | <arg><command>your-program</command></arg> |
| 25 | <arg><replaceable>your-program-options</replaceable></arg> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 26 | </cmdsynopsis> |
| 27 | </refsynopsisdiv> |
| 28 | |
| 29 | |
| 30 | <refsect1 id="description"> |
| 31 | <title>Description</title> |
| 32 | |
| 33 | <para><command>Valgrind</command> is a flexible program for debugging |
| 34 | and profiling Linux executables. It consists of a core, which provides |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame^] | 35 | a synthetic CPU in software, and a series of debugging and profiling tools. |
| 36 | The architecture is modular, so that new tools can be created easily and |
| 37 | without disturbing the existing structure.</para> |
| 38 | |
| 39 | <para>Some of the options described below work with all Valgrind tools, and |
| 40 | some only work with a few or one. The section MEMCHECK OPTIONS and those |
| 41 | below it describe tool-specific options.</para> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 42 | |
| 43 | <para>This manual page covers only basic usage and options. For more |
| 44 | comprehensive information, please see the HTML documentation on your |
| 45 | system: <filename>&vg-doc-path;</filename>, or online: |
| 46 | <filename>&vg-bookset;</filename>.</para> |
| 47 | |
| 48 | </refsect1> |
| 49 | |
| 50 | |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 51 | |
| 52 | <refsect1 id="basic-options"> |
| 53 | <title>Basic Options</title> |
| 54 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 55 | <xi:include href="manual-core.xml" xpointer="basic.opts.para" |
| 56 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 57 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 58 | <xi:include href="manual-core.xml" xpointer="basic.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 59 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 60 | |
| 61 | </refsect1> |
| 62 | |
| 63 | |
| 64 | |
| 65 | <refsect1 id="error-related-options"> |
| 66 | <title>Error-Related Options</title> |
| 67 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 68 | <xi:include href="manual-core.xml" xpointer="error-related.opts.para" |
| 69 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 70 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 71 | <xi:include href="manual-core.xml" xpointer="error-related.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 72 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 73 | |
| 74 | </refsect1> |
| 75 | |
| 76 | |
| 77 | |
| 78 | <refsect1 id="malloc-related-options"> |
| 79 | <title>malloc()-related Options</title> |
| 80 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 81 | <xi:include href="manual-core.xml" xpointer="malloc-related.opts.para" |
| 82 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 83 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 84 | <xi:include href="manual-core.xml" xpointer="malloc-related.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 85 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 86 | |
| 87 | </refsect1> |
| 88 | |
| 89 | |
| 90 | |
| 91 | <refsect1 id="uncommon-options"> |
| 92 | <title>Uncommon Options</title> |
| 93 | |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 94 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 95 | <xi:include href="manual-core.xml" xpointer="uncommon.opts.para" |
| 96 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 97 | |
| 98 | <xi:include href="manual-core.xml" xpointer="uncommon.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 99 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 100 | |
| 101 | </refsect1> |
| 102 | |
| 103 | |
| 104 | |
| 105 | <refsect1 id="debugging-valgrind-options"> |
| 106 | <title>Debugging Valgrind Options</title> |
| 107 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 108 | <xi:include href="manual-core.xml" xpointer="debug.opts.para" |
| 109 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 110 | |
| 111 | </refsect1> |
| 112 | |
| 113 | |
| 114 | |
| 115 | <refsect1 id="memcheck-options"> |
| 116 | <title>Memcheck Options</title> |
| 117 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 118 | <xi:include href="../../memcheck/docs/mc-manual.xml" |
| 119 | xpointer="mc.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 120 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 121 | |
| 122 | </refsect1> |
| 123 | |
| 124 | |
| 125 | |
| 126 | <refsect1 id="cachegrind-options"> |
| 127 | <title>Cachegrind Options</title> |
| 128 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 129 | <xi:include href="../../cachegrind/docs/cg-manual.xml" |
| 130 | xpointer="cg.opts.para" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 131 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 132 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 133 | <xi:include href="../../cachegrind/docs/cg-manual.xml" |
| 134 | xpointer="cg.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 135 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 136 | |
| 137 | </refsect1> |
| 138 | |
| 139 | |
| 140 | |
weidendo | af0e723 | 2006-03-20 10:29:30 +0000 | [diff] [blame] | 141 | <refsect1 id="callgrind-options"> |
| 142 | <title>Callgrind Options</title> |
| 143 | |
| 144 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
weidendo | cbf4e19 | 2007-11-27 01:27:12 +0000 | [diff] [blame] | 145 | xpointer="cl.opts.list.misc" |
weidendo | af0e723 | 2006-03-20 10:29:30 +0000 | [diff] [blame] | 146 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
weidendo | cbf4e19 | 2007-11-27 01:27:12 +0000 | [diff] [blame] | 147 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
| 148 | xpointer="cl.opts.list.creation" |
| 149 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 150 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
| 151 | xpointer="cl.opts.list.activity" |
| 152 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 153 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
| 154 | xpointer="cl.opts.list.collection" |
| 155 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 156 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
| 157 | xpointer="cl.opts.list.simulation" |
| 158 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
weidendo | af0e723 | 2006-03-20 10:29:30 +0000 | [diff] [blame] | 159 | </refsect1> |
| 160 | |
| 161 | |
| 162 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame^] | 163 | <refsect1 id="helgrind-options"> |
| 164 | <title>Helgrind Options</title> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 165 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame^] | 166 | <xi:include href="../../helgrind/docs/hg-manual.xml" |
| 167 | xpointer="hg.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 168 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 169 | |
| 170 | </refsect1> |
| 171 | |
| 172 | |
| 173 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame^] | 174 | <refsect1 id="drd-options"> |
| 175 | <title>DRD Options</title> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 176 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame^] | 177 | <xi:include href="../../drd/docs/drd-manual.xml" |
| 178 | xpointer="drd.opts.list" |
| 179 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 180 | |
| 181 | </refsect1> |
| 182 | |
| 183 | |
| 184 | |
| 185 | <refsect1 id="massif-options"> |
| 186 | <title>Massif Options</title> |
| 187 | |
| 188 | <xi:include href="../../massif/docs/ms-manual.xml" |
| 189 | xpointer="ms.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 190 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 191 | |
| 192 | </refsect1> |
| 193 | |
| 194 | |
| 195 | |
sewardj | 37a78a0 | 2008-10-23 13:15:23 +0000 | [diff] [blame] | 196 | <refsect1 id="ptrcheck-options"> |
| 197 | <title>Ptrcheck Options</title> |
| 198 | |
| 199 | <xi:include href="../../exp-ptrcheck/docs/pc-manual.xml" |
| 200 | xpointer="pc.opts.list" |
| 201 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 202 | |
| 203 | </refsect1> |
| 204 | |
njn | dbebecc | 2009-07-14 01:39:54 +0000 | [diff] [blame] | 205 | <refsect1 id="bbv-options"> |
| 206 | <title>BBV Options</title> |
| 207 | |
| 208 | <xi:include href="../../exp-bbv/docs/bbv-manual.xml" |
| 209 | xpointer="bbv.opts.list" |
| 210 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 211 | |
| 212 | </refsect1> |
sewardj | 37a78a0 | 2008-10-23 13:15:23 +0000 | [diff] [blame] | 213 | |
| 214 | |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 215 | <refsect1 id="lackey-options"> |
| 216 | <title>Lackey Options</title> |
| 217 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 218 | <xi:include href="../../lackey/docs/lk-manual.xml" |
| 219 | xpointer="lk.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 220 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 221 | |
| 222 | </refsect1> |
| 223 | |
| 224 | |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 225 | <refsect1 id="see_also"> |
| 226 | <title>See Also</title> |
| 227 | |
| 228 | <para> |
| 229 | <filename>&vg-doc-path;</filename>, |
| 230 | and/or |
| 231 | <filename>&vg-bookset;</filename>. |
| 232 | </para> |
| 233 | |
| 234 | </refsect1> |
| 235 | |
| 236 | |
| 237 | <refsect1 id="author"> |
| 238 | <title>Author</title> |
| 239 | |
| 240 | <para>This manpage has been written by Andres Roldan <aroldan@debian.org> |
| 241 | for the Debian Project, but can be used for any other distribution.</para> |
| 242 | |
| 243 | <para>Updated, rearranged and expanded by Robert Walsh |
| 244 | <rjwalsh@durables.org> for the 2.4.0 release, and by other |
| 245 | Valgrind developers subsequently.</para> |
| 246 | |
| 247 | </refsect1> |
| 248 | |
| 249 | |
| 250 | </refentry> |
| 251 | |