sewardj | a9a2dcf | 2002-11-11 00:20:07 +0000 | [diff] [blame^] | 1 | <html> |
| 2 | <head> |
| 3 | <style type="text/css"> |
| 4 | body { background-color: #ffffff; |
| 5 | color: #000000; |
| 6 | font-family: Times, Helvetica, Arial; |
| 7 | font-size: 14pt} |
| 8 | h4 { margin-bottom: 0.3em} |
| 9 | code { color: #000000; |
| 10 | font-family: Courier; |
| 11 | font-size: 13pt } |
| 12 | pre { color: #000000; |
| 13 | font-family: Courier; |
| 14 | font-size: 13pt } |
| 15 | a:link { color: #0000C0; |
| 16 | text-decoration: none; } |
| 17 | a:visited { color: #0000C0; |
| 18 | text-decoration: none; } |
| 19 | a:active { color: #0000C0; |
| 20 | text-decoration: none; } |
| 21 | </style> |
| 22 | <title>Valgrind</title> |
| 23 | </head> |
| 24 | |
| 25 | <body bgcolor="#ffffff"> |
| 26 | |
| 27 | <a name="title"> </a> |
| 28 | <h1 align=center>Valgrind, version 2.0.0</h1> |
| 29 | <center>This manual was last updated on 10 November 2002</center> |
| 30 | <p> |
| 31 | |
| 32 | <center> |
| 33 | <a href="mailto:jseward@acm.org">jseward@acm.org</a>, |
| 34 | <a href="mailto:njn25@cam.ac.uk">njn25@cam.ac.uk</a><br> |
| 35 | Copyright © 2000-2002 Julian Seward, Nick Nethercote |
| 36 | <p> |
| 37 | |
| 38 | Valgrind is licensed under the GNU General Public License, version |
| 39 | 2<br> |
| 40 | |
| 41 | An open-source tool for debugging and profiling Linux-x86 executables. |
| 42 | </center> |
| 43 | |
| 44 | <p> |
| 45 | |
| 46 | <hr width="100%"> |
| 47 | <a name="contents"></a> |
| 48 | <h2>Contents of this manual</h2> |
| 49 | |
| 50 | <h4>1 <a href="#intro">Introduction</a></h4> |
| 51 | 1.1 <a href="#whatfor">What Valgrind is for</a><br> |
| 52 | 1.2 <a href="#whatdoes">What it does with your program</a> |
| 53 | |
| 54 | <h4>2 <a href="#howtouse">How to use it, and how to make sense |
| 55 | of the results</a></h4> |
| 56 | 2.1 <a href="#starta">Getting started</a><br> |
| 57 | 2.2 <a href="#comment">The commentary</a><br> |
| 58 | 2.3 <a href="#report">Reporting of errors</a><br> |
| 59 | 2.4 <a href="#suppress">Suppressing errors</a><br> |
| 60 | 2.5 <a href="#flags">Command-line flags</a><br> |
| 61 | 2.6 <a href="#errormsgs">Explaination of error messages</a><br> |
| 62 | 2.7 <a href="#suppfiles">Writing suppressions files</a><br> |
| 63 | 2.8 <a href="#clientreq">The Client Request mechanism</a><br> |
| 64 | 2.9 <a href="#pthreads">Support for POSIX pthreads</a><br> |
| 65 | 2.10 <a href="#install">Building and installing</a><br> |
| 66 | 2.11 <a href="#problems">If you have problems</a><br> |
| 67 | |
| 68 | <h4>3 <a href="#machine">Details of the checking machinery</a></h4> |
| 69 | 3.1 <a href="#vvalue">Valid-value (V) bits</a><br> |
| 70 | 3.2 <a href="#vaddress">Valid-address (A) bits</a><br> |
| 71 | 3.3 <a href="#together">Putting it all together</a><br> |
| 72 | 3.4 <a href="#signals">Signals</a><br> |
| 73 | 3.5 <a href="#leaks">Memory leak detection</a><br> |
| 74 | |
| 75 | <h4>4 <a href="#limits">Limitations</a></h4> |
| 76 | |
| 77 | <h4>5 <a href="#howitworks">How it works -- a rough overview</a></h4> |
| 78 | 5.1 <a href="#startb">Getting started</a><br> |
| 79 | 5.2 <a href="#engine">The translation/instrumentation engine</a><br> |
| 80 | 5.3 <a href="#track">Tracking the status of memory</a><br> |
| 81 | 5.4 <a href="#sys_calls">System calls</a><br> |
| 82 | 5.5 <a href="#sys_signals">Signals</a><br> |
| 83 | |
| 84 | <h4>6 <a href="#example">An example</a></h4> |
| 85 | |
| 86 | <h4>7 <a href="#cache">Cache profiling</a></h4> |
| 87 | |
| 88 | <h4>8 <a href="techdocs.html">The design and implementation of Valgrind</a></h4> |
| 89 | |
| 90 | <hr width="100%"> |
| 91 | |
| 92 | |