Totalview® for HPC Reference Guide : PART I CLI Commands : Chapter 2 CLI Commands : dstepi
dstepi
Steps machine instructions, stepping into subfunctions
Format 
dstepi [-back] [ num-steps ]
Arguments 
-back
(ReplayEngine only) Steps to the previous instruction, moving into subroutines that called the current function. This option can be abbreviated to -b.
num-steps
An integer greater than 0, indicating the number of instructions to execute.
Description 
The dstepi command executes assembler instruction lines; that is, it advances the program by single instructions.
The optional num-steps argument defines the number of dstepi operations to perform. If you do not specify num-steps, the default is 1.
For more information, see dstep.
Command alias 
Alias
Definition
Description
si
dstepi
Runs the thread of interest (TOI) one instruction while allowing other threads in the process to run.
SI
{dfocus g dstepi}
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. This is a group stepping command.
sil
{dfocus L dstepi}
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 instruction. 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.
SIL
{dfocus gL dstepi}
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.
siw
{dfocus W dstepi}
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.
SIW
{dfocus gW dstepi}
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 
dstepi
Executes the next machine instruction, stepping into any procedure call it encounters. Although the CLI only steps the current thread, other threads in the process run.
si 15
Executes the next 15 instructions.
f p1.2 dstepi
Steps thread 2 in process 1 by one instruction, and resumes execution of all other threads in process 1; they halt as soon as thread 2 in process 1 executes its instruction.
f t1.2 si
Steps thread 2 in process 1 by one instruction. No other threads in process 1 execute.
Related Topics
Group > Step Instruction Command in the in-product help
Process > Step Instruction Command in the in-product help
Thread > Step Instruction Command in the in-product help
dstep Command
dnext Command
dfocus Command