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