bfd/elf-bfd.h

   1 /* BFD back-end data structures for ELF files.
   2    Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001
   3    Free Software Foundation, Inc.
   4    Written by Cygnus Support.
   5
   6 This file is part of BFD, the Binary File Descriptor library.
   7
   8 This program is free software; you can redistribute it and/or modify
   9 it under the terms of the GNU General Public License as published by
  10 the Free Software Foundation; either version 2 of the License, or
  11 (at your option) any later version.
  12
  13 This program is distributed in the hope that it will be useful,
  14 but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 GNU General Public License for more details.
  17
  18 You should have received a copy of the GNU General Public License
  19 along with this program; if not, write to the Free Software
  20 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  21
  22 #ifndef _LIBELF_H_
  23 #define _LIBELF_H_ 1
  24
  25 #include "elf/common.h"
  26 #include "elf/internal.h"
  27 #include "elf/external.h"
  28 #include "bfdlink.h"
  29
  30 /* The number of entries in a section is its size divided by the size
  31    of a single entry.  This is normally only applicaable to reloc and
  32    symbol table sections.  */
  33 #define NUM_SHDR_ENTRIES(shdr) ((shdr)->sh_size / (shdr)->sh_entsize)
  34
  35 /* If size isn't specified as 64 or 32, NAME macro should fail.  */
  36 #ifndef NAME
  37 #if ARCH_SIZE==64
  38 #define NAME(x,y) CAT4(x,64,_,y)
  39 #endif
  40 #if ARCH_SIZE==32
  41 #define NAME(x,y) CAT4(x,32,_,y)
  42 #endif
  43 #endif
  44
  45 #ifndef NAME
  46 #define NAME(x,y) CAT4(x,NOSIZE,_,y)
  47 #endif
  48
  49 #define ElfNAME(X)      NAME(Elf,X)
  50 #define elfNAME(X)      NAME(elf,X)
  51
  52 /* Information held for an ELF symbol.  The first field is the
  53    corresponding asymbol.  Every symbol is an ELF file is actually a
  54    pointer to this structure, although it is often handled as a
  55    pointer to an asymbol.  */
  56
  57 typedef struct
  58 {
  59   /* The BFD symbol.  */
  60   asymbol symbol;
  61   /* ELF symbol information.  */
  62   Elf_Internal_Sym internal_elf_sym;
  63   /* Backend specific information.  */
  64   union
  65     {
  66       unsigned int hppa_arg_reloc;
  67       PTR mips_extr;
  68       PTR any;
  69     }
  70   tc_data;
  71
  72   /* Version information.  This is from an Elf_Internal_Versym
  73      structure in a SHT_GNU_versym section.  It is zero if there is no
  74      version information.  */
  75   unsigned short version;
  76
  77 } elf_symbol_type;
  78 \f
  79 /* ELF linker hash table entries.  */
  80
  81 struct elf_link_hash_entry
  82 {
  83   struct bfd_link_hash_entry root;
  84
  85   /* Symbol index in output file.  This is initialized to -1.  It is
  86      set to -2 if the symbol is used by a reloc.  */
  87   long indx;
  88
  89   /* Symbol size.  */
  90   bfd_size_type size;
  91
  92   /* Symbol index as a dynamic symbol.  Initialized to -1, and remains
  93      -1 if this is not a dynamic symbol.  */
  94   /* ??? Note that this is consistently used as a synonym for tests
  95      against whether we can perform various simplifying transformations
  96      to the code.  (E.g. changing a pc-relative jump to a PLT entry
  97      into a pc-relative jump to the target function.)  That test, which
  98      is often relatively complex, and someplaces wrong or incomplete,
  99      should really be replaced by a predicate in elflink.c.
 100
 101      End result: this field -1 does not indicate that the symbol is
 102      not in the dynamic symbol table, but rather that the symbol is
 103      not visible outside this DSO.  */
 104   long dynindx;
 105
 106   /* String table index in .dynstr if this is a dynamic symbol.  */
 107   unsigned long dynstr_index;
 108
 109   /* If this is a weak defined symbol from a dynamic object, this
 110      field points to a defined symbol with the same value, if there is
 111      one.  Otherwise it is NULL.  */
 112   struct elf_link_hash_entry *weakdef;
 113
 114   /* If this symbol requires an entry in the global offset table, the
 115      processor specific backend uses this field to track usage and
 116      final offset.  We use a union and two names primarily to document
 117      the intent of any particular piece of code.  The field should be
 118      used as a count until size_dynamic_sections, at which point the
 119      contents of the .got is fixed.  Afterward, if this field is -1,
 120      then the symbol does not require a global offset table entry.  */
 121   union
 122     {
 123       bfd_signed_vma refcount;
 124       bfd_vma offset;
 125     } got;
 126
 127   /* Same, but tracks a procedure linkage table entry.  */
 128   union
 129     {
 130       bfd_signed_vma refcount;
 131       bfd_vma offset;
 132     } plt;
 133
 134   /* If this symbol is used in the linker created sections, the processor
 135      specific backend uses this field to map the field into the offset
 136      from the beginning of the section.  */
 137   struct elf_linker_section_pointers *linker_section_pointer;
 138
 139   /* Version information.  */
 140   union
 141   {
 142     /* This field is used for a symbol which is not defined in a
 143        regular object.  It points to the version information read in
 144        from the dynamic object.  */
 145     Elf_Internal_Verdef *verdef;
 146     /* This field is used for a symbol which is defined in a regular
 147        object.  It is set up in size_dynamic_sections.  It points to
 148        the version information we should write out for this symbol.  */
 149     struct bfd_elf_version_tree *vertree;
 150   } verinfo;
 151
 152   /* Virtual table entry use information.  This array is nominally of size
 153      size/sizeof(target_void_pointer), though we have to be able to assume
 154      and track a size while the symbol is still undefined.  It is indexed
 155      via offset/sizeof(target_void_pointer).  */
 156   size_t vtable_entries_size;
 157   boolean *vtable_entries_used;
 158
 159   /* Virtual table derivation info.  */
 160   struct elf_link_hash_entry *vtable_parent;
 161
 162   /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.).  */
 163   char type;
 164
 165   /* Symbol st_other value, symbol visibility.  */
 166   unsigned char other;
 167
 168   /* Hash value of the name computed using the ELF hash function.  */
 169   unsigned long elf_hash_value;
 170
 171   /* Some flags; legal values follow.  */
 172   unsigned short elf_link_hash_flags;
 173   /* Symbol is referenced by a non-shared object.  */
 174 #define ELF_LINK_HASH_REF_REGULAR 01
 175   /* Symbol is defined by a non-shared object.  */
 176 #define ELF_LINK_HASH_DEF_REGULAR 02
 177   /* Symbol is referenced by a shared object.  */
 178 #define ELF_LINK_HASH_REF_DYNAMIC 04
 179   /* Symbol is defined by a shared object.  */
 180 #define ELF_LINK_HASH_DEF_DYNAMIC 010
 181   /* Symbol has a non-weak reference from a non-shared object.  */
 182 #define ELF_LINK_HASH_REF_REGULAR_NONWEAK 020
 183   /* Dynamic symbol has been adjustd.  */
 184 #define ELF_LINK_HASH_DYNAMIC_ADJUSTED 040
 185   /* Symbol needs a copy reloc.  */
 186 #define ELF_LINK_HASH_NEEDS_COPY 0100
 187   /* Symbol needs a procedure linkage table entry.  */
 188 #define ELF_LINK_HASH_NEEDS_PLT 0200
 189   /* Symbol appears in a non-ELF input file.  */
 190 #define ELF_LINK_NON_ELF 0400
 191   /* Symbol should be marked as hidden in the version information.  */
 192 #define ELF_LINK_HIDDEN 01000
 193   /* Symbol was forced to local scope due to a version script file.  */
 194 #define ELF_LINK_FORCED_LOCAL 02000
 195   /* Symbol was marked during garbage collection.  */
 196 #define ELF_LINK_HASH_MARK 04000
 197   /* Symbol is referenced by a non-GOT/non-PLT relocation.  This is
 198      not currently set by all the backends.  */
 199 #define ELF_LINK_NON_GOT_REF 010000
 200 };
 201
 202 /* Records local symbols to be emitted in the dynamic symbol table.  */
 203
 204 struct elf_link_local_dynamic_entry
 205 {
 206   struct elf_link_local_dynamic_entry *next;
 207
 208   /* The input bfd this symbol came from.  */
 209   bfd *input_bfd;
 210
 211   /* The index of the local symbol being copied.  */
 212   long input_indx;
 213
 214   /* The index in the outgoing dynamic symbol table.  */
 215   long dynindx;
 216
 217   /* A copy of the input symbol.  */
 218   Elf_Internal_Sym isym;
 219 };
 220
 221 /* ELF linker hash table.  */
 222
 223 struct elf_link_hash_table
 224 {
 225   struct bfd_link_hash_table root;
 226   /* Whether we have created the special dynamic sections required
 227      when linking against or generating a shared object.  */
 228   boolean dynamic_sections_created;
 229   /* The BFD used to hold special sections created by the linker.
 230      This will be the first BFD found which requires these sections to
 231      be created.  */
 232   bfd *dynobj;
 233   /* The number of symbols found in the link which must be put into
 234      the .dynsym section.  */
 235   bfd_size_type dynsymcount;
 236   /* The string table of dynamic symbols, which becomes the .dynstr
 237      section.  */
 238   struct bfd_strtab_hash *dynstr;
 239   /* The number of buckets in the hash table in the .hash section.
 240      This is based on the number of dynamic symbols.  */
 241   bfd_size_type bucketcount;
 242   /* A linked list of DT_NEEDED names found in dynamic objects
 243      included in the link.  */
 244   struct bfd_link_needed_list *needed;
 245   /* The _GLOBAL_OFFSET_TABLE_ symbol.  */
 246   struct elf_link_hash_entry *hgot;
 247   /* A pointer to information used to link stabs in sections.  */
 248   PTR stab_info;
 249   /* A pointer to information used to merge SEC_MERGE sections.  */
 250   PTR merge_info;
 251   /* A linked list of local symbols to be added to .dynsym.  */
 252   struct elf_link_local_dynamic_entry *dynlocal;
 253   /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic
 254      objects included in the link.  */
 255   struct bfd_link_needed_list *runpath;
 256 };
 257
 258 /* Look up an entry in an ELF linker hash table.  */
 259
 260 #define elf_link_hash_lookup(table, string, create, copy, follow)       \
 261   ((struct elf_link_hash_entry *)                                       \
 262    bfd_link_hash_lookup (&(table)->root, (string), (create),            \
 263                          (copy), (follow)))
 264
 265 /* Traverse an ELF linker hash table.  */
 266
 267 #define elf_link_hash_traverse(table, func, info)                       \
 268   (bfd_link_hash_traverse                                               \
 269    (&(table)->root,                                                     \
 270     (boolean (*) PARAMS ((struct bfd_link_hash_entry *, PTR))) (func),  \
 271     (info)))
 272
 273 /* Get the ELF linker hash table from a link_info structure.  */
 274
 275 #define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash))
 276 \f
 277 /* Constant information held for an ELF backend.  */
 278
 279 struct elf_size_info {
 280   unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
 281   unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
 282
 283   /* The size of entries in the .hash section.  */
 284   unsigned char sizeof_hash_entry;
 285
 286   /* The number of internal relocations to allocate per external
 287      relocation entry.  */
 288   unsigned char int_rels_per_ext_rel;
 289
 290   unsigned char arch_size, file_align;
 291   unsigned char elfclass, ev_current;
 292   int (*write_out_phdrs) PARAMS ((bfd *, const Elf_Internal_Phdr *, int));
 293   boolean (*write_shdrs_and_ehdr) PARAMS ((bfd *));
 294   void (*write_relocs) PARAMS ((bfd *, asection *, PTR));
 295   void (*swap_symbol_out) PARAMS ((bfd *, const Elf_Internal_Sym *, PTR));
 296   boolean (*slurp_reloc_table)
 297     PARAMS ((bfd *, asection *, asymbol **, boolean));
 298   long (*slurp_symbol_table) PARAMS ((bfd *, asymbol **, boolean));
 299   void (*swap_dyn_in) PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
 300   void (*swap_dyn_out) PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR));
 301
 302   /* This function, if defined, is called to swap in a REL
 303      relocation.  If an external relocation corresponds to more than
 304      one internal relocation, then all relocations are swapped in at
 305      once.  */
 306   void (*swap_reloc_in)
 307     PARAMS ((bfd *, const bfd_byte *, Elf_Internal_Rel *));
 308
 309   /* This function, if defined, is called to swap out a REL
 310      relocation.  */
 311   void (*swap_reloc_out)
 312     PARAMS ((bfd *, const Elf_Internal_Rel *, bfd_byte *));
 313
 314   /* This function, if defined, is called to swap in a RELA
 315      relocation.  If an external relocation corresponds to more than
 316      one internal relocation, then all relocations are swapped in at
 317      once.  */
 318   void (*swap_reloca_in)
 319     PARAMS ((bfd *, const bfd_byte *, Elf_Internal_Rela *));
 320
 321   /* This function, if defined, is called to swap out a RELA
 322      relocation.  */
 323   void (*swap_reloca_out)
 324     PARAMS ((bfd *, const Elf_Internal_Rela *, bfd_byte *));
 325
 326 };
 327
 328 #define elf_symbol_from(ABFD,S) \
 329         (((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
 330           && (S)->the_bfd->tdata.elf_obj_data != 0) \
 331          ? (elf_symbol_type *) (S) \
 332          : 0)
 333
 334 struct elf_backend_data
 335 {
 336   /* The architecture for this backend.  */
 337   enum bfd_architecture arch;
 338
 339   /* The ELF machine code (EM_xxxx) for this backend.  */
 340   int elf_machine_code;
 341
 342   /* The maximum page size for this backend.  */
 343   bfd_vma maxpagesize;
 344
 345   /* A function to translate an ELF RELA relocation to a BFD arelent
 346      structure.  */
 347   void (*elf_info_to_howto) PARAMS ((bfd *, arelent *,
 348                                      Elf_Internal_Rela *));
 349
 350   /* A function to translate an ELF REL relocation to a BFD arelent
 351      structure.  */
 352   void (*elf_info_to_howto_rel) PARAMS ((bfd *, arelent *,
 353                                          Elf_Internal_Rel *));
 354
 355   /* A function to determine whether a symbol is global when
 356      partitioning the symbol table into local and global symbols.
 357      This should be NULL for most targets, in which case the correct
 358      thing will be done.  MIPS ELF, at least on the Irix 5, has
 359      special requirements.  */
 360   boolean (*elf_backend_sym_is_global) PARAMS ((bfd *, asymbol *));
 361
 362   /* The remaining functions are hooks which are called only if they
 363      are not NULL.  */
 364
 365   /* A function to permit a backend specific check on whether a
 366      particular BFD format is relevant for an object file, and to
 367      permit the backend to set any global information it wishes.  When
 368      this is called elf_elfheader is set, but anything else should be
 369      used with caution.  If this returns false, the check_format
 370      routine will return a bfd_error_wrong_format error.  */
 371   boolean (*elf_backend_object_p) PARAMS ((bfd *));
 372
 373   /* A function to do additional symbol processing when reading the
 374      ELF symbol table.  This is where any processor-specific special
 375      section indices are handled.  */
 376   void (*elf_backend_symbol_processing) PARAMS ((bfd *, asymbol *));
 377
 378   /* A function to do additional symbol processing after reading the
 379      entire ELF symbol table.  */
 380   boolean (*elf_backend_symbol_table_processing) PARAMS ((bfd *,
 381                                                           elf_symbol_type *,
 382                                                           unsigned int));
 383
 384    /* A function to set the type of the info field.  Processor-specific
 385      types should be handled here.  */
 386   int (*elf_backend_get_symbol_type) PARAMS (( Elf_Internal_Sym *, int));
 387
 388   /* A function to do additional processing on the ELF section header
 389      just before writing it out.  This is used to set the flags and
 390      type fields for some sections, or to actually write out data for
 391      unusual sections.  */
 392   boolean (*elf_backend_section_processing) PARAMS ((bfd *,
 393                                                      Elf32_Internal_Shdr *));
 394
 395   /* A function to handle unusual section types when creating BFD
 396      sections from ELF sections.  */
 397   boolean (*elf_backend_section_from_shdr) PARAMS ((bfd *,
 398                                                     Elf32_Internal_Shdr *,
 399                                                     char *));
 400
 401   /* A function to convert machine dependent section header flags to
 402      BFD internal section header flags.  */
 403   boolean (*elf_backend_section_flags) PARAMS ((flagword *,
 404                                                 Elf32_Internal_Shdr *));
 405
 406   /* A function to handle unusual program segment types when creating BFD
 407      sections from ELF program segments.  */
 408   boolean (*elf_backend_section_from_phdr) PARAMS ((bfd *,
 409                                                     Elf32_Internal_Phdr *,
 410                                                     int));
 411
 412   /* A function to set up the ELF section header for a BFD section in
 413      preparation for writing it out.  This is where the flags and type
 414      fields are set for unusual sections.  */
 415   boolean (*elf_backend_fake_sections) PARAMS ((bfd *, Elf32_Internal_Shdr *,
 416                                                 asection *));
 417
 418   /* A function to get the ELF section index for a BFD section.  If
 419      this returns true, the section was found.  If it is a normal ELF
 420      section, *RETVAL should be left unchanged.  If it is not a normal
 421      ELF section *RETVAL should be set to the SHN_xxxx index.  */
 422   boolean (*elf_backend_section_from_bfd_section)
 423     PARAMS ((bfd *, Elf32_Internal_Shdr *, asection *, int *retval));
 424
 425   /* If this field is not NULL, it is called by the add_symbols phase
 426      of a link just before adding a symbol to the global linker hash
 427      table.  It may modify any of the fields as it wishes.  If *NAME
 428      is set to NULL, the symbol will be skipped rather than being
 429      added to the hash table.  This function is responsible for
 430      handling all processor dependent symbol bindings and section
 431      indices, and must set at least *FLAGS and *SEC for each processor
 432      dependent case; failure to do so will cause a link error.  */
 433   boolean (*elf_add_symbol_hook)
 434     PARAMS ((bfd *abfd, struct bfd_link_info *info,
 435              const Elf_Internal_Sym *, const char **name,
 436              flagword *flags, asection **sec, bfd_vma *value));
 437
 438   /* If this field is not NULL, it is called by the elf_link_output_sym
 439      phase of a link for each symbol which will appear in the object file.  */
 440   boolean (*elf_backend_link_output_symbol_hook)
 441     PARAMS ((bfd *, struct bfd_link_info *info, const char *,
 442              Elf_Internal_Sym *, asection *));
 443
 444   /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
 445      linker the first time it encounters a dynamic object in the link.
 446      This function must create any sections required for dynamic
 447      linking.  The ABFD argument is a dynamic object.  The .interp,
 448      .dynamic, .dynsym, .dynstr, and .hash functions have already been
 449      created, and this function may modify the section flags if
 450      desired.  This function will normally create the .got and .plt
 451      sections, but different backends have different requirements.  */
 452   boolean (*elf_backend_create_dynamic_sections)
 453     PARAMS ((bfd *abfd, struct bfd_link_info *info));
 454
 455   /* The CHECK_RELOCS function is called by the add_symbols phase of
 456      the ELF backend linker.  It is called once for each section with
 457      relocs of an object file, just after the symbols for the object
 458      file have been added to the global linker hash table.  The
 459      function must look through the relocs and do any special handling
 460      required.  This generally means allocating space in the global
 461      offset table, and perhaps allocating space for a reloc.  The
 462      relocs are always passed as Rela structures; if the section
 463      actually uses Rel structures, the r_addend field will always be
 464      zero.  */
 465   boolean (*check_relocs)
 466     PARAMS ((bfd *abfd, struct bfd_link_info *info, asection *o,
 467              const Elf_Internal_Rela *relocs));
 468
 469   /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
 470      linker for every symbol which is defined by a dynamic object and
 471      referenced by a regular object.  This is called after all the
 472      input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
 473      function has been called.  The hash table entry should be
 474      bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
 475      defined in a section from a dynamic object.  Dynamic object
 476      sections are not included in the final link, and this function is
 477      responsible for changing the value to something which the rest of
 478      the link can deal with.  This will normally involve adding an
 479      entry to the .plt or .got or some such section, and setting the
 480      symbol to point to that.  */
 481   boolean (*elf_backend_adjust_dynamic_symbol)
 482     PARAMS ((struct bfd_link_info *info, struct elf_link_hash_entry *h));
 483
 484   /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
 485      after all the linker input files have been seen but before the
 486      section sizes have been set.  This is called after
 487      ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS.  */
 488   boolean (*elf_backend_always_size_sections)
 489     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
 490
 491   /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
 492      linker after all the linker input files have been seen but before
 493      the sections sizes have been set.  This is called after
 494      ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
 495      It is only called when linking against a dynamic object.  It must
 496      set the sizes of the dynamic sections, and may fill in their
 497      contents as well.  The generic ELF linker can handle the .dynsym,
 498      .dynstr and .hash sections.  This function must handle the
 499      .interp section and any sections created by the
 500      CREATE_DYNAMIC_SECTIONS entry point.  */
 501   boolean (*elf_backend_size_dynamic_sections)
 502     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
 503
 504   /* The RELOCATE_SECTION function is called by the ELF backend linker
 505      to handle the relocations for a section.
 506
 507      The relocs are always passed as Rela structures; if the section
 508      actually uses Rel structures, the r_addend field will always be
 509      zero.
 510
 511      This function is responsible for adjust the section contents as
 512      necessary, and (if using Rela relocs and generating a
 513      relocateable output file) adjusting the reloc addend as
 514      necessary.
 515
 516      This function does not have to worry about setting the reloc
 517      address or the reloc symbol index.
 518
 519      LOCAL_SYMS is a pointer to the swapped in local symbols.
 520
 521      LOCAL_SECTIONS is an array giving the section in the input file
 522      corresponding to the st_shndx field of each local symbol.
 523
 524      The global hash table entry for the global symbols can be found
 525      via elf_sym_hashes (input_bfd).
 526
 527      When generating relocateable output, this function must handle
 528      STB_LOCAL/STT_SECTION symbols specially.  The output symbol is
 529      going to be the section symbol corresponding to the output
 530      section, which means that the addend must be adjusted
 531      accordingly.  */
 532   boolean (*elf_backend_relocate_section)
 533     PARAMS ((bfd *output_bfd, struct bfd_link_info *info,
 534              bfd *input_bfd, asection *input_section, bfd_byte *contents,
 535              Elf_Internal_Rela *relocs, Elf_Internal_Sym *local_syms,
 536              asection **local_sections));
 537
 538   /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
 539      linker just before it writes a symbol out to the .dynsym section.
 540      The processor backend may make any required adjustment to the
 541      symbol.  It may also take the opportunity to set contents of the
 542      dynamic sections.  Note that FINISH_DYNAMIC_SYMBOL is called on
 543      all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
 544      on those symbols which are defined by a dynamic object.  */
 545   boolean (*elf_backend_finish_dynamic_symbol)
 546     PARAMS ((bfd *output_bfd, struct bfd_link_info *info,
 547              struct elf_link_hash_entry *h, Elf_Internal_Sym *sym));
 548
 549   /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
 550      linker just before it writes all the dynamic sections out to the
 551      output file.  The FINISH_DYNAMIC_SYMBOL will have been called on
 552      all dynamic symbols.  */
 553   boolean (*elf_backend_finish_dynamic_sections)
 554     PARAMS ((bfd *output_bfd, struct bfd_link_info *info));
 555
 556   /* A function to do any beginning processing needed for the ELF file
 557      before building the ELF headers and computing file positions.  */
 558   void (*elf_backend_begin_write_processing)
 559     PARAMS ((bfd *, struct bfd_link_info *));
 560
 561   /* A function to do any final processing needed for the ELF file
 562      before writing it out.  The LINKER argument is true if this BFD
 563      was created by the ELF backend linker.  */
 564   void (*elf_backend_final_write_processing)
 565     PARAMS ((bfd *, boolean linker));
 566
 567   /* This function is called by get_program_header_size.  It should
 568      return the number of additional program segments which this BFD
 569      will need.  It should return -1 on error.  */
 570   int (*elf_backend_additional_program_headers) PARAMS ((bfd *));
 571
 572   /* This function is called to modify an existing segment map in a
 573      backend specific fashion.  */
 574   boolean (*elf_backend_modify_segment_map) PARAMS ((bfd *));
 575
 576   /* This function is called during section gc to discover the section a
 577      particular relocation refers to.  It need not be defined for hosts
 578      that have no queer relocation types.  */
 579   asection * (*gc_mark_hook)
 580     PARAMS ((bfd *abfd, struct bfd_link_info *, Elf_Internal_Rela *,
 581              struct elf_link_hash_entry *h, Elf_Internal_Sym *));
 582
 583   /* This function, if defined, is called during the sweep phase of gc
 584      in order that a backend might update any data structures it might
 585      be maintaining.  */
 586   boolean (*gc_sweep_hook)
 587     PARAMS ((bfd *abfd, struct bfd_link_info *info, asection *o,
 588              const Elf_Internal_Rela *relocs));
 589
 590   /* This function, if defined, is called after the ELF headers have
 591      been created.  This allows for things like the OS and ABI versions
 592      to be changed.  */
 593   void (*elf_backend_post_process_headers)
 594     PARAMS ((bfd *, struct bfd_link_info *));
 595
 596   /* This function, if defined, prints a symbol to file and returns the
 597      name of the symbol to be printed.  It should return NULL to fall
 598      back to default symbol printing.  */
 599   const char *(*elf_backend_print_symbol_all)
 600     PARAMS ((bfd *, PTR, asymbol *));
 601
 602   /* This function, if defined, is called after all local symbols and
 603      global symbols converted to locals are emited into the symtab
 604      section.  It allows the backend to emit special global symbols
 605      not handled in the hash table.  */
 606   boolean (*elf_backend_output_arch_syms)
 607     PARAMS ((bfd *, struct bfd_link_info *, PTR,
 608             boolean (*) PARAMS ((PTR, const char *,
 609              Elf_Internal_Sym *, asection *))));
 610
 611   /* Copy any information related to dynamic linking from a pre-existing
 612      symbol IND to a newly created symbol DIR.  */
 613   void (*elf_backend_copy_indirect_symbol)
 614     PARAMS ((struct elf_link_hash_entry *, struct elf_link_hash_entry *));
 615
 616   /* Modify any information related to dynamic linking such that the
 617      symbol is not exported.  */
 618   void (*elf_backend_hide_symbol)
 619     PARAMS ((struct bfd_link_info *, struct elf_link_hash_entry *));
 620
 621   /* Emit relocations.  Overrides default routine for emitting relocs,
 622      except during a relocatable link, or if all relocs are being emitted.  */
 623   void (*elf_backend_emit_relocs)
 624     PARAMS ((bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *));
 625
 626   /* Count relocations.  Not called for relocatable links
 627      or if all relocs are being preserved in the output.  */
 628   unsigned int (*elf_backend_count_relocs)
 629     PARAMS ((asection *, Elf_Internal_Rela *));
 630
 631   /* This function, if defined, is called when an NT_PRSTATUS note is found
 632      in a core file. */
 633   boolean (*elf_backend_grok_prstatus) PARAMS ((bfd *, Elf_Internal_Note *));
 634
 635   /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
 636      note is found in a core file. */
 637   boolean (*elf_backend_grok_psinfo) PARAMS ((bfd *, Elf_Internal_Note *));
 638
 639   /* The swapping table to use when dealing with ECOFF information.
 640      Used for the MIPS ELF .mdebug section.  */
 641   const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
 642
 643   /* Alternate EM_xxxx machine codes for this backend.  */
 644   int elf_machine_alt1;
 645   int elf_machine_alt2;
 646
 647   const struct elf_size_info *s;
 648
 649   /* offset of the _GLOBAL_OFFSET_TABLE_ symbol from the start of the
 650      .got section */
 651   bfd_vma got_symbol_offset;
 652
 653   /* The size in bytes of the headers for the GOT and PLT.  This includes
 654      the so-called reserved entries on some systems.  */
 655   bfd_vma got_header_size;
 656   bfd_vma plt_header_size;
 657
 658   /* This is true if the linker should act like collect and gather
 659      global constructors and destructors by name.  This is true for
 660      MIPS ELF because the Irix 5 tools can not handle the .init
 661      section.  */
 662   unsigned collect : 1;
 663
 664   /* This is true if the linker should ignore changes to the type of a
 665      symbol.  This is true for MIPS ELF because some Irix 5 objects
 666      record undefined functions as STT_OBJECT although the definitions
 667      are STT_FUNC.  */
 668   unsigned type_change_ok : 1;
 669
 670   /* Whether the backend may use REL relocations.  (Some backends use
 671      both REL and RELA relocations, and this flag is set for those
 672      backends.)  */
 673   unsigned may_use_rel_p : 1;
 674
 675   /* Whether the backend may use RELA relocations.  (Some backends use
 676      both REL and RELA relocations, and this flag is set for those
 677      backends.)  */
 678   unsigned may_use_rela_p : 1;
 679
 680   /* Whether the default relocation type is RELA.  If a backend with
 681      this flag set wants REL relocations for a particular section,
 682      it must note that explicitly.  Similarly, if this flag is clear,
 683      and the backend wants RELA relocations for a particular
 684      section.  */
 685   unsigned default_use_rela_p : 1;
 686
 687   /* True if addresses "naturally" sign extend.  This is used when
 688      swapping in from Elf32 when BFD64.  */
 689   unsigned sign_extend_vma : 1;
 690
 691   unsigned want_got_plt : 1;
 692   unsigned plt_readonly : 1;
 693   unsigned want_plt_sym : 1;
 694   unsigned plt_not_loaded : 1;
 695   unsigned plt_alignment : 4;
 696   unsigned can_gc_sections : 1;
 697   unsigned want_dynbss : 1;
 698 };
 699
 700 /* Information stored for each BFD section in an ELF file.  This
 701    structure is allocated by elf_new_section_hook.  */
 702
 703 struct bfd_elf_section_data
 704 {
 705   /* The ELF header for this section.  */
 706   Elf_Internal_Shdr this_hdr;
 707   /* The ELF header for the reloc section associated with this
 708      section, if any.  */
 709   Elf_Internal_Shdr rel_hdr;
 710   /* If there is a second reloc section associated with this section,
 711      as can happen on Irix 6, this field points to the header.  */
 712   Elf_Internal_Shdr *rel_hdr2;
 713   /* The number of relocations currently assigned to REL_HDR.  */
 714   unsigned int rel_count;
 715   /* The number of relocations currently assigned to REL_HDR2.  */
 716   unsigned int rel_count2;
 717   /* The ELF section number of this section.  Only used for an output
 718      file.  */
 719   int this_idx;
 720   /* The ELF section number of the reloc section indicated by
 721      REL_HDR if any.  Only used for an output file.  */
 722   int rel_idx;
 723   /* The ELF section number of the reloc section indicated by
 724      REL_HDR2 if any.  Only used for an output file.  */
 725   int rel_idx2;
 726   /* Used by the backend linker to store the symbol hash table entries
 727      associated with relocs against global symbols.  */
 728   struct elf_link_hash_entry **rel_hashes;
 729   /* A pointer to the swapped relocs.  If the section uses REL relocs,
 730      rather than RELA, all the r_addend fields will be zero.  This
 731      pointer may be NULL.  It is used by the backend linker.  */
 732   Elf_Internal_Rela *relocs;
 733   /* Used by the backend linker when generating a shared library to
 734      record the dynamic symbol index for a section symbol
 735      corresponding to this section.  A value of 0 means that there is
 736      no dynamic symbol for this section.  */
 737   long dynindx;
 738   /* A pointer used for .stab linking optimizations.  */
 739   PTR stab_info;
 740   /* A pointer used for SEC_MERGE optimizations.  */
 741   PTR merge_info;
 742   /* A pointer available for the processor specific ELF backend.  */
 743   PTR tdata;
 744   /* Nonzero if this section uses RELA relocations, rather than REL.  */
 745   unsigned int use_rela_p:1;
 746 };
 747
 748 #define elf_section_data(sec)  ((struct bfd_elf_section_data*)sec->used_by_bfd)
 749
 750 #define get_elf_backend_data(abfd) \
 751   ((struct elf_backend_data *) (abfd)->xvec->backend_data)
 752
 753 /* Enumeration to specify the special section.  */
 754 typedef enum elf_linker_section_enum
 755 {
 756   LINKER_SECTION_UNKNOWN,               /* not used */
 757   LINKER_SECTION_GOT,                   /* .got section for global offset pointers */
 758   LINKER_SECTION_PLT,                   /* .plt section for generated procedure stubs */
 759   LINKER_SECTION_SDATA,                 /* .sdata/.sbss section for PowerPC */
 760   LINKER_SECTION_SDATA2,                /* .sdata2/.sbss2 section for PowerPC */
 761   LINKER_SECTION_MAX                    /* # of linker sections */
 762 } elf_linker_section_enum_t;
 763
 764 /* Sections created by the linker.  */
 765
 766 typedef struct elf_linker_section
 767 {
 768   char *name;                           /* name of the section */
 769   char *rel_name;                       /* name of the associated .rel{,a}. section */
 770   char *bss_name;                       /* name of a related .bss section */
 771   char *sym_name;                       /* name of symbol to reference this section */
 772   asection *section;                    /* pointer to the section */
 773   asection *bss_section;                /* pointer to the bss section associated with this */
 774   asection *rel_section;                /* pointer to the relocations needed for this section */
 775   struct elf_link_hash_entry *sym_hash; /* pointer to the created symbol hash value */
 776   bfd_vma initial_size;                 /* initial size before any linker generated allocations */
 777   bfd_vma sym_offset;                   /* offset of symbol from beginning of section */
 778   bfd_vma hole_size;                    /* size of reserved address hole in allocation */
 779   bfd_vma hole_offset;                  /* current offset for the hole */
 780   bfd_vma max_hole_offset;              /* maximum offset for the hole */
 781   elf_linker_section_enum_t which;      /* which section this is */
 782   boolean hole_written_p;               /* whether the hole has been initialized */
 783   unsigned int alignment;               /* alignment for the section */
 784   flagword flags;                       /* flags to use to create the section */
 785 } elf_linker_section_t;
 786
 787 /* Linked list of allocated pointer entries.  This hangs off of the symbol lists, and
 788    provides allows us to return different pointers, based on different addend's.  */
 789
 790 typedef struct elf_linker_section_pointers
 791 {
 792   struct elf_linker_section_pointers *next;     /* next allocated pointer for this symbol */
 793   bfd_vma offset;                               /* offset of pointer from beginning of section */
 794   bfd_signed_vma addend;                        /* addend used */
 795   elf_linker_section_enum_t which;              /* which linker section this is */
 796   boolean written_address_p;                    /* whether address was written yet */
 797 } elf_linker_section_pointers_t;
 798
 799 /* Some private data is stashed away for future use using the tdata pointer
 800    in the bfd structure.  */
 801
 802 struct elf_obj_tdata
 803 {
 804   Elf_Internal_Ehdr elf_header[1];      /* Actual data, but ref like ptr */
 805   Elf_Internal_Shdr **elf_sect_ptr;
 806   Elf_Internal_Phdr *phdr;
 807   struct elf_segment_map *segment_map;
 808   struct bfd_strtab_hash *strtab_ptr;
 809   int num_locals;
 810   int num_globals;
 811   asymbol **section_syms;               /* STT_SECTION symbols for each section */
 812   Elf_Internal_Shdr symtab_hdr;
 813   Elf_Internal_Shdr shstrtab_hdr;
 814   Elf_Internal_Shdr strtab_hdr;
 815   Elf_Internal_Shdr dynsymtab_hdr;
 816   Elf_Internal_Shdr dynstrtab_hdr;
 817   Elf_Internal_Shdr dynversym_hdr;
 818   Elf_Internal_Shdr dynverref_hdr;
 819   Elf_Internal_Shdr dynverdef_hdr;
 820   unsigned int symtab_section, shstrtab_section;
 821   unsigned int strtab_section, dynsymtab_section;
 822   unsigned int dynversym_section, dynverdef_section, dynverref_section;
 823   file_ptr next_file_pos;
 824 #if 0
 825   /* we don't need these inside bfd anymore, and I think
 826      these weren't used outside bfd.  */
 827   void *prstatus;                       /* The raw /proc prstatus structure */
 828   void *prpsinfo;                       /* The raw /proc prpsinfo structure */
 829 #endif
 830   bfd_vma gp;                           /* The gp value (MIPS only, for now) */
 831   unsigned int gp_size;                 /* The gp size (MIPS only, for now) */
 832
 833   /* Information grabbed from an elf core file.  */
 834   int core_signal;
 835   int core_pid;
 836   int core_lwpid;
 837   char* core_program;
 838   char* core_command;
 839
 840   /* This is set to true if the object was created by the backend
 841      linker.  */
 842   boolean linker;
 843
 844   /* A mapping from external symbols to entries in the linker hash
 845      table, used when linking.  This is indexed by the symbol index
 846      minus the sh_info field of the symbol table header.  */
 847   struct elf_link_hash_entry **sym_hashes;
 848
 849   /* A mapping from local symbols to offsets into the global offset
 850      table, used when linking.  This is indexed by the symbol index.
 851      Like for the globals, we use a union and two names primarily to
 852      document the intent of any particular piece of code.  The field
 853      should be used as a count until size_dynamic_sections, at which
 854      point the contents of the .got is fixed.  Afterward, if an entry
 855      is -1, then the symbol does not require a global offset table entry.  */
 856   union
 857     {
 858       bfd_signed_vma *refcounts;
 859       bfd_vma *offsets;
 860     } local_got;
 861
 862   /* A mapping from local symbols to offsets into the various linker
 863      sections added.  This is index by the symbol index.  */
 864   elf_linker_section_pointers_t **linker_section_pointers;
 865
 866   /* The linker ELF emulation code needs to let the backend ELF linker
 867      know what filename should be used for a dynamic object if the
 868      dynamic object is found using a search.  The emulation code then
 869      sometimes needs to know what name was actually used.  Until the
 870      file has been added to the linker symbol table, this field holds
 871      the name the linker wants.  After it has been added, it holds the
 872      name actually used, which will be the DT_SONAME entry if there is
 873      one.  */
 874   const char *dt_name;
 875
 876   /* When a reference in a regular object is resolved by a shared
 877      object is loaded into via the DT_NEEDED entries by the linker
 878      ELF emulation code, we need to add the shared object to the
 879      DT_NEEDED list of the resulting binary to indicate the dependency
 880      as if the -l option is passed to the linker. This field holds the
 881      name of the loaded shared object.  */
 882   const char *dt_soname;
 883
 884   /* Irix 5 often screws up the symbol table, sorting local symbols
 885      after global symbols.  This flag is set if the symbol table in
 886      this BFD appears to be screwed up.  If it is, we ignore the
 887      sh_info field in the symbol table header, and always read all the
 888      symbols.  */
 889   boolean bad_symtab;
 890
 891   /* Records the result of `get_program_header_size'.  */
 892   bfd_size_type program_header_size;
 893
 894   /* Used by find_nearest_line entry point.  */
 895   PTR line_info;
 896
 897   /* Used by MIPS ELF find_nearest_line entry point.  The structure
 898      could be included directly in this one, but there's no point to
 899      wasting the memory just for the infrequently called
 900      find_nearest_line.  */
 901   struct mips_elf_find_line *find_line_info;
 902
 903   /* A place to stash dwarf1 info for this bfd.  */
 904   struct dwarf1_debug *dwarf1_find_line_info;
 905
 906   /* A place to stash dwarf2 info for this bfd.  */
 907   PTR dwarf2_find_line_info;
 908
 909   /* An array of stub sections indexed by symbol number, used by the
 910      MIPS ELF linker.  FIXME: We should figure out some way to only
 911      include this field for a MIPS ELF target.  */
 912   asection **local_stubs;
 913
 914   /* Used to determine if the e_flags field has been initialized */
 915   boolean flags_init;
 916
 917   /* Number of symbol version definitions we are about to emit.  */
 918   unsigned int cverdefs;
 919
 920   /* Number of symbol version references we are about to emit.  */
 921   unsigned int cverrefs;
 922
 923   /* Symbol version definitions in external objects.  */
 924   Elf_Internal_Verdef *verdef;
 925
 926   /* Symbol version references to external objects.  */
 927   Elf_Internal_Verneed *verref;
 928
 929   /* Linker sections that we are interested in.  */
 930   struct elf_linker_section *linker_section[ (int)LINKER_SECTION_MAX ];
 931
 932   /* The Irix 5 support uses two virtual sections, which represent
 933      text/data symbols defined in dynamic objects.  */
 934   asymbol *elf_data_symbol;
 935   asymbol *elf_text_symbol;
 936   asection *elf_data_section;
 937   asection *elf_text_section;
 938 };
 939
 940 #define elf_tdata(bfd)          ((bfd) -> tdata.elf_obj_data)
 941 #define elf_elfheader(bfd)      (elf_tdata(bfd) -> elf_header)
 942 #define elf_elfsections(bfd)    (elf_tdata(bfd) -> elf_sect_ptr)
 943 #define elf_shstrtab(bfd)       (elf_tdata(bfd) -> strtab_ptr)
 944 #define elf_onesymtab(bfd)      (elf_tdata(bfd) -> symtab_section)
 945 #define elf_dynsymtab(bfd)      (elf_tdata(bfd) -> dynsymtab_section)
 946 #define elf_dynversym(bfd)      (elf_tdata(bfd) -> dynversym_section)
 947 #define elf_dynverdef(bfd)      (elf_tdata(bfd) -> dynverdef_section)
 948 #define elf_dynverref(bfd)      (elf_tdata(bfd) -> dynverref_section)
 949 #define elf_num_locals(bfd)     (elf_tdata(bfd) -> num_locals)
 950 #define elf_num_globals(bfd)    (elf_tdata(bfd) -> num_globals)
 951 #define elf_section_syms(bfd)   (elf_tdata(bfd) -> section_syms)
 952 #define core_prpsinfo(bfd)      (elf_tdata(bfd) -> prpsinfo)
 953 #define core_prstatus(bfd)      (elf_tdata(bfd) -> prstatus)
 954 #define elf_gp(bfd)             (elf_tdata(bfd) -> gp)
 955 #define elf_gp_size(bfd)        (elf_tdata(bfd) -> gp_size)
 956 #define elf_sym_hashes(bfd)     (elf_tdata(bfd) -> sym_hashes)
 957 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
 958 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
 959 #define elf_local_ptr_offsets(bfd) (elf_tdata(bfd) -> linker_section_pointers)
 960 #define elf_dt_name(bfd)        (elf_tdata(bfd) -> dt_name)
 961 #define elf_dt_soname(bfd)      (elf_tdata(bfd) -> dt_soname)
 962 #define elf_bad_symtab(bfd)     (elf_tdata(bfd) -> bad_symtab)
 963 #define elf_flags_init(bfd)     (elf_tdata(bfd) -> flags_init)
 964 #define elf_linker_section(bfd,n) (elf_tdata(bfd) -> linker_section[(int)n])
 965 \f
 966 extern void _bfd_elf_swap_verdef_in
 967   PARAMS ((bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *));
 968 extern void _bfd_elf_swap_verdef_out
 969   PARAMS ((bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *));
 970 extern void _bfd_elf_swap_verdaux_in
 971   PARAMS ((bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *));
 972 extern void _bfd_elf_swap_verdaux_out
 973   PARAMS ((bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *));
 974 extern void _bfd_elf_swap_verneed_in
 975   PARAMS ((bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *));
 976 extern void _bfd_elf_swap_verneed_out
 977   PARAMS ((bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *));
 978 extern void _bfd_elf_swap_vernaux_in
 979   PARAMS ((bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *));
 980 extern void _bfd_elf_swap_vernaux_out
 981   PARAMS ((bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *));
 982 extern void _bfd_elf_swap_versym_in
 983   PARAMS ((bfd *, const Elf_External_Versym *, Elf_Internal_Versym *));
 984 extern void _bfd_elf_swap_versym_out
 985   PARAMS ((bfd *, const Elf_Internal_Versym *, Elf_External_Versym *));
 986
 987 extern int _bfd_elf_section_from_bfd_section PARAMS ((bfd *, asection *));
 988 extern char *bfd_elf_string_from_elf_section
 989   PARAMS ((bfd *, unsigned, unsigned));
 990 extern char *bfd_elf_get_str_section PARAMS ((bfd *, unsigned));
 991
 992 extern boolean _bfd_elf_print_private_bfd_data PARAMS ((bfd *, PTR));
 993 extern void bfd_elf_print_symbol PARAMS ((bfd *, PTR, asymbol *,
 994                                           bfd_print_symbol_type));
 995 #define elf_string_from_elf_strtab(abfd,strindex) \
 996      bfd_elf_string_from_elf_section(abfd,elf_elfheader(abfd)->e_shstrndx,strindex)
 997
 998 #define bfd_elf32_print_symbol  bfd_elf_print_symbol
 999 #define bfd_elf64_print_symbol  bfd_elf_print_symbol
1000
1001 extern unsigned long bfd_elf_hash PARAMS ((const char *));
1002
1003 extern bfd_reloc_status_type bfd_elf_generic_reloc PARAMS ((bfd *,
1004                                                             arelent *,
1005                                                             asymbol *,
1006                                                             PTR,
1007                                                             asection *,
1008                                                             bfd *,
1009                                                             char **));
1010 extern boolean bfd_elf_mkobject PARAMS ((bfd *));
1011 extern boolean bfd_elf_mkcorefile PARAMS ((bfd *));
1012 extern Elf_Internal_Shdr *bfd_elf_find_section PARAMS ((bfd *, char *));
1013 extern boolean _bfd_elf_make_section_from_shdr
1014   PARAMS ((bfd *abfd, Elf_Internal_Shdr *hdr, const char *name));
1015 extern boolean _bfd_elf_make_section_from_phdr
1016   PARAMS ((bfd *abfd, Elf_Internal_Phdr *hdr, int index, const char *typename));
1017 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
1018   PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
1019 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
1020   PARAMS ((bfd *));
1021 extern void _bfd_elf_link_hash_copy_indirect
1022   PARAMS ((struct elf_link_hash_entry *, struct elf_link_hash_entry *));
1023 extern void _bfd_elf_link_hash_hide_symbol
1024   PARAMS ((struct bfd_link_info *, struct elf_link_hash_entry *));
1025 extern boolean _bfd_elf_link_hash_table_init
1026   PARAMS ((struct elf_link_hash_table *, bfd *,
1027            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
1028                                        struct bfd_hash_table *,
1029                                        const char *)));
1030 extern boolean _bfd_elf_slurp_version_tables PARAMS ((bfd *));
1031
1032 extern boolean _bfd_elf_merge_sections
1033   PARAMS ((bfd *, struct bfd_link_info *));
1034
1035 extern boolean _bfd_elf_copy_private_symbol_data
1036   PARAMS ((bfd *, asymbol *, bfd *, asymbol *));
1037 extern boolean _bfd_elf_copy_private_section_data
1038   PARAMS ((bfd *, asection *, bfd *, asection *));
1039 extern boolean _bfd_elf_write_object_contents PARAMS ((bfd *));
1040 extern boolean _bfd_elf_write_corefile_contents PARAMS ((bfd *));
1041 extern boolean _bfd_elf_set_section_contents PARAMS ((bfd *, sec_ptr, PTR,
1042                                                        file_ptr,
1043                                                        bfd_size_type));
1044 extern long _bfd_elf_get_symtab_upper_bound PARAMS ((bfd *));
1045 extern long _bfd_elf_get_symtab PARAMS ((bfd *, asymbol **));
1046 extern long _bfd_elf_get_dynamic_symtab_upper_bound PARAMS ((bfd *));
1047 extern long _bfd_elf_canonicalize_dynamic_symtab PARAMS ((bfd *, asymbol **));
1048 extern long _bfd_elf_get_reloc_upper_bound PARAMS ((bfd *, sec_ptr));
1049 extern long _bfd_elf_canonicalize_reloc PARAMS ((bfd *, sec_ptr,
1050                                                   arelent **, asymbol **));
1051 extern long _bfd_elf_get_dynamic_reloc_upper_bound PARAMS ((bfd *));
1052 extern long _bfd_elf_canonicalize_dynamic_reloc PARAMS ((bfd *, arelent **,
1053                                                          asymbol **));
1054 extern asymbol *_bfd_elf_make_empty_symbol PARAMS ((bfd *));
1055 extern void _bfd_elf_get_symbol_info PARAMS ((bfd *, asymbol *,
1056                                                symbol_info *));
1057 extern boolean _bfd_elf_is_local_label_name PARAMS ((bfd *, const char *));
1058 extern alent *_bfd_elf_get_lineno PARAMS ((bfd *, asymbol *));
1059 extern boolean _bfd_elf_set_arch_mach PARAMS ((bfd *, enum bfd_architecture,
1060                                                 unsigned long));
1061 extern boolean _bfd_elf_find_nearest_line PARAMS ((bfd *, asection *,
1062                                                     asymbol **,
1063                                                     bfd_vma, const char **,
1064                                                     const char **,
1065                                                     unsigned int *));
1066 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
1067 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
1068 extern int _bfd_elf_sizeof_headers PARAMS ((bfd *, boolean));
1069 extern boolean _bfd_elf_new_section_hook PARAMS ((bfd *, asection *));
1070 extern boolean _bfd_elf_init_reloc_shdr
1071   PARAMS ((bfd *, Elf_Internal_Shdr *, asection *, boolean));
1072
1073 /* If the target doesn't have reloc handling written yet:  */
1074 extern void _bfd_elf_no_info_to_howto PARAMS ((bfd *, arelent *,
1075                                                Elf_Internal_Rela *));
1076
1077 extern boolean bfd_section_from_shdr PARAMS ((bfd *, unsigned int shindex));
1078 extern boolean bfd_section_from_phdr PARAMS ((bfd *, Elf_Internal_Phdr *, int));
1079
1080 extern int _bfd_elf_symbol_from_bfd_symbol PARAMS ((bfd *, asymbol **));
1081
1082 asection *bfd_section_from_elf_index PARAMS ((bfd *, unsigned int));
1083 boolean _bfd_elf_create_dynamic_sections PARAMS ((bfd *,
1084                                                   struct bfd_link_info *));
1085 struct bfd_strtab_hash *_bfd_elf_stringtab_init PARAMS ((void));
1086 boolean
1087 _bfd_elf_link_record_dynamic_symbol PARAMS ((struct bfd_link_info *,
1088                                              struct elf_link_hash_entry *));
1089 long
1090 _bfd_elf_link_lookup_local_dynindx PARAMS ((struct bfd_link_info *,
1091                                             bfd *, long));
1092 boolean
1093 _bfd_elf_compute_section_file_positions PARAMS ((bfd *,
1094                                                  struct bfd_link_info *));
1095 void _bfd_elf_assign_file_positions_for_relocs PARAMS ((bfd *));
1096 file_ptr _bfd_elf_assign_file_position_for_section PARAMS ((Elf_Internal_Shdr *,
1097                                                             file_ptr,
1098                                                             boolean));
1099
1100 extern boolean _bfd_elf_validate_reloc PARAMS ((bfd *, arelent *));
1101
1102 boolean _bfd_elf_create_dynamic_sections PARAMS ((bfd *,
1103                                                   struct bfd_link_info *));
1104 boolean _bfd_elf_create_got_section PARAMS ((bfd *,
1105                                              struct bfd_link_info *));
1106 unsigned long _bfd_elf_link_renumber_dynsyms PARAMS ((bfd *,
1107                                                       struct bfd_link_info *));
1108
1109 boolean _bfd_elfcore_make_pseudosection PARAMS ((bfd *, char *, int, int));
1110 char *_bfd_elfcore_strndup PARAMS ((bfd *, char *, int));
1111
1112 elf_linker_section_t *_bfd_elf_create_linker_section
1113   PARAMS ((bfd *abfd,
1114            struct bfd_link_info *info,
1115            enum elf_linker_section_enum,
1116            elf_linker_section_t *defaults));
1117
1118 elf_linker_section_pointers_t *_bfd_elf_find_pointer_linker_section
1119   PARAMS ((elf_linker_section_pointers_t *linker_pointers,
1120            bfd_signed_vma addend,
1121            elf_linker_section_enum_t which));
1122
1123 boolean bfd_elf32_create_pointer_linker_section
1124   PARAMS ((bfd *abfd,
1125            struct bfd_link_info *info,
1126            elf_linker_section_t *lsect,
1127            struct elf_link_hash_entry *h,
1128            const Elf32_Internal_Rela *rel));
1129
1130 bfd_vma bfd_elf32_finish_pointer_linker_section
1131   PARAMS ((bfd *output_abfd,
1132            bfd *input_bfd,
1133            struct bfd_link_info *info,
1134            elf_linker_section_t *lsect,
1135            struct elf_link_hash_entry *h,
1136            bfd_vma relocation,
1137            const Elf32_Internal_Rela *rel,
1138            int relative_reloc));
1139
1140 boolean bfd_elf64_create_pointer_linker_section
1141   PARAMS ((bfd *abfd,
1142            struct bfd_link_info *info,
1143            elf_linker_section_t *lsect,
1144            struct elf_link_hash_entry *h,
1145            const Elf64_Internal_Rela *rel));
1146
1147 bfd_vma bfd_elf64_finish_pointer_linker_section
1148   PARAMS ((bfd *output_abfd,
1149            bfd *input_bfd,
1150            struct bfd_link_info *info,
1151            elf_linker_section_t *lsect,
1152            struct elf_link_hash_entry *h,
1153            bfd_vma relocation,
1154            const Elf64_Internal_Rela *rel,
1155            int relative_reloc));
1156
1157 boolean _bfd_elf_make_linker_section_rela
1158   PARAMS ((bfd *dynobj,
1159            elf_linker_section_t *lsect,
1160            int alignment));
1161
1162 boolean _bfd_elfcore_section_from_phdr
1163   PARAMS ((bfd *, Elf_Internal_Phdr *, int));
1164
1165 extern const bfd_target *bfd_elf32_object_p PARAMS ((bfd *));
1166 extern const bfd_target *bfd_elf32_core_file_p PARAMS ((bfd *));
1167 extern char *bfd_elf32_core_file_failing_command PARAMS ((bfd *));
1168 extern int bfd_elf32_core_file_failing_signal PARAMS ((bfd *));
1169 extern boolean bfd_elf32_core_file_matches_executable_p PARAMS ((bfd *,
1170                                                                  bfd *));
1171
1172 extern boolean bfd_elf32_bfd_link_add_symbols
1173   PARAMS ((bfd *, struct bfd_link_info *));
1174 extern boolean bfd_elf32_bfd_final_link
1175   PARAMS ((bfd *, struct bfd_link_info *));
1176
1177 extern void bfd_elf32_swap_symbol_in
1178   PARAMS ((bfd *, const Elf32_External_Sym *, Elf_Internal_Sym *));
1179 extern void bfd_elf32_swap_symbol_out
1180   PARAMS ((bfd *, const Elf_Internal_Sym *, PTR));
1181 extern void bfd_elf32_swap_reloc_in
1182   PARAMS ((bfd *, const Elf32_External_Rel *, Elf_Internal_Rel *));
1183 extern void bfd_elf32_swap_reloc_out
1184   PARAMS ((bfd *, const Elf_Internal_Rel *, Elf32_External_Rel *));
1185 extern void bfd_elf32_swap_reloca_in
1186   PARAMS ((bfd *, const Elf32_External_Rela *, Elf_Internal_Rela *));
1187 extern void bfd_elf32_swap_reloca_out
1188   PARAMS ((bfd *, const Elf_Internal_Rela *, Elf32_External_Rela *));
1189 extern void bfd_elf32_swap_phdr_in
1190   PARAMS ((bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *));
1191 extern void bfd_elf32_swap_phdr_out
1192   PARAMS ((bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *));
1193 extern void bfd_elf32_swap_dyn_in
1194   PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
1195 extern void bfd_elf32_swap_dyn_out
1196   PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR));
1197 extern long bfd_elf32_slurp_symbol_table
1198   PARAMS ((bfd *, asymbol **, boolean));
1199 extern boolean bfd_elf32_write_shdrs_and_ehdr PARAMS ((bfd *));
1200 extern int bfd_elf32_write_out_phdrs
1201   PARAMS ((bfd *, const Elf_Internal_Phdr *, int));
1202 extern void bfd_elf32_write_relocs
1203   PARAMS ((bfd *, asection *, PTR));
1204 extern boolean bfd_elf32_slurp_reloc_table
1205   PARAMS ((bfd *, asection *, asymbol **, boolean));
1206 extern boolean bfd_elf32_add_dynamic_entry
1207   PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma));
1208 extern boolean bfd_elf32_link_create_dynamic_sections
1209   PARAMS ((bfd *, struct bfd_link_info *));
1210 extern Elf_Internal_Rela *_bfd_elf32_link_read_relocs
1211   PARAMS ((bfd *, asection *, PTR, Elf_Internal_Rela *, boolean));
1212
1213 extern const bfd_target *bfd_elf64_object_p PARAMS ((bfd *));
1214 extern const bfd_target *bfd_elf64_core_file_p PARAMS ((bfd *));
1215 extern char *bfd_elf64_core_file_failing_command PARAMS ((bfd *));
1216 extern int bfd_elf64_core_file_failing_signal PARAMS ((bfd *));
1217 extern boolean bfd_elf64_core_file_matches_executable_p PARAMS ((bfd *,
1218                                                                  bfd *));
1219 extern boolean bfd_elf64_bfd_link_add_symbols
1220   PARAMS ((bfd *, struct bfd_link_info *));
1221 extern boolean bfd_elf64_bfd_final_link
1222   PARAMS ((bfd *, struct bfd_link_info *));
1223
1224 extern void bfd_elf64_swap_symbol_in
1225   PARAMS ((bfd *, const Elf64_External_Sym *, Elf_Internal_Sym *));
1226 extern void bfd_elf64_swap_symbol_out
1227   PARAMS ((bfd *, const Elf_Internal_Sym *, PTR));
1228 extern void bfd_elf64_swap_reloc_in
1229   PARAMS ((bfd *, const Elf64_External_Rel *, Elf_Internal_Rel *));
1230 extern void bfd_elf64_swap_reloc_out
1231   PARAMS ((bfd *, const Elf_Internal_Rel *, Elf64_External_Rel *));
1232 extern void bfd_elf64_swap_reloca_in
1233   PARAMS ((bfd *, const Elf64_External_Rela *, Elf_Internal_Rela *));
1234 extern void bfd_elf64_swap_reloca_out
1235   PARAMS ((bfd *, const Elf_Internal_Rela *, Elf64_External_Rela *));
1236 extern void bfd_elf64_swap_phdr_in
1237   PARAMS ((bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *));
1238 extern void bfd_elf64_swap_phdr_out
1239   PARAMS ((bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *));
1240 extern void bfd_elf64_swap_dyn_in
1241   PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *));
1242 extern void bfd_elf64_swap_dyn_out
1243   PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR));
1244 extern long bfd_elf64_slurp_symbol_table
1245   PARAMS ((bfd *, asymbol **, boolean));
1246 extern boolean bfd_elf64_write_shdrs_and_ehdr PARAMS ((bfd *));
1247 extern int bfd_elf64_write_out_phdrs
1248   PARAMS ((bfd *, const Elf_Internal_Phdr *, int));
1249 extern void bfd_elf64_write_relocs
1250   PARAMS ((bfd *, asection *, PTR));
1251 extern boolean bfd_elf64_slurp_reloc_table
1252   PARAMS ((bfd *, asection *, asymbol **, boolean));
1253 extern boolean bfd_elf64_add_dynamic_entry
1254   PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma));
1255 extern boolean bfd_elf64_link_create_dynamic_sections
1256   PARAMS ((bfd *, struct bfd_link_info *));
1257 extern Elf_Internal_Rela *_bfd_elf64_link_read_relocs
1258   PARAMS ((bfd *, asection *, PTR, Elf_Internal_Rela *, boolean));
1259
1260 #define bfd_elf32_link_record_dynamic_symbol \
1261   _bfd_elf_link_record_dynamic_symbol
1262 #define bfd_elf64_link_record_dynamic_symbol \
1263   _bfd_elf_link_record_dynamic_symbol
1264
1265 boolean _bfd_elf32_link_record_local_dynamic_symbol
1266   PARAMS ((struct bfd_link_info *, bfd *, long));
1267 boolean _bfd_elf64_link_record_local_dynamic_symbol
1268   PARAMS ((struct bfd_link_info *, bfd *, long));
1269
1270 extern boolean _bfd_elf_close_and_cleanup PARAMS ((bfd *));
1271 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
1272   PARAMS ((bfd *, arelent *, struct symbol_cache_entry *, PTR,
1273            asection *, bfd *, char **));
1274
1275 boolean _bfd_elf32_gc_sections
1276   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1277 boolean _bfd_elf32_gc_common_finalize_got_offsets
1278   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1279 boolean _bfd_elf32_gc_common_final_link
1280   PARAMS ((bfd *, struct bfd_link_info *));
1281 boolean _bfd_elf32_gc_record_vtinherit
1282   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1283 boolean _bfd_elf32_gc_record_vtentry
1284   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1285
1286 boolean _bfd_elf64_gc_sections
1287   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1288 boolean _bfd_elf64_gc_common_finalize_got_offsets
1289   PARAMS ((bfd *abfd, struct bfd_link_info *info));
1290 boolean _bfd_elf64_gc_common_final_link
1291   PARAMS ((bfd *, struct bfd_link_info *));
1292 boolean _bfd_elf64_gc_record_vtinherit
1293   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1294 boolean _bfd_elf64_gc_record_vtentry
1295   PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma));
1296
1297 /* MIPS ELF specific routines.  */
1298
1299 extern boolean _bfd_mips_elf_object_p PARAMS ((bfd *));
1300 extern boolean _bfd_mips_elf_section_from_shdr
1301   PARAMS ((bfd *, Elf_Internal_Shdr *, char *));
1302 extern boolean _bfd_mips_elf_fake_sections
1303   PARAMS ((bfd *, Elf_Internal_Shdr *, asection *));
1304 extern boolean _bfd_mips_elf_section_from_bfd_section
1305   PARAMS ((bfd *, Elf_Internal_Shdr *, asection *, int *));
1306 extern boolean _bfd_mips_elf_section_processing
1307   PARAMS ((bfd *, Elf_Internal_Shdr *));
1308 extern void _bfd_mips_elf_symbol_processing PARAMS ((bfd *, asymbol *));
1309 extern boolean _bfd_mips_elf_read_ecoff_info
1310   PARAMS ((bfd *, asection *, struct ecoff_debug_info *));
1311 extern void _bfd_mips_elf_final_write_processing PARAMS ((bfd *, boolean));
1312 extern bfd_reloc_status_type _bfd_mips_elf_hi16_reloc
1313   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1314 extern bfd_reloc_status_type _bfd_mips_elf_lo16_reloc
1315   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1316 extern bfd_reloc_status_type _bfd_mips_elf_gprel16_reloc
1317   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1318 extern bfd_reloc_status_type _bfd_mips_elf_got16_reloc
1319   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1320 extern bfd_reloc_status_type _bfd_mips_elf_gprel32_reloc
1321   PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **));
1322 extern boolean _bfd_mips_elf_set_private_flags PARAMS ((bfd *, flagword));
1323 extern boolean _bfd_mips_elf_copy_private_bfd_data PARAMS ((bfd *, bfd *));
1324 extern boolean _bfd_mips_elf_merge_private_bfd_data PARAMS ((bfd *, bfd *));
1325 extern boolean _bfd_mips_elf_find_nearest_line
1326   PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **,
1327            const char **, unsigned int *));
1328 extern boolean _bfd_mips_elf_set_section_contents
1329   PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type));
1330 extern boolean _bfd_mips_elf_create_dynamic_sections
1331   PARAMS ((bfd *, struct bfd_link_info *));
1332 extern boolean _bfd_mips_elf_add_symbol_hook
1333   PARAMS ((bfd *, struct bfd_link_info *, const Elf_Internal_Sym *,
1334            const char **, flagword *, asection **, bfd_vma *));
1335 extern boolean _bfd_mips_elf_adjust_dynamic_symbol
1336   PARAMS ((struct bfd_link_info *, struct elf_link_hash_entry *));
1337 extern boolean _bfd_mips_elf_finish_dynamic_symbol
1338   PARAMS ((bfd *, struct bfd_link_info *, struct elf_link_hash_entry *,
1339            Elf_Internal_Sym *));
1340 extern boolean _bfd_mips_elf_finish_dynamic_sections
1341   PARAMS ((bfd *, struct bfd_link_info *));
1342 extern asection * _bfd_mips_elf_gc_mark_hook
1343   PARAMS ((bfd *, struct bfd_link_info *, Elf_Internal_Rela *,
1344            struct elf_link_hash_entry *, Elf_Internal_Sym *));
1345 extern boolean _bfd_mips_elf_gc_sweep_hook
1346   PARAMS ((bfd *, struct bfd_link_info *, asection *,
1347            const Elf_Internal_Rela *));
1348 extern boolean _bfd_mips_elf_always_size_sections
1349   PARAMS ((bfd *, struct bfd_link_info *));
1350 extern boolean _bfd_mips_elf_size_dynamic_sections
1351   PARAMS ((bfd *, struct bfd_link_info *));
1352 extern boolean _bfd_mips_elf_check_relocs
1353   PARAMS ((bfd *, struct bfd_link_info *, asection *,
1354            const Elf_Internal_Rela *));
1355 extern struct bfd_link_hash_table *_bfd_mips_elf_link_hash_table_create
1356   PARAMS ((bfd *));
1357 extern boolean _bfd_mips_elf_print_private_bfd_data
1358   PARAMS ((bfd *, PTR));
1359 extern boolean _bfd_mips_elf_link_output_symbol_hook
1360   PARAMS ((bfd *, struct bfd_link_info *, const char *, Elf_Internal_Sym *,
1361            asection *));
1362 extern boolean _bfd_mips_elf_final_link
1363   PARAMS ((bfd *, struct bfd_link_info *));
1364 extern int _bfd_mips_elf_additional_program_headers PARAMS ((bfd *));
1365 extern boolean _bfd_mips_elf_modify_segment_map PARAMS ((bfd *));
1366 extern boolean _bfd_mips_elf_relocate_section
1367   PARAMS ((bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
1368            Elf_Internal_Rela *, Elf_Internal_Sym *, asection **));
1369
1370 /* SH ELF specific routine.  */
1371
1372 extern boolean _sh_elf_set_mach_from_flags PARAMS ((bfd *));
1373
1374 #endif /* _LIBELF_H_ */