Home | History | Annotate | Line # | Download | only in bfd
elf-bfd.h revision 1.1.1.1
      1 /* BFD back-end data structures for ELF files.
      2    Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
      3    2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
      4    Free Software Foundation, Inc.
      5    Written by Cygnus Support.
      6 
      7    This file is part of BFD, the Binary File Descriptor library.
      8 
      9    This program is free software; you can redistribute it and/or modify
     10    it under the terms of the GNU General Public License as published by
     11    the Free Software Foundation; either version 3 of the License, or
     12    (at your option) any later version.
     13 
     14    This program is distributed in the hope that it will be useful,
     15    but WITHOUT ANY WARRANTY; without even the implied warranty of
     16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     17    GNU General Public License for more details.
     18 
     19    You should have received a copy of the GNU General Public License
     20    along with this program; if not, write to the Free Software
     21    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
     22    MA 02110-1301, USA.  */
     23 
     24 #ifndef _LIBELF_H_
     25 #define _LIBELF_H_ 1
     26 
     27 #include "elf/common.h"
     28 #include "elf/external.h"
     29 #include "elf/internal.h"
     30 #include "bfdlink.h"
     31 
     32 /* The number of entries in a section is its size divided by the size
     33    of a single entry.  This is normally only applicable to reloc and
     34    symbol table sections.
     35    PR 9934: It is possible to have relocations that do not refer to
     36    symbols, thus it is also possible to have a relocation section in
     37    an object file, but no symbol table.  */
     38 #define NUM_SHDR_ENTRIES(shdr) ((shdr)->sh_entsize > 0 ? (shdr)->sh_size / (shdr)->sh_entsize : 0)
     39 
     40 /* If size isn't specified as 64 or 32, NAME macro should fail.  */
     41 #ifndef NAME
     42 #if ARCH_SIZE == 64
     43 #define NAME(x, y) x ## 64 ## _ ## y
     44 #endif
     45 #if ARCH_SIZE == 32
     46 #define NAME(x, y) x ## 32 ## _ ## y
     47 #endif
     48 #endif
     49 
     50 #ifndef NAME
     51 #define NAME(x, y) x ## NOSIZE ## _ ## y
     52 #endif
     53 
     54 #define ElfNAME(X)	NAME(Elf,X)
     55 #define elfNAME(X)	NAME(elf,X)
     56 
     57 /* Information held for an ELF symbol.  The first field is the
     58    corresponding asymbol.  Every symbol is an ELF file is actually a
     59    pointer to this structure, although it is often handled as a
     60    pointer to an asymbol.  */
     61 
     62 typedef struct
     63 {
     64   /* The BFD symbol.  */
     65   asymbol symbol;
     66   /* ELF symbol information.  */
     67   Elf_Internal_Sym internal_elf_sym;
     68   /* Backend specific information.  */
     69   union
     70     {
     71       unsigned int hppa_arg_reloc;
     72       void *mips_extr;
     73       void *any;
     74     }
     75   tc_data;
     76 
     77   /* Version information.  This is from an Elf_Internal_Versym
     78      structure in a SHT_GNU_versym section.  It is zero if there is no
     79      version information.  */
     80   unsigned short version;
     81 
     82 } elf_symbol_type;
     83 
     84 struct elf_strtab_hash;
     86 struct got_entry;
     87 struct plt_entry;
     88 
     89 union gotplt_union
     90   {
     91     bfd_signed_vma refcount;
     92     bfd_vma offset;
     93     struct got_entry *glist;
     94     struct plt_entry *plist;
     95   };
     96 
     97 struct elf_link_virtual_table_entry
     98   {
     99     /* Virtual table entry use information.  This array is nominally of size
    100        size/sizeof(target_void_pointer), though we have to be able to assume
    101        and track a size while the symbol is still undefined.  It is indexed
    102        via offset/sizeof(target_void_pointer).  */
    103     size_t size;
    104     bfd_boolean *used;
    105 
    106     /* Virtual table derivation info.  */
    107     struct elf_link_hash_entry *parent;
    108   };
    109 
    110 /* ELF linker hash table entries.  */
    111 
    112 struct elf_link_hash_entry
    113 {
    114   struct bfd_link_hash_entry root;
    115 
    116   /* Symbol index in output file.  This is initialized to -1.  It is
    117      set to -2 if the symbol is used by a reloc.  */
    118   long indx;
    119 
    120   /* Symbol index as a dynamic symbol.  Initialized to -1, and remains
    121      -1 if this is not a dynamic symbol.  */
    122   /* ??? Note that this is consistently used as a synonym for tests
    123      against whether we can perform various simplifying transformations
    124      to the code.  (E.g. changing a pc-relative jump to a PLT entry
    125      into a pc-relative jump to the target function.)  That test, which
    126      is often relatively complex, and someplaces wrong or incomplete,
    127      should really be replaced by a predicate in elflink.c.
    128 
    129      End result: this field -1 does not indicate that the symbol is
    130      not in the dynamic symbol table, but rather that the symbol is
    131      not visible outside this DSO.  */
    132   long dynindx;
    133 
    134   /* If this symbol requires an entry in the global offset table, the
    135      processor specific backend uses this field to track usage and
    136      final offset.  Two schemes are supported:  The first assumes that
    137      a symbol may only have one GOT entry, and uses REFCOUNT until
    138      size_dynamic_sections, at which point the contents of the .got is
    139      fixed.  Afterward, if OFFSET is -1, then the symbol does not
    140      require a global offset table entry.  The second scheme allows
    141      multiple GOT entries per symbol, managed via a linked list
    142      pointed to by GLIST.  */
    143   union gotplt_union got;
    144 
    145   /* Same, but tracks a procedure linkage table entry.  */
    146   union gotplt_union plt;
    147 
    148   /* Symbol size.  */
    149   bfd_size_type size;
    150 
    151   /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.).  */
    152   unsigned int type : 8;
    153 
    154   /* Symbol st_other value, symbol visibility.  */
    155   unsigned int other : 8;
    156 
    157   /* The symbol's st_target_internal value (see Elf_Internal_Sym).  */
    158   unsigned int target_internal : 8;
    159 
    160   /* Symbol is referenced by a non-shared object (other than the object
    161      in which it is defined).  */
    162   unsigned int ref_regular : 1;
    163   /* Symbol is defined by a non-shared object.  */
    164   unsigned int def_regular : 1;
    165   /* Symbol is referenced by a shared object.  */
    166   unsigned int ref_dynamic : 1;
    167   /* Symbol is defined by a shared object.  */
    168   unsigned int def_dynamic : 1;
    169   /* Symbol has a non-weak reference from a non-shared object (other than
    170      the object in which it is defined).  */
    171   unsigned int ref_regular_nonweak : 1;
    172   /* Dynamic symbol has been adjustd.  */
    173   unsigned int dynamic_adjusted : 1;
    174   /* Symbol needs a copy reloc.  */
    175   unsigned int needs_copy : 1;
    176   /* Symbol needs a procedure linkage table entry.  */
    177   unsigned int needs_plt : 1;
    178   /* Symbol appears in a non-ELF input file.  */
    179   unsigned int non_elf : 1;
    180   /* Symbol should be marked as hidden in the version information.  */
    181   unsigned int hidden : 1;
    182   /* Symbol was forced to local scope due to a version script file.  */
    183   unsigned int forced_local : 1;
    184   /* Symbol was forced to be dynamic due to a version script file.  */
    185   unsigned int dynamic : 1;
    186   /* Symbol was marked during garbage collection.  */
    187   unsigned int mark : 1;
    188   /* Symbol is referenced by a non-GOT/non-PLT relocation.  This is
    189      not currently set by all the backends.  */
    190   unsigned int non_got_ref : 1;
    191   /* Symbol has a definition in a shared object.
    192      FIXME: There is no real need for this field if def_dynamic is never
    193      cleared and all places that test def_dynamic also test def_regular.  */
    194   unsigned int dynamic_def : 1;
    195   /* Symbol is weak in all shared objects.  */
    196   unsigned int dynamic_weak : 1;
    197   /* Symbol is referenced with a relocation where C/C++ pointer equality
    198      matters.  */
    199   unsigned int pointer_equality_needed : 1;
    200   /* Symbol is a unique global symbol.  */
    201   unsigned int unique_global : 1;
    202 
    203   /* String table index in .dynstr if this is a dynamic symbol.  */
    204   unsigned long dynstr_index;
    205 
    206   union
    207   {
    208     /* If this is a weak defined symbol from a dynamic object, this
    209        field points to a defined symbol with the same value, if there is
    210        one.  Otherwise it is NULL.  */
    211     struct elf_link_hash_entry *weakdef;
    212 
    213     /* Hash value of the name computed using the ELF hash function.
    214        Used part way through size_dynamic_sections, after we've finished
    215        with weakdefs.  */
    216     unsigned long elf_hash_value;
    217   } u;
    218 
    219   /* Version information.  */
    220   union
    221   {
    222     /* This field is used for a symbol which is not defined in a
    223        regular object.  It points to the version information read in
    224        from the dynamic object.  */
    225     Elf_Internal_Verdef *verdef;
    226     /* This field is used for a symbol which is defined in a regular
    227        object.  It is set up in size_dynamic_sections.  It points to
    228        the version information we should write out for this symbol.  */
    229     struct bfd_elf_version_tree *vertree;
    230   } verinfo;
    231 
    232   struct elf_link_virtual_table_entry *vtable;
    233 };
    234 
    235 /* Will references to this symbol always reference the symbol
    236    in this object?  STV_PROTECTED is excluded from the visibility test
    237    here so that function pointer comparisons work properly.  Since
    238    function symbols not defined in an app are set to their .plt entry,
    239    it's necessary for shared libs to also reference the .plt even
    240    though the symbol is really local to the shared lib.  */
    241 #define SYMBOL_REFERENCES_LOCAL(INFO, H) \
    242   _bfd_elf_symbol_refs_local_p (H, INFO, 0)
    243 
    244 /* Will _calls_ to this symbol always call the version in this object?  */
    245 #define SYMBOL_CALLS_LOCAL(INFO, H) \
    246   _bfd_elf_symbol_refs_local_p (H, INFO, 1)
    247 
    248 /* Common symbols that are turned into definitions don't have the
    249    DEF_REGULAR flag set, so they might appear to be undefined.  */
    250 #define ELF_COMMON_DEF_P(H) \
    251   (!(H)->def_regular							\
    252    && !(H)->def_dynamic							\
    253    && (H)->root.type == bfd_link_hash_defined)
    254 
    255 /* Records local symbols to be emitted in the dynamic symbol table.  */
    256 
    257 struct elf_link_local_dynamic_entry
    258 {
    259   struct elf_link_local_dynamic_entry *next;
    260 
    261   /* The input bfd this symbol came from.  */
    262   bfd *input_bfd;
    263 
    264   /* The index of the local symbol being copied.  */
    265   long input_indx;
    266 
    267   /* The index in the outgoing dynamic symbol table.  */
    268   long dynindx;
    269 
    270   /* A copy of the input symbol.  */
    271   Elf_Internal_Sym isym;
    272 };
    273 
    274 struct elf_link_loaded_list
    275 {
    276   struct elf_link_loaded_list *next;
    277   bfd *abfd;
    278 };
    279 
    280 /* Structures used by the eh_frame optimization code.  */
    281 struct eh_cie_fde
    282 {
    283   union {
    284     struct {
    285       /* If REMOVED == 1, this is the CIE that the FDE originally used.
    286 	 The CIE belongs to the same .eh_frame input section as the FDE.
    287 
    288 	 If REMOVED == 0, this is the CIE that we have chosen to use for
    289 	 the output FDE.  The CIE's REMOVED field is also 0, but the CIE
    290 	 might belong to a different .eh_frame input section from the FDE.  */
    291       struct eh_cie_fde *cie_inf;
    292       struct eh_cie_fde *next_for_section;
    293     } fde;
    294     struct {
    295       /* CIEs have three states:
    296 
    297 	 - REMOVED && !MERGED: Slated for removal because we haven't yet
    298 	   proven that an FDE needs it.  FULL_CIE, if nonnull, points to
    299 	   more detailed information about the CIE.
    300 
    301 	 - REMOVED && MERGED: We have merged this CIE with MERGED_WITH,
    302 	   which may not belong to the same input section.
    303 
    304 	 - !REMOVED: We have decided to keep this CIE.  SEC is the
    305 	   .eh_frame input section that contains the CIE.  */
    306       union {
    307 	struct cie *full_cie;
    308  	struct eh_cie_fde *merged_with;
    309  	asection *sec;
    310       } u;
    311 
    312       /* The offset of the personality data from the start of the CIE,
    313 	 or 0 if the CIE doesn't have any.  */
    314       unsigned int personality_offset : 8;
    315 
    316       /* True if we have marked relocations associated with this CIE.  */
    317       unsigned int gc_mark : 1;
    318 
    319       /* True if we have decided to turn an absolute LSDA encoding into
    320 	 a PC-relative one.  */
    321       unsigned int make_lsda_relative : 1;
    322 
    323       /* True if we have decided to turn an absolute personality
    324 	 encoding into a PC-relative one.  */
    325       unsigned int make_per_encoding_relative : 1;
    326 
    327       /* True if the CIE contains personality data and if that
    328 	 data uses a PC-relative encoding.  Always true when
    329 	 make_per_encoding_relative is.  */
    330       unsigned int per_encoding_relative : 1;
    331 
    332       /* True if we need to add an 'R' (FDE encoding) entry to the
    333 	 CIE's augmentation data.  */
    334       unsigned int add_fde_encoding : 1;
    335 
    336       /* True if we have merged this CIE with another.  */
    337       unsigned int merged : 1;
    338 
    339       /* Unused bits.  */
    340       unsigned int pad1 : 18;
    341     } cie;
    342   } u;
    343   unsigned int reloc_index;
    344   unsigned int size;
    345   unsigned int offset;
    346   unsigned int new_offset;
    347   unsigned int fde_encoding : 8;
    348   unsigned int lsda_encoding : 8;
    349   unsigned int lsda_offset : 8;
    350 
    351   /* True if this entry represents a CIE, false if it represents an FDE.  */
    352   unsigned int cie : 1;
    353 
    354   /* True if this entry is currently marked for removal.  */
    355   unsigned int removed : 1;
    356 
    357   /* True if we need to add a 'z' (augmentation size) entry to the CIE's
    358      augmentation data, and an associated byte to each of the CIE's FDEs.  */
    359   unsigned int add_augmentation_size : 1;
    360 
    361   /* True if we have decided to convert absolute FDE relocations into
    362      relative ones.  This applies to the first relocation in the FDE,
    363      which is against the code that the FDE describes.  */
    364   unsigned int make_relative : 1;
    365 
    366   /* Unused bits.  */
    367   unsigned int pad1 : 4;
    368 
    369   unsigned int *set_loc;
    370 };
    371 
    372 struct eh_frame_sec_info
    373 {
    374   unsigned int count;
    375   struct cie *cies;
    376   struct eh_cie_fde entry[1];
    377 };
    378 
    379 struct eh_frame_array_ent
    380 {
    381   bfd_vma initial_loc;
    382   bfd_vma fde;
    383 };
    384 
    385 struct htab;
    386 
    387 struct eh_frame_hdr_info
    388 {
    389   struct htab *cies;
    390   asection *hdr_sec;
    391   unsigned int fde_count, array_count;
    392   struct eh_frame_array_ent *array;
    393   /* TRUE if we should try to merge CIEs between input sections.  */
    394   bfd_boolean merge_cies;
    395   /* TRUE if all .eh_frames have been parsd.  */
    396   bfd_boolean parsed_eh_frames;
    397   /* TRUE if .eh_frame_hdr should contain the sorted search table.
    398      We build it if we successfully read all .eh_frame input sections
    399      and recognize them.  */
    400   bfd_boolean table;
    401 };
    402 
    403 /* Enum used to identify target specific extensions to the elf_obj_tdata
    404    and elf_link_hash_table structures.  Note the enums deliberately start
    405    from 1 so that we can detect an uninitialized field.  The generic value
    406    is last so that additions to this enum do not need to modify more than
    407    one line.  */
    408 enum elf_target_id
    409 {
    410   ALPHA_ELF_DATA = 1,
    411   ARM_ELF_DATA,
    412   AVR_ELF_DATA,
    413   BFIN_ELF_DATA,
    414   CRIS_ELF_DATA,
    415   FRV_ELF_DATA,
    416   HPPA32_ELF_DATA,
    417   HPPA64_ELF_DATA,
    418   I386_ELF_DATA,
    419   IA64_ELF_DATA,
    420   LM32_ELF_DATA,
    421   M32R_ELF_DATA,
    422   M68HC11_ELF_DATA,
    423   M68K_ELF_DATA,
    424   MICROBLAZE_ELF_DATA,
    425   MIPS_ELF_DATA,
    426   MN10300_ELF_DATA,
    427   PPC32_ELF_DATA,
    428   PPC64_ELF_DATA,
    429   S390_ELF_DATA,
    430   SH_ELF_DATA,
    431   SPARC_ELF_DATA,
    432   SPU_ELF_DATA,
    433   TIC6X_ELF_DATA,
    434   X86_64_ELF_DATA,
    435   XTENSA_ELF_DATA,
    436   GENERIC_ELF_DATA
    437 };
    438 
    439 /* ELF linker hash table.  */
    440 
    441 struct elf_link_hash_table
    442 {
    443   struct bfd_link_hash_table root;
    444 
    445   /* An identifier used to distinguish different target
    446      specific extensions to this structure.  */
    447   enum elf_target_id hash_table_id;
    448 
    449   /* Whether we have created the special dynamic sections required
    450      when linking against or generating a shared object.  */
    451   bfd_boolean dynamic_sections_created;
    452 
    453   /* True if this target has relocatable executables, so needs dynamic
    454      section symbols.  */
    455   bfd_boolean is_relocatable_executable;
    456 
    457   /* The BFD used to hold special sections created by the linker.
    458      This will be the first BFD found which requires these sections to
    459      be created.  */
    460   bfd *dynobj;
    461 
    462   /* The value to use when initialising got.refcount/offset and
    463      plt.refcount/offset in an elf_link_hash_entry.  Set to zero when
    464      the values are refcounts.  Set to init_got_offset/init_plt_offset
    465      in size_dynamic_sections when the values may be offsets.  */
    466   union gotplt_union init_got_refcount;
    467   union gotplt_union init_plt_refcount;
    468 
    469   /* The value to use for got.refcount/offset and plt.refcount/offset
    470      when the values may be offsets.  Normally (bfd_vma) -1.  */
    471   union gotplt_union init_got_offset;
    472   union gotplt_union init_plt_offset;
    473 
    474   /* The number of symbols found in the link which must be put into
    475      the .dynsym section.  */
    476   bfd_size_type dynsymcount;
    477 
    478   /* The string table of dynamic symbols, which becomes the .dynstr
    479      section.  */
    480   struct elf_strtab_hash *dynstr;
    481 
    482   /* The number of buckets in the hash table in the .hash section.
    483      This is based on the number of dynamic symbols.  */
    484   bfd_size_type bucketcount;
    485 
    486   /* A linked list of DT_NEEDED names found in dynamic objects
    487      included in the link.  */
    488   struct bfd_link_needed_list *needed;
    489 
    490   /* Sections in the output bfd that provides a section symbol
    491      to be used by relocations emitted against local symbols.
    492      Most targets will not use data_index_section.  */
    493   asection *text_index_section;
    494   asection *data_index_section;
    495 
    496   /* The _GLOBAL_OFFSET_TABLE_ symbol.  */
    497   struct elf_link_hash_entry *hgot;
    498 
    499   /* The _PROCEDURE_LINKAGE_TABLE_ symbol.  */
    500   struct elf_link_hash_entry *hplt;
    501 
    502   /* A pointer to information used to merge SEC_MERGE sections.  */
    503   void *merge_info;
    504 
    505   /* Used to link stabs in sections.  */
    506   struct stab_info stab_info;
    507 
    508   /* Used by eh_frame code when editing .eh_frame.  */
    509   struct eh_frame_hdr_info eh_info;
    510 
    511   /* A linked list of local symbols to be added to .dynsym.  */
    512   struct elf_link_local_dynamic_entry *dynlocal;
    513 
    514   /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic
    515      objects included in the link.  */
    516   struct bfd_link_needed_list *runpath;
    517 
    518   /* Cached first output tls section and size of PT_TLS segment.  */
    519   asection *tls_sec;
    520   bfd_size_type tls_size;
    521 
    522   /* A linked list of BFD's loaded in the link.  */
    523   struct elf_link_loaded_list *loaded;
    524 
    525   /* Short-cuts to get to dynamic linker sections.  */
    526   asection *sgot;
    527   asection *sgotplt;
    528   asection *srelgot;
    529   asection *splt;
    530   asection *srelplt;
    531   asection *igotplt;
    532   asection *iplt;
    533   asection *irelplt;
    534   asection *irelifunc;
    535 };
    536 
    537 /* Look up an entry in an ELF linker hash table.  */
    538 
    539 #define elf_link_hash_lookup(table, string, create, copy, follow)	\
    540   ((struct elf_link_hash_entry *)					\
    541    bfd_link_hash_lookup (&(table)->root, (string), (create),		\
    542 			 (copy), (follow)))
    543 
    544 /* Traverse an ELF linker hash table.  */
    545 
    546 #define elf_link_hash_traverse(table, func, info)			\
    547   (bfd_link_hash_traverse						\
    548    (&(table)->root,							\
    549     (bfd_boolean (*) (struct bfd_link_hash_entry *, void *)) (func),	\
    550     (info)))
    551 
    552 /* Get the ELF linker hash table from a link_info structure.  */
    553 
    554 #define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash))
    555 
    556 #define elf_hash_table_id(table)	((table) -> hash_table_id)
    557 
    558 /* Returns TRUE if the hash table is a struct elf_link_hash_table.  */
    559 #define is_elf_hash_table(htab)					      	\
    560   (((struct bfd_link_hash_table *) (htab))->type == bfd_link_elf_hash_table)
    561 
    562 /* Used by bfd_sym_from_r_symndx to cache a small number of local
    563    symbols.  */
    564 #define LOCAL_SYM_CACHE_SIZE 32
    565 struct sym_cache
    566 {
    567   bfd *abfd;
    568   unsigned long indx[LOCAL_SYM_CACHE_SIZE];
    569   Elf_Internal_Sym sym[LOCAL_SYM_CACHE_SIZE];
    570 };
    571 
    572 /* Constant information held for an ELF backend.  */
    574 
    575 struct elf_size_info {
    576   unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
    577   unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
    578 
    579   /* The size of entries in the .hash section.  */
    580   unsigned char sizeof_hash_entry;
    581 
    582   /* The number of internal relocations to allocate per external
    583      relocation entry.  */
    584   unsigned char int_rels_per_ext_rel;
    585   /* We use some fixed size arrays.  This should be large enough to
    586      handle all back-ends.  */
    587 #define MAX_INT_RELS_PER_EXT_REL 3
    588 
    589   unsigned char arch_size, log_file_align;
    590   unsigned char elfclass, ev_current;
    591   int (*write_out_phdrs)
    592     (bfd *, const Elf_Internal_Phdr *, unsigned int);
    593   bfd_boolean
    594     (*write_shdrs_and_ehdr) (bfd *);
    595   bfd_boolean (*checksum_contents)
    596     (bfd * , void (*) (const void *, size_t, void *), void *);
    597   void (*write_relocs)
    598     (bfd *, asection *, void *);
    599   bfd_boolean (*swap_symbol_in)
    600     (bfd *, const void *, const void *, Elf_Internal_Sym *);
    601   void (*swap_symbol_out)
    602     (bfd *, const Elf_Internal_Sym *, void *, void *);
    603   bfd_boolean (*slurp_reloc_table)
    604     (bfd *, asection *, asymbol **, bfd_boolean);
    605   long (*slurp_symbol_table)
    606     (bfd *, asymbol **, bfd_boolean);
    607   void (*swap_dyn_in)
    608     (bfd *, const void *, Elf_Internal_Dyn *);
    609   void (*swap_dyn_out)
    610     (bfd *, const Elf_Internal_Dyn *, void *);
    611 
    612   /* This function is called to swap in a REL relocation.  If an
    613      external relocation corresponds to more than one internal
    614      relocation, then all relocations are swapped in at once.  */
    615   void (*swap_reloc_in)
    616     (bfd *, const bfd_byte *, Elf_Internal_Rela *);
    617 
    618   /* This function is called to swap out a REL relocation.  */
    619   void (*swap_reloc_out)
    620     (bfd *, const Elf_Internal_Rela *, bfd_byte *);
    621 
    622   /* This function is called to swap in a RELA relocation.  If an
    623      external relocation corresponds to more than one internal
    624      relocation, then all relocations are swapped in at once.  */
    625   void (*swap_reloca_in)
    626     (bfd *, const bfd_byte *, Elf_Internal_Rela *);
    627 
    628   /* This function is called to swap out a RELA relocation.  */
    629   void (*swap_reloca_out)
    630     (bfd *, const Elf_Internal_Rela *, bfd_byte *);
    631 };
    632 
    633 #define elf_symbol_from(ABFD,S) \
    634 	(((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
    635 	  && (S)->the_bfd->tdata.elf_obj_data != 0) \
    636 	 ? (elf_symbol_type *) (S) \
    637 	 : 0)
    638 
    639 enum elf_reloc_type_class {
    640   reloc_class_normal,
    641   reloc_class_relative,
    642   reloc_class_plt,
    643   reloc_class_copy
    644 };
    645 
    646 struct elf_reloc_cookie
    647 {
    648   Elf_Internal_Rela *rels, *rel, *relend;
    649   Elf_Internal_Sym *locsyms;
    650   bfd *abfd;
    651   size_t locsymcount;
    652   size_t extsymoff;
    653   struct elf_link_hash_entry **sym_hashes;
    654   int r_sym_shift;
    655   bfd_boolean bad_symtab;
    656 };
    657 
    658 /* The level of IRIX compatibility we're striving for.  */
    659 
    660 typedef enum {
    661   ict_none,
    662   ict_irix5,
    663   ict_irix6
    664 } irix_compat_t;
    665 
    666 /* Mapping of ELF section names and types.  */
    667 struct bfd_elf_special_section
    668 {
    669   const char *prefix;
    670   int prefix_length;
    671   /* 0 means name must match PREFIX exactly.
    672      -1 means name must start with PREFIX followed by an arbitrary string.
    673      -2 means name must match PREFIX exactly or consist of PREFIX followed
    674      by a dot then anything.
    675      > 0 means name must start with the first PREFIX_LENGTH chars of
    676      PREFIX and finish with the last SUFFIX_LENGTH chars of PREFIX.  */
    677   int suffix_length;
    678   int type;
    679   bfd_vma attr;
    680 };
    681 
    682 enum action_discarded
    683   {
    684     COMPLAIN = 1,
    685     PRETEND = 2
    686   };
    687 
    688 typedef asection * (*elf_gc_mark_hook_fn)
    689   (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
    690    struct elf_link_hash_entry *, Elf_Internal_Sym *);
    691 
    692 struct elf_backend_data
    693 {
    694   /* The architecture for this backend.  */
    695   enum bfd_architecture arch;
    696 
    697   /* An identifier used to distinguish different target specific
    698      extensions to elf_obj_tdata and elf_link_hash_table structures.  */
    699   enum elf_target_id target_id;
    700 
    701   /* The ELF machine code (EM_xxxx) for this backend.  */
    702   int elf_machine_code;
    703 
    704   /* EI_OSABI. */
    705   int elf_osabi;
    706 
    707   /* The maximum page size for this backend.  */
    708   bfd_vma maxpagesize;
    709 
    710   /* The minimum page size for this backend.  An input object will not be
    711      considered page aligned unless its sections are correctly aligned for
    712      pages at least this large.  May be smaller than maxpagesize.  */
    713   bfd_vma minpagesize;
    714 
    715   /* The common page size for this backend.  */
    716   bfd_vma commonpagesize;
    717 
    718   /* The BFD flags applied to sections created for dynamic linking.  */
    719   flagword dynamic_sec_flags;
    720 
    721   /* A function to translate an ELF RELA relocation to a BFD arelent
    722      structure.  */
    723   void (*elf_info_to_howto)
    724     (bfd *, arelent *, Elf_Internal_Rela *);
    725 
    726   /* A function to translate an ELF REL relocation to a BFD arelent
    727      structure.  */
    728   void (*elf_info_to_howto_rel)
    729     (bfd *, arelent *, Elf_Internal_Rela *);
    730 
    731   /* A function to determine whether a symbol is global when
    732      partitioning the symbol table into local and global symbols.
    733      This should be NULL for most targets, in which case the correct
    734      thing will be done.  MIPS ELF, at least on the Irix 5, has
    735      special requirements.  */
    736   bfd_boolean (*elf_backend_sym_is_global)
    737     (bfd *, asymbol *);
    738 
    739   /* The remaining functions are hooks which are called only if they
    740      are not NULL.  */
    741 
    742   /* A function to permit a backend specific check on whether a
    743      particular BFD format is relevant for an object file, and to
    744      permit the backend to set any global information it wishes.  When
    745      this is called elf_elfheader is set, but anything else should be
    746      used with caution.  If this returns FALSE, the check_format
    747      routine will return a bfd_error_wrong_format error.  */
    748   bfd_boolean (*elf_backend_object_p)
    749     (bfd *);
    750 
    751   /* A function to do additional symbol processing when reading the
    752      ELF symbol table.  This is where any processor-specific special
    753      section indices are handled.  */
    754   void (*elf_backend_symbol_processing)
    755     (bfd *, asymbol *);
    756 
    757   /* A function to do additional symbol processing after reading the
    758      entire ELF symbol table.  */
    759   bfd_boolean (*elf_backend_symbol_table_processing)
    760     (bfd *, elf_symbol_type *, unsigned int);
    761 
    762   /* A function to set the type of the info field.  Processor-specific
    763      types should be handled here.  */
    764   int (*elf_backend_get_symbol_type)
    765     (Elf_Internal_Sym *, int);
    766 
    767   /* A function to return the linker hash table entry of a symbol that
    768      might be satisfied by an archive symbol.  */
    769   struct elf_link_hash_entry * (*elf_backend_archive_symbol_lookup)
    770     (bfd *, struct bfd_link_info *, const char *);
    771 
    772   /* Return true if local section symbols should have a non-null st_name.
    773      NULL implies false.  */
    774   bfd_boolean (*elf_backend_name_local_section_symbols)
    775     (bfd *);
    776 
    777   /* A function to do additional processing on the ELF section header
    778      just before writing it out.  This is used to set the flags and
    779      type fields for some sections, or to actually write out data for
    780      unusual sections.  */
    781   bfd_boolean (*elf_backend_section_processing)
    782     (bfd *, Elf_Internal_Shdr *);
    783 
    784   /* A function to handle unusual section types when creating BFD
    785      sections from ELF sections.  */
    786   bfd_boolean (*elf_backend_section_from_shdr)
    787     (bfd *, Elf_Internal_Shdr *, const char *, int);
    788 
    789   /* A function to convert machine dependent ELF section header flags to
    790      BFD internal section header flags.  */
    791   bfd_boolean (*elf_backend_section_flags)
    792     (flagword *, const Elf_Internal_Shdr *);
    793 
    794   /* A function that returns a struct containing ELF section flags and
    795      type for the given BFD section.   */
    796   const struct bfd_elf_special_section * (*get_sec_type_attr)
    797     (bfd *, asection *);
    798 
    799   /* A function to handle unusual program segment types when creating BFD
    800      sections from ELF program segments.  */
    801   bfd_boolean (*elf_backend_section_from_phdr)
    802     (bfd *, Elf_Internal_Phdr *, int, const char *);
    803 
    804   /* A function to set up the ELF section header for a BFD section in
    805      preparation for writing it out.  This is where the flags and type
    806      fields are set for unusual sections.  */
    807   bfd_boolean (*elf_backend_fake_sections)
    808     (bfd *, Elf_Internal_Shdr *, asection *);
    809 
    810   /* A function to get the ELF section index for a BFD section.  If
    811      this returns TRUE, the section was found.  If it is a normal ELF
    812      section, *RETVAL should be left unchanged.  If it is not a normal
    813      ELF section *RETVAL should be set to the SHN_xxxx index.  */
    814   bfd_boolean (*elf_backend_section_from_bfd_section)
    815     (bfd *, asection *, int *retval);
    816 
    817   /* If this field is not NULL, it is called by the add_symbols phase
    818      of a link just before adding a symbol to the global linker hash
    819      table.  It may modify any of the fields as it wishes.  If *NAME
    820      is set to NULL, the symbol will be skipped rather than being
    821      added to the hash table.  This function is responsible for
    822      handling all processor dependent symbol bindings and section
    823      indices, and must set at least *FLAGS and *SEC for each processor
    824      dependent case; failure to do so will cause a link error.  */
    825   bfd_boolean (*elf_add_symbol_hook)
    826     (bfd *abfd, struct bfd_link_info *info, Elf_Internal_Sym *,
    827      const char **name, flagword *flags, asection **sec, bfd_vma *value);
    828 
    829   /* If this field is not NULL, it is called by the elf_link_output_sym
    830      phase of a link for each symbol which will appear in the object file.
    831      On error, this function returns 0.  1 is returned when the symbol
    832      should be output, 2 is returned when the symbol should be discarded.  */
    833   int (*elf_backend_link_output_symbol_hook)
    834     (struct bfd_link_info *info, const char *, Elf_Internal_Sym *,
    835      asection *, struct elf_link_hash_entry *);
    836 
    837   /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
    838      linker the first time it encounters a dynamic object in the link.
    839      This function must create any sections required for dynamic
    840      linking.  The ABFD argument is a dynamic object.  The .interp,
    841      .dynamic, .dynsym, .dynstr, and .hash functions have already been
    842      created, and this function may modify the section flags if
    843      desired.  This function will normally create the .got and .plt
    844      sections, but different backends have different requirements.  */
    845   bfd_boolean (*elf_backend_create_dynamic_sections)
    846     (bfd *abfd, struct bfd_link_info *info);
    847 
    848   /* When creating a shared library, determine whether to omit the
    849      dynamic symbol for the section.  */
    850   bfd_boolean (*elf_backend_omit_section_dynsym)
    851     (bfd *output_bfd, struct bfd_link_info *info, asection *osec);
    852 
    853   /* Return TRUE if relocations of targets are compatible to the extent
    854      that CHECK_RELOCS will properly process them.  PR 4424.  */
    855   bfd_boolean (*relocs_compatible) (const bfd_target *, const bfd_target *);
    856 
    857   /* The CHECK_RELOCS function is called by the add_symbols phase of
    858      the ELF backend linker.  It is called once for each section with
    859      relocs of an object file, just after the symbols for the object
    860      file have been added to the global linker hash table.  The
    861      function must look through the relocs and do any special handling
    862      required.  This generally means allocating space in the global
    863      offset table, and perhaps allocating space for a reloc.  The
    864      relocs are always passed as Rela structures; if the section
    865      actually uses Rel structures, the r_addend field will always be
    866      zero.  */
    867   bfd_boolean (*check_relocs)
    868     (bfd *abfd, struct bfd_link_info *info, asection *o,
    869      const Elf_Internal_Rela *relocs);
    870 
    871   /* The CHECK_DIRECTIVES function is called once per input file by
    872      the add_symbols phase of the ELF backend linker.  The function
    873      must inspect the bfd and create any additional symbols according
    874      to any custom directives in the bfd.  */
    875   bfd_boolean (*check_directives)
    876     (bfd *abfd, struct bfd_link_info *info);
    877 
    878   /* The AS_NEEDED_CLEANUP function is called once per --as-needed
    879      input file that was not needed by the add_symbols phase of the
    880      ELF backend linker.  The function must undo any target specific
    881      changes in the symbol hash table.  */
    882   bfd_boolean (*as_needed_cleanup)
    883     (bfd *abfd, struct bfd_link_info *info);
    884 
    885   /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
    886      linker for every symbol which is defined by a dynamic object and
    887      referenced by a regular object.  This is called after all the
    888      input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
    889      function has been called.  The hash table entry should be
    890      bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
    891      defined in a section from a dynamic object.  Dynamic object
    892      sections are not included in the final link, and this function is
    893      responsible for changing the value to something which the rest of
    894      the link can deal with.  This will normally involve adding an
    895      entry to the .plt or .got or some such section, and setting the
    896      symbol to point to that.  */
    897   bfd_boolean (*elf_backend_adjust_dynamic_symbol)
    898     (struct bfd_link_info *info, struct elf_link_hash_entry *h);
    899 
    900   /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
    901      after all the linker input files have been seen but before the
    902      section sizes have been set.  This is called after
    903      ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS.  */
    904   bfd_boolean (*elf_backend_always_size_sections)
    905     (bfd *output_bfd, struct bfd_link_info *info);
    906 
    907   /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
    908      linker after all the linker input files have been seen but before
    909      the sections sizes have been set.  This is called after
    910      ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
    911      It is only called when linking against a dynamic object.  It must
    912      set the sizes of the dynamic sections, and may fill in their
    913      contents as well.  The generic ELF linker can handle the .dynsym,
    914      .dynstr and .hash sections.  This function must handle the
    915      .interp section and any sections created by the
    916      CREATE_DYNAMIC_SECTIONS entry point.  */
    917   bfd_boolean (*elf_backend_size_dynamic_sections)
    918     (bfd *output_bfd, struct bfd_link_info *info);
    919 
    920   /* Set TEXT_INDEX_SECTION and DATA_INDEX_SECTION, the output sections
    921      we keep to use as a base for relocs and symbols.  */
    922   void (*elf_backend_init_index_section)
    923     (bfd *output_bfd, struct bfd_link_info *info);
    924 
    925   /* The RELOCATE_SECTION function is called by the ELF backend linker
    926      to handle the relocations for a section.
    927 
    928      The relocs are always passed as Rela structures; if the section
    929      actually uses Rel structures, the r_addend field will always be
    930      zero.
    931 
    932      This function is responsible for adjust the section contents as
    933      necessary, and (if using Rela relocs and generating a
    934      relocatable output file) adjusting the reloc addend as
    935      necessary.
    936 
    937      This function does not have to worry about setting the reloc
    938      address or the reloc symbol index.
    939 
    940      LOCAL_SYMS is a pointer to the swapped in local symbols.
    941 
    942      LOCAL_SECTIONS is an array giving the section in the input file
    943      corresponding to the st_shndx field of each local symbol.
    944 
    945      The global hash table entry for the global symbols can be found
    946      via elf_sym_hashes (input_bfd).
    947 
    948      When generating relocatable output, this function must handle
    949      STB_LOCAL/STT_SECTION symbols specially.  The output symbol is
    950      going to be the section symbol corresponding to the output
    951      section, which means that the addend must be adjusted
    952      accordingly.
    953 
    954      Returns FALSE on error, TRUE on success, 2 if successful and
    955      relocations should be written for this section.  */
    956   int (*elf_backend_relocate_section)
    957     (bfd *output_bfd, struct bfd_link_info *info, bfd *input_bfd,
    958      asection *input_section, bfd_byte *contents, Elf_Internal_Rela *relocs,
    959      Elf_Internal_Sym *local_syms, asection **local_sections);
    960 
    961   /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
    962      linker just before it writes a symbol out to the .dynsym section.
    963      The processor backend may make any required adjustment to the
    964      symbol.  It may also take the opportunity to set contents of the
    965      dynamic sections.  Note that FINISH_DYNAMIC_SYMBOL is called on
    966      all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
    967      on those symbols which are defined by a dynamic object.  */
    968   bfd_boolean (*elf_backend_finish_dynamic_symbol)
    969     (bfd *output_bfd, struct bfd_link_info *info,
    970      struct elf_link_hash_entry *h, Elf_Internal_Sym *sym);
    971 
    972   /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
    973      linker just before it writes all the dynamic sections out to the
    974      output file.  The FINISH_DYNAMIC_SYMBOL will have been called on
    975      all dynamic symbols.  */
    976   bfd_boolean (*elf_backend_finish_dynamic_sections)
    977     (bfd *output_bfd, struct bfd_link_info *info);
    978 
    979   /* A function to do any beginning processing needed for the ELF file
    980      before building the ELF headers and computing file positions.  */
    981   void (*elf_backend_begin_write_processing)
    982     (bfd *, struct bfd_link_info *);
    983 
    984   /* A function to do any final processing needed for the ELF file
    985      before writing it out.  The LINKER argument is TRUE if this BFD
    986      was created by the ELF backend linker.  */
    987   void (*elf_backend_final_write_processing)
    988     (bfd *, bfd_boolean linker);
    989 
    990   /* This function is called by get_program_header_size.  It should
    991      return the number of additional program segments which this BFD
    992      will need.  It should return -1 on error.  */
    993   int (*elf_backend_additional_program_headers)
    994     (bfd *, struct bfd_link_info *);
    995 
    996   /* This function is called to modify an existing segment map in a
    997      backend specific fashion.  */
    998   bfd_boolean (*elf_backend_modify_segment_map)
    999     (bfd *, struct bfd_link_info *);
   1000 
   1001   /* This function is called to modify program headers just before
   1002      they are written.  */
   1003   bfd_boolean (*elf_backend_modify_program_headers)
   1004     (bfd *, struct bfd_link_info *);
   1005 
   1006   /* This function is called before section garbage collection to
   1007      mark entry symbol sections.  */
   1008   void (*gc_keep)
   1009     (struct bfd_link_info *);
   1010 
   1011   /* This function is called during section garbage collection to
   1012      mark sections that define global symbols.  */
   1013   bfd_boolean (*gc_mark_dynamic_ref)
   1014     (struct elf_link_hash_entry *, void *);
   1015 
   1016   /* This function is called during section gc to discover the section a
   1017      particular relocation refers to.  */
   1018   elf_gc_mark_hook_fn gc_mark_hook;
   1019 
   1020   /* This function, if defined, is called after the first gc marking pass
   1021      to allow the backend to mark additional sections.  */
   1022   bfd_boolean (*gc_mark_extra_sections)
   1023     (struct bfd_link_info *, elf_gc_mark_hook_fn);
   1024 
   1025   /* This function, if defined, is called during the sweep phase of gc
   1026      in order that a backend might update any data structures it might
   1027      be maintaining.  */
   1028   bfd_boolean (*gc_sweep_hook)
   1029     (bfd *, struct bfd_link_info *, asection *, const Elf_Internal_Rela *);
   1030 
   1031   /* This function, if defined, is called after the ELF headers have
   1032      been created.  This allows for things like the OS and ABI versions
   1033      to be changed.  */
   1034   void (*elf_backend_post_process_headers)
   1035     (bfd *, struct bfd_link_info *);
   1036 
   1037   /* This function, if defined, prints a symbol to file and returns the
   1038      name of the symbol to be printed.  It should return NULL to fall
   1039      back to default symbol printing.  */
   1040   const char *(*elf_backend_print_symbol_all)
   1041     (bfd *, void *, asymbol *);
   1042 
   1043   /* This function, if defined, is called after all local symbols and
   1044      global symbols converted to locals are emitted into the symtab
   1045      section.  It allows the backend to emit special local symbols
   1046      not handled in the hash table.  */
   1047   bfd_boolean (*elf_backend_output_arch_local_syms)
   1048     (bfd *, struct bfd_link_info *, void *,
   1049      bfd_boolean (*) (void *, const char *, Elf_Internal_Sym *, asection *,
   1050 		      struct elf_link_hash_entry *));
   1051 
   1052   /* This function, if defined, is called after all symbols are emitted
   1053      into the symtab section.  It allows the backend to emit special
   1054      global symbols not handled in the hash table.  */
   1055   bfd_boolean (*elf_backend_output_arch_syms)
   1056     (bfd *, struct bfd_link_info *, void *,
   1057      bfd_boolean (*) (void *, const char *, Elf_Internal_Sym *, asection *,
   1058 		      struct elf_link_hash_entry *));
   1059 
   1060   /* Copy any information related to dynamic linking from a pre-existing
   1061      symbol to a newly created symbol.  Also called to copy flags and
   1062      other back-end info to a weakdef, in which case the symbol is not
   1063      newly created and plt/got refcounts and dynamic indices should not
   1064      be copied.  */
   1065   void (*elf_backend_copy_indirect_symbol)
   1066     (struct bfd_link_info *, struct elf_link_hash_entry *,
   1067      struct elf_link_hash_entry *);
   1068 
   1069   /* Modify any information related to dynamic linking such that the
   1070      symbol is not exported.  */
   1071   void (*elf_backend_hide_symbol)
   1072     (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
   1073 
   1074   /* A function to do additional symbol fixup, called by
   1075      _bfd_elf_fix_symbol_flags.  */
   1076   bfd_boolean (*elf_backend_fixup_symbol)
   1077     (struct bfd_link_info *, struct elf_link_hash_entry *);
   1078 
   1079   /* Merge the backend specific symbol attribute.  */
   1080   void (*elf_backend_merge_symbol_attribute)
   1081     (struct elf_link_hash_entry *, const Elf_Internal_Sym *, bfd_boolean,
   1082      bfd_boolean);
   1083 
   1084   /* This function, if defined, will return a string containing the
   1085      name of a target-specific dynamic tag.  */
   1086   char *(*elf_backend_get_target_dtag)
   1087     (bfd_vma);
   1088 
   1089   /* Decide whether an undefined symbol is special and can be ignored.
   1090      This is the case for OPTIONAL symbols on IRIX.  */
   1091   bfd_boolean (*elf_backend_ignore_undef_symbol)
   1092     (struct elf_link_hash_entry *);
   1093 
   1094   /* Emit relocations.  Overrides default routine for emitting relocs,
   1095      except during a relocatable link, or if all relocs are being emitted.  */
   1096   bfd_boolean (*elf_backend_emit_relocs)
   1097     (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *,
   1098      struct elf_link_hash_entry **);
   1099 
   1100   /* Count relocations.  Not called for relocatable links
   1101      or if all relocs are being preserved in the output.  */
   1102   unsigned int (*elf_backend_count_relocs)
   1103     (struct bfd_link_info *, asection *);
   1104 
   1105   /* This function, if defined, is called when an NT_PRSTATUS note is found
   1106      in a core file.  */
   1107   bfd_boolean (*elf_backend_grok_prstatus)
   1108     (bfd *, Elf_Internal_Note *);
   1109 
   1110   /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
   1111      note is found in a core file.  */
   1112   bfd_boolean (*elf_backend_grok_psinfo)
   1113     (bfd *, Elf_Internal_Note *);
   1114 
   1115   /* This function, if defined, is called to write a note to a corefile.  */
   1116   char *(*elf_backend_write_core_note)
   1117     (bfd *abfd, char *buf, int *bufsiz, int note_type, ...);
   1118 
   1119   /* This function returns class of a reloc type.  */
   1120   enum elf_reloc_type_class (*elf_backend_reloc_type_class)
   1121     (const Elf_Internal_Rela *);
   1122 
   1123   /* This function, if defined, removes information about discarded functions
   1124      from other sections which mention them.  */
   1125   bfd_boolean (*elf_backend_discard_info)
   1126     (bfd *, struct elf_reloc_cookie *, struct bfd_link_info *);
   1127 
   1128   /* This function, if defined, signals that the function above has removed
   1129      the discarded relocations for this section.  */
   1130   bfd_boolean (*elf_backend_ignore_discarded_relocs)
   1131     (asection *);
   1132 
   1133   /* What to do when ld finds relocations against symbols defined in
   1134      discarded sections.  */
   1135   unsigned int (*action_discarded)
   1136     (asection *);
   1137 
   1138   /* This function returns the width of FDE pointers in bytes, or 0 if
   1139      that can't be determined for some reason.  The default definition
   1140      goes by the bfd's EI_CLASS.  */
   1141   unsigned int (*elf_backend_eh_frame_address_size)
   1142     (bfd *, asection *);
   1143 
   1144   /* These functions tell elf-eh-frame whether to attempt to turn
   1145      absolute or lsda encodings into pc-relative ones.  The default
   1146      definition enables these transformations.  */
   1147   bfd_boolean (*elf_backend_can_make_relative_eh_frame)
   1148      (bfd *, struct bfd_link_info *, asection *);
   1149   bfd_boolean (*elf_backend_can_make_lsda_relative_eh_frame)
   1150      (bfd *, struct bfd_link_info *, asection *);
   1151 
   1152   /* This function returns an encoding after computing the encoded
   1153      value (and storing it in ENCODED) for the given OFFSET into OSEC,
   1154      to be stored in at LOC_OFFSET into the LOC_SEC input section.
   1155      The default definition chooses a 32-bit PC-relative encoding.  */
   1156   bfd_byte (*elf_backend_encode_eh_address)
   1157      (bfd *abfd, struct bfd_link_info *info,
   1158       asection *osec, bfd_vma offset,
   1159       asection *loc_sec, bfd_vma loc_offset,
   1160       bfd_vma *encoded);
   1161 
   1162   /* This function, if defined, may write out the given section.
   1163      Returns TRUE if it did so and FALSE if the caller should.  */
   1164   bfd_boolean (*elf_backend_write_section)
   1165     (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
   1166 
   1167   /* The level of IRIX compatibility we're striving for.
   1168      MIPS ELF specific function.  */
   1169   irix_compat_t (*elf_backend_mips_irix_compat)
   1170     (bfd *);
   1171 
   1172   reloc_howto_type *(*elf_backend_mips_rtype_to_howto)
   1173     (unsigned int, bfd_boolean);
   1174 
   1175   /* The swapping table to use when dealing with ECOFF information.
   1176      Used for the MIPS ELF .mdebug section.  */
   1177   const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
   1178 
   1179   /* This function implements `bfd_elf_bfd_from_remote_memory';
   1180      see elf.c, elfcode.h.  */
   1181   bfd *(*elf_backend_bfd_from_remote_memory)
   1182      (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
   1183       int (*target_read_memory) (bfd_vma vma, bfd_byte *myaddr, int len));
   1184 
   1185   /* This function is used by `_bfd_elf_get_synthetic_symtab';
   1186      see elf.c.  */
   1187   bfd_vma (*plt_sym_val) (bfd_vma, const asection *, const arelent *);
   1188 
   1189   /* Is symbol defined in common section?  */
   1190   bfd_boolean (*common_definition) (Elf_Internal_Sym *);
   1191 
   1192   /* Return a common section index for section.  */
   1193   unsigned int (*common_section_index) (asection *);
   1194 
   1195   /* Return a common section for section.  */
   1196   asection *(*common_section) (asection *);
   1197 
   1198   /* Return TRUE if we can merge 2 definitions.  */
   1199   bfd_boolean (*merge_symbol) (struct bfd_link_info *,
   1200 			       struct elf_link_hash_entry **,
   1201 			       struct elf_link_hash_entry *,
   1202 			       Elf_Internal_Sym *, asection **,
   1203 			       bfd_vma *, unsigned int *,
   1204 			       bfd_boolean *, bfd_boolean *,
   1205 			       bfd_boolean *, bfd_boolean *,
   1206 			       bfd_boolean *, bfd_boolean *,
   1207 			       bfd_boolean *, bfd_boolean *,
   1208 			       bfd *, asection **,
   1209 			       bfd_boolean *, bfd_boolean *,
   1210 			       bfd_boolean *, bfd_boolean *,
   1211 			       bfd *, asection **);
   1212 
   1213   /* Return TRUE if symbol should be hashed in the `.gnu.hash' section.  */
   1214   bfd_boolean (*elf_hash_symbol) (struct elf_link_hash_entry *);
   1215 
   1216   /* Return TRUE if type is a function symbol type.  */
   1217   bfd_boolean (*is_function_type) (unsigned int type);
   1218 
   1219   /* Used to handle bad SHF_LINK_ORDER input.  */
   1220   bfd_error_handler_type link_order_error_handler;
   1221 
   1222   /* Name of the PLT relocation section.  */
   1223   const char *relplt_name;
   1224 
   1225   /* Alternate EM_xxxx machine codes for this backend.  */
   1226   int elf_machine_alt1;
   1227   int elf_machine_alt2;
   1228 
   1229   const struct elf_size_info *s;
   1230 
   1231   /* An array of target specific special sections.  */
   1232   const struct bfd_elf_special_section *special_sections;
   1233 
   1234   /* The size in bytes of the header for the GOT.  This includes the
   1235      so-called reserved entries on some systems.  */
   1236   bfd_vma got_header_size;
   1237 
   1238   /* The size of the GOT entry for the symbol pointed to by H if non-NULL,
   1239      otherwise by the local symbol with index SYMNDX in IBFD.  */
   1240   bfd_vma (*got_elt_size) (bfd *, struct bfd_link_info *,
   1241 			   struct elf_link_hash_entry *h,
   1242 			   bfd *ibfd, unsigned long symndx);
   1243 
   1244   /* The vendor name to use for a processor-standard attributes section.  */
   1245   const char *obj_attrs_vendor;
   1246 
   1247   /* The section name to use for a processor-standard attributes section.  */
   1248   const char *obj_attrs_section;
   1249 
   1250   /* Return 1, 2 or 3 to indicate what type of arguments a
   1251      processor-specific tag takes.  */
   1252   int (*obj_attrs_arg_type) (int);
   1253 
   1254   /* The section type to use for an attributes section.  */
   1255   unsigned int obj_attrs_section_type;
   1256 
   1257   /* This function determines the order in which any attributes are
   1258      written.  It must be defined for input in the range
   1259      LEAST_KNOWN_OBJ_ATTRIBUTE..NUM_KNOWN_OBJ_ATTRIBUTES-1 (this range
   1260      is used in order to make unity easy).  The returned value is the
   1261      actual tag number to place in the input position.  */
   1262   int (*obj_attrs_order) (int);
   1263 
   1264   /* Handle merging unknown attributes; either warn and return TRUE,
   1265      or give an error and return FALSE.  */
   1266   bfd_boolean (*obj_attrs_handle_unknown) (bfd *, int);
   1267 
   1268   /* This is non-zero if static TLS segments require a special alignment.  */
   1269   unsigned static_tls_alignment;
   1270 
   1271   /* This is TRUE if the linker should act like collect and gather
   1272      global constructors and destructors by name.  This is TRUE for
   1273      MIPS ELF because the Irix 5 tools can not handle the .init
   1274      section.  */
   1275   unsigned collect : 1;
   1276 
   1277   /* This is TRUE if the linker should ignore changes to the type of a
   1278      symbol.  This is TRUE for MIPS ELF because some Irix 5 objects
   1279      record undefined functions as STT_OBJECT although the definitions
   1280      are STT_FUNC.  */
   1281   unsigned type_change_ok : 1;
   1282 
   1283   /* Whether the backend may use REL relocations.  (Some backends use
   1284      both REL and RELA relocations, and this flag is set for those
   1285      backends.)  */
   1286   unsigned may_use_rel_p : 1;
   1287 
   1288   /* Whether the backend may use RELA relocations.  (Some backends use
   1289      both REL and RELA relocations, and this flag is set for those
   1290      backends.)  */
   1291   unsigned may_use_rela_p : 1;
   1292 
   1293   /* Whether the default relocation type is RELA.  If a backend with
   1294      this flag set wants REL relocations for a particular section,
   1295      it must note that explicitly.  Similarly, if this flag is clear,
   1296      and the backend wants RELA relocations for a particular
   1297      section.  */
   1298   unsigned default_use_rela_p : 1;
   1299 
   1300   /* True if PLT and copy relocations should be RELA by default.  */
   1301   unsigned rela_plts_and_copies_p : 1;
   1302 
   1303   /* Set if RELA relocations for a relocatable link can be handled by
   1304      generic code.  Backends that set this flag need do nothing in the
   1305      backend relocate_section routine for relocatable linking.  */
   1306   unsigned rela_normal : 1;
   1307 
   1308   /* TRUE if addresses "naturally" sign extend.  This is used when
   1309      swapping in from Elf32 when BFD64.  */
   1310   unsigned sign_extend_vma : 1;
   1311 
   1312   unsigned want_got_plt : 1;
   1313   unsigned plt_readonly : 1;
   1314   unsigned want_plt_sym : 1;
   1315   unsigned plt_not_loaded : 1;
   1316   unsigned plt_alignment : 4;
   1317   unsigned can_gc_sections : 1;
   1318   unsigned can_refcount : 1;
   1319   unsigned want_got_sym : 1;
   1320   unsigned want_dynbss : 1;
   1321 
   1322   /* Targets which do not support physical addressing often require
   1323      that the p_paddr field in the section header to be set to zero.
   1324      This field indicates whether this behavior is required.  */
   1325   unsigned want_p_paddr_set_to_zero : 1;
   1326 
   1327   /* True if an object file lacking a .note.GNU-stack section
   1328      should be assumed to be requesting exec stack.  At least one
   1329      other file in the link needs to have a .note.GNU-stack section
   1330      for a PT_GNU_STACK segment to be created.  */
   1331   unsigned default_execstack : 1;
   1332 };
   1333 
   1334 /* Information about reloc sections associated with a bfd_elf_section_data
   1335    structure.  */
   1336 struct bfd_elf_section_reloc_data
   1337 {
   1338   /* The ELF header for the reloc section associated with this
   1339      section, if any.  */
   1340   Elf_Internal_Shdr *hdr;
   1341   /* The number of relocations currently assigned to HDR.  */
   1342   unsigned int count;
   1343   /* The ELF section number of the reloc section.  Only used for an
   1344      output file.  */
   1345   int idx;
   1346   /* Used by the backend linker to store the symbol hash table entries
   1347      associated with relocs against global symbols.  */
   1348   struct elf_link_hash_entry **hashes;
   1349 };
   1350 
   1351 /* Information stored for each BFD section in an ELF file.  This
   1352    structure is allocated by elf_new_section_hook.  */
   1353 
   1354 struct bfd_elf_section_data
   1355 {
   1356   /* The ELF header for this section.  */
   1357   Elf_Internal_Shdr this_hdr;
   1358 
   1359   /* Information about the REL and RELA reloc sections associated
   1360      with this section, if any.  */
   1361   struct bfd_elf_section_reloc_data rel, rela;
   1362 
   1363   /* The ELF section number of this section.  */
   1364   int this_idx;
   1365 
   1366   /* Used by the backend linker when generating a shared library to
   1367      record the dynamic symbol index for a section symbol
   1368      corresponding to this section.  A value of 0 means that there is
   1369      no dynamic symbol for this section.  */
   1370   int dynindx;
   1371 
   1372   /* A pointer to the linked-to section for SHF_LINK_ORDER.  */
   1373   asection *linked_to;
   1374 
   1375   /* A pointer to the swapped relocs.  If the section uses REL relocs,
   1376      rather than RELA, all the r_addend fields will be zero.  This
   1377      pointer may be NULL.  It is used by the backend linker.  */
   1378   Elf_Internal_Rela *relocs;
   1379 
   1380   /* A pointer to a linked list tracking dynamic relocs copied for
   1381      local symbols.  */
   1382   void *local_dynrel;
   1383 
   1384   /* A pointer to the bfd section used for dynamic relocs.  */
   1385   asection *sreloc;
   1386 
   1387   union {
   1388     /* Group name, if this section is a member of a group.  */
   1389     const char *name;
   1390 
   1391     /* Group signature sym, if this is the SHT_GROUP section.  */
   1392     struct bfd_symbol *id;
   1393   } group;
   1394 
   1395   /* For a member of a group, points to the SHT_GROUP section.
   1396      NULL for the SHT_GROUP section itself and non-group sections.  */
   1397   asection *sec_group;
   1398 
   1399   /* A linked list of member sections in the group.  Circular when used by
   1400      the linker.  For the SHT_GROUP section, points at first member.  */
   1401   asection *next_in_group;
   1402 
   1403   /* The FDEs associated with this section.  The u.fde.next_in_section
   1404      field acts as a chain pointer.  */
   1405   struct eh_cie_fde *fde_list;
   1406 
   1407   /* A pointer used for various section optimizations.  */
   1408   void *sec_info;
   1409 };
   1410 
   1411 #define elf_section_data(sec)  ((struct bfd_elf_section_data*)(sec)->used_by_bfd)
   1412 #define elf_linked_to_section(sec) (elf_section_data(sec)->linked_to)
   1413 #define elf_section_type(sec)  (elf_section_data(sec)->this_hdr.sh_type)
   1414 #define elf_section_flags(sec) (elf_section_data(sec)->this_hdr.sh_flags)
   1415 #define elf_group_name(sec)    (elf_section_data(sec)->group.name)
   1416 #define elf_group_id(sec)      (elf_section_data(sec)->group.id)
   1417 #define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group)
   1418 #define elf_fde_list(sec)      (elf_section_data(sec)->fde_list)
   1419 #define elf_sec_group(sec)	(elf_section_data(sec)->sec_group)
   1420 
   1421 #define xvec_get_elf_backend_data(xvec) \
   1422   ((const struct elf_backend_data *) (xvec)->backend_data)
   1423 
   1424 #define get_elf_backend_data(abfd) \
   1425    xvec_get_elf_backend_data ((abfd)->xvec)
   1426 
   1427 /* The least object attributes (within an attributes subsection) known
   1428    for any target.  Some code assumes that the value 0 is not used and
   1429    the field for that attribute can instead be used as a marker to
   1430    indicate that attributes have been initialized.  */
   1431 #define LEAST_KNOWN_OBJ_ATTRIBUTE 2
   1432 
   1433 /* The maximum number of known object attributes for any target.  */
   1434 #define NUM_KNOWN_OBJ_ATTRIBUTES 71
   1435 
   1436 /* The value of an object attribute.  The type indicates whether the attribute
   1437    holds and integer, a string, or both.  It can also indicate that there can
   1438    be no default (i.e. all values must be written to file, even zero).  */
   1439 
   1440 typedef struct obj_attribute
   1441 {
   1442 #define ATTR_TYPE_FLAG_INT_VAL    (1 << 0)
   1443 #define ATTR_TYPE_FLAG_STR_VAL    (1 << 1)
   1444 #define ATTR_TYPE_FLAG_NO_DEFAULT (1 << 2)
   1445 
   1446 #define ATTR_TYPE_HAS_INT_VAL(TYPE)	((TYPE) & ATTR_TYPE_FLAG_INT_VAL)
   1447 #define ATTR_TYPE_HAS_STR_VAL(TYPE)	((TYPE) & ATTR_TYPE_FLAG_STR_VAL)
   1448 #define ATTR_TYPE_HAS_NO_DEFAULT(TYPE)	((TYPE) & ATTR_TYPE_FLAG_NO_DEFAULT)
   1449 
   1450   int type;
   1451   unsigned int i;
   1452   char *s;
   1453 } obj_attribute;
   1454 
   1455 typedef struct obj_attribute_list
   1456 {
   1457   struct obj_attribute_list *next;
   1458   int tag;
   1459   obj_attribute attr;
   1460 } obj_attribute_list;
   1461 
   1462 /* Object attributes may either be defined by the processor ABI, index
   1463    OBJ_ATTR_PROC in the *_obj_attributes arrays, or be GNU-specific
   1464    (and possibly also processor-specific), index OBJ_ATTR_GNU.  */
   1465 #define OBJ_ATTR_PROC 0
   1466 #define OBJ_ATTR_GNU 1
   1467 #define OBJ_ATTR_FIRST OBJ_ATTR_PROC
   1468 #define OBJ_ATTR_LAST OBJ_ATTR_GNU
   1469 
   1470 /* The following object attribute tags are taken as generic, for all
   1471    targets and for "gnu" where there is no target standard.  */
   1472 enum
   1473 {
   1474   Tag_NULL = 0,
   1475   Tag_File = 1,
   1476   Tag_Section = 2,
   1477   Tag_Symbol = 3,
   1478   Tag_compatibility = 32
   1479 };
   1480 
   1481 /* Some private data is stashed away for future use using the tdata pointer
   1482    in the bfd structure.  */
   1483 
   1484 struct elf_obj_tdata
   1485 {
   1486   Elf_Internal_Ehdr elf_header[1];	/* Actual data, but ref like ptr */
   1487   Elf_Internal_Shdr **elf_sect_ptr;
   1488   Elf_Internal_Phdr *phdr;
   1489   struct elf_segment_map *segment_map;
   1490   struct elf_strtab_hash *strtab_ptr;
   1491   int num_locals;
   1492   int num_globals;
   1493   unsigned int num_elf_sections;	/* elf_sect_ptr size */
   1494   int num_section_syms;
   1495   asymbol **section_syms;		/* STT_SECTION symbols for each section */
   1496   Elf_Internal_Shdr symtab_hdr;
   1497   Elf_Internal_Shdr shstrtab_hdr;
   1498   Elf_Internal_Shdr strtab_hdr;
   1499   Elf_Internal_Shdr dynsymtab_hdr;
   1500   Elf_Internal_Shdr dynstrtab_hdr;
   1501   Elf_Internal_Shdr dynversym_hdr;
   1502   Elf_Internal_Shdr dynverref_hdr;
   1503   Elf_Internal_Shdr dynverdef_hdr;
   1504   Elf_Internal_Shdr symtab_shndx_hdr;
   1505   unsigned int symtab_section, shstrtab_section;
   1506   unsigned int strtab_section, dynsymtab_section;
   1507   unsigned int symtab_shndx_section;
   1508   unsigned int dynversym_section, dynverdef_section, dynverref_section;
   1509   file_ptr next_file_pos;
   1510   bfd_vma gp;				/* The gp value */
   1511   unsigned int gp_size;			/* The gp size */
   1512 
   1513   /* Information grabbed from an elf core file.  */
   1514   int core_signal;
   1515   int core_pid;
   1516   int core_lwpid;
   1517   char* core_program;
   1518   char* core_command;
   1519 
   1520   /* A mapping from external symbols to entries in the linker hash
   1521      table, used when linking.  This is indexed by the symbol index
   1522      minus the sh_info field of the symbol table header.  */
   1523   struct elf_link_hash_entry **sym_hashes;
   1524 
   1525   /* Track usage and final offsets of GOT entries for local symbols.
   1526      This array is indexed by symbol index.  Elements are used
   1527      identically to "got" in struct elf_link_hash_entry.  */
   1528   union
   1529     {
   1530       bfd_signed_vma *refcounts;
   1531       bfd_vma *offsets;
   1532       struct got_entry **ents;
   1533     } local_got;
   1534 
   1535   /* The linker ELF emulation code needs to let the backend ELF linker
   1536      know what filename should be used for a dynamic object if the
   1537      dynamic object is found using a search.  The emulation code then
   1538      sometimes needs to know what name was actually used.  Until the
   1539      file has been added to the linker symbol table, this field holds
   1540      the name the linker wants.  After it has been added, it holds the
   1541      name actually used, which will be the DT_SONAME entry if there is
   1542      one.  */
   1543   const char *dt_name;
   1544 
   1545   /* The linker emulation needs to know what audit libs
   1546      are used by a dynamic object.  */
   1547   const char *dt_audit;
   1548 
   1549   /* Records the result of `get_program_header_size'.  */
   1550   bfd_size_type program_header_size;
   1551 
   1552   /* Used by find_nearest_line entry point.  */
   1553   void *line_info;
   1554 
   1555   /* Used by MIPS ELF find_nearest_line entry point.  The structure
   1556      could be included directly in this one, but there's no point to
   1557      wasting the memory just for the infrequently called
   1558      find_nearest_line.  */
   1559   struct mips_elf_find_line *find_line_info;
   1560 
   1561   /* A place to stash dwarf1 info for this bfd.  */
   1562   struct dwarf1_debug *dwarf1_find_line_info;
   1563 
   1564   /* A place to stash dwarf2 info for this bfd.  */
   1565   void *dwarf2_find_line_info;
   1566 
   1567   /* An array of stub sections indexed by symbol number, used by the
   1568      MIPS ELF linker.  FIXME: We should figure out some way to only
   1569      include this field for a MIPS ELF target.  */
   1570   asection **local_stubs;
   1571   asection **local_call_stubs;
   1572 
   1573   /* Used to determine if PT_GNU_EH_FRAME segment header should be
   1574      created.  */
   1575   asection *eh_frame_hdr;
   1576 
   1577   Elf_Internal_Shdr **group_sect_ptr;
   1578   int num_group;
   1579 
   1580   /* Number of symbol version definitions we are about to emit.  */
   1581   unsigned int cverdefs;
   1582 
   1583   /* Number of symbol version references we are about to emit.  */
   1584   unsigned int cverrefs;
   1585 
   1586   /* Segment flags for the PT_GNU_STACK segment.  */
   1587   unsigned int stack_flags;
   1588 
   1589   /* Symbol version definitions in external objects.  */
   1590   Elf_Internal_Verdef *verdef;
   1591 
   1592   /* Symbol version references to external objects.  */
   1593   Elf_Internal_Verneed *verref;
   1594 
   1595   /* The Irix 5 support uses two virtual sections, which represent
   1596      text/data symbols defined in dynamic objects.  */
   1597   asymbol *elf_data_symbol;
   1598   asymbol *elf_text_symbol;
   1599   asection *elf_data_section;
   1600   asection *elf_text_section;
   1601 
   1602   /* A pointer to the .eh_frame section.  */
   1603   asection *eh_frame_section;
   1604 
   1605   /* Whether a dyanmic object was specified normally on the linker
   1606      command line, or was specified when --as-needed was in effect,
   1607      or was found via a DT_NEEDED entry.  */
   1608   enum dynamic_lib_link_class dyn_lib_class;
   1609 
   1610   /* This is set to TRUE if the object was created by the backend
   1611      linker.  */
   1612   bfd_boolean linker;
   1613 
   1614   /* Irix 5 often screws up the symbol table, sorting local symbols
   1615      after global symbols.  This flag is set if the symbol table in
   1616      this BFD appears to be screwed up.  If it is, we ignore the
   1617      sh_info field in the symbol table header, and always read all the
   1618      symbols.  */
   1619   bfd_boolean bad_symtab;
   1620 
   1621   /* Used to determine if the e_flags field has been initialized */
   1622   bfd_boolean flags_init;
   1623 
   1624   /* Symbol buffer.  */
   1625   void *symbuf;
   1626 
   1627   obj_attribute known_obj_attributes[2][NUM_KNOWN_OBJ_ATTRIBUTES];
   1628   obj_attribute_list *other_obj_attributes[2];
   1629 
   1630   /* Called at the end of _bfd_elf_write_object_contents if not NULL.  */
   1631   bfd_boolean (*after_write_object_contents) (bfd *);
   1632   void *after_write_object_contents_info;
   1633 
   1634   /* NT_GNU_BUILD_ID note type.  */
   1635   bfd_size_type build_id_size;
   1636   bfd_byte *build_id;
   1637 
   1638   /* True if the bfd contains symbols that have the STT_GNU_IFUNC
   1639      symbol type.  Used to set the osabi field in the ELF header
   1640      structure.  */
   1641   bfd_boolean has_ifunc_symbols;
   1642 
   1643   /* An identifier used to distinguish different target
   1644      specific extensions to this structure.  */
   1645   enum elf_target_id object_id;
   1646 };
   1647 
   1648 #define elf_tdata(bfd)		((bfd) -> tdata.elf_obj_data)
   1649 
   1650 #define elf_object_id(bfd)	(elf_tdata(bfd) -> object_id)
   1651 #define elf_program_header_size(bfd) (elf_tdata(bfd) -> program_header_size)
   1652 #define elf_elfheader(bfd)	(elf_tdata(bfd) -> elf_header)
   1653 #define elf_elfsections(bfd)	(elf_tdata(bfd) -> elf_sect_ptr)
   1654 #define elf_numsections(bfd)	(elf_tdata(bfd) -> num_elf_sections)
   1655 #define elf_shstrtab(bfd)	(elf_tdata(bfd) -> strtab_ptr)
   1656 #define elf_onesymtab(bfd)	(elf_tdata(bfd) -> symtab_section)
   1657 #define elf_symtab_shndx(bfd)	(elf_tdata(bfd) -> symtab_shndx_section)
   1658 #define elf_symtab_hdr(bfd)	(elf_tdata(bfd) -> symtab_hdr)
   1659 #define elf_dynsymtab(bfd)	(elf_tdata(bfd) -> dynsymtab_section)
   1660 #define elf_dynversym(bfd)	(elf_tdata(bfd) -> dynversym_section)
   1661 #define elf_dynverdef(bfd)	(elf_tdata(bfd) -> dynverdef_section)
   1662 #define elf_dynverref(bfd)	(elf_tdata(bfd) -> dynverref_section)
   1663 #define elf_eh_frame_section(bfd) \
   1664 				(elf_tdata(bfd) -> eh_frame_section)
   1665 #define elf_num_locals(bfd)	(elf_tdata(bfd) -> num_locals)
   1666 #define elf_num_globals(bfd)	(elf_tdata(bfd) -> num_globals)
   1667 #define elf_section_syms(bfd)	(elf_tdata(bfd) -> section_syms)
   1668 #define elf_num_section_syms(bfd) (elf_tdata(bfd) -> num_section_syms)
   1669 #define core_prpsinfo(bfd)	(elf_tdata(bfd) -> prpsinfo)
   1670 #define core_prstatus(bfd)	(elf_tdata(bfd) -> prstatus)
   1671 #define elf_gp(bfd)		(elf_tdata(bfd) -> gp)
   1672 #define elf_gp_size(bfd)	(elf_tdata(bfd) -> gp_size)
   1673 #define elf_sym_hashes(bfd)	(elf_tdata(bfd) -> sym_hashes)
   1674 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
   1675 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
   1676 #define elf_local_got_ents(bfd) (elf_tdata(bfd) -> local_got.ents)
   1677 #define elf_dt_name(bfd)	(elf_tdata(bfd) -> dt_name)
   1678 #define elf_dt_audit(bfd)	(elf_tdata(bfd) -> dt_audit)
   1679 #define elf_dyn_lib_class(bfd)	(elf_tdata(bfd) -> dyn_lib_class)
   1680 #define elf_bad_symtab(bfd)	(elf_tdata(bfd) -> bad_symtab)
   1681 #define elf_flags_init(bfd)	(elf_tdata(bfd) -> flags_init)
   1682 #define elf_known_obj_attributes(bfd) (elf_tdata (bfd) -> known_obj_attributes)
   1683 #define elf_other_obj_attributes(bfd) (elf_tdata (bfd) -> other_obj_attributes)
   1684 #define elf_known_obj_attributes_proc(bfd) \
   1685   (elf_known_obj_attributes (bfd) [OBJ_ATTR_PROC])
   1686 #define elf_other_obj_attributes_proc(bfd) \
   1687   (elf_other_obj_attributes (bfd) [OBJ_ATTR_PROC])
   1688 
   1689 extern void _bfd_elf_swap_verdef_in
   1691   (bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *);
   1692 extern void _bfd_elf_swap_verdef_out
   1693   (bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *);
   1694 extern void _bfd_elf_swap_verdaux_in
   1695   (bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *);
   1696 extern void _bfd_elf_swap_verdaux_out
   1697   (bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *);
   1698 extern void _bfd_elf_swap_verneed_in
   1699   (bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *);
   1700 extern void _bfd_elf_swap_verneed_out
   1701   (bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *);
   1702 extern void _bfd_elf_swap_vernaux_in
   1703   (bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *);
   1704 extern void _bfd_elf_swap_vernaux_out
   1705   (bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *);
   1706 extern void _bfd_elf_swap_versym_in
   1707   (bfd *, const Elf_External_Versym *, Elf_Internal_Versym *);
   1708 extern void _bfd_elf_swap_versym_out
   1709   (bfd *, const Elf_Internal_Versym *, Elf_External_Versym *);
   1710 
   1711 extern unsigned int _bfd_elf_section_from_bfd_section
   1712   (bfd *, asection *);
   1713 extern char *bfd_elf_string_from_elf_section
   1714   (bfd *, unsigned, unsigned);
   1715 extern Elf_Internal_Sym *bfd_elf_get_elf_syms
   1716   (bfd *, Elf_Internal_Shdr *, size_t, size_t, Elf_Internal_Sym *, void *,
   1717    Elf_External_Sym_Shndx *);
   1718 extern const char *bfd_elf_sym_name
   1719   (bfd *, Elf_Internal_Shdr *, Elf_Internal_Sym *, asection *);
   1720 
   1721 extern bfd_boolean _bfd_elf_copy_private_bfd_data
   1722   (bfd *, bfd *);
   1723 extern bfd_boolean _bfd_elf_print_private_bfd_data
   1724   (bfd *, void *);
   1725 extern void bfd_elf_print_symbol
   1726   (bfd *, void *, asymbol *, bfd_print_symbol_type);
   1727 
   1728 extern unsigned int _bfd_elf_eh_frame_address_size
   1729   (bfd *, asection *);
   1730 extern bfd_byte _bfd_elf_encode_eh_address
   1731   (bfd *abfd, struct bfd_link_info *info, asection *osec, bfd_vma offset,
   1732    asection *loc_sec, bfd_vma loc_offset, bfd_vma *encoded);
   1733 extern bfd_boolean _bfd_elf_can_make_relative
   1734   (bfd *input_bfd, struct bfd_link_info *info, asection *eh_frame_section);
   1735 
   1736 extern enum elf_reloc_type_class _bfd_elf_reloc_type_class
   1737   (const Elf_Internal_Rela *);
   1738 extern bfd_vma _bfd_elf_rela_local_sym
   1739   (bfd *, Elf_Internal_Sym *, asection **, Elf_Internal_Rela *);
   1740 extern bfd_vma _bfd_elf_rel_local_sym
   1741   (bfd *, Elf_Internal_Sym *, asection **, bfd_vma);
   1742 extern bfd_vma _bfd_elf_section_offset
   1743   (bfd *, struct bfd_link_info *, asection *, bfd_vma);
   1744 
   1745 extern unsigned long bfd_elf_hash
   1746   (const char *);
   1747 extern unsigned long bfd_elf_gnu_hash
   1748   (const char *);
   1749 
   1750 extern bfd_reloc_status_type bfd_elf_generic_reloc
   1751   (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
   1752 extern bfd_boolean bfd_elf_allocate_object
   1753   (bfd *, size_t, enum elf_target_id);
   1754 extern bfd_boolean bfd_elf_make_object
   1755   (bfd *);
   1756 extern bfd_boolean bfd_elf_mkcorefile
   1757   (bfd *);
   1758 extern bfd_boolean _bfd_elf_make_section_from_shdr
   1759   (bfd *, Elf_Internal_Shdr *, const char *, int);
   1760 extern bfd_boolean _bfd_elf_make_section_from_phdr
   1761   (bfd *, Elf_Internal_Phdr *, int, const char *);
   1762 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
   1763   (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
   1764 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
   1765   (bfd *);
   1766 extern void _bfd_elf_link_hash_copy_indirect
   1767   (struct bfd_link_info *, struct elf_link_hash_entry *,
   1768    struct elf_link_hash_entry *);
   1769 extern void _bfd_elf_link_hash_hide_symbol
   1770   (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
   1771 extern bfd_boolean _bfd_elf_link_hash_fixup_symbol
   1772   (struct bfd_link_info *, struct elf_link_hash_entry *);
   1773 extern bfd_boolean _bfd_elf_link_hash_table_init
   1774   (struct elf_link_hash_table *, bfd *,
   1775    struct bfd_hash_entry *(*)
   1776      (struct bfd_hash_entry *, struct bfd_hash_table *, const char *),
   1777    unsigned int, enum elf_target_id);
   1778 extern bfd_boolean _bfd_elf_slurp_version_tables
   1779   (bfd *, bfd_boolean);
   1780 extern bfd_boolean _bfd_elf_merge_sections
   1781   (bfd *, struct bfd_link_info *);
   1782 extern bfd_boolean _bfd_elf_match_sections_by_type
   1783   (bfd *, const asection *, bfd *, const asection *);
   1784 extern bfd_boolean bfd_elf_is_group_section
   1785   (bfd *, const struct bfd_section *);
   1786 extern void _bfd_elf_section_already_linked
   1787   (bfd *, struct bfd_section *, struct bfd_link_info *);
   1788 extern void bfd_elf_set_group_contents
   1789   (bfd *, asection *, void *);
   1790 extern asection *_bfd_elf_check_kept_section
   1791   (asection *, struct bfd_link_info *);
   1792 extern void _bfd_elf_link_just_syms
   1793   (asection *, struct bfd_link_info *);
   1794 extern void _bfd_elf_copy_link_hash_symbol_type
   1795   (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *);
   1796 extern bfd_boolean _bfd_elf_size_group_sections
   1797   (struct bfd_link_info *);
   1798 extern bfd_boolean _bfd_elf_fixup_group_sections
   1799 (bfd *, asection *);
   1800 extern bfd_boolean _bfd_elf_copy_private_header_data
   1801   (bfd *, bfd *);
   1802 extern bfd_boolean _bfd_elf_copy_private_symbol_data
   1803   (bfd *, asymbol *, bfd *, asymbol *);
   1804 #define _bfd_generic_init_private_section_data \
   1805   _bfd_elf_init_private_section_data
   1806 extern bfd_boolean _bfd_elf_init_private_section_data
   1807   (bfd *, asection *, bfd *, asection *, struct bfd_link_info *);
   1808 extern bfd_boolean _bfd_elf_copy_private_section_data
   1809   (bfd *, asection *, bfd *, asection *);
   1810 extern bfd_boolean _bfd_elf_write_object_contents
   1811   (bfd *);
   1812 extern bfd_boolean _bfd_elf_write_corefile_contents
   1813   (bfd *);
   1814 extern bfd_boolean _bfd_elf_set_section_contents
   1815   (bfd *, sec_ptr, const void *, file_ptr, bfd_size_type);
   1816 extern long _bfd_elf_get_symtab_upper_bound
   1817   (bfd *);
   1818 extern long _bfd_elf_canonicalize_symtab
   1819   (bfd *, asymbol **);
   1820 extern long _bfd_elf_get_dynamic_symtab_upper_bound
   1821   (bfd *);
   1822 extern long _bfd_elf_canonicalize_dynamic_symtab
   1823   (bfd *, asymbol **);
   1824 extern long _bfd_elf_get_synthetic_symtab
   1825   (bfd *, long, asymbol **, long, asymbol **, asymbol **);
   1826 extern long _bfd_elf_get_reloc_upper_bound
   1827   (bfd *, sec_ptr);
   1828 extern long _bfd_elf_canonicalize_reloc
   1829   (bfd *, sec_ptr, arelent **, asymbol **);
   1830 extern asection * _bfd_elf_get_dynamic_reloc_section
   1831   (bfd *, asection *, bfd_boolean);
   1832 extern asection * _bfd_elf_make_dynamic_reloc_section
   1833   (asection *, bfd *, unsigned int, bfd *, bfd_boolean);
   1834 extern long _bfd_elf_get_dynamic_reloc_upper_bound
   1835   (bfd *);
   1836 extern long _bfd_elf_canonicalize_dynamic_reloc
   1837   (bfd *, arelent **, asymbol **);
   1838 extern asymbol *_bfd_elf_make_empty_symbol
   1839   (bfd *);
   1840 extern void _bfd_elf_get_symbol_info
   1841   (bfd *, asymbol *, symbol_info *);
   1842 extern bfd_boolean _bfd_elf_is_local_label_name
   1843   (bfd *, const char *);
   1844 extern alent *_bfd_elf_get_lineno
   1845   (bfd *, asymbol *);
   1846 extern bfd_boolean _bfd_elf_set_arch_mach
   1847   (bfd *, enum bfd_architecture, unsigned long);
   1848 extern bfd_boolean _bfd_elf_find_nearest_line
   1849   (bfd *, asection *, asymbol **, bfd_vma, const char **, const char **,
   1850    unsigned int *);
   1851 extern bfd_boolean _bfd_elf_find_line
   1852   (bfd *, asymbol **, asymbol *, const char **, unsigned int *);
   1853 #define _bfd_generic_find_line _bfd_elf_find_line
   1854 extern bfd_boolean _bfd_elf_find_inliner_info
   1855   (bfd *, const char **, const char **, unsigned int *);
   1856 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
   1857 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
   1858 extern int _bfd_elf_sizeof_headers
   1859   (bfd *, struct bfd_link_info *);
   1860 extern bfd_boolean _bfd_elf_new_section_hook
   1861   (bfd *, asection *);
   1862 extern bfd_boolean _bfd_elf_init_reloc_shdr
   1863   (bfd *, struct bfd_elf_section_reloc_data *, asection *, bfd_boolean);
   1864 extern const struct bfd_elf_special_section *_bfd_elf_get_special_section
   1865   (const char *, const struct bfd_elf_special_section *, unsigned int);
   1866 extern const struct bfd_elf_special_section *_bfd_elf_get_sec_type_attr
   1867   (bfd *, asection *);
   1868 
   1869 /* If the target doesn't have reloc handling written yet:  */
   1870 extern void _bfd_elf_no_info_to_howto
   1871   (bfd *, arelent *, Elf_Internal_Rela *);
   1872 
   1873 extern bfd_boolean bfd_section_from_shdr
   1874   (bfd *, unsigned int shindex);
   1875 extern bfd_boolean bfd_section_from_phdr
   1876   (bfd *, Elf_Internal_Phdr *, int);
   1877 
   1878 extern int _bfd_elf_symbol_from_bfd_symbol
   1879   (bfd *, asymbol **);
   1880 
   1881 extern Elf_Internal_Sym *bfd_sym_from_r_symndx
   1882   (struct sym_cache *, bfd *, unsigned long);
   1883 extern asection *bfd_section_from_elf_index
   1884   (bfd *, unsigned int);
   1885 extern struct bfd_strtab_hash *_bfd_elf_stringtab_init
   1886   (void);
   1887 
   1888 extern struct elf_strtab_hash * _bfd_elf_strtab_init
   1889   (void);
   1890 extern void _bfd_elf_strtab_free
   1891   (struct elf_strtab_hash *);
   1892 extern bfd_size_type _bfd_elf_strtab_add
   1893   (struct elf_strtab_hash *, const char *, bfd_boolean);
   1894 extern void _bfd_elf_strtab_addref
   1895   (struct elf_strtab_hash *, bfd_size_type);
   1896 extern void _bfd_elf_strtab_delref
   1897   (struct elf_strtab_hash *, bfd_size_type);
   1898 extern void _bfd_elf_strtab_clear_all_refs
   1899   (struct elf_strtab_hash *);
   1900 extern bfd_size_type _bfd_elf_strtab_size
   1901   (struct elf_strtab_hash *);
   1902 extern bfd_size_type _bfd_elf_strtab_offset
   1903   (struct elf_strtab_hash *, bfd_size_type);
   1904 extern bfd_boolean _bfd_elf_strtab_emit
   1905   (bfd *, struct elf_strtab_hash *);
   1906 extern void _bfd_elf_strtab_finalize
   1907   (struct elf_strtab_hash *);
   1908 
   1909 extern void _bfd_elf_begin_eh_frame_parsing
   1910   (struct bfd_link_info *info);
   1911 extern void _bfd_elf_parse_eh_frame
   1912   (bfd *, struct bfd_link_info *, asection *, struct elf_reloc_cookie *);
   1913 extern void _bfd_elf_end_eh_frame_parsing
   1914   (struct bfd_link_info *info);
   1915 
   1916 extern bfd_boolean _bfd_elf_discard_section_eh_frame
   1917   (bfd *, struct bfd_link_info *, asection *,
   1918    bfd_boolean (*) (bfd_vma, void *), struct elf_reloc_cookie *);
   1919 extern bfd_boolean _bfd_elf_discard_section_eh_frame_hdr
   1920   (bfd *, struct bfd_link_info *);
   1921 extern bfd_vma _bfd_elf_eh_frame_section_offset
   1922   (bfd *, struct bfd_link_info *, asection *, bfd_vma);
   1923 extern bfd_boolean _bfd_elf_write_section_eh_frame
   1924   (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
   1925 extern bfd_boolean _bfd_elf_write_section_eh_frame_hdr
   1926   (bfd *, struct bfd_link_info *);
   1927 extern bfd_boolean _bfd_elf_maybe_strip_eh_frame_hdr
   1928   (struct bfd_link_info *);
   1929 
   1930 extern bfd_boolean _bfd_elf_merge_symbol
   1931   (bfd *, struct bfd_link_info *, const char *, Elf_Internal_Sym *,
   1932    asection **, bfd_vma *, unsigned int *,
   1933    struct elf_link_hash_entry **, bfd_boolean *,
   1934    bfd_boolean *, bfd_boolean *, bfd_boolean *);
   1935 
   1936 extern bfd_boolean _bfd_elf_hash_symbol (struct elf_link_hash_entry *);
   1937 
   1938 extern long _bfd_elf_link_lookup_local_dynindx
   1939   (struct bfd_link_info *, bfd *, long);
   1940 extern bfd_boolean _bfd_elf_compute_section_file_positions
   1941   (bfd *, struct bfd_link_info *);
   1942 extern void _bfd_elf_assign_file_positions_for_relocs
   1943   (bfd *);
   1944 extern file_ptr _bfd_elf_assign_file_position_for_section
   1945   (Elf_Internal_Shdr *, file_ptr, bfd_boolean);
   1946 
   1947 extern bfd_boolean _bfd_elf_validate_reloc
   1948   (bfd *, arelent *);
   1949 
   1950 extern bfd_boolean _bfd_elf_link_create_dynamic_sections
   1951   (bfd *, struct bfd_link_info *);
   1952 extern bfd_boolean _bfd_elf_link_omit_section_dynsym
   1953   (bfd *, struct bfd_link_info *, asection *);
   1954 extern bfd_boolean _bfd_elf_create_dynamic_sections
   1955   (bfd *, struct bfd_link_info *);
   1956 extern bfd_boolean _bfd_elf_create_got_section
   1957   (bfd *, struct bfd_link_info *);
   1958 extern struct elf_link_hash_entry *_bfd_elf_define_linkage_sym
   1959   (bfd *, struct bfd_link_info *, asection *, const char *);
   1960 extern void _bfd_elf_init_1_index_section
   1961   (bfd *, struct bfd_link_info *);
   1962 extern void _bfd_elf_init_2_index_sections
   1963   (bfd *, struct bfd_link_info *);
   1964 
   1965 extern bfd_boolean _bfd_elfcore_make_pseudosection
   1966   (bfd *, char *, size_t, ufile_ptr);
   1967 extern char *_bfd_elfcore_strndup
   1968   (bfd *, char *, size_t);
   1969 
   1970 extern Elf_Internal_Rela *_bfd_elf_link_read_relocs
   1971   (bfd *, asection *, void *, Elf_Internal_Rela *, bfd_boolean);
   1972 
   1973 extern bfd_boolean _bfd_elf_link_output_relocs
   1974   (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *,
   1975    struct elf_link_hash_entry **);
   1976 
   1977 extern bfd_boolean _bfd_elf_adjust_dynamic_copy
   1978   (struct elf_link_hash_entry *, asection *);
   1979 
   1980 extern bfd_boolean _bfd_elf_dynamic_symbol_p
   1981   (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
   1982 
   1983 extern bfd_boolean _bfd_elf_symbol_refs_local_p
   1984   (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
   1985 
   1986 extern bfd_reloc_status_type bfd_elf_perform_complex_relocation
   1987   (bfd *, asection *, bfd_byte *, Elf_Internal_Rela *, bfd_vma);
   1988 
   1989 extern bfd_boolean _bfd_elf_setup_sections
   1990   (bfd *);
   1991 
   1992 extern void _bfd_elf_set_osabi (bfd * , struct bfd_link_info *);
   1993 
   1994 extern const bfd_target *bfd_elf32_object_p
   1995   (bfd *);
   1996 extern const bfd_target *bfd_elf32_core_file_p
   1997   (bfd *);
   1998 extern char *bfd_elf32_core_file_failing_command
   1999   (bfd *);
   2000 extern int bfd_elf32_core_file_failing_signal
   2001   (bfd *);
   2002 extern bfd_boolean bfd_elf32_core_file_matches_executable_p
   2003   (bfd *, bfd *);
   2004 extern int bfd_elf32_core_file_pid
   2005   (bfd *);
   2006 
   2007 extern bfd_boolean bfd_elf32_swap_symbol_in
   2008   (bfd *, const void *, const void *, Elf_Internal_Sym *);
   2009 extern void bfd_elf32_swap_symbol_out
   2010   (bfd *, const Elf_Internal_Sym *, void *, void *);
   2011 extern void bfd_elf32_swap_reloc_in
   2012   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
   2013 extern void bfd_elf32_swap_reloc_out
   2014   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
   2015 extern void bfd_elf32_swap_reloca_in
   2016   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
   2017 extern void bfd_elf32_swap_reloca_out
   2018   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
   2019 extern void bfd_elf32_swap_phdr_in
   2020   (bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *);
   2021 extern void bfd_elf32_swap_phdr_out
   2022   (bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *);
   2023 extern void bfd_elf32_swap_dyn_in
   2024   (bfd *, const void *, Elf_Internal_Dyn *);
   2025 extern void bfd_elf32_swap_dyn_out
   2026   (bfd *, const Elf_Internal_Dyn *, void *);
   2027 extern long bfd_elf32_slurp_symbol_table
   2028   (bfd *, asymbol **, bfd_boolean);
   2029 extern bfd_boolean bfd_elf32_write_shdrs_and_ehdr
   2030   (bfd *);
   2031 extern int bfd_elf32_write_out_phdrs
   2032   (bfd *, const Elf_Internal_Phdr *, unsigned int);
   2033 extern bfd_boolean bfd_elf32_checksum_contents
   2034   (bfd * , void (*) (const void *, size_t, void *), void *);
   2035 extern void bfd_elf32_write_relocs
   2036   (bfd *, asection *, void *);
   2037 extern bfd_boolean bfd_elf32_slurp_reloc_table
   2038   (bfd *, asection *, asymbol **, bfd_boolean);
   2039 
   2040 extern const bfd_target *bfd_elf64_object_p
   2041   (bfd *);
   2042 extern const bfd_target *bfd_elf64_core_file_p
   2043   (bfd *);
   2044 extern char *bfd_elf64_core_file_failing_command
   2045   (bfd *);
   2046 extern int bfd_elf64_core_file_failing_signal
   2047   (bfd *);
   2048 extern bfd_boolean bfd_elf64_core_file_matches_executable_p
   2049   (bfd *, bfd *);
   2050 extern int bfd_elf64_core_file_pid
   2051   (bfd *);
   2052 
   2053 extern bfd_boolean bfd_elf64_swap_symbol_in
   2054   (bfd *, const void *, const void *, Elf_Internal_Sym *);
   2055 extern void bfd_elf64_swap_symbol_out
   2056   (bfd *, const Elf_Internal_Sym *, void *, void *);
   2057 extern void bfd_elf64_swap_reloc_in
   2058   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
   2059 extern void bfd_elf64_swap_reloc_out
   2060   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
   2061 extern void bfd_elf64_swap_reloca_in
   2062   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
   2063 extern void bfd_elf64_swap_reloca_out
   2064   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
   2065 extern void bfd_elf64_swap_phdr_in
   2066   (bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *);
   2067 extern void bfd_elf64_swap_phdr_out
   2068   (bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *);
   2069 extern void bfd_elf64_swap_dyn_in
   2070   (bfd *, const void *, Elf_Internal_Dyn *);
   2071 extern void bfd_elf64_swap_dyn_out
   2072   (bfd *, const Elf_Internal_Dyn *, void *);
   2073 extern long bfd_elf64_slurp_symbol_table
   2074   (bfd *, asymbol **, bfd_boolean);
   2075 extern bfd_boolean bfd_elf64_write_shdrs_and_ehdr
   2076   (bfd *);
   2077 extern int bfd_elf64_write_out_phdrs
   2078   (bfd *, const Elf_Internal_Phdr *, unsigned int);
   2079 extern bfd_boolean bfd_elf64_checksum_contents
   2080   (bfd * , void (*) (const void *, size_t, void *), void *);
   2081 extern void bfd_elf64_write_relocs
   2082   (bfd *, asection *, void *);
   2083 extern bfd_boolean bfd_elf64_slurp_reloc_table
   2084   (bfd *, asection *, asymbol **, bfd_boolean);
   2085 
   2086 extern bfd_boolean _bfd_elf_default_relocs_compatible
   2087   (const bfd_target *, const bfd_target *);
   2088 
   2089 extern bfd_boolean _bfd_elf_relocs_compatible
   2090   (const bfd_target *, const bfd_target *);
   2091 
   2092 extern struct elf_link_hash_entry *_bfd_elf_archive_symbol_lookup
   2093   (bfd *, struct bfd_link_info *, const char *);
   2094 extern bfd_boolean bfd_elf_link_add_symbols
   2095   (bfd *, struct bfd_link_info *);
   2096 extern bfd_boolean _bfd_elf_add_dynamic_entry
   2097   (struct bfd_link_info *, bfd_vma, bfd_vma);
   2098 
   2099 extern bfd_boolean bfd_elf_link_record_dynamic_symbol
   2100   (struct bfd_link_info *, struct elf_link_hash_entry *);
   2101 
   2102 extern int bfd_elf_link_record_local_dynamic_symbol
   2103   (struct bfd_link_info *, bfd *, long);
   2104 
   2105 extern bfd_boolean _bfd_elf_close_and_cleanup
   2106   (bfd *);
   2107 
   2108 extern bfd_boolean _bfd_elf_common_definition
   2109   (Elf_Internal_Sym *);
   2110 
   2111 extern unsigned int _bfd_elf_common_section_index
   2112   (asection *);
   2113 
   2114 extern asection *_bfd_elf_common_section
   2115   (asection *);
   2116 
   2117 extern void _bfd_dwarf2_cleanup_debug_info
   2118   (bfd *);
   2119 
   2120 extern bfd_vma _bfd_elf_default_got_elt_size
   2121 (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *, bfd *,
   2122  unsigned long);
   2123 
   2124 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
   2125   (bfd *, arelent *, struct bfd_symbol *, void *,
   2126    asection *, bfd *, char **);
   2127 
   2128 extern bfd_boolean bfd_elf_final_link
   2129   (bfd *, struct bfd_link_info *);
   2130 
   2131 extern void _bfd_elf_gc_keep
   2132   (struct bfd_link_info *info);
   2133 
   2134 extern bfd_boolean bfd_elf_gc_mark_dynamic_ref_symbol
   2135   (struct elf_link_hash_entry *h, void *inf);
   2136 
   2137 extern bfd_boolean bfd_elf_gc_sections
   2138   (bfd *, struct bfd_link_info *);
   2139 
   2140 extern bfd_boolean bfd_elf_gc_record_vtinherit
   2141   (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
   2142 
   2143 extern bfd_boolean bfd_elf_gc_record_vtentry
   2144   (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
   2145 
   2146 extern asection *_bfd_elf_gc_mark_hook
   2147   (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
   2148    struct elf_link_hash_entry *, Elf_Internal_Sym *);
   2149 
   2150 extern asection *_bfd_elf_gc_mark_rsec
   2151   (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn,
   2152    struct elf_reloc_cookie *);
   2153 
   2154 extern bfd_boolean _bfd_elf_gc_mark_reloc
   2155   (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn,
   2156    struct elf_reloc_cookie *);
   2157 
   2158 extern bfd_boolean _bfd_elf_gc_mark_fdes
   2159   (struct bfd_link_info *, asection *, asection *, elf_gc_mark_hook_fn,
   2160    struct elf_reloc_cookie *);
   2161 
   2162 extern bfd_boolean _bfd_elf_gc_mark
   2163   (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn);
   2164 
   2165 extern bfd_boolean bfd_elf_gc_common_finalize_got_offsets
   2166   (bfd *, struct bfd_link_info *);
   2167 
   2168 extern bfd_boolean bfd_elf_gc_common_final_link
   2169   (bfd *, struct bfd_link_info *);
   2170 
   2171 extern bfd_boolean bfd_elf_reloc_symbol_deleted_p
   2172   (bfd_vma, void *);
   2173 
   2174 extern struct elf_segment_map * _bfd_elf_make_dynamic_segment
   2175   (bfd *, asection *);
   2176 
   2177 extern bfd_boolean _bfd_elf_map_sections_to_segments
   2178   (bfd *, struct bfd_link_info *);
   2179 
   2180 extern bfd_boolean _bfd_elf_is_function_type (unsigned int);
   2181 
   2182 extern int bfd_elf_get_default_section_type (flagword);
   2183 
   2184 extern Elf_Internal_Phdr * _bfd_elf_find_segment_containing_section
   2185   (bfd * abfd, asection * section);
   2186 
   2187 /* Exported interface for writing elf corefile notes. */
   2188 extern char *elfcore_write_note
   2189   (bfd *, char *, int *, const char *, int, const void *, int);
   2190 extern char *elfcore_write_prpsinfo
   2191   (bfd *, char *, int *, const char *, const char *);
   2192 extern char *elfcore_write_prstatus
   2193   (bfd *, char *, int *, long, int, const void *);
   2194 extern char * elfcore_write_pstatus
   2195   (bfd *, char *, int *, long, int, const void *);
   2196 extern char *elfcore_write_prfpreg
   2197   (bfd *, char *, int *, const void *, int);
   2198 extern char *elfcore_write_prxfpreg
   2199   (bfd *, char *, int *, const void *, int);
   2200 extern char *elfcore_write_xstatereg
   2201   (bfd *, char *, int *, const void *, int);
   2202 extern char *elfcore_write_ppc_vmx
   2203   (bfd *, char *, int *, const void *, int);
   2204 extern char *elfcore_write_ppc_vsx
   2205   (bfd *, char *, int *, const void *, int);
   2206 extern char *elfcore_write_s390_timer
   2207   (bfd *, char *, int *, const void *, int);
   2208 extern char *elfcore_write_s390_todcmp
   2209   (bfd *, char *, int *, const void *, int);
   2210 extern char *elfcore_write_s390_todpreg
   2211   (bfd *, char *, int *, const void *, int);
   2212 extern char *elfcore_write_s390_ctrs
   2213   (bfd *, char *, int *, const void *, int);
   2214 extern char *elfcore_write_s390_prefix
   2215   (bfd *, char *, int *, const void *, int);
   2216 extern char *elfcore_write_lwpstatus
   2217   (bfd *, char *, int *, long, int, const void *);
   2218 extern char *elfcore_write_register_note
   2219   (bfd *, char *, int *, const char *, const void *, int);
   2220 
   2221 extern bfd *_bfd_elf32_bfd_from_remote_memory
   2222   (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
   2223    int (*target_read_memory) (bfd_vma, bfd_byte *, int));
   2224 extern bfd *_bfd_elf64_bfd_from_remote_memory
   2225   (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
   2226    int (*target_read_memory) (bfd_vma, bfd_byte *, int));
   2227 
   2228 extern bfd_vma bfd_elf_obj_attr_size (bfd *);
   2229 extern void bfd_elf_set_obj_attr_contents (bfd *, bfd_byte *, bfd_vma);
   2230 extern int bfd_elf_get_obj_attr_int (bfd *, int, int);
   2231 extern void bfd_elf_add_obj_attr_int (bfd *, int, int, unsigned int);
   2232 #define bfd_elf_add_proc_attr_int(BFD, TAG, VALUE) \
   2233   bfd_elf_add_obj_attr_int ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
   2234 extern void bfd_elf_add_obj_attr_string (bfd *, int, int, const char *);
   2235 #define bfd_elf_add_proc_attr_string(BFD, TAG, VALUE) \
   2236   bfd_elf_add_obj_attr_string ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
   2237 extern void bfd_elf_add_obj_attr_int_string (bfd *, int, int, unsigned int,
   2238 					     const char *);
   2239 #define bfd_elf_add_proc_attr_int_string(BFD, TAG, INTVAL, STRVAL) \
   2240   bfd_elf_add_obj_attr_int_string ((BFD), OBJ_ATTR_PROC, (TAG), \
   2241 				   (INTVAL), (STRVAL))
   2242 
   2243 extern char *_bfd_elf_attr_strdup (bfd *, const char *);
   2244 extern void _bfd_elf_copy_obj_attributes (bfd *, bfd *);
   2245 extern int _bfd_elf_obj_attrs_arg_type (bfd *, int, int);
   2246 extern void _bfd_elf_parse_attributes (bfd *, Elf_Internal_Shdr *);
   2247 extern bfd_boolean _bfd_elf_merge_object_attributes (bfd *, bfd *);
   2248 extern bfd_boolean _bfd_elf_merge_unknown_attribute_low (bfd *, bfd *, int);
   2249 extern bfd_boolean _bfd_elf_merge_unknown_attribute_list (bfd *, bfd *);
   2250 extern Elf_Internal_Shdr *_bfd_elf_single_rel_hdr (asection *sec);
   2251 
   2252 /* The linker may needs to keep track of the number of relocs that it
   2253    decides to copy as dynamic relocs in check_relocs for each symbol.
   2254    This is so that it can later discard them if they are found to be
   2255    unnecessary.  We can store the information in a field extending the
   2256    regular ELF linker hash table.  */
   2257 
   2258 struct elf_dyn_relocs
   2259 {
   2260   struct elf_dyn_relocs *next;
   2261 
   2262   /* The input section of the reloc.  */
   2263   asection *sec;
   2264 
   2265   /* Total number of relocs copied for the input section.  */
   2266   bfd_size_type count;
   2267 
   2268   /* Number of pc-relative relocs copied for the input section.  */
   2269   bfd_size_type pc_count;
   2270 };
   2271 
   2272 extern bfd_boolean _bfd_elf_create_ifunc_sections
   2273   (bfd *, struct bfd_link_info *);
   2274 extern asection * _bfd_elf_create_ifunc_dyn_reloc
   2275   (bfd *, struct bfd_link_info *, asection *sec, asection *sreloc,
   2276    struct elf_dyn_relocs **);
   2277 extern bfd_boolean _bfd_elf_allocate_ifunc_dyn_relocs
   2278   (struct bfd_link_info *, struct elf_link_hash_entry *,
   2279    struct elf_dyn_relocs **, unsigned int, unsigned int);
   2280 
   2281 extern void elf_append_rela (bfd *, asection *, Elf_Internal_Rela *);
   2282 extern void elf_append_rel (bfd *, asection *, Elf_Internal_Rela *);
   2283 
   2284 extern bfd_vma elf64_r_info (bfd_vma, bfd_vma);
   2285 extern bfd_vma elf64_r_sym (bfd_vma);
   2286 extern bfd_vma elf32_r_info (bfd_vma, bfd_vma);
   2287 extern bfd_vma elf32_r_sym (bfd_vma);
   2288 
   2289 /* Large common section.  */
   2290 extern asection _bfd_elf_large_com_section;
   2291 
   2292 /* Hash for local symbol with the first section id, ID, in the input
   2293    file and the local symbol index, SYM.  */
   2294 #define ELF_LOCAL_SYMBOL_HASH(ID, SYM) \
   2295   (((((ID) & 0xff) << 24) | (((ID) & 0xff00) << 8)) \
   2296    ^ (SYM) ^ ((ID) >> 16))
   2297 
   2298 /* This is the condition under which finish_dynamic_symbol will be called.
   2299    If our finish_dynamic_symbol isn't called, we'll need to do something
   2300    about initializing any .plt and .got entries in relocate_section.  */
   2301 #define WILL_CALL_FINISH_DYNAMIC_SYMBOL(DYN, SHARED, H) \
   2302   ((DYN)								\
   2303    && ((SHARED) || !(H)->forced_local)					\
   2304    && ((H)->dynindx != -1 || (H)->forced_local))
   2305 
   2306 /* This macro is to avoid lots of duplicated code in the body
   2307    of xxx_relocate_section() in the various elfxx-xxxx.c files.  */
   2308 #define RELOC_FOR_GLOBAL_SYMBOL(info, input_bfd, input_section, rel,	\
   2309 				r_symndx, symtab_hdr, sym_hashes,	\
   2310 				h, sec, relocation,			\
   2311 				unresolved_reloc, warned)		\
   2312   do									\
   2313     {									\
   2314       /* It seems this can happen with erroneous or unsupported		\
   2315 	 input (mixing a.out and elf in an archive, for example.)  */	\
   2316       if (sym_hashes == NULL)						\
   2317 	return FALSE;							\
   2318 									\
   2319       h = sym_hashes[r_symndx - symtab_hdr->sh_info];			\
   2320 									\
   2321       while (h->root.type == bfd_link_hash_indirect			\
   2322 	     || h->root.type == bfd_link_hash_warning)			\
   2323 	h = (struct elf_link_hash_entry *) h->root.u.i.link;		\
   2324 									\
   2325       warned = FALSE;							\
   2326       unresolved_reloc = FALSE;						\
   2327       relocation = 0;							\
   2328       if (h->root.type == bfd_link_hash_defined				\
   2329 	  || h->root.type == bfd_link_hash_defweak)			\
   2330 	{								\
   2331 	  sec = h->root.u.def.section;					\
   2332 	  if (sec == NULL						\
   2333 	      || sec->output_section == NULL)				\
   2334 	    /* Set a flag that will be cleared later if we find a	\
   2335 	       relocation value for this symbol.  output_section	\
   2336 	       is typically NULL for symbols satisfied by a shared	\
   2337 	       library.  */						\
   2338 	    unresolved_reloc = TRUE;					\
   2339 	  else								\
   2340 	    relocation = (h->root.u.def.value				\
   2341 			  + sec->output_section->vma			\
   2342 			  + sec->output_offset);			\
   2343 	}								\
   2344       else if (h->root.type == bfd_link_hash_undefweak)			\
   2345 	;								\
   2346       else if (info->unresolved_syms_in_objects == RM_IGNORE		\
   2347 	       && ELF_ST_VISIBILITY (h->other) == STV_DEFAULT)		\
   2348 	;								\
   2349       else if (!info->relocatable)					\
   2350 	{								\
   2351 	  bfd_boolean err;						\
   2352 	  err = (info->unresolved_syms_in_objects == RM_GENERATE_ERROR	\
   2353 		 || ELF_ST_VISIBILITY (h->other) != STV_DEFAULT);	\
   2354 	  if (!info->callbacks->undefined_symbol (info,			\
   2355 						  h->root.root.string,	\
   2356 						  input_bfd,		\
   2357 						  input_section,	\
   2358 						  rel->r_offset, err))	\
   2359 	    return FALSE;						\
   2360 	  warned = TRUE;						\
   2361 	}								\
   2362       (void) unresolved_reloc;						\
   2363       (void) warned;							\
   2364     }									\
   2365   while (0)
   2366 
   2367 /* This macro is to avoid lots of duplicated code in the body of the
   2368    loop over relocations in xxx_relocate_section() in the various
   2369    elfxx-xxxx.c files.
   2370 
   2371    Handle relocations against symbols from removed linkonce sections,
   2372    or sections discarded by a linker script.  When doing a relocatable
   2373    link, we remove such relocations.  Otherwise, we just want the
   2374    section contents zeroed and avoid any special processing.  */
   2375 #define RELOC_AGAINST_DISCARDED_SECTION(info, input_bfd, input_section,	\
   2376 					rel, relend, howto, contents)	\
   2377   {									\
   2378     _bfd_clear_contents (howto, input_bfd, input_section,		\
   2379 			 contents + rel->r_offset);			\
   2380 									\
   2381     if (info->relocatable						\
   2382 	&& (input_section->flags & SEC_DEBUGGING))			\
   2383       {									\
   2384 	/* Only remove relocations in debug sections since other	\
   2385 	   sections may require relocations.  */			\
   2386 	Elf_Internal_Shdr *rel_hdr;					\
   2387 									\
   2388 	rel_hdr = _bfd_elf_single_rel_hdr (input_section->output_section); \
   2389 									\
   2390 	/* Avoid empty output section.  */				\
   2391 	if (rel_hdr->sh_size > rel_hdr->sh_entsize)			\
   2392 	  {								\
   2393 	    rel_hdr->sh_size -= rel_hdr->sh_entsize;			\
   2394 	    rel_hdr = _bfd_elf_single_rel_hdr (input_section);		\
   2395 	    rel_hdr->sh_size -= rel_hdr->sh_entsize;			\
   2396 									\
   2397 	    memmove (rel, rel + 1, (relend - rel) * sizeof (*rel));	\
   2398 									\
   2399 	    input_section->reloc_count--;				\
   2400 	    relend--;							\
   2401 	    rel--;							\
   2402 	    continue;							\
   2403 	  }								\
   2404       }									\
   2405 									\
   2406     rel->r_info = 0;							\
   2407     rel->r_addend = 0;							\
   2408     continue;								\
   2409   }
   2410 
   2411 /* Will a symbol be bound to the the definition within the shared
   2412    library, if any.  A unique symbol can never be bound locally.  */
   2413 #define SYMBOLIC_BIND(INFO, H) \
   2414     (!(H)->unique_global \
   2415      && ((INFO)->symbolic || ((INFO)->dynamic && !(H)->dynamic)))
   2416 
   2417 #endif /* _LIBELF_H_ */
   2418