[v5,13/14] Add documentation for "maint print core-file-backed-mappings"

Message ID 20200722005832.863276-14-kevinb@redhat.com
State New
Headers show
Series
  • Fix BZ 25631 - core file memory access problem
Related show

Commit Message

Christian Biesinger via Gdb-patches July 22, 2020, 12:58 a.m.
gdb/ChangeLog:

	* NEWS (New commands): Mention new command
	"maintenance print core-file-backed-mappings".

gdb/doc/ChangeLog:

	* gdb.texinfo (Maintenance Commands): Add documentation for
	new command "maintenance print core-file-backed-mappings".
---
 gdb/NEWS            | 4 ++++
 gdb/doc/gdb.texinfo | 8 ++++++++
 2 files changed, 12 insertions(+)

-- 
2.26.2

Comments

Eli Zaretskii July 22, 2020, 2:27 a.m. | #1
> Date: Tue, 21 Jul 2020 17:58:31 -0700

> From: Kevin Buettner via Gdb-patches <gdb-patches@sourceware.org>

> 

> gdb/ChangeLog:

> 

> 	* NEWS (New commands): Mention new command

> 	"maintenance print core-file-backed-mappings".

> 

> gdb/doc/ChangeLog:

> 

> 	* gdb.texinfo (Maintenance Commands): Add documentation for

> 	new command "maintenance print core-file-backed-mappings".


This is OK, thanks.

Patch

diff --git a/gdb/NEWS b/gdb/NEWS
index 001dc5e468..ff0624ce6e 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -85,6 +85,10 @@  maintenance print xml-tdesc [FILE]
   the target description is read from FILE into GDB, and then
   reprinted.
 
+maintenance print core-file-backed-mappings
+  Prints file-backed mappings loaded from a core file's note section.
+  Output is expected to be similar to that of "info proc mappings".
+
 * Changed commands
 
 alias [-a] [--] ALIAS = COMMAND [DEFAULT-ARGS...]
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index a002084d5b..b1dc6c0998 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -38532,6 +38532,14 @@  library.  This exercises all @code{libthread_db} functionality used by
 @code{libthread_db} uses.  Note that parts of the test may be skipped
 on some platforms when debugging core files.
 
+@kindex maint print core-file-backed-mappings
+@cindex memory address space mappings
+@item maint print core-file-backed-mappings
+Print the file-backed mappings which were loaded from a core file note.
+This output represents state internal to @value{GDBN} and should be
+similar to the mappings displayed by the @code{info proc mappings}
+command.
+
 @kindex maint print dummy-frames
 @item maint print dummy-frames
 Prints the contents of @value{GDBN}'s internal dummy-frame stack.