aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorMichael Snyder <msnyder@vmware.com>2000-03-24 00:05:38 +0000
committerMichael Snyder <msnyder@vmware.com>2000-03-24 00:05:38 +0000
commitbba2971c52ae57e209089c3f9bd5fd93990e1d8e (patch)
tree1af766dc5e310a62e7542510dfb37d18704e9ea2 /gdb
parentcfeada605e69656df0aebec270630805d0c83e8e (diff)
downloadgdb-bba2971c52ae57e209089c3f9bd5fd93990e1d8e.zip
gdb-bba2971c52ae57e209089c3f9bd5fd93990e1d8e.tar.gz
gdb-bba2971c52ae57e209089c3f9bd5fd93990e1d8e.tar.bz2
2000-03-20 Michael Snyder <msnyder@cleaver.cygnus.com>
* gdb.texinfo: Add new queries ThreadInfo and ThreadExtraInfo.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/doc/ChangeLog4
-rw-r--r--gdb/doc/gdb.texinfo68
2 files changed, 66 insertions, 6 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index b3043d1..3d20b35 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -9,6 +9,10 @@
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
two places.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 7ccfe03..05f5fb5 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