dstepi
Steps machine instructions, stepping into subfunctions
Format:
dstepi [ num-steps ]
Arguments:
num-steps
An integer number greater than 0, indicating the number of instructions to be executed.
Description:
The dstepi command executes assembler instruction lines; that is, it advances the program by single instructions.
The optional num-steps argument tells the CLI how many dstepi operations it should perform. If you do not specify num-steps, the default is 1.
For more information, see dstep.
Command alias:
You may find the following aliases useful:
| Alias |
Definition |
Meaning |
| si |
{dstepi} |
Runs the thread of interest one instruction while allowing other threads in the process to run. |
| SI |
{dfocus g dstepi} |
A group stepping command. This searches for threads in the share group that are at the same PC as the thread of interest, and steps one such "aligned" thread in each member one instruction. The rest of the control group runs freely. |
| sil |
{dfocus L dstepi} |
Steps the process threads in "lockstep". This steps the thread of interest one instruction, and runs all threads in the process that are at the same PC as the thread of interest to the same instruction. 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. |
| 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 thread of interest one instruction. Other threads in the control group run freely. |
| siw |
{dfocus W dstepi} |
Steps worker threads in the process. This steps the thread of interest 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 thread of interest 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 that is encountered. While only the current thread is stepped, other threads in the process are allowed to run.
si 15
Executes the next 15 instructions.
f p1.2 dstepi
Steps thread 2 in process 1 by one instruction. This also resumes execution of all other threads in process 1; they are halted 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.
