gdb/buildsym.h

   1 /* Build symbol tables in GDB's internal format.
   2    Copyright (C) 1986-1991 Free Software Foundation, Inc.
   3
   4 This file is part of GDB.
   5
   6 This program is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2 of the License, or
   9 (at your option) any later version.
  10
  11 This program is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with this program; if not, write to the Free Software
  18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19
  20 #if !defined (BUILDSYM_H)
  21 #define BUILDSYM_H 1
  22
  23 /* This module provides definitions used for creating and adding to
  24    the symbol table.  These routines are called from various symbol-
  25    file-reading routines.
  26
  27    They originated in dbxread.c of gdb-4.2, and were split out to
  28    make xcoffread.c more maintainable by sharing code.
  29
  30    Variables declared in this file can be defined by #define-ing
  31    the name EXTERN to null.  It is used to declare variables that
  32    are normally extern, but which get defined in a single module
  33    using this technique.  */
  34
  35 #ifndef EXTERN
  36 #define EXTERN  extern
  37 #endif
  38
  39 /* Convert stab register number (from `r' declaration) to a gdb REGNUM.  */
  40
  41 #ifndef STAB_REG_TO_REGNUM
  42 #define STAB_REG_TO_REGNUM(VALUE) (VALUE)
  43 #endif
  44 \f
  45 /* Name of source file whose symbol data we are now processing.
  46    This comes from a symbol of type N_SO.  */
  47
  48 EXTERN char *last_source_file;
  49
  50 /* Core address of start of text of current source file.
  51    This too comes from the N_SO symbol.  */
  52
  53 EXTERN CORE_ADDR last_source_start_addr;
  54
  55 /* The list of sub-source-files within the current individual compilation.
  56    Each file gets its own symtab with its own linetable and associated info,
  57    but they all share one blockvector.  */
  58
  59 struct subfile
  60 {
  61   struct subfile *next;
  62   char *name;
  63   char *dirname;
  64   struct linetable *line_vector;
  65   int line_vector_length;
  66 };
  67
  68 EXTERN struct subfile *subfiles;
  69
  70 EXTERN struct subfile *current_subfile;
  71
  72 /* Global variable which, when set, indicates that we are processing a
  73    .o file compiled with gcc */
  74
  75 EXTERN unsigned char processing_gcc_compilation;
  76
  77 /* Count symbols as they are processed, for error messages.  */
  78
  79 EXTERN unsigned int symnum;
  80
  81 /* Vector of types defined so far, indexed by their dbx type numbers.
  82    (In newer sun systems, dbx uses a pair of numbers in parens,
  83     as in "(SUBFILENUM,NUMWITHINSUBFILE)".  Then these numbers must be
  84     translated through the type_translations hash table to get
  85     the index into the type vector.)  */
  86
  87 EXTERN struct type **type_vector;
  88
  89 /* Number of elements allocated for type_vector currently.  */
  90
  91 EXTERN int type_vector_length;
  92
  93 /* Hash table of global symbols whose values are not known yet.
  94    They are chained thru the SYMBOL_VALUE_CHAIN, since we don't
  95    have the correct data for that slot yet.  */
  96 /* The use of the LOC_BLOCK code in this chain is nonstandard--
  97    it refers to a FORTRAN common block rather than the usual meaning.  */
  98
  99 #define HASHSIZE 127
 100 EXTERN struct symbol *global_sym_chain[HASHSIZE];
 101
 102 /* Record the symbols defined for each context in a list.
 103    We don't create a struct block for the context until we
 104    know how long to make it.  */
 105
 106 #define PENDINGSIZE 100
 107
 108 struct pending
 109 {
 110   struct pending *next;
 111   int nsyms;
 112   struct symbol *symbol[PENDINGSIZE];
 113 };
 114
 115 /* List of free `struct pending' structures for reuse.  */
 116 EXTERN struct pending *free_pendings;
 117
 118 /* Here are the three lists that symbols are put on.  */
 119
 120 EXTERN struct pending *file_symbols;    /* static at top level, and types */
 121
 122 EXTERN struct pending *global_symbols;  /* global functions and variables */
 123
 124 EXTERN struct pending *local_symbols;   /* everything local to lexic context */
 125
 126 /* Kludge for xcoffread.c */
 127 struct pending_stabs {
 128   int   count, length;
 129   char  *stab[1];
 130 };
 131
 132 EXTERN struct pending_stabs *global_stabs;
 133
 134 /* List of symbols declared since the last BCOMM.  This list is a tail
 135    of local_symbols.  When ECOMM is seen, the symbols on the list
 136    are noted so their proper addresses can be filled in later,
 137    using the common block base address gotten from the assembler
 138    stabs.  */
 139
 140 EXTERN struct pending *common_block;
 141 EXTERN int common_block_i;
 142
 143 /* Stack representing unclosed lexical contexts
 144    (that will become blocks, eventually).  */
 145
 146 struct context_stack
 147 {
 148   struct pending *locals;       /* Outer locals at the time we entered */
 149   struct pending_block *old_blocks; /* Pointer into blocklist as of entry */
 150   struct symbol *name;          /* Name of function, if any, defining context*/
 151   CORE_ADDR start_addr;         /* PC where this context starts */
 152   CORE_ADDR end_addr;           /* Temp slot for exception handling. */
 153   int depth;                    /* For error-checking matching push/pop */
 154 };
 155
 156 EXTERN struct context_stack *context_stack;
 157
 158 /* Index of first unused entry in context stack.  */
 159 EXTERN int context_stack_depth;
 160
 161 /* Currently allocated size of context stack.  */
 162
 163 EXTERN int context_stack_size;
 164
 165 /* Macro "function" for popping contexts from the stack.  Pushing is done
 166    by a real function, push_context.  This returns a pointer to a struct
 167    context_stack.  */
 168
 169 #define pop_context()   \
 170       (&context_stack[--context_stack_depth]);
 171
 172 /* Nonzero if within a function (so symbols should be local,
 173    if nothing says specifically).  */
 174
 175 EXTERN int within_function;
 176
 177 /* List of blocks already made (lexical contexts already closed).
 178    This is used at the end to make the blockvector.  */
 179
 180 struct pending_block
 181 {
 182   struct pending_block *next;
 183   struct block *block;
 184 };
 185
 186 EXTERN struct pending_block *pending_blocks;
 187
 188 /* Global variable which, when set, indicates that we are processing a
 189    .o file compiled with gcc */
 190
 191 EXTERN unsigned char processing_gcc_compilation;
 192
 193 /* The type code that process_one_symbol saw on its previous invocation.
 194    Used to detect pairs of N_SO symbols. */
 195
 196 EXTERN int previous_stab_code;
 197
 198 /* Setup a define to deal cleanly with the underscore problem */
 199
 200 #ifdef NAMES_HAVE_UNDERSCORE
 201 #define HASH_OFFSET 1
 202 #else
 203 #define HASH_OFFSET 0
 204 #endif
 205 \f
 206 /* Support for Sun changes to dbx symbol format */
 207
 208 /* For each identified header file, we have a table of types defined
 209    in that header file.
 210
 211    header_files maps header file names to their type tables.
 212    It is a vector of n_header_files elements.
 213    Each element describes one header file.
 214    It contains a vector of types.
 215
 216    Sometimes it can happen that the same header file produces
 217    different results when included in different places.
 218    This can result from conditionals or from different
 219    things done before including the file.
 220    When this happens, there are multiple entries for the file in this table,
 221    one entry for each distinct set of results.
 222    The entries are distinguished by the INSTANCE field.
 223    The INSTANCE field appears in the N_BINCL and N_EXCL symbol table and is
 224    used to match header-file references to their corresponding data.  */
 225
 226 struct header_file
 227 {
 228   char *name;                   /* Name of header file */
 229   int instance;                 /* Numeric code distinguishing instances
 230                                    of one header file that produced
 231                                    different results when included.
 232                                    It comes from the N_BINCL or N_EXCL.  */
 233   struct type **vector;         /* Pointer to vector of types */
 234   int length;                   /* Allocated length (# elts) of that vector */
 235 };
 236
 237 EXTERN struct header_file *header_files;
 238
 239 EXTERN int n_header_files;
 240
 241 EXTERN int n_allocated_header_files;
 242
 243 /* Within each object file, various header files are assigned numbers.
 244    A type is defined or referred to with a pair of numbers
 245    (FILENUM,TYPENUM) where FILENUM is the number of the header file
 246    and TYPENUM is the number within that header file.
 247    TYPENUM is the index within the vector of types for that header file.
 248
 249    FILENUM == 1 is special; it refers to the main source of the object file,
 250    and not to any header file.  FILENUM != 1 is interpreted by looking it up
 251    in the following table, which contains indices in header_files.  */
 252
 253 EXTERN int *this_object_header_files;
 254
 255 EXTERN int n_this_object_header_files;
 256
 257 EXTERN int n_allocated_this_object_header_files;
 258
 259 struct subfile_stack
 260 {
 261   struct subfile_stack *next;
 262   char *name;
 263 };
 264
 265 EXTERN struct subfile_stack *subfile_stack;
 266
 267 extern struct complaint unknown_symtype_complaint;
 268
 269 #define next_symbol_text() (*next_symbol_text_func)()
 270
 271 /* Function to invoke get the next symbol.  Return the symbol name. */
 272
 273 EXTERN char *(*next_symbol_text_func) PARAMS ((void));
 274
 275 extern void
 276 add_symbol_to_list PARAMS ((struct symbol *, struct pending **));
 277
 278 extern struct symbol *
 279 find_symbol_in_list PARAMS ((struct pending *, char *, int));
 280
 281 extern void
 282 read_type_number PARAMS ((char **, int *));
 283
 284 extern struct type *
 285 read_type PARAMS ((char **, struct objfile *));
 286
 287 extern struct type **
 288 dbx_lookup_type PARAMS ((int [2]));
 289
 290 extern long
 291 read_number PARAMS ((char **, int));
 292
 293 extern void
 294 finish_block PARAMS ((struct symbol *, struct pending **,
 295                       struct pending_block *, CORE_ADDR, CORE_ADDR,
 296                       struct objfile *));
 297
 298 extern void
 299 add_undefined_type PARAMS ((struct type *));
 300
 301 extern void
 302 really_free_pendings PARAMS ((int foo));
 303
 304 extern void
 305 start_subfile PARAMS ((char *, char *));
 306
 307 extern void
 308 push_subfile PARAMS ((void));
 309
 310 extern char *
 311 pop_subfile PARAMS ((void));
 312
 313 extern struct symtab *
 314 end_symtab PARAMS ((CORE_ADDR, int, int,struct objfile *));
 315
 316 extern void
 317 scan_file_globals PARAMS ((struct objfile *));
 318
 319 extern void
 320 buildsym_new_init PARAMS ((void));
 321
 322 extern void
 323 buildsym_init PARAMS ((void));
 324
 325 extern struct context_stack *
 326 push_context PARAMS ((int, CORE_ADDR));
 327
 328 extern void
 329 record_line PARAMS ((struct subfile *, int, CORE_ADDR));
 330
 331 extern void
 332 start_symtab PARAMS ((char *, char *, CORE_ADDR));
 333
 334 extern struct symbol *
 335 define_symbol PARAMS ((unsigned int, char *, int, int, struct objfile *));
 336
 337 extern struct partial_symtab *
 338 start_psymtab PARAMS ((struct objfile *, CORE_ADDR, char *, CORE_ADDR, int,
 339                        struct partial_symbol *, struct partial_symbol *));
 340
 341 extern void
 342 end_psymtab PARAMS ((struct partial_symtab *, char **, int, int, CORE_ADDR,
 343                      struct partial_symtab **, int));
 344
 345 extern void
 346 process_one_symbol PARAMS ((int, int, CORE_ADDR, char *, int,
 347                             struct objfile *));
 348
 349 extern int
 350 hashname PARAMS ((char *));
 351
 352 #endif  /* defined (BUILDSYM_H) */