aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2005-12-28 20:05:49 +0000
committerEli Zaretskii <eliz@gnu.org>2005-12-28 20:05:49 +0000
commit36b80e652cc323db04e6e049a6c85caef1a8bcf1 (patch)
tree3f1aa1ae0a27c23742d28d3630afff6896e8f84d
parenta1b06f3564a44e113063ec06d7794063670e5a76 (diff)
downloadgdb-36b80e652cc323db04e6e049a6c85caef1a8bcf1.zip
gdb-36b80e652cc323db04e6e049a6c85caef1a8bcf1.tar.gz
gdb-36b80e652cc323db04e6e049a6c85caef1a8bcf1.tar.bz2
* gdb.texinfo (Registers): Describe how to refer to SSE and MMX
registers and the likes.
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo30
2 files changed, 35 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index def1289..6f62bb6 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2005-12-28 Eli Zaretskii <eliz@gnu.org>
+
+ * gdb.texinfo (Registers): Describe how to refer to SSE and MMX
+ registers and the likes.
+
2005-12-24 Eli Zaretskii <eliz@gnu.org>
* gdb.texinfo (Target Commands, Bug Reporting, File Options)
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index ae1ad18..ea22517 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -6279,6 +6279,36 @@ cases, @value{GDBN} normally works with the virtual format only (the format
that makes sense for your program), but the @code{info registers} command
prints the data in both formats.
+@cindex SSE registers (x86)
+@cindex MMX registers (x86)
+Some machines have special registers whose contents can be interpreted
+in several different ways. For example, modern x86-based machines
+have SSE and MMX registers that can hold several values packed
+together in several different formats. @value{GDBN} refers to such
+registers in @code{struct} notation:
+
+@smallexample
+(@value{GDBP}) print $xmm1
+$1 = @{
+ v4_float = @{0, 3.43859137e-038, 1.54142831e-044, 1.821688e-044@},
+ v2_double = @{9.92129282474342e-303, 2.7585945287983262e-313@},
+ v16_int8 = "\000\000\000\000\3706;\001\v\000\000\000\r\000\000",
+ v8_int16 = @{0, 0, 14072, 315, 11, 0, 13, 0@},
+ v4_int32 = @{0, 20657912, 11, 13@},
+ v2_int64 = @{88725056443645952, 55834574859@},
+ uint128 = 0x0000000d0000000b013b36f800000000
+@}
+@end smallexample
+
+@noindent
+To set values of such registers, you need to tell @value{GDBN} which
+view of the register you wish to change, as if you were assigning
+value to a @code{struct} member:
+
+@smallexample
+ (@value{GDBP}) set $xmm1.uint128 = 0x000000000000000000000000FFFFFFFF
+@end smallexample
+
Normally, register values are relative to the selected stack frame
(@pxref{Selection, ,Selecting a frame}). This means that you get the
value that the register would contain if all stack frames farther in