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