.TH getsregs 1P local "Silicon Graphics, Inc."
.SH NAME
getsregs \- retrieve scalar register contents from coprocessor
.SH SYNOPSIS
\f3getsregs\f1 thread
.SH DESCRIPTION
The 
.B getsregs
command sends a message requesting the contents of the coprocessor scalar
registers from the target system
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. The
.B thread
argument is required, but meaningless. Choose your favorite integer.
.PP
Before execution of this command, the
.I dbgif
program must be running and the
.I METHOD
environment variable must be set. Since the target system ignores the
specified value, it does not need to be changed to the "correct"
value of one, indicating that this is a request for the coprocessor.
The environment variable does need to be set so that a value can be
supplied as part of the request packet.
In
.I csh,
this is accomplished by specifying
.IP
setenv METHOD 1
.PP
If the coprocessor was running, the request will probably fail (as it should).
.SH SEE ALSO
dbgif(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
The thread argument should not be required.
.PP
The heading says General Registers; it should say Scalar Registers.