/* Include file for stabs debugging format support functions.
- Copyright 1986-1991, 1992, 1993 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., 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/>. */
+
+#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;
- 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. */
+#define next_symbol_text(objfile) (*next_symbol_text_func)(objfile)
-#ifndef EXTERN
-#define EXTERN extern
-#endif
+/* Function to invoke get the next symbol. Return the symbol name. */
-/* Convert stab register number (from `r' declaration) to a gdb REGNUM. */
+extern const char *(*next_symbol_text_func) (struct objfile *);
-#ifndef STAB_REG_TO_REGNUM
-#define STAB_REG_TO_REGNUM(VALUE) (VALUE)
-#endif
+/* Global variable which, when set, indicates that we are processing a
+ .o file compiled with gcc */
+
+extern unsigned char processing_gcc_compilation;
+
+/* Nonzero if within a function (so symbols should be local, if
+ nothing says specifically). */
+
+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
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 PARAMS ((char *, struct objfile *));
-extern void common_block_end PARAMS ((struct objfile *));
+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];
-};
+ {
+ int count;
+ int length;
+ char *stab[1];
+ };
-EXTERN struct pending_stabs *global_stabs;
+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 */
- /* Name of header file */
-
- char *name;
+ char *name;
- /* Numeric code distinguishing instances of one header file that produced
- different results when included. It comes from the N_BINCL or N_EXCL. */
+ /* Numeric code distinguishing instances of one header file that
+ produced different results when included. It comes from the
+ N_BINCL or N_EXCL. */
- int instance;
+ int instance;
- /* Pointer to vector of types */
+ /* Pointer to vector of types */
- struct type **vector;
+ struct type **vector;
- /* Allocated length (# elts) of that vector */
+ /* Allocated length (# elts) of that vector */
- int length;
+ int length;
-};
+ };
-/* The table of header_files of this OBJFILE. */
+/* The table of header_files of this OBJFILE. */
#define HEADER_FILES(OBJFILE) (DBX_SYMFILE_INFO (OBJFILE)->header_files)
-/* The actual length of 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. */
+/* The allocated lengh of HEADER_FILES. */
#define N_ALLOCATED_HEADER_FILES(OBJFILE) \
(DBX_SYMFILE_INFO (OBJFILE)->n_allocated_header_files)
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 struct complaint unknown_symtype_complaint;
-extern struct complaint unknown_symchar_complaint;
+extern void cleanup_undefined_stabs_types (struct objfile *);
-extern struct type *
-read_type PARAMS ((char **, struct objfile *));
+extern long read_number (char **, int);
-extern void
-cleanup_undefined_types PARAMS ((void));
+extern struct symbol *define_symbol (CORE_ADDR, const char *, int, int,
+ struct objfile *);
-extern struct type **
-dbx_lookup_type PARAMS ((int [2]));
+extern void stabsread_init (void);
-extern long
-read_number PARAMS ((char **, int));
+extern void stabsread_new_init (void);
-extern void
-add_undefined_type PARAMS ((struct type *));
+extern void start_stabs (void);
-extern struct symbol *
-define_symbol PARAMS ((CORE_ADDR, char *, int, int, struct objfile *));
+extern void end_stabs (void);
-extern void
-stabsread_init PARAMS ((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 void
-stabsread_new_init PARAMS ((void));
+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 void
-start_stabs PARAMS ((void));
+extern void process_one_symbol (int, int, CORE_ADDR, const char *,
+ const section_offsets &,
+ struct objfile *, enum language);
-extern void
-end_stabs PARAMS ((void));
+extern void elfstab_build_psymtabs (struct objfile *objfile,
+ asection *stabsect,
+ file_ptr stabstroffset,
+ unsigned int stabstrsize);
-extern void
-finish_global_stabs PARAMS ((struct objfile *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 int
-resolve_cfront_continuation PARAMS((struct objfile * objfile,
- struct symbol * sym, char * p));
-\f
-EXTERN int os9k_stabs;
-\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 stabsect_build_psymtabs (struct objfile *objfile, char *stab_name,
+ char *stabstr_name, char *text_name);
-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 *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
-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 int symbol_reference_defined (const char **);
-extern void coffstab_build_psymtabs
- PARAMS ((struct objfile *objfile,
- struct section_offsets *section_offsets,
- int mainline,
- CORE_ADDR textaddr, unsigned int textsize,
- struct stab_section_list *stabs,
- file_ptr stabstroffset,
- unsigned int stabstrsize));
-
-extern void stabsect_build_psymtabs
- PARAMS ((struct objfile *objfile,
- struct section_offsets *section_offsets,
- int mainline,
- char *stab_name,
- char *stabstr_name,
- char *text_name));
-
-extern void elfstab_offset_sections PARAMS ((struct objfile *,
- struct partial_symtab *));
-
-extern void process_later PARAMS ((struct symbol *, char *,
- int (*f) (struct objfile *, struct symbol *, char *)));
-
-#undef EXTERN
+extern void ref_add (int, struct symbol *, const char *, CORE_ADDR);
+
+extern struct symbol *ref_search (int);
+
+extern void free_header_files (void);
+
+extern void init_header_files (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 scan_file_globals (struct objfile *objfile);
+
+#endif /* STABSREAD_H */