From bba2971c52ae57e209089c3f9bd5fd93990e1d8e Mon Sep 17 00:00:00 2001
From: Michael Snyder <msnyder@vmware.com>
Date: Fri, 24 Mar 2000 00:05:38 +0000
Subject: [PATCH] 2000-03-20  Michael Snyder  <msnyder@cleaver.cygnus.com>

        * gdb.texinfo: Add new queries ThreadInfo and ThreadExtraInfo.
---
 gdb/doc/ChangeLog   |  4 +++
 gdb/doc/gdb.texinfo | 68 +++++++++++++++++++++++++++++++++++++++++----
 2 files changed, 66 insertions(+), 6 deletions(-)

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index b3043d11d69..3d20b353eae 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -7,6 +7,10 @@
 
       * gdb.texinfo: Add documentation for the apropos command.
 
+2000-03-20  Michael Snyder  <msnyder@cleaver.cygnus.com>
+
+	* gdb.texinfo: Add new queries ThreadInfo and ThreadExtraInfo.
+
 2000-03-20  Michael Snyder  <msnyder@cleaver.cygnus.com>
 
 	* gdb.texinfo: Add white space to prevent overprinting in 
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 7ccfe03e46f..05f5fb595dc 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -9344,15 +9344,57 @@ Where @var{pid} is a HEX encoded 16 bit process id.
 @tab reply *
 @tab Any other reply implies the old pid.
 
-@item compute CRC of memory block
-@tab @code{q}@code{CRC:}@var{addr}@code{,}@var{length}
+@item all thread ids
+@tab @code{q}@code{fThreadInfo}
+@item
+@tab @code{q}@code{sThreadInfo}
 @tab
+Obtain a list of active thread ids from the target (OS).  Since there
+may be too many active threads to fit into one reply packet, this query
+works iteratively: it may require more than one query/reply sequence to
+obtain the entire list of threads.  The first query of the sequence will
+be the @code{qf}@code{ThreadInfo} query; subsequent queries in the 
+sequence will be the @code{qs}@code{ThreadInfo} query.
 @item
-@tab reply @code{E}@var{NN}
-@tab An error (such as memory fault)
+@tab
+@tab NOTE: replaces the @code{qL} query (see below).
 @item
-@tab reply @code{C}@var{CRC32}
-@tab A 32 bit cyclic redundancy check of the specified memory region.
+@tab reply @code{m}@var{<id>} 
+@tab A single thread id
+@item
+@tab reply @code{m}@var{<id>,}@var{<id>...} 
+@tab a comma-separated list of thread ids
+@item
+@tab reply @code{l}
+@tab (lower case 'el') denotes end of list.
+@item
+@tab
+@tab
+In response to each query, the target will reply with a list of one
+or more thread ids, in big-endian hex, separated by commas.  GDB will
+respond to each reply with a request for more thread ids (using the
+@code{qs} form of the query), until the target responds with @code{l}
+(lower-case el, for @code{'last'}).
+
+@item extra thread info
+@tab @code{qfThreadExtraInfo,}@var{<id>}
+@tab
+@item
+@tab
+@tab
+Where @var{<id>} is a thread-id in big-endian hex.
+Obtain a printable string description of a thread's attributes from
+the target OS.  This string may contain anything that the target OS
+thinks is interesting for @value{GDBN} to tell the user about the thread.
+The string is displayed in @value{GDBN}'s @samp{info threads} display.
+Some examples of possible thread extra info strings are "Runnable", or 
+"Blocked on Mutex".
+@item
+@tab reply @var{XX...}
+@tab
+Where @var{XX...} is a hex encoding of @sc{ascii} data, comprising the
+printable string containing the extra information about the thread's
+attributes.
 
 @item query @var{LIST} or @var{threadLIST} @strong{(deprecated)}
 @tab @code{q}@code{L}@var{startflag}@var{threadcount}@var{nextthread}
@@ -9367,6 +9409,10 @@ number of threads the response packet can contain; and @var{nextthread}
 (eight hex digits), for subsequent queries (@var{startflag} is zero), is
 returned in the response as @var{argthread}.
 @item
+@tab
+@tab NOTE: this query is replaced by the @code{q}@code{fThreadInfo}
+query (see above).
+@item
 @tab reply @code{q}@code{M}@var{count}@var{done}@var{argthread}@var{thread...}
 @tab
 @item
@@ -9379,6 +9425,16 @@ digits) is @var{nextthread} from the request packet; @var{thread...} is
 a sequence of thread IDs from the target.  @var{threadid} (eight hex
 digits).  See @code{remote.c:parse_threadlist_response()}.
 
+@item compute CRC of memory block
+@tab @code{q}@code{CRC:}@var{addr}@code{,}@var{length}
+@tab
+@item
+@tab reply @code{E}@var{NN}
+@tab An error (such as memory fault)
+@item
+@tab reply @code{C}@var{CRC32}
+@tab A 32 bit cyclic redundancy check of the specified memory region.
+
 @item query sect offs
 @tab @code{q}@code{Offsets}
 @tab
-- 
2.30.2