mirror of
https://github.com/bminor/binutils-gdb.git
synced 2025-12-05 15:15:42 +00:00
doc: fine-tune the documentation of the 'm' RSP packet
Revise a sentence to avoid misinterpretation. Move @cindex entries before the text they index. Refer to trace frames regarding partial reads. Approved-By: Eli Zaretskii <eliz@gnu.org>
This commit is contained in:
@@ -43094,24 +43094,25 @@ probes the target state as if a new connection was opened
|
||||
@item m @var{addr},@var{length}
|
||||
@cindex @samp{m} packet
|
||||
Read @var{length} addressable memory units starting at address @var{addr}
|
||||
(@pxref{addressable memory unit}). Note that @var{addr} may not be aligned to
|
||||
any particular boundary.
|
||||
(@pxref{addressable memory unit}). Note that @var{addr} does not have to
|
||||
be aligned to any particular boundary.
|
||||
|
||||
@cindex alignment of remote memory accesses
|
||||
@cindex size of remote memory accesses
|
||||
@cindex memory, alignment and size of remote accesses
|
||||
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.
|
||||
@cindex alignment of remote memory accesses
|
||||
@cindex size of remote memory accesses
|
||||
@cindex memory, alignment and size of remote accesses
|
||||
|
||||
Reply:
|
||||
@table @samp
|
||||
@item @var{XX@dots{}}
|
||||
Memory contents; each byte is transmitted as a two-digit hexadecimal number.
|
||||
The reply may contain fewer addressable memory units than requested if the
|
||||
server was able to read only part of the region of memory.
|
||||
server was reading from a trace frame memory and was able to read only part
|
||||
of the region of memory.
|
||||
@end table
|
||||
|
||||
Unlike most packets, this packet does not support
|
||||
|
||||
Reference in New Issue
Block a user