/* Include file for stabs debugging format support functions.
- Copyright 1986-1991, 1992 Free Software Foundation, Inc.
+ Copyright (C) 1986-2020 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/>. */
+
+#ifndef STABSREAD_H
+#define STABSREAD_H
+
+struct objfile;
+enum language;
/* Definitions, prototypes, etc for stabs debugging format support
- functions.
+ functions. */
+
+#define HASHSIZE 127 /* Size of things hashed via
+ hashname(). */
+
+/* Compute a small integer hash code for the given name. */
+
+extern int hashname (const char *name);
+
+/* Count symbols as they are processed, for error messages. */
+
+extern unsigned int symnum;
+
+#define next_symbol_text(objfile) (*next_symbol_text_func)(objfile)
+
+/* Function to invoke get the next symbol. Return the symbol name. */
+
+extern const char *(*next_symbol_text_func) (struct objfile *);
- 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. */
+/* Global variable which, when set, indicates that we are processing a
+ .o file compiled with gcc */
-#ifndef EXTERN
-#define EXTERN extern
-#endif
+extern unsigned char processing_gcc_compilation;
-/* Convert stab register number (from `r' declaration) to a gdb REGNUM. */
+/* Nonzero if within a function (so symbols should be local, if
+ nothing says specifically). */
-#ifndef STAB_REG_TO_REGNUM
-#define STAB_REG_TO_REGNUM(VALUE) (VALUE)
-#endif
+extern int within_function;
/* 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 struct symbol *global_sym_chain[HASHSIZE];
+
+extern void common_block_start (const char *, struct objfile *);
+extern void common_block_end (struct objfile *);
/* Kludge for xcoffread.c */
struct pending_stabs
-{
- 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. */
+ {
+ int count;
+ int length;
+ char *stab[1];
+ };
-EXTERN struct pending *common_block;
-EXTERN int common_block_i;
+extern struct pending_stabs *global_stabs;
/* 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;
+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.
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
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. */
-EXTERN int *this_object_header_files;
+extern int *this_object_header_files;
+
+extern int n_this_object_header_files;
-EXTERN int n_this_object_header_files;
+extern int n_allocated_this_object_header_files;
-EXTERN int n_allocated_this_object_header_files;
+extern void cleanup_undefined_stabs_types (struct objfile *);
-extern struct complaint unknown_symtype_complaint;
+extern long read_number (char **, int);
-extern void
-read_type_number PARAMS ((char **, int *));
+extern struct symbol *define_symbol (CORE_ADDR, const char *, int, int,
+ struct objfile *);
-extern struct type *
-read_type PARAMS ((char **, struct objfile *));
+extern void stabsread_init (void);
-extern void
-cleanup_undefined_types PARAMS ((void));
+extern void stabsread_new_init (void);
+
+extern void start_stabs (void);
+
+extern void end_stabs (void);
+
+extern void finish_global_stabs (struct objfile *objfile);
+\f
+/* Functions exported by dbxread.c. These are not in stabsread.c because
+ they are only used by some stabs readers. */
-extern struct type **
-dbx_lookup_type PARAMS ((int [2]));
+extern struct partial_symtab *dbx_end_psymtab
+ (struct objfile *objfile, struct partial_symtab *pst,
+ const 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 long
-read_number PARAMS ((char **, int));
+extern void process_one_symbol (int, int, CORE_ADDR, const char *,
+ const section_offsets &,
+ struct objfile *, enum language);
-extern void
-add_undefined_type PARAMS ((struct type *));
+extern void elfstab_build_psymtabs (struct objfile *objfile,
+ asection *stabsect,
+ file_ptr stabstroffset,
+ unsigned int stabstrsize);
-extern struct symbol *
-define_symbol PARAMS ((unsigned int, char *, int, int, struct objfile *));
+extern void coffstab_build_psymtabs
+ (struct objfile *objfile,
+ CORE_ADDR textaddr, unsigned int textsize,
+ const std::vector<asection *> &stabs,
+ file_ptr stabstroffset, unsigned int stabstrsize);
-extern struct partial_symtab *
-start_psymtab PARAMS ((struct objfile *, struct section_offsets *, char *,
- CORE_ADDR, int, struct partial_symbol *,
- struct partial_symbol *));
+extern void stabsect_build_psymtabs (struct objfile *objfile, char *stab_name,
+ char *stabstr_name, char *text_name);
-extern void
-end_psymtab PARAMS ((struct partial_symtab *, char **, int, int, CORE_ADDR,
- struct partial_symtab **, int));
+extern int symbol_reference_defined (const char **);
-extern void
-process_one_symbol PARAMS ((int, int, CORE_ADDR, char *,
- struct section_offsets *, struct objfile *));
+extern void ref_add (int, struct symbol *, const char *, CORE_ADDR);
-extern void
-stabsread_init PARAMS ((void));
+extern struct symbol *ref_search (int);
-extern void
-stabsread_new_init PARAMS ((void));
+extern void free_header_files (void);
-extern void
-start_stabs PARAMS ((void));
+extern void init_header_files (void);
-extern void
-end_stabs PARAMS ((void));
+/* Scan through all of the global symbols defined in the object file,
+ assigning values to the debugging symbols that need to be assigned
+ to. Get these symbols from the minimal symbol table. */
-extern void
-finish_global_stabs PARAMS ((struct objfile *objfile));
+extern void scan_file_globals (struct objfile *objfile);
-#undef EXTERN
+#endif /* STABSREAD_H */