[15/16,v3] Extended-remote exec event documentation
Commit Message
This patch adds documentation of the new RSP support for exec events.
[This was previously approved by Eli:
https://sourceware.org/ml/gdb-patches/2014-05/msg00690.html]
Thanks
--Don
gdb/
2014-10-31 Don Breazeal <donb@codesourcery.com>
* NEWS: Mention RSP Stop Reply Packet, new stop reason 'exec'.
Mention gdbserver support for exec events on Linux.
gdb/doc/
2014-10-31 Don Breazeal <donb@codesourcery.com>
* gdb.texinfo (Stop Reply Packets): Document RSP support
for exec events.
---
gdb/NEWS | 21 ++++++++++++---------
gdb/doc/gdb.texinfo | 9 ++++++++-
2 files changed, 20 insertions(+), 10 deletions(-)
@@ -59,20 +59,23 @@ SGI Irix-6.x mips-*-irix6*
VAX running (4.2 - 4.3 Reno) BSD vax-*-bsd*
VAX running Ultrix vax-*-ultrix*
-* Remote fork events
+* Remote fork and exec events
- GDBserver extended-remote Linux targets now support fork events.
- This enables follow-fork-mode, detach-on-fork, catch fork, and
- catch vfork for those targets with Linux kernels 2.5.60 and later.
+ GDBserver extended-remote Linux targets now support fork and exec
+ events. This enables follow-fork-mode, detach-on-fork, follow-exec-mode,
+ catch fork, catch vfork, and catch exec for those targets with Linux
+ kernels that support these events. Linux kernel versions 2.5.60 and
+ later support all of these events.
* New remote packets
T Stop Reply Packet's reason
- The T stop reply packet supports new stop reasons 'fork', 'vfork'
- and 'vforkdone'. The 'fork' and 'vfork' reasons signify that the
- specified inferior has executed a fork or vfork. The 'vforkdone'
- reason signifies that a vforked child process has executed either
- an exec or an exit.
+ The T stop reply packet supports new stop reasons 'fork', 'vfork',
+ 'vforkdone', and 'exec'. The 'fork' and 'vfork' reasons signify
+ that the specified inferior has executed a fork or vfork. The
+ 'vforkdone' reason signifies that a vforked child process has
+ executed either an exec or an exit. The 'exec' reason signifies
+ that the specified inferior executed a call to execve.
*** Changes in GDB 7.8
@@ -3196,7 +3196,8 @@ process, use the @code{file} command with the parent executable name
as its argument. By default, after an @code{exec} call executes,
@value{GDBN} discards the symbols of the previous executable image.
You can change this behaviour with the @w{@code{set follow-exec-mode}}
-command.
+command. This command is supported when connected to @code{gdbserver}
++using @kbd{target extended-remote} as well as in native mode.
@table @code
@kindex set follow-exec-mode
@@ -34725,6 +34726,12 @@ address spaces of the parent and child process are no longer
shared. The @var{r} part is ignored. This packet is only
applicable to targets that support vforkdone events.
+@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 packet
+is only applicable to targets that support exec events.
+
@cindex replay log events, remote reply
@item replaylog
The packet indicates that the target cannot continue replaying