mingw/info/gdb/Annotations-for-Running.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="Annotations%20for%20Running">Annotations for Running</a>,
  13 Next:<a rel="next" accesskey="n" href="Source-Annotations.html#Source%20Annotations">Source Annotations</a>,
  14 Previous:<a rel="previous" accesskey="p" href="Invalidation.html#Invalidation">Invalidation</a>,
  15 Up:<a rel="up" accesskey="u" href="Annotations.html#Annotations">Annotations</a>
  16 <hr><br>
  17 </div>
  18
  19 <h3 class="section">Running the Program</h3>
  20
  21    <p>When the program starts executing due to a GDB command such as
  22 <code>step</code> or <code>continue</code>,
  23
  24 <pre class="smallexample">     ^Z^Zstarting
  25      </pre>
  26
  27    <p>is output.  When the program stops,
  28
  29 <pre class="smallexample">     ^Z^Zstopped
  30      </pre>
  31
  32    <p>is output.  Before the <code>stopped</code> annotation, a variety of
  33 annotations describe how the program stopped.
  34
  35      <dl>
  36 <dt><code>^Z^Zexited </code><var>exit-status</var><code></code>
  37      <dd>The program exited, and <var>exit-status</var> is the exit status (zero for
  38 successful exit, otherwise nonzero).
  39
  40      <br><dt><code>^Z^Zsignalled</code>
  41      <dd>The program exited with a signal.  After the <code>^Z^Zsignalled</code>, the
  42 annotation continues:
  43
  44      <pre class="smallexample">          <var>intro-text</var>
  45           ^Z^Zsignal-name
  46           <var>name</var>
  47           ^Z^Zsignal-name-end
  48           <var>middle-text</var>
  49           ^Z^Zsignal-string
  50           <var>string</var>
  51           ^Z^Zsignal-string-end
  52           <var>end-text</var>
  53           </pre>
  54
  55      <p>where <var>name</var> is the name of the signal, such as <code>SIGILL</code> or
  56 <code>SIGSEGV</code>, and <var>string</var> is the explanation of the signal, such
  57 as <code>Illegal Instruction</code> or <code>Segmentation fault</code>.
  58 <var>intro-text</var>, <var>middle-text</var>, and <var>end-text</var> are for the
  59 user's benefit and have no particular format.
  60
  61      <br><dt><code>^Z^Zsignal</code>
  62      <dd>The syntax of this annotation is just like <code>signalled</code>, but GDB is
  63 just saying that the program received the signal, not that it was
  64 terminated with it.
  65
  66      <br><dt><code>^Z^Zbreakpoint </code><var>number</var><code></code>
  67      <dd>The program hit breakpoint number <var>number</var>.
  68
  69      <br><dt><code>^Z^Zwatchpoint </code><var>number</var><code></code>
  70      <dd>The program hit watchpoint number <var>number</var>.
  71 </dl>
  72
  73    </body></html>
  74