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