/* Definitions for reading symbol files into GDB. Copyright (C) 1990, 1991 Free Software Foundation, Inc. This file is part of GDB. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ /* This file requires that you first include "bfd.h". */ /* Structure for keeping track of object files. One of these is allocated for each object file we access, e.g. the exec_file, symbol_file, and any shared library object files. */ struct objfile { /* All struct objfile's are chained together by their next pointers. */ struct objfile *next; /* Each objfile points to a chain of struct symtabs derived from this object file. They are chained by their objfile_chain pointers, and each one points back to this struct objfile. */ struct symtab *symtabs; /* Ditto for psymtabs. */ struct partial_symtab *psymtabs; /* The object file's name. Malloc'd; free it if you free this struct. */ char *name; /* The object file's BFD. Can be null, in which case bfd_open (name) and put the result here. */ bfd *obfd; /* The modification timestamp of the object file, as of the last time we read its symbols. */ long mtime; }; /* Structure to keep track of symbol reading functions for various object file types. */ struct sym_fns { /* sym_name is the name, or name prefix, of the BFD "target type" that this set of functions handles. E.g. "a.out" or "sunOs" or "coff" or "elf". */ char *sym_name; /* sym_namelen counts how many bytes of sym_name should be checked against the BFD target type of the file being read. If an exact match is desired, specify the number of characters in sym_name plus 1 for the NUL. If a prefix match is desired, specify the number of characters in sym_name. */ int sym_namelen; /* sym_new_init initializes anything that is global to the entire symbol table. It is called during symbol_file_add, when we begin debugging an entirely new program. */ void (*sym_new_init) (); /* sym_init (sf) reads any initial information from a symbol file, and initializes the struct sym_fns SF in preparation for sym_read(). It is called every time we read a symbol file for any reason. */ void (*sym_init) (); /* sym_read (sf, addr, mainline) reads a symbol file into a psymtab (or possibly a symtab). SF is the struct sym_fns that sym_init initialized. ADDR is the offset between the file's specified start address and its true address in memory. MAINLINE is 1 if this is the main symbol table being read, and 0 if a secondary symbol file (e.g. shared library or dynamically loaded file) is being read. */ void (*sym_read) (); /* sym_bfd is the accessor for the symbol file being read. */ bfd *sym_bfd; /* sym_private is where information can be shared among sym_init and sym_read. It is typically a pointer to malloc'd memory. */ char *sym_private; /* Should be void * */ /* next finds the next struct sym_fns. They are allocated and initialized in whatever module implements the functions pointed to; an initializer calls add_symtab_fns to add them to the global chain. */ struct sym_fns *next; /* objfile is the "struct objfile" for the object file being read. */ struct objfile *objfile; }; extern void extend_psymbol_list(); /* Add any kind of symbol to a psymbol_allocation_list. */ #define ADD_PSYMBOL_VT_TO_LIST(NAME, NAMELENGTH, NAMESPACE, CLASS, LIST, VALUE, VT)\ do { \ register struct partial_symbol *psym; \ if ((LIST).next >= (LIST).list + (LIST).size) \ extend_psymbol_list(&(LIST)); \ psym = (LIST).next++; \ \ SYMBOL_NAME (psym) = (char *) obstack_alloc (psymbol_obstack, \ (NAMELENGTH) + 1); \ strncpy (SYMBOL_NAME (psym), (NAME), (NAMELENGTH)); \ SYMBOL_NAME (psym)[(NAMELENGTH)] = '\0'; \ SYMBOL_NAMESPACE (psym) = (NAMESPACE); \ SYMBOL_CLASS (psym) = (CLASS); \ VT (psym) = (VALUE); \ } while (0); /* Functions */ extern struct symtab *allocate_symtab (); extern struct objfile *allocate_objfile (); extern void free_objfile (); extern int free_named_symtabs (); extern void fill_in_vptr_fieldno (); extern void add_symtab_fns (); extern void syms_from_objfile (); /* Functions for dealing with the misc "function" vector, really a misc address<->symbol mapping vector for things we don't have debug symbols for. */ extern void init_misc_bunches (); extern void prim_record_misc_function (); extern void discard_misc_bunches (); extern void condense_misc_bunches (); /* Sorting your symbols for fast lookup or alphabetical printing. */ extern void sort_block_syms (); extern void sort_symtab_syms (); extern void sort_all_symtab_syms (); extern void sort_block_syms (); /* Make a copy of the string at PTR with SIZE characters in the symbol obstack (and add a null character at the end in the copy). Returns the address of the copy. */ extern char *obsavestring (); /* Concatenate strings S1, S2 and S3; return the new string. Space is found in the symbol_obstack. */ extern char *obconcat (); /* Variables */ /* The object file that the main symbol table was loaded from (e.g. the argument to the "symbol-file" or "file" command). */ extern struct objfile *symfile_objfile; /* Where execution starts in symfile */ CORE_ADDR entry_point; /* Root of object file struct chain. */ struct objfile *object_files; /* Vectors of all partial symbols read in from file. */ extern struct psymbol_allocation_list { struct partial_symbol *list, *next; int size; } global_psymbols, static_psymbols; /* Support for complaining about things in the symbol file that aren't catastrophic. Each such thing gets a counter. The first time we have the problem, during a symbol read, we report it. At the end of symbol reading, if verbose, we report how many of each problem we had. */ struct complaint { char *message; unsigned counter; struct complaint *next; }; /* Root of the chain of complaints that have at some point been issued. This is used to reset the counters, and/or report the total counts. */ extern struct complaint complaint_root[1]; /* Functions that handle complaints. (in symfile.c) */ void complain(); void clear_complaints();