This is the mail archive of the gdb@sources.redhat.com mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

[Fwd: [patch] Fix doco for ``!'' and ``R'' packets]


FYI,

When comming up with this patch I was grubbing around and trying to 
understand gdbserver (gdbserver is at present the nearest thing we have 
to a reference implementation of the protocol).

The thing I noticed was that, the ``!'' packet tells the remote server 
to _NOT_ exit.  I know of one gdb server implementation that uses 
options to control this, the options are not needed and ``!'' should 
probably be used instead.

The only thing to fix (per TODO) is to merge ``remote'' and 
``extended-remote'' and try to use what was refered to as 
extended-remote by default.

	Andrew


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}



Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]