[3/4,REPOST] Document RSP support for Linux exec events

Message ID 1398885482-8449-4-git-send-email-donb@codesourcery.com
State Committed
Headers

Commit Message

Don Breazeal April 30, 2014, 7:18 p.m. UTC
  From: Don Breazeal <don_breazeal@mentor.com>

[Reposting to eliminate unexpected attachment type.]

This patch adds documentation of the new RSP support for exec events.

This patch was approved 4/4/2014 per this email:
> -----Original Message-----
> From: Eli Zaretskii [mailto:eliz@gnu.org]
> Sent: Wednesday, April 02, 2014 7:50 PM
> To: Breazeal, Don
> Cc: gdb-patches@sourceware.org
> Subject: Re: [PATCH 3/4] Document RSP support for exec events
>
> > From: "Breazeal, Don" <donb@codesourcery.com>
> > Date: Wed, 2 Apr 2014 22:24:18 +0000
> >
> > This patch adds documentation of the new RSP support for exec events.
>
> Thanks.
>
> > doc/
> > 2014-04-02  Don Breazeal  <donb@codesourcery.com>
> >
> >         * gdb.texinfo: Document RSP support for exec events.
>
> Please state the name of the node where you make the change.
>
> > +@cindex exec events, remote reply
> > +@item exec
> > +The packet indicates that execve was called, and @var{r} is the
> > +absolute pathname of the file that was executed, in hex.  This is
> > +only applicable to certain targets.
> > +
>
> "execve" should be in @code, as it is a C symbol.
>
> OK with that change.

doc/
2014-04-03  Don Breazeal  <donb@codesourcery.com>

	* gdb.texinfo (Stop Reply Packets): Document RSP support
	for exec events. 

---
 gdb/doc/gdb.texinfo |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)
  

Comments

Yao Qi May 8, 2014, 5:32 a.m. UTC | #1
On 05/01/2014 03:18 AM, Don Breazeal wrote:
> This patch adds documentation of the new RSP support for exec events.

The RSP change is user-visible, so we need an entry in NEWS for it, like

* New remote packets

Extend stop reasons in stop rely packets for exec event.

This patch series implements the support for exec events in gdbserver
on GNU/Linux, which should be mentioned in NEWS too, IMO.
  

Patch

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index b218769..bb9dfb8 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -34582,6 +34582,12 @@  The packet indicates that the loaded libraries have changed.
 @value{GDBN} should use @samp{qXfer:libraries:read} to fetch a new
 list of loaded libraries.  @var{r} is ignored.
 
+@cindex exec events, remote reply
+@item exec
+The packet indicates that @code{execve} was called, and @var{r} is the
+absolute pathname of the file that was executed, in hex.  This is
+only applicable to certain targets.
+
 @cindex replay log events, remote reply
 @item replaylog
 The packet indicates that the target cannot continue replaying