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