diff options
Diffstat (limited to 'gdb/doc')
| -rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
| -rw-r--r-- | gdb/doc/gdb.texinfo | 28 |
2 files changed, 33 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 2217332..65aa06b 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2009-03-14 Pedro Alves <pedro@codesourcery.com> + + * gdb.texinfo (Remote Configuration): Document query-attached. + (General Query Packets): Document qAttached. + 2009-03-05 Pedro Alves <pedro@codesourcery.com> * gdb.texinfo (Background Execution): Better describe the set diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 5b3c50b..33bac26 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -14425,6 +14425,10 @@ are: @item @code{osdata} @tab @code{qXfer:osdata:read} @tab @code{info os} + +@item @code{query-attached} +@tab @code{qAttached} +@tab Querying remote process attach state. @end multitable @node Remote Stub @@ -27306,6 +27310,30 @@ not recognize the @var{object} keyword, or its support for @var{object} does not recognize the @var{operation} keyword, the stub must respond with an empty packet. +@item qAttached:@var{pid} +@cindex query attached, remote request +@cindex @samp{qAttached} packet +Return an indication of whether the remote server attached to an +existing process or created a new process. When the multiprocess +protocol extensions are supported (@pxref{multiprocess extensions}), +@var{pid} is an integer in hexadecimal format identifying the target +process. Otherwise, @value{GDBN} will omit the @var{pid} field and +the query packet will be simplified as @samp{qAttached}. + +This query is used, for example, to know whether the remote process +should be detached or killed when a @value{GDBN} session is ended with +the @code{quit} command. + +Reply: +@table @samp +@item 1 +The remote server attached to an existing process. +@item 0 +The remote server created a new process. +@item E @var{NN} +A badly formed request or an error was encountered. +@end table + @end table @node Register Packet Format |