* elf64-sparc.c (sparc64_elf_relocate_section): Ignore overflows
[platform/upstream/binutils.git] / bfd / elf-bfd.h
1 /* BFD back-end data structures for ELF files.
2    Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
3    2002, 2003, 2004 Free Software Foundation, Inc.
4    Written by Cygnus Support.
5
6    This file is part of BFD, the Binary File Descriptor library.
7
8    This program is free software; you can redistribute it and/or modify
9    it under the terms of the GNU General Public License as published by
10    the Free Software Foundation; either version 2 of the License, or
11    (at your option) any later version.
12
13    This program is distributed in the hope that it will be useful,
14    but WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16    GNU General Public License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program; if not, write to the Free Software
20    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
21
22 #ifndef _LIBELF_H_
23 #define _LIBELF_H_ 1
24
25 #include "elf/common.h"
26 #include "elf/internal.h"
27 #include "elf/external.h"
28 #include "bfdlink.h"
29
30 /* The number of entries in a section is its size divided by the size
31    of a single entry.  This is normally only applicable to reloc and
32    symbol table sections.  */
33 #define NUM_SHDR_ENTRIES(shdr) ((shdr)->sh_size / (shdr)->sh_entsize)
34
35 /* If size isn't specified as 64 or 32, NAME macro should fail.  */
36 #ifndef NAME
37 #if ARCH_SIZE == 64
38 #define NAME(x, y) x ## 64 ## _ ## y
39 #endif
40 #if ARCH_SIZE == 32
41 #define NAME(x, y) x ## 32 ## _ ## y
42 #endif
43 #endif
44
45 #ifndef NAME
46 #define NAME(x, y) x ## NOSIZE ## _ ## y
47 #endif
48
49 #define ElfNAME(X)      NAME(Elf,X)
50 #define elfNAME(X)      NAME(elf,X)
51
52 /* Information held for an ELF symbol.  The first field is the
53    corresponding asymbol.  Every symbol is an ELF file is actually a
54    pointer to this structure, although it is often handled as a
55    pointer to an asymbol.  */
56
57 typedef struct
58 {
59   /* The BFD symbol.  */
60   asymbol symbol;
61   /* ELF symbol information.  */
62   Elf_Internal_Sym internal_elf_sym;
63   /* Backend specific information.  */
64   union
65     {
66       unsigned int hppa_arg_reloc;
67       void *mips_extr;
68       void *any;
69     }
70   tc_data;
71
72   /* Version information.  This is from an Elf_Internal_Versym
73      structure in a SHT_GNU_versym section.  It is zero if there is no
74      version information.  */
75   unsigned short version;
76
77 } elf_symbol_type;
78 \f
79 struct elf_strtab_hash;
80 struct got_entry;
81 struct plt_entry;
82
83 /* ELF linker hash table entries.  */
84
85 struct elf_link_hash_entry
86 {
87   struct bfd_link_hash_entry root;
88
89   /* Symbol index in output file.  This is initialized to -1.  It is
90      set to -2 if the symbol is used by a reloc.  */
91   long indx;
92
93   /* Symbol index as a dynamic symbol.  Initialized to -1, and remains
94      -1 if this is not a dynamic symbol.  */
95   /* ??? Note that this is consistently used as a synonym for tests
96      against whether we can perform various simplifying transformations
97      to the code.  (E.g. changing a pc-relative jump to a PLT entry
98      into a pc-relative jump to the target function.)  That test, which
99      is often relatively complex, and someplaces wrong or incomplete,
100      should really be replaced by a predicate in elflink.c.
101
102      End result: this field -1 does not indicate that the symbol is
103      not in the dynamic symbol table, but rather that the symbol is
104      not visible outside this DSO.  */
105   long dynindx;
106
107   /* If this symbol requires an entry in the global offset table, the
108      processor specific backend uses this field to track usage and
109      final offset.  Two schemes are supported:  The first assumes that
110      a symbol may only have one GOT entry, and uses REFCOUNT until
111      size_dynamic_sections, at which point the contents of the .got is
112      fixed.  Afterward, if OFFSET is -1, then the symbol does not
113      require a global offset table entry.  The second scheme allows
114      multiple GOT entries per symbol, managed via a linked list
115      pointed to by GLIST.  */
116   union gotplt_union
117     {
118       bfd_signed_vma refcount;
119       bfd_vma offset;
120       struct got_entry *glist;
121       struct plt_entry *plist;
122     } got;
123
124   /* Same, but tracks a procedure linkage table entry.  */
125   union gotplt_union plt;
126
127   /* Symbol size.  */
128   bfd_size_type size;
129
130   /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.).  */
131   unsigned int type : 8;
132
133   /* Symbol st_other value, symbol visibility.  */
134   unsigned int other : 8;
135
136   /* Symbol is referenced by a non-shared object.  */
137   unsigned int ref_regular : 1;
138   /* Symbol is defined by a non-shared object.  */
139   unsigned int def_regular : 1;
140   /* Symbol is referenced by a shared object.  */
141   unsigned int ref_dynamic : 1;
142   /* Symbol is defined by a shared object.  */
143   unsigned int def_dynamic : 1;
144   /* Symbol has a non-weak reference from a non-shared object.  */
145   unsigned int ref_regular_nonweak : 1;
146   /* Dynamic symbol has been adjustd.  */
147   unsigned int dynamic_adjusted : 1;
148   /* Symbol needs a copy reloc.  */
149   unsigned int needs_copy : 1;
150   /* Symbol needs a procedure linkage table entry.  */
151   unsigned int needs_plt : 1;
152   /* Symbol appears in a non-ELF input file.  */
153   unsigned int non_elf : 1;
154   /* Symbol should be marked as hidden in the version information.  */
155   unsigned int hidden : 1;
156   /* Symbol was forced to local scope due to a version script file.  */
157   unsigned int forced_local : 1;
158   /* Symbol was marked during garbage collection.  */
159   unsigned int mark : 1;
160   /* Symbol is referenced by a non-GOT/non-PLT relocation.  This is
161      not currently set by all the backends.  */
162   unsigned int non_got_ref : 1;
163   /* Symbol has a definition in a shared object.
164      FIXME: There is no real need for this field if def_dynamic is never
165      cleared and all places that test def_dynamic also test def_regular.  */
166   unsigned int dynamic_def : 1;
167   /* Symbol is weak in all shared objects.  */
168   unsigned int dynamic_weak : 1;
169   /* Symbol is referenced with a relocation where C/C++ pointer equality
170      matters.  */
171   unsigned int pointer_equality_needed : 1;
172
173   /* String table index in .dynstr if this is a dynamic symbol.  */
174   unsigned long dynstr_index;
175
176   union
177   {
178     /* If this is a weak defined symbol from a dynamic object, this
179        field points to a defined symbol with the same value, if there is
180        one.  Otherwise it is NULL.  */
181     struct elf_link_hash_entry *weakdef;
182
183     /* Hash value of the name computed using the ELF hash function.
184        Used part way through size_dynamic_sections, after we've finished
185        with weakdefs.  */
186     unsigned long elf_hash_value;
187   } u;
188
189   /* Version information.  */
190   union
191   {
192     /* This field is used for a symbol which is not defined in a
193        regular object.  It points to the version information read in
194        from the dynamic object.  */
195     Elf_Internal_Verdef *verdef;
196     /* This field is used for a symbol which is defined in a regular
197        object.  It is set up in size_dynamic_sections.  It points to
198        the version information we should write out for this symbol.  */
199     struct bfd_elf_version_tree *vertree;
200   } verinfo;
201
202   struct
203   {
204     /* Virtual table entry use information.  This array is nominally of size
205        size/sizeof(target_void_pointer), though we have to be able to assume
206        and track a size while the symbol is still undefined.  It is indexed
207        via offset/sizeof(target_void_pointer).  */
208     size_t size;
209     bfd_boolean *used;
210
211     /* Virtual table derivation info.  */
212     struct elf_link_hash_entry *parent;
213   } *vtable;
214 };
215
216 /* Will references to this symbol always reference the symbol
217    in this object?  STV_PROTECTED is excluded from the visibility test
218    here so that function pointer comparisons work properly.  Since
219    function symbols not defined in an app are set to their .plt entry,
220    it's necessary for shared libs to also reference the .plt even
221    though the symbol is really local to the shared lib.  */
222 #define SYMBOL_REFERENCES_LOCAL(INFO, H) \
223   _bfd_elf_symbol_refs_local_p (H, INFO, 0)
224
225 /* Will _calls_ to this symbol always call the version in this object?  */
226 #define SYMBOL_CALLS_LOCAL(INFO, H) \
227   _bfd_elf_symbol_refs_local_p (H, INFO, 1)
228
229 /* Common symbols that are turned into definitions don't have the
230    DEF_REGULAR flag set, so they might appear to be undefined.  */
231 #define ELF_COMMON_DEF_P(H) \
232   (!(H)->def_regular                                                    \
233    && !(H)->def_dynamic                                                 \
234    && (H)->root.type == bfd_link_hash_defined)
235
236 /* Records local symbols to be emitted in the dynamic symbol table.  */
237
238 struct elf_link_local_dynamic_entry
239 {
240   struct elf_link_local_dynamic_entry *next;
241
242   /* The input bfd this symbol came from.  */
243   bfd *input_bfd;
244
245   /* The index of the local symbol being copied.  */
246   long input_indx;
247
248   /* The index in the outgoing dynamic symbol table.  */
249   long dynindx;
250
251   /* A copy of the input symbol.  */
252   Elf_Internal_Sym isym;
253 };
254
255 struct elf_link_loaded_list
256 {
257   struct elf_link_loaded_list *next;
258   bfd *abfd;
259 };
260
261 /* Structures used by the eh_frame optimization code.  */
262 struct cie_header
263 {
264   unsigned int length;
265   unsigned int id;
266 };
267
268 struct cie
269 {
270   struct cie_header hdr;
271   unsigned char version;
272   unsigned char augmentation[20];
273   unsigned int code_align;
274   int data_align;
275   unsigned int ra_column;
276   unsigned int augmentation_size;
277   struct elf_link_hash_entry *personality;
278   unsigned char per_encoding;
279   unsigned char lsda_encoding;
280   unsigned char fde_encoding;
281   unsigned char initial_insn_length;
282   unsigned char make_relative;
283   unsigned char make_lsda_relative;
284   unsigned char initial_instructions[50];
285 };
286
287 struct eh_cie_fde
288 {
289   /* For FDEs, this points to the CIE used.  */
290   struct eh_cie_fde *cie_inf;
291   unsigned int size;
292   unsigned int offset;
293   unsigned int new_offset;
294   unsigned char fde_encoding;
295   unsigned char lsda_encoding;
296   unsigned char lsda_offset;
297   unsigned int cie : 1;
298   unsigned int removed : 1;
299   unsigned int add_augmentation_size : 1;
300   unsigned int add_fde_encoding : 1;
301   unsigned int make_relative : 1;
302   unsigned int make_lsda_relative : 1;
303   unsigned int need_lsda_relative : 1;
304   unsigned int per_encoding_relative : 1;
305 };
306
307 struct eh_frame_sec_info
308 {
309   unsigned int count;
310   unsigned int alloced;
311   struct eh_cie_fde entry[1];
312 };
313
314 struct eh_frame_array_ent
315 {
316   bfd_vma initial_loc;
317   bfd_vma fde;
318 };
319
320 struct eh_frame_hdr_info
321 {
322   struct cie last_cie;
323   asection *last_cie_sec;
324   struct eh_cie_fde *last_cie_inf;
325   asection *hdr_sec;
326   unsigned int fde_count, array_count;
327   struct eh_frame_array_ent *array;
328   /* TRUE if .eh_frame_hdr should contain the sorted search table.
329      We build it if we successfully read all .eh_frame input sections
330      and recognize them.  */
331   bfd_boolean table;
332   bfd_boolean offsets_adjusted;
333 };
334
335 /* ELF linker hash table.  */
336
337 struct elf_link_hash_table
338 {
339   struct bfd_link_hash_table root;
340
341   /* Whether we have created the special dynamic sections required
342      when linking against or generating a shared object.  */
343   bfd_boolean dynamic_sections_created;
344
345   /* The BFD used to hold special sections created by the linker.
346      This will be the first BFD found which requires these sections to
347      be created.  */
348   bfd *dynobj;
349
350   /* The value to use when initialising got.refcount/offset and
351      plt.refcount/offset in an elf_link_hash_entry.  Set to zero when
352      the values are refcounts.  Set to init_offset in
353      size_dynamic_sections when the values may be offsets.  */
354   union gotplt_union init_refcount;
355
356   /* The value to use for got.refcount/offset and plt.refcount/offset
357      when the values may be offsets.  Normally (bfd_vma) -1.  */
358   union gotplt_union init_offset;
359
360   /* The number of symbols found in the link which must be put into
361      the .dynsym section.  */
362   bfd_size_type dynsymcount;
363
364   /* The string table of dynamic symbols, which becomes the .dynstr
365      section.  */
366   struct elf_strtab_hash *dynstr;
367
368   /* The number of buckets in the hash table in the .hash section.
369      This is based on the number of dynamic symbols.  */
370   bfd_size_type bucketcount;
371
372   /* A linked list of DT_NEEDED names found in dynamic objects
373      included in the link.  */
374   struct bfd_link_needed_list *needed;
375
376   /* The _GLOBAL_OFFSET_TABLE_ symbol.  */
377   struct elf_link_hash_entry *hgot;
378
379   /* A pointer to information used to merge SEC_MERGE sections.  */
380   void *merge_info;
381
382   /* Used to link stabs in sections.  */
383   struct stab_info stab_info;
384
385   /* Used by eh_frame code when editing .eh_frame.  */
386   struct eh_frame_hdr_info eh_info;
387
388   /* A linked list of local symbols to be added to .dynsym.  */
389   struct elf_link_local_dynamic_entry *dynlocal;
390
391   /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic
392      objects included in the link.  */
393   struct bfd_link_needed_list *runpath;
394
395   /* Cached first output tls section and size of PT_TLS segment.  */
396   asection *tls_sec;
397   bfd_size_type tls_size;
398
399   /* A linked list of BFD's loaded in the link.  */
400   struct elf_link_loaded_list *loaded;
401 };
402
403 /* Look up an entry in an ELF linker hash table.  */
404
405 #define elf_link_hash_lookup(table, string, create, copy, follow)       \
406   ((struct elf_link_hash_entry *)                                       \
407    bfd_link_hash_lookup (&(table)->root, (string), (create),            \
408                          (copy), (follow)))
409
410 /* Traverse an ELF linker hash table.  */
411
412 #define elf_link_hash_traverse(table, func, info)                       \
413   (bfd_link_hash_traverse                                               \
414    (&(table)->root,                                                     \
415     (bfd_boolean (*) (struct bfd_link_hash_entry *, void *)) (func),    \
416     (info)))
417
418 /* Get the ELF linker hash table from a link_info structure.  */
419
420 #define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash))
421
422 /* Returns TRUE if the hash table is a struct elf_link_hash_table.  */
423 #define is_elf_hash_table(htab)                                         \
424   (((struct bfd_link_hash_table *) (htab))->type == bfd_link_elf_hash_table)
425
426 /* Used by bfd_section_from_r_symndx to cache a small number of local
427    symbol to section mappings.  */
428 #define LOCAL_SYM_CACHE_SIZE 32
429 struct sym_sec_cache
430 {
431   bfd *abfd;
432   unsigned long indx[LOCAL_SYM_CACHE_SIZE];
433   asection *sec[LOCAL_SYM_CACHE_SIZE];
434 };
435 \f
436 /* Constant information held for an ELF backend.  */
437
438 struct elf_size_info {
439   unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
440   unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
441
442   /* The size of entries in the .hash section.  */
443   unsigned char sizeof_hash_entry;
444
445   /* The number of internal relocations to allocate per external
446      relocation entry.  */
447   unsigned char int_rels_per_ext_rel;
448   /* We use some fixed size arrays.  This should be large enough to
449      handle all back-ends.  */
450 #define MAX_INT_RELS_PER_EXT_REL 3
451
452   unsigned char arch_size, log_file_align;
453   unsigned char elfclass, ev_current;
454   int (*write_out_phdrs)
455     (bfd *, const Elf_Internal_Phdr *, unsigned int);
456   bfd_boolean
457     (*write_shdrs_and_ehdr) (bfd *);
458   void (*write_relocs)
459     (bfd *, asection *, void *);
460   void (*swap_symbol_in)
461     (bfd *, const void *, const void *, Elf_Internal_Sym *);
462   void (*swap_symbol_out)
463     (bfd *, const Elf_Internal_Sym *, void *, void *);
464   bfd_boolean (*slurp_reloc_table)
465     (bfd *, asection *, asymbol **, bfd_boolean);
466   long (*slurp_symbol_table)
467     (bfd *, asymbol **, bfd_boolean);
468   void (*swap_dyn_in)
469     (bfd *, const void *, Elf_Internal_Dyn *);
470   void (*swap_dyn_out)
471     (bfd *, const Elf_Internal_Dyn *, void *);
472
473   /* This function is called to swap in a REL relocation.  If an
474      external relocation corresponds to more than one internal
475      relocation, then all relocations are swapped in at once.  */
476   void (*swap_reloc_in)
477     (bfd *, const bfd_byte *, Elf_Internal_Rela *);
478
479   /* This function is called to swap out a REL relocation.  */
480   void (*swap_reloc_out)
481     (bfd *, const Elf_Internal_Rela *, bfd_byte *);
482
483   /* This function is called to swap in a RELA relocation.  If an
484      external relocation corresponds to more than one internal
485      relocation, then all relocations are swapped in at once.  */
486   void (*swap_reloca_in)
487     (bfd *, const bfd_byte *, Elf_Internal_Rela *);
488
489   /* This function is called to swap out a RELA relocation.  */
490   void (*swap_reloca_out)
491     (bfd *, const Elf_Internal_Rela *, bfd_byte *);
492 };
493
494 #define elf_symbol_from(ABFD,S) \
495         (((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
496           && (S)->the_bfd->tdata.elf_obj_data != 0) \
497          ? (elf_symbol_type *) (S) \
498          : 0)
499
500 enum elf_reloc_type_class {
501   reloc_class_normal,
502   reloc_class_relative,
503   reloc_class_plt,
504   reloc_class_copy
505 };
506
507 struct elf_reloc_cookie
508 {
509   Elf_Internal_Rela *rels, *rel, *relend;
510   Elf_Internal_Sym *locsyms;
511   bfd *abfd;
512   size_t locsymcount;
513   size_t extsymoff;
514   struct elf_link_hash_entry **sym_hashes;
515   int r_sym_shift;
516   bfd_boolean bad_symtab;
517 };
518
519 /* The level of IRIX compatibility we're striving for.  */
520
521 typedef enum {
522   ict_none,
523   ict_irix5,
524   ict_irix6
525 } irix_compat_t;
526
527 /* Mapping of ELF section names and types.  */
528 struct bfd_elf_special_section
529 {
530   const char *prefix;
531   int prefix_length;
532   /* 0 means name must match PREFIX exactly.
533      -1 means name must start with PREFIX followed by an arbitrary string.
534      -2 means name must match PREFIX exactly or consist of PREFIX followed
535      by a dot then anything.
536      > 0 means name must start with the first PREFIX_LENGTH chars of
537      PREFIX and finish with the last SUFFIX_LENGTH chars of PREFIX.  */
538   int suffix_length;
539   int type;
540   int attr;
541 };
542
543 struct elf_backend_data
544 {
545   /* The architecture for this backend.  */
546   enum bfd_architecture arch;
547
548   /* The ELF machine code (EM_xxxx) for this backend.  */
549   int elf_machine_code;
550
551   /* The maximum page size for this backend.  */
552   bfd_vma maxpagesize;
553
554   /* The BFD flags applied to sections created for dynamic linking.  */
555   flagword dynamic_sec_flags;
556
557   /* A function to translate an ELF RELA relocation to a BFD arelent
558      structure.  */
559   void (*elf_info_to_howto)
560     (bfd *, arelent *, Elf_Internal_Rela *);
561
562   /* A function to translate an ELF REL relocation to a BFD arelent
563      structure.  */
564   void (*elf_info_to_howto_rel)
565     (bfd *, arelent *, Elf_Internal_Rela *);
566
567   /* A function to determine whether a symbol is global when
568      partitioning the symbol table into local and global symbols.
569      This should be NULL for most targets, in which case the correct
570      thing will be done.  MIPS ELF, at least on the Irix 5, has
571      special requirements.  */
572   bfd_boolean (*elf_backend_sym_is_global)
573     (bfd *, asymbol *);
574
575   /* The remaining functions are hooks which are called only if they
576      are not NULL.  */
577
578   /* A function to permit a backend specific check on whether a
579      particular BFD format is relevant for an object file, and to
580      permit the backend to set any global information it wishes.  When
581      this is called elf_elfheader is set, but anything else should be
582      used with caution.  If this returns FALSE, the check_format
583      routine will return a bfd_error_wrong_format error.  */
584   bfd_boolean (*elf_backend_object_p)
585     (bfd *);
586
587   /* A function to do additional symbol processing when reading the
588      ELF symbol table.  This is where any processor-specific special
589      section indices are handled.  */
590   void (*elf_backend_symbol_processing)
591     (bfd *, asymbol *);
592
593   /* A function to do additional symbol processing after reading the
594      entire ELF symbol table.  */
595   bfd_boolean (*elf_backend_symbol_table_processing)
596     (bfd *, elf_symbol_type *, unsigned int);
597
598   /* A function to set the type of the info field.  Processor-specific
599      types should be handled here.  */
600   int (*elf_backend_get_symbol_type)
601     (Elf_Internal_Sym *, int);
602
603   /* A function to return the linker hash table entry of a symbol that
604      might be satisfied by an archive symbol.  */
605   struct elf_link_hash_entry * (*elf_backend_archive_symbol_lookup)
606     (bfd *, struct bfd_link_info *, const char *);
607
608   /* Return true if local section symbols should have a non-null st_name.
609      NULL implies false.  */
610   bfd_boolean (*elf_backend_name_local_section_symbols)
611     (bfd *);
612
613   /* A function to do additional processing on the ELF section header
614      just before writing it out.  This is used to set the flags and
615      type fields for some sections, or to actually write out data for
616      unusual sections.  */
617   bfd_boolean (*elf_backend_section_processing)
618     (bfd *, Elf_Internal_Shdr *);
619
620   /* A function to handle unusual section types when creating BFD
621      sections from ELF sections.  */
622   bfd_boolean (*elf_backend_section_from_shdr)
623     (bfd *, Elf_Internal_Shdr *, const char *);
624
625   /* A function to convert machine dependent section header flags to
626      BFD internal section header flags.  */
627   bfd_boolean (*elf_backend_section_flags)
628     (flagword *, const Elf_Internal_Shdr *);
629
630   /* A function to handle unusual program segment types when creating BFD
631      sections from ELF program segments.  */
632   bfd_boolean (*elf_backend_section_from_phdr)
633     (bfd *, Elf_Internal_Phdr *, int);
634
635   /* A function to set up the ELF section header for a BFD section in
636      preparation for writing it out.  This is where the flags and type
637      fields are set for unusual sections.  */
638   bfd_boolean (*elf_backend_fake_sections)
639     (bfd *, Elf_Internal_Shdr *, asection *);
640
641   /* A function to get the ELF section index for a BFD section.  If
642      this returns TRUE, the section was found.  If it is a normal ELF
643      section, *RETVAL should be left unchanged.  If it is not a normal
644      ELF section *RETVAL should be set to the SHN_xxxx index.  */
645   bfd_boolean (*elf_backend_section_from_bfd_section)
646     (bfd *, asection *, int *retval);
647
648   /* If this field is not NULL, it is called by the add_symbols phase
649      of a link just before adding a symbol to the global linker hash
650      table.  It may modify any of the fields as it wishes.  If *NAME
651      is set to NULL, the symbol will be skipped rather than being
652      added to the hash table.  This function is responsible for
653      handling all processor dependent symbol bindings and section
654      indices, and must set at least *FLAGS and *SEC for each processor
655      dependent case; failure to do so will cause a link error.  */
656   bfd_boolean (*elf_add_symbol_hook)
657     (bfd *abfd, struct bfd_link_info *info, Elf_Internal_Sym *,
658      const char **name, flagword *flags, asection **sec, bfd_vma *value);
659
660   /* If this field is not NULL, it is called by the elf_link_output_sym
661      phase of a link for each symbol which will appear in the object file.  */
662   bfd_boolean (*elf_backend_link_output_symbol_hook)
663     (struct bfd_link_info *info, const char *, Elf_Internal_Sym *,
664      asection *, struct elf_link_hash_entry *);
665
666   /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
667      linker the first time it encounters a dynamic object in the link.
668      This function must create any sections required for dynamic
669      linking.  The ABFD argument is a dynamic object.  The .interp,
670      .dynamic, .dynsym, .dynstr, and .hash functions have already been
671      created, and this function may modify the section flags if
672      desired.  This function will normally create the .got and .plt
673      sections, but different backends have different requirements.  */
674   bfd_boolean (*elf_backend_create_dynamic_sections)
675     (bfd *abfd, struct bfd_link_info *info);
676
677   /* When creating a shared library, determine whether to omit the
678      dynamic symbol for the section.  */
679   bfd_boolean (*elf_backend_omit_section_dynsym)
680     (bfd *output_bfd, struct bfd_link_info *info, asection *osec);
681
682   /* The CHECK_RELOCS function is called by the add_symbols phase of
683      the ELF backend linker.  It is called once for each section with
684      relocs of an object file, just after the symbols for the object
685      file have been added to the global linker hash table.  The
686      function must look through the relocs and do any special handling
687      required.  This generally means allocating space in the global
688      offset table, and perhaps allocating space for a reloc.  The
689      relocs are always passed as Rela structures; if the section
690      actually uses Rel structures, the r_addend field will always be
691      zero.  */
692   bfd_boolean (*check_relocs)
693     (bfd *abfd, struct bfd_link_info *info, asection *o,
694      const Elf_Internal_Rela *relocs);
695
696   /* The CHECK_DIRECTIVES function is called once per input file by
697      the add_symbols phase of the ELF backend linker.  The function
698      must inspect the bfd and create any additional symbols according
699      to any custom directives in the bfd.  */
700   bfd_boolean (*check_directives)
701     (bfd *abfd, struct bfd_link_info *info);
702
703   /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
704      linker for every symbol which is defined by a dynamic object and
705      referenced by a regular object.  This is called after all the
706      input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
707      function has been called.  The hash table entry should be
708      bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
709      defined in a section from a dynamic object.  Dynamic object
710      sections are not included in the final link, and this function is
711      responsible for changing the value to something which the rest of
712      the link can deal with.  This will normally involve adding an
713      entry to the .plt or .got or some such section, and setting the
714      symbol to point to that.  */
715   bfd_boolean (*elf_backend_adjust_dynamic_symbol)
716     (struct bfd_link_info *info, struct elf_link_hash_entry *h);
717
718   /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
719      after all the linker input files have been seen but before the
720      section sizes have been set.  This is called after
721      ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS.  */
722   bfd_boolean (*elf_backend_always_size_sections)
723     (bfd *output_bfd, struct bfd_link_info *info);
724
725   /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
726      linker after all the linker input files have been seen but before
727      the sections sizes have been set.  This is called after
728      ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
729      It is only called when linking against a dynamic object.  It must
730      set the sizes of the dynamic sections, and may fill in their
731      contents as well.  The generic ELF linker can handle the .dynsym,
732      .dynstr and .hash sections.  This function must handle the
733      .interp section and any sections created by the
734      CREATE_DYNAMIC_SECTIONS entry point.  */
735   bfd_boolean (*elf_backend_size_dynamic_sections)
736     (bfd *output_bfd, struct bfd_link_info *info);
737
738   /* The RELOCATE_SECTION function is called by the ELF backend linker
739      to handle the relocations for a section.
740
741      The relocs are always passed as Rela structures; if the section
742      actually uses Rel structures, the r_addend field will always be
743      zero.
744
745      This function is responsible for adjust the section contents as
746      necessary, and (if using Rela relocs and generating a
747      relocatable output file) adjusting the reloc addend as
748      necessary.
749
750      This function does not have to worry about setting the reloc
751      address or the reloc symbol index.
752
753      LOCAL_SYMS is a pointer to the swapped in local symbols.
754
755      LOCAL_SECTIONS is an array giving the section in the input file
756      corresponding to the st_shndx field of each local symbol.
757
758      The global hash table entry for the global symbols can be found
759      via elf_sym_hashes (input_bfd).
760
761      When generating relocatable output, this function must handle
762      STB_LOCAL/STT_SECTION symbols specially.  The output symbol is
763      going to be the section symbol corresponding to the output
764      section, which means that the addend must be adjusted
765      accordingly.  */
766   bfd_boolean (*elf_backend_relocate_section)
767     (bfd *output_bfd, struct bfd_link_info *info, bfd *input_bfd,
768      asection *input_section, bfd_byte *contents, Elf_Internal_Rela *relocs,
769      Elf_Internal_Sym *local_syms, asection **local_sections);
770
771   /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
772      linker just before it writes a symbol out to the .dynsym section.
773      The processor backend may make any required adjustment to the
774      symbol.  It may also take the opportunity to set contents of the
775      dynamic sections.  Note that FINISH_DYNAMIC_SYMBOL is called on
776      all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
777      on those symbols which are defined by a dynamic object.  */
778   bfd_boolean (*elf_backend_finish_dynamic_symbol)
779     (bfd *output_bfd, struct bfd_link_info *info,
780      struct elf_link_hash_entry *h, Elf_Internal_Sym *sym);
781
782   /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
783      linker just before it writes all the dynamic sections out to the
784      output file.  The FINISH_DYNAMIC_SYMBOL will have been called on
785      all dynamic symbols.  */
786   bfd_boolean (*elf_backend_finish_dynamic_sections)
787     (bfd *output_bfd, struct bfd_link_info *info);
788
789   /* A function to do any beginning processing needed for the ELF file
790      before building the ELF headers and computing file positions.  */
791   void (*elf_backend_begin_write_processing)
792     (bfd *, struct bfd_link_info *);
793
794   /* A function to do any final processing needed for the ELF file
795      before writing it out.  The LINKER argument is TRUE if this BFD
796      was created by the ELF backend linker.  */
797   void (*elf_backend_final_write_processing)
798     (bfd *, bfd_boolean linker);
799
800   /* This function is called by get_program_header_size.  It should
801      return the number of additional program segments which this BFD
802      will need.  It should return -1 on error.  */
803   int (*elf_backend_additional_program_headers)
804     (bfd *);
805
806   /* This function is called to modify an existing segment map in a
807      backend specific fashion.  */
808   bfd_boolean (*elf_backend_modify_segment_map)
809     (bfd *, struct bfd_link_info *);
810
811   /* This function is called during section gc to discover the section a
812      particular relocation refers to.  */
813   asection * (*gc_mark_hook)
814     (asection *sec, struct bfd_link_info *, Elf_Internal_Rela *,
815      struct elf_link_hash_entry *h, Elf_Internal_Sym *);
816
817   /* This function, if defined, is called during the sweep phase of gc
818      in order that a backend might update any data structures it might
819      be maintaining.  */
820   bfd_boolean (*gc_sweep_hook)
821     (bfd *abfd, struct bfd_link_info *info, asection *o,
822      const Elf_Internal_Rela *relocs);
823
824   /* This function, if defined, is called after the ELF headers have
825      been created.  This allows for things like the OS and ABI versions
826      to be changed.  */
827   void (*elf_backend_post_process_headers)
828     (bfd *, struct bfd_link_info *);
829
830   /* This function, if defined, prints a symbol to file and returns the
831      name of the symbol to be printed.  It should return NULL to fall
832      back to default symbol printing.  */
833   const char *(*elf_backend_print_symbol_all)
834     (bfd *, void *, asymbol *);
835
836   /* This function, if defined, is called after all local symbols and
837      global symbols converted to locals are emitted into the symtab
838      section.  It allows the backend to emit special global symbols
839      not handled in the hash table.  */
840   bfd_boolean (*elf_backend_output_arch_syms)
841     (bfd *, struct bfd_link_info *, void *,
842      bfd_boolean (*) (void *, const char *, Elf_Internal_Sym *, asection *,
843                       struct elf_link_hash_entry *));
844
845   /* Copy any information related to dynamic linking from a pre-existing
846      symbol to a newly created symbol.  Also called to copy flags and
847      other back-end info to a weakdef, in which case the symbol is not
848      newly created and plt/got refcounts and dynamic indices should not
849      be copied.  */
850   void (*elf_backend_copy_indirect_symbol)
851     (const struct elf_backend_data *, struct elf_link_hash_entry *,
852      struct elf_link_hash_entry *);
853
854   /* Modify any information related to dynamic linking such that the
855      symbol is not exported.  */
856   void (*elf_backend_hide_symbol)
857     (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
858
859   /* Merge the backend specific symbol attribute.  */
860   void (*elf_backend_merge_symbol_attribute)
861     (struct elf_link_hash_entry *, const Elf_Internal_Sym *, bfd_boolean,
862      bfd_boolean);
863
864   /* Emit relocations.  Overrides default routine for emitting relocs,
865      except during a relocatable link, or if all relocs are being emitted.  */
866   bfd_boolean (*elf_backend_emit_relocs)
867     (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *);
868
869   /* Count relocations.  Not called for relocatable links
870      or if all relocs are being preserved in the output.  */
871   unsigned int (*elf_backend_count_relocs)
872     (asection *, Elf_Internal_Rela *);
873
874   /* This function, if defined, is called when an NT_PRSTATUS note is found
875      in a core file. */
876   bfd_boolean (*elf_backend_grok_prstatus)
877     (bfd *, Elf_Internal_Note *);
878
879   /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
880      note is found in a core file. */
881   bfd_boolean (*elf_backend_grok_psinfo)
882     (bfd *, Elf_Internal_Note *);
883
884   /* Functions to print VMAs.  Special code to handle 64 bit ELF files.  */
885   void (* elf_backend_sprintf_vma)
886     (bfd *, char *, bfd_vma);
887   void (* elf_backend_fprintf_vma)
888     (bfd *, void *, bfd_vma);
889
890   /* This function returns class of a reloc type.  */
891   enum elf_reloc_type_class (*elf_backend_reloc_type_class)
892     (const Elf_Internal_Rela *);
893
894   /* This function, if defined, removes information about discarded functions
895      from other sections which mention them.  */
896   bfd_boolean (*elf_backend_discard_info)
897     (bfd *, struct elf_reloc_cookie *, struct bfd_link_info *);
898
899   /* This function, if defined, signals that the function above has removed
900      the discarded relocations for this section.  */
901   bfd_boolean (*elf_backend_ignore_discarded_relocs)
902     (asection *);
903
904   /* These functions tell elf-eh-frame whether to attempt to turn
905      absolute or lsda encodings into pc-relative ones.  The default
906      definition enables these transformations.  */
907   bfd_boolean (*elf_backend_can_make_relative_eh_frame)
908      (bfd *, struct bfd_link_info *, asection *);
909   bfd_boolean (*elf_backend_can_make_lsda_relative_eh_frame)
910      (bfd *, struct bfd_link_info *, asection *);
911
912   /* This function returns an encoding after computing the encoded
913      value (and storing it in ENCODED) for the given OFFSET into OSEC,
914      to be stored in at LOC_OFFSET into the LOC_SEC input section.
915      The default definition chooses a 32-bit PC-relative encoding.  */
916   bfd_byte (*elf_backend_encode_eh_address)
917      (bfd *abfd, struct bfd_link_info *info,
918       asection *osec, bfd_vma offset,
919       asection *loc_sec, bfd_vma loc_offset,
920       bfd_vma *encoded);
921
922   /* This function, if defined, may write out the given section.
923      Returns TRUE if it did so and FALSE if the caller should.  */
924   bfd_boolean (*elf_backend_write_section)
925     (bfd *, asection *, bfd_byte *);
926
927   /* The level of IRIX compatibility we're striving for.
928      MIPS ELF specific function.  */
929   irix_compat_t (*elf_backend_mips_irix_compat)
930     (bfd *);
931
932   reloc_howto_type *(*elf_backend_mips_rtype_to_howto)
933     (unsigned int, bfd_boolean);
934
935   /* The swapping table to use when dealing with ECOFF information.
936      Used for the MIPS ELF .mdebug section.  */
937   const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
938
939   /* This function implements `bfd_elf_bfd_from_remote_memory';
940      see elf.c, elfcode.h.  */
941   bfd *(*elf_backend_bfd_from_remote_memory)
942      (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
943       int (*target_read_memory) (bfd_vma vma, char *myaddr, int len));
944
945   /* This function is used by `_bfd_elf_get_synthetic_symtab';
946      see elf.c.  */
947   bfd_vma (*plt_sym_val) (bfd_vma, const asection *, const arelent *);
948
949   /* Used to handle bad SHF_LINK_ORDER input.  */
950   bfd_error_handler_type link_order_error_handler;
951
952   /* Name of the PLT relocation section.  */
953   const char *relplt_name;
954
955   /* Alternate EM_xxxx machine codes for this backend.  */
956   int elf_machine_alt1;
957   int elf_machine_alt2;
958
959   const struct elf_size_info *s;
960
961   /* An array of target specific special section map.  */
962   const struct bfd_elf_special_section *special_sections;
963
964   /* offset of the _GLOBAL_OFFSET_TABLE_ symbol from the start of the
965      .got section */
966   bfd_vma got_symbol_offset;
967
968   /* The size in bytes of the header for the GOT.  This includes the
969      so-called reserved entries on some systems.  */
970   bfd_vma got_header_size;
971
972   /* This is TRUE if the linker should act like collect and gather
973      global constructors and destructors by name.  This is TRUE for
974      MIPS ELF because the Irix 5 tools can not handle the .init
975      section.  */
976   unsigned collect : 1;
977
978   /* This is TRUE if the linker should ignore changes to the type of a
979      symbol.  This is TRUE for MIPS ELF because some Irix 5 objects
980      record undefined functions as STT_OBJECT although the definitions
981      are STT_FUNC.  */
982   unsigned type_change_ok : 1;
983
984   /* Whether the backend may use REL relocations.  (Some backends use
985      both REL and RELA relocations, and this flag is set for those
986      backends.)  */
987   unsigned may_use_rel_p : 1;
988
989   /* Whether the backend may use RELA relocations.  (Some backends use
990      both REL and RELA relocations, and this flag is set for those
991      backends.)  */
992   unsigned may_use_rela_p : 1;
993
994   /* Whether the default relocation type is RELA.  If a backend with
995      this flag set wants REL relocations for a particular section,
996      it must note that explicitly.  Similarly, if this flag is clear,
997      and the backend wants RELA relocations for a particular
998      section.  */
999   unsigned default_use_rela_p : 1;
1000
1001   /* Set if RELA relocations for a relocatable link can be handled by
1002      generic code.  Backends that set this flag need do nothing in the
1003      backend relocate_section routine for relocatable linking.  */
1004   unsigned rela_normal : 1;
1005
1006   /* TRUE if addresses "naturally" sign extend.  This is used when
1007      swapping in from Elf32 when BFD64.  */
1008   unsigned sign_extend_vma : 1;
1009
1010   unsigned want_got_plt : 1;
1011   unsigned plt_readonly : 1;
1012   unsigned want_plt_sym : 1;
1013   unsigned plt_not_loaded : 1;
1014   unsigned plt_alignment : 4;
1015   unsigned can_gc_sections : 1;
1016   unsigned can_refcount : 1;
1017   unsigned want_got_sym : 1;
1018   unsigned want_dynbss : 1;
1019     /* Targets which do not support physical addressing often require
1020        that the p_paddr field in the section header to be set to zero.
1021        This field indicates whether this behavior is required.  */
1022   unsigned want_p_paddr_set_to_zero : 1;
1023 };
1024
1025 /* Information stored for each BFD section in an ELF file.  This
1026    structure is allocated by elf_new_section_hook.  */
1027
1028 struct bfd_elf_section_data
1029 {
1030   /* The ELF header for this section.  */
1031   Elf_Internal_Shdr this_hdr;
1032
1033   /* The ELF header for the reloc section associated with this
1034      section, if any.  */
1035   Elf_Internal_Shdr rel_hdr;
1036
1037   /* If there is a second reloc section associated with this section,
1038      as can happen on Irix 6, this field points to the header.  */
1039   Elf_Internal_Shdr *rel_hdr2;
1040
1041   /* The number of relocations currently assigned to REL_HDR.  */
1042   unsigned int rel_count;
1043
1044   /* The number of relocations currently assigned to REL_HDR2.  */
1045   unsigned int rel_count2;
1046
1047   /* The ELF section number of this section.  Only used for an output
1048      file.  */
1049   int this_idx;
1050
1051   /* The ELF section number of the reloc section indicated by
1052      REL_HDR if any.  Only used for an output file.  */
1053   int rel_idx;
1054
1055   /* The ELF section number of the reloc section indicated by
1056      REL_HDR2 if any.  Only used for an output file.  */
1057   int rel_idx2;
1058
1059   /* Used by the backend linker when generating a shared library to
1060      record the dynamic symbol index for a section symbol
1061      corresponding to this section.  A value of 0 means that there is
1062      no dynamic symbol for this section.  */
1063   int dynindx;
1064
1065   /* A pointer to the linked-to section for SHF_LINK_ORDER.  */
1066   asection *linked_to;
1067
1068   /* Used by the backend linker to store the symbol hash table entries
1069      associated with relocs against global symbols.  */
1070   struct elf_link_hash_entry **rel_hashes;
1071
1072   /* A pointer to the swapped relocs.  If the section uses REL relocs,
1073      rather than RELA, all the r_addend fields will be zero.  This
1074      pointer may be NULL.  It is used by the backend linker.  */
1075   Elf_Internal_Rela *relocs;
1076
1077   /* A pointer to a linked list tracking dynamic relocs copied for
1078      local symbols.  */
1079   void *local_dynrel;
1080
1081   /* A pointer to the bfd section used for dynamic relocs.  */
1082   asection *sreloc;
1083
1084   union {
1085     /* Group name, if this section is a member of a group.  */
1086     const char *name;
1087
1088     /* Group signature sym, if this is the SHT_GROUP section.  */
1089     struct bfd_symbol *id;
1090   } group;
1091
1092   /* Optional information about section group; NULL if it doesn't
1093      belongs to any section group. */
1094   asection *sec_group;
1095
1096   /* A linked list of sections in the group.  Circular when used by
1097      the linker.  */
1098   asection *next_in_group;
1099
1100   /* A pointer used for various section optimizations.  */
1101   void *sec_info;
1102 };
1103
1104 #define elf_section_data(sec)  ((struct bfd_elf_section_data*)sec->used_by_bfd)
1105 #define elf_linked_to_section(sec) (elf_section_data(sec)->linked_to)
1106 #define elf_section_type(sec)  (elf_section_data(sec)->this_hdr.sh_type)
1107 #define elf_section_flags(sec) (elf_section_data(sec)->this_hdr.sh_flags)
1108 #define elf_group_name(sec)    (elf_section_data(sec)->group.name)
1109 #define elf_group_id(sec)      (elf_section_data(sec)->group.id)
1110 #define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group)
1111 #define elf_sec_group(sec)      (elf_section_data(sec)->sec_group)
1112
1113 /* Return TRUE if section has been discarded.  */
1114 #define elf_discarded_section(sec)                              \
1115   (!bfd_is_abs_section (sec)                                    \
1116    && bfd_is_abs_section ((sec)->output_section)                \
1117    && (sec)->sec_info_type != ELF_INFO_TYPE_MERGE               \
1118    && (sec)->sec_info_type != ELF_INFO_TYPE_JUST_SYMS)
1119
1120 #define get_elf_backend_data(abfd) \
1121   ((const struct elf_backend_data *) (abfd)->xvec->backend_data)
1122
1123 /* This struct is used to pass information to routines called via
1124    elf_link_hash_traverse which must return failure.  */
1125
1126 struct elf_info_failed
1127 {
1128   bfd_boolean failed;
1129   struct bfd_link_info *info;
1130   struct bfd_elf_version_tree *verdefs;
1131 };
1132
1133 /* This structure is used to pass information to
1134    _bfd_elf_link_assign_sym_version.  */
1135
1136 struct elf_assign_sym_version_info
1137 {
1138   /* Output BFD.  */
1139   bfd *output_bfd;
1140   /* General link information.  */
1141   struct bfd_link_info *info;
1142   /* Version tree.  */
1143   struct bfd_elf_version_tree *verdefs;
1144   /* Whether we had a failure.  */
1145   bfd_boolean failed;
1146 };
1147
1148 /* This structure is used to pass information to
1149    _bfd_elf_link_find_version_dependencies.  */
1150
1151 struct elf_find_verdep_info
1152 {
1153   /* Output BFD.  */
1154   bfd *output_bfd;
1155   /* General link information.  */
1156   struct bfd_link_info *info;
1157   /* The number of dependencies.  */
1158   unsigned int vers;
1159   /* Whether we had a failure.  */
1160   bfd_boolean failed;
1161 };
1162
1163 /* Some private data is stashed away for future use using the tdata pointer
1164    in the bfd structure.  */
1165
1166 struct elf_obj_tdata
1167 {
1168   Elf_Internal_Ehdr elf_header[1];      /* Actual data, but ref like ptr */
1169   Elf_Internal_Shdr **elf_sect_ptr;
1170   Elf_Internal_Phdr *phdr;
1171   struct elf_segment_map *segment_map;
1172   struct elf_strtab_hash *strtab_ptr;
1173   int num_locals;
1174   int num_globals;
1175   unsigned int num_elf_sections;        /* elf_sect_ptr size */
1176   int num_section_syms;
1177   asymbol **section_syms;               /* STT_SECTION symbols for each section */
1178   Elf_Internal_Shdr symtab_hdr;
1179   Elf_Internal_Shdr shstrtab_hdr;
1180   Elf_Internal_Shdr strtab_hdr;
1181   Elf_Internal_Shdr dynsymtab_hdr;
1182   Elf_Internal_Shdr dynstrtab_hdr;
1183   Elf_Internal_Shdr dynversym_hdr;
1184   Elf_Internal_Shdr dynverref_hdr;
1185   Elf_Internal_Shdr dynverdef_hdr;
1186   Elf_Internal_Shdr symtab_shndx_hdr;
1187   unsigned int symtab_section, shstrtab_section;
1188   unsigned int strtab_section, dynsymtab_section;
1189   unsigned int symtab_shndx_section;
1190   unsigned int dynversym_section, dynverdef_section, dynverref_section;
1191   file_ptr next_file_pos;
1192   bfd_vma gp;                           /* The gp value */
1193   unsigned int gp_size;                 /* The gp size */
1194
1195   /* Information grabbed from an elf core file.  */
1196   int core_signal;
1197   int core_pid;
1198   int core_lwpid;
1199   char* core_program;
1200   char* core_command;
1201
1202   /* A mapping from external symbols to entries in the linker hash
1203      table, used when linking.  This is indexed by the symbol index
1204      minus the sh_info field of the symbol table header.  */
1205   struct elf_link_hash_entry **sym_hashes;
1206
1207   /* Track usage and final offsets of GOT entries for local symbols.
1208      This array is indexed by symbol index.  Elements are used
1209      identically to "got" in struct elf_link_hash_entry.  */
1210   union
1211     {
1212       bfd_signed_vma *refcounts;
1213       bfd_vma *offsets;
1214       struct got_entry **ents;
1215     } local_got;
1216
1217   /* The linker ELF emulation code needs to let the backend ELF linker
1218      know what filename should be used for a dynamic object if the
1219      dynamic object is found using a search.  The emulation code then
1220      sometimes needs to know what name was actually used.  Until the
1221      file has been added to the linker symbol table, this field holds
1222      the name the linker wants.  After it has been added, it holds the
1223      name actually used, which will be the DT_SONAME entry if there is
1224      one.  */
1225   const char *dt_name;
1226
1227   /* Records the result of `get_program_header_size'.  */
1228   bfd_size_type program_header_size;
1229
1230   /* Used by find_nearest_line entry point.  */
1231   void *line_info;
1232
1233   /* Used by MIPS ELF find_nearest_line entry point.  The structure
1234      could be included directly in this one, but there's no point to
1235      wasting the memory just for the infrequently called
1236      find_nearest_line.  */
1237   struct mips_elf_find_line *find_line_info;
1238
1239   /* A place to stash dwarf1 info for this bfd.  */
1240   struct dwarf1_debug *dwarf1_find_line_info;
1241
1242   /* A place to stash dwarf2 info for this bfd.  */
1243   void *dwarf2_find_line_info;
1244
1245   /* An array of stub sections indexed by symbol number, used by the
1246      MIPS ELF linker.  FIXME: We should figure out some way to only
1247      include this field for a MIPS ELF target.  */
1248   asection **local_stubs;
1249
1250   /* Used to determine if PT_GNU_EH_FRAME segment header should be
1251      created.  */
1252   asection *eh_frame_hdr;
1253
1254   Elf_Internal_Shdr **group_sect_ptr;
1255   int num_group;
1256
1257   /* Number of symbol version definitions we are about to emit.  */
1258   unsigned int cverdefs;
1259
1260   /* Number of symbol version references we are about to emit.  */
1261   unsigned int cverrefs;
1262
1263   /* Segment flags for the PT_GNU_STACK segment.  */
1264   unsigned int stack_flags;
1265
1266   /* Should the PT_GNU_RELRO segment be emitted?  */
1267   bfd_boolean relro;
1268
1269   /* Symbol version definitions in external objects.  */
1270   Elf_Internal_Verdef *verdef;
1271
1272   /* Symbol version references to external objects.  */
1273   Elf_Internal_Verneed *verref;
1274
1275   /* The Irix 5 support uses two virtual sections, which represent
1276      text/data symbols defined in dynamic objects.  */
1277   asymbol *elf_data_symbol;
1278   asymbol *elf_text_symbol;
1279   asection *elf_data_section;
1280   asection *elf_text_section;
1281
1282   /* Whether a dyanmic object was specified normally on the linker
1283      command line, or was specified when --as-needed was in effect,
1284      or was found via a DT_NEEDED entry.  */
1285   enum dynamic_lib_link_class dyn_lib_class;
1286
1287   /* This is set to TRUE if the object was created by the backend
1288      linker.  */
1289   bfd_boolean linker;
1290
1291   /* Irix 5 often screws up the symbol table, sorting local symbols
1292      after global symbols.  This flag is set if the symbol table in
1293      this BFD appears to be screwed up.  If it is, we ignore the
1294      sh_info field in the symbol table header, and always read all the
1295      symbols.  */
1296   bfd_boolean bad_symtab;
1297
1298   /* Used to determine if the e_flags field has been initialized */
1299   bfd_boolean flags_init;
1300 };
1301
1302 #define elf_tdata(bfd)          ((bfd) -> tdata.elf_obj_data)
1303 #define elf_elfheader(bfd)      (elf_tdata(bfd) -> elf_header)
1304 #define elf_elfsections(bfd)    (elf_tdata(bfd) -> elf_sect_ptr)
1305 #define elf_numsections(bfd)    (elf_tdata(bfd) -> num_elf_sections)
1306 #define elf_shstrtab(bfd)       (elf_tdata(bfd) -> strtab_ptr)
1307 #define elf_onesymtab(bfd)      (elf_tdata(bfd) -> symtab_section)
1308 #define elf_symtab_shndx(bfd)   (elf_tdata(bfd) -> symtab_shndx_section)
1309 #define elf_dynsymtab(bfd)      (elf_tdata(bfd) -> dynsymtab_section)
1310 #define elf_dynversym(bfd)      (elf_tdata(bfd) -> dynversym_section)
1311 #define elf_dynverdef(bfd)      (elf_tdata(bfd) -> dynverdef_section)
1312 #define elf_dynverref(bfd)      (elf_tdata(bfd) -> dynverref_section)
1313 #define elf_num_locals(bfd)     (elf_tdata(bfd) -> num_locals)
1314 #define elf_num_globals(bfd)    (elf_tdata(bfd) -> num_globals)
1315 #define elf_section_syms(bfd)   (elf_tdata(bfd) -> section_syms)
1316 #define elf_num_section_syms(bfd) (elf_tdata(bfd) -> num_section_syms)
1317 #define core_prpsinfo(bfd)      (elf_tdata(bfd) -> prpsinfo)
1318 #define core_prstatus(bfd)      (elf_tdata(bfd) -> prstatus)
1319 #define elf_gp(bfd)             (elf_tdata(bfd) -> gp)
1320 #define elf_gp_size(bfd)        (elf_tdata(bfd) -> gp_size)
1321 #define elf_sym_hashes(bfd)     (elf_tdata(bfd) -> sym_hashes)
1322 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
1323 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
1324 #define elf_local_got_ents(bfd) (elf_tdata(bfd) -> local_got.ents)
1325 #define elf_dt_name(bfd)        (elf_tdata(bfd) -> dt_name)
1326 #define elf_dyn_lib_class(bfd)  (elf_tdata(bfd) -> dyn_lib_class)
1327 #define elf_bad_symtab(bfd)     (elf_tdata(bfd) -> bad_symtab)
1328 #define elf_flags_init(bfd)     (elf_tdata(bfd) -> flags_init)
1329 \f
1330 extern void _bfd_elf_swap_verdef_in
1331   (bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *);
1332 extern void _bfd_elf_swap_verdef_out
1333   (bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *);
1334 extern void _bfd_elf_swap_verdaux_in
1335   (bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *);
1336 extern void _bfd_elf_swap_verdaux_out
1337   (bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *);
1338 extern void _bfd_elf_swap_verneed_in
1339   (bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *);
1340 extern void _bfd_elf_swap_verneed_out
1341   (bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *);
1342 extern void _bfd_elf_swap_vernaux_in
1343   (bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *);
1344 extern void _bfd_elf_swap_vernaux_out
1345   (bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *);
1346 extern void _bfd_elf_swap_versym_in
1347   (bfd *, const Elf_External_Versym *, Elf_Internal_Versym *);
1348 extern void _bfd_elf_swap_versym_out
1349   (bfd *, const Elf_Internal_Versym *, Elf_External_Versym *);
1350
1351 extern int _bfd_elf_section_from_bfd_section
1352   (bfd *, asection *);
1353 extern char *bfd_elf_string_from_elf_section
1354   (bfd *, unsigned, unsigned);
1355 extern char *bfd_elf_get_str_section
1356   (bfd *, unsigned);
1357 extern Elf_Internal_Sym *bfd_elf_get_elf_syms
1358   (bfd *, Elf_Internal_Shdr *, size_t, size_t, Elf_Internal_Sym *, void *,
1359    Elf_External_Sym_Shndx *);
1360 extern const char *bfd_elf_sym_name
1361   (bfd *, Elf_Internal_Shdr *, Elf_Internal_Sym *);
1362
1363 extern bfd_boolean _bfd_elf_copy_private_bfd_data
1364   (bfd *, bfd *);
1365 extern bfd_boolean _bfd_elf_print_private_bfd_data
1366   (bfd *, void *);
1367 extern void bfd_elf_print_symbol
1368   (bfd *, void *, asymbol *, bfd_print_symbol_type);
1369
1370 #define elf_string_from_elf_strtab(abfd, strindex) \
1371   bfd_elf_string_from_elf_section (abfd, elf_elfheader(abfd)->e_shstrndx, \
1372                                    strindex)
1373
1374 extern void _bfd_elf_sprintf_vma
1375   (bfd *, char *, bfd_vma);
1376 extern void _bfd_elf_fprintf_vma
1377   (bfd *, void *, bfd_vma);
1378
1379 extern bfd_byte _bfd_elf_encode_eh_address
1380   (bfd *abfd, struct bfd_link_info *info, asection *osec, bfd_vma offset,
1381    asection *loc_sec, bfd_vma loc_offset, bfd_vma *encoded);
1382 extern bfd_boolean _bfd_elf_can_make_relative
1383   (bfd *input_bfd, struct bfd_link_info *info, asection *eh_frame_section);
1384
1385 extern enum elf_reloc_type_class _bfd_elf_reloc_type_class
1386   (const Elf_Internal_Rela *);
1387 extern bfd_vma _bfd_elf_rela_local_sym
1388   (bfd *, Elf_Internal_Sym *, asection **, Elf_Internal_Rela *);
1389 extern bfd_vma _bfd_elf_rel_local_sym
1390   (bfd *, Elf_Internal_Sym *, asection **, bfd_vma);
1391 extern bfd_vma _bfd_elf_section_offset
1392   (bfd *, struct bfd_link_info *, asection *, bfd_vma);
1393
1394 extern unsigned long bfd_elf_hash
1395   (const char *);
1396
1397 extern bfd_reloc_status_type bfd_elf_generic_reloc
1398   (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
1399 extern bfd_boolean bfd_elf_mkobject
1400   (bfd *);
1401 extern bfd_boolean bfd_elf_mkcorefile
1402   (bfd *);
1403 extern Elf_Internal_Shdr *bfd_elf_find_section
1404   (bfd *, char *);
1405 extern bfd_boolean _bfd_elf_make_section_from_shdr
1406   (bfd *, Elf_Internal_Shdr *, const char *);
1407 extern bfd_boolean _bfd_elf_make_section_from_phdr
1408   (bfd *, Elf_Internal_Phdr *, int, const char *);
1409 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
1410   (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
1411 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
1412   (bfd *);
1413 extern void _bfd_elf_link_hash_copy_indirect
1414   (const struct elf_backend_data *, struct elf_link_hash_entry *,
1415    struct elf_link_hash_entry *);
1416 extern void _bfd_elf_link_hash_hide_symbol
1417   (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
1418 extern bfd_boolean _bfd_elf_link_hash_table_init
1419   (struct elf_link_hash_table *, bfd *,
1420    struct bfd_hash_entry *(*)
1421      (struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
1422 extern bfd_boolean _bfd_elf_slurp_version_tables
1423   (bfd *, bfd_boolean);
1424 extern bfd_boolean _bfd_elf_merge_sections
1425   (bfd *, struct bfd_link_info *);
1426 extern bfd_boolean bfd_elf_is_group_section
1427   (bfd *, const struct bfd_section *);
1428 extern bfd_boolean bfd_elf_discard_group
1429   (bfd *, struct bfd_section *);
1430 extern void _bfd_elf_section_already_linked
1431   (bfd *, struct bfd_section *);
1432 extern void bfd_elf_set_group_contents
1433   (bfd *, asection *, void *);
1434 extern void _bfd_elf_link_just_syms
1435   (asection *, struct bfd_link_info *);
1436 extern bfd_boolean _bfd_elf_copy_private_header_data
1437   (bfd *, bfd *);
1438 extern bfd_boolean _bfd_elf_copy_private_symbol_data
1439   (bfd *, asymbol *, bfd *, asymbol *);
1440 extern bfd_boolean _bfd_elf_copy_private_section_data
1441   (bfd *, asection *, bfd *, asection *);
1442 extern bfd_boolean _bfd_elf_write_object_contents
1443   (bfd *);
1444 extern bfd_boolean _bfd_elf_write_corefile_contents
1445   (bfd *);
1446 extern bfd_boolean _bfd_elf_set_section_contents
1447   (bfd *, sec_ptr, const void *, file_ptr, bfd_size_type);
1448 extern long _bfd_elf_get_symtab_upper_bound
1449   (bfd *);
1450 extern long _bfd_elf_canonicalize_symtab
1451   (bfd *, asymbol **);
1452 extern long _bfd_elf_get_dynamic_symtab_upper_bound
1453   (bfd *);
1454 extern long _bfd_elf_canonicalize_dynamic_symtab
1455   (bfd *, asymbol **);
1456 extern long _bfd_elf_get_synthetic_symtab
1457   (bfd *, long, asymbol **, long, asymbol **, asymbol **);
1458 extern long _bfd_elf_get_reloc_upper_bound
1459   (bfd *, sec_ptr);
1460 extern long _bfd_elf_canonicalize_reloc
1461   (bfd *, sec_ptr, arelent **, asymbol **);
1462 extern long _bfd_elf_get_dynamic_reloc_upper_bound
1463   (bfd *);
1464 extern long _bfd_elf_canonicalize_dynamic_reloc
1465   (bfd *, arelent **, asymbol **);
1466 extern asymbol *_bfd_elf_make_empty_symbol
1467   (bfd *);
1468 extern void _bfd_elf_get_symbol_info
1469   (bfd *, asymbol *, symbol_info *);
1470 extern bfd_boolean _bfd_elf_is_local_label_name
1471   (bfd *, const char *);
1472 extern alent *_bfd_elf_get_lineno
1473   (bfd *, asymbol *);
1474 extern bfd_boolean _bfd_elf_set_arch_mach
1475   (bfd *, enum bfd_architecture, unsigned long);
1476 extern bfd_boolean _bfd_elf_find_nearest_line
1477   (bfd *, asection *, asymbol **, bfd_vma, const char **, const char **,
1478    unsigned int *);
1479 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
1480 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
1481 extern int _bfd_elf_sizeof_headers
1482   (bfd *, bfd_boolean);
1483 extern bfd_boolean _bfd_elf_new_section_hook
1484   (bfd *, asection *);
1485 extern bfd_boolean _bfd_elf_init_reloc_shdr
1486   (bfd *, Elf_Internal_Shdr *, asection *, bfd_boolean);
1487 extern const struct bfd_elf_special_section *_bfd_elf_get_sec_type_attr
1488   (bfd *, const char *);
1489
1490 /* If the target doesn't have reloc handling written yet:  */
1491 extern void _bfd_elf_no_info_to_howto
1492   (bfd *, arelent *, Elf_Internal_Rela *);
1493
1494 extern bfd_boolean bfd_section_from_shdr
1495   (bfd *, unsigned int shindex);
1496 extern bfd_boolean bfd_section_from_phdr
1497   (bfd *, Elf_Internal_Phdr *, int);
1498
1499 extern int _bfd_elf_symbol_from_bfd_symbol
1500   (bfd *, asymbol **);
1501
1502 extern asection *bfd_section_from_r_symndx
1503   (bfd *, struct sym_sec_cache *, asection *, unsigned long);
1504 extern asection *bfd_section_from_elf_index
1505   (bfd *, unsigned int);
1506 extern struct bfd_strtab_hash *_bfd_elf_stringtab_init
1507   (void);
1508
1509 extern struct elf_strtab_hash * _bfd_elf_strtab_init
1510   (void);
1511 extern void _bfd_elf_strtab_free
1512   (struct elf_strtab_hash *);
1513 extern bfd_size_type _bfd_elf_strtab_add
1514   (struct elf_strtab_hash *, const char *, bfd_boolean);
1515 extern void _bfd_elf_strtab_addref
1516   (struct elf_strtab_hash *, bfd_size_type);
1517 extern void _bfd_elf_strtab_delref
1518   (struct elf_strtab_hash *, bfd_size_type);
1519 extern void _bfd_elf_strtab_clear_all_refs
1520   (struct elf_strtab_hash *);
1521 extern bfd_size_type _bfd_elf_strtab_size
1522   (struct elf_strtab_hash *);
1523 extern bfd_size_type _bfd_elf_strtab_offset
1524   (struct elf_strtab_hash *, bfd_size_type);
1525 extern bfd_boolean _bfd_elf_strtab_emit
1526   (bfd *, struct elf_strtab_hash *);
1527 extern void _bfd_elf_strtab_finalize
1528   (struct elf_strtab_hash *);
1529
1530 extern bfd_boolean _bfd_elf_discard_section_eh_frame
1531   (bfd *, struct bfd_link_info *, asection *,
1532    bfd_boolean (*) (bfd_vma, void *), struct elf_reloc_cookie *);
1533 extern bfd_boolean _bfd_elf_discard_section_eh_frame_hdr
1534   (bfd *, struct bfd_link_info *);
1535 extern bfd_vma _bfd_elf_eh_frame_section_offset
1536   (bfd *, struct bfd_link_info *, asection *, bfd_vma);
1537 extern bfd_boolean _bfd_elf_write_section_eh_frame
1538   (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
1539 extern bfd_boolean _bfd_elf_write_section_eh_frame_hdr
1540   (bfd *, struct bfd_link_info *);
1541 extern bfd_boolean _bfd_elf_maybe_strip_eh_frame_hdr
1542   (struct bfd_link_info *);
1543
1544 extern bfd_boolean _bfd_elf_merge_symbol
1545   (bfd *, struct bfd_link_info *, const char *, Elf_Internal_Sym *,
1546    asection **, bfd_vma *, struct elf_link_hash_entry **, bfd_boolean *,
1547    bfd_boolean *, bfd_boolean *, bfd_boolean *);
1548
1549 extern bfd_boolean _bfd_elf_add_default_symbol
1550   (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *,
1551    const char *, Elf_Internal_Sym *, asection **, bfd_vma *,
1552    bfd_boolean *, bfd_boolean);
1553
1554 extern bfd_boolean _bfd_elf_export_symbol
1555   (struct elf_link_hash_entry *, void *);
1556
1557 extern bfd_boolean _bfd_elf_link_find_version_dependencies
1558   (struct elf_link_hash_entry *, void *);
1559
1560 extern bfd_boolean _bfd_elf_link_assign_sym_version
1561   (struct elf_link_hash_entry *, void *);
1562
1563 extern long _bfd_elf_link_lookup_local_dynindx
1564   (struct bfd_link_info *, bfd *, long);
1565 extern bfd_boolean _bfd_elf_compute_section_file_positions
1566   (bfd *, struct bfd_link_info *);
1567 extern void _bfd_elf_assign_file_positions_for_relocs
1568   (bfd *);
1569 extern file_ptr _bfd_elf_assign_file_position_for_section
1570   (Elf_Internal_Shdr *, file_ptr, bfd_boolean);
1571
1572 extern bfd_boolean _bfd_elf_validate_reloc
1573   (bfd *, arelent *);
1574
1575 extern bfd_boolean _bfd_elf_link_create_dynamic_sections
1576   (bfd *, struct bfd_link_info *);
1577 extern bfd_boolean _bfd_elf_link_omit_section_dynsym
1578   (bfd *, struct bfd_link_info *, asection *);
1579 extern bfd_boolean _bfd_elf_create_dynamic_sections
1580   (bfd *, struct bfd_link_info *);
1581 extern bfd_boolean _bfd_elf_create_got_section
1582   (bfd *, struct bfd_link_info *);
1583 extern unsigned long _bfd_elf_link_renumber_dynsyms
1584   (bfd *, struct bfd_link_info *);
1585
1586 extern bfd_boolean _bfd_elfcore_make_pseudosection
1587   (bfd *, char *, size_t, ufile_ptr);
1588 extern char *_bfd_elfcore_strndup
1589   (bfd *, char *, size_t);
1590
1591 extern Elf_Internal_Rela *_bfd_elf_link_read_relocs
1592   (bfd *, asection *, void *, Elf_Internal_Rela *, bfd_boolean);
1593
1594 extern bfd_boolean _bfd_elf_link_size_reloc_section
1595   (bfd *, Elf_Internal_Shdr *, asection *);
1596
1597 extern bfd_boolean _bfd_elf_link_output_relocs
1598   (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *);
1599
1600 extern bfd_boolean _bfd_elf_fix_symbol_flags
1601   (struct elf_link_hash_entry *, struct elf_info_failed *);
1602
1603 extern bfd_boolean _bfd_elf_adjust_dynamic_symbol
1604   (struct elf_link_hash_entry *, void *);
1605
1606 extern bfd_boolean _bfd_elf_link_sec_merge_syms
1607   (struct elf_link_hash_entry *, void *);
1608
1609 extern bfd_boolean _bfd_elf_dynamic_symbol_p
1610   (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
1611
1612 extern bfd_boolean _bfd_elf_symbol_refs_local_p
1613   (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
1614
1615 extern bfd_boolean bfd_elf_match_symbols_in_sections
1616   (asection *sec1, asection *sec2);
1617
1618 extern bfd_boolean _bfd_elf_setup_group_pointers
1619   (bfd *);
1620
1621 extern const bfd_target *bfd_elf32_object_p
1622   (bfd *);
1623 extern const bfd_target *bfd_elf32_core_file_p
1624   (bfd *);
1625 extern char *bfd_elf32_core_file_failing_command
1626   (bfd *);
1627 extern int bfd_elf32_core_file_failing_signal
1628   (bfd *);
1629 extern bfd_boolean bfd_elf32_core_file_matches_executable_p
1630   (bfd *, bfd *);
1631
1632 extern void bfd_elf32_swap_symbol_in
1633   (bfd *, const void *, const void *, Elf_Internal_Sym *);
1634 extern void bfd_elf32_swap_symbol_out
1635   (bfd *, const Elf_Internal_Sym *, void *, void *);
1636 extern void bfd_elf32_swap_reloc_in
1637   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1638 extern void bfd_elf32_swap_reloc_out
1639   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1640 extern void bfd_elf32_swap_reloca_in
1641   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1642 extern void bfd_elf32_swap_reloca_out
1643   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1644 extern void bfd_elf32_swap_phdr_in
1645   (bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *);
1646 extern void bfd_elf32_swap_phdr_out
1647   (bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *);
1648 extern void bfd_elf32_swap_dyn_in
1649   (bfd *, const void *, Elf_Internal_Dyn *);
1650 extern void bfd_elf32_swap_dyn_out
1651   (bfd *, const Elf_Internal_Dyn *, void *);
1652 extern long bfd_elf32_slurp_symbol_table
1653   (bfd *, asymbol **, bfd_boolean);
1654 extern bfd_boolean bfd_elf32_write_shdrs_and_ehdr
1655   (bfd *);
1656 extern int bfd_elf32_write_out_phdrs
1657   (bfd *, const Elf_Internal_Phdr *, unsigned int);
1658 extern void bfd_elf32_write_relocs
1659   (bfd *, asection *, void *);
1660 extern bfd_boolean bfd_elf32_slurp_reloc_table
1661   (bfd *, asection *, asymbol **, bfd_boolean);
1662
1663 extern const bfd_target *bfd_elf64_object_p
1664   (bfd *);
1665 extern const bfd_target *bfd_elf64_core_file_p
1666   (bfd *);
1667 extern char *bfd_elf64_core_file_failing_command
1668   (bfd *);
1669 extern int bfd_elf64_core_file_failing_signal
1670   (bfd *);
1671 extern bfd_boolean bfd_elf64_core_file_matches_executable_p
1672   (bfd *, bfd *);
1673
1674 extern void bfd_elf64_swap_symbol_in
1675   (bfd *, const void *, const void *, Elf_Internal_Sym *);
1676 extern void bfd_elf64_swap_symbol_out
1677   (bfd *, const Elf_Internal_Sym *, void *, void *);
1678 extern void bfd_elf64_swap_reloc_in
1679   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1680 extern void bfd_elf64_swap_reloc_out
1681   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1682 extern void bfd_elf64_swap_reloca_in
1683   (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1684 extern void bfd_elf64_swap_reloca_out
1685   (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1686 extern void bfd_elf64_swap_phdr_in
1687   (bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *);
1688 extern void bfd_elf64_swap_phdr_out
1689   (bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *);
1690 extern void bfd_elf64_swap_dyn_in
1691   (bfd *, const void *, Elf_Internal_Dyn *);
1692 extern void bfd_elf64_swap_dyn_out
1693   (bfd *, const Elf_Internal_Dyn *, void *);
1694 extern long bfd_elf64_slurp_symbol_table
1695   (bfd *, asymbol **, bfd_boolean);
1696 extern bfd_boolean bfd_elf64_write_shdrs_and_ehdr
1697   (bfd *);
1698 extern int bfd_elf64_write_out_phdrs
1699   (bfd *, const Elf_Internal_Phdr *, unsigned int);
1700 extern void bfd_elf64_write_relocs
1701   (bfd *, asection *, void *);
1702 extern bfd_boolean bfd_elf64_slurp_reloc_table
1703   (bfd *, asection *, asymbol **, bfd_boolean);
1704
1705 extern struct elf_link_hash_entry *_bfd_elf_archive_symbol_lookup
1706   (bfd *, struct bfd_link_info *, const char *);
1707 extern bfd_boolean bfd_elf_link_add_symbols
1708   (bfd *, struct bfd_link_info *);
1709 extern bfd_boolean _bfd_elf_add_dynamic_entry
1710   (struct bfd_link_info *, bfd_vma, bfd_vma);
1711
1712 extern bfd_boolean bfd_elf_link_record_dynamic_symbol
1713   (struct bfd_link_info *, struct elf_link_hash_entry *);
1714
1715 extern int bfd_elf_link_record_local_dynamic_symbol
1716   (struct bfd_link_info *, bfd *, long);
1717
1718 extern bfd_boolean _bfd_elf_close_and_cleanup
1719   (bfd *);
1720 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
1721   (bfd *, arelent *, struct bfd_symbol *, void *,
1722    asection *, bfd *, char **);
1723
1724 extern bfd_boolean bfd_elf_final_link
1725   (bfd *, struct bfd_link_info *);
1726
1727 extern bfd_boolean bfd_elf_gc_sections
1728   (bfd *, struct bfd_link_info *);
1729
1730 extern bfd_boolean bfd_elf_gc_record_vtinherit
1731   (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
1732
1733 extern bfd_boolean bfd_elf_gc_record_vtentry
1734   (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
1735
1736 extern bfd_boolean _bfd_elf_gc_mark
1737   (struct bfd_link_info *, asection *,
1738    asection * (*) (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
1739                    struct elf_link_hash_entry *, Elf_Internal_Sym *));
1740
1741 extern bfd_boolean bfd_elf_gc_common_finalize_got_offsets
1742   (bfd *, struct bfd_link_info *);
1743
1744 extern bfd_boolean bfd_elf_gc_common_final_link
1745   (bfd *, struct bfd_link_info *);
1746
1747 extern bfd_boolean bfd_elf_reloc_symbol_deleted_p
1748   (bfd_vma, void *);
1749
1750 extern struct elf_segment_map *
1751 _bfd_elf_make_dynamic_segment
1752   (bfd *, asection *);
1753
1754 /* Exported interface for writing elf corefile notes. */
1755 extern char *elfcore_write_note
1756   (bfd *, char *, int *, const char *, int, const void *, int);
1757 extern char *elfcore_write_prpsinfo
1758   (bfd *, char *, int *, const char *, const char *);
1759 extern char *elfcore_write_prstatus
1760   (bfd *, char *, int *, long, int, const void *);
1761 extern char * elfcore_write_pstatus
1762   (bfd *, char *, int *, long, int, const void *);
1763 extern char *elfcore_write_prfpreg
1764   (bfd *, char *, int *, const void *, int);
1765 extern char *elfcore_write_prxfpreg
1766   (bfd *, char *, int *, const void *, int);
1767 extern char *elfcore_write_lwpstatus
1768   (bfd *, char *, int *, long, int, const void *);
1769
1770 extern bfd *_bfd_elf32_bfd_from_remote_memory
1771   (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
1772    int (*target_read_memory) (bfd_vma, char *, int));
1773 extern bfd *_bfd_elf64_bfd_from_remote_memory
1774   (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
1775    int (*target_read_memory) (bfd_vma, char *, int));
1776
1777 /* SH ELF specific routine.  */
1778
1779 extern bfd_boolean _sh_elf_set_mach_from_flags
1780   (bfd *);
1781
1782 /* This is the condition under which finish_dynamic_symbol will be called.
1783    If our finish_dynamic_symbol isn't called, we'll need to do something
1784    about initializing any .plt and .got entries in relocate_section.  */
1785 #define WILL_CALL_FINISH_DYNAMIC_SYMBOL(DYN, SHARED, H) \
1786   ((DYN)                                                                \
1787    && ((SHARED) || !(H)->forced_local)                                  \
1788    && ((H)->dynindx != -1 || (H)->forced_local))
1789
1790 /* This macro is to avoid lots of duplicated code in the body
1791    of xxx_relocate_section() in the various elfxx-xxxx.c files.  */
1792 #define RELOC_FOR_GLOBAL_SYMBOL(info, input_bfd, input_section, rel,    \
1793                                 r_symndx, symtab_hdr, sym_hashes,       \
1794                                 h, sec, relocation,                     \
1795                                 unresolved_reloc, warned)               \
1796   do                                                                    \
1797     {                                                                   \
1798       /* It seems this can happen with erroneous or unsupported         \
1799          input (mixing a.out and elf in an archive, for example.)  */   \
1800       if (sym_hashes == NULL)                                           \
1801         return FALSE;                                                   \
1802                                                                         \
1803       h = sym_hashes[r_symndx - symtab_hdr->sh_info];                   \
1804                                                                         \
1805       while (h->root.type == bfd_link_hash_indirect                     \
1806              || h->root.type == bfd_link_hash_warning)                  \
1807         h = (struct elf_link_hash_entry *) h->root.u.i.link;            \
1808                                                                         \
1809       warned = FALSE;                                                   \
1810       unresolved_reloc = FALSE;                                         \
1811       relocation = 0;                                                   \
1812       if (h->root.type == bfd_link_hash_defined                         \
1813           || h->root.type == bfd_link_hash_defweak)                     \
1814         {                                                               \
1815           sec = h->root.u.def.section;                                  \
1816           if (sec == NULL                                               \
1817               || sec->output_section == NULL)                           \
1818             /* Set a flag that will be cleared later if we find a       \
1819                relocation value for this symbol.  output_section        \
1820                is typically NULL for symbols satisfied by a shared      \
1821                library.  */                                             \
1822             unresolved_reloc = TRUE;                                    \
1823           else                                                          \
1824             relocation = (h->root.u.def.value                           \
1825                           + sec->output_section->vma                    \
1826                           + sec->output_offset);                        \
1827         }                                                               \
1828       else if (h->root.type == bfd_link_hash_undefweak)                 \
1829         ;                                                               \
1830       else if (info->unresolved_syms_in_objects == RM_IGNORE            \
1831                && ELF_ST_VISIBILITY (h->other) == STV_DEFAULT)          \
1832         ;                                                               \
1833       else                                                              \
1834         {                                                               \
1835           bfd_boolean err;                                              \
1836           err = (info->unresolved_syms_in_objects == RM_GENERATE_ERROR  \
1837                  || ELF_ST_VISIBILITY (h->other) != STV_DEFAULT);       \
1838           if (!info->callbacks->undefined_symbol (info,                 \
1839                                                   h->root.root.string,  \
1840                                                   input_bfd,            \
1841                                                   input_section,        \
1842                                                   rel->r_offset, err))  \
1843             return FALSE;                                               \
1844           warned = TRUE;                                                \
1845         }                                                               \
1846     }                                                                   \
1847   while (0)
1848
1849 #endif /* _LIBELF_H_ */