This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
[patch v4 3/3] Documentation for the remove-symbol-file command.
- From: Nicolas Blanc <nicolas dot blanc at intel dot com>
- To: gdb-patches at sourceware dot org, palves at redhat dot com, tromey at redhat dot com, eliz at gnu dot org, yao at codesourcery dot com
- Cc: nicolas dot blanc at intel dot com
- Date: Wed, 29 May 2013 11:13:25 +0200
- Subject: [patch v4 3/3] Documentation for the remove-symbol-file command.
- References: <1369818805-14288-1-git-send-email-nicolas dot blanc at intel dot com>
2013-04-05 Nicolas Blanc <nicolas.blanc@intel.com>
* NEWS: Add description of the remove-symbol-file command.
gdb/doc
* gdb.texinfo (Commands to Specify Files): Add description
of the remove-symbol-file command.
Signed-off-by: Nicolas Blanc <nicolas.blanc@intel.com>
---
gdb/NEWS | 5 +++++
gdb/doc/gdb.texinfo | 31 +++++++++++++++++++++++++++++--
2 files changed, 34 insertions(+), 2 deletions(-)
diff --git a/gdb/NEWS b/gdb/NEWS
index a23e8e3..34b4abf 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -31,6 +31,11 @@ maint set|show per-command time
maint set|show per-command symtab
Enable display of per-command gdb resource usage.
+remove-symbol-file ADDR
+ Remove all symbol information about the file loaded at the specified
+ address. The address must match the beginning of the text section
+ of a file added by the user via the `add-symbol-file' command.
+
* New options
set remote trace-status-packet
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index ead00b4..f347e12 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -16511,8 +16511,10 @@ section name and base address for that section. You can specify any
The symbol table of the file @var{filename} is added to the symbol table
originally read with the @code{symbol-file} command. You can use the
@code{add-symbol-file} command any number of times; the new symbol data
-thus read keeps adding to the old. To discard all old symbol data
-instead, use the @code{symbol-file} command without any arguments.
+thus read keeps adding to the old.
+
+Changes can be reverted using the command @code{remove-symbol-file},
+which takes as parameter the load address of the file to remove.
@cindex relocatable object files, reading symbols from
@cindex object files, relocatable, reading symbols from
@@ -16550,6 +16552,31 @@ way.
@code{add-symbol-file} does not repeat if you press @key{RET} after using it.
+@kindex remove-symbol-file
+@item remove-symbol-file @var{address}
+The @code{remove-symbol-file} command removes all symbol information about
+the file loaded at @var{address}. @var{address} must be an expression that
+represents the address of the text section of a file added by the user via
+the @code{add-symbol-file} command. In other words, the file to remove is
+identified by the first address parameter of the @code{add-symbol-file}
+command:
+
+@smallexample
+(gdb) add-symbol-file /home/user/gdb/mylib.so 0x7ffff7ff9480
+add symbol table from file "/home/user/gdb/mylib.so" at
+ .text_addr = 0x7ffff7ff9480
+(y or n) y
+Reading symbols from /home/user/gdb/mylib.so...done.
+(gdb) remove-symbol-file 0x7ffff7ff9480
+Remove symbol table from file "/home/user/gdb/mylib.so" at\
+ .text_addr = 0x7ffff7ff9480
+(y or n) y
+(gdb)
+@end smallexample
+
+
+@code{remove-symbol-file} does not repeat if you press @key{RET} after using it.
+
@kindex add-symbol-file-from-memory
@cindex @code{syscall DSO}
@cindex load symbols from memory
--
1.7.6.5