bfd/elf-bfd.h

   1 /* BFD back-end data structures for ELF files.
   2    Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
   3    Written by Cygnus Support.
   4
   5 This file is part of BFD, the Binary File Descriptor library.
   6
   7 This program is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2 of the License, or
  10 (at your option) any later version.
  11
  12 This program is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with this program; if not, write to the Free Software
  19 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  20
  21 #ifndef _LIBELF_H_
  22 #define _LIBELF_H_ 1
  23
  24 #include "elf/common.h"
  25 #include "elf/internal.h"
  26 #include "elf/external.h"
  27 #include "bfdlink.h"
  28
  29 /* If size isn't specified as 64 or 32, NAME macro should fail.  */
  30 #ifndef NAME
  31 #if ARCH_SIZE==64
  32 #define NAME(x,y) CAT4(x,64,_,y)
  33 #endif
  34 #if ARCH_SIZE==32
  35 #define NAME(x,y) CAT4(x,32,_,y)
  36 #endif
  37 #endif
  38
  39 #ifndef NAME
  40 #define NAME(x,y) CAT4(x,NOSIZE,_,y)
  41 #endif
  42
  43 #define ElfNAME(X)      NAME(Elf,X)
  44 #define elfNAME(X)      NAME(elf,X)
  45
  46 /* Information held for an ELF symbol.  The first field is the
  47    corresponding asymbol.  Every symbol is an ELF file is actually a
  48    pointer to this structure, although it is often handled as a
  49    pointer to an asymbol.  */
  50
  51 typedef struct
  52 {
  53   /* The BFD symbol.  */
  54   asymbol symbol;
  55   /* ELF symbol information.  */
  56   Elf_Internal_Sym internal_elf_sym;
  57   /* Backend specific information.  */
  58   union
  59     {
  60       unsigned int hppa_arg_reloc;
  61       PTR mips_extr;
  62       PTR any;
  63     }
  64   tc_data;
  65 } elf_symbol_type;
  66 \f
  67 /* ELF linker hash table entries.  */
  68
  69 struct elf_link_hash_entry
  70 {
  71   struct bfd_link_hash_entry root;
  72
  73   /* Symbol index in output file.  This is initialized to -1.  It is
  74      set to -2 if the symbol is used by a reloc.  */
  75   long indx;
  76
  77   /* Symbol size.  */
  78   bfd_size_type size;
  79
  80   /* Symbol index as a dynamic symbol.  Initialized to -1, and remains
  81      -1 if this is not a dynamic symbol.  */
  82   long dynindx;
  83
  84   /* String table index in .dynstr if this is a dynamic symbol.  */
  85   unsigned long dynstr_index;
  86
  87   /* If this is a weak defined symbol from a dynamic object, this
  88      field points to a defined symbol with the same value, if there is
  89      one.  Otherwise it is NULL.  */
  90   struct elf_link_hash_entry *weakdef;
  91
  92   /* If this symbol requires an entry in the global offset table, the
  93      processor specific backend uses this field to hold the offset
  94      into the .got section.  If this field is -1, then the symbol does
  95      not require a global offset table entry.  */
  96   bfd_vma got_offset;
  97
  98   /* If this symbol requires an entry in the procedure linkage table,
  99      the processor specific backend uses these two fields to hold the
 100      offset into the procedure linkage section and the offset into the
 101      .got section.  If plt_offset is -1, then the symbol does not
 102      require an entry in the procedure linkage table.  */
 103   bfd_vma plt_offset;
 104
 105   /* If this symbol is used in the linker created sections, the processor
 106      specific backend uses this field to map the field into the offset
 107      from the beginning of the section.  */
 108   struct elf_linker_section_pointers *linker_section_pointer;
 109
 110   /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.).  */
 111   char type;
 112
 113   /* Some flags; legal values follow.  */
 114   unsigned char elf_link_hash_flags;
 115   /* Symbol is referenced by a non-shared object.  */
 116 #define ELF_LINK_HASH_REF_REGULAR 01
 117   /* Symbol is defined by a non-shared object.  */
 118 #define ELF_LINK_HASH_DEF_REGULAR 02
 119   /* Symbol is referenced by a shared object.  */
 120 #define ELF_LINK_HASH_REF_DYNAMIC 04
 121   /* Symbol is defined by a shared object.  */
 122 #define ELF_LINK_HASH_DEF_DYNAMIC 010
 123   /* Dynamic symbol has been adjustd.  */
 124 #define ELF_LINK_HASH_DYNAMIC_ADJUSTED 020
 125   /* Symbol needs a copy reloc.  */
 126 #define ELF_LINK_HASH_NEEDS_COPY 040
 127   /* Symbol needs a procedure linkage table entry.  */
 128 #define ELF_LINK_HASH_NEEDS_PLT 0100
 129   /* Symbol appears in a non-ELF input file.  */
 130 #define ELF_LINK_NON_ELF 0200
 131   /* Note: If you add more flags, you must change the type of
 132      elf_link_hash_flags.  */
 133 };
 134
 135 /* ELF linker hash table.  */
 136
 137 struct elf_link_hash_table
 138 {
 139   struct bfd_link_hash_table root;
 140   /* Whether we have created the special dynamic sections required
 141      when linking against or generating a shared object.  */
 142   boolean dynamic_sections_created;
 143   /* The BFD used to hold special sections created by the linker.
 144      This will be the first BFD found which requires these sections to
 145      be created.  */
 146   bfd *dynobj;
 147   /* The number of symbols found in the link which must be put into
 148      the .dynsym section.  */
 149   bfd_size_type dynsymcount;
 150   /* The string table of dynamic symbols, which becomes the .dynstr
 151      section.  */
 152   struct bfd_strtab_hash *dynstr;
 153   /* The number of buckets in the hash table in the .hash section.
 154      This is based on the number of dynamic symbols.  */
 155   bfd_size_type bucketcount;
 156   /* A linked list of DT_NEEDED names found in dynamic objects
 157      included in the link.  */
 158   struct bfd_link_needed_list *needed;
 159   /* The _GLOBAL_OFFSET_TABLE_ symbol.  */
 160   struct elf_link_hash_entry *hgot;
 161 };
 162
 163 /* Look up an entry in an ELF linker hash table.  */
 164
 165 #define elf_link_hash_lookup(table, string, create, copy, follow)       \
 166   ((struct elf_link_hash_entry *)                                       \
 167    bfd_link_hash_lookup (&(table)->root, (string), (create),            \
 168                          (copy), (follow)))
 169
 170 /* Traverse an ELF linker hash table.  */
 171
 172 #define elf_link_hash_traverse(table, func, info)                       \
 173   (bfd_link_hash_traverse                                               \
 174    (&(table)->root,                                                     \
 175     (boolean (*) PARAMS ((struct bfd_link_hash_entry *, PTR))) (func),  \
 176     (info)))
 177
 178 /* Get the ELF linker hash table from a link_info structure.  */
 179
 180 #define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash))
 181 \f
 182 /* Constant information held for an ELF backend.  */
 183
 184 struct elf_size_info {
 185   unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
 186   unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
 187
 188   unsigned char arch_size, file_align;
 189   unsigned char elfclass, ev_current;
 190   int (*write_out_phdrs) PARAMS ((bfd *, Elf_Internal_Phdr *, int));
 191   boolean (*write_shdrs_and_ehdr) PARAMS ((bfd *));
 192   void (*write_relocs) PARAMS ((bfd *, asection *, PTR));
 193   void (*swap_symbol_out) PARAMS ((bfd *, Elf_Internal_Sym *, PTR));
 194   boolean (*slurp_reloc_table) PARAMS ((bfd *, asection *, asymbol **));
 195   long (*slurp_symbol_table) PARAMS ((bfd *, asymbol **, boolean));
 196   void (*swap_dyn_in) PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
 197 };
 198
 199 #define elf_symbol_from(ABFD,S) \
 200         (((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
 201           && (S)->the_bfd->tdata.elf_obj_data != 0) \
 202          ? (elf_symbol_type *) (S) \
 203          : 0)
 204
 205 struct elf_backend_data
 206 {
 207   /* Whether the backend uses REL or RELA relocations.  FIXME: some
 208      ELF backends use both.  When we need to support one, this whole
 209      approach will need to be changed.  */
 210   int use_rela_p;
 211
 212   /* The architecture for this backend.  */
 213   enum bfd_architecture arch;
 214
 215   /* The ELF machine code (EM_xxxx) for this backend.  */
 216   int elf_machine_code;
 217
 218   /* The maximum page size for this backend.  */
 219   bfd_vma maxpagesize;
 220
 221   /* This is true if the linker should act like collect and gather
 222      global constructors and destructors by name.  This is true for
 223      MIPS ELF because the Irix 5 tools can not handle the .init
 224      section.  */
 225   boolean collect;
 226
 227   /* This is true if the linker should ignore changes to the type of a
 228      symbol.  This is true for MIPS ELF because some Irix 5 objects
 229      record undefined functions as STT_OBJECT although the definitions
 230      are STT_FUNC.  */
 231   boolean type_change_ok;
 232
 233   /* A function to translate an ELF RELA relocation to a BFD arelent
 234      structure.  */
 235   void (*elf_info_to_howto) PARAMS ((bfd *, arelent *,
 236                                      Elf_Internal_Rela *));
 237
 238   /* A function to translate an ELF REL relocation to a BFD arelent
 239      structure.  */
 240   void (*elf_info_to_howto_rel) PARAMS ((bfd *, arelent *,
 241                                          Elf_Internal_Rel *));
 242
 243   /* A function to determine whether a symbol is global when
 244      partitioning the symbol table into local and global symbols.
 245      This should be NULL for most targets, in which case the correct
 246      thing will be done.  MIPS ELF, at least on the Irix 5, has
 247      special requirements.  */
 248   boolean (*elf_backend_sym_is_global) PARAMS ((bfd *, asymbol *));
 249
 250   /* The remaining functions are hooks which are called only if they
 251      are not NULL.  */
 252
 253   /* A function to permit a backend specific check on whether a
 254      particular BFD format is relevant for an object file, and to
 255      permit the backend to set any global information it wishes.  When
 256      this is called elf_elfheader is set, but anything else should be
 257      used with caution.  If this returns false, the check_format
 258      routine will return a bfd_error_wrong_format error.  */
 259   boolean (*elf_backend_object_p) PARAMS ((bfd *));
 260
 261   /* A function to do additional symbol processing when reading the
 262      ELF symbol table.  This is where any processor-specific special
 263      section indices are handled.  */
 264   void (*elf_backend_symbol_processing) PARAMS ((bfd *, asymbol *));
 265
 266   /* A function to do additional symbol processing after reading the
 267      entire ELF symbol table.  */
 268   boolean (*elf_backend_symbol_table_processing) PARAMS ((bfd *,
 269                                                           elf_symbol_type *,
 270                                                           unsigned int));
 271
 272   /* A function to do additional processing on the ELF section header
 273      just before writing it out.  This is used to set the flags and
 274      type fields for some sections, or to actually write out data for
 275      unusual sections.  */
 276   boolean (*elf_backend_section_processing) PARAMS ((bfd *,
 277                                                      Elf32_Internal_Shdr *));
 278
 279   /* A function to handle unusual section types when creating BFD
 280      sections from ELF sections.  */
 281   boolean (*elf_backend_section_from_shdr) PARAMS ((bfd *,
 282                                                     Elf32_Internal_Shdr *,
 283                                                     char *));
 284
 285   /* A function to set up the ELF section header for a BFD section in
 286      preparation for writing it out.  This is where the flags and type
 287      fields are set for unusual sections.  */
 288   boolean (*elf_backend_fake_sections) PARAMS ((bfd *, Elf32_Internal_Shdr *,
 289                                                 asection *));
 290
 291   /* A function to get the ELF section index for a BFD section.  If
 292      this returns true, the section was found.  If it is a normal ELF
 293      section, *RETVAL should be left unchanged.  If it is not a normal
 294      ELF section *RETVAL should be set to the SHN_xxxx index.  */
 295   boolean (*elf_backend_section_from_bfd_section)
 296     PARAMS ((bfd *, Elf32_Internal_Shdr *, asection *, int *retval));
 297
 298   /* If this field is not NULL, it is called by the add_symbols phase
 299      of a link just before adding a symbol to the global linker hash
 300      table.  It may modify any of the fields as it wishes.  If *NAME
 301      is set to NULL, the symbol will be skipped rather than being
 302      added to the hash table.  This function is responsible for
 303      handling all processor dependent symbol bindings and section
 304      indices, and must set at least *FLAGS and *SEC for each processor
 305      dependent case; failure to do so will cause a link error.  */
 306   boolean (*elf_add_symbol_hook)
 307     PARAMS ((bfd *abfd, struct bfd_link_info *info,
 308              const Elf_Internal_Sym *, const char **name,
 309              flagword *flags, asection **sec, bfd_vma *value));
 310
 311   /* If this field is not NULL, it is called by the elf_link_output_sym
 312      phase of a link for each symbol which will appear in the object file.  */
 313   boolean (*elf_backend_link_output_symbol_hook)
 314     PARAMS ((bfd *, struct bfd_link_info *info, const char *,
 315              Elf_Internal_Sym *, asection *));
 316
 317   /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
 318      linker the first time it encounters a dynamic object in the link.
 319      This function must create any sections required for dynamic
 320      linking.  The ABFD argument is a dynamic object.  The .interp,
 321      .dynamic, .dynsym, .dynstr, and .hash functions have already been
 322      created, and this function may modify the section flags if
 323      desired.  This function will normally create the .got and .plt
 324      sections, but different backends have different requirements.  */
 325   boolean (*elf_backend_create_dynamic_sections)
 326     PARAMS ((bfd *abfd, struct bfd_link_info *info));
 327
 328   /* The CHECK_RELOCS function is called by the add_symbols phase of
 329      the ELF backend linker.  It is called once for each section with
 330      relocs of an object file, just after the symbols for the object
 331      file have been added to the global linker hash table.  The
 332      function must look through the relocs and do any special handling
 333      required.  This generally means allocating space in the global
 334      offset table, and perhaps allocating space for a reloc.  The
 335      relocs are always passed as Rela structures; if the section
 336      actually uses Rel structures, the r_addend field will always be
 337      zero.  */
 338   boolean (*check_relocs)
 339     PARAMS ((bfd *abfd, struct bfd_link_info *info, asection *o,
 340              const Elf_Internal_Rela *relocs));
 341
 342   /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
 343      linker for every symbol which is defined by a dynamic object and
 344      referenced by a regular object.  This is called after all the
 345      input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
 346      function has been called.  The hash table entry should be
 347      bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
 348      defined in a section from a dynamic object.  Dynamic object
 349      sections are not included in the final link, and this function is
 350      responsible for changing the value to something which the rest of
 351      the link can deal with.  This will normally involve adding an
 352      entry to the .plt or .got or some such section, and setting the
 353      symbol to point to that.  */
 354   boolean (*elf_backend_adjust_dynamic_symbol)
 355     PARAMS ((struct bfd_link_info *info, struct elf_link_hash_entry *h));
 356
 357   /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
 358      linker after all the linker input files have been seen but before
 359      the sections sizes have been set.  This is called after
 360      ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
 361      It is only called when linking against a dynamic object.  It must
 362      set the sizes of the dynamic sections, and may fill in their
 363      contents as well.  The generic ELF linker can handle the .dynsym,
 364      .dynstr and .hash sections.  This function must handle the
 365      .interp section and any sections created by the
 366      CREATE_DYNAMIC_SECTIONS entry point.  */
 367   boolean (*elf_backend_size_dynamic_sections)
 368     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
 369
 370   /* The RELOCATE_SECTION function is called by the ELF backend linker
 371      to handle the relocations for a section.
 372
 373      The relocs are always passed as Rela structures; if the section
 374      actually uses Rel structures, the r_addend field will always be
 375      zero.
 376
 377      This function is responsible for adjust the section contents as
 378      necessary, and (if using Rela relocs and generating a
 379      relocateable output file) adjusting the reloc addend as
 380      necessary.
 381
 382      This function does not have to worry about setting the reloc
 383      address or the reloc symbol index.
 384
 385      LOCAL_SYMS is a pointer to the swapped in local symbols.
 386
 387      LOCAL_SECTIONS is an array giving the section in the input file
 388      corresponding to the st_shndx field of each local symbol.
 389
 390      The global hash table entry for the global symbols can be found
 391      via elf_sym_hashes (input_bfd).
 392
 393      When generating relocateable output, this function must handle
 394      STB_LOCAL/STT_SECTION symbols specially.  The output symbol is
 395      going to be the section symbol corresponding to the output
 396      section, which means that the addend must be adjusted
 397      accordingly.  */
 398   boolean (*elf_backend_relocate_section)
 399     PARAMS ((bfd *output_bfd, struct bfd_link_info *info,
 400              bfd *input_bfd, asection *input_section, bfd_byte *contents,
 401              Elf_Internal_Rela *relocs, Elf_Internal_Sym *local_syms,
 402              asection **local_sections));
 403
 404   /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
 405      linker just before it writes a symbol out to the .dynsym section.
 406      The processor backend may make any required adjustment to the
 407      symbol.  It may also take the opportunity to set contents of the
 408      dynamic sections.  Note that FINISH_DYNAMIC_SYMBOL is called on
 409      all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
 410      on those symbols which are defined by a dynamic object.  */
 411   boolean (*elf_backend_finish_dynamic_symbol)
 412     PARAMS ((bfd *output_bfd, struct bfd_link_info *info,
 413              struct elf_link_hash_entry *h, Elf_Internal_Sym *sym));
 414
 415   /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
 416      linker just before it writes all the dynamic sections out to the
 417      output file.  The FINISH_DYNAMIC_SYMBOL will have been called on
 418      all dynamic symbols.  */
 419   boolean (*elf_backend_finish_dynamic_sections)
 420     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
 421
 422   /* A function to do any beginning processing needed for the ELF file
 423      before building the ELF headers and computing file positions.  */
 424   void (*elf_backend_begin_write_processing)
 425     PARAMS ((bfd *, struct bfd_link_info *));
 426
 427   /* A function to do any final processing needed for the ELF file
 428      before writing it out.  The LINKER argument is true if this BFD
 429      was created by the ELF backend linker.  */
 430   void (*elf_backend_final_write_processing)
 431     PARAMS ((bfd *, boolean linker));
 432
 433   /* This function is called by get_program_header_size.  It should
 434      return the number of additional program segments which this BFD
 435      will need.  It should return -1 on error.  */
 436   int (*elf_backend_additional_program_headers) PARAMS ((bfd *));
 437
 438   /* This function is called to modify an existing segment map in a
 439      backend specific fashion.  */
 440   boolean (*elf_backend_modify_segment_map) PARAMS ((bfd *));
 441
 442   /* The swapping table to use when dealing with ECOFF information.
 443      Used for the MIPS ELF .mdebug section.  */
 444   const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
 445
 446   /* Alternate EM_xxxx machine codes for this backend.  */
 447   int elf_machine_alt1;
 448   int elf_machine_alt2;
 449
 450   const struct elf_size_info *s;
 451
 452   unsigned want_got_plt : 1;
 453   unsigned plt_readonly : 1;
 454   unsigned want_plt_sym : 1;
 455 };
 456
 457 /* Information stored for each BFD section in an ELF file.  This
 458    structure is allocated by elf_new_section_hook.  */
 459
 460 struct bfd_elf_section_data
 461 {
 462   /* The ELF header for this section.  */
 463   Elf_Internal_Shdr this_hdr;
 464   /* The ELF header for the reloc section associated with this
 465      section, if any.  */
 466   Elf_Internal_Shdr rel_hdr;
 467   /* The ELF section number of this section.  Only used for an output
 468      file.  */
 469   int this_idx;
 470   /* The ELF section number of the reloc section associated with this
 471      section, if any.  Only used for an output file.  */
 472   int rel_idx;
 473   /* Used by the backend linker to store the symbol hash table entries
 474      associated with relocs against global symbols.  */
 475   struct elf_link_hash_entry **rel_hashes;
 476   /* A pointer to the swapped relocs.  If the section uses REL relocs,
 477      rather than RELA, all the r_addend fields will be zero.  This
 478      pointer may be NULL.  It is used by the backend linker.  */
 479   Elf_Internal_Rela *relocs;
 480   /* Used by the backend linker when generating a shared library to
 481      record the dynamic symbol index for a section symbol
 482      corresponding to this section.  */
 483   long dynindx;
 484   /* A pointer available for the processor specific ELF backend.  */
 485   PTR tdata;
 486 };
 487
 488 #define elf_section_data(sec)  ((struct bfd_elf_section_data*)sec->used_by_bfd)
 489
 490 #define get_elf_backend_data(abfd) \
 491   ((struct elf_backend_data *) (abfd)->xvec->backend_data)
 492
 493 /* Enumeration to specify the special section.  */
 494 typedef enum elf_linker_section_enum
 495 {
 496   LINKER_SECTION_UNKNOWN,               /* not used */
 497   LINKER_SECTION_GOT,                   /* .got section for global offset pointers */
 498   LINKER_SECTION_PLT,                   /* .plt section for generated procedure stubs */
 499   LINKER_SECTION_SDATA,                 /* .sdata/.sbss section for PowerPC */
 500   LINKER_SECTION_SDATA2,                /* .sdata2/.sbss2 section for PowerPC */
 501   LINKER_SECTION_MAX                    /* # of linker sections */
 502 } elf_linker_section_enum_t;
 503
 504 /* Sections created by the linker.  */
 505
 506 typedef struct elf_linker_section
 507 {
 508   char *name;                           /* name of the section */
 509   char *rel_name;                       /* name of the associated .rel{,a}. section */
 510   char *bss_name;                       /* name of a related .bss section */
 511   char *sym_name;                       /* name of symbol to reference this section */
 512   asection *section;                    /* pointer to the section */
 513   asection *bss_section;                /* pointer to the bss section associated with this */
 514   asection *rel_section;                /* pointer to the relocations needed for this section */
 515   struct elf_link_hash_entry *sym_hash; /* pointer to the created symbol hash value */
 516   bfd_vma initial_size;                 /* initial size before any linker generated allocations */
 517   bfd_vma sym_offset;                   /* offset of symbol from beginning of section */
 518   bfd_vma hole_size;                    /* size of reserved address hole in allocation */
 519   bfd_vma hole_offset;                  /* current offset for the hole */
 520   bfd_vma max_hole_offset;              /* maximum offset for the hole */
 521   elf_linker_section_enum_t which;      /* which section this is */
 522   boolean hole_written_p;               /* whether the hole has been initialized */
 523   int alignment;                        /* alignment for the section */
 524   flagword flags;                       /* flags to use to create the section */
 525 } elf_linker_section_t;
 526
 527 /* Linked list of allocated pointer entries.  This hangs off of the symbol lists, and
 528    provides allows us to return different pointers, based on different addend's.  */
 529
 530 typedef struct elf_linker_section_pointers
 531 {
 532   struct elf_linker_section_pointers *next;     /* next allocated pointer for this symbol */
 533   bfd_vma offset;                               /* offset of pointer from beginning of section */
 534   bfd_signed_vma addend;                        /* addend used */
 535   elf_linker_section_enum_t which;              /* which linker section this is */
 536   boolean written_address_p;                    /* whether address was written yet */
 537 } elf_linker_section_pointers_t;
 538
 539 /* Some private data is stashed away for future use using the tdata pointer
 540    in the bfd structure.  */
 541
 542 struct elf_obj_tdata
 543 {
 544   Elf_Internal_Ehdr elf_header[1];      /* Actual data, but ref like ptr */
 545   Elf_Internal_Shdr **elf_sect_ptr;
 546   Elf_Internal_Phdr *phdr;
 547   struct elf_segment_map *segment_map;
 548   struct bfd_strtab_hash *strtab_ptr;
 549   int num_locals;
 550   int num_globals;
 551   asymbol **section_syms;               /* STT_SECTION symbols for each section */
 552   Elf_Internal_Shdr symtab_hdr;
 553   Elf_Internal_Shdr shstrtab_hdr;
 554   Elf_Internal_Shdr strtab_hdr;
 555   Elf_Internal_Shdr dynsymtab_hdr;
 556   Elf_Internal_Shdr dynstrtab_hdr;
 557   unsigned int symtab_section, shstrtab_section;
 558   unsigned int strtab_section, dynsymtab_section;
 559   file_ptr next_file_pos;
 560   void *prstatus;                       /* The raw /proc prstatus structure */
 561   void *prpsinfo;                       /* The raw /proc prpsinfo structure */
 562   bfd_vma gp;                           /* The gp value (MIPS only, for now) */
 563   unsigned int gp_size;                 /* The gp size (MIPS only, for now) */
 564
 565   /* This is set to true if the object was created by the backend
 566      linker.  */
 567   boolean linker;
 568
 569   /* A mapping from external symbols to entries in the linker hash
 570      table, used when linking.  This is indexed by the symbol index
 571      minus the sh_info field of the symbol table header.  */
 572   struct elf_link_hash_entry **sym_hashes;
 573
 574   /* A mapping from local symbols to offsets into the global offset
 575      table, used when linking.  This is indexed by the symbol index.  */
 576   bfd_vma *local_got_offsets;
 577
 578   /* A mapping from local symbols to offsets into the various linker
 579      sections added.  This is index by the symbol index.  */
 580   elf_linker_section_pointers_t **linker_section_pointers;
 581
 582   /* The linker ELF emulation code needs to let the backend ELF linker
 583      know what filename should be used for a dynamic object if the
 584      dynamic object is found using a search.  The emulation code then
 585      sometimes needs to know what name was actually used.  Until the
 586      file has been added to the linker symbol table, this field holds
 587      the name the linker wants.  After it has been added, it holds the
 588      name actually used, which will be the DT_SONAME entry if there is
 589      one.  */
 590   const char *dt_name;
 591
 592   /* Irix 5 often screws up the symbol table, sorting local symbols
 593      after global symbols.  This flag is set if the symbol table in
 594      this BFD appears to be screwed up.  If it is, we ignore the
 595      sh_info field in the symbol table header, and always read all the
 596      symbols.  */
 597   boolean bad_symtab;
 598
 599   /* Records the result of `get_program_header_size'.  */
 600   bfd_size_type program_header_size;
 601
 602   /* Used by find_nearest_line entry point.  */
 603   PTR line_info;
 604
 605   /* Used by MIPS ELF find_nearest_line entry point.  The structure
 606      could be included directly in this one, but there's no point to
 607      wasting the memory just for the infrequently called
 608      find_nearest_line.  */
 609   struct mips_elf_find_line *find_line_info;
 610
 611   /* Used to determine if the e_flags field has been initialized */
 612   boolean flags_init;
 613
 614   /* Linker sections that we are interested in.  */
 615   struct elf_linker_section *linker_section[ (int)LINKER_SECTION_MAX ];
 616 };
 617
 618 #define elf_tdata(bfd)          ((bfd) -> tdata.elf_obj_data)
 619 #define elf_elfheader(bfd)      (elf_tdata(bfd) -> elf_header)
 620 #define elf_elfsections(bfd)    (elf_tdata(bfd) -> elf_sect_ptr)
 621 #define elf_shstrtab(bfd)       (elf_tdata(bfd) -> strtab_ptr)
 622 #define elf_onesymtab(bfd)      (elf_tdata(bfd) -> symtab_section)
 623 #define elf_dynsymtab(bfd)      (elf_tdata(bfd) -> dynsymtab_section)
 624 #define elf_num_locals(bfd)     (elf_tdata(bfd) -> num_locals)
 625 #define elf_num_globals(bfd)    (elf_tdata(bfd) -> num_globals)
 626 #define elf_section_syms(bfd)   (elf_tdata(bfd) -> section_syms)
 627 #define core_prpsinfo(bfd)      (elf_tdata(bfd) -> prpsinfo)
 628 #define core_prstatus(bfd)      (elf_tdata(bfd) -> prstatus)
 629 #define elf_gp(bfd)             (elf_tdata(bfd) -> gp)
 630 #define elf_gp_size(bfd)        (elf_tdata(bfd) -> gp_size)
 631 #define elf_sym_hashes(bfd)     (elf_tdata(bfd) -> sym_hashes)
 632 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got_offsets)
 633 #define elf_local_ptr_offsets(bfd) (elf_tdata(bfd) -> linker_section_pointers)
 634 #define elf_dt_name(bfd)        (elf_tdata(bfd) -> dt_name)
 635 #define elf_bad_symtab(bfd)     (elf_tdata(bfd) -> bad_symtab)
 636 #define elf_flags_init(bfd)     (elf_tdata(bfd) -> flags_init)
 637 #define elf_linker_section(bfd,n) (elf_tdata(bfd) -> linker_section[(int)n])
 638 \f
 639 extern int _bfd_elf_section_from_bfd_section PARAMS ((bfd *, asection *));
 640 extern char *bfd_elf_string_from_elf_section
 641   PARAMS ((bfd *, unsigned, unsigned));
 642 extern char *bfd_elf_get_str_section PARAMS ((bfd *, unsigned));
 643
 644 extern boolean _bfd_elf_print_private_bfd_data PARAMS ((bfd *, PTR));
 645 extern void bfd_elf_print_symbol PARAMS ((bfd *, PTR, asymbol *,
 646                                           bfd_print_symbol_type));
 647 #define elf_string_from_elf_strtab(abfd,strindex) \
 648      bfd_elf_string_from_elf_section(abfd,elf_elfheader(abfd)->e_shstrndx,strindex)
 649
 650 #define bfd_elf32_print_symbol  bfd_elf_print_symbol
 651 #define bfd_elf64_print_symbol  bfd_elf_print_symbol
 652 #define bfd_elf32_mkobject      bfd_elf_mkobject
 653 #define bfd_elf64_mkobject      bfd_elf_mkobject
 654 #define elf_mkobject            bfd_elf_mkobject
 655
 656 extern unsigned long bfd_elf_hash PARAMS ((CONST unsigned char *));
 657
 658 extern bfd_reloc_status_type bfd_elf_generic_reloc PARAMS ((bfd *,
 659                                                             arelent *,
 660                                                             asymbol *,
 661                                                             PTR,
 662                                                             asection *,
 663                                                             bfd *,
 664                                                             char **));
 665 extern boolean bfd_elf_mkobject PARAMS ((bfd *));
 666 extern Elf_Internal_Shdr *bfd_elf_find_section PARAMS ((bfd *, char *));
 667 extern boolean _bfd_elf_make_section_from_shdr
 668   PARAMS ((bfd *abfd, Elf_Internal_Shdr *hdr, const char *name));
 669 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
 670   PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
 671 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
 672   PARAMS ((bfd *));
 673 extern boolean _bfd_elf_link_hash_table_init
 674   PARAMS ((struct elf_link_hash_table *, bfd *,
 675            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
 676                                        struct bfd_hash_table *,
 677                                        const char *)));
 678
 679 extern boolean _bfd_elf_copy_private_symbol_data
 680   PARAMS ((bfd *, asymbol *, bfd *, asymbol *));
 681 extern boolean _bfd_elf_copy_private_section_data
 682   PARAMS ((bfd *, asection *, bfd *, asection *));
 683 extern boolean _bfd_elf_write_object_contents PARAMS ((bfd *));
 684 extern boolean _bfd_elf_set_section_contents PARAMS ((bfd *, sec_ptr, PTR,
 685                                                        file_ptr,
 686                                                        bfd_size_type));
 687 extern long _bfd_elf_get_symtab_upper_bound PARAMS ((bfd *));
 688 extern long _bfd_elf_get_symtab PARAMS ((bfd *, asymbol **));
 689 extern long _bfd_elf_get_dynamic_symtab_upper_bound PARAMS ((bfd *));
 690 extern long _bfd_elf_canonicalize_dynamic_symtab PARAMS ((bfd *, asymbol **));
 691 extern long _bfd_elf_get_reloc_upper_bound PARAMS ((bfd *, sec_ptr));
 692 extern long _bfd_elf_canonicalize_reloc PARAMS ((bfd *, sec_ptr,
 693                                                   arelent **, asymbol **));
 694 extern asymbol *_bfd_elf_make_empty_symbol PARAMS ((bfd *));
 695 extern void _bfd_elf_get_symbol_info PARAMS ((bfd *, asymbol *,
 696                                                symbol_info *));
 697 extern alent *_bfd_elf_get_lineno PARAMS ((bfd *, asymbol *));
 698 extern boolean _bfd_elf_set_arch_mach PARAMS ((bfd *, enum bfd_architecture,
 699                                                 unsigned long));
 700 extern boolean _bfd_elf_find_nearest_line PARAMS ((bfd *, asection *,
 701                                                     asymbol **,
 702                                                     bfd_vma, CONST char **,
 703                                                     CONST char **,
 704                                                     unsigned int *));
 705 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
 706 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
 707 extern int _bfd_elf_sizeof_headers PARAMS ((bfd *, boolean));
 708 extern boolean _bfd_elf_new_section_hook PARAMS ((bfd *, asection *));
 709
 710 /* If the target doesn't have reloc handling written yet:  */
 711 extern void _bfd_elf_no_info_to_howto PARAMS ((bfd *, arelent *,
 712                                                Elf_Internal_Rela *));
 713
 714 asection *bfd_section_from_elf_index PARAMS ((bfd *, unsigned int));
 715 boolean _bfd_elf_create_dynamic_sections PARAMS ((bfd *,
 716                                                   struct bfd_link_info *));
 717 struct bfd_strtab_hash *_bfd_elf_stringtab_init PARAMS ((void));
 718 boolean
 719 _bfd_elf_link_record_dynamic_symbol PARAMS ((struct bfd_link_info *,
 720                                              struct elf_link_hash_entry *));
 721 boolean
 722 _bfd_elf_compute_section_file_positions PARAMS ((bfd *,
 723                                                  struct bfd_link_info *));
 724 void _bfd_elf_assign_file_positions_for_relocs PARAMS ((bfd *));
 725 file_ptr _bfd_elf_assign_file_position_for_section PARAMS ((Elf_Internal_Shdr *,
 726                                                             file_ptr,
 727                                                             boolean));
 728
 729 boolean _bfd_elf_create_dynamic_sections PARAMS ((bfd *,
 730                                                   struct bfd_link_info *));
 731 boolean _bfd_elf_create_got_section PARAMS ((bfd *,
 732                                              struct bfd_link_info *));
 733
 734 elf_linker_section_t *_bfd_elf_create_linker_section
 735   PARAMS ((bfd *abfd,
 736            struct bfd_link_info *info,
 737            enum elf_linker_section_enum,
 738            elf_linker_section_t *defaults));
 739
 740 elf_linker_section_pointers_t *_bfd_elf_find_pointer_linker_section
 741   PARAMS ((elf_linker_section_pointers_t *linker_pointers,
 742            bfd_signed_vma addend,
 743            elf_linker_section_enum_t which));
 744
 745 boolean bfd_elf32_create_pointer_linker_section
 746   PARAMS ((bfd *abfd,
 747            struct bfd_link_info *info,
 748            elf_linker_section_t *lsect,
 749            struct elf_link_hash_entry *h,
 750            const Elf32_Internal_Rela *rel));
 751
 752 bfd_vma bfd_elf32_finish_pointer_linker_section
 753   PARAMS ((bfd *output_abfd,
 754            bfd *input_bfd,
 755            struct bfd_link_info *info,
 756            elf_linker_section_t *lsect,
 757            struct elf_link_hash_entry *h,
 758            bfd_vma relocation,
 759            const Elf32_Internal_Rela *rel,
 760            int relative_reloc));
 761
 762 boolean bfd_elf64_create_pointer_linker_section
 763   PARAMS ((bfd *abfd,
 764            struct bfd_link_info *info,
 765            elf_linker_section_t *lsect,
 766            struct elf_link_hash_entry *h,
 767            const Elf64_Internal_Rela *rel));
 768
 769 bfd_vma bfd_elf64_finish_pointer_linker_section
 770   PARAMS ((bfd *output_abfd,
 771            bfd *input_bfd,
 772            struct bfd_link_info *info,
 773            elf_linker_section_t *lsect,
 774            struct elf_link_hash_entry *h,
 775            bfd_vma relocation,
 776            const Elf64_Internal_Rela *rel,
 777            int relative_reloc));
 778
 779 boolean _bfd_elf_make_linker_section_rela
 780   PARAMS ((bfd *dynobj,
 781            elf_linker_section_t *lsect,
 782            int alignment));
 783
 784 extern const bfd_target *bfd_elf32_object_p PARAMS ((bfd *));
 785 extern const bfd_target *bfd_elf32_core_file_p PARAMS ((bfd *));
 786 extern char *bfd_elf32_core_file_failing_command PARAMS ((bfd *));
 787 extern int bfd_elf32_core_file_failing_signal PARAMS ((bfd *));
 788 extern boolean bfd_elf32_core_file_matches_executable_p PARAMS ((bfd *,
 789                                                                  bfd *));
 790
 791 extern boolean bfd_elf32_bfd_link_add_symbols
 792   PARAMS ((bfd *, struct bfd_link_info *));
 793 extern boolean bfd_elf32_bfd_final_link
 794   PARAMS ((bfd *, struct bfd_link_info *));
 795
 796 extern void bfd_elf32_swap_symbol_in
 797   PARAMS ((bfd *, Elf32_External_Sym *, Elf_Internal_Sym *));
 798 extern void bfd_elf32_swap_symbol_out
 799   PARAMS ((bfd *, Elf_Internal_Sym *, PTR));
 800 extern void bfd_elf32_swap_reloc_in
 801   PARAMS ((bfd *, Elf32_External_Rel *, Elf_Internal_Rel *));
 802 extern void bfd_elf32_swap_reloc_out
 803   PARAMS ((bfd *, Elf_Internal_Rel *, Elf32_External_Rel *));
 804 extern void bfd_elf32_swap_reloca_in
 805   PARAMS ((bfd *, Elf32_External_Rela *, Elf_Internal_Rela *));
 806 extern void bfd_elf32_swap_reloca_out
 807   PARAMS ((bfd *, Elf_Internal_Rela *, Elf32_External_Rela *));
 808 extern void bfd_elf32_swap_phdr_in
 809   PARAMS ((bfd *, Elf32_External_Phdr *, Elf_Internal_Phdr *));
 810 extern void bfd_elf32_swap_phdr_out
 811   PARAMS ((bfd *, Elf_Internal_Phdr *, Elf32_External_Phdr *));
 812 extern void bfd_elf32_swap_dyn_in
 813   PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
 814 extern void bfd_elf32_swap_dyn_out
 815   PARAMS ((bfd *, const Elf_Internal_Dyn *, Elf32_External_Dyn *));
 816 extern boolean bfd_elf32_add_dynamic_entry
 817   PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma));
 818 extern boolean bfd_elf32_link_create_dynamic_sections
 819   PARAMS ((bfd *, struct bfd_link_info *));
 820
 821 extern const bfd_target *bfd_elf64_object_p PARAMS ((bfd *));
 822 extern const bfd_target *bfd_elf64_core_file_p PARAMS ((bfd *));
 823 extern char *bfd_elf64_core_file_failing_command PARAMS ((bfd *));
 824 extern int bfd_elf64_core_file_failing_signal PARAMS ((bfd *));
 825 extern boolean bfd_elf64_core_file_matches_executable_p PARAMS ((bfd *,
 826                                                                  bfd *));
 827 extern boolean bfd_elf64_bfd_link_add_symbols
 828   PARAMS ((bfd *, struct bfd_link_info *));
 829 extern boolean bfd_elf64_bfd_final_link
 830   PARAMS ((bfd *, struct bfd_link_info *));
 831
 832 extern void bfd_elf64_swap_symbol_in
 833   PARAMS ((bfd *, Elf64_External_Sym *, Elf_Internal_Sym *));
 834 extern void bfd_elf64_swap_symbol_out
 835   PARAMS ((bfd *, Elf_Internal_Sym *, PTR));
 836 extern void bfd_elf64_swap_reloc_in
 837   PARAMS ((bfd *, Elf64_External_Rel *, Elf_Internal_Rel *));
 838 extern void bfd_elf64_swap_reloc_out
 839   PARAMS ((bfd *, Elf_Internal_Rel *, Elf64_External_Rel *));
 840 extern void bfd_elf64_swap_reloca_in
 841   PARAMS ((bfd *, Elf64_External_Rela *, Elf_Internal_Rela *));
 842 extern void bfd_elf64_swap_reloca_out
 843   PARAMS ((bfd *, Elf_Internal_Rela *, Elf64_External_Rela *));
 844 extern void bfd_elf64_swap_phdr_in
 845   PARAMS ((bfd *, Elf64_External_Phdr *, Elf_Internal_Phdr *));
 846 extern void bfd_elf64_swap_phdr_out
 847   PARAMS ((bfd *, Elf_Internal_Phdr *, Elf64_External_Phdr *));
 848 extern void bfd_elf64_swap_dyn_in
 849   PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
 850 extern void bfd_elf64_swap_dyn_out
 851   PARAMS ((bfd *, const Elf_Internal_Dyn *, Elf64_External_Dyn *));
 852 extern boolean bfd_elf64_add_dynamic_entry
 853   PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma));
 854 extern boolean bfd_elf64_link_create_dynamic_sections
 855   PARAMS ((bfd *, struct bfd_link_info *));
 856
 857 #define bfd_elf32_link_record_dynamic_symbol _bfd_elf_link_record_dynamic_symbol
 858 #define bfd_elf64_link_record_dynamic_symbol _bfd_elf_link_record_dynamic_symbol
 859
 860 #endif /* _LIBELF_H_ */