From patchwork Mon Dec 4 08:17:13 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sergio Lopez X-Patchwork-Id: 24704 Received: (qmail 105053 invoked by alias); 4 Dec 2017 08:18:15 -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 104635 invoked by uid 89); 4 Dec 2017 08:17:37 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-26.9 required=5.0 tests=BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, SPF_HELO_PASS, T_RP_MATCHES_RCVD autolearn=ham version=3.3.2 spammy= X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 04 Dec 2017 08:17:36 +0000 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 6DCE15CB for ; Mon, 4 Dec 2017 08:17:35 +0000 (UTC) Received: from dritchie.redhat.com (ovpn-117-55.ams2.redhat.com [10.36.117.55]) by smtp.corp.redhat.com (Postfix) with ESMTP id DA81B6FDC1; Mon, 4 Dec 2017 08:17:33 +0000 (UTC) From: Sergio Lopez To: gdb-patches@sourceware.org Cc: Sergio Lopez Subject: [PATCH v3 2/5] Document new {set, show} dump-excluded-mappings commands. Date: Mon, 4 Dec 2017 09:17:13 +0100 Message-Id: <20171204081716.5414-3-slp@redhat.com> In-Reply-To: <20171204081716.5414-1-slp@redhat.com> References: <20171204081716.5414-1-slp@redhat.com> gdb/ChangeLog: 2017-11-29 Sergio Lopez * NEWS (Changes since GDB 8.0): Announce {set,show} dump_excluded_mappings commands. gdb/doc/ChangeLog: 2017-11-29 Sergio Lopez * gdb.texinfo (gcore): Mention new {set,show} dump-excluded-mappings commands. (set dump-excluded-mappings): Document new command. --- gdb/NEWS | 5 +++++ gdb/doc/gdb.texinfo | 14 +++++++++++++- 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/gdb/NEWS b/gdb/NEWS index 754ce103bd..1372552a37 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -134,6 +134,11 @@ set debug separate-debug-file show debug separate-debug-file Control the display of debug output about separate debug file search. +set dump-excluded-mappings +show dump-excluded-mappings + Control whether mappings marked with the VM_DONTDUMP flag should be + dumped when generating a core file. + maint info selftests List the registered selftests. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 675f6e7bc8..7b25912e49 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -11543,7 +11543,9 @@ this writing, @sc{gnu}/Linux, FreeBSD, Solaris, and S390). On @sc{gnu}/Linux, this command can take into account the value of the file @file{/proc/@var{pid}/coredump_filter} when generating the core -dump (@pxref{set use-coredump-filter}). +dump (@pxref{set use-coredump-filter}), and by default honors the +@code{VM_DONTDUMP} flag for mappings where it is present in the file +@file{/proc/@var{pid}/smaps} (@pxref{set dump-excluded-mappings}). @kindex set use-coredump-filter @anchor{set use-coredump-filter} @@ -11573,6 +11575,16 @@ value is currently @code{0x33}, which means that bits @code{0} (anonymous private mappings), @code{1} (anonymous shared mappings), @code{4} (ELF headers) and @code{5} (private huge pages) are active. This will cause these memory mappings to be dumped automatically. + +@kindex set dump-excluded-mappings +@anchor{set dump-excluded-mappings} +@item set dump-excluded-mappings on +@itemx set dump-excluded-mappings off +If @code{on} is specified, @value{GDBN} will dump memory mappings +marked with the @code{VM_DONTDUMP} flag. This flag is represented in +the file @file{/proc/@var{pid}/smaps} with the acronym @code{dd}. + +The default value is @code{off}. @end table @node Character Sets