mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-09 04:21:49 +08:00
2005-11-12 Jim Blandy <jimb@redhat.com>
* gdb.texinfo (General Query Packets): Put packets in alphabetical order. Remove extraneous 'z'.
This commit is contained in:
Jim Blandy
parent
c57a5dde19
commit
fa93a9d8fc
@ -1,3 +1,8 @@
|
|||||||
|
2005-11-12 Jim Blandy <jimb@redhat.com>
|
||||||
|
|
||||||
|
* gdb.texinfo (General Query Packets): Put packets in alphabetical
|
||||||
|
order. Remove extraneous 'z'.
|
||||||
|
|
||||||
2005-11-07 Andrew Stubbs <andrew.stubbs@st.com>
|
2005-11-07 Andrew Stubbs <andrew.stubbs@st.com>
|
||||||
|
|
||||||
* gdb.texinfo (Choosing files): Add --eval-command.
|
* gdb.texinfo (Choosing files): Add --eval-command.
|
||||||
|
|||||||
@ -22762,6 +22762,17 @@ Where @var{pid} is an unsigned hexidecimal process id.
|
|||||||
Any other reply implies the old pid.
|
Any other reply implies the old pid.
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
|
@item @code{q}@code{CRC:}@var{addr}@code{,}@var{length} --- compute CRC of memory block
|
||||||
|
@cindex CRC of memory block, remote request
|
||||||
|
@cindex @code{qCRC} packet
|
||||||
|
Reply:
|
||||||
|
@table @samp
|
||||||
|
@item @code{E}@var{NN}
|
||||||
|
An error (such as memory fault)
|
||||||
|
@item @code{C}@var{CRC32}
|
||||||
|
A 32 bit cyclic redundancy check of the specified memory region.
|
||||||
|
@end table
|
||||||
|
|
||||||
@item @code{q}@code{fThreadInfo} -- all thread ids
|
@item @code{q}@code{fThreadInfo} -- all thread ids
|
||||||
@cindex list active threads, remote request
|
@cindex list active threads, remote request
|
||||||
@cindex @code{qfThreadInfo} packet
|
@cindex @code{qfThreadInfo} packet
|
||||||
@ -22792,25 +22803,43 @@ more thread ids, in big-endian unsigned hex, separated by commas.
|
|||||||
ids (using the @code{qs} form of the query), until the target responds
|
ids (using the @code{qs} form of the query), until the target responds
|
||||||
with @code{l} (lower-case el, for @code{'last'}).
|
with @code{l} (lower-case el, for @code{'last'}).
|
||||||
|
|
||||||
@item @code{q}@code{ThreadExtraInfo}@code{,}@var{id} --- extra thread info
|
@item @code{qGetTLSAddr}:@var{thread-id},@var{offset},@var{lm} --- get thread local storage address
|
||||||
@cindex thread attributes info, remote request
|
@cindex get thread-local storage address, remote request
|
||||||
@cindex @code{qThreadExtraInfo} packet
|
@cindex @code{qGetTLSAddr} packet
|
||||||
Where @var{id} is a thread-id in big-endian hex. Obtain a printable
|
Fetch the address associated with thread local storage specified
|
||||||
string description of a thread's attributes from the target OS. This
|
by @var{thread-id}, @var{offset}, and @var{lm}.
|
||||||
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
|
@var{thread-id} is the (big endian, hex encoded) thread id associated with the
|
||||||
in @value{GDBN}'s @samp{info threads} display. Some examples of
|
thread for which to fetch the TLS address.
|
||||||
possible thread extra info strings are ``Runnable'', or ``Blocked on
|
|
||||||
Mutex''.
|
@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:
|
Reply:
|
||||||
@table @samp
|
@table @asis
|
||||||
@item @var{XX@dots{}}
|
@item @var{XX@dots{}}
|
||||||
Where @var{XX@dots{}} is a hex encoding of @sc{ascii} data, comprising
|
Hex encoded (big endian) bytes representing the address of the thread
|
||||||
the printable string containing the extra information about the thread's
|
local storage requested.
|
||||||
attributes.
|
|
||||||
|
@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
|
||||||
|
|
||||||
|
Use of this request packet is controlled by the @code{set remote
|
||||||
|
get-thread-local-storage-address} command (@pxref{Remote
|
||||||
|
configuration, set remote get-thread-local-storage-address}).
|
||||||
|
|
||||||
@item @code{q}@code{L}@var{startflag}@var{threadcount}@var{nextthread} --- query @var{LIST} or @var{threadLIST} @strong{(deprecated)}
|
@item @code{q}@code{L}@var{startflag}@var{threadcount}@var{nextthread} --- query @var{LIST} or @var{threadLIST} @strong{(deprecated)}
|
||||||
|
|
||||||
Obtain thread information from RTOS. Where: @var{startflag} (one hex
|
Obtain thread information from RTOS. Where: @var{startflag} (one hex
|
||||||
@ -22834,17 +22863,6 @@ is a sequence of thread IDs from the target. @var{threadid} (eight hex
|
|||||||
digits). See @code{remote.c:parse_threadlist_response()}.
|
digits). See @code{remote.c:parse_threadlist_response()}.
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
@item @code{q}@code{CRC:}@var{addr}@code{,}@var{length} --- compute CRC of memory block
|
|
||||||
@cindex CRC of memory block, remote request
|
|
||||||
@cindex @code{qCRC} packet
|
|
||||||
Reply:
|
|
||||||
@table @samp
|
|
||||||
@item @code{E}@var{NN}
|
|
||||||
An error (such as memory fault)
|
|
||||||
@item @code{C}@var{CRC32}
|
|
||||||
A 32 bit cyclic redundancy check of the specified memory region.
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@item @code{q}@code{Offsets} --- query sect offs
|
@item @code{q}@code{Offsets} --- query sect offs
|
||||||
@cindex section offsets, remote request
|
@cindex section offsets, remote request
|
||||||
@cindex @code{qOffsets} packet
|
@cindex @code{qOffsets} packet
|
||||||
@ -22871,65 +22889,6 @@ Reply:
|
|||||||
|
|
||||||
See @code{remote.c:remote_unpack_thread_info_response()}.
|
See @code{remote.c:remote_unpack_thread_info_response()}.
|
||||||
|
|
||||||
@item @code{q}@code{Rcmd,}@var{command} --- remote command
|
|
||||||
@cindex execute remote command, remote request
|
|
||||||
@cindex @code{qRcmd} packet
|
|
||||||
@var{command} (hex encoded) is passed to the local interpreter for
|
|
||||||
execution. Invalid commands should be reported using the output string.
|
|
||||||
Before the final result packet, the target may also respond with a
|
|
||||||
number of intermediate @code{O}@var{output} console output packets.
|
|
||||||
@emph{Implementors should note that providing access to a stubs's
|
|
||||||
interpreter may have security implications}.
|
|
||||||
|
|
||||||
Reply:
|
|
||||||
@table @samp
|
|
||||||
@item OK
|
|
||||||
A command response with no output.
|
|
||||||
@item @var{OUTPUT}
|
|
||||||
A command response with the hex encoded output string @var{OUTPUT}.
|
|
||||||
@item @code{E}@var{NN}
|
|
||||||
Indicate a badly formed request.
|
|
||||||
@item @samp{}
|
|
||||||
When @samp{q}@samp{Rcmd} is not recognized.
|
|
||||||
@end table
|
|
||||||
z
|
|
||||||
@item @code{qSymbol::} --- symbol lookup
|
|
||||||
@cindex symbol lookup, remote request
|
|
||||||
@cindex @code{qSymbol} packet
|
|
||||||
Notify the target that @value{GDBN} is prepared to serve symbol lookup
|
|
||||||
requests. Accept requests from the target for the values of symbols.
|
|
||||||
|
|
||||||
Reply:
|
|
||||||
@table @samp
|
|
||||||
@item @code{OK}
|
|
||||||
The target does not need to look up any (more) symbols.
|
|
||||||
@item @code{qSymbol:}@var{sym_name}
|
|
||||||
The target requests the value of symbol @var{sym_name} (hex encoded).
|
|
||||||
@value{GDBN} may provide the value by using the
|
|
||||||
@code{qSymbol:}@var{sym_value}:@var{sym_name} message, described below.
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@item @code{qSymbol:}@var{sym_value}:@var{sym_name} --- symbol value
|
|
||||||
|
|
||||||
Set the value of @var{sym_name} to @var{sym_value}.
|
|
||||||
|
|
||||||
@var{sym_name} (hex encoded) is the name of a symbol whose value the
|
|
||||||
target has previously requested.
|
|
||||||
|
|
||||||
@var{sym_value} (hex) is the value for symbol @var{sym_name}. If
|
|
||||||
@value{GDBN} cannot supply a value for @var{sym_name}, then this field
|
|
||||||
will be empty.
|
|
||||||
|
|
||||||
Reply:
|
|
||||||
@table @samp
|
|
||||||
@item @code{OK}
|
|
||||||
The target does not need to look up any (more) symbols.
|
|
||||||
@item @code{qSymbol:}@var{sym_name}
|
|
||||||
The target requests the value of a new symbol @var{sym_name} (hex
|
|
||||||
encoded). @value{GDBN} will continue to supply the values of symbols
|
|
||||||
(if available), until the target ceases to request them.
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@item @code{qPart}:@var{object}:@code{read}:@var{annex}:@var{offset},@var{length} --- read special data
|
@item @code{qPart}:@var{object}:@code{read}:@var{annex}:@var{offset},@var{length} --- read special data
|
||||||
@cindex read special object, remote request
|
@cindex read special object, remote request
|
||||||
@cindex @code{qPart} packet
|
@cindex @code{qPart} packet
|
||||||
@ -23009,42 +22968,83 @@ not recognize the @var{object} keyword, or its support for
|
|||||||
@var{object} does not recognize the @var{operation} keyword,
|
@var{object} does not recognize the @var{operation} keyword,
|
||||||
the stub must respond with an empty packet.
|
the stub must respond with an empty packet.
|
||||||
|
|
||||||
@item @code{qGetTLSAddr}:@var{thread-id},@var{offset},@var{lm} --- get thread local storage address
|
@item @code{q}@code{Rcmd,}@var{command} --- remote command
|
||||||
@cindex get thread-local storage address, remote request
|
@cindex execute remote command, remote request
|
||||||
@cindex @code{qGetTLSAddr} packet
|
@cindex @code{qRcmd} packet
|
||||||
Fetch the address associated with thread local storage specified
|
@var{command} (hex encoded) is passed to the local interpreter for
|
||||||
by @var{thread-id}, @var{offset}, and @var{lm}.
|
execution. Invalid commands should be reported using the output string.
|
||||||
|
Before the final result packet, the target may also respond with a
|
||||||
@var{thread-id} is the (big endian, hex encoded) thread id associated with the
|
number of intermediate @code{O}@var{output} console output packets.
|
||||||
thread for which to fetch the TLS address.
|
@emph{Implementors should note that providing access to a stubs's
|
||||||
|
interpreter may have security implications}.
|
||||||
@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:
|
Reply:
|
||||||
@table @asis
|
@table @samp
|
||||||
@item @var{XX@dots{}}
|
@item OK
|
||||||
Hex encoded (big endian) bytes representing the address of the thread
|
A command response with no output.
|
||||||
local storage requested.
|
@item @var{OUTPUT}
|
||||||
|
A command response with the hex encoded output string @var{OUTPUT}.
|
||||||
@item @code{E}@var{nn} (where @var{nn} are hex digits)
|
@item @code{E}@var{NN}
|
||||||
An error occurred.
|
Indicate a badly formed request.
|
||||||
|
@item @samp{}
|
||||||
@item @code{""} (empty)
|
When @samp{q}@samp{Rcmd} is not recognized.
|
||||||
An empty reply indicates that @code{qGetTLSAddr} is not supported by the stub.
|
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
Use of this request packet is controlled by the @code{set remote
|
@item @code{qSymbol::} --- symbol lookup
|
||||||
get-thread-local-storage-address} command (@pxref{Remote
|
@cindex symbol lookup, remote request
|
||||||
configuration, set remote get-thread-local-storage-address}).
|
@cindex @code{qSymbol} packet
|
||||||
|
Notify the target that @value{GDBN} is prepared to serve symbol lookup
|
||||||
|
requests. Accept requests from the target for the values of symbols.
|
||||||
|
|
||||||
|
Reply:
|
||||||
|
@table @samp
|
||||||
|
@item @code{OK}
|
||||||
|
The target does not need to look up any (more) symbols.
|
||||||
|
@item @code{qSymbol:}@var{sym_name}
|
||||||
|
The target requests the value of symbol @var{sym_name} (hex encoded).
|
||||||
|
@value{GDBN} may provide the value by using the
|
||||||
|
@code{qSymbol:}@var{sym_value}:@var{sym_name} message, described below.
|
||||||
|
@end table
|
||||||
|
|
||||||
|
@item @code{qSymbol:}@var{sym_value}:@var{sym_name} --- symbol value
|
||||||
|
|
||||||
|
Set the value of @var{sym_name} to @var{sym_value}.
|
||||||
|
|
||||||
|
@var{sym_name} (hex encoded) is the name of a symbol whose value the
|
||||||
|
target has previously requested.
|
||||||
|
|
||||||
|
@var{sym_value} (hex) is the value for symbol @var{sym_name}. If
|
||||||
|
@value{GDBN} cannot supply a value for @var{sym_name}, then this field
|
||||||
|
will be empty.
|
||||||
|
|
||||||
|
Reply:
|
||||||
|
@table @samp
|
||||||
|
@item @code{OK}
|
||||||
|
The target does not need to look up any (more) symbols.
|
||||||
|
@item @code{qSymbol:}@var{sym_name}
|
||||||
|
The target requests the value of a new symbol @var{sym_name} (hex
|
||||||
|
encoded). @value{GDBN} will continue to supply the values of symbols
|
||||||
|
(if available), until the target ceases to request them.
|
||||||
|
@end table
|
||||||
|
|
||||||
|
@item @code{q}@code{ThreadExtraInfo}@code{,}@var{id} --- extra thread info
|
||||||
|
@cindex thread attributes info, remote request
|
||||||
|
@cindex @code{qThreadExtraInfo} packet
|
||||||
|
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''.
|
||||||
|
|
||||||
|
Reply:
|
||||||
|
@table @samp
|
||||||
|
@item @var{XX@dots{}}
|
||||||
|
Where @var{XX@dots{}} is a hex encoding of @sc{ascii} data, comprising
|
||||||
|
the printable string containing the extra information about the thread's
|
||||||
|
attributes.
|
||||||
|
@end table
|
||||||
|
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user