dnexti

TotalView : TotalView Reference Guide : PART I Using the CLI : CLI Commands : All Commands : dnexti

dnexti

Steps machine instructions, stepping over subroutines

Format

dnexti [-back ][ num-steps ]

Arguments

-back

(ReplayEngine only) Steps a machine instruction back to the previous instruction, stepping over subroutines. This option can be abbreviated to -b.

num-steps

An integer greater than 0, indicating the number of instructions to be executed.

Description

The dnexti command executes machine-level instructions; that is, it advances the program by a single instruction. However, if the instruction invokes a subfunction, the dnexticommand executes the subfunction as if it were one instruction; that is, it steps over the call. This command steps the thread of interest (TOI) while allowing other threads in the process to run.

The optional num-steps argument defines how many dnexti operations to perform. If you do not specify num-steps, the default is 1.

The dnexti command iterates over the arenas in the 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
ni	dnexti	Runs the TOI one instruction while allowing other threads in the process to run.
NI	{dfocus g dnexti}	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 instruction. The rest of the control group runs freely.
nil	{dfocus L dnexti}	Steps the process threads in lockstep. This steps the TOI one instruction, 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.
NIL	{dfocus gL dnexti}	Steps lockstep threads in the group. This steps all threads in the share group that are at the same PC as the TOI one instruction. Other threads in the control group run freely.
niw	{dfocus W dnexti}	Steps worker threads in the process. This steps the TOI one instruction, 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.
NIW	{dfocus gW dnexti}	Steps worker threads in the group. This steps the TOI one instruction, and runs all worker threads in the same share group to the same statement. All other threads in the control group run freely.

Examples

dnexti

Steps one machine-level instruction.

ni 10

Steps ten machine-level instructions.

Steps one instruction and runs all other processes in the group that were executing at that instruction to the next instruction.

f t n

Steps the thread one machine-level instruction.

dfocus 3. dnexti

Steps process 3 one machine-level instruction.