ddown
Moves down the call stack
Format
ddown [ num-levels ]
Arguments
num-levels
Number of levels to move down. The default is 1.
Description
The ddown command moves the selected stack frame down one or more levels and prints the new frame’s number and function name.
Call stack movements are all relative, so using the ddown command effectively moves down in the call stack. (If up is in the direction of the main() function, then down is back to where you were before you moved through stack frames.)
Frame 0 is the most recent—that is, the currently executing—frame in the call stack, frame 1 corresponds to the procedure that invoked the currently executing frame, and so on. The call stack’s depth is increased by one each time a procedure is entered, and decreased by one when it is exited.
The command affects each thread in the focus. That is, if the current width is process, the ddown command acts on each thread in the process. You can specify any collection of processes and threads as the target set.
In addition, the
ddown command modifies the current list location to be the current execution location for the new frame; this means that a
dlist command displays the code that surrounds this new location.
The context and scope changes made by this command remain in effect until the CLI executes a command that modifies the current execution location (for example, the
dstep command), or until you enter either a
dup or
ddown command.
If you tell the CLI to move down more levels than exist, the CLI simply moves down to the lowest level in the stack, which was the place where you began moving through the stack frames.
Command alias
Alias | Definition | Description |
---|
d | ddown | Moves down the call stack |
Examples
ddown
Moves down one level in the call stack. As a result, for example, dlist commands that follow refers to the procedure that invoked this one. The following example shows what prints after you enter this command:
0 check_fortran_arrays_ PC=0x10001254,
FP=0x7fff2ed0 [arrays.F#48]
d 5
Moves the current frame down five levels in the call stack.
Related Topics