mingw/info/gdb/Tracepoint-Passcounts.html

   1 <html lang="en">
   2 <head>
   3 <title>Debugging with GDB</title>
   4 <meta http-equiv="Content-Type" content="text/html">
   5 <meta name="description" content="Debugging with GDB">
   6 <meta name="generator" content="makeinfo 4.3">
   7 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home">
   8 </head>
   9 <body>
  10 <div class="node">
  11 <p>
  12 Node:<a name="Tracepoint%20Passcounts">Tracepoint Passcounts</a>,
  13 Next:<a rel="next" accesskey="n" href="Tracepoint-Actions.html#Tracepoint%20Actions">Tracepoint Actions</a>,
  14 Previous:<a rel="previous" accesskey="p" href="Enable-and-Disable-Tracepoints.html#Enable%20and%20Disable%20Tracepoints">Enable and Disable Tracepoints</a>,
  15 Up:<a rel="up" accesskey="u" href="Set-Tracepoints.html#Set%20Tracepoints">Set Tracepoints</a>
  16 <hr><br>
  17 </div>
  18
  19 <h4 class="subsection">Tracepoint Passcounts</h4>
  20
  21      <dl>
  22 <dt><code>passcount </code>[<code></code><var>n</var><code> </code>[<code></code><var>num</var><code></code>]]<code></code>
  23      <dd>Set the <dfn>passcount</dfn> of a tracepoint.  The passcount is a way to
  24 automatically stop a trace experiment.  If a tracepoint's passcount is
  25 <var>n</var>, then the trace experiment will be automatically stopped on
  26 the <var>n</var>'th time that tracepoint is hit.  If the tracepoint number
  27 <var>num</var> is not specified, the <code>passcount</code> command sets the
  28 passcount of the most recently defined tracepoint.  If no passcount is
  29 given, the trace experiment will run until stopped explicitly by the
  30 user.
  31
  32      <p>Examples:
  33
  34      <pre class="smallexample">          (gdb) <b>passcount 5 2</b> // Stop on the 5th execution of
  35      <br>                                   <code>// tracepoint 2</code><br>
  36
  37           (gdb) <b>passcount 12</b>  // Stop on the 12th execution of the
  38      <br>                                   <code>// most recently defined tracepoint.</code><br>
  39           (gdb) <b>trace foo</b>
  40           (gdb) <b>pass 3</b>
  41           (gdb) <b>trace bar</b>
  42           (gdb) <b>pass 2</b>
  43           (gdb) <b>trace baz</b>
  44           (gdb) <b>pass 1</b>        // Stop tracing when foo has been
  45      <br>                                    <code>// executed 3 times OR when bar has</code><br>
  46      <br>                                    <code>// been executed 2 times</code><br>
  47      <br>                                    <code>// OR when baz has been executed 1 time.</code><br>
  48           </pre>
  49      </dl>
  50
  51    </body></html>
  52