bfd/
[deliverable/binutils-gdb.git] / bfd / libaout.h
index 38587b32f2de0cab614f8984f542656bc8c6cb13..ef9eae1a9d9d32832b3acdff925c315cceed7143 100644 (file)
@@ -1,24 +1,24 @@
 /* BFD back-end data structures for a.out (and similar) files.
    Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
-   2000, 2001, 2002
+   2000, 2001, 2002, 2003, 2004
    Free Software Foundation, Inc.
    Written by Cygnus Support.
 
-This file is part of BFD, the Binary File Descriptor library.
+   This file is part of BFD, the Binary File Descriptor library.
 
-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.  */
 
 #ifndef LIBAOUT_H
 #define LIBAOUT_H
@@ -29,51 +29,23 @@ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
 
 #include "bfdlink.h"
 
-/* Macros for accessing components in an aout header.  Saves cluttering
-   the source with (bfd_vma) and (bfd_byte *) casts.  */
-
-#define H_PUT_64(abfd, val, where) \
-  bfd_h_put_64 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
-
-#define H_PUT_32(abfd, val, where) \
-  bfd_h_put_32 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
-
-#define H_PUT_16(abfd, val, where) \
-  bfd_h_put_16 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
+/* Macros for accessing components in an aout header.  */
 
+#define H_PUT_64 bfd_h_put_64
+#define H_PUT_32 bfd_h_put_32
+#define H_PUT_16 bfd_h_put_16
 #define H_PUT_8 bfd_h_put_8
-
-#define H_PUT_S64(abfd, val, where) \
-  bfd_h_put_signed_64 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
-
-#define H_PUT_S32(abfd, val, where) \
-  bfd_h_put_signed_32 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
-
-#define H_PUT_S16(abfd, val, where) \
-  bfd_h_put_signed_16 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
-
+#define H_PUT_S64 bfd_h_put_signed_64
+#define H_PUT_S32 bfd_h_put_signed_32
+#define H_PUT_S16 bfd_h_put_signed_16
 #define H_PUT_S8 bfd_h_put_signed_8
-
-#define H_GET_64(abfd, where) \
-  bfd_h_get_64 ((abfd), (bfd_byte *) (where))
-
-#define H_GET_32(abfd, where) \
-  bfd_h_get_32 ((abfd), (bfd_byte *) (where))
-
-#define H_GET_16(abfd, where) \
-  bfd_h_get_16 ((abfd), (bfd_byte *) (where))
-
+#define H_GET_64 bfd_h_get_64
+#define H_GET_32 bfd_h_get_32
+#define H_GET_16 bfd_h_get_16
 #define H_GET_8 bfd_h_get_8
-
-#define H_GET_S64(abfd, where) \
-  bfd_h_get_signed_64 ((abfd), (bfd_byte *) (where))
-
-#define H_GET_S32(abfd, where) \
-  bfd_h_get_signed_32 ((abfd), (bfd_byte *) (where))
-
-#define H_GET_S16(abfd, where) \
-  bfd_h_get_signed_16 ((abfd), (bfd_byte *) (where))
-
+#define H_GET_S64 bfd_h_get_signed_64
+#define H_GET_S32 bfd_h_get_signed_32
+#define H_GET_S16 bfd_h_get_signed_16
 #define H_GET_S8 bfd_h_get_signed_8
 
 /* Parameterize the a.out code based on whether it is being built
@@ -249,73 +221,77 @@ struct aout_backend_data
 
 struct internal_exec
 {
-    long a_info;               /* Magic number and flags, packed */
-    bfd_vma a_text;            /* length of text, in bytes  */
-    bfd_vma a_data;            /* length of data, in bytes  */
-    bfd_vma a_bss;             /* length of uninitialized data area in mem */
-    bfd_vma a_syms;            /* length of symbol table data in file */
-    bfd_vma a_entry;           /* start address */
-    bfd_vma a_trsize;          /* length of text's relocation info, in bytes */
-    bfd_vma a_drsize;          /* length of data's relocation info, in bytes */
-    /* Added for i960 */
-    bfd_vma a_tload;           /* Text runtime load address */
-    bfd_vma a_dload;           /* Data runtime load address */
-    unsigned char a_talign;    /* Alignment of text segment */
-    unsigned char a_dalign;    /* Alignment of data segment */
-    unsigned char a_balign;    /* Alignment of bss segment */
-    char a_relaxable;           /* Enough info for linker relax */
+  long a_info;                 /* Magic number and flags, packed.  */
+  bfd_vma a_text;              /* Length of text, in bytes.  */
+  bfd_vma a_data;              /* Length of data, in bytes.  */
+  bfd_vma a_bss;               /* Length of uninitialized data area in mem.  */
+  bfd_vma a_syms;              /* Length of symbol table data in file.  */
+  bfd_vma a_entry;             /* Start address.  */
+  bfd_vma a_trsize;            /* Length of text's relocation info, in bytes.  */
+  bfd_vma a_drsize;            /* Length of data's relocation info, in bytes.  */
+  /* Added for i960 */
+  bfd_vma a_tload;             /* Text runtime load address.  */
+  bfd_vma a_dload;             /* Data runtime load address.  */
+  unsigned char a_talign;      /* Alignment of text segment.  */
+  unsigned char a_dalign;      /* Alignment of data segment.  */
+  unsigned char a_balign;      /* Alignment of bss segment.  */
+  char a_relaxable;            /* Enough info for linker relax.  */
 };
 
 /* Magic number is written
-< MSB          >
-3130292827262524232221201918171615141312111009080706050403020100
-< FLAGS        >< MACHINE TYPE ><  MAGIC NUMBER                >
-*/
+   < MSB          >
+   3130292827262524232221201918171615141312111009080706050403020100
+   < FLAGS        >< MACHINE TYPE ><  MAGIC NUMBER                >  */
+
 /* Magic number for NetBSD is
-<MSB           >
-3130292827262524232221201918171615141312111009080706050403020100
-< FLAGS    >< MACHINE TYPE     ><  MAGIC NUMBER                >
-*/
+   <MSB           >
+   3130292827262524232221201918171615141312111009080706050403020100
+   < FLAGS    >< MACHINE TYPE     ><  MAGIC NUMBER                >  */
 
-enum machine_type {
+enum machine_type
+{
   M_UNKNOWN = 0,
   M_68010 = 1,
   M_68020 = 2,
   M_SPARC = 3,
-  /* skip a bunch so we don't run into any of suns numbers */
-  /* make these up for the ns32k*/
-  M_NS32032 = (64),            /* ns32032 running ? */
-  M_NS32532 = (64 + 5),                /* ns32532 running mach */
-
+  /* Skip a bunch so we don't run into any of SUN's numbers.  */
+  /* Make these up for the ns32k.  */
+  M_NS32032 = (64),      /* NS32032 running ?  */
+  M_NS32532 = (64 + 5),          /* NS32532 running mach.  */
   M_386 = 100,
-  M_29K = 101,          /* AMD 29000 */
-  M_386_DYNIX = 102,   /* Sequent running dynix */
-  M_ARM = 103,         /* Advanced Risc Machines ARM */
-  M_SPARCLET = 131,    /* SPARClet = M_SPARC + 128 */
-  M_386_NETBSD = 134,  /* NetBSD/i386 binary */
-  M_68K_NETBSD = 135,  /* NetBSD/m68k binary */
-  M_68K4K_NETBSD = 136,        /* NetBSD/m68k4k binary */
-  M_532_NETBSD = 137,  /* NetBSD/ns32k binary */
-  M_SPARC_NETBSD = 138,        /* NetBSD/sparc binary */
-  M_PMAX_NETBSD = 139, /* NetBSD/pmax (MIPS little-endian) binary */
-  M_VAX_NETBSD = 140,  /* NetBSD/vax binary */
-  M_ALPHA_NETBSD = 141,        /* NetBSD/alpha binary */
-  M_ARM6_NETBSD = 143, /* NetBSD/arm32 binary */
-  M_SPARCLET_1 = 147,  /* 0x93, reserved */
-  M_VAX4K_NETBSD = 150,        /* NetBSD/vax 4K pages binary */
-  M_MIPS1 = 151,        /* MIPS R2000/R3000 binary */
-  M_MIPS2 = 152,        /* MIPS R4000/R6000 binary */
-  M_SPARCLET_2 = 163,  /* 0xa3, reserved */
-  M_SPARCLET_3 = 179,  /* 0xb3, reserved */
-  M_SPARCLET_4 = 195,  /* 0xc3, reserved */
-  M_HP200 = 200,       /* HP 200 (68010) BSD binary */
-  M_HP300 = (300 % 256), /* HP 300 (68020+68881) BSD binary */
-  M_HPUX = (0x20c % 256), /* HP 200/300 HPUX binary */
-  M_SPARCLET_5 = 211,  /* 0xd3, reserved */
-  M_SPARCLET_6 = 227,  /* 0xe3, reserved */
-  /*  M_SPARCLET_7 = 243       / * 0xf3, reserved */
+  M_29K = 101,            /* AMD 29000.  */
+  M_386_DYNIX = 102,     /* Sequent running dynix.  */
+  M_ARM = 103,           /* Advanced Risc Machines ARM.  */
+  M_SPARCLET = 131,      /* SPARClet = M_SPARC + 128.  */
+  M_386_NETBSD = 134,    /* NetBSD/i386 binary.  */
+  M_68K_NETBSD = 135,    /* NetBSD/m68k binary.  */
+  M_68K4K_NETBSD = 136,          /* NetBSD/m68k4k binary.  */
+  M_532_NETBSD = 137,    /* NetBSD/ns32k binary.  */
+  M_SPARC_NETBSD = 138,          /* NetBSD/sparc binary.  */
+  M_PMAX_NETBSD = 139,   /* NetBSD/pmax (MIPS little-endian) binary.  */
+  M_VAX_NETBSD = 140,    /* NetBSD/vax binary.  */
+  M_ALPHA_NETBSD = 141,          /* NetBSD/alpha binary.  */
+  M_ARM6_NETBSD = 143,   /* NetBSD/arm32 binary.  */
+  M_SPARCLET_1 = 147,    /* 0x93, reserved.  */
+  M_POWERPC_NETBSD = 149, /* NetBSD/powerpc (big-endian) binary.  */
+  M_VAX4K_NETBSD = 150,          /* NetBSD/vax 4K pages binary.  */
+  M_MIPS1 = 151,          /* MIPS R2000/R3000 binary.  */
+  M_MIPS2 = 152,          /* MIPS R4000/R6000 binary.  */
+  M_88K_OPENBSD = 153,   /* OpenBSD/m88k binary.  */
+  M_HPPA_OPENBSD = 154,          /* OpenBSD/hppa binary.  */
+  M_SPARC64_NETBSD = 156, /* NetBSD/sparc64 binary.  */
+  M_X86_64_NETBSD = 157,  /* NetBSD/amd64 binary.  */
+  M_SPARCLET_2 = 163,    /* 0xa3, reserved.  */
+  M_SPARCLET_3 = 179,    /* 0xb3, reserved.  */
+  M_SPARCLET_4 = 195,    /* 0xc3, reserved.  */
+  M_HP200 = 200,         /* HP 200 (68010) BSD binary.  */
+  M_HP300 = (300 % 256),  /* HP 300 (68020+68881) BSD binary.  */
+  M_HPUX = (0x20c % 256), /* HP 200/300 HPUX binary.  */
+  M_SPARCLET_5 = 211,    /* 0xd3, reserved.  */
+  M_SPARCLET_6 = 227,    /* 0xe3, reserved.  */
+/*M_SPARCLET_7 = 243    / * 0xf3, reserved.  */
   M_SPARCLITE_LE = 243,
-  M_CRIS = 255         /* Axis CRIS binary.  */
+  M_CRIS = 255           /* Axis CRIS binary.  */
 };
 
 #define N_DYNAMIC(exec) ((exec).a_info & 0x80000000)
@@ -362,7 +338,8 @@ enum machine_type {
  ((exec).a_info&0x00ffffff) | (((flags) & 0xff) << 24))
 #endif
 
-typedef struct aout_symbol {
+typedef struct aout_symbol
+{
   asymbol symbol;
   short desc;
   char other;
@@ -373,11 +350,12 @@ typedef struct aout_symbol {
    Various things depend on this struct being around any time an a.out
    file is being handled.  An example is dbxread.c in GDB.  */
 
-struct aoutdata {
-  struct internal_exec *hdr;           /* exec file header */
-  aout_symbol_type *symbols;           /* symtab for input bfd */
+struct aoutdata
+{
+  struct internal_exec *hdr;           /* Exec file header.  */
+  aout_symbol_type *symbols;           /* Symtab for input bfd.  */
 
-  /* For ease, we do this */
+  /* For ease, we do this */
   asection *textsec;
   asection *datasec;
   asection *bsssec;
@@ -387,16 +365,16 @@ struct aoutdata {
   file_ptr sym_filepos;
   file_ptr str_filepos;
 
-  /* Size of a relocation entry in external form */
+  /* Size of a relocation entry in external form */
   unsigned reloc_entry_size;
 
-  /* Size of a symbol table entry in external form */
+  /* Size of a symbol table entry in external form */
   unsigned symbol_entry_size;
 
-  /* Page size - needed for alignment of demand paged files. */
+  /* Page size - needed for alignment of demand paged files.  */
   unsigned long page_size;
 
-  /* Segment size - needed for alignment of demand paged files. */
+  /* Segment size - needed for alignment of demand paged files.  */
   unsigned long segment_size;
 
   /* Zmagic disk block size - need to align the start of the text
@@ -406,7 +384,7 @@ struct aoutdata {
   unsigned exec_bytes_size;
   unsigned vma_adjusted : 1;
 
-  /* used when a bfd supports several highly similar formats */
+  /* Used when a bfd supports several highly similar formats.  */
   enum
     {
       default_format = 0,
@@ -445,33 +423,34 @@ struct aoutdata {
   bfd_vma *local_got_offsets;
 };
 
-struct  aout_data_struct {
-    struct aoutdata a;
-    struct internal_exec e;
+struct  aout_data_struct
+{
+  struct aoutdata a;
+  struct internal_exec e;
 };
 
-#define        adata(bfd)              ((bfd)->tdata.aout_data->a)
-#define        exec_hdr(bfd)           (adata(bfd).hdr)
-#define        obj_aout_symbols(bfd)   (adata(bfd).symbols)
-#define        obj_textsec(bfd)        (adata(bfd).textsec)
-#define        obj_datasec(bfd)        (adata(bfd).datasec)
-#define        obj_bsssec(bfd)         (adata(bfd).bsssec)
-#define        obj_sym_filepos(bfd)    (adata(bfd).sym_filepos)
-#define        obj_str_filepos(bfd)    (adata(bfd).str_filepos)
-#define        obj_reloc_entry_size(bfd) (adata(bfd).reloc_entry_size)
-#define        obj_symbol_entry_size(bfd) (adata(bfd).symbol_entry_size)
-#define obj_aout_subformat(bfd)        (adata(bfd).subformat)
-#define obj_aout_external_syms(bfd) (adata(bfd).external_syms)
-#define obj_aout_external_sym_count(bfd) (adata(bfd).external_sym_count)
-#define obj_aout_sym_window(bfd) (adata(bfd).sym_window)
-#define obj_aout_external_strings(bfd) (adata(bfd).external_strings)
-#define obj_aout_external_string_size(bfd) (adata(bfd).external_string_size)
-#define obj_aout_string_window(bfd) (adata(bfd).string_window)
-#define obj_aout_sym_hashes(bfd) (adata(bfd).sym_hashes)
-#define obj_aout_dynamic_info(bfd) (adata(bfd).dynamic_info)
+#define        adata(bfd)                         ((bfd)->tdata.aout_data->a)
+#define        exec_hdr(bfd)                      (adata (bfd).hdr)
+#define        obj_aout_symbols(bfd)              (adata (bfd).symbols)
+#define        obj_textsec(bfd)                   (adata (bfd).textsec)
+#define        obj_datasec(bfd)                   (adata (bfd).datasec)
+#define        obj_bsssec(bfd)                    (adata (bfd).bsssec)
+#define        obj_sym_filepos(bfd)               (adata (bfd).sym_filepos)
+#define        obj_str_filepos(bfd)               (adata (bfd).str_filepos)
+#define        obj_reloc_entry_size(bfd)          (adata (bfd).reloc_entry_size)
+#define        obj_symbol_entry_size(bfd)         (adata (bfd).symbol_entry_size)
+#define obj_aout_subformat(bfd)                   (adata (bfd).subformat)
+#define obj_aout_external_syms(bfd)        (adata (bfd).external_syms)
+#define obj_aout_external_sym_count(bfd)   (adata (bfd).external_sym_count)
+#define obj_aout_sym_window(bfd)           (adata (bfd).sym_window)
+#define obj_aout_external_strings(bfd)     (adata (bfd).external_strings)
+#define obj_aout_external_string_size(bfd) (adata (bfd).external_string_size)
+#define obj_aout_string_window(bfd)        (adata (bfd).string_window)
+#define obj_aout_sym_hashes(bfd)           (adata (bfd).sym_hashes)
+#define obj_aout_dynamic_info(bfd)         (adata (bfd).dynamic_info)
 
 /* We take the address of the first element of an asymbol to ensure that the
-   macro is only ever applied to an asymbol */
+   macro is only ever applied to an asymbol */
 #define aout_symbol(asymbol) ((aout_symbol_type *)(&(asymbol)->the_bfd))
 
 /* Information we keep for each a.out section.  This is currently only
@@ -489,7 +468,7 @@ struct aout_section_data_struct
 #define set_aout_section_data(s,v) \
   ((s)->used_by_bfd = (PTR)&(v)->relocs)
 
-/* Prototype declarations for functions defined in aoutx.h  */
+/* Prototype declarations for functions defined in aoutx.h.  */
 
 extern bfd_boolean NAME(aout,squirt_out_relocs)
   PARAMS ((bfd *, asection *));
@@ -513,7 +492,7 @@ extern bfd_boolean NAME(aout,new_section_hook)
   PARAMS ((bfd *, asection *));
 
 extern bfd_boolean NAME(aout,set_section_contents)
-  PARAMS ((bfd *, sec_ptr, PTR, file_ptr, bfd_size_type));
+  PARAMS ((bfd *, sec_ptr, const PTR, file_ptr, bfd_size_type));
 
 extern asymbol * NAME(aout,make_empty_symbol)
   PARAMS ((bfd *));
@@ -534,7 +513,7 @@ extern void NAME(aout,reclaim_symbol_table)
 extern long NAME(aout,get_symtab_upper_bound)
   PARAMS ((bfd *));
 
-extern long NAME(aout,get_symtab)
+extern long NAME(aout,canonicalize_symtab)
   PARAMS ((bfd *, asymbol **));
 
 extern void NAME(aout,swap_ext_reloc_in)
@@ -612,7 +591,7 @@ extern bfd_boolean NAME(aout,final_link)
 extern bfd_boolean NAME(aout,bfd_free_cached_info)
   PARAMS ((bfd *));
 
-/* A.out uses the generic versions of these routines... */
+/* A.out uses the generic versions of these routines...  */
 
 #define        aout_16_get_section_contents    _bfd_generic_get_section_contents
 
@@ -627,10 +606,15 @@ extern bfd_boolean NAME(aout,bfd_free_cached_info)
 #define aout_32_bfd_is_local_label_name bfd_generic_is_local_label_name
 #endif
 
+#ifndef aout_32_bfd_is_target_special_symbol
+#define aout_32_bfd_is_target_special_symbol \
+  ((bfd_boolean (*) (bfd *, asymbol *)) bfd_false)
+#endif
+
 #ifndef WRITE_HEADERS
 #define WRITE_HEADERS(abfd, execp)                                           \
       {                                                                              \
-       bfd_size_type text_size; /* dummy vars */                             \
+       bfd_size_type text_size; /* Dummy vars.  */                           \
        file_ptr text_end;                                                    \
        if (adata(abfd).magic == undecided_magic)                             \
          NAME(aout,adjust_sizes_and_vmas) (abfd, &text_size, &text_end);     \
@@ -645,10 +629,10 @@ extern bfd_boolean NAME(aout,bfd_free_cached_info)
        NAME(aout,swap_exec_header_out) (abfd, execp, &exec_bytes);           \
                                                                              \
        if (bfd_seek (abfd, (file_ptr) 0, SEEK_SET) != 0                      \
-           || bfd_bwrite ((PTR) &exec_bytes, (bfd_size_type) EXEC_BYTES_SIZE, \
+           || bfd_bwrite ((PTR) &exec_bytes, (bfd_size_type) EXEC_BYTES_SIZE,\
                          abfd) != EXEC_BYTES_SIZE)                           \
          return FALSE;                                                       \
-       /* Now write out reloc info, followed by syms and strings */          \
+       /* Now write out reloc info, followed by syms and strings.  */        \
                                                                              \
        if (bfd_get_outsymbols (abfd) != (asymbol **) NULL                    \
            && bfd_get_symcount (abfd) != 0)                                  \
@@ -660,16 +644,35 @@ extern bfd_boolean NAME(aout,bfd_free_cached_info)
              return FALSE;                                                   \
          }                                                                   \
                                                                              \
-       if (bfd_seek (abfd, (file_ptr) (N_TRELOFF(*execp)), SEEK_SET) != 0)   \
+       if (bfd_seek (abfd, (file_ptr) (N_TRELOFF (*execp)), SEEK_SET) != 0)  \
          return FALSE;                                                       \
        if (!NAME(aout,squirt_out_relocs) (abfd, obj_textsec (abfd)))         \
          return FALSE;                                                       \
                                                                              \
-       if (bfd_seek (abfd, (file_ptr) (N_DRELOFF(*execp)), SEEK_SET) != 0)   \
+       if (bfd_seek (abfd, (file_ptr) (N_DRELOFF (*execp)), SEEK_SET) != 0)  \
          return FALSE;                                                       \
        if (!NAME(aout,squirt_out_relocs) (abfd, obj_datasec (abfd)))         \
          return FALSE;                                                       \
       }
 #endif
 
+/* Test if a read-only section can be merged with .text.  This is
+   possible if:
+
+   1. Section has file contents and is read-only.
+   2. The VMA of the section is after the end of .text and before
+      the start of .data.
+   3. The image is demand-pageable (otherwise, a_text in the header
+      will not reflect the gap between .text and .data).  */
+
+#define aout_section_merge_with_text_p(abfd, sec)                      \
+  (((sec)->flags & (SEC_HAS_CONTENTS | SEC_READONLY)) ==               \
+      (SEC_HAS_CONTENTS | SEC_READONLY)                                        \
+   && obj_textsec (abfd) != NULL                                       \
+   && obj_datasec (abfd) != NULL                                       \
+   && (sec)->vma >= (obj_textsec (abfd)->vma +                         \
+                    obj_textsec (abfd)->size)                          \
+   && ((sec)->vma + (sec)->size) <= obj_datasec (abfd)->vma            \
+   && ((abfd)->flags & D_PAGED) != 0)
+
 #endif /* ! defined (LIBAOUT_H) */
This page took 0.032732 seconds and 4 git commands to generate.