From 83761cbd36b58d460215df1e96a439502d19712e Mon Sep 17 00:00:00 2001 From: Kevin Buettner Date: Thu, 3 Feb 2005 16:11:38 +0000 Subject: [PATCH] * gdb.texinfo (General Query Packets): Document qGetTLSAddr packet. --- gdb/doc/ChangeLog | 4 ++++ gdb/doc/gdb.texinfo | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 37 insertions(+) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index b6c2e16b31..70781e0867 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,7 @@ +2005-02-03 Kevin Buettner + + * gdb.texinfo (General Query Packets): Document qGetTLSAddr packet. + 2005-01-17 Michael Snyder * gdb.texinfo: Fix spelling, infinte -> infinite. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 624fc63f70..0e93963a25 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -21076,6 +21076,39 @@ Requests of this form may be added in the future. When a stub does 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 @code{qGetTLSAddr}:@var{thread-id},@var{offset},@var{lm} --- get thread local storage address + +Fetch the address associated with thread local storage specified +by @var{thread-id}, @var{offset}, and @var{lm}. + +@var{thread-id} is the (big endian, hex encoded) thread id associated with the +thread for which to fetch the TLS address. + +@var{offset} is the (big endian, hex encoded) offset associated with the +thread local variable. (This offset is obtained from the debug +information associated with the variable.) + +@var{lm} is the (big endian, hex encoded) OS/ABI specific encoding of the +the load module associated with the thread local storage. For example, +a @sc{gnu}/Linux system will pass the link map address of the shared +object associated with the thread local storage under consideration. +Other operating environments may choose to represent the load module +differently, so the precise meaning of this parameter will vary. + +Reply: +@table @asis +@item @var{XX@dots} +Hex encoded (big endian) bytes representing the address of the thread +local storage requested. + +@item @code{E}@var{nn} (where @var{nn} are hex digits) +An error occurred. + +@item @code{""} (empty) +An empty reply indicates that @code{qGetTLSAddr} is not supported by the stub. +@end table + @end table @node Register Packet Format