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