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