binutils/
[external/binutils.git] / gdb / stabsread.h
index 8d18ac8..92523a9 100644 (file)
@@ -1,21 +1,24 @@
 /* Include file for stabs debugging format support functions.
-   Copyright 1986-1991, 1992, 1993 Free Software Foundation, Inc.
+   Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
+   1996, 1997, 1999, 2000, 2001, 2002, 2003, 2007, 2008, 2009, 2010, 2011
+   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., 675 Mass Ave, Cambridge, MA 02139, 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/>.  */
+
+struct objfile;
 
 /* Definitions, prototypes, etc for stabs debugging format support
    functions.
@@ -29,47 +32,36 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
 #define        EXTERN extern
 #endif
 
-/* Convert stab register number (from `r' declaration) to a gdb REGNUM.  */
-
-#ifndef STAB_REG_TO_REGNUM
-#define STAB_REG_TO_REGNUM(VALUE) (VALUE)
-#endif
-
 /* Hash table of global symbols whose values are not known yet.
    They are chained thru the SYMBOL_VALUE_CHAIN, since we don't
    have the correct data for that slot yet.
 
    The use of the LOC_BLOCK code in this chain is nonstandard--
-   it refers to a FORTRAN common block rather than the usual meaning.  */
+   it refers to a FORTRAN common block rather than the usual meaning, and
+   the such LOC_BLOCK symbols use their fields in nonstandard ways.  */
 
 EXTERN struct symbol *global_sym_chain[HASHSIZE];
 
+extern void common_block_start (char *, struct objfile *);
+extern void common_block_end (struct objfile *);
+
 /* Kludge for xcoffread.c */
 
 struct pending_stabs
-{
-  int count;
-  int length;
-  char *stab[1];
-};
+  {
+    int count;
+    int length;
+    char *stab[1];
+  };
 
 EXTERN struct pending_stabs *global_stabs;
 
-/* List of symbols declared since the last BCOMM.  This list is a tail
-   of local_symbols.  When ECOMM is seen, the symbols on the list
-   are noted so their proper addresses can be filled in later,
-   using the common block base address gotten from the assembler
-   stabs.  */
-
-EXTERN struct pending *common_block;
-EXTERN int common_block_i;
-
 /* The type code that process_one_symbol saw on its previous invocation.
-   Used to detect pairs of N_SO symbols. */
+   Used to detect pairs of N_SO symbols.  */
 
 EXTERN int previous_stab_code;
 \f
-/* Support for Sun changes to dbx symbol format */
+/* Support for Sun changes to dbx symbol format */
 
 /* For each identified header file, we have a table of types defined
    in that header file.
@@ -90,32 +82,37 @@ EXTERN int previous_stab_code;
    used to match header-file references to their corresponding data.  */
 
 struct header_file
-{
+  {
 
-  /* Name of header file */
-  
-  char *name;
+    /* Name of header file */
 
-  /* Numeric code distinguishing instances of one header file that produced
-     different results when included.  It comes from the N_BINCL or N_EXCL. */
+    char *name;
 
-  int instance;
+    /* Numeric code distinguishing instances of one header file that
+       produced different results when included.  It comes from the
+       N_BINCL or N_EXCL.  */
 
-  /* Pointer to vector of types */
+    int instance;
 
-  struct type **vector;
+    /* Pointer to vector of types */
 
-  /* Allocated length (# elts) of that vector */
+    struct type **vector;
 
-  int length;
+    /* Allocated length (# elts) of that vector */
 
-};
+    int length;
 
-EXTERN struct header_file *header_files;
+  };
 
-EXTERN int n_header_files;
+/* The table of header_files of this OBJFILE.  */
+#define HEADER_FILES(OBJFILE) (DBX_SYMFILE_INFO (OBJFILE)->header_files)
 
-EXTERN int n_allocated_header_files;
+/* The actual length of HEADER_FILES.  */
+#define N_HEADER_FILES(OBJFILE) (DBX_SYMFILE_INFO (OBJFILE)->n_header_files)
+
+/* The allocated lengh of HEADER_FILES.  */
+#define N_ALLOCATED_HEADER_FILES(OBJFILE) \
+  (DBX_SYMFILE_INFO (OBJFILE)->n_allocated_header_files)
 
 /* Within each object file, various header files are assigned numbers.
    A type is defined or referred to with a pair of numbers
@@ -123,7 +120,7 @@ EXTERN int n_allocated_header_files;
    and TYPENUM is the number within that header file.
    TYPENUM is the index within the vector of types for that header file.
 
-   FILENUM == 1 is special; it refers to the main source of the object file,
+   FILENUM == 0 is special; it refers to the main source of the object file,
    and not to any header file.  FILENUM != 1 is interpreted by looking it up
    in the following table, which contains indices in header_files.  */
 
@@ -133,68 +130,75 @@ EXTERN int n_this_object_header_files;
 
 EXTERN int n_allocated_this_object_header_files;
 
-extern struct complaint unknown_symtype_complaint;
-extern struct complaint unknown_symchar_complaint;
+extern void cleanup_undefined_types (struct objfile *);
+
+extern long read_number (char **, int);
 
-extern struct type *
-read_type PARAMS ((char **, struct objfile *));
+extern struct symbol *define_symbol (CORE_ADDR, char *, int, int,
+                                    struct objfile *);
 
-extern void
-cleanup_undefined_types PARAMS ((void));
+extern void stabsread_init (void);
 
-extern struct type **
-dbx_lookup_type PARAMS ((int [2]));
+extern void stabsread_new_init (void);
 
-extern long
-read_number PARAMS ((char **, int));
+extern void start_stabs (void);
 
-extern void
-add_undefined_type PARAMS ((struct type *));
+extern void end_stabs (void);
 
-extern struct symbol *
-define_symbol PARAMS ((unsigned int, char *, int, int, struct objfile *));
+extern void finish_global_stabs (struct objfile *objfile);
+\f
+/* COFF files can have multiple .stab sections, if they are linked
+   using --split-by-reloc.  This linked list is used to pass the
+   information into the functions in dbxread.c.  */
+struct stab_section_list
+  {
+    /* Next in list.  */
+    struct stab_section_list *next;
+
+    /* Stab section.  */
+    asection *section;
+  };
+\f
+/* Functions exported by dbxread.c.  These are not in stabsread.c because
+   they are only used by some stabs readers.  */
 
-extern void
-stabsread_init PARAMS ((void));
+extern struct partial_symtab *end_psymtab (struct partial_symtab *pst,
+                                          char **include_list,
+                                          int num_includes,
+                                          int capping_symbol_offset,
+                                          CORE_ADDR capping_text,
+                                          struct partial_symtab
+                                          **dependency_list,
+                                          int number_dependencies,
+                                          int textlow_not_set);
 
-extern void
-stabsread_new_init PARAMS ((void));
+extern void process_one_symbol (int, int, CORE_ADDR, char *,
+                               struct section_offsets *, struct objfile *);
 
-extern void
-start_stabs PARAMS ((void));
+extern void elfstab_build_psymtabs (struct objfile *objfile,
+                                   asection *stabsect,
+                                   file_ptr stabstroffset,
+                                   unsigned int stabstrsize);
 
-extern void
-end_stabs PARAMS ((void));
+extern void coffstab_build_psymtabs
+  (struct objfile *objfile,
+   CORE_ADDR textaddr, unsigned int textsize,
+   struct stab_section_list *stabs,
+   file_ptr stabstroffset, unsigned int stabstrsize);
 
-extern void
-finish_global_stabs PARAMS ((struct objfile *objfile));
-\f
-/* Functions exported by dbxread.c.  These are not in stabsread.h because
-   they are only used by some stabs readers.  */
+extern void stabsect_build_psymtabs (struct objfile *objfile, char *stab_name,
+                                    char *stabstr_name, char *text_name);
+
+extern void elfstab_offset_sections (struct objfile *,
+                                    struct partial_symtab *);
+extern int symbol_reference_defined (char **);
+
+extern void ref_add (int, struct symbol *, char *, CORE_ADDR);
+
+extern struct symbol *ref_search (int);
+
+extern void free_header_files (void);
 
-extern struct partial_symtab *
-start_psymtab PARAMS ((struct objfile *, struct section_offsets *, char *,
-                      CORE_ADDR, int, struct partial_symbol *,
-                      struct partial_symbol *));
-
-extern struct partial_symtab *
-end_psymtab PARAMS ((struct partial_symtab *, char **, int, int, CORE_ADDR,
-                    struct partial_symtab **, int));
-
-extern void
-process_one_symbol PARAMS ((int, int, CORE_ADDR, char *,
-                           struct section_offsets *, struct objfile *));
-
-extern void
-elfstab_build_psymtabs PARAMS ((struct objfile *objfile,
-                               struct section_offsets *section_offsets,
-                               int mainline,
-                               file_ptr staboff, unsigned int stabsize,
-                               file_ptr stabstroffset,
-                               unsigned int stabstrsize));
-
-extern void
-pastab_build_psymtabs PARAMS ((struct objfile *, struct section_offsets *,
-                              int));
+extern void init_header_files (void);
 
 #undef EXTERN