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

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

Commit Message

Pedro Franco de Carvalho via Gdb-patches July 5, 2020, 10:58 p.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 6, 2020, 2:26 a.m. | #1
> From: Kevin Buettner <kevinb@redhat.com>

> Cc: Kevin Buettner <kevinb@redhat.com>,

> 	Eli Zaretskii <eliz@gnu.org>

> Date: Sun,  5 Jul 2020 15:58:07 -0700

> 

> 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".


Thanks, this is OK.

Patch

diff --git a/gdb/NEWS b/gdb/NEWS
index a116d62bca..fe5396b3a0 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 fbe9f850af..6e54115730 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -38526,6 +38526,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.