.TH getfpregs 1P local "Silicon Graphics, Inc."
.SH NAME
getfpregs \- retrieve floating point register contents for a target system thread
.SH SYNOPSIS
\f3getfpregs\f1 thread
.SH DESCRIPTION
The 
.B getfpregs
command sends a message requesting the contents of the floating
point registers for the specified target system
.B thread
via
.I dbgif
and displays the register contents (in hex) 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 zero to indicate that this is a
request for the R4300 CPU. The coprocessor does not have floating point 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 registers will be
the contents of the registers at the time the thread was
preempted to service the getfpregs 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.
.PP
Only the 32-bit floating point registers ("float" regs) are displayed. It would
be nice to display the 64-bit registers ("double" regs) as well.