http://sourceware.org/ml/gdb-cvs/2013-06/msg00016.html ### src/gdb/doc/ChangeLog 2013/05/24 04:50:26 1.1463 ### src/gdb/doc/ChangeLog 2013/06/04 13:07:45 1.1464 ## -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 --- src/gdb/doc/gdb.texinfo 2013/05/24 04:50:26 1.1093 +++ src/gdb/doc/gdb.texinfo 2013/06/04 13:07:45 1.1094 @@ -38594,6 +38594,16 @@ @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-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 @@ @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 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