|
From: <sv...@va...> - 2005-08-03 23:20:18
|
Author: de Date: 2005-08-04 00:20:12 +0100 (Thu, 04 Aug 2005) New Revision: 166 Log: oops - slipped thru the net Added: trunk/docs/manual/manual.html Added: trunk/docs/manual/manual.html =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/docs/manual/manual.html 2005-08-03 23:17:28 UTC (rev 165) +++ trunk/docs/manual/manual.html 2005-08-03 23:20:12 UTC (rev 166) @@ -0,0 +1,136 @@ +<div class=3D"book" lang=3D"en"> +<div class=3D"titlepage"> +<div> +<div><h1 class=3D"title"> +<a name=3D"manual"></a>Valgrind User Manual</h1></div> +<div><p class=3D"releaseinfo">Release 3.0.0 August 3 2005</p></div> +<div><p class=3D"copyright">Copyright =A9 2000-2005=20 + <a href=3D"dist.authors.html" title=3D"2.=A0AUTHORS">AUTHORS</a> + </p></div> +</div> +<div></div> +<hr> +</div> +<div class=3D"toc"> +<p><b>Table of Contents</b></p> +<dl> +<dt><span class=3D"chapter"><a href=3D"manual-intro.html">1. Introductio= n</a></span></dt> +<dd><dl> +<dt><span class=3D"sect1"><a href=3D"manual-intro.html#manual-intro.over= view">1.1. An Overview of Valgrind</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-intro.html#manual-intro.navi= gation">1.2. How to navigate this manual</a></span></dt> +</dl></dd> +<dt><span class=3D"chapter"><a href=3D"manual-core.html">2. Using and un= derstanding the Valgrind core</a></span></dt> +<dd><dl> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.whatdo= es">2.1. What Valgrind does with your program</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.starte= d">2.2. Getting started</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.commen= t">2.3. The commentary</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.report= ">2.4. Reporting of errors</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.suppre= ss">2.5. Suppressing errors</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.flags"= >2.6. Command-line flags for the Valgrind core</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.toolop= ts">2.6.1. Tool-selection option</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.basico= pts">2.6.2. Basic Options</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.erropt= s">2.6.3. Error-related options</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.malloc= opts">2.6.4. malloc()-related Options</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.rareop= ts">2.6.5. Uncommon Options</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.debugo= pts">2.6.6. Debugging Valgrind Options</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.defopt= s">2.6.7. Setting default Options</a></span></dt> +</dl></dd> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.client= req">2.7. The Client Request mechanism</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.pthrea= ds">2.8. Support for Threads</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.signal= s">2.9. Handling of Signals</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.instal= l">2.10. Building and Installing</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.proble= ms">2.11. If You Have Problems</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.limits= ">2.12. Limitations</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.howwor= ks">2.13. How It Works -- A Rough Overview</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.startb= ">2.13.1. Getting started</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.engine= ">2.13.2. The translation/instrumentation engine</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.track"= >2.13.3. Tracking the Status of Memory</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.syscal= ls">2.13.4. System calls</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"manual-core.html#manual-core.syssig= nals">2.13.5. Signals</a></span></dt> +</dl></dd> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.exampl= e">2.14. An Example Run</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"manual-core.html#manual-core.warnin= gs">2.15. Warning Messages You Might See</a></span></dt> +</dl></dd> +<dt><span class=3D"chapter"><a href=3D"mc-manual.html">3. Memcheck: a he= avyweight memory checker</a></span></dt> +<dd><dl> +<dt><span class=3D"sect1"><a href=3D"mc-manual.html#mc-manual.bugs">3.1.= Kinds of bugs that Memcheck can find</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"mc-manual.html#mc-manual.flags">3.2= . Command-line flags specific to Memcheck</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"mc-manual.html#mc-manual.errormsgs"= >3.3. Explanation of error messages from Memcheck</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.badrw">3.3= .1. Illegal read / Illegal write errors</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.uninitvals= ">3.3.2. Use of uninitialised values</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.badfrees">= 3.3.3. Illegal frees</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.rudefn">3.= 3.4. When a block is freed with an inappropriate deallocation +function</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.badperm">3= .3.5. Passing system call parameters with inadequate read/write +permissions</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.overlap">3= .3.6. Overlapping source and destination blocks</a></span></dt> +</dl></dd> +<dt><span class=3D"sect1"><a href=3D"mc-manual.html#mc-manual.suppfiles"= >3.4. Writing suppressions files</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"mc-manual.html#mc-manual.machine">3= .5. Details of Memcheck's checking machinery</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.value">3.5= .1. Valid-value (V) bits</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.vaddress">= 3.5.2. Valid-address (A) bits</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"mc-manual.html#mc-manual.together">= 3.5.3. Putting it all together</a></span></dt> +</dl></dd> +<dt><span class=3D"sect1"><a href=3D"mc-manual.html#mc-manual.leaks">3.6= . Memory leak detection</a></span></dt> +<dt><span class=3D"sect1"><a href=3D"mc-manual.html#mc-manual.clientreqs= ">3.7. Client Requests</a></span></dt> +</dl></dd> +<dt><span class=3D"chapter"><a href=3D"ac-manual.html">4. Addrcheck: a l= ightweight memory checker</a></span></dt> +<dd><dl><dt><span class=3D"sect1"><a href=3D"ac-manual.html#id4815230">4= .1. Kinds of bugs that Addrcheck can find</a></span></dt></dl></dd> +<dt><span class=3D"chapter"><a href=3D"cg-manual.html">5. Cachegrind: a = cache profiler</a></span></dt> +<dd><dl> +<dt><span class=3D"sect1"><a href=3D"cg-manual.html#cg-manual.cache">5.1= . Cache profiling</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#cg-manual.overview">= 5.1.1. Overview</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#cache-sim">5.1.2. Ca= che simulation specifics</a></span></dt> +</dl></dd> +<dt><span class=3D"sect1"><a href=3D"cg-manual.html#cg-manual.profile">5= .2. Profiling programs</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#cg-manual.outputfile= ">5.2.1. Output file</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#cg-manual.cgopts">5.= 2.2. Cachegrind options</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#cg-manual.annotate">= 5.2.3. Annotating C/C++ programs</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#cg-manual.assembler"= >5.2.4. Annotating assembler programs</a></span></dt> +</dl></dd> +<dt><span class=3D"sect1"><a href=3D"cg-manual.html#cg-manual.annopts">5= .3. cg_annotate options</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#id4807200">5.3.1. Wa= rnings</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#id4832105">5.3.2. Th= ings to watch out for</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#id4821049">5.3.3. Ac= curacy</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"cg-manual.html#id4847414">5.3.4. To= do</a></span></dt> +</dl></dd> +</dl></dd> +<dt><span class=3D"chapter"><a href=3D"ms-manual.html">6. Massif: a heap= profiler</a></span></dt> +<dd><dl> +<dt><span class=3D"sect1"><a href=3D"ms-manual.html#ms-manual.spaceprof"= >6.1. Heap profiling</a></span></dt> +<dd><dl><dt><span class=3D"sect2"><a href=3D"ms-manual.html#ms-manual.he= approf">6.1.1. Why Use a Heap Profiler?</a></span></dt></dl></dd> +<dt><span class=3D"sect1"><a href=3D"ms-manual.html#ms-manual.using">6.2= . Using Massif</a></span></dt> +<dd><dl> +<dt><span class=3D"sect2"><a href=3D"ms-manual.html#ms-manual.overview">= 6.2.1. Overview</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"ms-manual.html#ms-manual.basicresul= ts">6.2.2. Basic Results of Profiling</a></span></dt> +<dt><span class=3D"sect2"><a href=3D"ms-manual.html#ms-manual.graphs">6.= 2.3. Spacetime Graphs</a></span></dt> +</dl></dd> +<dt><span class=3D"sect1"><a href=3D"ms-manual.html#ms-manual.heapdetail= s">6.3. Details of Heap Allocations</a></span></dt> +<dd><dl><dt><span class=3D"sect2"><a href=3D"ms-manual.html#ms-manual.ac= curacy">6.3.1. Accuracy</a></span></dt></dl></dd> +<dt><span class=3D"sect1"><a href=3D"ms-manual.html#ms-manual.options">6= .4. Massif options</a></span></dt> +</dl></dd> +<dt><span class=3D"chapter"><a href=3D"hg-manual.html">7. Helgrind: a da= ta-race detector</a></span></dt> +<dt><span class=3D"chapter"><a href=3D"nl-manual.html">8. Nulgrind: the = ``null'' tool</a></span></dt> +<dt><span class=3D"chapter"><a href=3D"lk-manual.html">9. Lackey: a very= simple profiler</a></span></dt> +</dl> +</div> +</div> +<div> +<br><table class=3D"nav" width=3D"100%" cellspacing=3D"3" cellpadding=3D= "2" border=3D"0" summary=3D"Navigation footer"> +<tr> +<td rowspan=3D"2" width=3D"40%" align=3D"left"> +<a accesskey=3D"p" href=3D"quick-start.html"><<=A0Valgrind Quick S= tart Guide</a>=A0</td> +<td width=3D"20%" align=3D"center"><a accesskey=3D"u" href=3D"index.html= ">Up</a></td> +<td rowspan=3D"2" width=3D"40%" align=3D"right">=A0<a accesskey=3D"n" hr= ef=3D"manual-intro.html">1.=A0Introduction=A0>></a> +</td> +</tr> +<tr><td width=3D"20%" align=3D"center"><a accesskey=3D"h" href=3D"index.= html">Home</a></td></tr> +</table> +</div> |