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