PATCH: 2/6: Add AVX support (Update document)

H.J. Lu
2010-03-04T18:05:14Z

Hi,

This patch updates document for AVX support. OK to install?

Thanks.

H.J.
---
2010-03-03 H.J. Lu <hongjiu.lu@intel.com>

* gdb.texinfo (General Query Packets): Document x86:xstate
extension in gdb remote protocol.
(i386 Features): Add org.gnu.gdb.i386.avx.

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 6bb7d52..9bb79ae 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -30250,6 +30250,16 @@ extensions to the remote protocol. @value{GDBN} does not use such
extensions unless the stub also reports that it supports them by
including @samp{multiprocess+} in its @samp{qSupported} reply.
@xref{multiprocess extensions}, for details.
+
+@item x86:xstate=@var{bytes}:xcr0=@var{value}
+This feature indicates that @value{GDBN} supports x86 XSAVE extended
+state. @var{bytes} specifies the maximum size in bytes of x86 XSAVE
+extended state @value{GDBN} supports. @var{value} specifies the
+maximum value of the extended control register 0 (the
+XFEATURE_ENABLED_MASK register) @value{GDBN} supports. The stub should
+select the best target description supported by @value{GDBN}, based on
+@var{bytes} and @var{value}. @var{bytes} and @var{value} are encoded
+as @sc{ascii} string in hexadecimal or decimal numbers.
@end table

Stubs should ignore any unknown values for
@@ -33320,8 +33330,7 @@ targets. It should describe the following registers:

The register sets may be different, depending on the target.

-The @samp{org.gnu.gdb.i386.sse} feature is required. It should
-describe registers:
+The @samp{org.gnu.gdb.i386.sse} feature should describe registers:

@itemize @minus
@item
@@ -33332,6 +33341,20 @@ describe registers:
@samp{mxcsr}
@end itemize

+The @samp{org.gnu.gdb.i386.avx} feature should describe registers:
+
+@itemize @minus
+@item
+@samp{ymm0} through @samp{ymm7} for i386
+@item
+@samp{ymm0} through @samp{ymm15} for amd64
+@item
+@samp{mxcsr}
+@end itemize
+
+One of the @samp{org.gnu.gdb.i386.sse} or @samp{org.gnu.gdb.i386.avx}
+feature is required, not both.
+
The @samp{org.gnu.gdb.i386.linux} feature is optional. It should
describe a single register, @samp{orig_eax}.