manpagez: man pages & more
info gawk
Home | html | info | man

gawk: Execution Stack

 14.3.4 Working with the Stack
 Whenever you run a program that contains any function calls, 'gawk'
 maintains a stack of all of the function calls leading up to where the
 program is right now.  You can see how you got to where you are, and
 also move around in the stack to see what the state of things was in the
 functions that called the one you are in.  The commands for doing this
 'backtrace' [COUNT]
 'bt' [COUNT]
 'where' [COUNT]
      Print a backtrace of all function calls (stack frames), or
      innermost COUNT frames if COUNT > 0.  Print the outermost COUNT
      frames if COUNT < 0.  The backtrace displays the name and arguments
      to each function, the source file name, and the line number.  The
      alias 'where' for 'backtrace' is provided for longtime GDB users
      who may be used to that command.
 'down' [COUNT]
      Move COUNT (default 1) frames down the stack toward the innermost
      frame.  Then select and print the frame.
 'frame' [N]
 'f' [N]
      Select and print stack frame N.  Frame 0 is the currently
      executing, or "innermost", frame (function call); frame 1 is the
      frame that called the innermost one.  The highest-numbered frame is
      the one for the main program.  The printed information consists of
      the frame number, function and argument names, source file, and the
      source line.
 'up' [COUNT]
      Move COUNT (default 1) frames up the stack toward the outermost
      frame.  Then select and print the frame.
© 2000-2018
Individual documents may contain additional copyright information.