mingw/info/gdb/Starting-and-Stopping-Trace-Experiment.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="Starting%20and%20Stopping%20Trace%20Experiment">Starting and Stopping Trace Experiment</a>,
  13 Previous:<a rel="previous" accesskey="p" href="Listing-Tracepoints.html#Listing%20Tracepoints">Listing Tracepoints</a>,
  14 Up:<a rel="up" accesskey="u" href="Set-Tracepoints.html#Set%20Tracepoints">Set Tracepoints</a>
  15 <hr><br>
  16 </div>
  17
  18 <h4 class="subsection">Starting and Stopping Trace Experiment</h4>
  19
  20      <dl>
  21 <dt><code>tstart</code>
  22      <dd>This command takes no arguments.  It starts the trace experiment, and
  23 begins collecting data.  This has the side effect of discarding all
  24 the data collected in the trace buffer during the previous trace
  25 experiment.
  26
  27      <br><dt><code>tstop</code>
  28      <dd>This command takes no arguments.  It ends the trace experiment, and
  29 stops collecting data.
  30
  31      <p><strong>Note:</strong> a trace experiment and data collection may stop
  32 automatically if any tracepoint's passcount is reached
  33 (see <a href="Tracepoint-Passcounts.html#Tracepoint%20Passcounts">Tracepoint Passcounts</a>), or if the trace buffer becomes full.
  34
  35      <br><dt><code>tstatus</code>
  36      <dd>This command displays the status of the current trace data
  37 collection.
  38 </dl>
  39
  40    <p>Here is an example of the commands we described so far:
  41
  42 <pre class="smallexample">     (gdb) <b>trace gdb_c_test</b>
  43      (gdb) <b>actions</b>
  44      Enter actions for tracepoint #1, one per line.
  45      &gt; collect $regs,$locals,$args
  46      &gt; while-stepping 11
  47        &gt; collect $regs
  48        &gt; end
  49      &gt; end
  50      (gdb) <b>tstart</b>
  51         [time passes ...]
  52      (gdb) <b>tstop</b>
  53      </pre>
  54
  55    </body></html>
  56