gdb/gdbtk/library/help/trace/stack.html

   1 <HTML>
   2 <HEAD>
   3 <TITLE>Stack Window Help</TITLE>
   4 </HEAD>
   5 <BODY>
   6 <H1>The Stack Window</H1>
   7 <H3>Overview</H3>
   8 <P>The Stack Window allows users to view the call stack and jump between
   9 levels of the stack. To use the Stack Window in tracepoint mode, the
  10 stack pointer must be collected. See
  11 <A HREF="tracedlg.html#t_actions_add">Adding an Action</A> in the Tracepoint
  12 Dialog for more information on collecting registers.</P>
  13
  14 <P>Stack Window topics:
  15 <UL>
  16     <LI><UL><A HREF="#display">Stack Display</A>
  17             <LI><A HREF="#display_nav">Navigating the Stack Window</A>
  18             <LI><A HREF="#display_lvl">Changing the Stack Level</A>
  19         </UL>
  20 </UL></P>
  21
  22 <H3><A NAME="display">Stack Display</A></H3>
  23 The Stack Display consists of a listbox which displays levels of the call stack
  24 one per line. Each line contains the level number (useful when using the <A
  25 HREF="console.html">Console Window</A>) and a description of the function executing
  26 in that level. Typically, the function name and either the address of the function
  27 or the file and line number where the function is defined are displayed. The
  28 Stack Window may also be used to jump between levels of the stack.
  29 <BR>
  30
  31 <H4><A NAME="display_nav">Navigating the Stack Window</A></H4>
  32 Navigation of the Stack Window is accomplished by clicking on the desired level
  33 with the left mouse button. The <A HREF="source.html#display">Source Window
  34 Display</A> updates to show the selected frame. All other secondary windows,
  35 <A HREF="register.html">Registers</A>, <A HREF="watch.html">Watch</A>, and
  36 <A HREF="locals.html">Locals</A> update their displays for the selected frame.
  37 <BR>
  38
  39 <H4><A NAME="display_lvl">Changing Stack Levels</A></H4>
  40 To switch frames, simply click the left mouse button on the desired frame and the
  41 debugger will switch contexts, updating all windows. The selected frame is highlighted
  42 (in gold, by default).
  43
  44 <P>As an alternative, changing stack levels may be accomplished via the
  45 <A HREF="source.html#toolbar_frame">Frame Control Buttons</A> on the Source Window's
  46 Toolbar. These buttons may be used to change frames one level at a time (either
  47 immediately up or immediately down) or to jump to the bottom-most stack frame.
  48 See <A HREF="source.html#toolbar_frame">Source Frame Control Buttons</A> for more
  49 information.</P>
  50 </BODY>
  51 </HTML>