summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Jacobowitz <drow@false.org>2006-04-19 18:19:20 +0000
committerDaniel Jacobowitz <drow@false.org>2006-04-19 18:19:20 +0000
commitc1bc7fd90c39577fa0582538a929c27ac7ad026d (patch)
tree154037fb91fc16e7182f08b80c6bd36986d779da
parentc6fa8bc6dad144a797b0d2ee62bf56d8a920f05c (diff)
downloadbinutils-gdb-c1bc7fd90c39577fa0582538a929c27ac7ad026d.tar.gz
* gdb/doc/gdb.texinfo (Remote configuration): Mention "set remotegdb-csl-sourcerygxx-3_4_4-17gdb-csl-20060226-branch-merge-to-csl-symbian-1
load-offsets". (General Query Packets): Document qPartInfo.
-rw-r--r--ChangeLog.csl6
-rw-r--r--gdb/doc/gdb.texinfo67
2 files changed, 73 insertions, 0 deletions
diff --git a/ChangeLog.csl b/ChangeLog.csl
index c07e1ce20fb..00b108814e2 100644
--- a/ChangeLog.csl
+++ b/ChangeLog.csl
@@ -1,3 +1,9 @@
+2006-04-19 Daniel Jacobowitz <dan@codesourcery.com>
+
+ * gdb/doc/gdb.texinfo (Remote configuration): Mention "set remote
+ load-offsets".
+ (General Query Packets): Document qPartInfo.
+
2006-04-18 Mark Mitchell <mark@codesourcery.com>
Issue #655
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index d79933a1511..b1a75811214 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -12624,6 +12624,20 @@ packet.
@item show remote get-thread-local-storage-address
@kindex show remote get-thread-local-storage-address
Show the current setting of @samp{qGetTLSAddr} packet usage.
+
+@item set remote load-offsets
+@kindex set remote load-offsets
+@cindex load offsets of remote targets
+This command enables or disables the use of the @samp{qOffsets}
+request packet. This packet is used to find a relocated downloaded
+image. @xref{General Query Packets, qOffsets}, for more details about
+this packet. The default depends on the remote stub's support of this
+packet (@value{GDBN} queries the stub when this packet is first
+required).
+
+@item show remote load-offsets
+@kindex show remote load-offsets
+Show the current setting of @samp{qOffsets} packet usage.
@end table
@node remote stub
@@ -23249,6 +23263,59 @@ encoded 32 bit mode; @var{threadid} is a hex encoded 64 bit thread ID.
Reply: see @code{remote.c:remote_unpack_thread_info_response()}.
+@item qPacketInfo @r{[};@var{feature}@r{]}...
+@cindex supported packets, remote query
+@cindex @samp{qPacketInfo} packet
+Tell the remote target about features supported by @value{GDBN}, and
+query it for features it supports.
+
+No values of @var{feature} are defined yet. Targets should ignore any
+unknown values for @var{feature}. Any @value{GDBN} which sends a
+@samp{qPacketInfo} packet supports receiving packets of unlimited
+length. Values for @var{feature} may be defined in the future to let
+the stub take advantage of new features in @value{GDBN}, e.g.@:
+incompatible improvements in the remote protocol.
+
+The reply is one or more feature responses, or empty if this packet is
+not supported. Multiple feature responses are separated by semicolons,
+and individual feature responses may not include semicolons. @value{GDBN}
+will silently ignore unrecognized feature responses, as long as the
+unrecognized response has one of the standard forms. The standard forms
+are:
+
+@table @samp
+@item @var{name}=@var{value}
+Set a remote communication parameter to the specified value.
+@item @var{name}+
+The remote protocol packet @var{name} is supported.
+@item @var{name}-
+The remote protocol packet @var{name} is not supported.
+@end table
+
+Currently only one communication parameter is supported:
+
+@table @samp
+@item PacketSize=@var{bytes}
+The remote target can accept packets up to at least @var{bytes} in
+length.
+@end table
+
+The name of a packet which can be marked as supported or unsupported
+is the text of the packet in this documentation, up to but not
+including the first punctuation character or variable. For example, a
+target which supports hardware watchpoints but not hardware
+breakpoints might report @samp{Z0-;Z1-;Z2+;Z3+;Z4+}. An exception is
+made for @samp{qPart:@var{object}} packets; the name of the packet
+includes the @var{object}, but not the @var{annex}. Individual
+@samp{qPart} packet types must be reported separately.
+
+Currently, all remote packets which are not mentioned in the response
+will be probed individually, just as if the @samp{qPacketInfo} command
+was not supported. In the future, some new packets may be added to
+the remote protocol which will be assumed to be unsupported unless
+@samp{qPacketInfo} is supported and the new packet is reported in the
+@samp{qPacketInfo} response.
+
@item qPart:@var{object}:read:@var{annex}:@var{offset},@var{length}
@cindex read special object, remote request
@cindex @samp{qPart} packet