From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4731 invoked by alias); 7 Oct 2013 12:27:09 -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 4704 invoked by uid 89); 7 Oct 2013 12:27:09 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-2.3 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-HELO: mga09.intel.com Received: from mga09.intel.com (HELO mga09.intel.com) (134.134.136.24) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 07 Oct 2013 12:27:08 +0000 Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga102.jf.intel.com with ESMTP; 07 Oct 2013 05:23:54 -0700 X-ExtLoop1: 1 Received: from irvmail001.ir.intel.com ([163.33.26.43]) by orsmga002.jf.intel.com with ESMTP; 07 Oct 2013 05:27:06 -0700 Received: from ulvlx001.iul.intel.com (ulvlx001.iul.intel.com [172.28.207.17]) by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id r97CR5eP020256; Mon, 7 Oct 2013 13:27:05 +0100 Received: from ulvlx001.iul.intel.com (localhost [127.0.0.1]) by ulvlx001.iul.intel.com with ESMTP id r97CR5c3021946; Mon, 7 Oct 2013 14:27:05 +0200 Received: (from nblanc@localhost) by ulvlx001.iul.intel.com with œ id r97CR5V8021942; Mon, 7 Oct 2013 14:27:05 +0200 From: Nicolas Blanc To: gdb-patches@sourceware.org Cc: nicolas.blanc@intel.com Subject: [PATCH v16 2/5] Documentation for the remove-symbol-file command. Date: Mon, 07 Oct 2013 12:27:00 -0000 Message-Id: <1381148820-21890-3-git-send-email-nicolas.blanc@intel.com> In-Reply-To: <1381148820-21890-1-git-send-email-nicolas.blanc@intel.com> References: <1381148820-21890-1-git-send-email-nicolas.blanc@intel.com> X-IsSubscribed: yes X-SW-Source: 2013-10/txt/msg00182.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 | 6 ++++++ gdb/doc/gdb.texinfo | 26 ++++++++++++++++++++++++-- 2 files changed, 30 insertions(+), 2 deletions(-) diff --git a/gdb/NEWS b/gdb/NEWS index 8114fb1..d9e7b2c 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -74,6 +74,12 @@ maint set|show per-command time maint set|show per-command symtab Enable display of per-command gdb resource usage. +remove-symbol-file FILENAME +remove-symbol-file -a ADDRESS + Remove a symbol file added via add-symbol-file. The file to remove + can be identified by its filename or by an address that lies within + the boundaries of this symbol file in memory. + * New options set debug symfile off|on diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 7ec91d8..2099a15 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -16672,8 +16672,9 @@ 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 is kept in addition to the old. + +Changes can be reverted using the command @code{remove-symbol-file}. @cindex relocatable object files, reading symbols from @cindex object files, relocatable, reading symbols from @@ -16711,6 +16712,27 @@ 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{filename} +@item remove-symbol-file -a @var{address} +Remove a symbol file added via the @code{add-symbol-file} command. The +file to remove can be identified by its @var{filename} or by an @var{address} +that lies within the boundaries of this symbol file in memory. Example: + +@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 -a 0x7ffff7ff9480 +Remove symbol table from file "/home/user/gdb/mylib.so"? (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