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