/* Build symbol tables in GDB's internal format.
- Copyright 1986-1993, 1996-1999 Free Software Foundation, Inc.
+ Copyright (C) 1986-2018 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
+ the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
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., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA. */
+ along with this program. If not, see <http://www.gnu.org/licenses/>. */
#if !defined (BUILDSYM_H)
#define BUILDSYM_H 1
+struct objfile;
+struct symbol;
+struct addrmap;
+struct compunit_symtab;
+enum language;
+
/* This module provides definitions used for creating and adding to
the symbol table. These routines are called from various symbol-
file-reading routines.
normally extern, but which get defined in a single module using
this technique. */
+struct block;
+struct pending_block;
+
+struct dynamic_prop;
+
#ifndef EXTERN
#define EXTERN extern
#endif
-#define HASHSIZE 127 /* Size of things hashed via
- hashname() */
-
-/* Name of source file whose symbol data we are now processing. This
- comes from a symbol of type N_SO. */
-
-EXTERN char *last_source_file;
-
-/* Core address of start of text of current source file. This too
- comes from the N_SO symbol. */
-
-EXTERN CORE_ADDR last_source_start_addr;
-
/* The list of sub-source-files within the current individual
compilation. Each file gets its own symtab with its own linetable
and associated info, but they all share one blockvector. */
struct subfile
- {
- struct subfile *next;
- char *name;
- char *dirname;
- struct linetable *line_vector;
- int line_vector_length;
- enum language language;
- char *debugformat;
- };
-
-EXTERN struct subfile *subfiles;
-
-EXTERN struct subfile *current_subfile;
-
-/* Global variable which, when set, indicates that we are processing a
- .o file compiled with gcc */
-
-EXTERN unsigned char processing_gcc_compilation;
-
-/* When set, we are processing a .o file compiled by sun acc. This is
- misnamed; it refers to all stabs-in-elf implementations which use
- N_UNDF the way Sun does, including Solaris gcc. Hopefully all
- stabs-in-elf implementations ever invented will choose to be
- compatible. */
-
-EXTERN unsigned char processing_acc_compilation;
-
-/* elz: added this flag to know when a block is compiled with HP
- compilers (cc, aCC). This is necessary because of the macro
- COERCE_FLOAT_TO_DOUBLE defined in tm_hppa.h, which causes a
- coercion of float to double to always occur in parameter passing
- for a function called by gdb (see the function value_arg_coerce in
- valops.c). This is necessary only if the target was compiled with
- gcc, not with HP compilers or with g++ */
-
-EXTERN unsigned char processing_hp_compilation;
-
-/* Count symbols as they are processed, for error messages. */
-
-EXTERN unsigned int symnum;
+{
+ struct subfile *next;
+ /* Space for this is malloc'd. */
+ char *name;
+ /* Space for this is malloc'd. */
+ struct linetable *line_vector;
+ int line_vector_length;
+ /* The "containing" compunit. */
+ struct buildsym_compunit *buildsym_compunit;
+ enum language language;
+ struct symtab *symtab;
+};
/* Record the symbols defined for each context in a list. We don't
create a struct block for the context until we know how long to
EXTERN struct pending *local_symbols;
-/* func params local to lexical context */
-
-EXTERN struct pending *param_symbols;
-
/* Stack representing unclosed lexical contexts (that will become
blocks, eventually). */
struct pending *locals;
- /* Pending func params at the time we entered */
+ /* Pending using directives at the time we entered. */
- struct pending *params;
+ struct using_direct *local_using_directives;
/* Pointer into blocklist as of entry */
struct symbol *name;
+ /* Expression that computes the frame base of the lexically enclosing
+ function, if any. NULL otherwise. */
+
+ struct dynamic_prop *static_link;
+
/* PC where this context starts */
CORE_ADDR start_addr;
- /* Temp slot for exception handling. */
+ /* Temp slot for exception handling. */
CORE_ADDR end_addr;
};
-EXTERN struct context_stack *context_stack;
+/* The type of the record_line function. */
+typedef void (record_line_ftype) (struct subfile *subfile, int line,
+ CORE_ADDR pc);
-/* Index of first unused entry in context stack. */
+\f
-EXTERN int context_stack_depth;
+extern void add_symbol_to_list (struct symbol *symbol,
+ struct pending **listhead);
-/* Currently allocated size of context stack. */
+extern struct symbol *find_symbol_in_list (struct pending *list,
+ char *name, int length);
-EXTERN int context_stack_size;
+extern struct block *finish_block (struct symbol *symbol,
+ struct pending **listhead,
+ struct pending_block *old_blocks,
+ const struct dynamic_prop *static_link,
+ CORE_ADDR start,
+ CORE_ADDR end);
-/* Macro "function" for popping contexts from the stack. Pushing is
- done by a real function, push_context. This returns a pointer to a
- struct context_stack. */
+extern void record_block_range (struct block *,
+ CORE_ADDR start, CORE_ADDR end_inclusive);
-#define pop_context() (&context_stack[--context_stack_depth]);
+class scoped_free_pendings
+{
+public:
-/* Nonzero if within a function (so symbols should be local, if
- nothing says specifically). */
+ scoped_free_pendings ();
+ ~scoped_free_pendings ();
-EXTERN int within_function;
+ DISABLE_COPY_AND_ASSIGN (scoped_free_pendings);
+};
-/* List of blocks already made (lexical contexts already closed).
- This is used at the end to make the blockvector. */
+extern void start_subfile (const char *name);
-struct pending_block
- {
- struct pending_block *next;
- struct block *block;
- };
+extern void patch_subfile_names (struct subfile *subfile, const char *name);
-/* Pointer to the head of a linked list of symbol blocks which have
- already been finalized (lexical contexts already closed) and which
- are just waiting to be built into a blockvector when finalizing the
- associated symtab. */
+extern void push_subfile ();
-EXTERN struct pending_block *pending_blocks;
-\f
+extern const char *pop_subfile ();
-struct subfile_stack
- {
- struct subfile_stack *next;
- char *name;
- };
+extern struct block *end_symtab_get_static_block (CORE_ADDR end_addr,
+ int expandable,
+ int required);
-EXTERN struct subfile_stack *subfile_stack;
+extern struct compunit_symtab *
+ end_symtab_from_static_block (struct block *static_block,
+ int section, int expandable);
-#define next_symbol_text(objfile) (*next_symbol_text_func)(objfile)
+extern struct compunit_symtab *end_symtab (CORE_ADDR end_addr, int section);
-/* Function to invoke get the next symbol. Return the symbol name. */
+extern struct compunit_symtab *end_expandable_symtab (CORE_ADDR end_addr,
+ int section);
-EXTERN char *(*next_symbol_text_func) (struct objfile *);
+extern void augment_type_symtab (void);
-/* Vector of types defined so far, indexed by their type numbers.
- Used for both stabs and coff. (In newer sun systems, dbx uses a
- pair of numbers in parens, as in "(SUBFILENUM,NUMWITHINSUBFILE)".
- Then these numbers must be translated through the type_translations
- hash table to get the index into the type vector.) */
+extern void buildsym_init ();
-EXTERN struct type **type_vector;
+extern struct context_stack *push_context (int desc, CORE_ADDR valu);
-/* Number of elements allocated for type_vector currently. */
+extern struct context_stack pop_context ();
-EXTERN int type_vector_length;
+extern record_line_ftype record_line;
-/* Initial size of type vector. Is realloc'd larger if needed, and
- realloc'd down to the size actually used, when completed. */
+extern struct compunit_symtab *start_symtab (struct objfile *objfile,
+ const char *name,
+ const char *comp_dir,
+ CORE_ADDR start_addr,
+ enum language language);
-#define INITIAL_TYPE_VECTOR_LENGTH 160
+extern void restart_symtab (struct compunit_symtab *cust,
+ const char *name, CORE_ADDR start_addr);
-extern void add_free_pendings (struct pending *list);
+/* Record the name of the debug format in the current pending symbol
+ table. FORMAT must be a string with a lifetime at least as long as
+ the symtab's objfile. */
-extern void add_symbol_to_list (struct symbol *symbol,
- struct pending **listhead);
+extern void record_debugformat (const char *format);
-extern struct symbol *find_symbol_in_list (struct pending *list,
- char *name, int length);
+/* Record the name of the debuginfo producer (usually the compiler) in
+ the current pending symbol table. PRODUCER must be a string with a
+ lifetime at least as long as the symtab's objfile. */
-extern void finish_block (struct symbol *symbol,
- struct pending **listhead,
- struct pending_block *old_blocks,
- CORE_ADDR start, CORE_ADDR end,
- struct objfile *objfile);
+extern void record_producer (const char *producer);
-extern void really_free_pendings (PTR dummy);
+/* Set the name of the last source file. NAME is copied by this
+ function. */
-extern void start_subfile (char *name, char *dirname);
+extern void set_last_source_file (const char *name);
-extern void patch_subfile_names (struct subfile *subfile, char *name);
+/* Fetch the name of the last source file. */
-extern void push_subfile (void);
+extern const char *get_last_source_file (void);
-extern char *pop_subfile (void);
+/* Return the compunit symtab object.
+ It is only valid to call this between calls to start_symtab and the
+ end_symtab* functions. */
-extern struct symtab *end_symtab (CORE_ADDR end_addr,
- struct objfile *objfile, int section);
+extern struct compunit_symtab *buildsym_compunit_symtab (void);
-/* Defined in stabsread.c. */
+/* Return the macro table.
+ Initialize it if this is the first use.
+ It is only valid to call this between calls to start_symtab and the
+ end_symtab* functions. */
-extern void scan_file_globals (struct objfile *objfile);
+extern struct macro_table *get_macro_table (void);
-extern void buildsym_new_init (void);
+/* Set the last source start address. Can only be used between
+ start_symtab and end_symtab* calls. */
-extern void buildsym_init (void);
+extern void set_last_source_start_addr (CORE_ADDR addr);
-extern struct context_stack *push_context (int desc, CORE_ADDR valu);
+/* Get the last source start address. Can only be used between
+ start_symtab and end_symtab* calls. */
+
+extern CORE_ADDR get_last_source_start_addr ();
+
+/* Return the local using directives. */
+
+extern struct using_direct **get_local_using_directives ();
+
+/* Set the list of local using directives. */
+
+extern void set_local_using_directives (struct using_direct *new_local);
-extern void record_line (struct subfile *subfile, int line, CORE_ADDR pc);
+/* Return the global using directives. */
-extern void start_symtab (char *name, char *dirname, CORE_ADDR start_addr);
+extern struct using_direct **get_global_using_directives ();
-extern int hashname (char *name);
+/* True if the context stack is empty. */
-extern void free_pending_blocks (void);
+extern bool outermost_context_p ();
-/* FIXME: Note that this is used only in buildsym.c and dstread.c,
- which should be fixed to not need direct access to
- make_blockvector. */
+/* Return the top of the context stack, or nullptr if there is an
+ entry. */
-extern struct blockvector *make_blockvector (struct objfile *objfile);
+extern struct context_stack *get_current_context_stack ();
-/* FIXME: Note that this is used only in buildsym.c and dstread.c,
- which should be fixed to not need direct access to
- record_pending_block. */
+/* Return the context stack depth. */
-extern void record_pending_block (struct objfile *objfile,
- struct block *block,
- struct pending_block *opblock);
+extern int get_context_stack_depth ();
-extern void record_debugformat (char *format);
+/* Return the current subfile. */
-extern void merge_symbol_lists (struct pending **srclist,
- struct pending **targetlist);
+extern struct subfile *get_current_subfile ();
#undef EXTERN
projects / deliverable / binutils-gdb.git / blobdiff