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