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 |
njn | 25ac384 | 2009-08-07 02:58:11 +0000 | [diff] [blame] | 45 | system: <filename>&vg-docs-path;</filename>, or online: |
| 46 | <filename>&vg-docs-url;</filename>.</para> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 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" |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 130 | xpointer="cg.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 131 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 132 | |
| 133 | </refsect1> |
| 134 | |
| 135 | |
| 136 | |
weidendo | af0e723 | 2006-03-20 10:29:30 +0000 | [diff] [blame] | 137 | <refsect1 id="callgrind-options"> |
| 138 | <title>Callgrind Options</title> |
| 139 | |
| 140 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
weidendo | cbf4e19 | 2007-11-27 01:27:12 +0000 | [diff] [blame] | 141 | xpointer="cl.opts.list.creation" |
| 142 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 143 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
| 144 | xpointer="cl.opts.list.activity" |
| 145 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 146 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
| 147 | xpointer="cl.opts.list.collection" |
| 148 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 149 | <xi:include href="../../callgrind/docs/cl-manual.xml" |
| 150 | xpointer="cl.opts.list.simulation" |
| 151 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
weidendo | af0e723 | 2006-03-20 10:29:30 +0000 | [diff] [blame] | 152 | </refsect1> |
| 153 | |
| 154 | |
| 155 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame] | 156 | <refsect1 id="helgrind-options"> |
| 157 | <title>Helgrind Options</title> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 158 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame] | 159 | <xi:include href="../../helgrind/docs/hg-manual.xml" |
| 160 | xpointer="hg.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 161 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 162 | |
| 163 | </refsect1> |
| 164 | |
| 165 | |
| 166 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame] | 167 | <refsect1 id="drd-options"> |
| 168 | <title>DRD Options</title> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 169 | |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame] | 170 | <xi:include href="../../drd/docs/drd-manual.xml" |
| 171 | xpointer="drd.opts.list" |
| 172 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
njn | 9cfec67 | 2009-08-07 06:08:51 +0000 | [diff] [blame] | 173 | <xi:include href="../../drd/docs/drd-manual.xml" |
| 174 | xpointer="drd.debugopts.list" |
| 175 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
njn | 3a5786e | 2009-07-30 04:22:09 +0000 | [diff] [blame] | 176 | |
| 177 | </refsect1> |
| 178 | |
| 179 | |
| 180 | |
| 181 | <refsect1 id="massif-options"> |
| 182 | <title>Massif Options</title> |
| 183 | |
| 184 | <xi:include href="../../massif/docs/ms-manual.xml" |
| 185 | xpointer="ms.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 186 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 187 | |
| 188 | </refsect1> |
| 189 | |
| 190 | |
| 191 | |
sewardj | 37a78a0 | 2008-10-23 13:15:23 +0000 | [diff] [blame] | 192 | <refsect1 id="ptrcheck-options"> |
| 193 | <title>Ptrcheck Options</title> |
| 194 | |
| 195 | <xi:include href="../../exp-ptrcheck/docs/pc-manual.xml" |
| 196 | xpointer="pc.opts.list" |
| 197 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 198 | |
| 199 | </refsect1> |
| 200 | |
njn | dbebecc | 2009-07-14 01:39:54 +0000 | [diff] [blame] | 201 | <refsect1 id="bbv-options"> |
| 202 | <title>BBV Options</title> |
| 203 | |
| 204 | <xi:include href="../../exp-bbv/docs/bbv-manual.xml" |
| 205 | xpointer="bbv.opts.list" |
| 206 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 207 | |
| 208 | </refsect1> |
sewardj | 37a78a0 | 2008-10-23 13:15:23 +0000 | [diff] [blame] | 209 | |
| 210 | |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 211 | <refsect1 id="lackey-options"> |
| 212 | <title>Lackey Options</title> |
| 213 | |
de | 03e0e7c | 2005-12-03 23:02:33 +0000 | [diff] [blame] | 214 | <xi:include href="../../lackey/docs/lk-manual.xml" |
| 215 | xpointer="lk.opts.list" |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 216 | xmlns:xi="http://www.w3.org/2001/XInclude" /> |
| 217 | |
| 218 | </refsect1> |
| 219 | |
| 220 | |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 221 | <refsect1 id="see_also"> |
| 222 | <title>See Also</title> |
| 223 | |
| 224 | <para> |
njn | c206a81 | 2009-08-07 07:56:20 +0000 | [diff] [blame] | 225 | cg_annotate(1), |
njn | efd7ef7 | 2009-08-07 07:44:31 +0000 | [diff] [blame] | 226 | callgrind_annotate(1), |
| 227 | callgrind_control(1), |
njn | abe8b8c | 2009-08-07 06:54:44 +0000 | [diff] [blame] | 228 | ms_print(1), |
| 229 | <filename>&vg-docs-path;</filename> or |
njn | 25ac384 | 2009-08-07 02:58:11 +0000 | [diff] [blame] | 230 | <filename>&vg-docs-url;</filename>. |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 231 | </para> |
| 232 | |
| 233 | </refsect1> |
| 234 | |
| 235 | |
| 236 | <refsect1 id="author"> |
| 237 | <title>Author</title> |
| 238 | |
njn | efd7ef7 | 2009-08-07 07:44:31 +0000 | [diff] [blame] | 239 | <para>The Valgrind developers.</para> |
| 240 | |
| 241 | <para>This manpage was written by Andres Roldan <aroldan@debian.org> |
| 242 | and the Valgrind developers.</para> |
de | bad57fc | 2005-12-03 22:33:29 +0000 | [diff] [blame] | 243 | |
| 244 | </refsect1> |
| 245 | |
| 246 | |
| 247 | </refentry> |
| 248 | |