This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
[PATCH 9/9] Improve function comment for lookup_global_symbol.
- From: Doug Evans <xdje42 at gmail dot com>
- To: gdb-patches at sourceware dot org
- Date: Sun, 26 Oct 2014 22:03:04 -0700
- Subject: [PATCH 9/9] Improve function comment for lookup_global_symbol.
- Authentication-results: sourceware.org; auth=none
Hi.
The BLOCK argument to lookup_global_symbol is not documented.
2014-10-26 Doug Evans <xdje42@gmail.com>
* 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. */