From 1e52e8495a074c9d1f7ef17f13b9060b76be6f41 Mon Sep 17 00:00:00 2001 From: Sergio Lopez Date: Mon, 4 Dec 2017 09:17:13 +0100 Subject: [PATCH] Document new {set,show} dump-excluded-mappings commands. 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 7ca626252f3..86fcbd90a2e 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -185,6 +185,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 689025feabd..1039f4c27bb 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -11594,7 +11594,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} @@ -11624,6 +11626,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.30.2