public inbox for gdb-patches@sourceware.org
 help / color / mirror / Atom feed
From: Sergio Lopez <slp@redhat.com>
To: gdb-patches@sourceware.org
Cc: Sergio Lopez <slp@redhat.com>
Subject: [PATCH v3 2/5] Document new {set,show} dump-excluded-mappings commands.
Date: Mon, 04 Dec 2017 08:18:00 -0000	[thread overview]
Message-ID: <20171204081716.5414-3-slp@redhat.com> (raw)
In-Reply-To: <20171204081716.5414-1-slp@redhat.com>

gdb/ChangeLog:
2017-11-29  Sergio Lopez  <slp@redhat.com>

	* NEWS (Changes since GDB 8.0): Announce {set,show}
	dump_excluded_mappings commands.

gdb/doc/ChangeLog:
2017-11-29  Sergio Lopez  <slp@redhat.com>

	* 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
-- 
2.14.3

  parent reply	other threads:[~2017-12-04  8:18 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-12-04  8:18 [PATCH v3 0/5] Enable the user to dump all memory regions Sergio Lopez
2017-12-04  8:18 ` [PATCH v3 3/5] Implement "-a" command line option for gcore Sergio Lopez
2017-12-04  8:18 ` [PATCH v3 1/5] Implement 'set dump-excluded-mappings' command Sergio Lopez
2017-12-04  8:18 ` Sergio Lopez [this message]
2017-12-04 15:19   ` [PATCH v3 2/5] Document new {set,show} dump-excluded-mappings commands Eli Zaretskii
2017-12-04  8:26 ` [PATCH v3 4/5] Document the new "-a" command line option for gcore Sergio Lopez
2017-12-04 15:25   ` Eli Zaretskii
2017-12-04 17:10     ` Sergio Durigan Junior
2017-12-04  8:27 ` [PATCH v3 5/5] Extend gdb.core/coredump-filter.exp to test dump-excluded-mappings Sergio Lopez
2017-12-04 14:37 ` [PATCH v3 0/5] Enable the user to dump all memory regions Pedro Alves
2017-12-04 17:09   ` Sergio Durigan Junior

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20171204081716.5414-3-slp@redhat.com \
    --to=slp@redhat.com \
    --cc=gdb-patches@sourceware.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).