Totalview® for HPC Reference Guide : PART I CLI Commands : Chapter 2 CLI Commands : dnext
dnext
Steps source lines, stepping over subroutines
Format 
dnext [ -back ] [ num-steps ]
Arguments 
-back
(ReplayEngine only) Steps to the previous source line, stepping over subroutines. This option can be abbreviated to -b.
num-steps
An integer greater than 0, indicating the number of source lines to be executed.
Description 
The dnext command executes source lines; that is, it advances the program by steps (source line statements). However, if a statement in a source line invokes a routine, the dnext command executes the routine as if it were one statement; that is, it steps over the call.
The optional num-steps argument defines how many dnext operations to perform. If you do not specify num-steps, the default is 1.
The dnext command iterates over the arenas in its focus set, performing a thread-level, process-level, or group-level step in each arena, depending on the width of the arena. The default width is process (p).
For more information on stepping in processes and threads, see dstep.
Command alias 
Alias
Definition
Description
n
dnext
Runs the thread of interest (TOI) one statement, while allowing other threads in the process to run.
N
{dfocus g dnext}
A group stepping command. This searches for threads in the share group that are at the same PC as the TOI, and steps one such aligned thread in each member one statement. The rest of the control group runs freely.
nl
{dfocus L dnext}
Steps the process threads in lockstep. This steps the TOI one statement and runs all threads in the process that are at the same PC as the TOI to the same statement. 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.
NL
{dfocus gL dnext}
Steps lockstep threads in the group. This steps all threads in the share group that are at the same PC as the TOI one statement. Other threads in the control group run freely.
nw
{dfocus W dnext}
Steps worker threads in the process. This steps the TOI one statement, 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.
NW
{dfocus gW dnext}
Steps worker threads in the group. This steps the TOI one statement, and runs all worker threads in the same share group to the same statement. All other threads in the control group run freely.
Examples 
dnext
Steps one source line.
n 10
Steps ten source lines.
N
Steps one source line. It also runs all other processes in the group that are in the same lockstep group to the same line.
f t n
Steps the thread one statement.
dfocus 3. dnext
Steps process 3 one step.
Related Topics
Creating a Process by Single Stepping in the TotalView for HPC User Guide
Stepping and Setting Breakpoints in the TotalView for HPC User Guide
Using Stepping Commands in the TotalView for HPC User Guide
Group > Next Command in the in-product help
Process > Next Command in the in-product help
Thread > Next Command in the in-product help
dnexti Command
dstep Command
dfocus Command