]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blobdiff - gdb/symtab.h
import gdb-1999-09-08 snapshot
[thirdparty/binutils-gdb.git] / gdb / symtab.h
index 76e359c127def97e37a0f308738c4518231e4104..0d9903b2aef038e3035a3a1ffa6a0bd2d758f431 100644 (file)
@@ -1,21 +1,23 @@
 /* Symbol table definitions for GDB.
-   Copyright (C) 1986, 1989, 1991, 1992 Free Software Foundation, Inc.
+   Copyright 1986, 89, 91, 92, 93, 94, 95, 96, 1998
+   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 2 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, write to the Free Software
+   Foundation, Inc., 59 Temple Place - Suite 330,
+   Boston, MA 02111-1307, USA.  */
 
 #if !defined (SYMTAB_H)
 #define SYMTAB_H 1
@@ -25,94 +27,123 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
 #include "obstack.h"
 #define obstack_chunk_alloc xmalloc
 #define obstack_chunk_free free
+#include "bcache.h"
+
+/* Don't do this; it means that if some .o's are compiled with GNU C
+   and some are not (easy to do accidentally the way we configure
+   things; also it is a pain to have to "make clean" every time you
+   want to switch compilers), then GDB dies a horrible death.  */
+/* GNU C supports enums that are bitfields.  Some compilers don't. */
+#if 0 && defined(__GNUC__) && !defined(BYTE_BITFIELD)
+#define        BYTE_BITFIELD   :8;
+#else
+#define        BYTE_BITFIELD           /*nothing */
+#endif
 
 /* Define a structure for the information that is common to all symbol types,
    including minimal symbols, partial symbols, and full symbols.  In a
    multilanguage environment, some language specific information may need to
-   be recorded along with each symbol. */
-
-struct general_symbol_info
-{
-  /* Name of the symbol.  This is a required field.  Storage for the name is
-     allocated on the psymbol_obstack or symbol_obstack for the associated
-     objfile. */
+   be recorded along with each symbol.
 
-  char *name;
+   These fields are ordered to encourage good packing, since we frequently
+   have tens or hundreds of thousands of these.  */
 
-  /* Value of the symbol.  Which member of this union to use, and what
-     it means, depends on what kind of symbol this is and its
-     SYMBOL_CLASS.  See comments there for more details.  All of these
-     are in host byte order (though what they point to might be in
-     target byte order, e.g. LOC_CONST_BYTES).  */
-
-  union
-    {
-      long value;
+struct general_symbol_info
+  {
+    /* Name of the symbol.  This is a required field.  Storage for the name is
+       allocated on the psymbol_obstack or symbol_obstack for the associated
+       objfile. */
 
-      struct block *block;
+    char *name;
 
-      char *bytes;
+    /* Value of the symbol.  Which member of this union to use, and what
+       it means, depends on what kind of symbol this is and its
+       SYMBOL_CLASS.  See comments there for more details.  All of these
+       are in host byte order (though what they point to might be in
+       target byte order, e.g. LOC_CONST_BYTES).  */
 
-      CORE_ADDR address;
+    union
+      {
+       /* The fact that this is a long not a LONGEST mainly limits the
+          range of a LOC_CONST.  Since LOC_CONST_BYTES exists, I'm not
+          sure that is a big deal.  */
+       long ivalue;
 
-      /* for opaque typedef struct chain */
+       struct block *block;
 
-      struct symbol *chain;
-    }
-  value;
+       char *bytes;
 
-  /* Record the source code language that applies to this symbol.
-     This is used to select one of the fields from the language specific
-     union below. */
+       CORE_ADDR address;
 
-  enum language language;
+       /* for opaque typedef struct chain */
 
-  /* Since one and only one language can apply, wrap the language specific
-     information inside a union. */
+       struct symbol *chain;
+      }
+    value;
 
-  union
-    {
-      struct cplus_specific      /* For C++ */
-       {
-         char *demangled_name;
-       } cplus_specific;
-      struct chill_specific      /* For Chill */
-       {
-         char *demangled_name;
-       } chill_specific;
-    } language_specific;
+    /* Since one and only one language can apply, wrap the language specific
+       information inside a union. */
 
-  /* Which section is this symbol in?  This is an index into
-     section_offsets for this objfile.  Negative means that the symbol
-     does not get relocated relative to a section.
-     Disclaimer: currently this is just used for xcoff, so don't expect
-     all symbol-reading code to set it correctly.  */
+    union
+      {
+       struct cplus_specific   /* For C++ */
+       /*  and Java */
+         {
+           char *demangled_name;
+         }
+       cplus_specific;
+       struct chill_specific   /* For Chill */
+         {
+           char *demangled_name;
+         }
+       chill_specific;
+      }
+    language_specific;
+
+    /* Record the source code language that applies to this symbol.
+       This is used to select one of the fields from the language specific
+       union above. */
+
+    enum language language BYTE_BITFIELD;
+
+    /* Which section is this symbol in?  This is an index into
+       section_offsets for this objfile.  Negative means that the symbol
+       does not get relocated relative to a section.
+       Disclaimer: currently this is just used for xcoff, so don't
+       expect all symbol-reading code to set it correctly (the ELF code
+       also tries to set it correctly).  */
+
+    short section;
+
+    /* The bfd section associated with this symbol. */
+
+    asection *bfd_section;
+  };
 
-  int section;
-};
+extern CORE_ADDR symbol_overlayed_address PARAMS ((CORE_ADDR, asection *));
 
 #define SYMBOL_NAME(symbol)            (symbol)->ginfo.name
-#define SYMBOL_VALUE(symbol)           (symbol)->ginfo.value.value
+#define SYMBOL_VALUE(symbol)           (symbol)->ginfo.value.ivalue
 #define SYMBOL_VALUE_ADDRESS(symbol)   (symbol)->ginfo.value.address
 #define SYMBOL_VALUE_BYTES(symbol)     (symbol)->ginfo.value.bytes
 #define SYMBOL_BLOCK_VALUE(symbol)     (symbol)->ginfo.value.block
 #define SYMBOL_VALUE_CHAIN(symbol)     (symbol)->ginfo.value.chain
 #define SYMBOL_LANGUAGE(symbol)                (symbol)->ginfo.language
 #define SYMBOL_SECTION(symbol)         (symbol)->ginfo.section
+#define SYMBOL_BFD_SECTION(symbol)     (symbol)->ginfo.bfd_section
 
 #define SYMBOL_CPLUS_DEMANGLED_NAME(symbol)    \
   (symbol)->ginfo.language_specific.cplus_specific.demangled_name
 
-
-extern int demangle;   /* We reference it, so go ahead and declare it. */
-
 /* Macro that initializes the language dependent portion of a symbol
    depending upon the language for the symbol. */
 
 #define SYMBOL_INIT_LANGUAGE_SPECIFIC(symbol,language)                 \
   do {                                                                 \
     SYMBOL_LANGUAGE (symbol) = language;                               \
-    if (SYMBOL_LANGUAGE (symbol) == language_cplus)                    \
+    if (SYMBOL_LANGUAGE (symbol) == language_cplus                     \
+       || SYMBOL_LANGUAGE (symbol) == language_java                    \
+       )                                                               \
       {                                                                        \
        SYMBOL_CPLUS_DEMANGLED_NAME (symbol) = NULL;                    \
       }                                                                        \
@@ -156,6 +187,23 @@ extern int demangle;       /* We reference it, so go ahead and declare it. */
            SYMBOL_CPLUS_DEMANGLED_NAME (symbol) = NULL;                \
          }                                                             \
       }                                                                        \
+    if (SYMBOL_LANGUAGE (symbol) == language_java)                     \
+      {                                                                        \
+       demangled =                                                     \
+         cplus_demangle (SYMBOL_NAME (symbol),                         \
+                         DMGL_PARAMS | DMGL_ANSI | DMGL_JAVA);         \
+       if (demangled != NULL)                                          \
+         {                                                             \
+           SYMBOL_LANGUAGE (symbol) = language_java;                   \
+           SYMBOL_CPLUS_DEMANGLED_NAME (symbol) =                      \
+             obsavestring (demangled, strlen (demangled), (obstack));  \
+           free (demangled);                                           \
+         }                                                             \
+       else                                                            \
+         {                                                             \
+           SYMBOL_CPLUS_DEMANGLED_NAME (symbol) = NULL;                \
+         }                                                             \
+      }                                                                        \
     if (demangled == NULL                                              \
        && (SYMBOL_LANGUAGE (symbol) == language_chill                  \
            || SYMBOL_LANGUAGE (symbol) == language_auto))              \
@@ -185,6 +233,7 @@ extern int demangle;        /* We reference it, so go ahead and declare it. */
 
 #define SYMBOL_DEMANGLED_NAME(symbol)                                  \
   (SYMBOL_LANGUAGE (symbol) == language_cplus                          \
+   || SYMBOL_LANGUAGE (symbol) == language_java                                \
    ? SYMBOL_CPLUS_DEMANGLED_NAME (symbol)                              \
    : (SYMBOL_LANGUAGE (symbol) == language_chill                       \
       ? SYMBOL_CHILL_DEMANGLED_NAME (symbol)                           \
@@ -214,10 +263,6 @@ extern int demangle;       /* We reference it, so go ahead and declare it. */
    ? SYMBOL_DEMANGLED_NAME (symbol)                                    \
    : SYMBOL_NAME (symbol))
 
-/* From utils.c.  */
-extern int demangle;
-extern int asm_demangle;
-
 /* Macro that tests a symbol for a match against a specified name string.
    First test the unencoded name, then looks for and test a C++ encoded
    name if it exists.  Note that whitespace is ignored while attempting to
@@ -229,7 +274,7 @@ extern int asm_demangle;
   (STREQ (SYMBOL_NAME (symbol), (name))                                        \
    || (SYMBOL_DEMANGLED_NAME (symbol) != NULL                          \
        && strcmp_iw (SYMBOL_DEMANGLED_NAME (symbol), (name)) == 0))
-   
+
 /* Macro that tests a symbol for an re-match against the last compiled regular
    expression.  First test the unencoded name, then look for and test a C++
    encoded name if it exists.
@@ -239,7 +284,7 @@ extern int asm_demangle;
   (re_exec (SYMBOL_NAME (symbol)) != 0                                 \
    || (SYMBOL_DEMANGLED_NAME (symbol) != NULL                          \
        && re_exec (SYMBOL_DEMANGLED_NAME (symbol)) != 0))
-   
+
 /* Define a simple structure used to hold some very basic information about
    all defined global symbols (text, data, bss, abs, etc).  The only required
    information is the general_symbol_info.
@@ -253,49 +298,71 @@ extern int asm_demangle;
    used to figure out what full symbol table entries need to be read in. */
 
 struct minimal_symbol
-{
+  {
 
-  /* The general symbol info required for all types of symbols.
+    /* The general symbol info required for all types of symbols.
 
-     The SYMBOL_VALUE_ADDRESS contains the address that this symbol
-     corresponds to.  */
+       The SYMBOL_VALUE_ADDRESS contains the address that this symbol
+       corresponds to.  */
 
-  struct general_symbol_info ginfo;
+    struct general_symbol_info ginfo;
 
-  /* The info field is available for caching machine-specific information that
-     The AMD 29000 tdep.c uses it to remember things it has decoded from the
-     instructions in the function header, so it doesn't have to rederive the
-     info constantly (over a serial line).  It is initialized to zero and
-     stays that way until target-dependent code sets it.  Storage for any data
-     pointed to by this field should be allocated on the symbol_obstack for
-     the associated objfile.  The type would be "void *" except for reasons
-     of compatibility with older compilers.  This field is optional. */
+    /* The info field is available for caching machine-specific information
+       so it doesn't have to rederive the info constantly (over a serial line).
+       It is initialized to zero and stays that way until target-dependent code
+       sets it.  Storage for any data pointed to by this field should be allo-
+       cated on the symbol_obstack for the associated objfile.  
+       The type would be "void *" except for reasons of compatibility with older
+       compilers.  This field is optional.
 
-  char *info;
+       Currently, the AMD 29000 tdep.c uses it to remember things it has decoded
+       from the instructions in the function header, and the MIPS-16 code uses
+       it to identify 16-bit procedures.  */
 
-  /* Classification types for this symbol.  These should be taken as "advisory
-     only", since if gdb can't easily figure out a classification it simply
-     selects mst_unknown.  It may also have to guess when it can't figure out
-     which is a better match between two types (mst_data versus mst_bss) for
-     example.  Since the minimal symbol info is sometimes derived from the
-     BFD library's view of a file, we need to live with what information bfd
-     supplies. */
+    char *info;
 
-  enum minimal_symbol_type
-    {
-      mst_unknown = 0,         /* Unknown type, the default */
-      mst_text,                        /* Generally executable instructions */
-      mst_data,                        /* Generally initialized data */
-      mst_bss,                 /* Generally uninitialized data */
-      mst_abs                  /* Generally absolute (nonrelocatable) */
-    } type;
+#ifdef SOFUN_ADDRESS_MAYBE_MISSING
+    /* Which source file is this symbol in?  Only relevant for mst_file_*.  */
+    char *filename;
+#endif
 
-};
+    /* Classification types for this symbol.  These should be taken as "advisory
+       only", since if gdb can't easily figure out a classification it simply
+       selects mst_unknown.  It may also have to guess when it can't figure out
+       which is a better match between two types (mst_data versus mst_bss) for
+       example.  Since the minimal symbol info is sometimes derived from the
+       BFD library's view of a file, we need to live with what information bfd
+       supplies. */
+
+    enum minimal_symbol_type
+      {
+       mst_unknown = 0,        /* Unknown type, the default */
+       mst_text,               /* Generally executable instructions */
+       mst_data,               /* Generally initialized data */
+       mst_bss,                /* Generally uninitialized data */
+       mst_abs,                /* Generally absolute (nonrelocatable) */
+       /* GDB uses mst_solib_trampoline for the start address of a shared
+          library trampoline entry.  Breakpoints for shared library functions
+          are put there if the shared library is not yet loaded.
+          After the shared library is loaded, lookup_minimal_symbol will
+          prefer the minimal symbol from the shared library (usually
+          a mst_text symbol) over the mst_solib_trampoline symbol, and the
+          breakpoints will be moved to their true address in the shared
+          library via breakpoint_re_set.  */
+       mst_solib_trampoline,   /* Shared library trampoline code */
+       /* For the mst_file* types, the names are only guaranteed to be unique
+          within a given .o file.  */
+       mst_file_text,          /* Static version of mst_text */
+       mst_file_data,          /* Static version of mst_data */
+       mst_file_bss            /* Static version of mst_bss */
+      }
+    type BYTE_BITFIELD;
+  };
 
 #define MSYMBOL_INFO(msymbol)          (msymbol)->info
 #define MSYMBOL_TYPE(msymbol)          (msymbol)->type
-
 \f
+
 /* All of the name-scope contours of the program
    are represented by `struct block' objects.
    All of these objects are pointed to by the blockvector.
@@ -323,12 +390,12 @@ struct minimal_symbol
    the blocks appear in the order of a depth-first tree walk.  */
 
 struct blockvector
-{
-  /* Number of blocks in the list.  */
-  int nblocks;
-  /* The blocks themselves.  */
-  struct block *block[1];
-};
+  {
+    /* Number of blocks in the list.  */
+    int nblocks;
+    /* The blocks themselves.  */
+    struct block *block[1];
+  };
 
 #define BLOCKVECTOR_NBLOCKS(blocklist) (blocklist)->nblocks
 #define BLOCKVECTOR_BLOCK(blocklist,n) (blocklist)->block[n]
@@ -340,47 +407,47 @@ struct blockvector
 #define        FIRST_LOCAL_BLOCK       2
 
 struct block
-{
+  {
 
-  /* Addresses in the executable code that are in this block.  */
+    /* Addresses in the executable code that are in this block.  */
 
-  CORE_ADDR startaddr;
-  CORE_ADDR endaddr;
+    CORE_ADDR startaddr;
+    CORE_ADDR endaddr;
 
-  /* The symbol that names this block, if the block is the body of a
-     function; otherwise, zero.  */
+    /* The symbol that names this block, if the block is the body of a
+       function; otherwise, zero.  */
 
-  struct symbol *function;
+    struct symbol *function;
 
-  /* The `struct block' for the containing block, or 0 if none.
+    /* The `struct block' for the containing block, or 0 if none.
 
-     The superblock of a top-level local block (i.e. a function in the
-     case of C) is the STATIC_BLOCK.  The superblock of the
-     STATIC_BLOCK is the GLOBAL_BLOCK.  */
+       The superblock of a top-level local block (i.e. a function in the
+       case of C) is the STATIC_BLOCK.  The superblock of the
+       STATIC_BLOCK is the GLOBAL_BLOCK.  */
 
-  struct block *superblock;
+    struct block *superblock;
 
-  /* Version of GCC used to compile the function corresponding
-     to this block, or 0 if not compiled with GCC.  When possible,
-     GCC should be compatible with the native compiler, or if that
-     is not feasible, the differences should be fixed during symbol
-     reading.  As of 16 Apr 93, this flag is never used to distinguish
-     between gcc2 and the native compiler.
+    /* Version of GCC used to compile the function corresponding
+       to this block, or 0 if not compiled with GCC.  When possible,
+       GCC should be compatible with the native compiler, or if that
+       is not feasible, the differences should be fixed during symbol
+       reading.  As of 16 Apr 93, this flag is never used to distinguish
+       between gcc2 and the native compiler.
 
-     If there is no function corresponding to this block, this meaning
-     of this flag is undefined.  */
+       If there is no function corresponding to this block, this meaning
+       of this flag is undefined.  */
 
-  unsigned char gcc_compile_flag;
+    unsigned char gcc_compile_flag;
 
-  /* Number of local symbols.  */
+    /* Number of local symbols.  */
 
-  int nsyms;
+    int nsyms;
 
-  /* The symbols.  If some of them are arguments, then they must be
-     in the order in which we would like to print them.  */
+    /* The symbols.  If some of them are arguments, then they must be
+       in the order in which we would like to print them.  */
 
-  struct symbol *sym[1];
-};
+    struct symbol *sym[1];
+  };
 
 #define BLOCK_START(bl)                (bl)->startaddr
 #define BLOCK_END(bl)          (bl)->endaddr
@@ -396,184 +463,265 @@ struct block
    arguments.  */
 
 #define BLOCK_SHOULD_SORT(bl) ((bl)->nsyms >= 40 && BLOCK_FUNCTION (bl) == NULL)
-
 \f
+
 /* Represent one symbol name; a variable, constant, function or typedef.  */
 
 /* Different name spaces for symbols.  Looking up a symbol specifies a
    namespace and ignores symbol definitions in other name spaces. */
 
-enum namespace
-{
-  /* UNDEF_NAMESPACE is used when a namespace has not been discovered or
-     none of the following apply.  This usually indicates an error either
-     in the symbol information or in gdb's handling of symbols. */
+typedef enum
+  {
+    /* UNDEF_NAMESPACE is used when a namespace has not been discovered or
+       none of the following apply.  This usually indicates an error either
+       in the symbol information or in gdb's handling of symbols. */
+
+    UNDEF_NAMESPACE,
+
+    /* VAR_NAMESPACE is the usual namespace.  In C, this contains variables,
+       function names, typedef names and enum type values. */
+
+    VAR_NAMESPACE,
+
+    /* STRUCT_NAMESPACE is used in C to hold struct, union and enum type names.
+       Thus, if `struct foo' is used in a C program, it produces a symbol named
+       `foo' in the STRUCT_NAMESPACE. */
 
-  UNDEF_NAMESPACE,
+    STRUCT_NAMESPACE,
 
-  /* VAR_NAMESPACE is the usual namespace.  In C, this contains variables,
-     function names, typedef names and enum type values. */
+    /* LABEL_NAMESPACE may be used for names of labels (for gotos);
+       currently it is not used and labels are not recorded at all.  */
 
-  VAR_NAMESPACE,
+    LABEL_NAMESPACE,
 
-  /* STRUCT_NAMESPACE is used in C to hold struct, union and enum type names.
-     Thus, if `struct foo' is used in a C program, it produces a symbol named
-     `foo' in the STRUCT_NAMESPACE. */
+    /* Searching namespaces. These overlap with VAR_NAMESPACE, providing
+       some granularity with the search_symbols function. */
 
-  STRUCT_NAMESPACE,
+    /* Everything in VAR_NAMESPACE minus FUNCTIONS_-, TYPES_-, and
+       METHODS_NAMESPACE */
+    VARIABLES_NAMESPACE,
 
-  /* LABEL_NAMESPACE may be used for names of labels (for gotos);
-     currently it is not used and labels are not recorded at all.  */
+    /* All functions -- for some reason not methods, though. */
+    FUNCTIONS_NAMESPACE,
 
-  LABEL_NAMESPACE
-};
+    /* All defined types */
+    TYPES_NAMESPACE,
+
+    /* All class methods -- why is this separated out? */
+    METHODS_NAMESPACE
+
+  }
+namespace_enum;
 
 /* An address-class says where to find the value of a symbol.  */
 
 enum address_class
-{
-  /* Not used; catches errors */
+  {
+    /* Not used; catches errors */
 
-  LOC_UNDEF,
+    LOC_UNDEF,
 
-  /* Value is constant int SYMBOL_VALUE, host byteorder */
+    /* Value is constant int SYMBOL_VALUE, host byteorder */
 
-  LOC_CONST,
+    LOC_CONST,
 
-  /* Value is at fixed address SYMBOL_VALUE_ADDRESS */
+    /* Value is at fixed address SYMBOL_VALUE_ADDRESS */
 
-  LOC_STATIC,
+    LOC_STATIC,
 
-  /* Value is in register.  SYMBOL_VALUE is the register number.  */
+    /* Value is in register.  SYMBOL_VALUE is the register number.  */
 
-  LOC_REGISTER,
+    LOC_REGISTER,
 
-  /* It's an argument; the value is at SYMBOL_VALUE offset in arglist.  */
+    /* It's an argument; the value is at SYMBOL_VALUE offset in arglist.  */
 
-  LOC_ARG,
+    LOC_ARG,
 
-  /* Value address is at SYMBOL_VALUE offset in arglist.  */
+    /* Value address is at SYMBOL_VALUE offset in arglist.  */
 
-  LOC_REF_ARG,
+    LOC_REF_ARG,
 
-  /* Value is in register number SYMBOL_VALUE.  Just like LOC_REGISTER
-     except this is an argument.  Probably the cleaner way to handle
-     this would be to separate address_class (which would include
-     separate ARG and LOCAL to deal with FRAME_ARGS_ADDRESS versus
-     FRAME_LOCALS_ADDRESS), and an is_argument flag.
+    /* Value is in register number SYMBOL_VALUE.  Just like LOC_REGISTER
+       except this is an argument.  Probably the cleaner way to handle
+       this would be to separate address_class (which would include
+       separate ARG and LOCAL to deal with FRAME_ARGS_ADDRESS versus
+       FRAME_LOCALS_ADDRESS), and an is_argument flag.
 
-     For some symbol formats (stabs, for some compilers at least),
-     the compiler generates two symbols, an argument and a register.
-     In some cases we combine them to a single LOC_REGPARM in symbol
-     reading, but currently not for all cases (e.g. it's passed on the
-     stack and then loaded into a register).  */
+       For some symbol formats (stabs, for some compilers at least),
+       the compiler generates two symbols, an argument and a register.
+       In some cases we combine them to a single LOC_REGPARM in symbol
+       reading, but currently not for all cases (e.g. it's passed on the
+       stack and then loaded into a register).  */
 
-  LOC_REGPARM,
+    LOC_REGPARM,
 
-  /* Value is in specified register.  Just like LOC_REGPARM except the
-     register holds the address of the argument instead of the argument
-     itself. This is currently used for the passing of structs and unions
-     on sparc and hppa.  It is also used for call by reference where the
-     address is in a register, at least by mipsread.c.  */
+    /* Value is in specified register.  Just like LOC_REGPARM except the
+       register holds the address of the argument instead of the argument
+       itself. This is currently used for the passing of structs and unions
+       on sparc and hppa.  It is also used for call by reference where the
+       address is in a register, at least by mipsread.c.  */
 
-  LOC_REGPARM_ADDR,
+    LOC_REGPARM_ADDR,
 
-  /* Value is a local variable at SYMBOL_VALUE offset in stack frame.  */
+    /* Value is a local variable at SYMBOL_VALUE offset in stack frame.  */
 
-  LOC_LOCAL,
+    LOC_LOCAL,
 
-  /* Value not used; definition in SYMBOL_TYPE.  Symbols in the namespace
-     STRUCT_NAMESPACE all have this class.  */
+    /* Value not used; definition in SYMBOL_TYPE.  Symbols in the namespace
+       STRUCT_NAMESPACE all have this class.  */
 
-  LOC_TYPEDEF,
+    LOC_TYPEDEF,
 
-  /* Value is address SYMBOL_VALUE_ADDRESS in the code */
+    /* Value is address SYMBOL_VALUE_ADDRESS in the code */
 
-  LOC_LABEL,
+    LOC_LABEL,
 
-  /* In a symbol table, value is SYMBOL_BLOCK_VALUE of a `struct block'.
-     In a partial symbol table, SYMBOL_VALUE_ADDRESS is the start address
-     of the block.  Function names have this class. */
+    /* In a symbol table, value is SYMBOL_BLOCK_VALUE of a `struct block'.
+       In a partial symbol table, SYMBOL_VALUE_ADDRESS is the start address
+       of the block.  Function names have this class. */
 
-  LOC_BLOCK,
+    LOC_BLOCK,
 
-  /* Value is a constant byte-sequence pointed to by SYMBOL_VALUE_BYTES, in
-     target byte order.  */
+    /* Value is a constant byte-sequence pointed to by SYMBOL_VALUE_BYTES, in
+       target byte order.  */
 
-  LOC_CONST_BYTES,
+    LOC_CONST_BYTES,
 
-  /* Value is arg at SYMBOL_VALUE offset in stack frame. Differs from
-     LOC_LOCAL in that symbol is an argument; differs from LOC_ARG in
-     that we find it in the frame (FRAME_LOCALS_ADDRESS), not in the
-     arglist (FRAME_ARGS_ADDRESS).  Added for i960, which passes args
-     in regs then copies to frame.  */
+    /* Value is arg at SYMBOL_VALUE offset in stack frame. Differs from
+       LOC_LOCAL in that symbol is an argument; differs from LOC_ARG in
+       that we find it in the frame (FRAME_LOCALS_ADDRESS), not in the
+       arglist (FRAME_ARGS_ADDRESS).  Added for i960, which passes args
+       in regs then copies to frame.  */
 
-  LOC_LOCAL_ARG,
+    LOC_LOCAL_ARG,
 
-  /* The variable does not actually exist in the program.
-     The value is ignored.  */
+    /* Value is at SYMBOL_VALUE offset from the current value of
+       register number SYMBOL_BASEREG.  This exists mainly for the same
+       things that LOC_LOCAL and LOC_ARG do; but we need to do this
+       instead because on 88k DWARF gives us the offset from the
+       frame/stack pointer, rather than the offset from the "canonical
+       frame address" used by COFF, stabs, etc., and we don't know how
+       to convert between these until we start examining prologues.
 
-  LOC_OPTIMIZED_OUT
-};
+       Note that LOC_BASEREG is much less general than a DWARF expression.
+       We don't need the generality (at least not yet), and storing a general
+       DWARF expression would presumably take up more space than the existing
+       scheme.  */
 
-struct symbol
-{
+    LOC_BASEREG,
 
-  /* The general symbol info required for all types of symbols. */
+    /* Same as LOC_BASEREG but it is an argument.  */
 
-  struct general_symbol_info ginfo;
+    LOC_BASEREG_ARG,
 
-  /* Name space code.  */
+    /* Value is at fixed address, but the address of the variable has
+       to be determined from the minimal symbol table whenever the
+       variable is referenced.
+       This happens if debugging information for a global symbol is
+       emitted and the corresponding minimal symbol is defined
+       in another object file or runtime common storage.
+       The linker might even remove the minimal symbol if the global
+       symbol is never referenced, in which case the symbol remains
+       unresolved.  */
 
-  enum namespace namespace;
+    LOC_UNRESOLVED,
 
-  /* Address class */
+    /* Value is at a thread-specific location calculated by a
+       target-specific method. */
 
-  enum address_class class;
+    LOC_THREAD_LOCAL_STATIC,
 
-  /* Data type of value */
+    /* The variable does not actually exist in the program.
+       The value is ignored.  */
 
-  struct type *type;
+    LOC_OPTIMIZED_OUT,
 
-  /* Line number of definition.  FIXME:  Should we really make the assumption
-     that nobody will try to debug files longer than 64K lines?  What about
-     machine generated programs? */
+    /* The variable is static, but actually lives at * (address).
+     * I.e. do an extra indirection to get to it.
+     * This is used on HP-UX to get at globals that are allocated
+     * in shared libraries, where references from images other
+     * than the one where the global was allocated are done
+     * with a level of indirection.
+     */
 
-  unsigned short line;
-  
-  /* Some symbols require an additional value to be recorded on a per-
-     symbol basis.  Stash those values here. */
+    LOC_INDIRECT
 
-  union
-    {
-      /* for OP_BASEREG in DWARF location specs */
-      struct
-       {
-         short regno_valid;    /* 0 == regno invalid; !0 == regno valid */
-         short regno;          /* base register number {0, 1, 2, ...} */
-       } basereg;
-    }
-  aux_value;
+  };
 
-};
+/* Linked list of symbol's live ranges. */
 
-#define SYMBOL_NAMESPACE(symbol)       (symbol)->namespace
-#define SYMBOL_CLASS(symbol)           (symbol)->class
-#define SYMBOL_TYPE(symbol)            (symbol)->type
-#define SYMBOL_LINE(symbol)            (symbol)->line
-#define SYMBOL_BASEREG(symbol)         (symbol)->aux_value.basereg.regno
+struct range_list
+  {
+    CORE_ADDR start;
+    CORE_ADDR end;
+    struct range_list *next;
+  };
 
-/* This currently fails because some symbols are not being initialized
-   to zero on allocation, and no code is currently setting this value.
-   Basereg handling will probably change significantly in the next release.
-   FIXME -fnf */
+/* Linked list of aliases for a particular main/primary symbol.  */
+struct alias_list
+  {
+    struct symbol *sym;
+    struct alias_list *next;
+  };
 
-#if 0
-#define SYMBOL_BASEREG_VALID(symbol) (symbol)->aux_value.basereg.regno_valid
-#else
-#define SYMBOL_BASEREG_VALID(symbol) 0
+struct symbol
+  {
+
+    /* The general symbol info required for all types of symbols. */
+
+    struct general_symbol_info ginfo;
+
+    /* Data type of value */
+
+    struct type *type;
+
+    /* Name space code.  */
+
+#ifdef __MFC4__
+    /* FIXME: don't conflict with C++'s namespace */
+    /* would be safer to do a global change for all namespace identifiers. */
+#define namespace _namespace
 #endif
+    namespace_enum namespace BYTE_BITFIELD;
+
+    /* Address class */
 
+    enum address_class aclass BYTE_BITFIELD;
+
+    /* Line number of definition.  FIXME:  Should we really make the assumption
+       that nobody will try to debug files longer than 64K lines?  What about
+       machine generated programs? */
+
+    unsigned short line;
+
+    /* Some symbols require an additional value to be recorded on a per-
+       symbol basis.  Stash those values here. */
+
+    union
+      {
+       /* Used by LOC_BASEREG and LOC_BASEREG_ARG.  */
+       short basereg;
+      }
+    aux_value;
+
+
+    /* Link to a list of aliases for this symbol.
+       Only a "primary/main symbol may have aliases.  */
+    struct alias_list *aliases;
+
+    /* List of ranges where this symbol is active.  This is only
+       used by alias symbols at the current time.  */
+    struct range_list *ranges;
+  };
+
+
+#define SYMBOL_NAMESPACE(symbol)       (symbol)->namespace
+#define SYMBOL_CLASS(symbol)           (symbol)->aclass
+#define SYMBOL_TYPE(symbol)            (symbol)->type
+#define SYMBOL_LINE(symbol)            (symbol)->line
+#define SYMBOL_BASEREG(symbol)         (symbol)->aux_value.basereg
+#define SYMBOL_ALIASES(symbol)         (symbol)->aliases
+#define SYMBOL_RANGES(symbol)          (symbol)->ranges
 \f
 /* A partial_symbol records the name, namespace, and address class of
    symbols whose types we have not parsed yet.  For functions, it also
@@ -583,34 +731,34 @@ struct symbol
    normal symtab once the partial_symtab has been referenced.  */
 
 struct partial_symbol
-{
+  {
 
-  /* The general symbol info required for all types of symbols. */
+    /* The general symbol info required for all types of symbols. */
 
-  struct general_symbol_info ginfo;
+    struct general_symbol_info ginfo;
 
-  /* Name space code.  */
+    /* Name space code.  */
 
-  enum namespace namespace;
+    namespace_enum namespace BYTE_BITFIELD;
 
-  /* Address class (for info_symbols) */
+    /* Address class (for info_symbols) */
 
-  enum address_class class;
+    enum address_class aclass BYTE_BITFIELD;
 
-};
+  };
 
 #define PSYMBOL_NAMESPACE(psymbol)     (psymbol)->namespace
-#define PSYMBOL_CLASS(psymbol)         (psymbol)->class
-
+#define PSYMBOL_CLASS(psymbol)         (psymbol)->aclass
 \f
+
 /* Source-file information.  This describes the relation between source files,
    ine numbers and addresses in the program text.  */
 
 struct sourcevector
-{
-  int length;                  /* Number of source files described */
-  struct source *source[1];    /* Descriptions of the files */
-};
+  {
+    int length;                        /* Number of source files described */
+    struct source *source[1];  /* Descriptions of the files */
+  };
 
 /* Each item represents a line-->pc (or the reverse) mapping.  This is
    somewhat more wasteful of space than one might wish, but since only
@@ -618,41 +766,42 @@ struct sourcevector
    waste much space.  */
 
 struct linetable_entry
-{
-  int line;
-  CORE_ADDR pc;
-};
-
-/* The order of entries in the linetable is significant.
+  {
+    int line;
+    CORE_ADDR pc;
+  };
 
-   It should generally be in ascending line number order.  Line table
-   entries for a function at lines 10-40 should come before entries
-   for a function at lines 50-70.
+/* The order of entries in the linetable is significant.  They should
+   be sorted by increasing values of the pc field.  If there is more than
+   one entry for a given pc, then I'm not sure what should happen (and
+   I not sure whether we currently handle it the best way).
 
-   A for statement looks like this
+   Example: a C for statement generally looks like this
 
-       10      0x100   - for the init/test part of a for stmt.
-       20      0x200
-       30      0x300
-       10      0x400   - for the increment part of a for stmt.
+   10   0x100   - for the init/test part of a for stmt.
+   20   0x200
+   30   0x300
+   10   0x400   - for the increment part of a for stmt.
 
-   FIXME: this description is incomplete.  coffread.c is said to get
-   the linetable order wrong (would arrange_linenos from xcoffread.c
-   work for normal COFF too?).  */
+ */
 
 struct linetable
-{
-  int nitems;
-  struct linetable_entry item[1];
-};
+  {
+    int nitems;
+
+    /* Actually NITEMS elements.  If you don't like this use of the
+       `struct hack', you can shove it up your ANSI (seriously, if the
+       committee tells us how to do it, we can probably go along).  */
+    struct linetable_entry item[1];
+  };
 
 /* All the information on one source file.  */
 
 struct source
-{
-  char *name;                  /* Name of file */
-  struct linetable contents;
-};
+  {
+    char *name;                        /* Name of file */
+    struct linetable contents;
+  };
 
 /* How to relocate the symbols from each section in a symbol file.
    Each struct contains an array of offsets.
@@ -666,12 +815,19 @@ struct source
 
 struct section_offsets
   {
-    CORE_ADDR offsets[1];              /* As many as needed. */
+    CORE_ADDR offsets[1];      /* As many as needed. */
   };
 
 #define        ANOFFSET(secoff, whichone)      (secoff->offsets[whichone])
 
-/* Each source file is represented by a struct symtab. 
+/* The maximum possible size of a section_offsets table.  */
+
+#define SIZEOF_SECTION_OFFSETS \
+  (sizeof (struct section_offsets) \
+   + sizeof (((struct section_offsets *) 0)->offsets) * (SECT_OFF_MAX-1))
+
+
+/* Each source file or header is represented by a struct symtab. 
    These objects are chained through the `next' field.  */
 
 struct symtab
@@ -681,22 +837,24 @@ struct symtab
 
     struct symtab *next;
 
-    /* List of all symbol scope blocks for this symtab.  */
+    /* List of all symbol scope blocks for this symtab.  May be shared
+       between different symtabs (and normally is for all the symtabs
+       in a given compilation unit).  */
 
     struct blockvector *blockvector;
 
     /* Table mapping core addresses to line numbers for this file.
-       Can be NULL if none.  */
+       Can be NULL if none.  Never shared between different symtabs.  */
 
     struct linetable *linetable;
 
     /* Section in objfile->section_offsets for the blockvector and
-       the linetable.  */
+       the linetable.  Probably always SECT_OFF_TEXT.  */
 
     int block_line_section;
 
     /* If several symtabs share a blockvector, exactly one of them
-       should be designed the primary, so that the blockvector
+       should be designated the primary, so that the blockvector
        is relocated exactly once by objfile_relocate.  */
 
     int primary;
@@ -712,18 +870,19 @@ struct symtab
     /* This component says how to free the data we point to:
        free_contents => do a tree walk and free each object.
        free_nothing => do nothing; some other symtab will free
-         the data this one uses.
-      free_linetable => free just the linetable.  */
+       the data this one uses.
+       free_linetable => free just the linetable.  FIXME: Is this redundant
+       with the primary field?  */
 
     enum free_code
       {
        free_nothing, free_contents, free_linetable
-       }
+      }
     free_code;
 
     /* Pointer to one block of storage to be freed, if nonzero.  */
     /* This is IN ADDITION to the action indicated by free_code.  */
-    
+
     char *free_ptr;
 
     /* Total number of lines found in source file.  */
@@ -740,6 +899,13 @@ struct symtab
 
     enum language language;
 
+    /* String that identifies the format of the debugging information, such
+       as "stabs", "dwarf 1", "dwarf 2", "coff", etc.  This is mostly useful
+       for automated testing of gdb but may also be information that is
+       useful to the user. */
+
+    char *debugformat;
+
     /* String of version information.  May be zero.  */
 
     char *version;
@@ -753,20 +919,12 @@ struct symtab
 
     struct objfile *objfile;
 
-    /* Anything extra for this symtab.  This is for target machines
-       with special debugging info of some sort (which cannot just
-       be represented in a normal symtab).  */
-
-#if defined (EXTRA_SYMTAB_INFO)
-    EXTRA_SYMTAB_INFO
-#endif
-
   };
 
 #define BLOCKVECTOR(symtab)    (symtab)->blockvector
 #define LINETABLE(symtab)      (symtab)->linetable
-
 \f
+
 /* Each source file that has not been fully read in is represented by
    a partial_symtab.  This contains the information on where in the
    executable the debugging symbols for a specific file are, and a
@@ -779,90 +937,90 @@ struct symtab
    style execution of a bunch of .o's.  */
 
 struct partial_symtab
-{
+  {
 
-  /* Chain of all existing partial symtabs.  */
+    /* Chain of all existing partial symtabs.  */
 
-  struct partial_symtab *next;
+    struct partial_symtab *next;
 
-  /* Name of the source file which this partial_symtab defines */
+    /* Name of the source file which this partial_symtab defines */
 
-  char *filename;
+    char *filename;
 
-  /* Information about the object file from which symbols should be read.  */
+    /* Information about the object file from which symbols should be read.  */
 
-  struct objfile *objfile;
+    struct objfile *objfile;
 
-  /* Set of relocation offsets to apply to each section.  */ 
+    /* Set of relocation offsets to apply to each section.  */
 
-  struct section_offsets *section_offsets;
+    struct section_offsets *section_offsets;
 
-  /* Range of text addresses covered by this file; texthigh is the
-     beginning of the next section. */
+    /* Range of text addresses covered by this file; texthigh is the
+       beginning of the next section. */
 
-  CORE_ADDR textlow;
-  CORE_ADDR texthigh;
+    CORE_ADDR textlow;
+    CORE_ADDR texthigh;
 
-  /* Array of pointers to all of the partial_symtab's which this one
-     depends on.  Since this array can only be set to previous or
-     the current (?) psymtab, this dependency tree is guaranteed not
-     to have any loops.  "depends on" means that symbols must be read
-     for the dependencies before being read for this psymtab; this is
-     for type references in stabs, where if foo.c includes foo.h, declarations
-     in foo.h may use type numbers defined in foo.c.  For other debugging
-     formats there may be no need to use dependencies.  */
+    /* Array of pointers to all of the partial_symtab's which this one
+       depends on.  Since this array can only be set to previous or
+       the current (?) psymtab, this dependency tree is guaranteed not
+       to have any loops.  "depends on" means that symbols must be read
+       for the dependencies before being read for this psymtab; this is
+       for type references in stabs, where if foo.c includes foo.h, declarations
+       in foo.h may use type numbers defined in foo.c.  For other debugging
+       formats there may be no need to use dependencies.  */
 
-  struct partial_symtab **dependencies;
+    struct partial_symtab **dependencies;
 
-  int number_of_dependencies;
+    int number_of_dependencies;
 
-  /* Global symbol list.  This list will be sorted after readin to
-     improve access.  Binary search will be the usual method of
-     finding a symbol within it. globals_offset is an integer offset
-     within global_psymbols[].  */
+    /* Global symbol list.  This list will be sorted after readin to
+       improve access.  Binary search will be the usual method of
+       finding a symbol within it. globals_offset is an integer offset
+       within global_psymbols[].  */
 
-  int globals_offset;
-  int n_global_syms;
+    int globals_offset;
+    int n_global_syms;
 
-  /* Static symbol list.  This list will *not* be sorted after readin;
-     to find a symbol in it, exhaustive search must be used.  This is
-     reasonable because searches through this list will eventually
-     lead to either the read in of a files symbols for real (assumed
-     to take a *lot* of time; check) or an error (and we don't care
-     how long errors take).  This is an offset and size within
-     static_psymbols[].  */
+    /* Static symbol list.  This list will *not* be sorted after readin;
+       to find a symbol in it, exhaustive search must be used.  This is
+       reasonable because searches through this list will eventually
+       lead to either the read in of a files symbols for real (assumed
+       to take a *lot* of time; check) or an error (and we don't care
+       how long errors take).  This is an offset and size within
+       static_psymbols[].  */
 
-  int statics_offset;
-  int n_static_syms;
+    int statics_offset;
+    int n_static_syms;
 
-  /* Pointer to symtab eventually allocated for this source file, 0 if
-     !readin or if we haven't looked for the symtab after it was readin.  */
+    /* Pointer to symtab eventually allocated for this source file, 0 if
+       !readin or if we haven't looked for the symtab after it was readin.  */
 
-  struct symtab *symtab;
+    struct symtab *symtab;
 
-  /* Pointer to function which will read in the symtab corresponding to
-     this psymtab.  */
+    /* Pointer to function which will read in the symtab corresponding to
+       this psymtab.  */
 
-  void (*read_symtab) PARAMS ((struct partial_symtab *));
+    void (*read_symtab) PARAMS ((struct partial_symtab *));
 
-  /* Information that lets read_symtab() locate the part of the symbol table
-     that this psymtab corresponds to.  This information is private to the
-     format-dependent symbol reading routines.  For further detail examine
-     the various symbol reading modules.  Should really be (void *) but is
-     (char *) as with other such gdb variables.  (FIXME) */
+    /* Information that lets read_symtab() locate the part of the symbol table
+       that this psymtab corresponds to.  This information is private to the
+       format-dependent symbol reading routines.  For further detail examine
+       the various symbol reading modules.  Should really be (void *) but is
+       (char *) as with other such gdb variables.  (FIXME) */
 
-  char *read_symtab_private;
+    char *read_symtab_private;
 
-  /* Non-zero if the symtab corresponding to this psymtab has been readin */
+    /* Non-zero if the symtab corresponding to this psymtab has been readin */
 
-  unsigned char readin;
-};
+    unsigned char readin;
+  };
 
 /* A fast way to get from a psymtab to its symtab (after the first time).  */
 #define        PSYMTAB_TO_SYMTAB(pst)  \
     ((pst) -> symtab != NULL ? (pst) -> symtab : psymtab_to_symtab (pst))
-
 \f
+
 /* The virtual function table is now an array of structures which have the
    form { int16 offset, delta; void *pfn; }. 
 
@@ -873,7 +1031,7 @@ struct partial_symtab
    PFN is a pointer to the virtual function.
 
    Note that this macro is g++ specific (FIXME). */
-  
+
 #define VTBL_FNADDR_OFFSET 2
 
 /* Macro that yields non-zero value iff NAME is the prefix for C++ operator
@@ -883,21 +1041,26 @@ struct partial_symtab
    Note that this macro is g++ specific (FIXME). */
 
 #define OPNAME_PREFIX_P(NAME) \
-  ((NAME)[0] == 'o' && (NAME)[1] == 'p' && (NAME)[2] == CPLUS_MARKER)
+  ((NAME)[0] == 'o' && (NAME)[1] == 'p' && is_cplus_marker ((NAME)[2]))
 
 /* Macro that yields non-zero value iff NAME is the prefix for C++ vtbl
-   names.  Note that this macro is g++ specific (FIXME).  */
+   names.  Note that this macro is g++ specific (FIXME).
+   '_vt$' is the old cfront-style vtables; '_VT$' is the new
+   style, using thunks (where '$' is really CPLUS_MARKER). */
 
 #define VTBL_PREFIX_P(NAME) \
-  ((NAME)[3] == CPLUS_MARKER && !strncmp ((NAME), "_vt", 3))
+  ((NAME)[0] == '_' \
+   && (((NAME)[1] == 'V' && (NAME)[2] == 'T') \
+       || ((NAME)[1] == 'v' && (NAME)[2] == 't')) \
+   && is_cplus_marker ((NAME)[3]))
 
 /* Macro that yields non-zero value iff NAME is the prefix for C++ destructor
    names.  Note that this macro is g++ specific (FIXME).  */
 
 #define DESTRUCTOR_PREFIX_P(NAME) \
-  ((NAME)[0] == '_' && (NAME)[1] == CPLUS_MARKER && (NAME)[2] == '_')
-
+  ((NAME)[0] == '_' && is_cplus_marker ((NAME)[1]) && (NAME)[2] == '_')
 \f
+
 /* External variables and functions for the objects described above. */
 
 /* This symtab variable specifies the current file for printing source lines */
@@ -912,49 +1075,110 @@ extern int current_source_line;
 
 extern struct objfile *current_objfile;
 
+/* True if we are nested inside psymtab_to_symtab. */
+
+extern int currently_reading_symtab;
+
+/* From utils.c.  */
+extern int demangle;
+extern int asm_demangle;
+
+/* symtab.c lookup functions */
+
+/* lookup a symbol table by source file name */
+
 extern struct symtab *
-lookup_symtab PARAMS ((char *));
+  lookup_symtab PARAMS ((char *));
+
+/* lookup a symbol by name (optional block, optional symtab) */
 
 extern struct symbol *
-lookup_symbol PARAMS ((const char *, const struct block *,
-                      const enum namespace, int *, struct symtab **));
+  lookup_symbol PARAMS ((const char *, const struct block *,
+                        const namespace_enum, int *, struct symtab **));
+
+/* lookup a symbol by name, within a specified block */
 
 extern struct symbol *
-lookup_block_symbol PARAMS ((const struct block *, const char *,
-                            const enum namespace));
+  lookup_block_symbol PARAMS ((const struct block *, const char *,
+                              const namespace_enum));
+
+/* lookup a [struct, union, enum] by name, within a specified block */
 
 extern struct type *
-lookup_struct PARAMS ((char *, struct block *));
+  lookup_struct PARAMS ((char *, struct block *));
 
 extern struct type *
-lookup_union PARAMS ((char *, struct block *));
+  lookup_union PARAMS ((char *, struct block *));
 
 extern struct type *
-lookup_enum PARAMS ((char *, struct block *));
+  lookup_enum PARAMS ((char *, struct block *));
+
+/* lookup the function corresponding to the block */
+
+extern struct symbol *
+  block_function PARAMS ((struct block *));
+
+/* from blockframe.c: */
+
+/* lookup the function symbol corresponding to the address */
 
 extern struct symbol *
-block_function PARAMS ((struct block *));
+  find_pc_function PARAMS ((CORE_ADDR));
+
+/* lookup the function corresponding to the address and section */
 
 extern struct symbol *
-find_pc_function PARAMS ((CORE_ADDR));
+  find_pc_sect_function PARAMS ((CORE_ADDR, asection *));
+
+/* lookup function from address, return name, start addr and end addr */
 
-extern int find_pc_partial_function
-  PARAMS ((CORE_ADDR, char **, CORE_ADDR *, CORE_ADDR *));
+extern int
+find_pc_partial_function PARAMS ((CORE_ADDR, char **,
+                                 CORE_ADDR *, CORE_ADDR *));
 
 extern void
 clear_pc_function_cache PARAMS ((void));
 
+extern int
+find_pc_sect_partial_function PARAMS ((CORE_ADDR, asection *,
+                                      char **, CORE_ADDR *, CORE_ADDR *));
+
+/* from symtab.c: */
+
+/* lookup partial symbol table by filename */
+
 extern struct partial_symtab *
-lookup_partial_symtab PARAMS ((char *));
+  lookup_partial_symtab PARAMS ((char *));
+
+/* lookup partial symbol table by address */
+
+extern struct partial_symtab *
+  find_pc_psymtab PARAMS ((CORE_ADDR));
+
+/* lookup partial symbol table by address and section */
 
 extern struct partial_symtab *
-find_pc_psymtab PARAMS ((CORE_ADDR));
+  find_pc_sect_psymtab PARAMS ((CORE_ADDR, asection *));
+
+/* lookup full symbol table by address */
+
+extern struct symtab *
+  find_pc_symtab PARAMS ((CORE_ADDR));
+
+/* lookup full symbol table by address and section */
 
 extern struct symtab *
-find_pc_symtab PARAMS ((CORE_ADDR));
+  find_pc_sect_symtab PARAMS ((CORE_ADDR, asection *));
+
+/* lookup partial symbol by address */
+
+extern struct partial_symbol *
+  find_pc_psymbol PARAMS ((struct partial_symtab *, CORE_ADDR));
+
+/* lookup partial symbol by address and section */
 
 extern struct partial_symbol *
-find_pc_psymbol PARAMS ((struct partial_symtab *, CORE_ADDR));
+  find_pc_sect_psymbol PARAMS ((struct partial_symtab *, CORE_ADDR, asection *));
 
 extern int
 find_pc_line_pc_range PARAMS ((CORE_ADDR, CORE_ADDR *, CORE_ADDR *));
@@ -965,23 +1189,62 @@ contained_in PARAMS ((struct block *, struct block *));
 extern void
 reread_symbols PARAMS ((void));
 
+extern struct type *
+  lookup_transparent_type PARAMS ((const char *));
+
+
+/* Macro for name of symbol to indicate a file compiled with gcc. */
+#ifndef GCC_COMPILED_FLAG_SYMBOL
+#define GCC_COMPILED_FLAG_SYMBOL "gcc_compiled."
+#endif
+
+/* Macro for name of symbol to indicate a file compiled with gcc2. */
+#ifndef GCC2_COMPILED_FLAG_SYMBOL
+#define GCC2_COMPILED_FLAG_SYMBOL "gcc2_compiled."
+#endif
+
 /* Functions for dealing with the minimal symbol table, really a misc
    address<->symbol mapping for things we don't have debug symbols for.  */
 
-extern void
-prim_record_minimal_symbol PARAMS ((const char *, CORE_ADDR,
-                                   enum minimal_symbol_type));
+extern void prim_record_minimal_symbol PARAMS ((const char *, CORE_ADDR,
+                                               enum minimal_symbol_type,
+                                               struct objfile *));
+
+extern struct minimal_symbol *prim_record_minimal_symbol_and_info
+  PARAMS ((const char *, CORE_ADDR,
+          enum minimal_symbol_type,
+          char *info, int section,
+          asection * bfd_section,
+          struct objfile *));
+
+#ifdef SOFUN_ADDRESS_MAYBE_MISSING
+extern CORE_ADDR find_stab_function_addr PARAMS ((char *,
+                                                 struct partial_symtab *,
+                                                 struct objfile *));
+#endif
 
-extern void
-prim_record_minimal_symbol_and_info PARAMS ((const char *, CORE_ADDR,
-                                            enum minimal_symbol_type,
-                                            char *info, int section));
+extern struct minimal_symbol *
+  lookup_minimal_symbol PARAMS ((const char *, const char *, struct objfile *));
+
+extern struct minimal_symbol *
+  lookup_minimal_symbol_text PARAMS ((const char *, const char *, struct objfile *));
+
+struct minimal_symbol *
+  lookup_minimal_symbol_solib_trampoline PARAMS ((const char *,
+                                                 const char *,
+                                                 struct objfile *));
 
 extern struct minimal_symbol *
-lookup_minimal_symbol PARAMS ((const char *, struct objfile *));
+  lookup_minimal_symbol_by_pc PARAMS ((CORE_ADDR));
 
 extern struct minimal_symbol *
-lookup_minimal_symbol_by_pc PARAMS ((CORE_ADDR));
+  lookup_minimal_symbol_by_pc_section PARAMS ((CORE_ADDR, asection *));
+
+extern struct minimal_symbol *
+  lookup_solib_trampoline_symbol_by_pc PARAMS ((CORE_ADDR));
+
+extern CORE_ADDR
+  find_solib_trampoline_target PARAMS ((CORE_ADDR));
 
 extern void
 init_minimal_symbol_collection PARAMS ((void));
@@ -992,24 +1255,73 @@ discard_minimal_symbols PARAMS ((int));
 extern void
 install_minimal_symbols PARAMS ((struct objfile *));
 
-struct symtab_and_line
-{
-  struct symtab *symtab;
+/* Sort all the minimal symbols in OBJFILE.  */
 
-  /* Line number.  Line numbers start at 1 and proceed through symtab->nlines.
-     0 is never a valid line number; it is used to indicate that line number
-     information is not available.  */
-  int line;
+extern void msymbols_sort PARAMS ((struct objfile * objfile));
+
+struct symtab_and_line
+  {
+    struct symtab *symtab;
+    asection *section;
+    /* Line number.  Line numbers start at 1 and proceed through symtab->nlines.
+       0 is never a valid line number; it is used to indicate that line number
+       information is not available.  */
+    int line;
+
+    CORE_ADDR pc;
+    CORE_ADDR end;
+  };
 
-  CORE_ADDR pc;
-  CORE_ADDR end;
-};
+#define INIT_SAL(sal) { \
+  (sal)->symtab  = 0;   \
+  (sal)->section = 0;   \
+  (sal)->line    = 0;   \
+  (sal)->pc      = 0;   \
+  (sal)->end     = 0;   \
+}
 
 struct symtabs_and_lines
-{
-  struct symtab_and_line *sals;
-  int nelts;
-};
+  {
+    struct symtab_and_line *sals;
+    int nelts;
+  };
+\f
+
+
+/* Some types and macros needed for exception catchpoints.
+   Can't put these in target.h because symtab_and_line isn't
+   known there. This file will be included by breakpoint.c,
+   hppa-tdep.c, etc. */
+
+/* Enums for exception-handling support */
+enum exception_event_kind
+  {
+    EX_EVENT_THROW,
+    EX_EVENT_CATCH
+  };
+
+/* Type for returning info about an exception */
+struct exception_event_record
+  {
+    enum exception_event_kind kind;
+    struct symtab_and_line throw_sal;
+    struct symtab_and_line catch_sal;
+    /* This may need to be extended in the future, if
+       some platforms allow reporting more information,
+       such as point of rethrow, type of exception object,
+       type expected by catch clause, etc. */
+  };
+
+#define CURRENT_EXCEPTION_KIND       (current_exception_event->kind)
+#define CURRENT_EXCEPTION_CATCH_SAL  (current_exception_event->catch_sal)
+#define CURRENT_EXCEPTION_CATCH_LINE (current_exception_event->catch_sal.line)
+#define CURRENT_EXCEPTION_CATCH_FILE (current_exception_event->catch_sal.symtab->filename)
+#define CURRENT_EXCEPTION_CATCH_PC   (current_exception_event->catch_sal.pc)
+#define CURRENT_EXCEPTION_THROW_SAL  (current_exception_event->throw_sal)
+#define CURRENT_EXCEPTION_THROW_LINE (current_exception_event->throw_sal.line)
+#define CURRENT_EXCEPTION_THROW_FILE (current_exception_event->throw_sal.symtab->filename)
+#define CURRENT_EXCEPTION_THROW_PC   (current_exception_event->throw_sal.pc)
+\f
 
 /* Given a pc value, return line number it is in.  Second arg nonzero means
    if pc is on the boundary use the previous statement's line number.  */
@@ -1017,13 +1329,26 @@ struct symtabs_and_lines
 extern struct symtab_and_line
 find_pc_line PARAMS ((CORE_ADDR, int));
 
+/* Same function, but specify a section as well as an address */
+
+extern struct symtab_and_line
+find_pc_sect_line PARAMS ((CORE_ADDR, asection *, int));
+
+/* Given an address, return the nearest symbol at or below it in memory.
+   Optionally return the symtab it's from through 2nd arg, and the
+   address in inferior memory of the symbol through 3rd arg.  */
+
+extern struct symbol *
+  find_addr_symbol PARAMS ((CORE_ADDR, struct symtab **, CORE_ADDR *));
+
 /* Given a symtab and line number, return the pc there.  */
 
-extern CORE_ADDR
-find_line_pc PARAMS ((struct symtab *, int));
+extern int
+find_line_pc PARAMS ((struct symtab *, int, CORE_ADDR *));
 
-extern int 
-find_line_pc_range PARAMS ((struct symtab *, int, CORE_ADDR *, CORE_ADDR *));
+extern int
+find_line_pc_range PARAMS ((struct symtab_and_line,
+                           CORE_ADDR *, CORE_ADDR *));
 
 extern void
 resolve_sal_pc PARAMS ((struct symtab_and_line *));
@@ -1038,12 +1363,10 @@ extern struct symtabs_and_lines
 decode_line_spec_1 PARAMS ((char *, int));
 
 extern struct symtabs_and_lines
-decode_line_1 PARAMS ((char **, int, struct symtab *, int));
+decode_line_1 PARAMS ((char **, int, struct symtab *, int, char ***));
 
 /* Symmisc.c */
 
-#if MAINTENANCE_CMDS
-
 void
 maintenance_print_symbols PARAMS ((char *, int));
 
@@ -1056,7 +1379,13 @@ maintenance_print_msymbols PARAMS ((char *, int));
 void
 maintenance_print_objfiles PARAMS ((char *, int));
 
-#endif
+void
+maintenance_check_symtabs PARAMS ((char *, int));
+
+/* maint.c */
+
+void
+maintenance_print_statistics PARAMS ((char *, int));
 
 extern void
 free_symtab PARAMS ((struct symtab *));
@@ -1064,18 +1393,16 @@ free_symtab PARAMS ((struct symtab *));
 /* Symbol-reading stuff in symfile.c and solib.c.  */
 
 extern struct symtab *
-psymtab_to_symtab PARAMS ((struct partial_symtab *));
+  psymtab_to_symtab PARAMS ((struct partial_symtab *));
 
 extern void
 clear_solib PARAMS ((void));
 
 extern struct objfile *
-symbol_file_add PARAMS ((char *, int, CORE_ADDR, int, int, int));
+  symbol_file_add PARAMS ((char *, int, CORE_ADDR, int, int, int, int, int));
 
 /* source.c */
 
-extern int frame_file_full_name; /* in stack.c */
-
 extern int
 identify_source_line PARAMS ((struct symtab *, int, int, CORE_ADDR));
 
@@ -1090,22 +1417,65 @@ select_source_symtab PARAMS ((struct symtab *));
 
 extern char **make_symbol_completion_list PARAMS ((char *, char *));
 
-/* symtab.c */
+extern struct symbol **
+  make_symbol_overload_list PARAMS ((struct symbol *));
 
-extern void
-clear_symtab_users_once PARAMS ((void));
+/* symtab.c */
 
 extern struct partial_symtab *
-find_main_psymtab PARAMS ((void));
+  find_main_psymtab PARAMS ((void));
 
 /* blockframe.c */
 
 extern struct blockvector *
-blockvector_for_pc PARAMS ((CORE_ADDR, int *));
+  blockvector_for_pc PARAMS ((CORE_ADDR, int *));
+
+extern struct blockvector *
+  blockvector_for_pc_sect PARAMS ((CORE_ADDR, asection *, int *,
+                                  struct symtab *));
 
 /* symfile.c */
 
+extern void
+clear_symtab_users PARAMS ((void));
+
 extern enum language
 deduce_language_from_filename PARAMS ((char *));
 
+/* symtab.c */
+
+extern int
+in_prologue PARAMS ((CORE_ADDR pc, CORE_ADDR func_start));
+
+extern struct symbol *
+  fixup_symbol_section PARAMS ((struct symbol *, struct objfile *));
+
+/* Symbol searching */
+
+/* When using search_symbols, a list of the following structs is returned.
+   Callers must free the search list using free_symbol_search! */
+struct symbol_search
+  {
+    /* The block in which the match was found. Could be, for example,
+       STATIC_BLOCK or GLOBAL_BLOCK. */
+    int block;
+
+    /* Information describing what was found.
+
+       If symtab abd symbol are NOT NULL, then information was found
+       for this match. */
+    struct symtab *symtab;
+    struct symbol *symbol;
+
+    /* If msymbol is non-null, then a match was made on something for
+       which only minimal_symbols exist. */
+    struct minimal_symbol *msymbol;
+
+    /* A link to the next match, or NULL for the end. */
+    struct symbol_search *next;
+  };
+
+extern void search_symbols PARAMS ((char *, namespace_enum, int, char **, struct symbol_search **));
+extern void free_search_symbols PARAMS ((struct symbol_search *));
+
 #endif /* !defined(SYMTAB_H) */