- To: GDB Patches <gdb-patches at sourceware dot cygnus dot com>
- Subject: [patch] Fix doco for ``!'' and ``R'' packets
- From: Andrew Cagney <ac131313 at cygnus dot com>
- Date: Thu, 14 Jun 2001 18:08:50 -0400
Hello,
The attached fixes the documentation for the ``!'' and ``R'' packets:
o ``!'' does return OK
o ``R'' doesn't return at all
I think these tweeks are pretty straight forward.
Andrew
2001-06-14 Andrew Cagney <ac131313@redhat.com>
* gdb.texinfo (Remote Protocol): Document that the ``!'' packet
returns ``OK''. Document that the ``R'' packet does not reply.
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.39
diff -p -r1.39 gdb.texinfo
*** gdb.texinfo 2001/06/13 08:40:22 1.39
--- gdb.texinfo 2001/06/14 22:03:58
*************** their corresponding response @var{data}:
*** 9778,9794 ****
@tab Request
@tab Description
! @item extended ops
@tab @code{!}
@tab
! Use the extended remote protocol. Sticky---only needs to be set once.
! The extended remote protocol supports the @samp{R} packet.
@item
! @tab reply @samp{}
@tab
! Stubs that support the extended remote protocol return @samp{} which,
! unfortunately, is identical to the response returned by stubs that do not
! support protocol extensions.
@item last signal
@tab @code{?}
--- 9778,9793 ----
@tab Request
@tab Description
! @item extended mode
@tab @code{!}
@tab
! Enable extended mode. In extended mode, the remote server is made
! persistent. The (@samp{R}) packet is used to restart the program being
! debugged.
@item
! @tab reply @samp{OK}
@tab
! The remote target both supports and has enabled extended mode.
@item last signal
@tab @code{?}
*************** Reset the entire system.
*** 10080,10089 ****
@item remote restart
@tab @code{R}@var{XX}
@tab
! Restart the remote server. @var{XX} while needed has no clear
! definition. FIXME: @emph{An example interaction explaining how this
! packet is used in extended-remote mode is needed}.
@item step
@tab @code{s}@var{addr}
--- 10079,10092 ----
@item remote restart
@tab @code{R}@var{XX}
+ @tab
+ Restart the program being debugged. @var{XX}, while needed, is ignored.
+ This packet is only available in extended mode.
+ @item
+ @tab
+ no reply
@tab
! The @samp{R} packet has no reply.
@item step
@tab @code{s}@var{addr}