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. It also prints the new frame's number and function name.

Call stack movements are all relative, so ddown effectively "moves down" in the call stack. (If "up" is in the direction of main(), then "down" is back from where you started moving 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 one, 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. 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 surrounding 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, dstep), or until you enter 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:

You may find the following alias useful:

Alias	Definition	Meaning
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 will refer to the procedure that invoked this one. Here is an example of what is printed 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.