From: Kevin Buettner <kevinb@redhat.com>
Date: Sat, 4 Jul 2020 05:09:20 +0000 (-0700)
Subject: Add documentation for "maint print core-file-backed-mappings"
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=b089853a22ce53c4051ebe2b336afb442fe3e278;p=binutils-gdb.git

Add documentation for "maint print core-file-backed-mappings"

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

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 2a7ffde1f76..7ba156188a6 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,8 @@
+2020-07-22  Kevin Buettner  <kevinb@redhat.com>
+
+	* NEWS (New commands): Mention new command
+	"maintenance print core-file-backed-mappings".
+
 2020-07-22  Kevin Buettner  <kevinb@redhat.com>
 
 	* corelow.c (gdbcmd.h): Include.
diff --git a/gdb/NEWS b/gdb/NEWS
index 001dc5e4683..ff0624ce6eb 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/ChangeLog b/gdb/doc/ChangeLog
index 208c1c406ba..7e530c04475 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2020-07-22  Kevin Buettner  <kevinb@redhat.com>
+
+	* gdb.texinfo (Maintenance Commands): Add documentation for
+	new command "maintenance print core-file-backed-mappings".
+
 2020-07-22  Reuben Thomas  <rrt@sc3d.org>
 
 	* gdb.texinfo (Remote Protocol, Overview): Correct the description
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 3bd8ddfd624..1b9f76573b9 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.