From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 19474 invoked by alias); 17 Jul 2013 16:27:56 -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 19430 invoked by uid 89); 17 Jul 2013 16:27:56 -0000 X-Spam-SWARE-Status: No, score=-4.1 required=5.0 tests=AWL,BAYES_40,KHOP_RCVD_UNTRUST,KHOP_THREADED,RCVD_IN_HOSTKARMA_W,RCVD_IN_HOSTKARMA_WL,RDNS_NONE autolearn=no version=3.3.1 Received: from Unknown (HELO mga03.intel.com) (143.182.124.21) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Wed, 17 Jul 2013 16:27:55 +0000 Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by azsmga101.ch.intel.com with ESMTP; 17 Jul 2013 09:27:47 -0700 X-ExtLoop1: 1 Received: from irvmail001.ir.intel.com ([163.33.26.43]) by fmsmga001.fm.intel.com with ESMTP; 17 Jul 2013 09:27:46 -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 r6HGRja2027831; Wed, 17 Jul 2013 17:27:45 +0100 Received: from ulslx001.iul.intel.com (localhost [127.0.0.1]) by ulslx001.iul.intel.com with ESMTP id r6HGRj5g000963; Wed, 17 Jul 2013 18:27:45 +0200 Received: (from nblanc@localhost) by ulslx001.iul.intel.com with id r6HGRjvP000958; Wed, 17 Jul 2013 18:27:45 +0200 From: Nicolas Blanc To: gdb-patches@sourceware.org, dje@google.com Cc: nicolas.blanc@intel.com Subject: [PATCH v12 2/5] Documentation for the remove-symbol-file command. Date: Wed, 17 Jul 2013 16:27:00 -0000 Message-Id: <1374078455-906-3-git-send-email-nicolas.blanc@intel.com> In-Reply-To: <1374078455-906-1-git-send-email-nicolas.blanc@intel.com> References: <1374078455-906-1-git-send-email-nicolas.blanc@intel.com> X-SW-Source: 2013-07/txt/msg00391.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 e469f1e..b8a1a68 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -32,6 +32,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 remote trace-status-packet diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index fae54e4..b4f08bc 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -16513,8 +16513,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 @@ -16552,6 +16553,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