gdb/psymtab.h

   1 /* Public partial symbol table definitions.
   2
   3    Copyright (C) 2009-2019 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   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 3 of the License, or
  10    (at your option) any later version.
  11
  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.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef PSYMTAB_H
  21 #define PSYMTAB_H
  22
  23 #include "gdb_obstack.h"
  24 #include "symfile.h"
  25 #include "common/next-iterator.h"
  26
  27 struct partial_symbol;
  28
  29 /* A bcache for partial symbols.  */
  30
  31 struct psymbol_bcache;
  32
  33 /* An instance of this class manages the partial symbol tables and
  34    partial symbols for a given objfile.  */
  35
  36 class psymtab_storage
  37 {
  38 public:
  39
  40   explicit psymtab_storage (struct objfile *objfile);
  41
  42   ~psymtab_storage ();
  43
  44   DISABLE_COPY_AND_ASSIGN (psymtab_storage);
  45
  46   /* Discard all partial symbol tables starting with "psymtabs" and
  47      proceeding until "to" has been discarded.  */
  48
  49   void discard_psymtabs_to (struct partial_symtab *to)
  50   {
  51     while (psymtabs != to)
  52       discard_psymtab (psymtabs);
  53   }
  54
  55   /* Discard the partial symbol table.  */
  56
  57   void discard_psymtab (struct partial_symtab *pst);
  58
  59   /* Return the obstack that is used for storage by this object.  */
  60
  61   struct obstack *obstack ()
  62   {
  63     return m_obstack;
  64   }
  65
  66   /* Allocate storage for the "dependencies" field of a psymtab.
  67      NUMBER says how many dependencies there are.  */
  68
  69   struct partial_symtab **allocate_dependencies (int number)
  70   {
  71     return OBSTACK_CALLOC (obstack (), number, struct partial_symtab *);
  72   }
  73
  74   /* Allocate a new psymtab on the psymtab obstack.  The new psymtab
  75      will be linked in to the "psymtabs" list, but otherwise all other
  76      fields will be zero.  */
  77
  78   struct partial_symtab *allocate_psymtab ();
  79
  80
  81   /* Each objfile points to a linked list of partial symtabs derived from
  82      this file, one partial symtab structure for each compilation unit
  83      (source file).  */
  84
  85   struct partial_symtab *psymtabs = nullptr;
  86
  87   /* Map addresses to the entries of PSYMTABS.  It would be more efficient to
  88      have a map per the whole process but ADDRMAP cannot selectively remove
  89      its items during FREE_OBJFILE.  This mapping is already present even for
  90      PARTIAL_SYMTABs which still have no corresponding full SYMTABs read.  */
  91
  92   struct addrmap *psymtabs_addrmap = nullptr;
  93
  94   /* A byte cache where we can stash arbitrary "chunks" of bytes that
  95      will not change.  */
  96
  97   struct psymbol_bcache *psymbol_cache;
  98
  99   /* Vectors of all partial symbols read in from file.  The actual data
 100      is stored in the objfile_obstack.  */
 101
 102   std::vector<partial_symbol *> global_psymbols;
 103   std::vector<partial_symbol *> static_psymbols;
 104
 105 private:
 106
 107   /* List of freed partial symtabs, available for re-use.  */
 108
 109   struct partial_symtab *free_psymtabs = nullptr;
 110
 111   /* The obstack where allocations are made.  */
 112
 113   struct obstack *m_obstack;
 114 };
 115
 116
 117 extern struct psymbol_bcache *psymbol_bcache_init (void);
 118 extern void psymbol_bcache_free (struct psymbol_bcache *);
 119 extern struct bcache *psymbol_bcache_get_bcache (struct psymbol_bcache *);
 120
 121 extern const struct quick_symbol_functions psym_functions;
 122
 123 extern const struct quick_symbol_functions dwarf2_gdb_index_functions;
 124 extern const struct quick_symbol_functions dwarf2_debug_names_functions;
 125
 126 /* Ensure that the partial symbols for OBJFILE have been loaded.  If
 127    VERBOSE is non-zero, then this will print a message when symbols
 128    are loaded.  This function returns a range adapter suitable for
 129    iterating over the psymtabs of OBJFILE.  */
 130
 131 class objfile_psymtabs;
 132 extern objfile_psymtabs require_partial_symbols (struct objfile *objfile,
 133                                                  int verbose);
 134
 135 #endif /* PSYMTAB_H */