X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Fpsymtab.h;h=c761fa72222603a0f1d6d3e0a584256c1c22f0f4;hb=b9a3f8429b012b753e30a4222bd8e4cbba019fad;hp=6d9f257f31fcba6bbd598be423b2031068225142;hpb=e2882c85786571175a0b0bfc3bcd2f14620b1ea3;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/psymtab.h b/gdb/psymtab.h index 6d9f257f31..c761fa7222 100644 --- a/gdb/psymtab.h +++ b/gdb/psymtab.h @@ -1,6 +1,6 @@ /* Public partial symbol table definitions. - Copyright (C) 2009-2018 Free Software Foundation, Inc. + Copyright (C) 2009-2019 Free Software Foundation, Inc. This file is part of GDB. @@ -20,15 +20,122 @@ #ifndef PSYMTAB_H #define PSYMTAB_H +#include "gdb_obstack.h" #include "symfile.h" +#include "common/next-iterator.h" +#include "bcache.h" -/* A bcache for partial symbols. */ +struct partial_symbol; -struct psymbol_bcache; +/* An instance of this class manages the partial symbol tables and + partial symbols for a given objfile. + + The core psymtab functions -- those in psymtab.c -- arrange for + nearly all psymtab- and psymbol-related allocations to happen + either in the psymtab_storage object (either on its obstack or in + other memory managed by this class), or on the per-BFD object. The + only link from the psymtab storage object back to the objfile (or + objfile_obstack) that is made by the core psymtab code is the + compunit_symtab member in the psymtab. + + However, it is up to each symbol reader to maintain this invariant + in other ways, if it wants to reuse psymtabs across multiple + objfiles. The main issue here is ensuring that read_symtab_private + does not point into objfile_obstack. */ + +class psymtab_storage +{ +public: + + psymtab_storage (); + + ~psymtab_storage (); + + DISABLE_COPY_AND_ASSIGN (psymtab_storage); + + /* Discard all partial symbol tables starting with "psymtabs" and + proceeding until "to" has been discarded. */ + + void discard_psymtabs_to (struct partial_symtab *to) + { + while (psymtabs != to) + discard_psymtab (psymtabs); + } + + /* Discard the partial symbol table. */ + + void discard_psymtab (struct partial_symtab *pst); + + /* Return the obstack that is used for storage by this object. */ + + struct obstack *obstack () + { + if (!m_obstack.has_value ()) + m_obstack.emplace (); + return &*m_obstack; + } + + /* Allocate storage for the "dependencies" field of a psymtab. + NUMBER says how many dependencies there are. */ + + struct partial_symtab **allocate_dependencies (int number) + { + return OBSTACK_CALLOC (obstack (), number, struct partial_symtab *); + } + + /* Allocate a new psymtab on the psymtab obstack. The new psymtab + will be linked in to the "psymtabs" list, but otherwise all other + fields will be zero. */ + + struct partial_symtab *allocate_psymtab (); + + typedef next_adapter partial_symtab_range; + + /* A range adapter that makes it possible to iterate over all + psymtabs in one objfile. */ + + partial_symtab_range range () + { + return partial_symtab_range (psymtabs); + } + + + /* Each objfile points to a linked list of partial symtabs derived from + this file, one partial symtab structure for each compilation unit + (source file). */ + + struct partial_symtab *psymtabs = nullptr; + + /* Map addresses to the entries of PSYMTABS. It would be more efficient to + have a map per the whole process but ADDRMAP cannot selectively remove + its items during FREE_OBJFILE. This mapping is already present even for + PARTIAL_SYMTABs which still have no corresponding full SYMTABs read. */ + + struct addrmap *psymtabs_addrmap = nullptr; + + /* A byte cache where we can stash arbitrary "chunks" of bytes that + will not change. */ + + struct bcache psymbol_cache; + + /* Vectors of all partial symbols read in from file. The actual data + is stored in the objfile_obstack. */ + + std::vector global_psymbols; + std::vector static_psymbols; + +private: + + /* List of freed partial symtabs, available for re-use. */ + + struct partial_symtab *free_psymtabs = nullptr; + + /* The obstack where allocations are made. This is lazily allocated + so that we don't waste memory when there are no psymtabs. */ + + gdb::optional m_obstack; +}; -extern struct psymbol_bcache *psymbol_bcache_init (void); -extern void psymbol_bcache_free (struct psymbol_bcache *); -extern struct bcache *psymbol_bcache_get_bcache (struct psymbol_bcache *); extern const struct quick_symbol_functions psym_functions; @@ -37,10 +144,10 @@ extern const struct quick_symbol_functions dwarf2_debug_names_functions; /* Ensure that the partial symbols for OBJFILE have been loaded. If VERBOSE is non-zero, then this will print a message when symbols - are loaded. This function always returns its argument, as a - convenience. */ + are loaded. This function returns a range adapter suitable for + iterating over the psymtabs of OBJFILE. */ -extern struct objfile *require_partial_symbols (struct objfile *objfile, - int verbose); +extern psymtab_storage::partial_symtab_range require_partial_symbols + (struct objfile *objfile, int verbose); #endif /* PSYMTAB_H */