.TH stopthread 1P local "Silicon Graphics, Inc."
.SH NAME
stopthread \- halt a target system thread
.SH SYNOPSIS
\f3stopthread\f1 thread
.SH DESCRIPTION
The 
.B stopthread
command sends a message requesting a halt of the specified
.B thread
running on the target system via
.I dbgif
and displays the thread status on stdout.
.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
.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.
.PP
If
.I gvd
is running, it will be surprised by the unexpected stop of the thread and
will probably try to restart it.