From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 8644 invoked by alias); 29 May 2013 09:13:57 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 8620 invoked by uid 89); 29 May 2013 09:13:57 -0000 X-Spam-SWARE-Status: No, score=-6.4 required=5.0 tests=AWL,BAYES_00,KHOP_RCVD_UNTRUST,KHOP_THREADED,RCVD_IN_HOSTKARMA_W,RCVD_IN_HOSTKARMA_WL,RP_MATCHES_RCVD autolearn=ham version=3.3.1 Received: from mga01.intel.com (HELO mga01.intel.com) (192.55.52.88) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Wed, 29 May 2013 09:13:56 +0000 Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga101.fm.intel.com with ESMTP; 29 May 2013 02:13:54 -0700 X-ExtLoop1: 1 Received: from irvmail001.ir.intel.com ([163.33.26.43]) by fmsmga001.fm.intel.com with ESMTP; 29 May 2013 02:13:49 -0700 Received: from ulslx001.iul.intel.com (ulslx001.iul.intel.com [172.28.207.63]) by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id r4T9Dan7011442; Wed, 29 May 2013 10:13:36 +0100 Received: from ulslx001.iul.intel.com (localhost [127.0.0.1]) by ulslx001.iul.intel.com with ESMTP id r4T9DaOZ014349; Wed, 29 May 2013 11:13:36 +0200 Received: (from nblanc@localhost) by ulslx001.iul.intel.com with id r4T9DaxT014345; Wed, 29 May 2013 11:13:36 +0200 From: Nicolas Blanc To: gdb-patches@sourceware.org, palves@redhat.com, tromey@redhat.com, eliz@gnu.org, yao@codesourcery.com Cc: nicolas.blanc@intel.com Subject: [patch v4 3/3] Documentation for the remove-symbol-file command. Date: Wed, 29 May 2013 09:13:00 -0000 Message-Id: <1369818805-14288-4-git-send-email-nicolas.blanc@intel.com> In-Reply-To: <1369818805-14288-1-git-send-email-nicolas.blanc@intel.com> References: <1369818805-14288-1-git-send-email-nicolas.blanc@intel.com> X-SW-Source: 2013-05/txt/msg00982.txt.bz2 2013-04-05 Nicolas Blanc * 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 --- 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