import gdb-1999-07-07 post reformat

1 files changed, 212 insertions, 208 deletions

diff --git a/gdb/objfiles.h b/gdb/objfiles.h
index 31bd124d0a6..96890be646d 100644
--- a/gdb/objfiles.h
+++ b/gdb/objfiles.h
@@ -1,21 +1,22 @@
 /* Definitions for symbol file management in GDB.
    Copyright (C) 1992, 1993, 1994, 1995 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., 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, write to the Free Software
+   Foundation, Inc., 59 Temple Place - Suite 330,
+   Boston, MA 02111-1307, USA.  */
 
 #if !defined (OBJFILES_H)
 #define OBJFILES_H
@@ -76,41 +77,41 @@ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
 
    To use this method, define your FRAME_CHAIN_VALID macro like:
 
-	#define FRAME_CHAIN_VALID(chain, thisframe)     \
-	  (chain != 0                                   \
-	   && !(inside_main_func ((thisframe)->pc))     \
-	   && !(inside_entry_func ((thisframe)->pc)))
+   #define FRAME_CHAIN_VALID(chain, thisframe)     \
+   (chain != 0                                   \
+   && !(inside_main_func ((thisframe)->pc))     \
+   && !(inside_entry_func ((thisframe)->pc)))
 
    and add initializations of the four scope controlling variables inside
    the object file / debugging information processing modules.  */
 
 struct entry_info
-{
-  
-  /* The value we should use for this objects entry point.
-     The illegal/unknown value needs to be something other than 0, ~0
-     for instance, which is much less likely than 0. */
+  {
 
-  CORE_ADDR entry_point;
+    /* The value we should use for this objects entry point.
+       The illegal/unknown value needs to be something other than 0, ~0
+       for instance, which is much less likely than 0. */
 
-#define INVALID_ENTRY_POINT (~0) /* ~0 will not be in any file, we hope.  */
+    CORE_ADDR entry_point;
 
-  /* Start (inclusive) and end (exclusive) of function containing the
-     entry point. */
+#define INVALID_ENTRY_POINT (~0)	/* ~0 will not be in any file, we hope.  */
 
-  CORE_ADDR entry_func_lowpc;
-  CORE_ADDR entry_func_highpc;
+    /* Start (inclusive) and end (exclusive) of function containing the
+       entry point. */
 
-  /* Start (inclusive) and end (exclusive) of object file containing the
-     entry point. */
-  
-  CORE_ADDR entry_file_lowpc;
-  CORE_ADDR entry_file_highpc;
+    CORE_ADDR entry_func_lowpc;
+    CORE_ADDR entry_func_highpc;
 
-  /* Start (inclusive) and end (exclusive) of the user code main() function. */
+    /* Start (inclusive) and end (exclusive) of object file containing the
+       entry point. */
 
-  CORE_ADDR main_func_lowpc;
-  CORE_ADDR main_func_highpc;
+    CORE_ADDR entry_file_lowpc;
+    CORE_ADDR entry_file_highpc;
+
+    /* Start (inclusive) and end (exclusive) of the user code main() function. */
+
+    CORE_ADDR main_func_lowpc;
+    CORE_ADDR main_func_highpc;
 
 /* Use these values when any of the above ranges is invalid.  */
 
@@ -121,7 +122,7 @@ struct entry_info
 #define INVALID_ENTRY_LOWPC (3)
 #define INVALID_ENTRY_HIGHPC (1)
 
-};
+  };
 
 /* Sections in an objfile.
 
@@ -136,44 +137,47 @@ struct entry_info
 
    I'm not sure this could or should be changed, however.  */
 
-struct obj_section {
-  CORE_ADDR	addr;	 /* lowest address in section */
-  CORE_ADDR	endaddr; /* 1+highest address in section */
+struct obj_section
+  {
+    CORE_ADDR addr;		/* lowest address in section */
+    CORE_ADDR endaddr;		/* 1+highest address in section */
 
-  /* This field is being used for nefarious purposes by syms_from_objfile.
-     It is said to be redundant with section_offsets; it's not really being
-     used that way, however, it's some sort of hack I don't understand
-     and am not going to try to eliminate (yet, anyway).  FIXME.
+    /* This field is being used for nefarious purposes by syms_from_objfile.
+       It is said to be redundant with section_offsets; it's not really being
+       used that way, however, it's some sort of hack I don't understand
+       and am not going to try to eliminate (yet, anyway).  FIXME.
 
-     It was documented as "offset between (end)addr and actual memory
-     addresses", but that's not true; addr & endaddr are actual memory
-     addresses.  */
-  CORE_ADDR offset;
+       It was documented as "offset between (end)addr and actual memory
+       addresses", but that's not true; addr & endaddr are actual memory
+       addresses.  */
+    CORE_ADDR offset;
 
-  sec_ptr the_bfd_section; /* BFD section pointer */
+    sec_ptr the_bfd_section;	/* BFD section pointer */
 
-  /* Objfile this section is part of.  */
-  struct objfile *objfile;
+    /* Objfile this section is part of.  */
+    struct objfile *objfile;
 
-  /* True if this "overlay section" is mapped into an "overlay region". */
-  int ovly_mapped;
-};
+    /* True if this "overlay section" is mapped into an "overlay region". */
+    int ovly_mapped;
+  };
 
 /* An import entry contains information about a symbol that
    is used in this objfile but not defined in it, and so needs
    to be imported from some other objfile */
-/* Currently we just store the name; no attributes. 1997-08-05 */ 
-typedef char * ImportEntry;
+/* Currently we just store the name; no attributes. 1997-08-05 */
+typedef char *ImportEntry;
 
 
 /* An export entry contains information about a symbol that
    is defined in this objfile and available for use in other
-   objfiles */ 
-typedef struct {
-  char * name; /* name of exported symbol */ 
-  int address; /* offset subject to relocation */ 
-  /* Currently no other attributes 1997-08-05 */ 
-} ExportEntry;
+   objfiles */
+typedef struct
+  {
+    char *name;			/* name of exported symbol */
+    int address;		/* offset subject to relocation */
+    /* Currently no other attributes 1997-08-05 */
+  }
+ExportEntry;
 
 
 /* The "objstats" structure provides a place for gdb to record some
@@ -181,14 +185,15 @@ typedef struct {
    per objfile basis, such as information about the number of symbols
    read, size of string table (if any), etc. */
 
-struct objstats {
-  int n_minsyms;	/* Number of minimal symbols read */
-  int n_psyms;		/* Number of partial symbols read */
-  int n_syms;		/* Number of full symbols read */
-  int n_stabs;		/* Number of ".stabs" read (if applicable) */
-  int n_types;		/* Number of types */
-  int sz_strtab;	/* Size of stringtable, (if applicable) */
-};
+struct objstats
+  {
+    int n_minsyms;		/* Number of minimal symbols read */
+    int n_psyms;		/* Number of partial symbols read */
+    int n_syms;			/* Number of full symbols read */
+    int n_stabs;		/* Number of ".stabs" read (if applicable) */
+    int n_types;		/* Number of types */
+    int sz_strtab;		/* Size of stringtable, (if applicable) */
+  };
 
 #define OBJSTAT(objfile, expr) (objfile -> stats.expr)
 #define OBJSTATS struct objstats stats
@@ -204,195 +209,194 @@ extern void print_symbol_bcache_statistics PARAMS ((void));
    (see remote-vx.c).  */
 
 struct objfile
-{
+  {
 
-  /* All struct objfile's are chained together by their next pointers.
-     The global variable "object_files" points to the first link in this
-     chain.
+    /* All struct objfile's are chained together by their next pointers.
+       The global variable "object_files" points to the first link in this
+       chain.
 
-     FIXME:  There is a problem here if the objfile is reusable, and if
-     multiple users are to be supported.  The problem is that the objfile
-     list is linked through a member of the objfile struct itself, which
-     is only valid for one gdb process.  The list implementation needs to
-     be changed to something like:
+       FIXME:  There is a problem here if the objfile is reusable, and if
+       multiple users are to be supported.  The problem is that the objfile
+       list is linked through a member of the objfile struct itself, which
+       is only valid for one gdb process.  The list implementation needs to
+       be changed to something like:
 
-     struct list {struct list *next; struct objfile *objfile};
+       struct list {struct list *next; struct objfile *objfile};
 
-     where the list structure is completely maintained separately within
-     each gdb process. */
+       where the list structure is completely maintained separately within
+       each gdb process. */
 
-  struct objfile *next;
+    struct objfile *next;
 
-  /* The object file's name.  Malloc'd; free it if you free this struct.  */
+    /* The object file's name.  Malloc'd; free it if you free this struct.  */
 
-  char *name;
+    char *name;
 
-  /* TRUE if this objfile was created because the user explicitly caused
-     it (e.g., used the add-symbol-file command).
+    /* TRUE if this objfile was created because the user explicitly caused
+       it (e.g., used the add-symbol-file command).
      */
-  int  user_loaded;
+    int user_loaded;
 
-  /* TRUE if this objfile was explicitly created to represent a solib.
+    /* TRUE if this objfile was explicitly created to represent a solib.
 
-     (If FALSE, the objfile may actually be a solib.  This can happen if
-     the user created the objfile by using the add-symbol-file command.
-     GDB doesn't in that situation actually check whether the file is a
-     solib.  Rather, the target's implementation of the solib interface
-     is responsible for setting this flag when noticing solibs used by
-     an inferior.)
+       (If FALSE, the objfile may actually be a solib.  This can happen if
+       the user created the objfile by using the add-symbol-file command.
+       GDB doesn't in that situation actually check whether the file is a
+       solib.  Rather, the target's implementation of the solib interface
+       is responsible for setting this flag when noticing solibs used by
+       an inferior.)
      */
-  int  is_solib;
+    int is_solib;
 
-  /* Some flag bits for this objfile. */
+    /* Some flag bits for this objfile. */
 
-  unsigned short flags;
+    unsigned short flags;
 
-  /* Each objfile points to a linked list of symtabs derived from this file,
-     one symtab structure for each compilation unit (source file).  Each link
-     in the symtab list contains a backpointer to this objfile. */
+    /* Each objfile points to a linked list of symtabs derived from this file,
+       one symtab structure for each compilation unit (source file).  Each link
+       in the symtab list contains a backpointer to this objfile. */
 
-  struct symtab *symtabs;
+    struct symtab *symtabs;
 
-  /* Each objfile points to a linked list of partial symtabs derived from
-     this file, one partial symtab structure for each compilation unit
-     (source file). */
+    /* Each objfile points to a linked list of partial symtabs derived from
+       this file, one partial symtab structure for each compilation unit
+       (source file). */
 
-  struct partial_symtab *psymtabs;
+    struct partial_symtab *psymtabs;
 
-  /* List of freed partial symtabs, available for re-use */
+    /* List of freed partial symtabs, available for re-use */
 
-  struct partial_symtab *free_psymtabs;
+    struct partial_symtab *free_psymtabs;
 
-  /* The object file's BFD.  Can be null if the objfile contains only
-     minimal symbols, e.g. the run time common symbols for SunOS4.  */
+    /* The object file's BFD.  Can be null if the objfile contains only
+       minimal symbols, e.g. the run time common symbols for SunOS4.  */
 
-  bfd *obfd;
+    bfd *obfd;
 
-  /* The modification timestamp of the object file, as of the last time
-     we read its symbols.  */
+    /* The modification timestamp of the object file, as of the last time
+       we read its symbols.  */
 
-  long mtime;
+    long mtime;
 
-  /* Obstacks to hold objects that should be freed when we load a new symbol
-     table from this object file. */
+    /* Obstacks to hold objects that should be freed when we load a new symbol
+       table from this object file. */
 
-  struct obstack psymbol_obstack;	/* Partial symbols */
-  struct obstack symbol_obstack;	/* Full symbols */
-  struct obstack type_obstack;		/* Types */
+    struct obstack psymbol_obstack;	/* Partial symbols */
+    struct obstack symbol_obstack;	/* Full symbols */
+    struct obstack type_obstack;	/* Types */
 
-  /* A byte cache where we can stash arbitrary "chunks" of bytes that
-     will not change. */
+    /* A byte cache where we can stash arbitrary "chunks" of bytes that
+       will not change. */
 
-  struct bcache psymbol_cache;		/* Byte cache for partial syms */
+    struct bcache psymbol_cache;	/* Byte cache for partial syms */
 
-  /* Vectors of all partial symbols read in from file.  The actual data
-     is stored in the psymbol_obstack. */
+    /* Vectors of all partial symbols read in from file.  The actual data
+       is stored in the psymbol_obstack. */
 
-  struct psymbol_allocation_list global_psymbols;
-  struct psymbol_allocation_list static_psymbols;
+    struct psymbol_allocation_list global_psymbols;
+    struct psymbol_allocation_list static_psymbols;
 
-  /* Each file contains a pointer to an array of minimal symbols for all
-     global symbols that are defined within the file.  The array is terminated
-     by a "null symbol", one that has a NULL pointer for the name and a zero
-     value for the address.  This makes it easy to walk through the array
-     when passed a pointer to somewhere in the middle of it.  There is also
-     a count of the number of symbols, which does not include the terminating
-     null symbol.  The array itself, as well as all the data that it points
-     to, should be allocated on the symbol_obstack for this file. */
+    /* Each file contains a pointer to an array of minimal symbols for all
+       global symbols that are defined within the file.  The array is terminated
+       by a "null symbol", one that has a NULL pointer for the name and a zero
+       value for the address.  This makes it easy to walk through the array
+       when passed a pointer to somewhere in the middle of it.  There is also
+       a count of the number of symbols, which does not include the terminating
+       null symbol.  The array itself, as well as all the data that it points
+       to, should be allocated on the symbol_obstack for this file. */
 
-  struct minimal_symbol *msymbols;
-  int minimal_symbol_count;
+    struct minimal_symbol *msymbols;
+    int minimal_symbol_count;
 
-  /* For object file formats which don't specify fundamental types, gdb
-     can create such types.  For now, it maintains a vector of pointers
-     to these internally created fundamental types on a per objfile basis,
-     however it really should ultimately keep them on a per-compilation-unit
-     basis, to account for linkage-units that consist of a number of
-     compilation units that may have different fundamental types, such as
-     linking C modules with ADA modules, or linking C modules that are
-     compiled with 32-bit ints with C modules that are compiled with 64-bit
-     ints (not inherently evil with a smarter linker). */
+    /* For object file formats which don't specify fundamental types, gdb
+       can create such types.  For now, it maintains a vector of pointers
+       to these internally created fundamental types on a per objfile basis,
+       however it really should ultimately keep them on a per-compilation-unit
+       basis, to account for linkage-units that consist of a number of
+       compilation units that may have different fundamental types, such as
+       linking C modules with ADA modules, or linking C modules that are
+       compiled with 32-bit ints with C modules that are compiled with 64-bit
+       ints (not inherently evil with a smarter linker). */
 
-  struct type **fundamental_types;
+    struct type **fundamental_types;
 
-  /* The mmalloc() malloc-descriptor for this objfile if we are using
-     the memory mapped malloc() package to manage storage for this objfile's
-     data.  NULL if we are not. */
+    /* The mmalloc() malloc-descriptor for this objfile if we are using
+       the memory mapped malloc() package to manage storage for this objfile's
+       data.  NULL if we are not. */
 
-  PTR md;
+    PTR md;
 
-  /* The file descriptor that was used to obtain the mmalloc descriptor
-     for this objfile.  If we call mmalloc_detach with the malloc descriptor
-     we should then close this file descriptor. */
+    /* The file descriptor that was used to obtain the mmalloc descriptor
+       for this objfile.  If we call mmalloc_detach with the malloc descriptor
+       we should then close this file descriptor. */
 
-  int mmfd;
+    int mmfd;
 
-  /* Structure which keeps track of functions that manipulate objfile's
-     of the same type as this objfile.  I.E. the function to read partial
-     symbols for example.  Note that this structure is in statically
-     allocated memory, and is shared by all objfiles that use the
-     object module reader of this type. */
+    /* Structure which keeps track of functions that manipulate objfile's
+       of the same type as this objfile.  I.E. the function to read partial
+       symbols for example.  Note that this structure is in statically
+       allocated memory, and is shared by all objfiles that use the
+       object module reader of this type. */
 
-  struct sym_fns *sf;
+    struct sym_fns *sf;
 
-  /* The per-objfile information about the entry point, the scope (file/func)
-     containing the entry point, and the scope of the user's main() func. */
+    /* The per-objfile information about the entry point, the scope (file/func)
+       containing the entry point, and the scope of the user's main() func. */
 
-  struct entry_info ei;
+    struct entry_info ei;
 
-  /* Information about stabs.  Will be filled in with a dbx_symfile_info
-     struct by those readers that need it. */
+    /* Information about stabs.  Will be filled in with a dbx_symfile_info
+       struct by those readers that need it. */
 
-  struct dbx_symfile_info *sym_stab_info;
+    struct dbx_symfile_info *sym_stab_info;
 
-  /* Hook for information for use by the symbol reader (currently used
-     for information shared by sym_init and sym_read).  It is
-     typically a pointer to malloc'd memory.  The symbol reader's finish
-     function is responsible for freeing the memory thusly allocated.  */
+    /* Hook for information for use by the symbol reader (currently used
+       for information shared by sym_init and sym_read).  It is
+       typically a pointer to malloc'd memory.  The symbol reader's finish
+       function is responsible for freeing the memory thusly allocated.  */
 
-  PTR sym_private;
+    PTR sym_private;
 
-  /* Hook for target-architecture-specific information.  This must
-     point to memory allocated on one of the obstacks in this objfile,
-     so that it gets freed automatically when reading a new object
-     file. */
+    /* Hook for target-architecture-specific information.  This must
+       point to memory allocated on one of the obstacks in this objfile,
+       so that it gets freed automatically when reading a new object
+       file. */
 
-  PTR obj_private;
+    PTR obj_private;
 
-  /* Set of relocation offsets to apply to each section.
-     Currently on the psymbol_obstack (which makes no sense, but I'm
-     not sure it's harming anything).
+    /* Set of relocation offsets to apply to each section.
+       Currently on the psymbol_obstack (which makes no sense, but I'm
+       not sure it's harming anything).
 
-     These offsets indicate that all symbols (including partial and
-     minimal symbols) which have been read have been relocated by this
-     much.  Symbols which are yet to be read need to be relocated by
-     it.  */
+       These offsets indicate that all symbols (including partial and
+       minimal symbols) which have been read have been relocated by this
+       much.  Symbols which are yet to be read need to be relocated by
+       it.  */
 
-  struct section_offsets *section_offsets;
-  int num_sections;
+    struct section_offsets *section_offsets;
+    int num_sections;
 
-  /* set of section begin and end addresses used to map pc addresses
-     into sections.  Currently on the psymbol_obstack (which makes no
-     sense, but I'm not sure it's harming anything).  */
+    /* set of section begin and end addresses used to map pc addresses
+       into sections.  Currently on the psymbol_obstack (which makes no
+       sense, but I'm not sure it's harming anything).  */
 
-  struct obj_section
-    *sections,
-    *sections_end;
+    struct obj_section
+     *sections, *sections_end;
 
-  /* two auxiliary fields, used to hold the fp of separate symbol files */
-  FILE *auxf1, *auxf2;
+    /* two auxiliary fields, used to hold the fp of separate symbol files */
+    FILE *auxf1, *auxf2;
 
-  /* Imported symbols */
-  ImportEntry * import_list;
-  int import_list_size;
+    /* Imported symbols */
+    ImportEntry *import_list;
+    int import_list_size;
 
-  /* Exported symbols */
-  ExportEntry * export_list;
-  int export_list_size;
+    /* Exported symbols */
+    ExportEntry *export_list;
+    int export_list_size;
 
-  /* Place to stash various statistics about this objfile */
-  OBJSTATS;
-};
+    /* Place to stash various statistics about this objfile */
+      OBJSTATS;
+  };
 
 /* Defines for the objfile flag word. */
 
@@ -421,11 +425,11 @@ struct objfile
    whose setting is determined upon symbol table read in.  */
 
 #define OBJF_REORDERED	(1 << 2)	/* Functions are reordered */
-                       
+
 /* Distinguish between an objfile for a shared library and a
    "vanilla" objfile. */
 
-#define OBJF_SHARED     (1 << 3)        /* From a shared library */
+#define OBJF_SHARED     (1 << 3)	/* From a shared library */
 
 /* The object file that the main symbol table was loaded from (e.g. the
    argument to the "symbol-file" or "file" command).  */
@@ -460,7 +464,7 @@ extern struct objfile *object_files;
 /* Declarations for functions defined in objfiles.c */
 
 extern struct objfile *
-allocate_objfile PARAMS ((bfd *, int, int, int));
+  allocate_objfile PARAMS ((bfd *, int, int, int));
 
 extern int
 build_objfile_section_table PARAMS ((struct objfile *));
@@ -488,7 +492,7 @@ have_full_symbols PARAMS ((void));
 /* This operation deletes all objfile entries that represent solibs that
    weren't explicitly loaded by the user, via e.g., the add-symbol-file
    command.
-   */
+ */
 extern void
 objfile_purge_solibs PARAMS ((void));
 
@@ -499,10 +503,10 @@ extern int
 have_minimal_symbols PARAMS ((void));
 
 extern struct obj_section *
-find_pc_section PARAMS((CORE_ADDR pc));
+  find_pc_section PARAMS ((CORE_ADDR pc));
 
 extern struct obj_section *
-find_pc_sect_section PARAMS((CORE_ADDR pc, asection *section));
+  find_pc_sect_section PARAMS ((CORE_ADDR pc, asection * section));
 
 extern int
 in_plt_section PARAMS ((CORE_ADDR, char *));
@@ -559,4 +563,4 @@ in_plt_section PARAMS ((CORE_ADDR, char *));
   ALL_OBJFILES (objfile)			\
     ALL_OBJFILE_OSECTIONS (objfile, osect)
 
-#endif	/* !defined (OBJFILES_H) */
+#endif /* !defined (OBJFILES_H) */