Totalview® for HPC Reference Guide : PART I CLI Commands : Chapter 2 CLI Commands : dout
dout
Executes until just after the place that called the current routine
Format 
dout [-back] [frame-count ]
Arguments 
-back
(ReplayEngine only) Returns to the function call that placed the PC into the current routine. This option can be abbreviated to -b.
frame-count
An integer that specifies that the thread returns out of this many levels of subroutine calls. Without this number, the thread returns from the current level.
Description 
The dout command runs a thread until it returns from either of the following:
• The current subroutine
• One or more nested subroutines
When you specify process width, TotalView allows all threads in the process that are not running to this goal to run free. (Specifying process width is the default.)
Command alias 
Alias
Definition
Description
ou
dout
Runs the thread of interest (TOI) out of the current function, while allowing other threads in the process to run.
OU
{dfocus g dout}
Searches for threads in the share group that are at the same PC as the TOI, and runs one such aligned thread in each member out of the current function. The rest of the control group runs freely. This is a group stepping command.
oul
{dfocus L dout}
Runs the process threads in lockstep. This runs the TOI out of the current function, and also runs all threads in the process that are at the same PC as the TOI out of the current function. Other threads in the process run freely. The group of threads that is 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 TOI 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 TOI 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 TOI 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 TOI 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.
Related Topics
Group > Out Command in the in-product help
Process > Out Command in the in-product help
Thread > Out Command in the in-product help