dout

Runs out from the current subroutine

Format:

dout [ frame-count ]

Arguments:

frame-count

Specifies that the thread returns out of this many levels of subroutine calls. If this number is omitted, the thread returns from the current level.

Description:

The dout command runs a thread until it returns:

• From the current subroutine.
• From one or more nested subroutines.

When process width is specified, TotalView allows all threads in the process that are not running to this goal to run free. Note that specifying process width is the default.

Command alias:

You may find the following aliases useful:

Alias	Definition	Meaning
ou	{dout}	Runs the thread of interest out of the current function while allowing other threads in the process to run.
OU	{dfocus g dout}	A group stepping command. This searches for threads in the share group that are at the same PC as the thread of interest, and runs one such "aligned" thread in each member out of the current function. The rest of the control group runs freely.
oul	{dfocus L dout}	Runs the process threads in "lockstep". This runs the thread of interest out of the current function, and also runs all threads in the process that are at the same PC as the thread of interest out of the current function. Other threads in the process run freely. The group of threads that are at the same PC is called the lockstep group. This alias does not force process width. If the default focus is set to group, this steps the group.
OUL	{dfocus gL dout}	Runs "lockstep" threads in the group. This runs all threads in the share group that are at the same PC as the thread of interest out of the current function. Other threads in the control group run freely.
ouw	{dfocus W dout}	Runs worker threads in the process. This runs the thread of interest out of the current function and runs all worker threads in the process to the same (goal) statement. The nonworker threads in the process run freely. This alias does not force process width. If the default focus is set to group, this steps the group.
OUW	{dfocus gW dout}	Runs worker threads in the group. This runs the thread of interest out of the current function and also runs all worker threads in the same share group out of the current function. All other threads in the control group run freely.

For additional information on the different kinds of stepping, see the dstep command information.

Examples:

f t ou

Runs the current thread of interest out of the current subroutine.

f p dout 3

Unwinds the process in the current focus out of the current subroutine to the routine three levels above it in the call stack.