.TH stepthread 1P local "Silicon Graphics, Inc."
.SH NAME
stepthread \- single steps a target system thread
.SH SYNOPSIS
\f3stepthread\f1 thread
.SH DESCRIPTION
The 
.B stepthread
command sends a message requesting a single step of the specified
.B thread
running on the target system via
.I dbgif.
This command has no output. Single-step is defined as the execution of
one assembly language instruction, not one line of source code.
.PP
Before execution of this command, the
.I dbgif
program must be running and the
.I METHOD
environment variable must be set to indicate whether this is a request for the
R4300 CPU or the coprocessor. The value zero represents the CPU and the number
one represents the RCP. In
.I csh,
this is accomplished by specifying
.IP
setenv METHOD 0
.PP
Note that single-stepping the coprocessor actually executes two instructions
if the first instruction is a branch.
.SH SEE ALSO
dbgif(1P), listthreads(1P)
.SH BUGS
In the event of a communications failure, the program will dump core. It
would be nice if it cleaned up after itself, but at present the core file
must be removed manually.