1 /* Symbol table lookup for the GNU debugger, GDB.
2 Copyright 1986, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 1997
3 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
31 #include "call-cmds.h"
32 #include "gnu-regex.h"
33 #include "expression.h"
39 #include <sys/types.h>
41 #include "gdb_string.h"
45 /* Prototypes for local functions */
48 find_methods PARAMS ((struct type *, char *, struct symbol **));
51 completion_list_add_name PARAMS ((char *, char *, int, char *, char *));
54 build_canonical_line_spec PARAMS ((struct symtab_and_line *, char *, char ***));
56 static struct symtabs_and_lines
57 decode_line_2 PARAMS ((struct symbol *[], int, int, char ***));
60 rbreak_command PARAMS ((char *, int));
63 types_info PARAMS ((char *, int));
66 functions_info PARAMS ((char *, int));
69 variables_info PARAMS ((char *, int));
72 sources_info PARAMS ((char *, int));
75 list_symbols PARAMS ((char *, int, int, int));
78 output_source_filename PARAMS ((char *, int *));
81 operator_chars PARAMS ((char *, char **));
83 static int find_line_common PARAMS ((struct linetable *, int, int *));
85 static struct partial_symbol *
86 lookup_partial_symbol PARAMS ((struct partial_symtab *, const char *,
87 int, namespace_enum));
89 static struct symtab *
90 lookup_symtab_1 PARAMS ((char *));
93 cplusplus_hint PARAMS ((char *));
97 /* The single non-language-specific builtin type */
98 struct type *builtin_type_error;
100 /* Block in which the most recently searched-for symbol was found.
101 Might be better to make this a parameter to lookup_symbol and
104 const struct block *block_found;
106 char no_symtab_msg[] = "No symbol table is loaded. Use the \"file\" command.";
108 /* While the C++ support is still in flux, issue a possibly helpful hint on
109 using the new command completion feature on single quoted demangled C++
110 symbols. Remove when loose ends are cleaned up. FIXME -fnf */
113 cplusplus_hint (name)
116 while (*name == '\'')
118 printf_filtered ("Hint: try '%s<TAB> or '%s<ESC-?>\n", name, name);
119 printf_filtered ("(Note leading single quote.)\n");
122 /* Check for a symtab of a specific name; first in symtabs, then in
123 psymtabs. *If* there is no '/' in the name, a match after a '/'
124 in the symtab filename will also work. */
126 static struct symtab *
127 lookup_symtab_1 (name)
130 register struct symtab *s;
131 register struct partial_symtab *ps;
132 register char *slash;
133 register struct objfile *objfile;
137 /* First, search for an exact match */
139 ALL_SYMTABS (objfile, s)
140 if (STREQ (name, s->filename))
143 slash = strchr (name, '/');
145 /* Now, search for a matching tail (only if name doesn't have any dirs) */
148 ALL_SYMTABS (objfile, s)
150 char *p = s -> filename;
151 char *tail = strrchr (p, '/');
160 /* Same search rules as above apply here, but now we look thru the
163 ps = lookup_partial_symtab (name);
168 error ("Internal: readin %s pst for `%s' found when no symtab found.",
169 ps -> filename, name);
171 s = PSYMTAB_TO_SYMTAB (ps);
176 /* At this point, we have located the psymtab for this file, but
177 the conversion to a symtab has failed. This usually happens
178 when we are looking up an include file. In this case,
179 PSYMTAB_TO_SYMTAB doesn't return a symtab, even though one has
180 been created. So, we need to run through the symtabs again in
181 order to find the file.
182 XXX - This is a crock, and should be fixed inside of the the
183 symbol parsing routines. */
187 /* Lookup the symbol table of a source file named NAME. Try a couple
188 of variations if the first lookup doesn't work. */
194 register struct symtab *s;
199 s = lookup_symtab_1 (name);
203 /* This screws c-exp.y:yylex if there is both a type "tree" and a symtab
206 /* If name not found as specified, see if adding ".c" helps. */
207 /* Why is this? Is it just a user convenience? (If so, it's pretty
208 questionable in the presence of C++, FORTRAN, etc.). It's not in
211 copy = (char *) alloca (strlen (name) + 3);
214 s = lookup_symtab_1 (copy);
218 /* We didn't find anything; die. */
222 /* Lookup the partial symbol table of a source file named NAME.
223 *If* there is no '/' in the name, a match after a '/'
224 in the psymtab filename will also work. */
226 struct partial_symtab *
227 lookup_partial_symtab (name)
230 register struct partial_symtab *pst;
231 register struct objfile *objfile;
233 ALL_PSYMTABS (objfile, pst)
235 if (STREQ (name, pst -> filename))
241 /* Now, search for a matching tail (only if name doesn't have any dirs) */
243 if (!strchr (name, '/'))
244 ALL_PSYMTABS (objfile, pst)
246 char *p = pst -> filename;
247 char *tail = strrchr (p, '/');
259 /* Demangle a GDB method stub type.
260 Note that this function is g++ specific. */
263 gdb_mangle_name (type, i, j)
267 int mangled_name_len;
269 struct fn_field *f = TYPE_FN_FIELDLIST1 (type, i);
270 struct fn_field *method = &f[j];
271 char *field_name = TYPE_FN_FIELDLIST_NAME (type, i);
272 char *physname = TYPE_FN_FIELD_PHYSNAME (f, j);
273 char *newname = type_name_no_tag (type);
275 /* Does the form of physname indicate that it is the full mangled name
276 of a constructor (not just the args)? */
277 int is_full_physname_constructor;
280 int is_destructor = DESTRUCTOR_PREFIX_P (physname);
281 /* Need a new type prefix. */
282 char *const_prefix = method->is_const ? "C" : "";
283 char *volatile_prefix = method->is_volatile ? "V" : "";
285 int len = (newname == NULL ? 0 : strlen (newname));
287 is_full_physname_constructor =
288 ((physname[0]=='_' && physname[1]=='_' &&
289 (isdigit(physname[2]) || physname[2]=='Q' || physname[2]=='t'))
290 || (strncmp(physname, "__ct", 4) == 0));
293 is_full_physname_constructor || (newname && STREQ(field_name, newname));
296 is_destructor = (strncmp(physname, "__dt", 4) == 0);
298 if (is_destructor || is_full_physname_constructor)
300 mangled_name = (char*) xmalloc(strlen(physname)+1);
301 strcpy(mangled_name, physname);
307 sprintf (buf, "__%s%s", const_prefix, volatile_prefix);
308 if (strcmp(buf, "__") == 0)
311 else if (newname != NULL && strchr (newname, '<') != NULL)
313 /* Template methods are fully mangled. */
314 sprintf (buf, "__%s%s", const_prefix, volatile_prefix);
320 sprintf (buf, "__%s%s%d", const_prefix, volatile_prefix, len);
322 mangled_name_len = ((is_constructor ? 0 : strlen (field_name))
327 /* Only needed for GNU-mangled names. ANSI-mangled names
328 work with the normal mechanisms. */
329 if (OPNAME_PREFIX_P (field_name))
331 const char *opname = cplus_mangle_opname (field_name + 3, 0);
333 error ("No mangling for \"%s\"", field_name);
334 mangled_name_len += strlen (opname);
335 mangled_name = (char *)xmalloc (mangled_name_len);
337 strncpy (mangled_name, field_name, 3);
338 mangled_name[3] = '\0';
339 strcat (mangled_name, opname);
343 mangled_name = (char *)xmalloc (mangled_name_len);
345 mangled_name[0] = '\0';
347 strcpy (mangled_name, field_name);
349 strcat (mangled_name, buf);
350 /* If the class doesn't have a name, i.e. newname NULL, then we just
351 mangle it using 0 for the length of the class. Thus it gets mangled
352 as something starting with `::' rather than `classname::'. */
354 strcat (mangled_name, newname);
356 strcat (mangled_name, physname);
357 return (mangled_name);
361 /* Find which partial symtab on contains PC. Return 0 if none. */
363 struct partial_symtab *
365 register CORE_ADDR pc;
367 register struct partial_symtab *pst;
368 register struct objfile *objfile;
370 ALL_PSYMTABS (objfile, pst)
372 if (pc >= pst->textlow && pc < pst->texthigh)
374 struct minimal_symbol *msymbol;
375 struct partial_symtab *tpst;
377 /* An objfile that has its functions reordered might have
378 many partial symbol tables containing the PC, but
379 we want the partial symbol table that contains the
380 function containing the PC. */
381 if (!(objfile->flags & OBJF_REORDERED))
384 msymbol = lookup_minimal_symbol_by_pc (pc);
388 for (tpst = pst; tpst != NULL; tpst = tpst->next)
390 if (pc >= tpst->textlow && pc < tpst->texthigh)
392 struct partial_symbol *p;
394 p = find_pc_psymbol (tpst, pc);
396 && SYMBOL_VALUE_ADDRESS(p)
397 == SYMBOL_VALUE_ADDRESS (msymbol))
407 /* Find which partial symbol within a psymtab contains PC. Return 0
408 if none. Check all psymtabs if PSYMTAB is 0. */
409 struct partial_symbol *
410 find_pc_psymbol (psymtab, pc)
411 struct partial_symtab *psymtab;
414 struct partial_symbol *best = NULL, *p, **pp;
418 psymtab = find_pc_psymtab (pc);
422 best_pc = psymtab->textlow - 1;
424 /* Search the global symbols as well as the static symbols, so that
425 find_pc_partial_function doesn't use a minimal symbol and thus
426 cache a bad endaddr. */
427 for (pp = psymtab->objfile->global_psymbols.list + psymtab->globals_offset;
428 (pp - (psymtab->objfile->global_psymbols.list + psymtab->globals_offset)
429 < psymtab->n_global_syms);
433 if (SYMBOL_NAMESPACE (p) == VAR_NAMESPACE
434 && SYMBOL_CLASS (p) == LOC_BLOCK
435 && pc >= SYMBOL_VALUE_ADDRESS (p)
436 && SYMBOL_VALUE_ADDRESS (p) > best_pc)
438 best_pc = SYMBOL_VALUE_ADDRESS (p);
442 for (pp = psymtab->objfile->static_psymbols.list + psymtab->statics_offset;
443 (pp - (psymtab->objfile->static_psymbols.list + psymtab->statics_offset)
444 < psymtab->n_static_syms);
448 if (SYMBOL_NAMESPACE (p) == VAR_NAMESPACE
449 && SYMBOL_CLASS (p) == LOC_BLOCK
450 && pc >= SYMBOL_VALUE_ADDRESS (p)
451 && SYMBOL_VALUE_ADDRESS (p) > best_pc)
453 best_pc = SYMBOL_VALUE_ADDRESS (p);
457 if (best_pc == psymtab->textlow - 1)
462 /* Debug symbols usually don't have section information. We need to dig that
463 out of the minimal symbols and stash that in the debug symbol. */
466 struct symbol * fixup_symbol_section PARAMS ((struct symbol *sym,
467 struct objfile *objfile));
468 static struct symbol *
469 fixup_symbol_section (sym, objfile)
471 struct objfile *objfile;
473 struct minimal_symbol *msym;
478 if (SYMBOL_BFD_SECTION (sym))
481 msym = lookup_minimal_symbol (SYMBOL_NAME (sym), NULL, objfile);
484 SYMBOL_BFD_SECTION (sym) = SYMBOL_BFD_SECTION (msym);
490 /* Find the definition for a specified symbol name NAME
491 in namespace NAMESPACE, visible from lexical block BLOCK.
492 Returns the struct symbol pointer, or zero if no symbol is found.
493 If SYMTAB is non-NULL, store the symbol table in which the
494 symbol was found there, or NULL if not found.
495 C++: if IS_A_FIELD_OF_THIS is nonzero on entry, check to see if
496 NAME is a field of the current implied argument `this'. If so set
497 *IS_A_FIELD_OF_THIS to 1, otherwise set it to zero.
498 BLOCK_FOUND is set to the block in which NAME is found (in the case of
499 a field of `this', value_of_this sets BLOCK_FOUND to the proper value.) */
501 /* This function has a bunch of loops in it and it would seem to be
502 attractive to put in some QUIT's (though I'm not really sure
503 whether it can run long enough to be really important). But there
504 are a few calls for which it would appear to be bad news to quit
505 out of here: find_proc_desc in alpha-tdep.c and mips-tdep.c, and
506 nindy_frame_chain_valid in nindy-tdep.c. (Note that there is C++
507 code below which can error(), but that probably doesn't affect
508 these calls since they are looking for a known variable and thus
509 can probably assume it will never hit the C++ code). */
512 lookup_symbol (name, block, namespace, is_a_field_of_this, symtab)
514 register const struct block *block;
515 const namespace_enum namespace;
516 int *is_a_field_of_this;
517 struct symtab **symtab;
519 register struct symbol *sym;
520 register struct symtab *s = NULL;
521 register struct partial_symtab *ps;
522 struct blockvector *bv;
523 register struct objfile *objfile = NULL;
524 register struct block *b;
525 register struct minimal_symbol *msymbol;
527 /* Search specified block and its superiors. */
531 sym = lookup_block_symbol (block, name, namespace);
537 /* Search the list of symtabs for one which contains the
538 address of the start of this block. */
539 ALL_SYMTABS (objfile, s)
541 bv = BLOCKVECTOR (s);
542 b = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
543 if (BLOCK_START (b) <= BLOCK_START (block)
544 && BLOCK_END (b) > BLOCK_START (block))
551 return fixup_symbol_section (sym, objfile);
553 block = BLOCK_SUPERBLOCK (block);
556 /* FIXME: this code is never executed--block is always NULL at this
557 point. What is it trying to do, anyway? We already should have
558 checked the STATIC_BLOCK above (it is the superblock of top-level
559 blocks). Why is VAR_NAMESPACE special-cased? */
560 /* Don't need to mess with the psymtabs; if we have a block,
561 that file is read in. If we don't, then we deal later with
562 all the psymtab stuff that needs checking. */
563 if (namespace == VAR_NAMESPACE && block != NULL)
566 /* Find the right symtab. */
567 ALL_SYMTABS (objfile, s)
569 bv = BLOCKVECTOR (s);
570 b = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
571 if (BLOCK_START (b) <= BLOCK_START (block)
572 && BLOCK_END (b) > BLOCK_START (block))
574 sym = lookup_block_symbol (b, name, VAR_NAMESPACE);
580 return fixup_symbol_section (sym, objfile);
587 /* C++: If requested to do so by the caller,
588 check to see if NAME is a field of `this'. */
589 if (is_a_field_of_this)
591 struct value *v = value_of_this (0);
593 *is_a_field_of_this = 0;
594 if (v && check_field (v, name))
596 *is_a_field_of_this = 1;
603 /* Now search all global blocks. Do the symtab's first, then
604 check the psymtab's */
606 ALL_SYMTABS (objfile, s)
608 bv = BLOCKVECTOR (s);
609 block = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
610 sym = lookup_block_symbol (block, name, namespace);
616 return fixup_symbol_section (sym, objfile);
620 /* Check for the possibility of the symbol being a function or
621 a mangled variable that is stored in one of the minimal symbol tables.
622 Eventually, all global symbols might be resolved in this way. */
624 if (namespace == VAR_NAMESPACE)
626 msymbol = lookup_minimal_symbol (name, NULL, NULL);
629 s = find_pc_symtab (SYMBOL_VALUE_ADDRESS (msymbol));
632 /* This is a function which has a symtab for its address. */
633 bv = BLOCKVECTOR (s);
634 block = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
635 sym = lookup_block_symbol (block, SYMBOL_NAME (msymbol),
637 /* We kept static functions in minimal symbol table as well as
638 in static scope. We want to find them in the symbol table. */
640 block = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
641 sym = lookup_block_symbol (block, SYMBOL_NAME (msymbol),
645 /* sym == 0 if symbol was found in the minimal symbol table
646 but not in the symtab.
647 Return 0 to use the msymbol definition of "foo_".
649 This happens for Fortran "foo_" symbols,
650 which are "foo" in the symtab.
652 This can also happen if "asm" is used to make a
653 regular symbol but not a debugging symbol, e.g.
660 return fixup_symbol_section (sym, objfile);
662 else if (MSYMBOL_TYPE (msymbol) != mst_text
663 && MSYMBOL_TYPE (msymbol) != mst_file_text
664 && !STREQ (name, SYMBOL_NAME (msymbol)))
666 /* This is a mangled variable, look it up by its
668 return fixup_symbol_section
669 (lookup_symbol (SYMBOL_NAME (msymbol), block,
670 namespace, is_a_field_of_this, symtab),
673 /* There are no debug symbols for this file, or we are looking
674 for an unmangled variable.
675 Try to find a matching static symbol below. */
679 ALL_PSYMTABS (objfile, ps)
681 if (!ps->readin && lookup_partial_symbol (ps, name, 1, namespace))
683 s = PSYMTAB_TO_SYMTAB(ps);
684 bv = BLOCKVECTOR (s);
685 block = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
686 sym = lookup_block_symbol (block, name, namespace);
688 error ("Internal: global symbol `%s' found in %s psymtab but not in symtab", name, ps->filename);
691 return fixup_symbol_section (sym, objfile);
695 /* Now search all per-file blocks.
696 Not strictly correct, but more useful than an error.
697 Do the symtabs first, then check the psymtabs */
699 ALL_SYMTABS (objfile, s)
701 bv = BLOCKVECTOR (s);
702 block = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
703 sym = lookup_block_symbol (block, name, namespace);
709 return fixup_symbol_section (sym, objfile);
713 ALL_PSYMTABS (objfile, ps)
715 if (!ps->readin && lookup_partial_symbol (ps, name, 0, namespace))
717 s = PSYMTAB_TO_SYMTAB(ps);
718 bv = BLOCKVECTOR (s);
719 block = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
720 sym = lookup_block_symbol (block, name, namespace);
722 error ("Internal: static symbol `%s' found in %s psymtab but not in symtab", name, ps->filename);
725 return fixup_symbol_section (sym, objfile);
734 /* Look, in partial_symtab PST, for symbol NAME. Check the global
735 symbols if GLOBAL, the static symbols if not */
737 static struct partial_symbol *
738 lookup_partial_symbol (pst, name, global, namespace)
739 struct partial_symtab *pst;
742 namespace_enum namespace;
744 struct partial_symbol **start, **psym;
745 struct partial_symbol **top, **bottom, **center;
746 int length = (global ? pst->n_global_syms : pst->n_static_syms);
747 int do_linear_search = 1;
755 pst->objfile->global_psymbols.list + pst->globals_offset :
756 pst->objfile->static_psymbols.list + pst->statics_offset );
758 if (global) /* This means we can use a binary search. */
760 do_linear_search = 0;
762 /* Binary search. This search is guaranteed to end with center
763 pointing at the earliest partial symbol with the correct
764 name. At that point *all* partial symbols with that name
765 will be checked against the correct namespace. */
768 top = start + length - 1;
771 center = bottom + (top - bottom) / 2;
774 if (!do_linear_search && SYMBOL_LANGUAGE (*center) == language_cplus)
776 do_linear_search = 1;
778 if (STRCMP (SYMBOL_NAME (*center), name) >= 0)
787 if (!(top == bottom))
789 while (STREQ (SYMBOL_NAME (*top), name))
791 if (SYMBOL_NAMESPACE (*top) == namespace)
799 /* Can't use a binary search or else we found during the binary search that
800 we should also do a linear search. */
802 if (do_linear_search)
804 for (psym = start; psym < start + length; psym++)
806 if (namespace == SYMBOL_NAMESPACE (*psym))
808 if (SYMBOL_MATCHES_NAME (*psym, name))
819 /* Find the psymtab containing main(). */
820 /* FIXME: What about languages without main() or specially linked
821 executables that have no main() ? */
823 struct partial_symtab *
826 register struct partial_symtab *pst;
827 register struct objfile *objfile;
829 ALL_PSYMTABS (objfile, pst)
831 if (lookup_partial_symbol (pst, "main", 1, VAR_NAMESPACE))
839 /* Search BLOCK for symbol NAME in NAMESPACE.
841 Note that if NAME is the demangled form of a C++ symbol, we will fail
842 to find a match during the binary search of the non-encoded names, but
843 for now we don't worry about the slight inefficiency of looking for
844 a match we'll never find, since it will go pretty quick. Once the
845 binary search terminates, we drop through and do a straight linear
846 search on the symbols. Each symbol which is marked as being a C++
847 symbol (language_cplus set) has both the encoded and non-encoded names
848 tested for a match. */
851 lookup_block_symbol (block, name, namespace)
852 register const struct block *block;
854 const namespace_enum namespace;
856 register int bot, top, inc;
857 register struct symbol *sym;
858 register struct symbol *sym_found = NULL;
859 register int do_linear_search = 1;
861 /* If the blocks's symbols were sorted, start with a binary search. */
863 if (BLOCK_SHOULD_SORT (block))
865 /* Reset the linear search flag so if the binary search fails, we
866 won't do the linear search once unless we find some reason to
867 do so, such as finding a C++ symbol during the binary search.
868 Note that for C++ modules, ALL the symbols in a block should
869 end up marked as C++ symbols. */
871 do_linear_search = 0;
872 top = BLOCK_NSYMS (block);
875 /* Advance BOT to not far before the first symbol whose name is NAME. */
879 inc = (top - bot + 1);
880 /* No need to keep binary searching for the last few bits worth. */
885 inc = (inc >> 1) + bot;
886 sym = BLOCK_SYM (block, inc);
887 if (!do_linear_search && SYMBOL_LANGUAGE (sym) == language_cplus)
889 do_linear_search = 1;
891 if (SYMBOL_NAME (sym)[0] < name[0])
895 else if (SYMBOL_NAME (sym)[0] > name[0])
899 else if (STRCMP (SYMBOL_NAME (sym), name) < 0)
909 /* Now scan forward until we run out of symbols, find one whose
910 name is greater than NAME, or find one we want. If there is
911 more than one symbol with the right name and namespace, we
912 return the first one; I believe it is now impossible for us
913 to encounter two symbols with the same name and namespace
914 here, because blocks containing argument symbols are no
917 top = BLOCK_NSYMS (block);
920 sym = BLOCK_SYM (block, bot);
921 inc = SYMBOL_NAME (sym)[0] - name[0];
924 inc = STRCMP (SYMBOL_NAME (sym), name);
926 if (inc == 0 && SYMBOL_NAMESPACE (sym) == namespace)
938 /* Here if block isn't sorted, or we fail to find a match during the
939 binary search above. If during the binary search above, we find a
940 symbol which is a C++ symbol, then we have re-enabled the linear
941 search flag which was reset when starting the binary search.
943 This loop is equivalent to the loop above, but hacked greatly for speed.
945 Note that parameter symbols do not always show up last in the
946 list; this loop makes sure to take anything else other than
947 parameter symbols first; it only uses parameter symbols as a
948 last resort. Note that this only takes up extra computation
951 if (do_linear_search)
953 top = BLOCK_NSYMS (block);
957 sym = BLOCK_SYM (block, bot);
958 if (SYMBOL_NAMESPACE (sym) == namespace &&
959 SYMBOL_MATCHES_NAME (sym, name))
962 if (SYMBOL_CLASS (sym) != LOC_ARG &&
963 SYMBOL_CLASS (sym) != LOC_LOCAL_ARG &&
964 SYMBOL_CLASS (sym) != LOC_REF_ARG &&
965 SYMBOL_CLASS (sym) != LOC_REGPARM &&
966 SYMBOL_CLASS (sym) != LOC_REGPARM_ADDR &&
967 SYMBOL_CLASS (sym) != LOC_BASEREG_ARG)
975 return (sym_found); /* Will be NULL if not found. */
979 /* Return the symbol for the function which contains a specified
980 lexical block, described by a struct block BL. */
986 while (BLOCK_FUNCTION (bl) == 0 && BLOCK_SUPERBLOCK (bl) != 0)
987 bl = BLOCK_SUPERBLOCK (bl);
989 return BLOCK_FUNCTION (bl);
992 /* Find the symtab associated with PC. Look through the psymtabs and read in
993 another symtab if necessary. */
997 register CORE_ADDR pc;
999 register struct block *b;
1000 struct blockvector *bv;
1001 register struct symtab *s = NULL;
1002 register struct symtab *best_s = NULL;
1003 register struct partial_symtab *ps;
1004 register struct objfile *objfile;
1007 /* Search all symtabs for the one whose file contains our address, and which
1008 is the smallest of all the ones containing the address. This is designed
1009 to deal with a case like symtab a is at 0x1000-0x2000 and 0x3000-0x4000
1010 and symtab b is at 0x2000-0x3000. So the GLOBAL_BLOCK for a is from
1011 0x1000-0x4000, but for address 0x2345 we want to return symtab b.
1013 This happens for native ecoff format, where code from included files
1014 gets its own symtab. The symtab for the included file should have
1015 been read in already via the dependency mechanism.
1016 It might be swifter to create several symtabs with the same name
1017 like xcoff does (I'm not sure).
1019 It also happens for objfiles that have their functions reordered.
1020 For these, the symtab we are looking for is not necessarily read in. */
1022 ALL_SYMTABS (objfile, s)
1024 bv = BLOCKVECTOR (s);
1025 b = BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK);
1026 if (BLOCK_START (b) <= pc
1027 && BLOCK_END (b) > pc
1029 || BLOCK_END (b) - BLOCK_START (b) < distance))
1031 /* For an objfile that has its functions reordered,
1032 find_pc_psymtab will find the proper partial symbol table
1033 and we simply return its corresponding symtab. */
1034 if ((objfile->flags & OBJF_REORDERED) && objfile->psymtabs)
1036 ps = find_pc_psymtab (pc);
1038 s = PSYMTAB_TO_SYMTAB (ps);
1043 distance = BLOCK_END (b) - BLOCK_START (b);
1052 ps = find_pc_psymtab (pc);
1056 /* Might want to error() here (in case symtab is corrupt and
1057 will cause a core dump), but maybe we can successfully
1058 continue, so let's not. */
1059 /* FIXME-32x64: assumes pc fits in a long */
1061 (Internal error: pc 0x%lx in read in psymtab, but not in symtab.)\n",
1062 (unsigned long) pc);
1063 s = PSYMTAB_TO_SYMTAB (ps);
1070 /* Find the closest symbol value (of any sort -- function or variable)
1071 for a given address value. Slow but complete. (currently unused,
1072 mainly because it is too slow. We could fix it if each symtab and
1073 psymtab had contained in it the addresses ranges of each of its
1074 sections, which also would be required to make things like "info
1075 line *0x2345" cause psymtabs to be converted to symtabs). */
1078 find_addr_symbol (addr, symtabp, symaddrp)
1080 struct symtab **symtabp;
1081 CORE_ADDR *symaddrp;
1083 struct symtab *symtab, *best_symtab;
1084 struct objfile *objfile;
1085 register int bot, top;
1086 register struct symbol *sym;
1087 register CORE_ADDR sym_addr;
1088 struct block *block;
1091 /* Info on best symbol seen so far */
1093 register CORE_ADDR best_sym_addr = 0;
1094 struct symbol *best_sym = 0;
1096 /* FIXME -- we should pull in all the psymtabs, too! */
1097 ALL_SYMTABS (objfile, symtab)
1099 /* Search the global and static blocks in this symtab for
1100 the closest symbol-address to the desired address. */
1102 for (blocknum = GLOBAL_BLOCK; blocknum <= STATIC_BLOCK; blocknum++)
1105 block = BLOCKVECTOR_BLOCK (BLOCKVECTOR (symtab), blocknum);
1106 top = BLOCK_NSYMS (block);
1107 for (bot = 0; bot < top; bot++)
1109 sym = BLOCK_SYM (block, bot);
1110 switch (SYMBOL_CLASS (sym))
1114 sym_addr = SYMBOL_VALUE_ADDRESS (sym);
1118 sym_addr = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
1125 if (sym_addr <= addr)
1126 if (sym_addr > best_sym_addr)
1128 /* Quit if we found an exact match. */
1130 best_sym_addr = sym_addr;
1131 best_symtab = symtab;
1132 if (sym_addr == addr)
1141 *symtabp = best_symtab;
1143 *symaddrp = best_sym_addr;
1148 /* Find the source file and line number for a given PC value.
1149 Return a structure containing a symtab pointer, a line number,
1150 and a pc range for the entire source line.
1151 The value's .pc field is NOT the specified pc.
1152 NOTCURRENT nonzero means, if specified pc is on a line boundary,
1153 use the line that ends there. Otherwise, in that case, the line
1154 that begins there is used. */
1156 /* The big complication here is that a line may start in one file, and end just
1157 before the start of another file. This usually occurs when you #include
1158 code in the middle of a subroutine. To properly find the end of a line's PC
1159 range, we must search all symtabs associated with this compilation unit, and
1160 find the one whose first PC is closer than that of the next line in this
1163 /* If it's worth the effort, we could be using a binary search. */
1165 struct symtab_and_line
1166 find_pc_line (pc, notcurrent)
1171 register struct linetable *l;
1174 register struct linetable_entry *item;
1175 struct symtab_and_line val;
1176 struct blockvector *bv;
1178 /* Info on best line seen so far, and where it starts, and its file. */
1180 struct linetable_entry *best = NULL;
1181 CORE_ADDR best_end = 0;
1182 struct symtab *best_symtab = 0;
1184 /* Store here the first line number
1185 of a file which contains the line at the smallest pc after PC.
1186 If we don't find a line whose range contains PC,
1187 we will use a line one less than this,
1188 with a range from the start of that file to the first line's pc. */
1189 struct linetable_entry *alt = NULL;
1190 struct symtab *alt_symtab = 0;
1192 /* Info on best line seen in this file. */
1194 struct linetable_entry *prev;
1196 /* If this pc is not from the current frame,
1197 it is the address of the end of a call instruction.
1198 Quite likely that is the start of the following statement.
1199 But what we want is the statement containing the instruction.
1200 Fudge the pc to make sure we get that. */
1202 INIT_SAL (&val); /* initialize to zeroes */
1207 s = find_pc_symtab (pc);
1214 bv = BLOCKVECTOR (s);
1216 /* Look at all the symtabs that share this blockvector.
1217 They all have the same apriori range, that we found was right;
1218 but they have different line tables. */
1220 for (; s && BLOCKVECTOR (s) == bv; s = s->next)
1222 /* Find the best line in this symtab. */
1229 /* I think len can be zero if the symtab lacks line numbers
1230 (e.g. gcc -g1). (Either that or the LINETABLE is NULL;
1231 I'm not sure which, and maybe it depends on the symbol
1237 item = l->item; /* Get first line info */
1239 /* Is this file's first line closer than the first lines of other files?
1240 If so, record this file, and its first line, as best alternate. */
1241 if (item->pc > pc && (!alt || item->pc < alt->pc))
1247 for (i = 0; i < len; i++, item++)
1249 /* Leave prev pointing to the linetable entry for the last line
1250 that started at or before PC. */
1257 /* At this point, prev points at the line whose start addr is <= pc, and
1258 item points at the next line. If we ran off the end of the linetable
1259 (pc >= start of the last line), then prev == item. If pc < start of
1260 the first line, prev will not be set. */
1262 /* Is this file's best line closer than the best in the other files?
1263 If so, record this file, and its best line, as best so far. */
1265 if (prev && (!best || prev->pc > best->pc))
1269 /* If another line is in the linetable, and its PC is closer
1270 than the best_end we currently have, take it as best_end. */
1271 if (i < len && (best_end == 0 || best_end > item->pc))
1272 best_end = item->pc;
1279 { /* If we didn't find any line # info, just
1285 val.symtab = alt_symtab;
1286 val.line = alt->line - 1;
1288 /* Don't return line 0, that means that we didn't find the line. */
1289 if (val.line == 0) ++val.line;
1291 val.pc = BLOCK_END (BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK));
1297 val.symtab = best_symtab;
1298 val.line = best->line;
1300 if (best_end && (!alt || best_end < alt->pc))
1305 val.end = BLOCK_END (BLOCKVECTOR_BLOCK (bv, GLOBAL_BLOCK));
1310 static int find_line_symtab PARAMS ((struct symtab *, int, struct linetable **,
1313 /* Find line number LINE in any symtab whose name is the same as
1316 If found, return 1, set *LINETABLE to the linetable in which it was
1317 found, set *INDEX to the index in the linetable of the best entry
1318 found, and set *EXACT_MATCH nonzero if the value returned is an
1321 If not found, return 0. */
1324 find_line_symtab (symtab, line, linetable, index, exact_match)
1325 struct symtab *symtab;
1327 struct linetable **linetable;
1333 /* BEST_INDEX and BEST_LINETABLE identify the smallest linenumber > LINE
1337 struct linetable *best_linetable;
1339 /* First try looking it up in the given symtab. */
1340 best_linetable = LINETABLE (symtab);
1341 best_index = find_line_common (best_linetable, line, &exact);
1342 if (best_index < 0 || !exact)
1344 /* Didn't find an exact match. So we better keep looking for
1345 another symtab with the same name. In the case of xcoff,
1346 multiple csects for one source file (produced by IBM's FORTRAN
1347 compiler) produce multiple symtabs (this is unavoidable
1348 assuming csects can be at arbitrary places in memory and that
1349 the GLOBAL_BLOCK of a symtab has a begin and end address). */
1351 /* BEST is the smallest linenumber > LINE so far seen,
1352 or 0 if none has been seen so far.
1353 BEST_INDEX and BEST_LINETABLE identify the item for it. */
1356 struct objfile *objfile;
1359 if (best_index >= 0)
1360 best = best_linetable->item[best_index].line;
1364 ALL_SYMTABS (objfile, s)
1366 struct linetable *l;
1369 if (!STREQ (symtab->filename, s->filename))
1372 ind = find_line_common (l, line, &exact);
1381 if (best == 0 || l->item[ind].line < best)
1383 best = l->item[ind].line;
1395 *index = best_index;
1397 *linetable = best_linetable;
1399 *exact_match = exact;
1403 /* Find the PC value for a given source file and line number.
1404 Returns zero for invalid line number.
1405 The source file is specified with a struct symtab. */
1408 find_line_pc (symtab, line)
1409 struct symtab *symtab;
1412 struct linetable *l;
1417 if (find_line_symtab (symtab, line, &l, &ind, NULL))
1418 return l->item[ind].pc;
1423 /* Find the range of pc values in a line.
1424 Store the starting pc of the line into *STARTPTR
1425 and the ending pc (start of next line) into *ENDPTR.
1426 Returns 1 to indicate success.
1427 Returns 0 if could not find the specified line. */
1430 find_line_pc_range (sal, startptr, endptr)
1431 struct symtab_and_line sal;
1432 CORE_ADDR *startptr, *endptr;
1434 CORE_ADDR startaddr;
1435 struct symtab_and_line found_sal;
1440 startaddr = find_line_pc (sal.symtab, sal.line);
1445 /* This whole function is based on address. For example, if line 10 has
1446 two parts, one from 0x100 to 0x200 and one from 0x300 to 0x400, then
1447 "info line *0x123" should say the line goes from 0x100 to 0x200
1448 and "info line *0x355" should say the line goes from 0x300 to 0x400.
1449 This also insures that we never give a range like "starts at 0x134
1450 and ends at 0x12c". */
1452 found_sal = find_pc_line (startaddr, 0);
1453 if (found_sal.line != sal.line)
1455 /* The specified line (sal) has zero bytes. */
1456 *startptr = found_sal.pc;
1457 *endptr = found_sal.pc;
1461 *startptr = found_sal.pc;
1462 *endptr = found_sal.end;
1467 /* Given a line table and a line number, return the index into the line
1468 table for the pc of the nearest line whose number is >= the specified one.
1469 Return -1 if none is found. The value is >= 0 if it is an index.
1471 Set *EXACT_MATCH nonzero if the value returned is an exact match. */
1474 find_line_common (l, lineno, exact_match)
1475 register struct linetable *l;
1476 register int lineno;
1482 /* BEST is the smallest linenumber > LINENO so far seen,
1483 or 0 if none has been seen so far.
1484 BEST_INDEX identifies the item for it. */
1486 int best_index = -1;
1495 for (i = 0; i < len; i++)
1497 register struct linetable_entry *item = &(l->item[i]);
1499 if (item->line == lineno)
1501 /* Return the first (lowest address) entry which matches. */
1506 if (item->line > lineno && (best == 0 || item->line < best))
1513 /* If we got here, we didn't get an exact match. */
1520 find_pc_line_pc_range (pc, startptr, endptr)
1522 CORE_ADDR *startptr, *endptr;
1524 struct symtab_and_line sal;
1525 sal = find_pc_line (pc, 0);
1528 return sal.symtab != 0;
1531 /* Given a function symbol SYM, find the symtab and line for the start
1533 If the argument FUNFIRSTLINE is nonzero, we want the first line
1534 of real code inside the function. */
1536 static struct symtab_and_line
1537 find_function_start_sal PARAMS ((struct symbol *sym, int));
1539 static struct symtab_and_line
1540 find_function_start_sal (sym, funfirstline)
1545 struct symtab_and_line sal;
1547 pc = BLOCK_START (SYMBOL_BLOCK_VALUE (sym));
1550 pc += FUNCTION_START_OFFSET;
1553 sal = find_pc_line (pc, 0);
1555 #ifdef PROLOGUE_FIRSTLINE_OVERLAP
1556 /* Convex: no need to suppress code on first line, if any */
1559 /* Check if SKIP_PROLOGUE left us in mid-line, and the next
1560 line is still part of the same function. */
1562 && BLOCK_START (SYMBOL_BLOCK_VALUE (sym)) <= sal.end
1563 && sal.end < BLOCK_END (SYMBOL_BLOCK_VALUE (sym)))
1565 /* First pc of next line */
1567 /* Recalculate the line number (might not be N+1). */
1568 sal = find_pc_line (pc, 0);
1576 /* If P is of the form "operator[ \t]+..." where `...' is
1577 some legitimate operator text, return a pointer to the
1578 beginning of the substring of the operator text.
1579 Otherwise, return "". */
1581 operator_chars (p, end)
1586 if (strncmp (p, "operator", 8))
1590 /* Don't get faked out by `operator' being part of a longer
1592 if (isalpha(*p) || *p == '_' || *p == '$' || *p == '\0')
1595 /* Allow some whitespace between `operator' and the operator symbol. */
1596 while (*p == ' ' || *p == '\t')
1599 /* Recognize 'operator TYPENAME'. */
1601 if (isalpha(*p) || *p == '_' || *p == '$')
1603 register char *q = p+1;
1604 while (isalnum(*q) || *q == '_' || *q == '$')
1629 if (p[1] == '=' || p[1] == p[0])
1640 error ("`operator ()' must be specified without whitespace in `()'");
1645 error ("`operator ?:' must be specified without whitespace in `?:'");
1650 error ("`operator []' must be specified without whitespace in `[]'");
1654 error ("`operator %s' not supported", p);
1661 /* Return the number of methods described for TYPE, including the
1662 methods from types it derives from. This can't be done in the symbol
1663 reader because the type of the baseclass might still be stubbed
1664 when the definition of the derived class is parsed. */
1666 static int total_number_of_methods PARAMS ((struct type *type));
1669 total_number_of_methods (type)
1675 CHECK_TYPEDEF (type);
1676 count = TYPE_NFN_FIELDS_TOTAL (type);
1678 for (n = 0; n < TYPE_N_BASECLASSES (type); n++)
1679 count += total_number_of_methods (TYPE_BASECLASS (type, n));
1684 /* Recursive helper function for decode_line_1.
1685 Look for methods named NAME in type T.
1686 Return number of matches.
1687 Put matches in SYM_ARR, which should have been allocated with
1688 a size of total_number_of_methods (T) * sizeof (struct symbol *).
1689 Note that this function is g++ specific. */
1692 find_methods (t, name, sym_arr)
1695 struct symbol **sym_arr;
1699 struct symbol *sym_class;
1700 char *class_name = type_name_no_tag (t);
1701 /* Ignore this class if it doesn't have a name. This is ugly, but
1702 unless we figure out how to get the physname without the name of
1703 the class, then the loop can't do any good. */
1705 && (sym_class = lookup_symbol (class_name,
1706 (struct block *)NULL,
1709 (struct symtab **)NULL)))
1712 /* FIXME: Shouldn't this just be CHECK_TYPEDEF (t)? */
1713 t = SYMBOL_TYPE (sym_class);
1714 for (method_counter = TYPE_NFN_FIELDS (t) - 1;
1715 method_counter >= 0;
1719 struct fn_field *f = TYPE_FN_FIELDLIST1 (t, method_counter);
1720 char *method_name = TYPE_FN_FIELDLIST_NAME (t, method_counter);
1721 char dem_opname[64];
1723 if (strncmp(method_name, "__", 2)==0 ||
1724 strncmp(method_name, "op", 2)==0 ||
1725 strncmp(method_name, "type", 4)==0 )
1727 if (cplus_demangle_opname(method_name, dem_opname, DMGL_ANSI))
1728 method_name = dem_opname;
1729 else if (cplus_demangle_opname(method_name, dem_opname, 0))
1730 method_name = dem_opname;
1732 if (STREQ (name, method_name))
1733 /* Find all the fields with that name. */
1734 for (field_counter = TYPE_FN_FIELDLIST_LENGTH (t, method_counter) - 1;
1739 if (TYPE_FN_FIELD_STUB (f, field_counter))
1740 check_stub_method (t, method_counter, field_counter);
1741 phys_name = TYPE_FN_FIELD_PHYSNAME (f, field_counter);
1742 /* Destructor is handled by caller, dont add it to the list */
1743 if (DESTRUCTOR_PREFIX_P (phys_name))
1746 sym_arr[i1] = lookup_symbol (phys_name,
1747 NULL, VAR_NAMESPACE,
1749 (struct symtab **) NULL);
1754 fputs_filtered("(Cannot find method ", gdb_stdout);
1755 fprintf_symbol_filtered (gdb_stdout, phys_name,
1757 DMGL_PARAMS | DMGL_ANSI);
1758 fputs_filtered(" - possibly inlined.)\n", gdb_stdout);
1764 /* Only search baseclasses if there is no match yet, since names in
1765 derived classes override those in baseclasses.
1767 FIXME: The above is not true; it is only true of member functions
1768 if they have the same number of arguments (??? - section 13.1 of the
1769 ARM says the function members are not in the same scope but doesn't
1770 really spell out the rules in a way I understand. In any case, if
1771 the number of arguments differ this is a case in which we can overload
1772 rather than hiding without any problem, and gcc 2.4.5 does overload
1773 rather than hiding in this case). */
1777 for (ibase = 0; ibase < TYPE_N_BASECLASSES (t); ibase++)
1778 i1 += find_methods(TYPE_BASECLASS(t, ibase), name,
1783 /* Helper function for decode_line_1.
1784 Build a canonical line spec in CANONICAL if it is non-NULL and if
1785 the SAL has a symtab.
1786 If SYMNAME is non-NULL the canonical line spec is `filename:symname'.
1787 If SYMNAME is NULL the line number from SAL is used and the canonical
1788 line spec is `filename:linenum'. */
1791 build_canonical_line_spec (sal, symname, canonical)
1792 struct symtab_and_line *sal;
1796 char **canonical_arr;
1797 char *canonical_name;
1799 struct symtab *s = sal->symtab;
1801 if (s == (struct symtab *)NULL
1802 || s->filename == (char *)NULL
1803 || canonical == (char ***)NULL)
1806 canonical_arr = (char **) xmalloc (sizeof (char *));
1807 *canonical = canonical_arr;
1809 filename = s->filename;
1810 if (symname != NULL)
1812 canonical_name = xmalloc (strlen (filename) + strlen (symname) + 2);
1813 sprintf (canonical_name, "%s:%s", filename, symname);
1817 canonical_name = xmalloc (strlen (filename) + 30);
1818 sprintf (canonical_name, "%s:%d", filename, sal->line);
1820 canonical_arr[0] = canonical_name;
1823 /* Parse a string that specifies a line number.
1824 Pass the address of a char * variable; that variable will be
1825 advanced over the characters actually parsed.
1829 LINENUM -- that line number in current file. PC returned is 0.
1830 FILE:LINENUM -- that line in that file. PC returned is 0.
1831 FUNCTION -- line number of openbrace of that function.
1832 PC returned is the start of the function.
1833 VARIABLE -- line number of definition of that variable.
1835 FILE:FUNCTION -- likewise, but prefer functions in that file.
1836 *EXPR -- line in which address EXPR appears.
1838 FUNCTION may be an undebuggable function found in minimal symbol table.
1840 If the argument FUNFIRSTLINE is nonzero, we want the first line
1841 of real code inside a function when a function is specified, and it is
1842 not OK to specify a variable or type to get its line number.
1844 DEFAULT_SYMTAB specifies the file to use if none is specified.
1845 It defaults to current_source_symtab.
1846 DEFAULT_LINE specifies the line number to use for relative
1847 line numbers (that start with signs). Defaults to current_source_line.
1848 If CANONICAL is non-NULL, store an array of strings containing the canonical
1849 line specs there if necessary. Currently overloaded member functions and
1850 line numbers or static functions without a filename yield a canonical
1851 line spec. The array and the line spec strings are allocated on the heap,
1852 it is the callers responsibility to free them.
1854 Note that it is possible to return zero for the symtab
1855 if no file is validly specified. Callers must check that.
1856 Also, the line number returned may be invalid. */
1858 /* We allow single quotes in various places. This is a hideous
1859 kludge, which exists because the completer can't yet deal with the
1860 lack of single quotes. FIXME: write a linespec_completer which we
1861 can use as appropriate instead of make_symbol_completion_list. */
1863 struct symtabs_and_lines
1864 decode_line_1 (argptr, funfirstline, default_symtab, default_line, canonical)
1867 struct symtab *default_symtab;
1871 struct symtabs_and_lines values;
1872 #ifdef HPPA_COMPILER_BUG
1873 /* FIXME: The native HP 9000/700 compiler has a bug which appears
1874 when optimizing this file with target i960-vxworks. I haven't
1875 been able to construct a simple test case. The problem is that
1876 in the second call to SKIP_PROLOGUE below, the compiler somehow
1877 does not realize that the statement val = find_pc_line (...) will
1878 change the values of the fields of val. It extracts the elements
1879 into registers at the top of the block, and does not update the
1880 registers after the call to find_pc_line. You can check this by
1881 inserting a printf at the end of find_pc_line to show what values
1882 it is returning for val.pc and val.end and another printf after
1883 the call to see what values the function actually got (remember,
1884 this is compiling with cc -O, with this patch removed). You can
1885 also examine the assembly listing: search for the second call to
1886 skip_prologue; the LDO statement before the next call to
1887 find_pc_line loads the address of the structure which
1888 find_pc_line will return; if there is a LDW just before the LDO,
1889 which fetches an element of the structure, then the compiler
1892 Setting val to volatile avoids the problem. We must undef
1893 volatile, because the HPPA native compiler does not define
1894 __STDC__, although it does understand volatile, and so volatile
1895 will have been defined away in defs.h. */
1897 volatile struct symtab_and_line val;
1898 #define volatile /*nothing*/
1900 struct symtab_and_line val;
1902 register char *p, *p1;
1907 register struct symtab *s;
1909 register struct symbol *sym;
1910 /* The symtab that SYM was found in. */
1911 struct symtab *sym_symtab;
1913 register CORE_ADDR pc;
1914 register struct minimal_symbol *msymbol;
1916 struct symbol *sym_class;
1918 int is_quoted, has_parens;
1919 struct symbol **sym_arr;
1921 char *saved_arg = *argptr;
1922 extern char *gdb_completer_quote_characters;
1924 INIT_SAL (&val); /* initialize to zeroes */
1926 /* Defaults have defaults. */
1928 if (default_symtab == 0)
1930 default_symtab = current_source_symtab;
1931 default_line = current_source_line;
1934 /* See if arg is *PC */
1936 if (**argptr == '*')
1939 pc = parse_and_eval_address_1 (argptr);
1940 values.sals = (struct symtab_and_line *)
1941 xmalloc (sizeof (struct symtab_and_line));
1943 values.sals[0] = find_pc_line (pc, 0);
1944 values.sals[0].pc = pc;
1948 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION */
1951 is_quoted = (**argptr
1952 && strchr (gdb_completer_quote_characters, **argptr) != NULL);
1953 has_parens = ((pp = strchr (*argptr, '(')) != NULL
1954 && (pp = strchr (pp, ')')) != NULL);
1956 for (p = *argptr; *p; p++)
1960 while(++p && *p != '>');
1963 error ("non-matching '<' and '>' in command");
1966 if (p[0] == ':' || p[0] == ' ' || p[0] == '\t')
1969 while (p[0] == ' ' || p[0] == '\t') p++;
1971 if ((p[0] == ':') && !has_parens)
1975 if (is_quoted) *argptr = *argptr+1;
1978 /* Extract the class name. */
1980 while (p != *argptr && p[-1] == ' ') --p;
1981 copy = (char *) alloca (p - *argptr + 1);
1982 memcpy (copy, *argptr, p - *argptr);
1983 copy[p - *argptr] = 0;
1985 /* Discard the class name from the arg. */
1987 while (*p == ' ' || *p == '\t') p++;
1990 sym_class = lookup_symbol (copy, 0, STRUCT_NAMESPACE, 0,
1991 (struct symtab **)NULL);
1994 (t = check_typedef (SYMBOL_TYPE (sym_class)),
1995 (TYPE_CODE (t) == TYPE_CODE_STRUCT
1996 || TYPE_CODE (t) == TYPE_CODE_UNION)))
1998 /* Arg token is not digits => try it as a function name
1999 Find the next token(everything up to end or next blank). */
2001 && strchr (gdb_completer_quote_characters, **argptr) != NULL)
2003 p = skip_quoted(*argptr);
2004 *argptr = *argptr + 1;
2009 while (*p && *p!=' ' && *p!='\t' && *p!=',' && *p!=':') p++;
2012 q = operator_chars (*argptr, &q1);
2016 char *tmp = alloca (q1 - q + 1);
2017 memcpy (tmp, q, q1 - q);
2019 opname = cplus_mangle_opname (tmp, DMGL_ANSI);
2023 printf_filtered ("no mangling for \"%s\"\n", tmp);
2024 cplusplus_hint (saved_arg);
2025 return_to_top_level (RETURN_ERROR);
2027 copy = (char*) alloca (3 + strlen(opname));
2028 sprintf (copy, "__%s", opname);
2034 copy = (char *) alloca (p - *argptr + 1 );
2035 memcpy (copy, *argptr, p - *argptr);
2036 copy[p - *argptr] = '\0';
2038 && copy[p - *argptr - 1]
2039 && strchr (gdb_completer_quote_characters,
2040 copy[p - *argptr - 1]) != NULL)
2041 copy[p - *argptr - 1] = '\0';
2044 /* no line number may be specified */
2045 while (*p == ' ' || *p == '\t') p++;
2049 i1 = 0; /* counter for the symbol array */
2050 sym_arr = (struct symbol **) alloca(total_number_of_methods (t)
2051 * sizeof(struct symbol *));
2053 if (destructor_name_p (copy, t))
2055 /* Destructors are a special case. */
2056 int m_index, f_index;
2058 if (get_destructor_fn_field (t, &m_index, &f_index))
2060 struct fn_field *f = TYPE_FN_FIELDLIST1 (t, m_index);
2063 lookup_symbol (TYPE_FN_FIELD_PHYSNAME (f, f_index),
2064 NULL, VAR_NAMESPACE, (int *) NULL,
2065 (struct symtab **)NULL);
2071 i1 = find_methods (t, copy, sym_arr);
2074 /* There is exactly one field with that name. */
2077 if (sym && SYMBOL_CLASS (sym) == LOC_BLOCK)
2079 values.sals = (struct symtab_and_line *)xmalloc (sizeof (struct symtab_and_line));
2081 values.sals[0] = find_function_start_sal (sym,
2092 /* There is more than one field with that name
2093 (overloaded). Ask the user which one to use. */
2094 return decode_line_2 (sym_arr, i1, funfirstline, canonical);
2100 if (OPNAME_PREFIX_P (copy))
2102 tmp = (char *)alloca (strlen (copy+3) + 9);
2103 strcpy (tmp, "operator ");
2104 strcat (tmp, copy+3);
2111 ("the class `%s' does not have destructor defined\n",
2112 SYMBOL_SOURCE_NAME(sym_class));
2115 ("the class %s does not have any method named %s\n",
2116 SYMBOL_SOURCE_NAME(sym_class), tmp);
2117 cplusplus_hint (saved_arg);
2118 return_to_top_level (RETURN_ERROR);
2124 /* The quotes are important if copy is empty. */
2126 ("can't find class, struct, or union named \"%s\"\n", copy);
2127 cplusplus_hint (saved_arg);
2128 return_to_top_level (RETURN_ERROR);
2134 /* Extract the file name. */
2136 while (p != *argptr && p[-1] == ' ') --p;
2137 copy = (char *) alloca (p - *argptr + 1);
2138 memcpy (copy, *argptr, p - *argptr);
2139 copy[p - *argptr] = 0;
2141 /* Find that file's data. */
2142 s = lookup_symtab (copy);
2145 if (!have_full_symbols () && !have_partial_symbols ())
2146 error (no_symtab_msg);
2147 error ("No source file named %s.", copy);
2150 /* Discard the file name from the arg. */
2152 while (*p == ' ' || *p == '\t') p++;
2156 /* S is specified file's symtab, or 0 if no file specified.
2157 arg no longer contains the file name. */
2159 /* Check whether arg is all digits (and sign) */
2162 if (*q == '-' || *q == '+') q++;
2163 while (*q >= '0' && *q <= '9')
2166 if (q != *argptr && (*q == 0 || *q == ' ' || *q == '\t' || *q == ','))
2168 /* We found a token consisting of all digits -- at least one digit. */
2169 enum sign {none, plus, minus} sign = none;
2171 /* We might need a canonical line spec if no file was specified. */
2172 int need_canonical = (s == 0) ? 1 : 0;
2174 /* This is where we need to make sure that we have good defaults.
2175 We must guarantee that this section of code is never executed
2176 when we are called with just a function name, since
2177 select_source_symtab calls us with such an argument */
2179 if (s == 0 && default_symtab == 0)
2181 select_source_symtab (0);
2182 default_symtab = current_source_symtab;
2183 default_line = current_source_line;
2186 if (**argptr == '+')
2187 sign = plus, (*argptr)++;
2188 else if (**argptr == '-')
2189 sign = minus, (*argptr)++;
2190 val.line = atoi (*argptr);
2197 val.line = default_line + val.line;
2203 val.line = default_line - val.line;
2208 break; /* No need to adjust val.line. */
2211 while (*q == ' ' || *q == '\t') q++;
2217 values.sals = (struct symtab_and_line *)xmalloc (sizeof (struct symtab_and_line));
2218 values.sals[0] = val;
2221 build_canonical_line_spec (values.sals, NULL, canonical);
2225 /* Arg token is not digits => try it as a variable name
2226 Find the next token (everything up to end or next whitespace). */
2228 if (**argptr == '$') /* Convenience variable */
2229 p = skip_quoted (*argptr + 1);
2232 p = skip_quoted (*argptr);
2234 error ("Unmatched single quote.");
2236 else if (has_parens)
2242 p = skip_quoted(*argptr);
2245 copy = (char *) alloca (p - *argptr + 1);
2246 memcpy (copy, *argptr, p - *argptr);
2247 copy[p - *argptr] = '\0';
2250 && copy[0] == copy [p - *argptr - 1]
2251 && strchr (gdb_completer_quote_characters, copy[0]) != NULL)
2253 copy [p - *argptr - 1] = '\0';
2256 while (*p == ' ' || *p == '\t') p++;
2259 /* See if it's a convenience variable */
2264 int need_canonical = (s == 0) ? 1 : 0;
2266 valx = value_of_internalvar (lookup_internalvar (copy + 1));
2267 if (TYPE_CODE (VALUE_TYPE (valx)) != TYPE_CODE_INT)
2268 error ("Convenience variables used in line specs must have integer values.");
2270 val.symtab = s ? s : default_symtab;
2271 val.line = value_as_long (valx);
2274 values.sals = (struct symtab_and_line *)xmalloc (sizeof val);
2275 values.sals[0] = val;
2279 build_canonical_line_spec (values.sals, NULL, canonical);
2285 /* Look up that token as a variable.
2286 If file specified, use that file's per-file block to start with. */
2288 sym = lookup_symbol (copy,
2289 (s ? BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), STATIC_BLOCK)
2290 : get_selected_block ()),
2291 VAR_NAMESPACE, 0, &sym_symtab);
2295 if (SYMBOL_CLASS (sym) == LOC_BLOCK)
2297 /* Arg is the name of a function */
2298 values.sals = (struct symtab_and_line *)xmalloc (sizeof (struct symtab_and_line));
2299 values.sals[0] = find_function_start_sal (sym, funfirstline);
2302 /* Don't use the SYMBOL_LINE; if used at all it points to
2303 the line containing the parameters or thereabouts, not
2304 the first line of code. */
2306 /* We might need a canonical line spec if it is a static
2310 struct blockvector *bv = BLOCKVECTOR (sym_symtab);
2311 struct block *b = BLOCKVECTOR_BLOCK (bv, STATIC_BLOCK);
2312 if (lookup_block_symbol (b, copy, VAR_NAMESPACE) != NULL)
2313 build_canonical_line_spec (values.sals, copy, canonical);
2320 error ("\"%s\" is not a function", copy);
2321 else if (SYMBOL_LINE (sym) != 0)
2323 /* We know its line number. */
2324 values.sals = (struct symtab_and_line *)
2325 xmalloc (sizeof (struct symtab_and_line));
2327 memset (&values.sals[0], 0, sizeof (values.sals[0]));
2328 values.sals[0].symtab = sym_symtab;
2329 values.sals[0].line = SYMBOL_LINE (sym);
2333 /* This can happen if it is compiled with a compiler which doesn't
2334 put out line numbers for variables. */
2335 /* FIXME: Shouldn't we just set .line and .symtab to zero
2336 and return? For example, "info line foo" could print
2338 error ("Line number not known for symbol \"%s\"", copy);
2342 msymbol = lookup_minimal_symbol (copy, NULL, NULL);
2343 if (msymbol != NULL)
2345 val.pc = SYMBOL_VALUE_ADDRESS (msymbol);
2348 val.pc += FUNCTION_START_OFFSET;
2349 SKIP_PROLOGUE (val.pc);
2351 values.sals = (struct symtab_and_line *)
2352 xmalloc (sizeof (struct symtab_and_line));
2353 values.sals[0] = val;
2358 if (!have_full_symbols () &&
2359 !have_partial_symbols () && !have_minimal_symbols ())
2360 error (no_symtab_msg);
2362 error ("Function \"%s\" not defined.", copy);
2363 return values; /* for lint */
2366 struct symtabs_and_lines
2367 decode_line_spec (string, funfirstline)
2371 struct symtabs_and_lines sals;
2373 error ("Empty line specification.");
2374 sals = decode_line_1 (&string, funfirstline,
2375 current_source_symtab, current_source_line,
2378 error ("Junk at end of line specification: %s", string);
2382 /* Given a list of NELTS symbols in SYM_ARR, return a list of lines to
2383 operate on (ask user if necessary).
2384 If CANONICAL is non-NULL return a corresponding array of mangled names
2385 as canonical line specs there. */
2387 static struct symtabs_and_lines
2388 decode_line_2 (sym_arr, nelts, funfirstline, canonical)
2389 struct symbol *sym_arr[];
2394 struct symtabs_and_lines values, return_values;
2399 struct cleanup *old_chain;
2400 char **canonical_arr = (char **)NULL;
2402 values.sals = (struct symtab_and_line *) alloca (nelts * sizeof(struct symtab_and_line));
2403 return_values.sals = (struct symtab_and_line *) xmalloc (nelts * sizeof(struct symtab_and_line));
2404 old_chain = make_cleanup (free, return_values.sals);
2408 canonical_arr = (char **) xmalloc (nelts * sizeof (char *));
2409 make_cleanup (free, canonical_arr);
2410 memset (canonical_arr, 0, nelts * sizeof (char *));
2411 *canonical = canonical_arr;
2415 printf_unfiltered("[0] cancel\n[1] all\n");
2418 INIT_SAL (&return_values.sals[i]); /* initialize to zeroes */
2419 INIT_SAL (&values.sals[i]);
2420 if (sym_arr[i] && SYMBOL_CLASS (sym_arr[i]) == LOC_BLOCK)
2422 values.sals[i] = find_function_start_sal (sym_arr[i], funfirstline);
2423 printf_unfiltered ("[%d] %s at %s:%d\n",
2425 SYMBOL_SOURCE_NAME (sym_arr[i]),
2426 values.sals[i].symtab->filename,
2427 values.sals[i].line);
2430 printf_unfiltered ("?HERE\n");
2434 if ((prompt = getenv ("PS2")) == NULL)
2438 printf_unfiltered("%s ",prompt);
2439 gdb_flush(gdb_stdout);
2441 args = command_line_input ((char *) NULL, 0, "overload-choice");
2443 if (args == 0 || *args == 0)
2444 error_no_arg ("one or more choice numbers");
2452 while (*arg1 >= '0' && *arg1 <= '9') arg1++;
2453 if (*arg1 && *arg1 != ' ' && *arg1 != '\t')
2454 error ("Arguments must be choice numbers.");
2459 error ("cancelled");
2464 for (i = 0; i < nelts; i++)
2466 if (canonical_arr[i] == NULL)
2468 symname = SYMBOL_NAME (sym_arr[i]);
2469 canonical_arr[i] = savestring (symname, strlen (symname));
2473 memcpy (return_values.sals, values.sals,
2474 (nelts * sizeof(struct symtab_and_line)));
2475 return_values.nelts = nelts;
2476 discard_cleanups (old_chain);
2477 return return_values;
2480 if (num >= nelts + 2)
2482 printf_unfiltered ("No choice number %d.\n", num);
2487 if (values.sals[num].pc)
2491 symname = SYMBOL_NAME (sym_arr[num]);
2492 make_cleanup (free, symname);
2493 canonical_arr[i] = savestring (symname, strlen (symname));
2495 return_values.sals[i++] = values.sals[num];
2496 values.sals[num].pc = 0;
2500 printf_unfiltered ("duplicate request for %d ignored.\n", num);
2505 while (*args == ' ' || *args == '\t') args++;
2507 return_values.nelts = i;
2508 discard_cleanups (old_chain);
2509 return return_values;
2513 /* Slave routine for sources_info. Force line breaks at ,'s.
2514 NAME is the name to print and *FIRST is nonzero if this is the first
2515 name printed. Set *FIRST to zero. */
2517 output_source_filename (name, first)
2521 /* Table of files printed so far. Since a single source file can
2522 result in several partial symbol tables, we need to avoid printing
2523 it more than once. Note: if some of the psymtabs are read in and
2524 some are not, it gets printed both under "Source files for which
2525 symbols have been read" and "Source files for which symbols will
2526 be read in on demand". I consider this a reasonable way to deal
2527 with the situation. I'm not sure whether this can also happen for
2528 symtabs; it doesn't hurt to check. */
2529 static char **tab = NULL;
2530 /* Allocated size of tab in elements.
2531 Start with one 256-byte block (when using GNU malloc.c).
2532 24 is the malloc overhead when range checking is in effect. */
2533 static int tab_alloc_size = (256 - 24) / sizeof (char *);
2534 /* Current size of tab in elements. */
2535 static int tab_cur_size;
2542 tab = (char **) xmalloc (tab_alloc_size * sizeof (*tab));
2546 /* Is NAME in tab? */
2547 for (p = tab; p < tab + tab_cur_size; p++)
2548 if (STREQ (*p, name))
2549 /* Yes; don't print it again. */
2551 /* No; add it to tab. */
2552 if (tab_cur_size == tab_alloc_size)
2554 tab_alloc_size *= 2;
2555 tab = (char **) xrealloc ((char *) tab, tab_alloc_size * sizeof (*tab));
2557 tab[tab_cur_size++] = name;
2565 printf_filtered (", ");
2569 fputs_filtered (name, gdb_stdout);
2573 sources_info (ignore, from_tty)
2577 register struct symtab *s;
2578 register struct partial_symtab *ps;
2579 register struct objfile *objfile;
2582 if (!have_full_symbols () && !have_partial_symbols ())
2584 error (no_symtab_msg);
2587 printf_filtered ("Source files for which symbols have been read in:\n\n");
2590 ALL_SYMTABS (objfile, s)
2592 output_source_filename (s -> filename, &first);
2594 printf_filtered ("\n\n");
2596 printf_filtered ("Source files for which symbols will be read in on demand:\n\n");
2599 ALL_PSYMTABS (objfile, ps)
2603 output_source_filename (ps -> filename, &first);
2606 printf_filtered ("\n");
2609 /* List all symbols (if REGEXP is NULL) or all symbols matching REGEXP.
2610 If CLASS is zero, list all symbols except functions, type names, and
2612 If CLASS is 1, list only functions.
2613 If CLASS is 2, list only type names.
2614 If CLASS is 3, list only method names.
2616 BPT is non-zero if we should set a breakpoint at the functions
2620 list_symbols (regexp, class, bpt, from_tty)
2626 register struct symtab *s;
2627 register struct partial_symtab *ps;
2628 register struct blockvector *bv;
2629 struct blockvector *prev_bv = 0;
2630 register struct block *b;
2632 register struct symbol *sym;
2633 struct partial_symbol **psym;
2634 struct objfile *objfile;
2635 struct minimal_symbol *msymbol;
2637 static char *classnames[]
2638 = {"variable", "function", "type", "method"};
2639 int found_in_file = 0;
2641 static enum minimal_symbol_type types[]
2642 = {mst_data, mst_text, mst_abs, mst_unknown};
2643 static enum minimal_symbol_type types2[]
2644 = {mst_bss, mst_file_text, mst_abs, mst_unknown};
2645 static enum minimal_symbol_type types3[]
2646 = {mst_file_data, mst_solib_trampoline, mst_abs, mst_unknown};
2647 static enum minimal_symbol_type types4[]
2648 = {mst_file_bss, mst_text, mst_abs, mst_unknown};
2649 enum minimal_symbol_type ourtype = types[class];
2650 enum minimal_symbol_type ourtype2 = types2[class];
2651 enum minimal_symbol_type ourtype3 = types3[class];
2652 enum minimal_symbol_type ourtype4 = types4[class];
2656 /* Make sure spacing is right for C++ operators.
2657 This is just a courtesy to make the matching less sensitive
2658 to how many spaces the user leaves between 'operator'
2659 and <TYPENAME> or <OPERATOR>. */
2661 char *opname = operator_chars (regexp, &opend);
2664 int fix = -1; /* -1 means ok; otherwise number of spaces needed. */
2665 if (isalpha(*opname) || *opname == '_' || *opname == '$')
2667 /* There should 1 space between 'operator' and 'TYPENAME'. */
2668 if (opname[-1] != ' ' || opname[-2] == ' ')
2673 /* There should 0 spaces between 'operator' and 'OPERATOR'. */
2674 if (opname[-1] == ' ')
2677 /* If wrong number of spaces, fix it. */
2680 char *tmp = (char*) alloca(opend-opname+10);
2681 sprintf(tmp, "operator%.*s%s", fix, " ", opname);
2686 if (0 != (val = re_comp (regexp)))
2687 error ("Invalid regexp (%s): %s", val, regexp);
2690 /* Search through the partial symtabs *first* for all symbols
2691 matching the regexp. That way we don't have to reproduce all of
2692 the machinery below. */
2694 ALL_PSYMTABS (objfile, ps)
2696 struct partial_symbol **bound, **gbound, **sbound;
2699 if (ps->readin) continue;
2701 gbound = objfile->global_psymbols.list + ps->globals_offset + ps->n_global_syms;
2702 sbound = objfile->static_psymbols.list + ps->statics_offset + ps->n_static_syms;
2705 /* Go through all of the symbols stored in a partial
2706 symtab in one loop. */
2707 psym = objfile->global_psymbols.list + ps->globals_offset;
2712 if (bound == gbound && ps->n_static_syms != 0)
2714 psym = objfile->static_psymbols.list + ps->statics_offset;
2725 /* If it would match (logic taken from loop below)
2726 load the file and go on to the next one */
2727 if ((regexp == NULL || SYMBOL_MATCHES_REGEXP (*psym))
2728 && ((class == 0 && SYMBOL_CLASS (*psym) != LOC_TYPEDEF
2729 && SYMBOL_CLASS (*psym) != LOC_BLOCK)
2730 || (class == 1 && SYMBOL_CLASS (*psym) == LOC_BLOCK)
2731 || (class == 2 && SYMBOL_CLASS (*psym) == LOC_TYPEDEF)
2732 || (class == 3 && SYMBOL_CLASS (*psym) == LOC_BLOCK)))
2734 PSYMTAB_TO_SYMTAB(ps);
2742 /* Here, we search through the minimal symbol tables for functions
2743 and variables that match, and force their symbols to be read.
2744 This is in particular necessary for demangled variable names,
2745 which are no longer put into the partial symbol tables.
2746 The symbol will then be found during the scan of symtabs below.
2748 For functions, find_pc_symtab should succeed if we have debug info
2749 for the function, for variables we have to call lookup_symbol
2750 to determine if the variable has debug info.
2751 If the lookup fails, set found_misc so that we will rescan to print
2752 any matching symbols without debug info.
2755 if (class == 0 || class == 1)
2757 ALL_MSYMBOLS (objfile, msymbol)
2759 if (MSYMBOL_TYPE (msymbol) == ourtype ||
2760 MSYMBOL_TYPE (msymbol) == ourtype2 ||
2761 MSYMBOL_TYPE (msymbol) == ourtype3 ||
2762 MSYMBOL_TYPE (msymbol) == ourtype4)
2764 if (regexp == NULL || SYMBOL_MATCHES_REGEXP (msymbol))
2766 if (0 == find_pc_symtab (SYMBOL_VALUE_ADDRESS (msymbol)))
2769 || lookup_symbol (SYMBOL_NAME (msymbol),
2770 (struct block *) NULL,
2772 0, (struct symtab **) NULL) == NULL)
2780 /* Printout here so as to get after the "Reading in symbols"
2781 messages which will be generated above. */
2783 printf_filtered (regexp
2784 ? "All %ss matching regular expression \"%s\":\n"
2785 : "All defined %ss:\n",
2789 ALL_SYMTABS (objfile, s)
2792 bv = BLOCKVECTOR (s);
2793 /* Often many files share a blockvector.
2794 Scan each blockvector only once so that
2795 we don't get every symbol many times.
2796 It happens that the first symtab in the list
2797 for any given blockvector is the main file. */
2799 for (i = GLOBAL_BLOCK; i <= STATIC_BLOCK; i++)
2801 b = BLOCKVECTOR_BLOCK (bv, i);
2802 /* Skip the sort if this block is always sorted. */
2803 if (!BLOCK_SHOULD_SORT (b))
2804 sort_block_syms (b);
2805 for (j = 0; j < BLOCK_NSYMS (b); j++)
2808 sym = BLOCK_SYM (b, j);
2809 if ((regexp == NULL || SYMBOL_MATCHES_REGEXP (sym))
2810 && ((class == 0 && SYMBOL_CLASS (sym) != LOC_TYPEDEF
2811 && SYMBOL_CLASS (sym) != LOC_BLOCK
2812 && SYMBOL_CLASS (sym) != LOC_CONST)
2813 || (class == 1 && SYMBOL_CLASS (sym) == LOC_BLOCK)
2814 || (class == 2 && SYMBOL_CLASS (sym) == LOC_TYPEDEF)
2815 || (class == 3 && SYMBOL_CLASS (sym) == LOC_BLOCK)))
2819 /* Set a breakpoint here, if it's a function */
2822 /* There may be more than one function with the
2823 same name but in different files. In order to
2824 set breakpoints on all of them, we must give
2825 both the file name and the function name to
2827 Quoting the symbol name gets rid of problems
2828 with mangled symbol names that contain
2829 CPLUS_MARKER characters. */
2831 (char *) alloca (strlen (s->filename)
2832 + strlen (SYMBOL_NAME(sym))
2834 strcpy (string, s->filename);
2835 strcat (string, ":'");
2836 strcat (string, SYMBOL_NAME(sym));
2837 strcat (string, "'");
2838 break_command (string, from_tty);
2841 else if (!found_in_file)
2843 fputs_filtered ("\nFile ", gdb_stdout);
2844 fputs_filtered (s->filename, gdb_stdout);
2845 fputs_filtered (":\n", gdb_stdout);
2849 if (class != 2 && i == STATIC_BLOCK)
2850 printf_filtered ("static ");
2852 /* Typedef that is not a C++ class */
2854 && SYMBOL_NAMESPACE (sym) != STRUCT_NAMESPACE)
2855 c_typedef_print (SYMBOL_TYPE(sym), sym, gdb_stdout);
2856 /* variable, func, or typedef-that-is-c++-class */
2857 else if (class < 2 ||
2859 SYMBOL_NAMESPACE(sym) == STRUCT_NAMESPACE))
2861 type_print (SYMBOL_TYPE (sym),
2862 (SYMBOL_CLASS (sym) == LOC_TYPEDEF
2863 ? "" : SYMBOL_SOURCE_NAME (sym)),
2866 printf_filtered (";\n");
2871 /* Tiemann says: "info methods was never implemented." */
2872 char *demangled_name;
2873 c_type_print_base (TYPE_FN_FIELD_TYPE(t, i),
2875 c_type_print_varspec_prefix (TYPE_FN_FIELD_TYPE(t, i),
2877 if (TYPE_FN_FIELD_STUB (t, i))
2878 check_stub_method (TYPE_DOMAIN_TYPE (type), j, i);
2880 cplus_demangle (TYPE_FN_FIELD_PHYSNAME (t, i),
2881 DMGL_ANSI | DMGL_PARAMS);
2882 if (demangled_name == NULL)
2883 fprintf_filtered (stream, "<badly mangled name %s>",
2884 TYPE_FN_FIELD_PHYSNAME (t, i));
2887 fputs_filtered (demangled_name, stream);
2888 free (demangled_name);
2898 /* If there are no eyes, avoid all contact. I mean, if there are
2899 no debug symbols, then print directly from the msymbol_vector. */
2901 if (found_misc || class != 1)
2904 ALL_MSYMBOLS (objfile, msymbol)
2906 if (MSYMBOL_TYPE (msymbol) == ourtype ||
2907 MSYMBOL_TYPE (msymbol) == ourtype2 ||
2908 MSYMBOL_TYPE (msymbol) == ourtype3 ||
2909 MSYMBOL_TYPE (msymbol) == ourtype4)
2911 if (regexp == NULL || SYMBOL_MATCHES_REGEXP (msymbol))
2913 /* Functions: Look up by address. */
2915 (0 == find_pc_symtab (SYMBOL_VALUE_ADDRESS (msymbol))))
2917 /* Variables/Absolutes: Look up by name */
2918 if (lookup_symbol (SYMBOL_NAME (msymbol),
2919 (struct block *) NULL, VAR_NAMESPACE,
2920 0, (struct symtab **) NULL) == NULL)
2924 break_command (SYMBOL_NAME (msymbol), from_tty);
2925 printf_filtered ("<function, no debug info> %s;\n",
2926 SYMBOL_SOURCE_NAME (msymbol));
2931 printf_filtered ("\nNon-debugging symbols:\n");
2934 printf_filtered (" %08lx %s\n",
2935 (unsigned long) SYMBOL_VALUE_ADDRESS (msymbol),
2936 SYMBOL_SOURCE_NAME (msymbol));
2946 variables_info (regexp, from_tty)
2950 list_symbols (regexp, 0, 0, from_tty);
2954 functions_info (regexp, from_tty)
2958 list_symbols (regexp, 1, 0, from_tty);
2962 types_info (regexp, from_tty)
2966 list_symbols (regexp, 2, 0, from_tty);
2970 /* Tiemann says: "info methods was never implemented." */
2972 methods_info (regexp)
2975 list_symbols (regexp, 3, 0, from_tty);
2979 /* Breakpoint all functions matching regular expression. */
2981 rbreak_command (regexp, from_tty)
2985 list_symbols (regexp, 1, 1, from_tty);
2989 /* Return Nonzero if block a is lexically nested within block b,
2990 or if a and b have the same pc range.
2991 Return zero otherwise. */
2994 struct block *a, *b;
2998 return BLOCK_START (a) >= BLOCK_START (b)
2999 && BLOCK_END (a) <= BLOCK_END (b);
3003 /* Helper routine for make_symbol_completion_list. */
3005 static int return_val_size;
3006 static int return_val_index;
3007 static char **return_val;
3009 #define COMPLETION_LIST_ADD_SYMBOL(symbol, sym_text, len, text, word) \
3011 if (SYMBOL_DEMANGLED_NAME (symbol) != NULL) \
3012 /* Put only the mangled name on the list. */ \
3013 /* Advantage: "b foo<TAB>" completes to "b foo(int, int)" */ \
3014 /* Disadvantage: "b foo__i<TAB>" doesn't complete. */ \
3015 completion_list_add_name \
3016 (SYMBOL_DEMANGLED_NAME (symbol), (sym_text), (len), (text), (word)); \
3018 completion_list_add_name \
3019 (SYMBOL_NAME (symbol), (sym_text), (len), (text), (word)); \
3022 /* Test to see if the symbol specified by SYMNAME (which is already
3023 demangled for C++ symbols) matches SYM_TEXT in the first SYM_TEXT_LEN
3024 characters. If so, add it to the current completion list. */
3027 completion_list_add_name (symname, sym_text, sym_text_len, text, word)
3037 /* clip symbols that cannot match */
3039 if (strncmp (symname, sym_text, sym_text_len) != 0)
3044 /* Clip any symbol names that we've already considered. (This is a
3045 time optimization) */
3047 for (i = 0; i < return_val_index; ++i)
3049 if (STREQ (symname, return_val[i]))
3055 /* We have a match for a completion, so add SYMNAME to the current list
3056 of matches. Note that the name is moved to freshly malloc'd space. */
3060 if (word == sym_text)
3062 new = xmalloc (strlen (symname) + 5);
3063 strcpy (new, symname);
3065 else if (word > sym_text)
3067 /* Return some portion of symname. */
3068 new = xmalloc (strlen (symname) + 5);
3069 strcpy (new, symname + (word - sym_text));
3073 /* Return some of SYM_TEXT plus symname. */
3074 new = xmalloc (strlen (symname) + (sym_text - word) + 5);
3075 strncpy (new, word, sym_text - word);
3076 new[sym_text - word] = '\0';
3077 strcat (new, symname);
3080 /* Recheck for duplicates if we intend to add a modified symbol. */
3081 if (word != sym_text)
3083 for (i = 0; i < return_val_index; ++i)
3085 if (STREQ (new, return_val[i]))
3093 if (return_val_index + 3 > return_val_size)
3095 newsize = (return_val_size *= 2) * sizeof (char *);
3096 return_val = (char **) xrealloc ((char *) return_val, newsize);
3098 return_val[return_val_index++] = new;
3099 return_val[return_val_index] = NULL;
3103 /* Return a NULL terminated array of all symbols (regardless of class) which
3104 begin by matching TEXT. If the answer is no symbols, then the return value
3105 is an array which contains only a NULL pointer.
3107 Problem: All of the symbols have to be copied because readline frees them.
3108 I'm not going to worry about this; hopefully there won't be that many. */
3111 make_symbol_completion_list (text, word)
3115 register struct symbol *sym;
3116 register struct symtab *s;
3117 register struct partial_symtab *ps;
3118 register struct minimal_symbol *msymbol;
3119 register struct objfile *objfile;
3120 register struct block *b, *surrounding_static_block = 0;
3122 struct partial_symbol **psym;
3123 /* The symbol we are completing on. Points in same buffer as text. */
3125 /* Length of sym_text. */
3128 /* Now look for the symbol we are supposed to complete on.
3129 FIXME: This should be language-specific. */
3133 char *quote_pos = NULL;
3135 /* First see if this is a quoted string. */
3137 for (p = text; *p != '\0'; ++p)
3139 if (quote_found != '\0')
3141 if (*p == quote_found)
3142 /* Found close quote. */
3144 else if (*p == '\\' && p[1] == quote_found)
3145 /* A backslash followed by the quote character
3146 doesn't end the string. */
3149 else if (*p == '\'' || *p == '"')
3155 if (quote_found == '\'')
3156 /* A string within single quotes can be a symbol, so complete on it. */
3157 sym_text = quote_pos + 1;
3158 else if (quote_found == '"')
3159 /* A double-quoted string is never a symbol, nor does it make sense
3160 to complete it any other way. */
3164 /* It is not a quoted string. Break it based on the characters
3165 which are in symbols. */
3168 if (isalnum (p[-1]) || p[-1] == '_' || p[-1] == '\0')
3177 sym_text_len = strlen (sym_text);
3179 return_val_size = 100;
3180 return_val_index = 0;
3181 return_val = (char **) xmalloc ((return_val_size + 1) * sizeof (char *));
3182 return_val[0] = NULL;
3184 /* Look through the partial symtabs for all symbols which begin
3185 by matching SYM_TEXT. Add each one that you find to the list. */
3187 ALL_PSYMTABS (objfile, ps)
3189 /* If the psymtab's been read in we'll get it when we search
3190 through the blockvector. */
3191 if (ps->readin) continue;
3193 for (psym = objfile->global_psymbols.list + ps->globals_offset;
3194 psym < (objfile->global_psymbols.list + ps->globals_offset
3195 + ps->n_global_syms);
3198 /* If interrupted, then quit. */
3200 COMPLETION_LIST_ADD_SYMBOL (*psym, sym_text, sym_text_len, text, word);
3203 for (psym = objfile->static_psymbols.list + ps->statics_offset;
3204 psym < (objfile->static_psymbols.list + ps->statics_offset
3205 + ps->n_static_syms);
3209 COMPLETION_LIST_ADD_SYMBOL (*psym, sym_text, sym_text_len, text, word);
3213 /* At this point scan through the misc symbol vectors and add each
3214 symbol you find to the list. Eventually we want to ignore
3215 anything that isn't a text symbol (everything else will be
3216 handled by the psymtab code above). */
3218 ALL_MSYMBOLS (objfile, msymbol)
3221 COMPLETION_LIST_ADD_SYMBOL (msymbol, sym_text, sym_text_len, text, word);
3224 /* Search upwards from currently selected frame (so that we can
3225 complete on local vars. */
3227 for (b = get_selected_block (); b != NULL; b = BLOCK_SUPERBLOCK (b))
3229 if (!BLOCK_SUPERBLOCK (b))
3231 surrounding_static_block = b; /* For elmin of dups */
3234 /* Also catch fields of types defined in this places which match our
3235 text string. Only complete on types visible from current context. */
3237 for (i = 0; i < BLOCK_NSYMS (b); i++)
3239 sym = BLOCK_SYM (b, i);
3240 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3241 if (SYMBOL_CLASS (sym) == LOC_TYPEDEF)
3243 struct type *t = SYMBOL_TYPE (sym);
3244 enum type_code c = TYPE_CODE (t);
3246 if (c == TYPE_CODE_UNION || c == TYPE_CODE_STRUCT)
3248 for (j = TYPE_N_BASECLASSES (t); j < TYPE_NFIELDS (t); j++)
3250 if (TYPE_FIELD_NAME (t, j))
3252 completion_list_add_name (TYPE_FIELD_NAME (t, j),
3253 sym_text, sym_text_len, text, word);
3261 /* Go through the symtabs and check the externs and statics for
3262 symbols which match. */
3264 ALL_SYMTABS (objfile, s)
3267 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), GLOBAL_BLOCK);
3268 for (i = 0; i < BLOCK_NSYMS (b); i++)
3270 sym = BLOCK_SYM (b, i);
3271 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3275 ALL_SYMTABS (objfile, s)
3278 b = BLOCKVECTOR_BLOCK (BLOCKVECTOR (s), STATIC_BLOCK);
3279 /* Don't do this block twice. */
3280 if (b == surrounding_static_block) continue;
3281 for (i = 0; i < BLOCK_NSYMS (b); i++)
3283 sym = BLOCK_SYM (b, i);
3284 COMPLETION_LIST_ADD_SYMBOL (sym, sym_text, sym_text_len, text, word);
3288 return (return_val);
3291 /* Determine if PC is in the prologue of a function. The prologue is the area
3292 between the first instruction of a function, and the first executable line.
3293 Returns 1 if PC *might* be in prologue, 0 if definately *not* in prologue.
3295 If non-zero, func_start is where we thing the prologue starts, possibly
3296 by previous examination of symbol table information.
3300 in_prologue (pc, func_start)
3302 CORE_ADDR func_start;
3304 struct symtab_and_line sal;
3305 CORE_ADDR func_addr, func_end;
3307 if (!find_pc_partial_function (pc, NULL, &func_addr, &func_end))
3308 goto nosyms; /* Might be in prologue */
3310 sal = find_pc_line (func_addr, 0);
3315 if (sal.end > func_addr
3316 && sal.end <= func_end) /* Is prologue in function? */
3317 return pc < sal.end; /* Yes, is pc in prologue? */
3319 /* The line after the prologue seems to be outside the function. In this
3320 case, tell the caller to find the prologue the hard way. */
3324 /* Come here when symtabs don't contain line # info. In this case, it is
3325 likely that the user has stepped into a library function w/o symbols, or
3326 is doing a stepi/nexti through code without symbols. */
3330 /* If func_start is zero (meaning unknown) then we don't know whether pc is
3331 in the prologue or not. I.E. it might be. */
3333 if (!func_start) return 1;
3335 /* We need to call the target-specific prologue skipping functions with the
3336 function's start address because PC may be pointing at an instruction that
3337 could be mistakenly considered part of the prologue. */
3339 SKIP_PROLOGUE (func_start);
3341 return pc < func_start;
3346 _initialize_symtab ()
3348 add_info ("variables", variables_info,
3349 "All global and static variable names, or those matching REGEXP.");
3350 add_info ("functions", functions_info,
3351 "All function names, or those matching REGEXP.");
3353 /* FIXME: This command has at least the following problems:
3354 1. It prints builtin types (in a very strange and confusing fashion).
3355 2. It doesn't print right, e.g. with
3356 typedef struct foo *FOO
3357 type_print prints "FOO" when we want to make it (in this situation)
3358 print "struct foo *".
3359 I also think "ptype" or "whatis" is more likely to be useful (but if
3360 there is much disagreement "info types" can be fixed). */
3361 add_info ("types", types_info,
3362 "All type names, or those matching REGEXP.");
3365 add_info ("methods", methods_info,
3366 "All method names, or those matching REGEXP::REGEXP.\n\
3367 If the class qualifier is omitted, it is assumed to be the current scope.\n\
3368 If the first REGEXP is omitted, then all methods matching the second REGEXP\n\
3371 add_info ("sources", sources_info,
3372 "Source files in the program.");
3374 add_com ("rbreak", no_class, rbreak_command,
3375 "Set a breakpoint for all functions matching REGEXP.");
3377 /* Initialize the one built-in type that isn't language dependent... */
3378 builtin_type_error = init_type (TYPE_CODE_ERROR, 0, 0,
3379 "<unknown type>", (struct objfile *) NULL);