[PATCH] Add autoload-breakpoints [3/7] ReportAsync-doc

Hui Zhu
2012-03-17T08:52:52Z

[-- Attachment #1: Type: text/plain, Size: 205 bytes --]

Hi,

This is patch for the doc about ReportAsync.

Thanks,
Hui

2012-03-17 Hui Zhu <hui_zhu@mentor.com>

* gdb.texinfo (qSupported): Add ReportAsync.
(Remote Serial Protocol): Add ReportAsync Packets.

[-- Attachment #2: report-doc.txt --]
[-- Type: text/plain, Size: 1693 bytes --]

---
doc/gdb.texinfo | 25 +++++++++++++++++++++++++
1 file changed, 25 insertions(+)

--- a/doc/gdb.texinfo
+++ b/doc/gdb.texinfo
@@ -33568,6 +33568,7 @@ Show the current setting of the target w
* Host I/O Packets::
* Interrupts::
* Notification Packets::
+* ReportAsync Packets::
* Remote Non-Stop::
* Packet Acknowledgment::
* Examples::
@@ -35474,6 +35475,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::
@@ -36571,6 +36576,26 @@ 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 includes @dfn{reportasync},
+packets that the stub can report status or do an operation in any time.
+If the stub supports @dfn{reportasync}, it should report that to
+@value{GDBN} by including @samp{ReportAsync+} in its @samp{qSupported}
+response (@pxref{qSupported}).
+
+When the stub want send @dfn{reportasync} packets, it send shake hands
+packet @samp{^} to @value{GDBN}.
+If @value{GDBN} reply a @samp{^}, the shake hands is successful.
+If not, the shake hands is fail and this packet need to be handle
+as a simple packet.
+
+After shake hands, the stub can send packet to @value{GDBN}, the packet
+format is same with simple remote serial protocol.
+
@node Remote Non-Stop
@section Remote Protocol Support for Non-Stop Mode