From: Jim Blandy <jimb@codesourcery.com>
Date: Tue, 15 Nov 2005 19:58:30 +0000 (+0000)
Subject: * gdb.texinfo (Packets): Clarify lack of restrictions on behavior
X-Git-Tag: gdb-csl-gxxpro-6_3-branchpoint~9
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=0312625ce8d435f600175c15b09da46a624dc839;p=pf3gnuchains%2Fpf3gnuchains4x.git

* gdb.texinfo (Packets): Clarify lack of restrictions on behavior
of stub when processing an 'm' packet.
---

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 5af5143e47..fd6d5c1656 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,5 +1,8 @@
 2005-11-15  Jim Blandy  <jimb@redhat.com>
 
+	* gdb.texinfo (Packets): Clarify lack of restrictions on behavior
+	of stub when processing an 'm' packet.
+
 	* gdb.texinfo (Packets): Mention that packets beginning with
 	letters are reserved once, at the top, instead of actually listing
 	them all and saying "reserved".
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 8b2e7c3392..a6b97b9d7a 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -22325,18 +22325,19 @@ thread?)}.
 @cindex @code{m} packet
 
 Read @var{length} bytes of memory starting at address @var{addr}.
-Neither @value{GDBN} nor the stub assume that sized memory transfers are
-assumed using word aligned accesses. FIXME: @emph{A word aligned memory
-transfer mechanism is needed.}
+Note that @var{addr} may not be aligned to any particular boundary.
+
+The stub need not use any particular size or alignment when gathering
+data from memory for the response; even if @var{addr} is word-aligned
+and @var{length} is a multiple of the word size, the stub is free to
+use byte accesses, or not.  For this reason, this packet may not be
+suitable for accessing memory-mapped I/O devices.
 
 Reply:
 @table @samp
 @item @var{XX@dots{}}
 @var{XX@dots{}} is mem contents. Can be fewer bytes than requested if able
-to read only part of the data.  Neither @value{GDBN} nor the stub assume
-that sized memory transfers are assumed using word aligned
-accesses. FIXME: @emph{A word aligned memory transfer mechanism is
-needed.}
+to read only part of the data.
 @item E@var{NN}
 @var{NN} is errno
 @end table