From patchwork Wed Jul 15 21:49:39 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Don Breazeal X-Patchwork-Id: 7711 Received: (qmail 21983 invoked by alias); 15 Jul 2015 21:51:27 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 21972 invoked by uid 89); 15 Jul 2015 21:51:27 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.2 required=5.0 tests=AWL, BAYES_00, RCVD_IN_DNSWL_LOW, SPF_PASS autolearn=ham version=3.3.2 X-HELO: relay1.mentorg.com Received: from relay1.mentorg.com (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 15 Jul 2015 21:51:26 +0000 Received: from svr-orw-fem-06.mgc.mentorg.com ([147.34.97.120]) by relay1.mentorg.com with esmtp id 1ZFUaJ-0000qm-4P from Don_Breazeal@mentor.com ; Wed, 15 Jul 2015 14:51:23 -0700 Received: from build4-lucid-cs (147.34.91.1) by SVR-ORW-FEM-06.mgc.mentorg.com (147.34.97.120) with Microsoft SMTP Server id 14.3.224.2; Wed, 15 Jul 2015 14:51:22 -0700 Received: by build4-lucid-cs (Postfix, from userid 1905) id 629ED40F0A; Wed, 15 Jul 2015 14:51:23 -0700 (PDT) From: Don Breazeal To: , Subject: [PATCH 5/5] Extended-remote exec event docs Date: Wed, 15 Jul 2015 14:49:39 -0700 Message-ID: <1436996979-32350-6-git-send-email-donb@codesourcery.com> In-Reply-To: <1436996979-32350-1-git-send-email-donb@codesourcery.com> References: <1436996979-32350-1-git-send-email-donb@codesourcery.com> MIME-Version: 1.0 X-IsSubscribed: yes This patch adds documentation of support for exec events on extended-remote Linux targets. Thanks, --Don 2015-07-15 Don Breazeal * gdb/NEWS: Announce new remote packets for the exec-events feature and the exec-events feature. * gdb/doc/gdb.texinfo (Remote Configuration): Add exec event feature to table of packet settings. (Stop Reply Packets): Add exec events to the list of stop reasons. (General Query Packets): Add exec events to tables of 'gdbfeatures' and 'stub features' supported in the qSupported packet, as well as to the list containing stub feature details. --- gdb/NEWS | 17 +++++++++++++++++ gdb/doc/gdb.texinfo | 30 ++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+) diff --git a/gdb/NEWS b/gdb/NEWS index 7ce9758..87e1ad4 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -5,6 +5,23 @@ * Support for tracepoints on aarch64-linux was added in GDBserver. +* New remote packets + +exec stop reason + Indicates that an exec system call was executed. + +exec-events feature in qSupported + The qSupported packet allows GDB to request support for exec + events using the new 'gdbfeature' exec-event, and the qSupported + response can contain the corresponding 'stubfeature'. Set and + show commands can be used to display whether these features are enabled. + +* Extended-remote exec events + + ** GDB now has support for exec events on extended-remote Linux targets. + For such targets with Linux kernels 2.5.46 and later, this enables + follow-exec-mode and exec catchpoints. + *** Changes in GDB 7.10 * Support for process record-replay and reverse debugging on aarch64*-linux* diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 9e2ecd1..5970782 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -20022,6 +20022,10 @@ are: @tab @code{vfork stop reason} @tab @code{vfork} +@item @code{exec-event-feature} +@tab @code{exec stop reason} +@tab @code{exec} + @end multitable @node Remote Stub @@ -35655,6 +35659,18 @@ appropriate @samp{qSupported} feature (@pxref{qSupported}). The remote stub must also supply the appropriate @samp{qSupported} feature indicating support. +@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. + +This packet should not be sent by default; older @value{GDBN} versions +did not support it. @value{GDBN} requests it, by supplying an +appropriate @samp{qSupported} feature (@pxref{qSupported}). The +remote stub must also supply the appropriate @samp{qSupported} feature +indicating support. + @end table @item W @var{AA} @@ -36259,6 +36275,12 @@ This feature indicates whether @value{GDBN} supports vfork event extensions to the remote protocol. @value{GDBN} does not use such extensions unless the stub also reports that it supports them by including @samp{vfork-events+} in its @samp{qSupported} reply. + +@item exec-events +This feature indicates whether @value{GDBN} supports exec event +extensions to the remote protocol. @value{GDBN} does not use such +extensions unless the stub also reports that it supports them by +including @samp{exec-events+} in its @samp{qSupported} reply. @end table Stubs should ignore any unknown values for @@ -36522,6 +36544,11 @@ These are the currently defined stub features and their properties: @tab @samp{-} @tab No +@item @samp{exec-events} +@tab No +@tab @samp{-} +@tab No + @end multitable These are the currently defined stub features, in more detail: @@ -36727,6 +36754,9 @@ The remote stub reports the @samp{fork} stop reason for fork events. The remote stub reports the @samp{vfork} stop reason for vfork events and vforkdone events. +@item exec-events +The remote stub reports the @samp{exec} stop reason for exec events. + @end table @item qSymbol::