1 /* Symbol table lookup for the GNU debugger, GDB.
3 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994,
4 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
5 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place - Suite 330,
22 Boston, MA 02111-1307, USA. */
34 #include "call-cmds.h"
35 #include "gdb_regex.h"
36 #include "expression.h"
42 #include "filenames.h" /* for FILENAME_CMP */
43 #include "objc-lang.h"
47 #include "gdb_obstack.h"
50 #include <sys/types.h>
52 #include "gdb_string.h"
57 /* Prototypes for local functions */
59 static void completion_list_add_name (char *, char *, int, char *, char *);
61 static void rbreak_command (char *, int);
63 static void types_info (char *, int);
65 static void functions_info (char *, int);
67 static void variables_info (char *, int);
69 static void sources_info (char *, int);
71 static void output_source_filename (char *, int *);
73 static int find_line_common (struct linetable *, int, int *);
75 /* This one is used by linespec.c */
77 char *operator_chars (char *p, char **end);
79 static struct partial_symbol *lookup_partial_symbol (struct partial_symtab *,
84 static struct symbol *lookup_symbol_aux (const char *name,
85 const char *mangled_name,
86 const struct block *block,
87 const domain_enum domain,
88 int *is_a_field_of_this,
89 struct symtab **symtab);
92 struct symbol *lookup_symbol_aux_local (const char *name,
93 const char *mangled_name,
94 const struct block *block,
95 const domain_enum domain,
96 struct symtab **symtab,
97 const struct block **static_block);
100 struct symbol *lookup_symbol_aux_block (const char *name,
101 const char *mangled_name,
102 const struct block *block,
103 const domain_enum domain,
104 struct symtab **symtab);
107 struct symbol *lookup_symbol_aux_symtabs (int block_index,
109 const char *mangled_name,
110 const domain_enum domain,
111 struct symtab **symtab);
114 struct symbol *lookup_symbol_aux_psymtabs (int block_index,
116 const char *mangled_name,
117 const domain_enum domain,
118 struct symtab **symtab);
122 struct symbol *lookup_symbol_aux_minsyms (const char *name,
123 const char *mangled_name,
124 const domain_enum domain,
125 int *is_a_field_of_this,
126 struct symtab **symtab);
129 static struct symbol *find_active_alias (struct symbol *sym, CORE_ADDR addr);
131 /* This flag is used in hppa-tdep.c, and set in hp-symtab-read.c */
132 /* Signals the presence of objects compiled by HP compilers */
133 int hp_som_som_object_present = 0;
135 static void fixup_section (struct general_symbol_info *, struct objfile *);
137 static int file_matches (char *, char **, int);
139 static void print_symbol_info (domain_enum,
140 struct symtab *, struct symbol *, int, char *);
142 static void print_msymbol_info (struct minimal_symbol *);
144 static void symtab_symbol_info (char *, domain_enum, int);
146 static void overload_list_add_symbol (struct symbol *sym, char *oload_name);
148 void _initialize_symtab (void);
152 /* The single non-language-specific builtin type */
153 struct type *builtin_type_error;
155 /* Block in which the most recently searched-for symbol was found.
156 Might be better to make this a parameter to lookup_symbol and
159 const struct block *block_found;
161 /* Check for a symtab of a specific name; first in symtabs, then in
162 psymtabs. *If* there is no '/' in the name, a match after a '/'
163 in the symtab filename will also work. */
166 lookup_symtab (const char *name)
168 register struct symtab *s;
169 register struct partial_symtab *ps;
170 register struct objfile *objfile;
171 char *real_path = NULL;
172 char *full_path = NULL;
174 /* Here we are interested in canonicalizing an absolute path, not
175 absolutizing a relative path. */
176 if (IS_ABSOLUTE_PATH (name))
178 full_path = xfullpath (name);
179 make_cleanup (xfree, full_path);
180 real_path = gdb_realpath (name);
181 make_cleanup (xfree, real_path);
186 /* First, search for an exact match */
188 ALL_SYMTABS (objfile, s)
190 if (FILENAME_CMP (name, s->filename) == 0)
195 /* If the user gave us an absolute path, try to find the file in
196 this symtab and use its absolute path. */
198 if (full_path != NULL)
200 const char *fp = symtab_to_filename (s);
201 if (FILENAME_CMP (full_path, fp) == 0)
207 if (real_path != NULL)
209 char *rp = gdb_realpath (symtab_to_filename (s));
210 make_cleanup (xfree, rp);
211 if (FILENAME_CMP (real_path, rp) == 0)
218 /* Now, search for a matching tail (only if name doesn't have any dirs) */
220 if (lbasename (name) == name)
221 ALL_SYMTABS (objfile, s)
223 if (FILENAME_CMP (lbasename (s->filename), name) == 0)
227 /* Same search rules as above apply here, but now we look thru the
230 ps = lookup_partial_symtab (name);
235 error ("Internal: readin %s pst for `%s' found when no symtab found.",
238 s = PSYMTAB_TO_SYMTAB (ps);
243 /* At this point, we have located the psymtab for this file, but
244 the conversion to a symtab has failed. This usually happens
245 when we are looking up an include file. In this case,
246 PSYMTAB_TO_SYMTAB doesn't return a symtab, even though one has
247 been created. So, we need to run through the symtabs again in
248 order to find the file.
249 XXX - This is a crock, and should be fixed inside of the the
250 symbol parsing routines. */
254 /* Lookup the partial symbol table of a source file named NAME.
255 *If* there is no '/' in the name, a match after a '/'
256 in the psymtab filename will also work. */
258 struct partial_symtab *
259 lookup_partial_symtab (const char *name)
261 register struct partial_symtab *pst;
262 register struct objfile *objfile;
263 char *full_path = NULL;
264 char *real_path = NULL;
266 /* Here we are interested in canonicalizing an absolute path, not
267 absolutizing a relative path. */
268 if (IS_ABSOLUTE_PATH (name))
270 full_path = xfullpath (name);
271 make_cleanup (xfree, full_path);
272 real_path = gdb_realpath (name);
273 make_cleanup (xfree, real_path);
276 ALL_PSYMTABS (objfile, pst)
278 if (FILENAME_CMP (name, pst->filename) == 0)
283 /* If the user gave us an absolute path, try to find the file in
284 this symtab and use its absolute path. */
285 if (full_path != NULL)
287 if (pst->fullname == NULL)
288 source_full_path_of (pst->filename, &pst->fullname);
289 if (pst->fullname != NULL
290 && FILENAME_CMP (full_path, pst->fullname) == 0)
296 if (real_path != NULL)
299 if (pst->fullname == NULL)
300 source_full_path_of (pst->filename, &pst->fullname);
301 if (pst->fullname != NULL)
303 rp = gdb_realpath (pst->fullname);
304 make_cleanup (xfree, rp);
306 if (rp != NULL && FILENAME_CMP (real_path, rp) == 0)
313 /* Now, search for a matching tail (only if name doesn't have any dirs) */
315 if (lbasename (name) == name)
316 ALL_PSYMTABS (objfile, pst)
318 if (FILENAME_CMP (lbasename (pst->filename), name) == 0)
325 /* Mangle a GDB method stub type. This actually reassembles the pieces of the
326 full method name, which consist of the class name (from T), the unadorned
327 method name from METHOD_ID, and the signature for the specific overload,
328 specified by SIGNATURE_ID. Note that this function is g++ specific. */
331 gdb_mangle_name (struct type *type, int method_id, int signature_id)
333 int mangled_name_len;
335 struct fn_field *f = TYPE_FN_FIELDLIST1 (type, method_id);
336 struct fn_field *method = &f[signature_id];
337 char *field_name = TYPE_FN_FIELDLIST_NAME (type, method_id);
338 char *physname = TYPE_FN_FIELD_PHYSNAME (f, signature_id);
339 char *newname = type_name_no_tag (type);
341 /* Does the form of physname indicate that it is the full mangled name
342 of a constructor (not just the args)? */
343 int is_full_physname_constructor;
346 int is_destructor = is_destructor_name (physname);
347 /* Need a new type prefix. */
348 char *const_prefix = method->is_const ? "C" : "";
349 char *volatile_prefix = method->is_volatile ? "V" : "";
351 int len = (newname == NULL ? 0 : strlen (newname));
353 /* Nothing to do if physname already contains a fully mangled v3 abi name
354 or an operator name. */
355 if ((physname[0] == '_' && physname[1] == 'Z')
356 || is_operator_name (field_name))
357 return xstrdup (physname);
359 is_full_physname_constructor = is_constructor_name (physname);
362 is_full_physname_constructor || (newname && STREQ (field_name, newname));
365 is_destructor = (strncmp (physname, "__dt", 4) == 0);
367 if (is_destructor || is_full_physname_constructor)
369 mangled_name = (char *) xmalloc (strlen (physname) + 1);
370 strcpy (mangled_name, physname);
376 sprintf (buf, "__%s%s", const_prefix, volatile_prefix);
378 else if (physname[0] == 't' || physname[0] == 'Q')
380 /* The physname for template and qualified methods already includes
382 sprintf (buf, "__%s%s", const_prefix, volatile_prefix);
388 sprintf (buf, "__%s%s%d", const_prefix, volatile_prefix, len);
390 mangled_name_len = ((is_constructor ? 0 : strlen (field_name))
391 + strlen (buf) + len + strlen (physname) + 1);
394 mangled_name = (char *) xmalloc (mangled_name_len);
396 mangled_name[0] = '\0';
398 strcpy (mangled_name, field_name);
400 strcat (mangled_name, buf);
401 /* If the class doesn't have a name, i.e. newname NULL, then we just
402 mangle it using 0 for the length of the class. Thus it gets mangled
403 as something starting with `::' rather than `classname::'. */
405 strcat (mangled_name, newname);
407 strcat (mangled_name, physname);
408 return (mangled_name);
412 /* Initialize the language dependent portion of a symbol
413 depending upon the language for the symbol. */
415 symbol_init_language_specific (struct general_symbol_info *gsymbol,
416 enum language language)
418 gsymbol->language = language;
419 if (gsymbol->language == language_cplus
420 || gsymbol->language == language_java
421 || gsymbol->language == language_objc)
423 gsymbol->language_specific.cplus_specific.demangled_name = NULL;
427 memset (&gsymbol->language_specific, 0,
428 sizeof (gsymbol->language_specific));
432 /* Functions to initialize a symbol's mangled name. */
434 /* Create the hash table used for demangled names. Each hash entry is
435 a pair of strings; one for the mangled name and one for the demangled
436 name. The entry is hashed via just the mangled name. */
439 create_demangled_names_hash (struct objfile *objfile)
441 /* Choose 256 as the starting size of the hash table, somewhat arbitrarily.
442 The hash table code will round this up to the next prime number.
443 Choosing a much larger table size wastes memory, and saves only about
444 1% in symbol reading. */
446 objfile->demangled_names_hash = htab_create_alloc_ex
447 (256, htab_hash_string, (int (*) (const void *, const void *)) streq,
448 NULL, objfile->md, xmcalloc, xmfree);
451 /* Try to determine the demangled name for a symbol, based on the
452 language of that symbol. If the language is set to language_auto,
453 it will attempt to find any demangling algorithm that works and
454 then set the language appropriately. The returned name is allocated
455 by the demangler and should be xfree'd. */
458 symbol_find_demangled_name (struct general_symbol_info *gsymbol,
461 char *demangled = NULL;
463 if (gsymbol->language == language_unknown)
464 gsymbol->language = language_auto;
466 if (gsymbol->language == language_objc
467 || gsymbol->language == language_auto)
470 objc_demangle (mangled, 0);
471 if (demangled != NULL)
473 gsymbol->language = language_objc;
477 if (gsymbol->language == language_cplus
478 || gsymbol->language == language_auto)
481 cplus_demangle (mangled, DMGL_PARAMS | DMGL_ANSI);
482 if (demangled != NULL)
484 gsymbol->language = language_cplus;
488 if (gsymbol->language == language_java)
491 cplus_demangle (mangled,
492 DMGL_PARAMS | DMGL_ANSI | DMGL_JAVA);
493 if (demangled != NULL)
495 gsymbol->language = language_java;
502 /* Set both the mangled and demangled (if any) names for GSYMBOL based
503 on LINKAGE_NAME and LEN. The hash table corresponding to OBJFILE
504 is used, and the memory comes from that objfile's symbol_obstack.
505 LINKAGE_NAME is copied, so the pointer can be discarded after
506 calling this function. */
508 /* We have to be careful when dealing with Java names: when we run
509 into a Java minimal symbol, we don't know it's a Java symbol, so it
510 gets demangled as a C++ name. This is unfortunate, but there's not
511 much we can do about it: but when demangling partial symbols and
512 regular symbols, we'd better not reuse the wrong demangled name.
513 (See PR gdb/1039.) We solve this by putting a distinctive prefix
514 on Java names when storing them in the hash table. */
516 /* FIXME: carlton/2003-03-13: This is an unfortunate situation. I
517 don't mind the Java prefix so much: different languages have
518 different demangling requirements, so it's only natural that we
519 need to keep language data around in our demangling cache. But
520 it's not good that the minimal symbol has the wrong demangled name.
521 Unfortunately, I can't think of any easy solution to that
524 #define JAVA_PREFIX "##JAVA$$"
525 #define JAVA_PREFIX_LEN 8
528 symbol_set_names (struct general_symbol_info *gsymbol,
529 const char *linkage_name, int len, struct objfile *objfile)
532 /* A 0-terminated copy of the linkage name. */
533 const char *linkage_name_copy;
534 /* A copy of the linkage name that might have a special Java prefix
535 added to it, for use when looking names up in the hash table. */
536 const char *lookup_name;
537 /* The length of lookup_name. */
540 if (objfile->demangled_names_hash == NULL)
541 create_demangled_names_hash (objfile);
543 /* The stabs reader generally provides names that are not
544 NUL-terminated; most of the other readers don't do this, so we
545 can just use the given copy, unless we're in the Java case. */
546 if (gsymbol->language == language_java)
549 lookup_len = len + JAVA_PREFIX_LEN;
551 alloc_name = alloca (lookup_len + 1);
552 memcpy (alloc_name, JAVA_PREFIX, JAVA_PREFIX_LEN);
553 memcpy (alloc_name + JAVA_PREFIX_LEN, linkage_name, len);
554 alloc_name[lookup_len] = '\0';
556 lookup_name = alloc_name;
557 linkage_name_copy = alloc_name + JAVA_PREFIX_LEN;
559 else if (linkage_name[len] != '\0')
564 alloc_name = alloca (lookup_len + 1);
565 memcpy (alloc_name, linkage_name, len);
566 alloc_name[lookup_len] = '\0';
568 lookup_name = alloc_name;
569 linkage_name_copy = alloc_name;
574 lookup_name = linkage_name;
575 linkage_name_copy = linkage_name;
578 slot = (char **) htab_find_slot (objfile->demangled_names_hash,
579 lookup_name, INSERT);
581 /* If this name is not in the hash table, add it. */
584 char *demangled_name = symbol_find_demangled_name (gsymbol,
586 int demangled_len = demangled_name ? strlen (demangled_name) : 0;
588 /* If there is a demangled name, place it right after the mangled name.
589 Otherwise, just place a second zero byte after the end of the mangled
591 *slot = obstack_alloc (&objfile->symbol_obstack,
592 lookup_len + demangled_len + 2);
593 memcpy (*slot, lookup_name, lookup_len + 1);
594 if (demangled_name != NULL)
596 memcpy (*slot + lookup_len + 1, demangled_name, demangled_len + 1);
597 xfree (demangled_name);
600 (*slot)[lookup_len + 1] = '\0';
603 gsymbol->name = *slot + lookup_len - len;
604 if ((*slot)[lookup_len + 1] != '\0')
605 gsymbol->language_specific.cplus_specific.demangled_name
606 = &(*slot)[lookup_len + 1];
608 gsymbol->language_specific.cplus_specific.demangled_name = NULL;
611 /* Initialize the demangled name of GSYMBOL if possible. Any required space
612 to store the name is obtained from the specified obstack. The function
613 symbol_set_names, above, should be used instead where possible for more
614 efficient memory usage. */
617 symbol_init_demangled_name (struct general_symbol_info *gsymbol,
618 struct obstack *obstack)
620 char *mangled = gsymbol->name;
621 char *demangled = NULL;
623 demangled = symbol_find_demangled_name (gsymbol, mangled);
624 if (gsymbol->language == language_cplus
625 || gsymbol->language == language_java
626 || gsymbol->language == language_objc)
630 gsymbol->language_specific.cplus_specific.demangled_name
631 = obsavestring (demangled, strlen (demangled), obstack);
635 gsymbol->language_specific.cplus_specific.demangled_name = NULL;
639 /* Unknown language; just clean up quietly. */
645 /* Return the source code name of a symbol. In languages where
646 demangling is necessary, this is the demangled name. */
649 symbol_natural_name (const struct general_symbol_info *gsymbol)
651 if ((gsymbol->language == language_cplus
652 || gsymbol->language == language_java
653 || gsymbol->language == language_objc)
654 && (gsymbol->language_specific.cplus_specific.demangled_name != NULL))
656 return gsymbol->language_specific.cplus_specific.demangled_name;
660 return gsymbol->name;
664 /* Return the demangled name for a symbol based on the language for
665 that symbol. If no demangled name exists, return NULL. */
667 symbol_demangled_name (struct general_symbol_info *gsymbol)
669 if (gsymbol->language == language_cplus
670 || gsymbol->language == language_java
671 || gsymbol->language == language_objc)
672 return gsymbol->language_specific.cplus_specific.demangled_name;
678 /* Initialize the structure fields to zero values. */
680 init_sal (struct symtab_and_line *sal)
691 /* Find which partial symtab on contains PC and SECTION. Return 0 if none. */
693 struct partial_symtab *
694 find_pc_sect_psymtab (CORE_ADDR pc, asection *section)
696 register struct partial_symtab *pst;
697 register struct objfile *objfile;
698 struct minimal_symbol *msymbol;
700 /* If we know that this is not a text address, return failure. This is
701 necessary because we loop based on texthigh and textlow, which do
702 not include the data ranges. */
703 msymbol = lookup_minimal_symbol_by_pc_section (pc, section);
705 && (msymbol->type == mst_data
706 || msymbol->type == mst_bss
707 || msymbol->type == mst_abs
708 || msymbol->type == mst_file_data
709 || msymbol->type == mst_file_bss))
712 ALL_PSYMTABS (objfile, pst)
714 if (pc >= pst->textlow && pc < pst->texthigh)
716 struct partial_symtab *tpst;
718 /* An objfile that has its functions reordered might have
719 many partial symbol tables containing the PC, but
720 we want the partial symbol table that contains the
721 function containing the PC. */
722 if (!(objfile->flags & OBJF_REORDERED) &&
723 section == 0) /* can't validate section this way */
729 for (tpst = pst; tpst != NULL; tpst = tpst->next)
731 if (pc >= tpst->textlow && pc < tpst->texthigh)
733 struct partial_symbol *p;
735 p = find_pc_sect_psymbol (tpst, pc, section);
737 && SYMBOL_VALUE_ADDRESS (p)
738 == SYMBOL_VALUE_ADDRESS (msymbol))
748 /* Find which partial symtab contains PC. Return 0 if none.
749 Backward compatibility, no section */
751 struct partial_symtab *
752 find_pc_psymtab (CORE_ADDR pc)
754 return find_pc_sect_psymtab (pc, find_pc_mapped_section (pc));
757 /* Find which partial symbol within a psymtab matches PC and SECTION.
758 Return 0 if none. Check all psymtabs if PSYMTAB is 0. */
760 struct partial_symbol *
761 find_pc_sect_psymbol (struct partial_symtab *psymtab, CORE_ADDR pc,
764 struct partial_symbol *best = NULL, *p, **pp;
768 psymtab = find_pc_sect_psymtab (pc, section);
772 /* Cope with programs that start at address 0 */
773 best_pc = (psymtab->textlow != 0) ? psymtab->textlow - 1 : 0;
775 /* Search the global symbols as well as the static symbols, so that
776 find_pc_partial_function doesn't use a minimal symbol and thus
777 cache a bad endaddr. */
778 for (pp = psymtab->objfile->global_psymbols.list + psymtab->globals_offset;
779 (pp - (psymtab->objfile->global_psymbols.list + psymtab->globals_offset)
780 < psymtab->n_global_syms);
784 if (SYMBOL_DOMAIN (p) == VAR_DOMAIN
785 && SYMBOL_CLASS (p) == LOC_BLOCK
786 && pc >= SYMBOL_VALUE_ADDRESS (p)
787 && (SYMBOL_VALUE_ADDRESS (p) > best_pc
788 || (psymtab->textlow == 0
789 && best_pc == 0 && SYMBOL_VALUE_ADDRESS (p) == 0)))
791 if (section) /* match on a specific section */
793 fixup_psymbol_section (p, psymtab->objfile);
794 if (SYMBOL_BFD_SECTION (p) != section)
797 best_pc = SYMBOL_VALUE_ADDRESS (p);
802 for (pp = psymtab->objfile->static_psymbols.list + psymtab->statics_offset;
803 (pp - (psymtab->objfile->static_psymbols.list + psymtab->statics_offset)
804 < psymtab->n_static_syms);
808 if (SYMBOL_DOMAIN (p) == VAR_DOMAIN
809 && SYMBOL_CLASS (p) == LOC_BLOCK
810 && pc >= SYMBOL_VALUE_ADDRESS (p)
811 && (SYMBOL_VALUE_ADDRESS (p) > best_pc
812 || (psymtab->textlow == 0
813 && best_pc == 0 && SYMBOL_VALUE_ADDRESS (p) == 0)))
815 if (section) /* match on a specific section */
817 fixup_psymbol_section (p, psymtab->objfile);
818 if (SYMBOL_BFD_SECTION (p) != section)
821 best_pc = SYMBOL_VALUE_ADDRESS (p);
829 /* Find which partial symbol within a psymtab matches PC. Return 0 if none.
830 Check all psymtabs if PSYMTAB is 0. Backwards compatibility, no section. */
832 struct partial_symbol *
833 find_pc_psymbol (struct partial_symtab *psymtab, CORE_ADDR pc)
835 return find_pc_sect_psymbol (psymtab, pc, find_pc_mapped_section (pc));
838 /* Debug symbols usually don't have section information. We need to dig that
839 out of the minimal symbols and stash that in the debug symbol. */
842 fixup_section (struct general_symbol_info *ginfo, struct objfile *objfile)
844 struct minimal_symbol *msym;
845 msym = lookup_minimal_symbol (ginfo->name, NULL, objfile);
849 ginfo->bfd_section = SYMBOL_BFD_SECTION (msym);
850 ginfo->section = SYMBOL_SECTION (msym);
855 fixup_symbol_section (struct symbol *sym, struct objfile *objfile)
860 if (SYMBOL_BFD_SECTION (sym))
863 fixup_section (&sym->ginfo, objfile);
868 struct partial_symbol *
869 fixup_psymbol_section (struct partial_symbol *psym, struct objfile *objfile)
874 if (SYMBOL_BFD_SECTION (psym))
877 fixup_section (&psym->ginfo, objfile);
882 /* Find the definition for a specified symbol name NAME
883 in domain DOMAIN, visible from lexical block BLOCK.
884 Returns the struct symbol pointer, or zero if no symbol is found.
885 If SYMTAB is non-NULL, store the symbol table in which the
886 symbol was found there, or NULL if not found.
887 C++: if IS_A_FIELD_OF_THIS is nonzero on entry, check to see if
888 NAME is a field of the current implied argument `this'. If so set
889 *IS_A_FIELD_OF_THIS to 1, otherwise set it to zero.
890 BLOCK_FOUND is set to the block in which NAME is found (in the case of
891 a field of `this', value_of_this sets BLOCK_FOUND to the proper value.) */
893 /* This function has a bunch of loops in it and it would seem to be
894 attractive to put in some QUIT's (though I'm not really sure
895 whether it can run long enough to be really important). But there
896 are a few calls for which it would appear to be bad news to quit
897 out of here: find_proc_desc in alpha-tdep.c and mips-tdep.c. (Note
898 that there is C++ code below which can error(), but that probably
899 doesn't affect these calls since they are looking for a known
900 variable and thus can probably assume it will never hit the C++
904 lookup_symbol (const char *name, const struct block *block,
905 const domain_enum domain, int *is_a_field_of_this,
906 struct symtab **symtab)
908 char *demangled_name = NULL;
909 const char *modified_name = NULL;
910 const char *mangled_name = NULL;
911 int needtofreename = 0;
912 struct symbol *returnval;
914 modified_name = name;
916 /* If we are using C++ language, demangle the name before doing a lookup, so
917 we can always binary search. */
918 if (current_language->la_language == language_cplus)
920 demangled_name = cplus_demangle (name, DMGL_ANSI | DMGL_PARAMS);
924 modified_name = demangled_name;
929 if (case_sensitivity == case_sensitive_off)
935 copy = (char *) alloca (len + 1);
936 for (i= 0; i < len; i++)
937 copy[i] = tolower (name[i]);
939 modified_name = copy;
942 returnval = lookup_symbol_aux (modified_name, mangled_name, block,
943 domain, is_a_field_of_this, symtab);
945 xfree (demangled_name);
950 static struct symbol *
951 lookup_symbol_aux (const char *name, const char *mangled_name,
952 const struct block *block, const domain_enum domain,
953 int *is_a_field_of_this, struct symtab **symtab)
956 const struct block *static_block;
958 /* Search specified block and its superiors. Don't search
959 STATIC_BLOCK or GLOBAL_BLOCK. */
961 sym = lookup_symbol_aux_local (name, mangled_name, block, domain,
962 symtab, &static_block);
967 /* NOTE: carlton/2002-11-05: At the time that this code was
968 #ifdeffed out, the value of 'block' was always NULL at this
969 point, hence the bemused comments below. */
971 /* FIXME: this code is never executed--block is always NULL at this
972 point. What is it trying to do, anyway? We already should have
973 checked the STATIC_BLOCK above (it is the superblock of top-level
974 blocks). Why is VAR_DOMAIN special-cased? */
975 /* Don't need to mess with the psymtabs; if we have a block,
976 that file is read in. If we don't, then we deal later with
977 all the psymtab stuff that needs checking. */
978 /* Note (RT): The following never-executed code looks unnecessary to me also.
979 * If we change the code to use the original (passed-in)
980 * value of 'block', we could cause it to execute, but then what
981 * would it do? The STATIC_BLOCK of the symtab containing the passed-in
982 * 'block' was already searched by the above code. And the STATIC_BLOCK's
983 * of *other* symtabs (those files not containing 'block' lexically)
984 * should not contain 'block' address-wise. So we wouldn't expect this
985 * code to find any 'sym''s that were not found above. I vote for
986 * deleting the following paragraph of code.
988 if (domain == VAR_DOMAIN && block != NULL)
991 /* Find the right symtab. */
992 ALL_SYMTABS (objfile, s)
994 bv = BLOCKVECTOR (s);
995 b = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
996 if (BLOCK_START (b) <= BLOCK_START (block)
997 && BLOCK_END (b) > BLOCK_START (block))
999 sym = lookup_block_symbol (b, name, mangled_name, VAR_DOMAIN);
1005 return fixup_symbol_section (sym, objfile);
1012 /* C++/Java/Objective-C: If requested to do so by the caller,
1013 check to see if NAME is a field of `this'. */
1014 if (is_a_field_of_this)
1016 struct value *v = value_of_this (0);
1018 *is_a_field_of_this = 0;
1019 if (v && check_field (v, name))
1021 *is_a_field_of_this = 1;
1028 /* If there's a static block to search, search it next. */
1030 /* NOTE: carlton/2002-12-05: There is a question as to whether or
1031 not it would be appropriate to search the current global block
1032 here as well. (That's what this code used to do before the
1033 is_a_field_of_this check was moved up.) On the one hand, it's
1034 redundant with the lookup_symbol_aux_symtabs search that happens
1035 next. On the other hand, if decode_line_1 is passed an argument
1036 like filename:var, then the user presumably wants 'var' to be
1037 searched for in filename. On the third hand, there shouldn't be
1038 multiple global variables all of which are named 'var', and it's
1039 not like decode_line_1 has ever restricted its search to only
1040 global variables in a single filename. All in all, only
1041 searching the static block here seems best: it's correct and it's
1044 /* NOTE: carlton/2002-12-05: There's also a possible performance
1045 issue here: if you usually search for global symbols in the
1046 current file, then it would be slightly better to search the
1047 current global block before searching all the symtabs. But there
1048 are other factors that have a much greater effect on performance
1049 than that one, so I don't think we should worry about that for
1052 if (static_block != NULL)
1054 sym = lookup_symbol_aux_block (name, mangled_name, static_block,
1060 /* Now search all global blocks. Do the symtab's first, then
1061 check the psymtab's. If a psymtab indicates the existence
1062 of the desired name as a global, then do psymtab-to-symtab
1063 conversion on the fly and return the found symbol. */
1065 sym = lookup_symbol_aux_symtabs (GLOBAL_BLOCK, name, mangled_name,
1070 sym = lookup_symbol_aux_psymtabs (GLOBAL_BLOCK, name, mangled_name,
1075 /* Now search all static file-level symbols. Not strictly correct,
1076 but more useful than an error. Do the symtabs first, then check
1077 the psymtabs. If a psymtab indicates the existence of the
1078 desired name as a file-level static, then do psymtab-to-symtab
1079 conversion on the fly and return the found symbol. */
1081 sym = lookup_symbol_aux_symtabs (STATIC_BLOCK, name, mangled_name,
1086 sym = lookup_symbol_aux_psymtabs (STATIC_BLOCK, name, mangled_name,
1096 /* Check to see if the symbol is defined in BLOCK or its superiors.
1097 Don't search STATIC_BLOCK or GLOBAL_BLOCK. If we don't find a
1098 match, store the address of STATIC_BLOCK in static_block. */
1100 static struct symbol *
1101 lookup_symbol_aux_local (const char *name, const char *mangled_name,
1102 const struct block *block,
1103 const domain_enum domain,
1104 struct symtab **symtab,
1105 const struct block **static_block)
1109 /* Check if either no block is specified or it's a global block. */
1111 if (block == NULL || BLOCK_SUPERBLOCK (block) == NULL)
1113 *static_block = NULL;
1117 while (BLOCK_SUPERBLOCK (BLOCK_SUPERBLOCK (block)) != NULL)
1119 sym = lookup_symbol_aux_block (name, mangled_name, block, domain,
1123 block = BLOCK_SUPERBLOCK (block);
1126 /* We've reached the static block. */
1128 *static_block = block;
1132 /* Look up a symbol in a block; if found, locate its symtab, fixup the
1133 symbol, and set block_found appropriately. */
1135 static struct symbol *
1136 lookup_symbol_aux_block (const char *name, const char *mangled_name,
1137 const struct block *block,
1138 const domain_enum domain,
1139 struct symtab **symtab)
1142 struct objfile *objfile = NULL;
1143 struct blockvector *bv;
1145 struct symtab *s = NULL;
1147 sym = lookup_block_symbol (block, name, mangled_name, domain);
1150 block_found = block;
1153 /* Search the list of symtabs for one which contains the
1154 address of the start of this block. */
1155 ALL_SYMTABS (objfile, s)
1157 bv = BLOCKVECTOR (s);
1158 b = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
1159 if (BLOCK_START (b) <= BLOCK_START (block)
1160 && BLOCK_END (b) > BLOCK_START (block))
1167 return fixup_symbol_section (sym, objfile);
1173 /* Check to see if the symbol is defined in one of the symtabs.
1174 BLOCK_INDEX should be either GLOBAL_BLOCK or STATIC_BLOCK,
1175 depending on whether or not we want to search global symbols or
1178 static struct symbol *
1179 lookup_symbol_aux_symtabs (int block_index,
1180 const char *name, const char *mangled_name,
1181 const domain_enum domain,
1182 struct symtab **symtab)
1185 struct objfile *objfile;
1186 struct blockvector *bv;
1187 const struct block *block;
1190 ALL_SYMTABS (objfile, s)
1192 bv = BLOCKVECTOR (s);
1193 block = BLOCKVECTOR_BLOCK (bv, block_index);
1194 sym = lookup_block_symbol (block, name, mangled_name, domain);
1197 block_found = block;
1200 return fixup_symbol_section (sym, objfile);
1207 /* Check to see if the symbol is defined in one of the partial
1208 symtabs. BLOCK_INDEX should be either GLOBAL_BLOCK or
1209 STATIC_BLOCK, depending on whether or not we want to search global
1210 symbols or static symbols. */
1212 static struct symbol *
1213 lookup_symbol_aux_psymtabs (int block_index, const char *name,
1214 const char *mangled_name,
1215 const domain_enum domain,
1216 struct symtab **symtab)
1219 struct objfile *objfile;
1220 struct blockvector *bv;
1221 const struct block *block;
1222 struct partial_symtab *ps;
1224 const int psymtab_index = (block_index == GLOBAL_BLOCK ? 1 : 0);
1226 ALL_PSYMTABS (objfile, ps)
1229 && lookup_partial_symbol (ps, name, mangled_name,
1230 psymtab_index, domain))
1232 s = PSYMTAB_TO_SYMTAB (ps);
1233 bv = BLOCKVECTOR (s);
1234 block = BLOCKVECTOR_BLOCK (bv, block_index);
1235 sym = lookup_block_symbol (block, name, mangled_name, domain);
1238 /* This shouldn't be necessary, but as a last resort try
1239 looking in the statics even though the psymtab claimed
1240 the symbol was global, or vice-versa. It's possible
1241 that the psymtab gets it wrong in some cases. */
1243 /* FIXME: carlton/2002-09-30: Should we really do that?
1244 If that happens, isn't it likely to be a GDB error, in
1245 which case we should fix the GDB error rather than
1246 silently dealing with it here? So I'd vote for
1247 removing the check for the symbol in the other
1249 block = BLOCKVECTOR_BLOCK (bv,
1250 block_index == GLOBAL_BLOCK ?
1251 STATIC_BLOCK : GLOBAL_BLOCK);
1252 sym = lookup_block_symbol (block, name, mangled_name, domain);
1254 error ("Internal: %s symbol `%s' found in %s psymtab but not in symtab.\n%s may be an inlined function, or may be a template function\n(if a template, try specifying an instantiation: %s<type>).",
1255 block_index == GLOBAL_BLOCK ? "global" : "static",
1256 name, ps->filename, name, name);
1260 return fixup_symbol_section (sym, objfile);
1268 /* Check for the possibility of the symbol being a function or a
1269 mangled variable that is stored in one of the minimal symbol
1270 tables. Eventually, all global symbols might be resolved in this
1273 /* NOTE: carlton/2002-12-05: At one point, this function was part of
1274 lookup_symbol_aux, and what are now 'return' statements within
1275 lookup_symbol_aux_minsyms returned from lookup_symbol_aux, even if
1276 sym was NULL. As far as I can tell, this was basically accidental;
1277 it didn't happen every time that msymbol was non-NULL, but only if
1278 some additional conditions held as well, and it caused problems
1279 with HP-generated symbol tables. */
1281 /* NOTE: carlton/2003-05-14: This function was once used as part of
1282 lookup_symbol. It is currently unnecessary for correctness
1283 reasons, however, and using it doesn't seem to be any faster than
1284 using lookup_symbol_aux_psymtabs, so I'm commenting it out. */
1286 static struct symbol *
1287 lookup_symbol_aux_minsyms (const char *name,
1288 const char *mangled_name,
1289 const domain_enum domain,
1290 int *is_a_field_of_this,
1291 struct symtab **symtab)
1294 struct blockvector *bv;
1295 const struct block *block;
1296 struct minimal_symbol *msymbol;
1299 if (domain == VAR_DOMAIN)
1301 msymbol = lookup_minimal_symbol (name, NULL, NULL);
1303 if (msymbol != NULL)
1305 /* OK, we found a minimal symbol in spite of not finding any
1306 symbol. There are various possible explanations for
1307 this. One possibility is the symbol exists in code not
1308 compiled -g. Another possibility is that the 'psymtab'
1309 isn't doing its job. A third possibility, related to #2,
1310 is that we were confused by name-mangling. For instance,
1311 maybe the psymtab isn't doing its job because it only
1312 know about demangled names, but we were given a mangled
1315 /* We first use the address in the msymbol to try to locate
1316 the appropriate symtab. Note that find_pc_sect_symtab()
1317 has a side-effect of doing psymtab-to-symtab expansion,
1318 for the found symtab. */
1319 s = find_pc_sect_symtab (SYMBOL_VALUE_ADDRESS (msymbol),
1320 SYMBOL_BFD_SECTION (msymbol));
1323 /* This is a function which has a symtab for its address. */
1324 bv = BLOCKVECTOR (s);
1325 block = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
1327 /* This call used to pass `DEPRECATED_SYMBOL_NAME (msymbol)' as the
1328 `name' argument to lookup_block_symbol. But the name
1329 of a minimal symbol is always mangled, so that seems
1330 to be clearly the wrong thing to pass as the
1333 lookup_block_symbol (block, name, mangled_name, domain);
1334 /* We kept static functions in minimal symbol table as well as
1335 in static scope. We want to find them in the symbol table. */
1338 block = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
1339 sym = lookup_block_symbol (block, name,
1340 mangled_name, domain);
1343 /* NOTE: carlton/2002-12-04: The following comment was
1344 taken from a time when two versions of this function
1345 were part of the body of lookup_symbol_aux: this
1346 comment was taken from the version of the function
1347 that was #ifdef HPUXHPPA, and the comment was right
1348 before the 'return NULL' part of lookup_symbol_aux.
1349 (Hence the "Fall through and return 0" comment.)
1350 Elena did some digging into the situation for
1351 Fortran, and she reports:
1353 "I asked around (thanks to Jeff Knaggs), and I think
1354 the story for Fortran goes like this:
1356 "Apparently, in older Fortrans, '_' was not part of
1357 the user namespace. g77 attached a final '_' to
1358 procedure names as the exported symbols for linkage
1359 (foo_) , but the symbols went in the debug info just
1360 like 'foo'. The rationale behind this is not
1361 completely clear, and maybe it was done to other
1362 symbols as well, not just procedures." */
1364 /* If we get here with sym == 0, the symbol was
1365 found in the minimal symbol table
1366 but not in the symtab.
1367 Fall through and return 0 to use the msymbol
1368 definition of "foo_".
1369 (Note that outer code generally follows up a call
1370 to this routine with a call to lookup_minimal_symbol(),
1371 so a 0 return means we'll just flow into that other routine).
1373 This happens for Fortran "foo_" symbols,
1374 which are "foo" in the symtab.
1376 This can also happen if "asm" is used to make a
1377 regular symbol but not a debugging symbol, e.g.
1378 asm(".globl _main");
1382 if (symtab != NULL && sym != NULL)
1384 return fixup_symbol_section (sym, s->objfile);
1393 /* Look, in partial_symtab PST, for symbol whose natural name is NAME.
1394 If LINKAGE_NAME is non-NULL, check in addition that the symbol's
1395 linkage name matches it. Check the global symbols if GLOBAL, the
1396 static symbols if not */
1398 static struct partial_symbol *
1399 lookup_partial_symbol (struct partial_symtab *pst, const char *name,
1400 const char *linkage_name, int global,
1403 struct partial_symbol *temp;
1404 struct partial_symbol **start, **psym;
1405 struct partial_symbol **top, **real_top, **bottom, **center;
1406 int length = (global ? pst->n_global_syms : pst->n_static_syms);
1407 int do_linear_search = 1;
1414 pst->objfile->global_psymbols.list + pst->globals_offset :
1415 pst->objfile->static_psymbols.list + pst->statics_offset);
1417 if (global) /* This means we can use a binary search. */
1419 do_linear_search = 0;
1421 /* Binary search. This search is guaranteed to end with center
1422 pointing at the earliest partial symbol whose name might be
1423 correct. At that point *all* partial symbols with an
1424 appropriate name will be checked against the correct
1428 top = start + length - 1;
1430 while (top > bottom)
1432 center = bottom + (top - bottom) / 2;
1433 if (!(center < top))
1434 internal_error (__FILE__, __LINE__, "failed internal consistency check");
1435 if (!do_linear_search
1436 && (SYMBOL_LANGUAGE (*center) == language_java))
1438 do_linear_search = 1;
1440 if (strcmp_iw_ordered (SYMBOL_NATURAL_NAME (*center), name) >= 0)
1446 bottom = center + 1;
1449 if (!(top == bottom))
1450 internal_error (__FILE__, __LINE__, "failed internal consistency check");
1452 while (top <= real_top
1453 && (linkage_name != NULL
1454 ? strcmp (SYMBOL_LINKAGE_NAME (*top), linkage_name) == 0
1455 : SYMBOL_MATCHES_NATURAL_NAME (*top,name)))
1457 if (SYMBOL_DOMAIN (*top) == domain)
1465 /* Can't use a binary search or else we found during the binary search that
1466 we should also do a linear search. */
1468 if (do_linear_search)
1470 for (psym = start; psym < start + length; psym++)
1472 if (domain == SYMBOL_DOMAIN (*psym))
1474 if (linkage_name != NULL
1475 ? strcmp (SYMBOL_LINKAGE_NAME (*psym), linkage_name) == 0
1476 : SYMBOL_MATCHES_NATURAL_NAME (*psym, name))
1487 /* Look up a type named NAME in the struct_domain. The type returned
1488 must not be opaque -- i.e., must have at least one field defined
1490 This code was modelled on lookup_symbol -- the parts not relevant to looking
1491 up types were just left out. In particular it's assumed here that types
1492 are available in struct_domain and only at file-static or global blocks. */
1496 lookup_transparent_type (const char *name)
1498 register struct symbol *sym;
1499 register struct symtab *s = NULL;
1500 register struct partial_symtab *ps;
1501 struct blockvector *bv;
1502 register struct objfile *objfile;
1503 register struct block *block;
1505 /* Now search all the global symbols. Do the symtab's first, then
1506 check the psymtab's. If a psymtab indicates the existence
1507 of the desired name as a global, then do psymtab-to-symtab
1508 conversion on the fly and return the found symbol. */
1510 ALL_SYMTABS (objfile, s)
1512 bv = BLOCKVECTOR (s);
1513 block = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
1514 sym = lookup_block_symbol (block, name, NULL, STRUCT_DOMAIN);
1515 if (sym && !TYPE_IS_OPAQUE (SYMBOL_TYPE (sym)))
1517 return SYMBOL_TYPE (sym);
1521 ALL_PSYMTABS (objfile, ps)
1523 if (!ps->readin && lookup_partial_symbol (ps, name, NULL,
1526 s = PSYMTAB_TO_SYMTAB (ps);
1527 bv = BLOCKVECTOR (s);
1528 block = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
1529 sym = lookup_block_symbol (block, name, NULL, STRUCT_DOMAIN);
1532 /* This shouldn't be necessary, but as a last resort
1533 * try looking in the statics even though the psymtab
1534 * claimed the symbol was global. It's possible that
1535 * the psymtab gets it wrong in some cases.
1537 block = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
1538 sym = lookup_block_symbol (block, name, NULL, STRUCT_DOMAIN);
1540 error ("Internal: global symbol `%s' found in %s psymtab but not in symtab.\n\
1541 %s may be an inlined function, or may be a template function\n\
1542 (if a template, try specifying an instantiation: %s<type>).",
1543 name, ps->filename, name, name);
1545 if (!TYPE_IS_OPAQUE (SYMBOL_TYPE (sym)))
1546 return SYMBOL_TYPE (sym);
1550 /* Now search the static file-level symbols.
1551 Not strictly correct, but more useful than an error.
1552 Do the symtab's first, then
1553 check the psymtab's. If a psymtab indicates the existence
1554 of the desired name as a file-level static, then do psymtab-to-symtab
1555 conversion on the fly and return the found symbol.
1558 ALL_SYMTABS (objfile, s)
1560 bv = BLOCKVECTOR (s);
1561 block = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
1562 sym = lookup_block_symbol (block, name, NULL, STRUCT_DOMAIN);
1563 if (sym && !TYPE_IS_OPAQUE (SYMBOL_TYPE (sym)))
1565 return SYMBOL_TYPE (sym);
1569 ALL_PSYMTABS (objfile, ps)
1571 if (!ps->readin && lookup_partial_symbol (ps, name, NULL, 0, STRUCT_DOMAIN))
1573 s = PSYMTAB_TO_SYMTAB (ps);
1574 bv = BLOCKVECTOR (s);
1575 block = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
1576 sym = lookup_block_symbol (block, name, NULL, STRUCT_DOMAIN);
1579 /* This shouldn't be necessary, but as a last resort
1580 * try looking in the globals even though the psymtab
1581 * claimed the symbol was static. It's possible that
1582 * the psymtab gets it wrong in some cases.
1584 block = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
1585 sym = lookup_block_symbol (block, name, NULL, STRUCT_DOMAIN);
1587 error ("Internal: static symbol `%s' found in %s psymtab but not in symtab.\n\
1588 %s may be an inlined function, or may be a template function\n\
1589 (if a template, try specifying an instantiation: %s<type>).",
1590 name, ps->filename, name, name);
1592 if (!TYPE_IS_OPAQUE (SYMBOL_TYPE (sym)))
1593 return SYMBOL_TYPE (sym);
1596 return (struct type *) 0;
1600 /* Find the psymtab containing main(). */
1601 /* FIXME: What about languages without main() or specially linked
1602 executables that have no main() ? */
1604 struct partial_symtab *
1605 find_main_psymtab (void)
1607 register struct partial_symtab *pst;
1608 register struct objfile *objfile;
1610 ALL_PSYMTABS (objfile, pst)
1612 if (lookup_partial_symbol (pst, main_name (), NULL, 1, VAR_DOMAIN))
1620 /* Search BLOCK for symbol NAME in DOMAIN.
1622 Note that if NAME is the demangled form of a C++ symbol, we will fail
1623 to find a match during the binary search of the non-encoded names, but
1624 for now we don't worry about the slight inefficiency of looking for
1625 a match we'll never find, since it will go pretty quick. Once the
1626 binary search terminates, we drop through and do a straight linear
1627 search on the symbols. Each symbol which is marked as being a ObjC/C++
1628 symbol (language_cplus or language_objc set) has both the encoded and
1629 non-encoded names tested for a match.
1631 If MANGLED_NAME is non-NULL, verify that any symbol we find has this
1632 particular mangled name.
1636 lookup_block_symbol (register const struct block *block, const char *name,
1637 const char *mangled_name,
1638 const domain_enum domain)
1640 register int bot, top, inc;
1641 register struct symbol *sym;
1642 register struct symbol *sym_found = NULL;
1643 register int do_linear_search = 1;
1645 if (BLOCK_HASHTABLE (block))
1647 unsigned int hash_index;
1648 hash_index = msymbol_hash_iw (name);
1649 hash_index = hash_index % BLOCK_BUCKETS (block);
1650 for (sym = BLOCK_BUCKET (block, hash_index); sym; sym = sym->hash_next)
1652 if (SYMBOL_DOMAIN (sym) == domain
1654 ? strcmp (DEPRECATED_SYMBOL_NAME (sym), mangled_name) == 0
1655 : SYMBOL_MATCHES_NATURAL_NAME (sym, name)))
1661 /* If the blocks's symbols were sorted, start with a binary search. */
1663 if (BLOCK_SHOULD_SORT (block))
1665 /* Reset the linear search flag so if the binary search fails, we
1666 won't do the linear search once unless we find some reason to
1669 do_linear_search = 0;
1670 top = BLOCK_NSYMS (block);
1673 /* Advance BOT to not far before the first symbol whose name is NAME. */
1677 inc = (top - bot + 1);
1678 /* No need to keep binary searching for the last few bits worth. */
1683 inc = (inc >> 1) + bot;
1684 sym = BLOCK_SYM (block, inc);
1685 if (!do_linear_search && (SYMBOL_LANGUAGE (sym) == language_java))
1687 do_linear_search = 1;
1689 if (SYMBOL_NATURAL_NAME (sym)[0] < name[0])
1693 else if (SYMBOL_NATURAL_NAME (sym)[0] > name[0])
1697 else if (strcmp (SYMBOL_NATURAL_NAME (sym), name) < 0)
1707 /* Now scan forward until we run out of symbols, find one whose
1708 name is greater than NAME, or find one we want. If there is
1709 more than one symbol with the right name and domain, we
1710 return the first one; I believe it is now impossible for us
1711 to encounter two symbols with the same name and domain
1712 here, because blocks containing argument symbols are no
1713 longer sorted. The exception is for C++, where multiple functions
1714 (cloned constructors / destructors, in particular) can have
1715 the same demangled name. So if we have a particular
1716 mangled name to match, try to do so. */
1718 top = BLOCK_NSYMS (block);
1721 sym = BLOCK_SYM (block, bot);
1722 if (SYMBOL_DOMAIN (sym) == domain
1724 ? strcmp (DEPRECATED_SYMBOL_NAME (sym), mangled_name) == 0
1725 : SYMBOL_MATCHES_NATURAL_NAME (sym, name)))
1729 if (SYMBOL_PRINT_NAME (sym)[0] > name[0])
1737 /* Here if block isn't sorted, or we fail to find a match during the
1738 binary search above. If during the binary search above, we find a
1739 symbol which is a Java symbol, then we have re-enabled the linear
1740 search flag which was reset when starting the binary search.
1742 This loop is equivalent to the loop above, but hacked greatly for speed.
1744 Note that parameter symbols do not always show up last in the
1745 list; this loop makes sure to take anything else other than
1746 parameter symbols first; it only uses parameter symbols as a
1747 last resort. Note that this only takes up extra computation
1750 if (do_linear_search)
1752 top = BLOCK_NSYMS (block);
1756 sym = BLOCK_SYM (block, bot);
1757 if (SYMBOL_DOMAIN (sym) == domain
1759 ? strcmp (DEPRECATED_SYMBOL_NAME (sym), mangled_name) == 0
1760 : SYMBOL_MATCHES_NATURAL_NAME (sym, name)))
1762 /* If SYM has aliases, then use any alias that is active
1763 at the current PC. If no alias is active at the current
1764 PC, then use the main symbol.
1766 ?!? Is checking the current pc correct? Is this routine
1767 ever called to look up a symbol from another context?
1769 FIXME: No, it's not correct. If someone sets a
1770 conditional breakpoint at an address, then the
1771 breakpoint's `struct expression' should refer to the
1772 `struct symbol' appropriate for the breakpoint's
1773 address, which may not be the PC.
1775 Even if it were never called from another context,
1776 it's totally bizarre for lookup_symbol's behavior to
1777 depend on the value of the inferior's current PC. We
1778 should pass in the appropriate PC as well as the
1779 block. The interface to lookup_symbol should change
1780 to require the caller to provide a PC. */
1782 if (SYMBOL_ALIASES (sym))
1783 sym = find_active_alias (sym, read_pc ());
1786 if (SYMBOL_CLASS (sym) != LOC_ARG &&
1787 SYMBOL_CLASS (sym) != LOC_LOCAL_ARG &&
1788 SYMBOL_CLASS (sym) != LOC_REF_ARG &&
1789 SYMBOL_CLASS (sym) != LOC_REGPARM &&
1790 SYMBOL_CLASS (sym) != LOC_REGPARM_ADDR &&
1791 SYMBOL_CLASS (sym) != LOC_BASEREG_ARG &&
1792 SYMBOL_CLASS (sym) != LOC_COMPUTED_ARG)
1800 return (sym_found); /* Will be NULL if not found. */
1803 /* Given a main symbol SYM and ADDR, search through the alias
1804 list to determine if an alias is active at ADDR and return
1807 If no alias is active, then return SYM. */
1809 static struct symbol *
1810 find_active_alias (struct symbol *sym, CORE_ADDR addr)
1812 struct range_list *r;
1813 struct alias_list *aliases;
1815 /* If we have aliases, check them first. */
1816 aliases = SYMBOL_ALIASES (sym);
1820 if (!SYMBOL_RANGES (aliases->sym))
1821 return aliases->sym;
1822 for (r = SYMBOL_RANGES (aliases->sym); r; r = r->next)
1824 if (r->start <= addr && r->end > addr)
1825 return aliases->sym;
1827 aliases = aliases->next;
1830 /* Nothing found, return the main symbol. */
1835 /* Find the symtab associated with PC and SECTION. Look through the
1836 psymtabs and read in another symtab if necessary. */
1839 find_pc_sect_symtab (CORE_ADDR pc, asection *section)
1841 register struct block *b;
1842 struct blockvector *bv;
1843 register struct symtab *s = NULL;
1844 register struct symtab *best_s = NULL;
1845 register struct partial_symtab *ps;
1846 register struct objfile *objfile;
1847 CORE_ADDR distance = 0;
1848 struct minimal_symbol *msymbol;
1850 /* If we know that this is not a text address, return failure. This is
1851 necessary because we loop based on the block's high and low code
1852 addresses, which do not include the data ranges, and because
1853 we call find_pc_sect_psymtab which has a similar restriction based
1854 on the partial_symtab's texthigh and textlow. */
1855 msymbol = lookup_minimal_symbol_by_pc_section (pc, section);
1857 && (msymbol->type == mst_data
1858 || msymbol->type == mst_bss
1859 || msymbol->type == mst_abs
1860 || msymbol->type == mst_file_data
1861 || msymbol->type == mst_file_bss))
1864 /* Search all symtabs for the one whose file contains our address, and which
1865 is the smallest of all the ones containing the address. This is designed
1866 to deal with a case like symtab a is at 0x1000-0x2000 and 0x3000-0x4000
1867 and symtab b is at 0x2000-0x3000. So the GLOBAL_BLOCK for a is from
1868 0x1000-0x4000, but for address 0x2345 we want to return symtab b.
1870 This happens for native ecoff format, where code from included files
1871 gets its own symtab. The symtab for the included file should have
1872 been read in already via the dependency mechanism.
1873 It might be swifter to create several symtabs with the same name
1874 like xcoff does (I'm not sure).
1876 It also happens for objfiles that have their functions reordered.
1877 For these, the symtab we are looking for is not necessarily read in. */
1879 ALL_SYMTABS (objfile, s)
1881 bv = BLOCKVECTOR (s);
1882 b = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
1884 if (BLOCK_START (b) <= pc
1885 && BLOCK_END (b) > pc
1887 || BLOCK_END (b) - BLOCK_START (b) < distance))
1889 /* For an objfile that has its functions reordered,
1890 find_pc_psymtab will find the proper partial symbol table
1891 and we simply return its corresponding symtab. */
1892 /* In order to better support objfiles that contain both
1893 stabs and coff debugging info, we continue on if a psymtab
1895 if ((objfile->flags & OBJF_REORDERED) && objfile->psymtabs)
1897 ps = find_pc_sect_psymtab (pc, section);
1899 return PSYMTAB_TO_SYMTAB (ps);
1904 struct symbol *sym = NULL;
1906 ALL_BLOCK_SYMBOLS (b, i, sym)
1908 fixup_symbol_section (sym, objfile);
1909 if (section == SYMBOL_BFD_SECTION (sym))
1912 if ((i >= BLOCK_BUCKETS (b)) && (sym == NULL))
1913 continue; /* no symbol in this symtab matches section */
1915 distance = BLOCK_END (b) - BLOCK_START (b);
1924 ps = find_pc_sect_psymtab (pc, section);
1928 /* Might want to error() here (in case symtab is corrupt and
1929 will cause a core dump), but maybe we can successfully
1930 continue, so let's not. */
1932 (Internal error: pc 0x%s in read in psymtab, but not in symtab.)\n",
1934 s = PSYMTAB_TO_SYMTAB (ps);
1939 /* Find the symtab associated with PC. Look through the psymtabs and
1940 read in another symtab if necessary. Backward compatibility, no section */
1943 find_pc_symtab (CORE_ADDR pc)
1945 return find_pc_sect_symtab (pc, find_pc_mapped_section (pc));
1949 /* Find the source file and line number for a given PC value and SECTION.
1950 Return a structure containing a symtab pointer, a line number,
1951 and a pc range for the entire source line.
1952 The value's .pc field is NOT the specified pc.
1953 NOTCURRENT nonzero means, if specified pc is on a line boundary,
1954 use the line that ends there. Otherwise, in that case, the line
1955 that begins there is used. */
1957 /* The big complication here is that a line may start in one file, and end just
1958 before the start of another file. This usually occurs when you #include
1959 code in the middle of a subroutine. To properly find the end of a line's PC
1960 range, we must search all symtabs associated with this compilation unit, and
1961 find the one whose first PC is closer than that of the next line in this
1964 /* If it's worth the effort, we could be using a binary search. */
1966 struct symtab_and_line
1967 find_pc_sect_line (CORE_ADDR pc, struct sec *section, int notcurrent)
1970 register struct linetable *l;
1973 register struct linetable_entry *item;
1974 struct symtab_and_line val;
1975 struct blockvector *bv;
1976 struct minimal_symbol *msymbol;
1977 struct minimal_symbol *mfunsym;
1979 /* Info on best line seen so far, and where it starts, and its file. */
1981 struct linetable_entry *best = NULL;
1982 CORE_ADDR best_end = 0;
1983 struct symtab *best_symtab = 0;
1985 /* Store here the first line number
1986 of a file which contains the line at the smallest pc after PC.
1987 If we don't find a line whose range contains PC,
1988 we will use a line one less than this,
1989 with a range from the start of that file to the first line's pc. */
1990 struct linetable_entry *alt = NULL;
1991 struct symtab *alt_symtab = 0;
1993 /* Info on best line seen in this file. */
1995 struct linetable_entry *prev;
1997 /* If this pc is not from the current frame,
1998 it is the address of the end of a call instruction.
1999 Quite likely that is the start of the following statement.
2000 But what we want is the statement containing the instruction.
2001 Fudge the pc to make sure we get that. */
2003 init_sal (&val); /* initialize to zeroes */
2005 /* It's tempting to assume that, if we can't find debugging info for
2006 any function enclosing PC, that we shouldn't search for line
2007 number info, either. However, GAS can emit line number info for
2008 assembly files --- very helpful when debugging hand-written
2009 assembly code. In such a case, we'd have no debug info for the
2010 function, but we would have line info. */
2015 /* elz: added this because this function returned the wrong
2016 information if the pc belongs to a stub (import/export)
2017 to call a shlib function. This stub would be anywhere between
2018 two functions in the target, and the line info was erroneously
2019 taken to be the one of the line before the pc.
2021 /* RT: Further explanation:
2023 * We have stubs (trampolines) inserted between procedures.
2025 * Example: "shr1" exists in a shared library, and a "shr1" stub also
2026 * exists in the main image.
2028 * In the minimal symbol table, we have a bunch of symbols
2029 * sorted by start address. The stubs are marked as "trampoline",
2030 * the others appear as text. E.g.:
2032 * Minimal symbol table for main image
2033 * main: code for main (text symbol)
2034 * shr1: stub (trampoline symbol)
2035 * foo: code for foo (text symbol)
2037 * Minimal symbol table for "shr1" image:
2039 * shr1: code for shr1 (text symbol)
2042 * So the code below is trying to detect if we are in the stub
2043 * ("shr1" stub), and if so, find the real code ("shr1" trampoline),
2044 * and if found, do the symbolization from the real-code address
2045 * rather than the stub address.
2047 * Assumptions being made about the minimal symbol table:
2048 * 1. lookup_minimal_symbol_by_pc() will return a trampoline only
2049 * if we're really in the trampoline. If we're beyond it (say
2050 * we're in "foo" in the above example), it'll have a closer
2051 * symbol (the "foo" text symbol for example) and will not
2052 * return the trampoline.
2053 * 2. lookup_minimal_symbol_text() will find a real text symbol
2054 * corresponding to the trampoline, and whose address will
2055 * be different than the trampoline address. I put in a sanity
2056 * check for the address being the same, to avoid an
2057 * infinite recursion.
2059 msymbol = lookup_minimal_symbol_by_pc (pc);
2060 if (msymbol != NULL)
2061 if (MSYMBOL_TYPE (msymbol) == mst_solib_trampoline)
2063 mfunsym = lookup_minimal_symbol_text (DEPRECATED_SYMBOL_NAME (msymbol), NULL, NULL);
2064 if (mfunsym == NULL)
2065 /* I eliminated this warning since it is coming out
2066 * in the following situation:
2067 * gdb shmain // test program with shared libraries
2068 * (gdb) break shr1 // function in shared lib
2069 * Warning: In stub for ...
2070 * In the above situation, the shared lib is not loaded yet,
2071 * so of course we can't find the real func/line info,
2072 * but the "break" still works, and the warning is annoying.
2073 * So I commented out the warning. RT */
2074 /* warning ("In stub for %s; unable to find real function/line info", DEPRECATED_SYMBOL_NAME (msymbol)) */ ;
2076 else if (SYMBOL_VALUE (mfunsym) == SYMBOL_VALUE (msymbol))
2077 /* Avoid infinite recursion */
2078 /* See above comment about why warning is commented out */
2079 /* warning ("In stub for %s; unable to find real function/line info", DEPRECATED_SYMBOL_NAME (msymbol)) */ ;
2082 return find_pc_line (SYMBOL_VALUE (mfunsym), 0);
2086 s = find_pc_sect_symtab (pc, section);
2089 /* if no symbol information, return previous pc */
2096 bv = BLOCKVECTOR (s);
2098 /* Look at all the symtabs that share this blockvector.
2099 They all have the same apriori range, that we found was right;
2100 but they have different line tables. */
2102 for (; s && BLOCKVECTOR (s) == bv; s = s->next)
2104 /* Find the best line in this symtab. */
2111 /* I think len can be zero if the symtab lacks line numbers
2112 (e.g. gcc -g1). (Either that or the LINETABLE is NULL;
2113 I'm not sure which, and maybe it depends on the symbol
2119 item = l->item; /* Get first line info */
2121 /* Is this file's first line closer than the first lines of other files?
2122 If so, record this file, and its first line, as best alternate. */
2123 if (item->pc > pc && (!alt || item->pc < alt->pc))
2129 for (i = 0; i < len; i++, item++)
2131 /* Leave prev pointing to the linetable entry for the last line
2132 that started at or before PC. */
2139 /* At this point, prev points at the line whose start addr is <= pc, and
2140 item points at the next line. If we ran off the end of the linetable
2141 (pc >= start of the last line), then prev == item. If pc < start of
2142 the first line, prev will not be set. */
2144 /* Is this file's best line closer than the best in the other files?
2145 If so, record this file, and its best line, as best so far. Don't
2146 save prev if it represents the end of a function (i.e. line number
2147 0) instead of a real line. */
2149 if (prev && prev->line && (!best || prev->pc > best->pc))
2154 /* Discard BEST_END if it's before the PC of the current BEST. */
2155 if (best_end <= best->pc)
2159 /* If another line (denoted by ITEM) is in the linetable and its
2160 PC is after BEST's PC, but before the current BEST_END, then
2161 use ITEM's PC as the new best_end. */
2162 if (best && i < len && item->pc > best->pc
2163 && (best_end == 0 || best_end > item->pc))
2164 best_end = item->pc;
2170 { /* If we didn't find any line # info, just
2176 val.symtab = alt_symtab;
2177 val.line = alt->line - 1;
2179 /* Don't return line 0, that means that we didn't find the line. */
2183 val.pc = BLOCK_END (BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK));
2187 else if (best->line == 0)
2189 /* If our best fit is in a range of PC's for which no line
2190 number info is available (line number is zero) then we didn't
2191 find any valid line information. */
2196 val.symtab = best_symtab;
2197 val.line = best->line;
2199 if (best_end && (!alt || best_end < alt->pc))
2204 val.end = BLOCK_END (BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK));
2206 val.section = section;
2210 /* Backward compatibility (no section) */
2212 struct symtab_and_line
2213 find_pc_line (CORE_ADDR pc, int notcurrent)
2217 section = find_pc_overlay (pc);
2218 if (pc_in_unmapped_range (pc, section))
2219 pc = overlay_mapped_address (pc, section);
2220 return find_pc_sect_line (pc, section, notcurrent);
2223 /* Find line number LINE in any symtab whose name is the same as
2226 If found, return the symtab that contains the linetable in which it was
2227 found, set *INDEX to the index in the linetable of the best entry
2228 found, and set *EXACT_MATCH nonzero if the value returned is an
2231 If not found, return NULL. */
2234 find_line_symtab (struct symtab *symtab, int line, int *index, int *exact_match)
2238 /* BEST_INDEX and BEST_LINETABLE identify the smallest linenumber > LINE
2242 struct linetable *best_linetable;
2243 struct symtab *best_symtab;
2245 /* First try looking it up in the given symtab. */
2246 best_linetable = LINETABLE (symtab);
2247 best_symtab = symtab;
2248 best_index = find_line_common (best_linetable, line, &exact);
2249 if (best_index < 0 || !exact)
2251 /* Didn't find an exact match. So we better keep looking for
2252 another symtab with the same name. In the case of xcoff,
2253 multiple csects for one source file (produced by IBM's FORTRAN
2254 compiler) produce multiple symtabs (this is unavoidable
2255 assuming csects can be at arbitrary places in memory and that
2256 the GLOBAL_BLOCK of a symtab has a begin and end address). */
2258 /* BEST is the smallest linenumber > LINE so far seen,
2259 or 0 if none has been seen so far.
2260 BEST_INDEX and BEST_LINETABLE identify the item for it. */
2263 struct objfile *objfile;
2266 if (best_index >= 0)
2267 best = best_linetable->item[best_index].line;
2271 ALL_SYMTABS (objfile, s)
2273 struct linetable *l;
2276 if (!STREQ (symtab->filename, s->filename))
2279 ind = find_line_common (l, line, &exact);
2289 if (best == 0 || l->item[ind].line < best)
2291 best = l->item[ind].line;
2304 *index = best_index;
2306 *exact_match = exact;
2311 /* Set the PC value for a given source file and line number and return true.
2312 Returns zero for invalid line number (and sets the PC to 0).
2313 The source file is specified with a struct symtab. */
2316 find_line_pc (struct symtab *symtab, int line, CORE_ADDR *pc)
2318 struct linetable *l;
2325 symtab = find_line_symtab (symtab, line, &ind, NULL);
2328 l = LINETABLE (symtab);
2329 *pc = l->item[ind].pc;
2336 /* Find the range of pc values in a line.
2337 Store the starting pc of the line into *STARTPTR
2338 and the ending pc (start of next line) into *ENDPTR.
2339 Returns 1 to indicate success.
2340 Returns 0 if could not find the specified line. */
2343 find_line_pc_range (struct symtab_and_line sal, CORE_ADDR *startptr,
2346 CORE_ADDR startaddr;
2347 struct symtab_and_line found_sal;
2350 if (startaddr == 0 && !find_line_pc (sal.symtab, sal.line, &startaddr))
2353 /* This whole function is based on address. For example, if line 10 has
2354 two parts, one from 0x100 to 0x200 and one from 0x300 to 0x400, then
2355 "info line *0x123" should say the line goes from 0x100 to 0x200
2356 and "info line *0x355" should say the line goes from 0x300 to 0x400.
2357 This also insures that we never give a range like "starts at 0x134
2358 and ends at 0x12c". */
2360 found_sal = find_pc_sect_line (startaddr, sal.section, 0);
2361 if (found_sal.line != sal.line)
2363 /* The specified line (sal) has zero bytes. */
2364 *startptr = found_sal.pc;
2365 *endptr = found_sal.pc;
2369 *startptr = found_sal.pc;
2370 *endptr = found_sal.end;
2375 /* Given a line table and a line number, return the index into the line
2376 table for the pc of the nearest line whose number is >= the specified one.
2377 Return -1 if none is found. The value is >= 0 if it is an index.
2379 Set *EXACT_MATCH nonzero if the value returned is an exact match. */
2382 find_line_common (register struct linetable *l, register int lineno,
2388 /* BEST is the smallest linenumber > LINENO so far seen,
2389 or 0 if none has been seen so far.
2390 BEST_INDEX identifies the item for it. */
2392 int best_index = -1;
2401 for (i = 0; i < len; i++)
2403 register struct linetable_entry *item = &(l->item[i]);
2405 if (item->line == lineno)
2407 /* Return the first (lowest address) entry which matches. */
2412 if (item->line > lineno && (best == 0 || item->line < best))
2419 /* If we got here, we didn't get an exact match. */
2426 find_pc_line_pc_range (CORE_ADDR pc, CORE_ADDR *startptr, CORE_ADDR *endptr)
2428 struct symtab_and_line sal;
2429 sal = find_pc_line (pc, 0);
2432 return sal.symtab != 0;
2435 /* Given a function symbol SYM, find the symtab and line for the start
2437 If the argument FUNFIRSTLINE is nonzero, we want the first line
2438 of real code inside the function. */
2440 struct symtab_and_line
2441 find_function_start_sal (struct symbol *sym, int funfirstline)
2444 struct symtab_and_line sal;
2446 pc = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
2447 fixup_symbol_section (sym, NULL);
2449 { /* skip "first line" of function (which is actually its prologue) */
2450 asection *section = SYMBOL_BFD_SECTION (sym);
2451 /* If function is in an unmapped overlay, use its unmapped LMA
2452 address, so that SKIP_PROLOGUE has something unique to work on */
2453 if (section_is_overlay (section) &&
2454 !section_is_mapped (section))
2455 pc = overlay_unmapped_address (pc, section);
2457 pc += FUNCTION_START_OFFSET;
2458 pc = SKIP_PROLOGUE (pc);
2460 /* For overlays, map pc back into its mapped VMA range */
2461 pc = overlay_mapped_address (pc, section);
2463 sal = find_pc_sect_line (pc, SYMBOL_BFD_SECTION (sym), 0);
2465 #ifdef PROLOGUE_FIRSTLINE_OVERLAP
2466 /* Convex: no need to suppress code on first line, if any */
2469 /* Check if SKIP_PROLOGUE left us in mid-line, and the next
2470 line is still part of the same function. */
2472 && BLOCK_START (SYMBOL_BLOCK_VALUE (sym)) <= sal.end
2473 && sal.end < BLOCK_END (SYMBOL_BLOCK_VALUE (sym)))
2475 /* First pc of next line */
2477 /* Recalculate the line number (might not be N+1). */
2478 sal = find_pc_sect_line (pc, SYMBOL_BFD_SECTION (sym), 0);
2486 /* If P is of the form "operator[ \t]+..." where `...' is
2487 some legitimate operator text, return a pointer to the
2488 beginning of the substring of the operator text.
2489 Otherwise, return "". */
2491 operator_chars (char *p, char **end)
2494 if (strncmp (p, "operator", 8))
2498 /* Don't get faked out by `operator' being part of a longer
2500 if (isalpha (*p) || *p == '_' || *p == '$' || *p == '\0')
2503 /* Allow some whitespace between `operator' and the operator symbol. */
2504 while (*p == ' ' || *p == '\t')
2507 /* Recognize 'operator TYPENAME'. */
2509 if (isalpha (*p) || *p == '_' || *p == '$')
2511 register char *q = p + 1;
2512 while (isalnum (*q) || *q == '_' || *q == '$')
2521 case '\\': /* regexp quoting */
2524 if (p[2] == '=') /* 'operator\*=' */
2526 else /* 'operator\*' */
2530 else if (p[1] == '[')
2533 error ("mismatched quoting on brackets, try 'operator\\[\\]'");
2534 else if (p[2] == '\\' && p[3] == ']')
2536 *end = p + 4; /* 'operator\[\]' */
2540 error ("nothing is allowed between '[' and ']'");
2544 /* Gratuitous qoute: skip it and move on. */
2566 if (p[0] == '-' && p[1] == '>')
2568 /* Struct pointer member operator 'operator->'. */
2571 *end = p + 3; /* 'operator->*' */
2574 else if (p[2] == '\\')
2576 *end = p + 4; /* Hopefully 'operator->\*' */
2581 *end = p + 2; /* 'operator->' */
2585 if (p[1] == '=' || p[1] == p[0])
2596 error ("`operator ()' must be specified without whitespace in `()'");
2601 error ("`operator ?:' must be specified without whitespace in `?:'");
2606 error ("`operator []' must be specified without whitespace in `[]'");
2610 error ("`operator %s' not supported", p);
2619 /* If FILE is not already in the table of files, return zero;
2620 otherwise return non-zero. Optionally add FILE to the table if ADD
2621 is non-zero. If *FIRST is non-zero, forget the old table
2624 filename_seen (const char *file, int add, int *first)
2626 /* Table of files seen so far. */
2627 static const char **tab = NULL;
2628 /* Allocated size of tab in elements.
2629 Start with one 256-byte block (when using GNU malloc.c).
2630 24 is the malloc overhead when range checking is in effect. */
2631 static int tab_alloc_size = (256 - 24) / sizeof (char *);
2632 /* Current size of tab in elements. */
2633 static int tab_cur_size;
2639 tab = (const char **) xmalloc (tab_alloc_size * sizeof (*tab));
2643 /* Is FILE in tab? */
2644 for (p = tab; p < tab + tab_cur_size; p++)
2645 if (strcmp (*p, file) == 0)
2648 /* No; maybe add it to tab. */
2651 if (tab_cur_size == tab_alloc_size)
2653 tab_alloc_size *= 2;
2654 tab = (const char **) xrealloc ((char *) tab,
2655 tab_alloc_size * sizeof (*tab));
2657 tab[tab_cur_size++] = file;
2663 /* Slave routine for sources_info. Force line breaks at ,'s.
2664 NAME is the name to print and *FIRST is nonzero if this is the first
2665 name printed. Set *FIRST to zero. */
2667 output_source_filename (char *name, int *first)
2669 /* Since a single source file can result in several partial symbol
2670 tables, we need to avoid printing it more than once. Note: if
2671 some of the psymtabs are read in and some are not, it gets
2672 printed both under "Source files for which symbols have been
2673 read" and "Source files for which symbols will be read in on
2674 demand". I consider this a reasonable way to deal with the
2675 situation. I'm not sure whether this can also happen for
2676 symtabs; it doesn't hurt to check. */
2678 /* Was NAME already seen? */
2679 if (filename_seen (name, 1, first))
2681 /* Yes; don't print it again. */
2684 /* No; print it and reset *FIRST. */
2691 printf_filtered (", ");
2695 fputs_filtered (name, gdb_stdout);
2699 sources_info (char *ignore, int from_tty)
2701 register struct symtab *s;
2702 register struct partial_symtab *ps;
2703 register struct objfile *objfile;
2706 if (!have_full_symbols () && !have_partial_symbols ())
2708 error ("No symbol table is loaded. Use the \"file\" command.");
2711 printf_filtered ("Source files for which symbols have been read in:\n\n");
2714 ALL_SYMTABS (objfile, s)
2716 output_source_filename (s->filename, &first);
2718 printf_filtered ("\n\n");
2720 printf_filtered ("Source files for which symbols will be read in on demand:\n\n");
2723 ALL_PSYMTABS (objfile, ps)
2727 output_source_filename (ps->filename, &first);
2730 printf_filtered ("\n");
2734 file_matches (char *file, char *files[], int nfiles)
2738 if (file != NULL && nfiles != 0)
2740 for (i = 0; i < nfiles; i++)
2742 if (strcmp (files[i], lbasename (file)) == 0)
2746 else if (nfiles == 0)
2751 /* Free any memory associated with a search. */
2753 free_search_symbols (struct symbol_search *symbols)
2755 struct symbol_search *p;
2756 struct symbol_search *next;
2758 for (p = symbols; p != NULL; p = next)
2766 do_free_search_symbols_cleanup (void *symbols)
2768 free_search_symbols (symbols);
2772 make_cleanup_free_search_symbols (struct symbol_search *symbols)
2774 return make_cleanup (do_free_search_symbols_cleanup, symbols);
2777 /* Helper function for sort_search_symbols and qsort. Can only
2778 sort symbols, not minimal symbols. */
2780 compare_search_syms (const void *sa, const void *sb)
2782 struct symbol_search **sym_a = (struct symbol_search **) sa;
2783 struct symbol_search **sym_b = (struct symbol_search **) sb;
2785 return strcmp (SYMBOL_PRINT_NAME ((*sym_a)->symbol),
2786 SYMBOL_PRINT_NAME ((*sym_b)->symbol));
2789 /* Sort the ``nfound'' symbols in the list after prevtail. Leave
2790 prevtail where it is, but update its next pointer to point to
2791 the first of the sorted symbols. */
2792 static struct symbol_search *
2793 sort_search_symbols (struct symbol_search *prevtail, int nfound)
2795 struct symbol_search **symbols, *symp, *old_next;
2798 symbols = (struct symbol_search **) xmalloc (sizeof (struct symbol_search *)
2800 symp = prevtail->next;
2801 for (i = 0; i < nfound; i++)
2806 /* Generally NULL. */
2809 qsort (symbols, nfound, sizeof (struct symbol_search *),
2810 compare_search_syms);
2813 for (i = 0; i < nfound; i++)
2815 symp->next = symbols[i];
2818 symp->next = old_next;
2824 /* Search the symbol table for matches to the regular expression REGEXP,
2825 returning the results in *MATCHES.
2827 Only symbols of KIND are searched:
2828 FUNCTIONS_DOMAIN - search all functions
2829 TYPES_DOMAIN - search all type names
2830 METHODS_DOMAIN - search all methods NOT IMPLEMENTED
2831 VARIABLES_DOMAIN - search all symbols, excluding functions, type names,
2832 and constants (enums)
2834 free_search_symbols should be called when *MATCHES is no longer needed.
2836 The results are sorted locally; each symtab's global and static blocks are
2837 separately alphabetized.
2840 search_symbols (char *regexp, domain_enum kind, int nfiles, char *files[],
2841 struct symbol_search **matches)
2843 register struct symtab *s;
2844 register struct partial_symtab *ps;
2845 register struct blockvector *bv;
2846 struct blockvector *prev_bv = 0;
2847 register struct block *b;
2850 register struct symbol *sym;
2851 struct partial_symbol **psym;
2852 struct objfile *objfile;
2853 struct minimal_symbol *msymbol;
2856 static enum minimal_symbol_type types[]
2858 {mst_data, mst_text, mst_abs, mst_unknown};
2859 static enum minimal_symbol_type types2[]
2861 {mst_bss, mst_file_text, mst_abs, mst_unknown};
2862 static enum minimal_symbol_type types3[]
2864 {mst_file_data, mst_solib_trampoline, mst_abs, mst_unknown};
2865 static enum minimal_symbol_type types4[]
2867 {mst_file_bss, mst_text, mst_abs, mst_unknown};
2868 enum minimal_symbol_type ourtype;
2869 enum minimal_symbol_type ourtype2;
2870 enum minimal_symbol_type ourtype3;
2871 enum minimal_symbol_type ourtype4;
2872 struct symbol_search *sr;
2873 struct symbol_search *psr;
2874 struct symbol_search *tail;
2875 struct cleanup *old_chain = NULL;
2877 if (kind < VARIABLES_DOMAIN)
2878 error ("must search on specific domain");
2880 ourtype = types[(int) (kind - VARIABLES_DOMAIN)];
2881 ourtype2 = types2[(int) (kind - VARIABLES_DOMAIN)];
2882 ourtype3 = types3[(int) (kind - VARIABLES_DOMAIN)];
2883 ourtype4 = types4[(int) (kind - VARIABLES_DOMAIN)];
2885 sr = *matches = NULL;
2890 /* Make sure spacing is right for C++ operators.
2891 This is just a courtesy to make the matching less sensitive
2892 to how many spaces the user leaves between 'operator'
2893 and <TYPENAME> or <OPERATOR>. */
2895 char *opname = operator_chars (regexp, &opend);
2898 int fix = -1; /* -1 means ok; otherwise number of spaces needed. */
2899 if (isalpha (*opname) || *opname == '_' || *opname == '$')
2901 /* There should 1 space between 'operator' and 'TYPENAME'. */
2902 if (opname[-1] != ' ' || opname[-2] == ' ')
2907 /* There should 0 spaces between 'operator' and 'OPERATOR'. */
2908 if (opname[-1] == ' ')
2911 /* If wrong number of spaces, fix it. */
2914 char *tmp = (char *) alloca (8 + fix + strlen (opname) + 1);
2915 sprintf (tmp, "operator%.*s%s", fix, " ", opname);
2920 if (0 != (val = re_comp (regexp)))
2921 error ("Invalid regexp (%s): %s", val, regexp);
2924 /* Search through the partial symtabs *first* for all symbols
2925 matching the regexp. That way we don't have to reproduce all of
2926 the machinery below. */
2928 ALL_PSYMTABS (objfile, ps)
2930 struct partial_symbol **bound, **gbound, **sbound;
2936 gbound = objfile->global_psymbols.list + ps->globals_offset + ps->n_global_syms;
2937 sbound = objfile->static_psymbols.list + ps->statics_offset + ps->n_static_syms;
2940 /* Go through all of the symbols stored in a partial
2941 symtab in one loop. */
2942 psym = objfile->global_psymbols.list + ps->globals_offset;
2947 if (bound == gbound && ps->n_static_syms != 0)
2949 psym = objfile->static_psymbols.list + ps->statics_offset;
2960 /* If it would match (logic taken from loop below)
2961 load the file and go on to the next one */
2962 if (file_matches (ps->filename, files, nfiles)
2964 || re_exec (SYMBOL_NATURAL_NAME (*psym)) != 0)
2965 && ((kind == VARIABLES_DOMAIN && SYMBOL_CLASS (*psym) != LOC_TYPEDEF
2966 && SYMBOL_CLASS (*psym) != LOC_BLOCK)
2967 || (kind == FUNCTIONS_DOMAIN && SYMBOL_CLASS (*psym) == LOC_BLOCK)
2968 || (kind == TYPES_DOMAIN && SYMBOL_CLASS (*psym) == LOC_TYPEDEF)
2969 || (kind == METHODS_DOMAIN && SYMBOL_CLASS (*psym) == LOC_BLOCK))))
2971 PSYMTAB_TO_SYMTAB (ps);
2979 /* Here, we search through the minimal symbol tables for functions
2980 and variables that match, and force their symbols to be read.
2981 This is in particular necessary for demangled variable names,
2982 which are no longer put into the partial symbol tables.
2983 The symbol will then be found during the scan of symtabs below.
2985 For functions, find_pc_symtab should succeed if we have debug info
2986 for the function, for variables we have to call lookup_symbol
2987 to determine if the variable has debug info.
2988 If the lookup fails, set found_misc so that we will rescan to print
2989 any matching symbols without debug info.
2992 if (nfiles == 0 && (kind == VARIABLES_DOMAIN || kind == FUNCTIONS_DOMAIN))
2994 ALL_MSYMBOLS (objfile, msymbol)
2996 if (MSYMBOL_TYPE (msymbol) == ourtype ||
2997 MSYMBOL_TYPE (msymbol) == ourtype2 ||
2998 MSYMBOL_TYPE (msymbol) == ourtype3 ||
2999 MSYMBOL_TYPE (msymbol) == ourtype4)
3002 || re_exec (SYMBOL_NATURAL_NAME (msymbol)) != 0)
3004 if (0 == find_pc_symtab (SYMBOL_VALUE_ADDRESS (msymbol)))
3006 /* FIXME: carlton/2003-02-04: Given that the
3007 semantics of lookup_symbol keeps on changing
3008 slightly, it would be a nice idea if we had a
3009 function lookup_symbol_minsym that found the
3010 symbol associated to a given minimal symbol (if
3012 if (kind == FUNCTIONS_DOMAIN
3013 || lookup_symbol (DEPRECATED_SYMBOL_NAME (msymbol),
3014 (struct block *) NULL,
3016 0, (struct symtab **) NULL) == NULL)
3024 ALL_SYMTABS (objfile, s)
3026 bv = BLOCKVECTOR (s);
3027 /* Often many files share a blockvector.
3028 Scan each blockvector only once so that
3029 we don't get every symbol many times.
3030 It happens that the first symtab in the list
3031 for any given blockvector is the main file. */
3033 for (i = GLOBAL_BLOCK; i <= STATIC_BLOCK; i++)
3035 struct symbol_search *prevtail = tail;
3037 b = BLOCKVECTOR_BLOCK (bv, i);
3038 ALL_BLOCK_SYMBOLS (b, j, sym)
3041 if (file_matches (s->filename, files, nfiles)
3043 || re_exec (SYMBOL_NATURAL_NAME (sym)) != 0)
3044 && ((kind == VARIABLES_DOMAIN && SYMBOL_CLASS (sym) != LOC_TYPEDEF
3045 && SYMBOL_CLASS (sym) != LOC_BLOCK
3046 && SYMBOL_CLASS (sym) != LOC_CONST)
3047 || (kind == FUNCTIONS_DOMAIN && SYMBOL_CLASS (sym) == LOC_BLOCK)
3048 || (kind == TYPES_DOMAIN && SYMBOL_CLASS (sym) == LOC_TYPEDEF)
3049 || (kind == METHODS_DOMAIN && SYMBOL_CLASS (sym) == LOC_BLOCK))))
3052 psr = (struct symbol_search *) xmalloc (sizeof (struct symbol_search));
3056 psr->msymbol = NULL;
3068 if (prevtail == NULL)
3070 struct symbol_search dummy;
3073 tail = sort_search_symbols (&dummy, nfound);
3076 old_chain = make_cleanup_free_search_symbols (sr);
3079 tail = sort_search_symbols (prevtail, nfound);
3085 /* If there are no eyes, avoid all contact. I mean, if there are
3086 no debug symbols, then print directly from the msymbol_vector. */
3088 if (found_misc || kind != FUNCTIONS_DOMAIN)
3090 ALL_MSYMBOLS (objfile, msymbol)
3092 if (MSYMBOL_TYPE (msymbol) == ourtype ||
3093 MSYMBOL_TYPE (msymbol) == ourtype2 ||
3094 MSYMBOL_TYPE (msymbol) == ourtype3 ||
3095 MSYMBOL_TYPE (msymbol) == ourtype4)
3098 || re_exec (SYMBOL_NATURAL_NAME (msymbol)) != 0)
3100 /* Functions: Look up by address. */
3101 if (kind != FUNCTIONS_DOMAIN ||
3102 (0 == find_pc_symtab (SYMBOL_VALUE_ADDRESS (msymbol))))
3104 /* Variables/Absolutes: Look up by name */
3105 if (lookup_symbol (DEPRECATED_SYMBOL_NAME (msymbol),
3106 (struct block *) NULL, VAR_DOMAIN,
3107 0, (struct symtab **) NULL) == NULL)
3110 psr = (struct symbol_search *) xmalloc (sizeof (struct symbol_search));
3112 psr->msymbol = msymbol;
3119 old_chain = make_cleanup_free_search_symbols (sr);
3133 discard_cleanups (old_chain);
3136 /* Helper function for symtab_symbol_info, this function uses
3137 the data returned from search_symbols() to print information
3138 regarding the match to gdb_stdout.
3141 print_symbol_info (domain_enum kind, struct symtab *s, struct symbol *sym,
3142 int block, char *last)
3144 if (last == NULL || strcmp (last, s->filename) != 0)
3146 fputs_filtered ("\nFile ", gdb_stdout);
3147 fputs_filtered (s->filename, gdb_stdout);
3148 fputs_filtered (":\n", gdb_stdout);
3151 if (kind != TYPES_DOMAIN && block == STATIC_BLOCK)
3152 printf_filtered ("static ");
3154 /* Typedef that is not a C++ class */
3155 if (kind == TYPES_DOMAIN
3156 && SYMBOL_DOMAIN (sym) != STRUCT_DOMAIN)
3157 typedef_print (SYMBOL_TYPE (sym), sym, gdb_stdout);
3158 /* variable, func, or typedef-that-is-c++-class */
3159 else if (kind < TYPES_DOMAIN ||
3160 (kind == TYPES_DOMAIN &&
3161 SYMBOL_DOMAIN (sym) == STRUCT_DOMAIN))
3163 type_print (SYMBOL_TYPE (sym),
3164 (SYMBOL_CLASS (sym) == LOC_TYPEDEF
3165 ? "" : SYMBOL_PRINT_NAME (sym)),
3168 printf_filtered (";\n");
3172 /* This help function for symtab_symbol_info() prints information
3173 for non-debugging symbols to gdb_stdout.
3176 print_msymbol_info (struct minimal_symbol *msymbol)
3180 if (TARGET_ADDR_BIT <= 32)
3181 tmp = local_hex_string_custom (SYMBOL_VALUE_ADDRESS (msymbol)
3182 & (CORE_ADDR) 0xffffffff,
3185 tmp = local_hex_string_custom (SYMBOL_VALUE_ADDRESS (msymbol),
3187 printf_filtered ("%s %s\n",
3188 tmp, SYMBOL_PRINT_NAME (msymbol));
3191 /* This is the guts of the commands "info functions", "info types", and
3192 "info variables". It calls search_symbols to find all matches and then
3193 print_[m]symbol_info to print out some useful information about the
3197 symtab_symbol_info (char *regexp, domain_enum kind, int from_tty)
3199 static char *classnames[]
3201 {"variable", "function", "type", "method"};
3202 struct symbol_search *symbols;
3203 struct symbol_search *p;
3204 struct cleanup *old_chain;
3205 char *last_filename = NULL;
3208 /* must make sure that if we're interrupted, symbols gets freed */
3209 search_symbols (regexp, kind, 0, (char **) NULL, &symbols);
3210 old_chain = make_cleanup_free_search_symbols (symbols);
3212 printf_filtered (regexp
3213 ? "All %ss matching regular expression \"%s\":\n"
3214 : "All defined %ss:\n",
3215 classnames[(int) (kind - VARIABLES_DOMAIN)], regexp);
3217 for (p = symbols; p != NULL; p = p->next)
3221 if (p->msymbol != NULL)
3225 printf_filtered ("\nNon-debugging symbols:\n");
3228 print_msymbol_info (p->msymbol);
3232 print_symbol_info (kind,
3237 last_filename = p->symtab->filename;
3241 do_cleanups (old_chain);
3245 variables_info (char *regexp, int from_tty)
3247 symtab_symbol_info (regexp, VARIABLES_DOMAIN, from_tty);
3251 functions_info (char *regexp, int from_tty)
3253 symtab_symbol_info (regexp, FUNCTIONS_DOMAIN, from_tty);
3258 types_info (char *regexp, int from_tty)
3260 symtab_symbol_info (regexp, TYPES_DOMAIN, from_tty);
3263 /* Breakpoint all functions matching regular expression. */
3266 rbreak_command_wrapper (char *regexp, int from_tty)
3268 rbreak_command (regexp, from_tty);
3272 rbreak_command (char *regexp, int from_tty)
3274 struct symbol_search *ss;
3275 struct symbol_search *p;
3276 struct cleanup *old_chain;
3278 search_symbols (regexp, FUNCTIONS_DOMAIN, 0, (char **) NULL, &ss);
3279 old_chain = make_cleanup_free_search_symbols (ss);
3281 for (p = ss; p != NULL; p = p->next)
3283 if (p->msymbol == NULL)
3285 char *string = (char *) alloca (strlen (p->symtab->filename)
3286 + strlen (DEPRECATED_SYMBOL_NAME (p->symbol))
3288 strcpy (string, p->symtab->filename);
3289 strcat (string, ":'");
3290 strcat (string, DEPRECATED_SYMBOL_NAME (p->symbol));
3291 strcat (string, "'");
3292 break_command (string, from_tty);
3293 print_symbol_info (FUNCTIONS_DOMAIN,
3297 p->symtab->filename);
3301 break_command (DEPRECATED_SYMBOL_NAME (p->msymbol), from_tty);
3302 printf_filtered ("<function, no debug info> %s;\n",
3303 SYMBOL_PRINT_NAME (p->msymbol));
3307 do_cleanups (old_chain);
3311 /* Helper routine for make_symbol_completion_list. */
3313 static int return_val_size;
3314 static int return_val_index;
3315 static char **return_val;
3317 #define COMPLETION_LIST_ADD_SYMBOL(symbol, sym_text, len, text, word) \
3319 if (SYMBOL_DEMANGLED_NAME (symbol) != NULL) \
3320 /* Put only the mangled name on the list. */ \
3321 /* Advantage: "b foo<TAB>" completes to "b foo(int, int)" */ \
3322 /* Disadvantage: "b foo__i<TAB>" doesn't complete. */ \
3323 completion_list_add_name \
3324 (SYMBOL_DEMANGLED_NAME (symbol), (sym_text), (len), (text), (word)); \
3326 completion_list_add_name \
3327 (DEPRECATED_SYMBOL_NAME (symbol), (sym_text), (len), (text), (word)); \
3330 /* Test to see if the symbol specified by SYMNAME (which is already
3331 demangled for C++ symbols) matches SYM_TEXT in the first SYM_TEXT_LEN
3332 characters. If so, add it to the current completion list. */
3335 completion_list_add_name (char *symname, char *sym_text, int sym_text_len,
3336 char *text, char *word)
3341 /* clip symbols that cannot match */
3343 if (strncmp (symname, sym_text, sym_text_len) != 0)
3348 /* We have a match for a completion, so add SYMNAME to the current list
3349 of matches. Note that the name is moved to freshly malloc'd space. */
3353 if (word == sym_text)
3355 new = xmalloc (strlen (symname) + 5);
3356 strcpy (new, symname);
3358 else if (word > sym_text)
3360 /* Return some portion of symname. */
3361 new = xmalloc (strlen (symname) + 5);
3362 strcpy (new, symname + (word - sym_text));
3366 /* Return some of SYM_TEXT plus symname. */
3367 new = xmalloc (strlen (symname) + (sym_text - word) + 5);
3368 strncpy (new, word, sym_text - word);
3369 new[sym_text - word] = '\0';
3370 strcat (new, symname);
3373 if (return_val_index + 3 > return_val_size)
3375 newsize = (return_val_size *= 2) * sizeof (char *);
3376 return_val = (char **) xrealloc ((char *) return_val, newsize);
3378 return_val[return_val_index++] = new;
3379 return_val[return_val_index] = NULL;
3383 /* Return a NULL terminated array of all symbols (regardless of class)
3384 which begin by matching TEXT. If the answer is no symbols, then
3385 the return value is an array which contains only a NULL pointer.
3387 Problem: All of the symbols have to be copied because readline frees them.
3388 I'm not going to worry about this; hopefully there won't be that many. */
3391 make_symbol_completion_list (char *text, char *word)
3393 register struct symbol *sym;
3394 register struct symtab *s;
3395 register struct partial_symtab *ps;
3396 register struct minimal_symbol *msymbol;
3397 register struct objfile *objfile;
3398 register struct block *b, *surrounding_static_block = 0;
3400 struct partial_symbol **psym;
3401 /* The symbol we are completing on. Points in same buffer as text. */
3403 /* Length of sym_text. */
3406 /* Now look for the symbol we are supposed to complete on.
3407 FIXME: This should be language-specific. */
3411 char *quote_pos = NULL;
3413 /* First see if this is a quoted string. */
3415 for (p = text; *p != '\0'; ++p)
3417 if (quote_found != '\0')
3419 if (*p == quote_found)
3420 /* Found close quote. */
3422 else if (*p == '\\' && p[1] == quote_found)
3423 /* A backslash followed by the quote character
3424 doesn't end the string. */
3427 else if (*p == '\'' || *p == '"')
3433 if (quote_found == '\'')
3434 /* A string within single quotes can be a symbol, so complete on it. */
3435 sym_text = quote_pos + 1;
3436 else if (quote_found == '"')
3437 /* A double-quoted string is never a symbol, nor does it make sense
3438 to complete it any other way. */
3440 return_val = (char **) xmalloc (sizeof (char *));
3441 return_val[0] = NULL;
3446 /* It is not a quoted string. Break it based on the characters
3447 which are in symbols. */
3450 if (isalnum (p[-1]) || p[-1] == '_' || p[-1] == '\0')
3459 sym_text_len = strlen (sym_text);
3461 return_val_size = 100;
3462 return_val_index = 0;
3463 return_val = (char **) xmalloc ((return_val_size + 1) * sizeof (char *));
3464 return_val[0] = NULL;
3466 /* Look through the partial symtabs for all symbols which begin
3467 by matching SYM_TEXT. Add each one that you find to the list. */
3469 ALL_PSYMTABS (objfile, ps)
3471 /* If the psymtab's been read in we'll get it when we search
3472 through the blockvector. */
3476 for (psym = objfile->global_psymbols.list + ps->globals_offset;
3477 psym < (objfile->global_psymbols.list + ps->globals_offset
3478 + ps->n_global_syms);
3481 /* If interrupted, then quit. */
3483 COMPLETION_LIST_ADD_SYMBOL (*psym, sym_text, sym_text_len, text, word);
3486 for (psym = objfile->static_psymbols.list + ps->statics_offset;
3487 psym < (objfile->static_psymbols.list + ps->statics_offset
3488 + ps->n_static_syms);
3492 COMPLETION_LIST_ADD_SYMBOL (*psym, sym_text, sym_text_len, text, word);
3496 /* At this point scan through the misc symbol vectors and add each
3497 symbol you find to the list. Eventually we want to ignore
3498 anything that isn't a text symbol (everything else will be
3499 handled by the psymtab code above). */
3501 ALL_MSYMBOLS (objfile, msymbol)
3504 COMPLETION_LIST_ADD_SYMBOL (msymbol, sym_text, sym_text_len, text, word);
3507 /* Search upwards from currently selected frame (so that we can
3508 complete on local vars. */
3510 for (b = get_selected_block (0); b != NULL; b = BLOCK_SUPERBLOCK (b))
3512 if (!BLOCK_SUPERBLOCK (b))
3514 surrounding_static_block = b; /* For elmin of dups */
3517 /* Also catch fields of types defined in this places which match our
3518 text string. Only complete on types visible from current context. */
3520 ALL_BLOCK_SYMBOLS (b, i, sym)
3522 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3523 if (SYMBOL_CLASS (sym) == LOC_TYPEDEF)
3525 struct type *t = SYMBOL_TYPE (sym);
3526 enum type_code c = TYPE_CODE (t);
3528 if (c == TYPE_CODE_UNION || c == TYPE_CODE_STRUCT)
3530 for (j = TYPE_N_BASECLASSES (t); j < TYPE_NFIELDS (t); j++)
3532 if (TYPE_FIELD_NAME (t, j))
3534 completion_list_add_name (TYPE_FIELD_NAME (t, j),
3535 sym_text, sym_text_len, text, word);
3543 /* Go through the symtabs and check the externs and statics for
3544 symbols which match. */
3546 ALL_SYMTABS (objfile, s)
3549 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), GLOBAL_BLOCK);
3550 ALL_BLOCK_SYMBOLS (b, i, sym)
3552 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3556 ALL_SYMTABS (objfile, s)
3559 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), STATIC_BLOCK);
3560 /* Don't do this block twice. */
3561 if (b == surrounding_static_block)
3563 ALL_BLOCK_SYMBOLS (b, i, sym)
3565 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3569 return (return_val);
3572 /* Like make_symbol_completion_list, but returns a list of symbols
3573 defined in a source file FILE. */
3576 make_file_symbol_completion_list (char *text, char *word, char *srcfile)
3578 register struct symbol *sym;
3579 register struct symtab *s;
3580 register struct block *b;
3582 /* The symbol we are completing on. Points in same buffer as text. */
3584 /* Length of sym_text. */
3587 /* Now look for the symbol we are supposed to complete on.
3588 FIXME: This should be language-specific. */
3592 char *quote_pos = NULL;
3594 /* First see if this is a quoted string. */
3596 for (p = text; *p != '\0'; ++p)
3598 if (quote_found != '\0')
3600 if (*p == quote_found)
3601 /* Found close quote. */
3603 else if (*p == '\\' && p[1] == quote_found)
3604 /* A backslash followed by the quote character
3605 doesn't end the string. */
3608 else if (*p == '\'' || *p == '"')
3614 if (quote_found == '\'')
3615 /* A string within single quotes can be a symbol, so complete on it. */
3616 sym_text = quote_pos + 1;
3617 else if (quote_found == '"')
3618 /* A double-quoted string is never a symbol, nor does it make sense
3619 to complete it any other way. */
3621 return_val = (char **) xmalloc (sizeof (char *));
3622 return_val[0] = NULL;
3627 /* It is not a quoted string. Break it based on the characters
3628 which are in symbols. */
3631 if (isalnum (p[-1]) || p[-1] == '_' || p[-1] == '\0')
3640 sym_text_len = strlen (sym_text);
3642 return_val_size = 10;
3643 return_val_index = 0;
3644 return_val = (char **) xmalloc ((return_val_size + 1) * sizeof (char *));
3645 return_val[0] = NULL;
3647 /* Find the symtab for SRCFILE (this loads it if it was not yet read
3649 s = lookup_symtab (srcfile);
3652 /* Maybe they typed the file with leading directories, while the
3653 symbol tables record only its basename. */
3654 const char *tail = lbasename (srcfile);
3657 s = lookup_symtab (tail);
3660 /* If we have no symtab for that file, return an empty list. */
3662 return (return_val);
3664 /* Go through this symtab and check the externs and statics for
3665 symbols which match. */
3667 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), GLOBAL_BLOCK);
3668 ALL_BLOCK_SYMBOLS (b, i, sym)
3670 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3673 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), STATIC_BLOCK);
3674 ALL_BLOCK_SYMBOLS (b, i, sym)
3676 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3679 return (return_val);
3682 /* A helper function for make_source_files_completion_list. It adds
3683 another file name to a list of possible completions, growing the
3684 list as necessary. */
3687 add_filename_to_list (const char *fname, char *text, char *word,
3688 char ***list, int *list_used, int *list_alloced)
3691 size_t fnlen = strlen (fname);
3693 if (*list_used + 1 >= *list_alloced)
3696 *list = (char **) xrealloc ((char *) *list,
3697 *list_alloced * sizeof (char *));
3702 /* Return exactly fname. */
3703 new = xmalloc (fnlen + 5);
3704 strcpy (new, fname);
3706 else if (word > text)
3708 /* Return some portion of fname. */
3709 new = xmalloc (fnlen + 5);
3710 strcpy (new, fname + (word - text));
3714 /* Return some of TEXT plus fname. */
3715 new = xmalloc (fnlen + (text - word) + 5);
3716 strncpy (new, word, text - word);
3717 new[text - word] = '\0';
3718 strcat (new, fname);
3720 (*list)[*list_used] = new;
3721 (*list)[++*list_used] = NULL;
3725 not_interesting_fname (const char *fname)
3727 static const char *illegal_aliens[] = {
3728 "_globals_", /* inserted by coff_symtab_read */
3733 for (i = 0; illegal_aliens[i]; i++)
3735 if (strcmp (fname, illegal_aliens[i]) == 0)
3741 /* Return a NULL terminated array of all source files whose names
3742 begin with matching TEXT. The file names are looked up in the
3743 symbol tables of this program. If the answer is no matchess, then
3744 the return value is an array which contains only a NULL pointer. */
3747 make_source_files_completion_list (char *text, char *word)
3749 register struct symtab *s;
3750 register struct partial_symtab *ps;
3751 register struct objfile *objfile;
3753 int list_alloced = 1;
3755 size_t text_len = strlen (text);
3756 char **list = (char **) xmalloc (list_alloced * sizeof (char *));
3757 const char *base_name;
3761 if (!have_full_symbols () && !have_partial_symbols ())
3764 ALL_SYMTABS (objfile, s)
3766 if (not_interesting_fname (s->filename))
3768 if (!filename_seen (s->filename, 1, &first)
3769 #if HAVE_DOS_BASED_FILE_SYSTEM
3770 && strncasecmp (s->filename, text, text_len) == 0
3772 && strncmp (s->filename, text, text_len) == 0
3776 /* This file matches for a completion; add it to the current
3778 add_filename_to_list (s->filename, text, word,
3779 &list, &list_used, &list_alloced);
3783 /* NOTE: We allow the user to type a base name when the
3784 debug info records leading directories, but not the other
3785 way around. This is what subroutines of breakpoint
3786 command do when they parse file names. */
3787 base_name = lbasename (s->filename);
3788 if (base_name != s->filename
3789 && !filename_seen (base_name, 1, &first)
3790 #if HAVE_DOS_BASED_FILE_SYSTEM
3791 && strncasecmp (base_name, text, text_len) == 0
3793 && strncmp (base_name, text, text_len) == 0
3796 add_filename_to_list (base_name, text, word,
3797 &list, &list_used, &list_alloced);
3801 ALL_PSYMTABS (objfile, ps)
3803 if (not_interesting_fname (ps->filename))
3807 if (!filename_seen (ps->filename, 1, &first)
3808 #if HAVE_DOS_BASED_FILE_SYSTEM
3809 && strncasecmp (ps->filename, text, text_len) == 0
3811 && strncmp (ps->filename, text, text_len) == 0
3815 /* This file matches for a completion; add it to the
3816 current list of matches. */
3817 add_filename_to_list (ps->filename, text, word,
3818 &list, &list_used, &list_alloced);
3823 base_name = lbasename (ps->filename);
3824 if (base_name != ps->filename
3825 && !filename_seen (base_name, 1, &first)
3826 #if HAVE_DOS_BASED_FILE_SYSTEM
3827 && strncasecmp (base_name, text, text_len) == 0
3829 && strncmp (base_name, text, text_len) == 0
3832 add_filename_to_list (base_name, text, word,
3833 &list, &list_used, &list_alloced);
3841 /* Determine if PC is in the prologue of a function. The prologue is the area
3842 between the first instruction of a function, and the first executable line.
3843 Returns 1 if PC *might* be in prologue, 0 if definately *not* in prologue.
3845 If non-zero, func_start is where we think the prologue starts, possibly
3846 by previous examination of symbol table information.
3850 in_prologue (CORE_ADDR pc, CORE_ADDR func_start)
3852 struct symtab_and_line sal;
3853 CORE_ADDR func_addr, func_end;
3855 /* We have several sources of information we can consult to figure
3857 - Compilers usually emit line number info that marks the prologue
3858 as its own "source line". So the ending address of that "line"
3859 is the end of the prologue. If available, this is the most
3861 - The minimal symbols and partial symbols, which can usually tell
3862 us the starting and ending addresses of a function.
3863 - If we know the function's start address, we can call the
3864 architecture-defined SKIP_PROLOGUE function to analyze the
3865 instruction stream and guess where the prologue ends.
3866 - Our `func_start' argument; if non-zero, this is the caller's
3867 best guess as to the function's entry point. At the time of
3868 this writing, handle_inferior_event doesn't get this right, so
3869 it should be our last resort. */
3871 /* Consult the partial symbol table, to find which function
3873 if (! find_pc_partial_function (pc, NULL, &func_addr, &func_end))
3875 CORE_ADDR prologue_end;
3877 /* We don't even have minsym information, so fall back to using
3878 func_start, if given. */
3880 return 1; /* We *might* be in a prologue. */
3882 prologue_end = SKIP_PROLOGUE (func_start);
3884 return func_start <= pc && pc < prologue_end;
3887 /* If we have line number information for the function, that's
3888 usually pretty reliable. */
3889 sal = find_pc_line (func_addr, 0);
3891 /* Now sal describes the source line at the function's entry point,
3892 which (by convention) is the prologue. The end of that "line",
3893 sal.end, is the end of the prologue.
3895 Note that, for functions whose source code is all on a single
3896 line, the line number information doesn't always end up this way.
3897 So we must verify that our purported end-of-prologue address is
3898 *within* the function, not at its start or end. */
3900 || sal.end <= func_addr
3901 || func_end <= sal.end)
3903 /* We don't have any good line number info, so use the minsym
3904 information, together with the architecture-specific prologue
3906 CORE_ADDR prologue_end = SKIP_PROLOGUE (func_addr);
3908 return func_addr <= pc && pc < prologue_end;
3911 /* We have line number info, and it looks good. */
3912 return func_addr <= pc && pc < sal.end;
3916 /* Begin overload resolution functions */
3919 remove_params (const char *demangled_name)
3925 if (demangled_name == NULL)
3928 /* First find the end of the arg list. */
3929 argp = strrchr (demangled_name, ')');
3933 /* Back up to the beginning. */
3936 while (argp-- > demangled_name)
3940 else if (*argp == '(')
3949 internal_error (__FILE__, __LINE__,
3950 "bad demangled name %s\n", demangled_name);
3951 while (argp[-1] == ' ' && argp > demangled_name)
3954 new_name = xmalloc (argp - demangled_name + 1);
3955 memcpy (new_name, demangled_name, argp - demangled_name);
3956 new_name[argp - demangled_name] = '\0';
3960 /* Helper routine for make_symbol_completion_list. */
3962 static int sym_return_val_size;
3963 static int sym_return_val_index;
3964 static struct symbol **sym_return_val;
3966 /* Test to see if the symbol specified by SYMNAME (which is already
3967 demangled for C++ symbols) matches SYM_TEXT in the first SYM_TEXT_LEN
3968 characters. If so, add it to the current completion list. */
3971 overload_list_add_symbol (struct symbol *sym, char *oload_name)
3977 /* If there is no type information, we can't do anything, so skip */
3978 if (SYMBOL_TYPE (sym) == NULL)
3981 /* skip any symbols that we've already considered. */
3982 for (i = 0; i < sym_return_val_index; ++i)
3983 if (!strcmp (DEPRECATED_SYMBOL_NAME (sym), DEPRECATED_SYMBOL_NAME (sym_return_val[i])))
3986 /* Get the demangled name without parameters */
3987 sym_name = remove_params (SYMBOL_DEMANGLED_NAME (sym));
3991 /* skip symbols that cannot match */
3992 if (strcmp (sym_name, oload_name) != 0)
4000 /* We have a match for an overload instance, so add SYM to the current list
4001 * of overload instances */
4002 if (sym_return_val_index + 3 > sym_return_val_size)
4004 newsize = (sym_return_val_size *= 2) * sizeof (struct symbol *);
4005 sym_return_val = (struct symbol **) xrealloc ((char *) sym_return_val, newsize);
4007 sym_return_val[sym_return_val_index++] = sym;
4008 sym_return_val[sym_return_val_index] = NULL;
4011 /* Return a null-terminated list of pointers to function symbols that
4012 * match name of the supplied symbol FSYM.
4013 * This is used in finding all overloaded instances of a function name.
4014 * This has been modified from make_symbol_completion_list. */
4018 make_symbol_overload_list (struct symbol *fsym)
4020 register struct symbol *sym;
4021 register struct symtab *s;
4022 register struct partial_symtab *ps;
4023 register struct objfile *objfile;
4024 register struct block *b, *surrounding_static_block = 0;
4026 /* The name we are completing on. */
4027 char *oload_name = NULL;
4028 /* Length of name. */
4029 int oload_name_len = 0;
4031 /* Look for the symbol we are supposed to complete on. */
4033 oload_name = remove_params (SYMBOL_DEMANGLED_NAME (fsym));
4036 sym_return_val_size = 1;
4037 sym_return_val = (struct symbol **) xmalloc (2 * sizeof (struct symbol *));
4038 sym_return_val[0] = fsym;
4039 sym_return_val[1] = NULL;
4041 return sym_return_val;
4043 oload_name_len = strlen (oload_name);
4045 sym_return_val_size = 100;
4046 sym_return_val_index = 0;
4047 sym_return_val = (struct symbol **) xmalloc ((sym_return_val_size + 1) * sizeof (struct symbol *));
4048 sym_return_val[0] = NULL;
4050 /* Read in all partial symtabs containing a partial symbol named
4053 ALL_PSYMTABS (objfile, ps)
4055 struct partial_symbol **psym;
4057 /* If the psymtab's been read in we'll get it when we search
4058 through the blockvector. */
4062 if ((lookup_partial_symbol (ps, oload_name, NULL, 1, VAR_DOMAIN)
4064 || (lookup_partial_symbol (ps, oload_name, NULL, 0, VAR_DOMAIN)
4066 PSYMTAB_TO_SYMTAB (ps);
4069 /* Search upwards from currently selected frame (so that we can
4070 complete on local vars. */
4072 for (b = get_selected_block (0); b != NULL; b = BLOCK_SUPERBLOCK (b))
4074 if (!BLOCK_SUPERBLOCK (b))
4076 surrounding_static_block = b; /* For elimination of dups */
4079 /* Also catch fields of types defined in this places which match our
4080 text string. Only complete on types visible from current context. */
4082 ALL_BLOCK_SYMBOLS (b, i, sym)
4084 overload_list_add_symbol (sym, oload_name);
4088 /* Go through the symtabs and check the externs and statics for
4089 symbols which match. */
4091 ALL_SYMTABS (objfile, s)
4094 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), GLOBAL_BLOCK);
4095 ALL_BLOCK_SYMBOLS (b, i, sym)
4097 overload_list_add_symbol (sym, oload_name);
4101 ALL_SYMTABS (objfile, s)
4104 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), STATIC_BLOCK);
4105 /* Don't do this block twice. */
4106 if (b == surrounding_static_block)
4108 ALL_BLOCK_SYMBOLS (b, i, sym)
4110 overload_list_add_symbol (sym, oload_name);
4116 return (sym_return_val);
4119 /* End of overload resolution functions */
4121 struct symtabs_and_lines
4122 decode_line_spec (char *string, int funfirstline)
4124 struct symtabs_and_lines sals;
4125 struct symtab_and_line cursal;
4128 error ("Empty line specification.");
4130 /* We use whatever is set as the current source line. We do not try
4131 and get a default or it will recursively call us! */
4132 cursal = get_current_source_symtab_and_line ();
4134 sals = decode_line_1 (&string, funfirstline,
4135 cursal.symtab, cursal.line,
4139 error ("Junk at end of line specification: %s", string);
4144 static char *name_of_main;
4147 set_main_name (const char *name)
4149 if (name_of_main != NULL)
4151 xfree (name_of_main);
4152 name_of_main = NULL;
4156 name_of_main = xstrdup (name);
4163 if (name_of_main != NULL)
4164 return name_of_main;
4171 _initialize_symtab (void)
4173 add_info ("variables", variables_info,
4174 "All global and static variable names, or those matching REGEXP.");
4176 add_com ("whereis", class_info, variables_info,
4177 "All global and static variable names, or those matching REGEXP.");
4179 add_info ("functions", functions_info,
4180 "All function names, or those matching REGEXP.");
4183 /* FIXME: This command has at least the following problems:
4184 1. It prints builtin types (in a very strange and confusing fashion).
4185 2. It doesn't print right, e.g. with
4186 typedef struct foo *FOO
4187 type_print prints "FOO" when we want to make it (in this situation)
4188 print "struct foo *".
4189 I also think "ptype" or "whatis" is more likely to be useful (but if
4190 there is much disagreement "info types" can be fixed). */
4191 add_info ("types", types_info,
4192 "All type names, or those matching REGEXP.");
4194 add_info ("sources", sources_info,
4195 "Source files in the program.");
4197 add_com ("rbreak", class_breakpoint, rbreak_command,
4198 "Set a breakpoint for all functions matching REGEXP.");
4202 add_com ("lf", class_info, sources_info, "Source files in the program");
4203 add_com ("lg", class_info, variables_info,
4204 "All global and static variable names, or those matching REGEXP.");
4207 /* Initialize the one built-in type that isn't language dependent... */
4208 builtin_type_error = init_type (TYPE_CODE_ERROR, 0, 0,
4209 "<unknown type>", (struct objfile *) NULL);