mingw/info/gdb/Frame-Info.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="Frame%20Info">Frame Info</a>,
  13 Previous:<a rel="previous" accesskey="p" href="Selection.html#Selection">Selection</a>,
  14 Up:<a rel="up" accesskey="u" href="Stack.html#Stack">Stack</a>
  15 <hr><br>
  16 </div>
  17
  18 <h3 class="section">Information about a frame</h3>
  19
  20    <p>There are several other commands to print information about the selected
  21 stack frame.
  22
  23      <dl>
  24 <dt><code>frame</code>
  25      <dd><dt><code>f</code>
  26      <dd>When used without any argument, this command does not change which
  27 frame is selected, but prints a brief description of the currently
  28 selected stack frame.  It can be abbreviated <code>f</code>.  With an
  29 argument, this command is used to select a stack frame.
  30 See <a href="Selection.html#Selection">Selecting a frame</a>.
  31
  32      <br><dt><code>info frame</code>
  33      <dd><dt><code>info f</code>
  34      <dd>This command prints a verbose description of the selected stack frame,
  35 including:
  36
  37           <ul>
  38 <li>the address of the frame
  39 <li>the address of the next frame down (called by this frame)
  40 <li>the address of the next frame up (caller of this frame)
  41 <li>the language in which the source code corresponding to this frame is written
  42 <li>the address of the frame's arguments
  43 <li>the address of the frame's local variables
  44 <li>the program counter saved in it (the address of execution in the caller frame)
  45 <li>which registers were saved in the frame
  46 </ul>
  47
  48      <p>The verbose description is useful when
  49 something has gone wrong that has made the stack format fail to fit
  50 the usual conventions.
  51
  52      <br><dt><code>info frame </code><var>addr</var><code></code>
  53      <dd><dt><code>info f </code><var>addr</var><code></code>
  54      <dd>Print a verbose description of the frame at address <var>addr</var>, without
  55 selecting that frame.  The selected frame remains unchanged by this
  56 command.  This requires the same kind of address (more than one for some
  57 architectures) that you specify in the <code>frame</code> command.
  58 See <a href="Selection.html#Selection">Selecting a frame</a>.
  59
  60      <br><dt><code>info args</code>
  61      <dd>Print the arguments of the selected frame, each on a separate line.
  62
  63      <br><dt><code>info locals</code>
  64      <dd>Print the local variables of the selected frame, each on a separate
  65 line.  These are all variables (declared either static or automatic)
  66 accessible at the point of execution of the selected frame.
  67
  68      <br><dt><code>info catch</code>
  69      <dd>Print a list of all the exception handlers that are active in the
  70 current stack frame at the current point of execution.  To see other
  71 exception handlers, visit the associated frame (using the <code>up</code>,
  72 <code>down</code>, or <code>frame</code> commands); then type <code>info catch</code>.
  73 See <a href="Set-Catchpoints.html#Set%20Catchpoints">Setting catchpoints</a>.
  74
  75    </dl>
  76
  77    </body></html>
  78