From 85dc5a128b06ba0d81733740dde149559e2f2630 Mon Sep 17 00:00:00 2001 From: Gary Benson Date: Tue, 4 Jun 2013 13:07:45 +0000 Subject: [PATCH] 2013-06-04 Gary Benson * gdb.texinfo (General Query Packets/qSupported): Added "qXfer:libraries-svr4:read" and "augmented-libraries-svr4-read". to the table of currently defined stub features. Added a more detailed entry for "augmented-libraries-svr4-read". (General Query Packets/qXfer:libraries-svr4:read): Documented the augmented form of this packet. --- gdb/doc/ChangeLog | 9 +++++++++ gdb/doc/gdb.texinfo | 44 +++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 52 insertions(+), 1 deletion(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index bb290caeb1a..fdb240010c3 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,12 @@ +2013-06-04 Gary Benson + + * gdb.texinfo (General Query Packets/qSupported): Added + "qXfer:libraries-svr4:read" and "augmented-libraries-svr4-read". + to the table of currently defined stub features. + Added a more detailed entry for "augmented-libraries-svr4-read". + (General Query Packets/qXfer:libraries-svr4:read): Documented + the augmented form of this packet. + 2013-05-23 Joel Brobecker * gdb.texinfo (System-wide Configuration Scripts): Renames diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index ead00b41a8f..db293c2b214 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -38594,6 +38594,16 @@ These are the currently defined stub features and their properties: @tab @samp{-} @tab Yes +@item @samp{qXfer:libraries-svr4:read} +@tab No +@tab @samp{-} +@tab Yes + +@item @samp{augmented-libraries-svr4-read} +@tab No +@tab @samp{-} +@tab No + @item @samp{qXfer:memory-map:read} @tab No @tab @samp{-} @@ -38770,6 +38780,11 @@ The remote stub understands the @samp{qXfer:libraries:read} packet The remote stub understands the @samp{qXfer:libraries-svr4:read} packet (@pxref{qXfer svr4 library list read}). +@item augmented-libraries-svr4-read +The remote stub understands the augmented form of the +@samp{qXfer:libraries-svr4:read} packet +(@pxref{qXfer svr4 library list read}). + @item qXfer:memory-map:read The remote stub understands the @samp{qXfer:memory-map:read} packet (@pxref{qXfer memory map read}). @@ -39065,7 +39080,10 @@ by supplying an appropriate @samp{qSupported} response (@pxref{qSupported}). @anchor{qXfer svr4 library list read} Access the target's list of loaded libraries when the target is an SVR4 platform. @xref{Library List Format for SVR4 Targets}. The annex part -of the generic @samp{qXfer} packet must be empty (@pxref{qXfer read}). +of the generic @samp{qXfer} packet must be empty unless the remote +stub indicated it supports the augmented form of this packet +by supplying an appropriate @samp{qSupported} response +(@pxref{qXfer read}, @ref{qSupported}). This packet is optional for better performance on SVR4 targets. @value{GDBN} uses memory read packets to read the SVR4 library list otherwise. @@ -39073,6 +39091,30 @@ This packet is optional for better performance on SVR4 targets. This packet is not probed by default; the remote stub must request it, by supplying an appropriate @samp{qSupported} response (@pxref{qSupported}). +If the remote stub indicates it supports the augmented form of this +packet then the annex part of the generic @samp{qXfer} packet may +contain a semicolon-separated list of @samp{@var{name}=@var{value}} +arguments. The currently supported arguments are: + +@table @code +@item start=@var{address} +A hexadecimal number specifying the address of the @samp{struct +link_map} to start reading the library list from. If unset or zero +then the first @samp{struct link_map} in the library list will be +chosen as the starting point. + +@item prev=@var{address} +A hexadecimal number specifying the address of the @samp{struct +link_map} immediately preceding the @samp{struct link_map} +specified by the @samp{start} argument. If unset or zero then +the remote stub will expect that no @samp{struct link_map} +exists prior to the starting point. + +@end table + +Arguments that are not understood by the remote stub will be silently +ignored. + @item qXfer:memory-map:read::@var{offset},@var{length} @anchor{qXfer memory map read} Access the target's @dfn{memory-map}. @xref{Memory Map Format}. The -- 2.30.2