From patchwork Mon Oct 27 05:03:04 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Doug Evans X-Patchwork-Id: 3400 Received: (qmail 9788 invoked by alias); 27 Oct 2014 05:03:55 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 9777 invoked by uid 89); 27 Oct 2014 05:03:54 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL, BAYES_00, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, SPF_PASS autolearn=ham version=3.3.2 X-HELO: mail-pd0-f173.google.com Received: from mail-pd0-f173.google.com (HELO mail-pd0-f173.google.com) (209.85.192.173) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-SHA encrypted) ESMTPS; Mon, 27 Oct 2014 05:03:54 +0000 Received: by mail-pd0-f173.google.com with SMTP id v10so4925755pde.32 for ; Sun, 26 Oct 2014 22:03:52 -0700 (PDT) X-Received: by 10.66.120.176 with SMTP id ld16mr22225741pab.86.1414386232351; Sun, 26 Oct 2014 22:03:52 -0700 (PDT) Received: from seba.sebabeach.org.gmail.com (173-13-178-50-sfba.hfc.comcastbusiness.net. [173.13.178.50]) by mx.google.com with ESMTPSA id r9sm9632717pdl.60.2014.10.26.22.03.51 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 26 Oct 2014 22:03:51 -0700 (PDT) From: Doug Evans To: gdb-patches@sourceware.org Subject: [PATCH 9/9] Improve function comment for lookup_global_symbol. Date: Sun, 26 Oct 2014 22:03:04 -0700 Message-ID: MIME-Version: 1.0 X-IsSubscribed: yes Hi. The BLOCK argument to lookup_global_symbol is not documented. 2014-10-26 Doug Evans * symtab.h (lookup_global_symbol): Improve function comment. diff --git a/gdb/symtab.h b/gdb/symtab.h index c967c62..9b3ea80 100644 --- a/gdb/symtab.h +++ b/gdb/symtab.h @@ -1104,6 +1104,14 @@ extern struct symbol *lookup_static_symbol (const char *name, const domain_enum domain); /* Lookup a symbol in all files' global blocks. + + If BLOCK is non-NULL then it is used for two things: + 1) If a target-specific lookup routine for libraries exists, then use the + routine for the objfile of BLOCK, and + 2) The objfile of BLOCK is used to assist in determining the search order + if the target requires it. + See gdbarch_iterate_over_objfiles_in_search_order. + Upon success sets BLOCK_FOUND and fixes up the symbol's section if necessary. */