]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blobdiff - gdb/buildsym.h
Switch the license of all .c files to GPLv3.
[thirdparty/binutils-gdb.git] / gdb / buildsym.h
index feb22a17d0417ad64dab5d363628b60269422dc4..cb16be19c3071416a349df76bb6418518768cd4a 100644 (file)
@@ -1,67 +1,75 @@
 /* Build symbol tables in GDB's internal format.
-   Copyright (C) 1986-1996 Free Software Foundation, Inc.
+   Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1995, 1996,
+   1997, 1998, 1999, 2000, 2002, 2003, 2007 Free Software Foundation, Inc.
 
-This file is part of GDB.
+   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 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 3 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.
+   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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
+   You should have received a copy of the GNU General Public License
+   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
 
 #if !defined (BUILDSYM_H)
 #define BUILDSYM_H 1
 
+struct objfile;
+struct symbol;
+
 /* This module provides definitions used for creating and adding to
    the symbol table.  These routines are called from various symbol-
-   file-reading routines.  
+   file-reading routines.
 
    They originated in dbxread.c of gdb-4.2, and were split out to
    make xcoffread.c more maintainable by sharing code.
 
-   Variables declared in this file can be defined by #define-ing
-   the name EXTERN to null.  It is used to declare variables that
-   are normally extern, but which get defined in a single module
-   using this technique.  */
+   Variables declared in this file can be defined by #define-ing the
+   name EXTERN to null.  It is used to declare variables that are
+   normally extern, but which get defined in a single module using
+   this technique.  */
+
+struct block;
 
 #ifndef EXTERN
 #define        EXTERN extern
 #endif
 
-#define HASHSIZE 127   /* Size of things hashed via hashname() */
+#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. */
+/* 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. */
+/* 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.  */
+/* 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;
-};
+  {
+    struct subfile *next;
+    char *name;
+    char *dirname;
+    struct linetable *line_vector;
+    int line_vector_length;
+    enum language language;
+    char *producer;
+    char *debugformat;
+    struct symtab *symtab;
+  };
 
 EXTERN struct subfile *subfiles;
 
@@ -80,77 +88,75 @@ EXTERN unsigned char processing_gcc_compilation;
 
 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;
 
-/* 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 make it.  */
+/* 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
+   make it.  */
 
 #define PENDINGSIZE 100
 
 struct pending
-{
-  struct pending *next;
-  int nsyms;
-  struct symbol *symbol[PENDINGSIZE];
-};
+  {
+    struct pending *next;
+    int nsyms;
+    struct symbol *symbol[PENDINGSIZE];
+  };
 
 /* Here are the three lists that symbols are put on.  */
 
-EXTERN struct pending *file_symbols;   /* static at top level, and types */
+/* static at top level, and types */
+
+EXTERN struct pending *file_symbols;
+
+/* global functions and variables */
+
+EXTERN struct pending *global_symbols;
+
+/* everything local to lexical context */
 
-EXTERN struct pending *global_symbols; /* global functions and variables */
+EXTERN struct pending *local_symbols;
 
-EXTERN struct pending *local_symbols;  /* everything local to lexic context */
+/* func params local to lexical  context */
 
-EXTERN struct pending *param_symbols;  /* func params local to lexic context */
+EXTERN struct pending *param_symbols;
 
-/* Stack representing unclosed lexical contexts
-   (that will become blocks, eventually).  */
+/* Stack representing unclosed lexical contexts (that will become
+   blocks, eventually).  */
 
 struct context_stack
-{
-  /* Outer locals at the time we entered */
+  {
+    /* Outer locals at the time we entered */
 
-  struct pending *locals;
+    struct pending *locals;
 
-  /* Pending func params at the time we entered */
+    /* Pending func params at the time we entered */
 
-  struct pending *params;
+    struct pending *params;
 
-  /* Pointer into blocklist as of entry */
+    /* Pointer into blocklist as of entry */
 
-  struct pending_block *old_blocks;
+    struct pending_block *old_blocks;
 
-  /* Name of function, if any, defining context*/
+    /* Name of function, if any, defining context */
 
-  struct symbol *name;
+    struct symbol *name;
 
-  /* PC where this context starts */
+    /* PC where this context starts */
 
-  CORE_ADDR start_addr;
+    CORE_ADDR start_addr;
 
-  /* Temp slot for exception handling. */
+    /* Temp slot for exception handling. */
 
-  CORE_ADDR end_addr;
+    CORE_ADDR end_addr;
 
-  /* For error-checking matching push/pop */
+    /* For error-checking matching push/pop */
 
-  int depth;
+    int depth;
 
-};
+  };
 
 EXTERN struct context_stack *context_stack;
 
@@ -162,14 +168,11 @@ EXTERN int context_stack_depth;
 
 EXTERN int context_stack_size;
 
-/* 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.  */
+/* Non-zero if the context stack is empty.  */
+#define outermost_context_p() (context_stack_depth == 0)
 
-#define        pop_context() (&context_stack[--context_stack_depth]);
-
-/* Nonzero if within a function (so symbols should be local,
-   if nothing says specifically).  */
+/* Nonzero if within a function (so symbols should be local, if
+   nothing says specifically).  */
 
 EXTERN int within_function;
 
@@ -177,24 +180,24 @@ EXTERN int within_function;
    This is used at the end to make the blockvector.  */
 
 struct pending_block
-{
-  struct pending_block *next;
-  struct block *block;
-};
+  {
+    struct pending_block *next;
+    struct block *block;
+  };
 
 /* 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
+   already been finalized (lexical contexts already closed) and which
+   are just waiting to be built into a blockvector when finalizing the
    associated symtab. */
 
 EXTERN struct pending_block *pending_blocks;
-
 \f
+
 struct subfile_stack
-{
-  struct subfile_stack *next;
-  char *name;
-};
+  {
+    struct subfile_stack *next;
+    char *name;
+  };
 
 EXTERN struct subfile_stack *subfile_stack;
 
@@ -202,14 +205,13 @@ EXTERN struct subfile_stack *subfile_stack;
 
 /* Function to invoke get the next symbol.  Return the symbol name. */
 
-EXTERN char *(*next_symbol_text_func) PARAMS ((struct objfile *));
+EXTERN char *(*next_symbol_text_func) (struct objfile *);
 
 /* 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.)  */
+   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 struct type **type_vector;
 
@@ -217,83 +219,77 @@ EXTERN struct type **type_vector;
 
 EXTERN int type_vector_length;
 
-/* Initial size of type vector.  Is realloc'd larger if needed,
-   and realloc'd down to the size actually used, when completed.  */
+/* Initial size of type vector.  Is realloc'd larger if needed, and
+   realloc'd down to the size actually used, when completed.  */
 
 #define        INITIAL_TYPE_VECTOR_LENGTH      160
 
-extern void
-add_symbol_to_list PARAMS ((struct symbol *, struct pending **));
+extern void add_free_pendings (struct pending *list);
 
-extern struct symbol *
-find_symbol_in_list PARAMS ((struct pending *, char *, int));
+extern void add_symbol_to_list (struct symbol *symbol,
+                               struct pending **listhead);
 
-extern void
-finish_block PARAMS ((struct symbol *, struct pending **,
-                     struct pending_block *, CORE_ADDR, CORE_ADDR,
-                     struct objfile *));
+extern struct symbol *find_symbol_in_list (struct pending *list,
+                                          char *name, int length);
 
-extern void
-really_free_pendings PARAMS ((int foo));
+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
-start_subfile PARAMS ((char *, char *));
+extern void really_free_pendings (void *dummy);
 
-extern void
-patch_subfile_names PARAMS ((struct subfile *subfile, char *name));
+extern void start_subfile (char *name, char *dirname);
 
-extern void
-push_subfile PARAMS ((void));
+extern void patch_subfile_names (struct subfile *subfile, char *name);
 
-extern char *
-pop_subfile PARAMS ((void));
+extern void push_subfile (void);
 
-extern struct symtab *
-end_symtab PARAMS ((CORE_ADDR, struct objfile *, int));
+extern char *pop_subfile (void);
 
-extern void
-scan_file_globals PARAMS ((struct objfile *));
+extern struct symtab *end_symtab (CORE_ADDR end_addr,
+                                 struct objfile *objfile, int section);
 
-extern void
-buildsym_new_init PARAMS ((void));
+/* Defined in stabsread.c.  */
 
-extern void
-buildsym_init PARAMS ((void));
+extern void scan_file_globals (struct objfile *objfile);
 
-extern struct context_stack *
-push_context PARAMS ((int, CORE_ADDR));
+extern void buildsym_new_init (void);
 
-extern void
-record_line PARAMS ((struct subfile *, int, CORE_ADDR));
+extern void buildsym_init (void);
 
-extern void
-start_symtab PARAMS ((char *, char *, CORE_ADDR));
+extern struct context_stack *push_context (int desc, CORE_ADDR valu);
 
-extern int
-hashname PARAMS ((char *));
+extern struct context_stack *pop_context (void);
 
-extern void
-free_pending_blocks PARAMS ((void));
+extern void record_line (struct subfile *subfile, int line, CORE_ADDR pc);
 
-/* 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. */
+extern void start_symtab (char *name, char *dirname, CORE_ADDR start_addr);
 
-extern struct blockvector *
-make_blockvector PARAMS ((struct objfile *));
+extern int hashname (char *name);
+
+extern void free_pending_blocks (void);
 
 /* 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. */
+   which should be fixed to not need direct access to
+   record_pending_block. */
+
+extern void record_pending_block (struct objfile *objfile,
+                                 struct block *block,
+                                 struct pending_block *opblock);
+
+extern void record_debugformat (char *format);
 
-extern void
-record_pending_block PARAMS ((struct objfile *, struct block *,
-                             struct pending_block *));
+extern void record_producer (const char *producer);
 
-extern void
-record_debugformat PARAMS ((char *));
+extern void merge_symbol_lists (struct pending **srclist,
+                               struct pending **targetlist);
 
-extern void
-merge_symbol_lists PARAMS ((struct pending **, struct pending **));
+/* The macro table for the compilation unit whose symbols we're
+   currently reading.  All the symtabs for this CU will point to this.  */
+EXTERN struct macro_table *pending_macros;
 
 #undef EXTERN
 
-#endif /* defined (BUILDSYM_H) */
+#endif /* defined (BUILDSYM_H) */