--- doc/gdb.texinfo | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) --- a/doc/gdb.texinfo +++ b/doc/gdb.texinfo @@ -33661,6 +33661,7 @@ Show the current setting of the target w * Host I/O Packets:: * Interrupts:: * Notification Packets:: +* ReportAsync Packets:: * Remote Non-Stop:: * Packet Acknowledgment:: * Examples:: @@ -35567,6 +35568,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:: @@ -36664,6 +36669,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 want send @dfn{reportasync} packets, it send shake hands +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