[PATCH v2] Add autoload-breakpoints [3/6] ReportAsync-doc
Hui Zhu
hui_zhu@mentor.com
Wed Apr 11 10:54:00 GMT 2012
Hi,
This is patch for the doc about ReportAsync.
Thanks,
Hui
2012-04-11 Hui Zhu <hui_zhu@mentor.com>
* gdb.texinfo (qSupported): Add ReportAsync.
(Remote Serial Protocol): Add ReportAsync Packets.
-------------- next part --------------
---
doc/gdb.texinfo | 23 +++++++++++++++++++++++
1 file changed, 23 insertions(+)
--- a/doc/gdb.texinfo
+++ b/doc/gdb.texinfo
@@ -33669,6 +33669,7 @@ Show the current setting of the target w
* Host I/O Packets::
* Interrupts::
* Notification Packets::
+* ReportAsync Packets::
* Remote Non-Stop::
* Packet Acknowledgment::
* Examples::
@@ -35575,6 +35576,10 @@ to be enabled and disabled while a trace
The remote stub supports the @samp{tracenz} bytecode for collecting strings.
See @ref{Bytecode Descriptions} for details about the bytecode.
+@item ReportAsync
+The remote stub supports the @samp{ReportAsync} packet
+(@pxref{ReportAsync Packets}).
+
@end table
@item qSymbol::
@@ -36672,6 +36677,24 @@ for information on how these notificatio
@value{GDBN}.
@end table
+@node ReportAsync Packets
+@section ReportAsync Packets
+@cindex reportasync packets
+@cindex packets, reportasync
+
+The @value{GDBN} remote serial protocol supports @dfn{reportasync}
+that can be used asynchronously to report status or send commands.
+
+When the stub wants to send @dfn{reportasync} packets, it should
+first send a handshake packet @samp{^} to @value{GDBN}.
+If @value{GDBN} replies with a @samp{^}, the handshake is successful.
+If not, the handshake fails, and the @samp{reportasync} packet needs
+to be handled as usual.
+
+After the handshake, the stub can send @samp{reportasync} packets to
+@value{GDBN}, using the same packet format as in normal remote serial
+protocol.
+
@node Remote Non-Stop
@section Remote Protocol Support for Non-Stop Mode
More information about the Gdb-patches
mailing list