.TH getgregs 1P local "Silicon Graphics, Inc."
.SH NAME
getgregs \- retrieve general purpose register contents for a target system thread
.SH SYNOPSIS
\f3getgregs\f1 thread
.SH DESCRIPTION
The 
.B getgregs
command sends a message requesting the contents of the general
purpose registers for the specified target system
.B thread
via
.I dbgif
and displays the register contents (in hex) on stdout. The contents of
certain CP0 registers (e.g., the program counter) are also displayed.
.PP
Before execution of this command, the
.I dbgif
program must be running and the
.I METHOD
environment variable must be set to zero to indicate that this is a
request for the R4300 CPU. The coprocessor does not have general registers,
so it is inappropriate to set METHOD to 1.
In
.I csh,
this is accomplished by specifying
.IP
setenv METHOD 0
.PP
If the specified thread was running, the displayed values will be
the contents of the registers at the time the thread was
preempted to service the getgregs request.
.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.