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