This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
[PATCH 5/7] DOC and NEWS
- From: Yao Qi <yao at codesourcery dot com>
- To: <gdb-patches at sourceware dot org>
- Date: Sun, 8 Sep 2013 20:03:25 +0800
- Subject: [PATCH 5/7] DOC and NEWS
- Authentication-results: sourceware.org; auth=none
- References: <1378432920-7731-1-git-send-email-yao at codesourcery dot com> <1378641807-24256-1-git-send-email-yao at codesourcery dot com>
The doc and NEWS patch was reviewed by Eli here
https://sourceware.org/ml/gdb-patches/2013-09/msg00214.html
gdb:
2013-09-08 Yao Qi <yao@codesourcery.com>
* NEWS: Describe the default option of
"trust-readonly-sections" becomes "auto" and the related
changes.
gdb/doc:
2013-09-08 Yao Qi <yao@codesourcery.com>
* gdb.texinfo (File): Mention that user has
'set trust-readonly-sections off' to get updated contents if
they are modified. Explain the default option of
"trust-readonly-sections" is "auto".
---
gdb/NEWS | 5 +++++
gdb/doc/gdb.texinfo | 11 +++++++++--
2 files changed, 14 insertions(+), 2 deletions(-)
diff --git a/gdb/NEWS b/gdb/NEWS
index ad97f6f..e60a553 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -3,6 +3,11 @@
*** Changes since GDB 7.6
+* The default value of option "trust-readonly-sections" is "auto". GDB
+ will decide based on the target memory protection features whether to
+ read readonly sections from object file instead of from the inferior's
+ memory.
+
* The "maintenance print objfiles" command now takes an optional regexp.
* The "catch syscall" command now works on arm*-linux* targets.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 21250fe..cd7859a 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -16673,12 +16673,19 @@ out of the object file, rather than from the target program.
For some targets (notably embedded ones), this can be a significant
enhancement to debugging performance.
-The default is off.
+@item set trust-readonly-sections auto
+This is the default mode. @value{GDBN} will decide based on the
+target memory protection features whether to read readonly sections
+from object file instead of from the inferior's memory, because the
+contents of the section in the inferior can't change.
@item set trust-readonly-sections off
Tell @value{GDBN} not to trust readonly sections. This means that
the contents of the section might change while the program is running,
-and must therefore be fetched from the target when needed.
+and must therefore be fetched from the target when needed. If you
+modified the code in the target program, you have to
+@code{set trust-readonly-sections off} to guarantee @value{GDBN} reads
+updated contents from the target program instead of object file.
@item show trust-readonly-sections
Show the current setting of trusting readonly sections.
--
1.7.7.6