1 /* BFD back-end data structures for ELF files.
2 Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
3 2002, 2003, 2004 Free Software Foundation, Inc.
4 Written by Cygnus Support.
6 This file is part of BFD, the Binary File Descriptor library.
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.
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.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
25 #include "elf/common.h"
26 #include "elf/internal.h"
27 #include "elf/external.h"
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)
35 /* If size isn't specified as 64 or 32, NAME macro should fail. */
38 #define NAME(x, y) x ## 64 ## _ ## y
41 #define NAME(x, y) x ## 32 ## _ ## y
46 #define NAME(x, y) x ## NOSIZE ## _ ## y
49 #define ElfNAME(X) NAME(Elf,X)
50 #define elfNAME(X) NAME(elf,X)
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. */
61 /* ELF symbol information. */
62 Elf_Internal_Sym internal_elf_sym;
63 /* Backend specific information. */
66 unsigned int hppa_arg_reloc;
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;
79 struct elf_strtab_hash;
83 /* ELF linker hash table entries. */
85 struct elf_link_hash_entry
87 struct bfd_link_hash_entry root;
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. */
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.
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. */
107 /* String table index in .dynstr if this is a dynamic symbol. */
108 unsigned long dynstr_index;
110 /* Hash value of the name computed using the ELF hash function. */
111 unsigned long elf_hash_value;
113 /* If this is a weak defined symbol from a dynamic object, this
114 field points to a defined symbol with the same value, if there is
115 one. Otherwise it is NULL. */
116 struct elf_link_hash_entry *weakdef;
118 /* Version information. */
121 /* This field is used for a symbol which is not defined in a
122 regular object. It points to the version information read in
123 from the dynamic object. */
124 Elf_Internal_Verdef *verdef;
125 /* This field is used for a symbol which is defined in a regular
126 object. It is set up in size_dynamic_sections. It points to
127 the version information we should write out for this symbol. */
128 struct bfd_elf_version_tree *vertree;
131 /* Virtual table entry use information. This array is nominally of size
132 size/sizeof(target_void_pointer), though we have to be able to assume
133 and track a size while the symbol is still undefined. It is indexed
134 via offset/sizeof(target_void_pointer). */
135 size_t vtable_entries_size;
136 bfd_boolean *vtable_entries_used;
138 /* Virtual table derivation info. */
139 struct elf_link_hash_entry *vtable_parent;
141 /* If this symbol requires an entry in the global offset table, the
142 processor specific backend uses this field to track usage and
143 final offset. Two schemes are supported: The first assumes that
144 a symbol may only have one GOT entry, and uses REFCOUNT until
145 size_dynamic_sections, at which point the contents of the .got is
146 fixed. Afterward, if OFFSET is -1, then the symbol does not
147 require a global offset table entry. The second scheme allows
148 multiple GOT entries per symbol, managed via a linked list
149 pointed to by GLIST. */
152 bfd_signed_vma refcount;
154 struct got_entry *glist;
155 struct plt_entry *plist;
158 /* Same, but tracks a procedure linkage table entry. */
159 union gotplt_union plt;
164 /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.). */
167 /* Symbol st_other value, symbol visibility. */
170 /* Some flags; legal values follow. */
171 unsigned short elf_link_hash_flags;
172 /* Symbol is referenced by a non-shared object. */
173 #define ELF_LINK_HASH_REF_REGULAR 01
174 /* Symbol is defined by a non-shared object. */
175 #define ELF_LINK_HASH_DEF_REGULAR 02
176 /* Symbol is referenced by a shared object. */
177 #define ELF_LINK_HASH_REF_DYNAMIC 04
178 /* Symbol is defined by a shared object. */
179 #define ELF_LINK_HASH_DEF_DYNAMIC 010
180 /* Symbol has a non-weak reference from a non-shared object. */
181 #define ELF_LINK_HASH_REF_REGULAR_NONWEAK 020
182 /* Dynamic symbol has been adjustd. */
183 #define ELF_LINK_HASH_DYNAMIC_ADJUSTED 040
184 /* Symbol needs a copy reloc. */
185 #define ELF_LINK_HASH_NEEDS_COPY 0100
186 /* Symbol needs a procedure linkage table entry. */
187 #define ELF_LINK_HASH_NEEDS_PLT 0200
188 /* Symbol appears in a non-ELF input file. */
189 #define ELF_LINK_NON_ELF 0400
190 /* Symbol should be marked as hidden in the version information. */
191 #define ELF_LINK_HIDDEN 01000
192 /* Symbol was forced to local scope due to a version script file. */
193 #define ELF_LINK_FORCED_LOCAL 02000
194 /* Symbol was marked during garbage collection. */
195 #define ELF_LINK_HASH_MARK 04000
196 /* Symbol is referenced by a non-GOT/non-PLT relocation. This is
197 not currently set by all the backends. */
198 #define ELF_LINK_NON_GOT_REF 010000
199 /* Symbol has a definition in a shared object. */
200 #define ELF_LINK_DYNAMIC_DEF 020000
201 /* Symbol is weak in all shared objects. */
202 #define ELF_LINK_DYNAMIC_WEAK 040000
203 /* Symbol is referenced with a relocation where C/C++ pointer equality
205 #define ELF_LINK_POINTER_EQUALITY_NEEDED 0100000
208 /* Will references to this symbol always reference the symbol
209 in this object? STV_PROTECTED is excluded from the visibility test
210 here so that function pointer comparisons work properly. Since
211 function symbols not defined in an app are set to their .plt entry,
212 it's necessary for shared libs to also reference the .plt even
213 though the symbol is really local to the shared lib. */
214 #define SYMBOL_REFERENCES_LOCAL(INFO, H) \
215 _bfd_elf_symbol_refs_local_p (H, INFO, 0)
217 /* Will _calls_ to this symbol always call the version in this object? */
218 #define SYMBOL_CALLS_LOCAL(INFO, H) \
219 _bfd_elf_symbol_refs_local_p (H, INFO, 1)
221 /* Records local symbols to be emitted in the dynamic symbol table. */
223 struct elf_link_local_dynamic_entry
225 struct elf_link_local_dynamic_entry *next;
227 /* The input bfd this symbol came from. */
230 /* The index of the local symbol being copied. */
233 /* The index in the outgoing dynamic symbol table. */
236 /* A copy of the input symbol. */
237 Elf_Internal_Sym isym;
240 struct elf_link_loaded_list
242 struct elf_link_loaded_list *next;
246 /* Structures used by the eh_frame optimization code. */
255 struct cie_header hdr;
256 unsigned char version;
257 unsigned char augmentation[20];
258 unsigned int code_align;
260 unsigned int ra_column;
261 unsigned int augmentation_size;
262 struct elf_link_hash_entry *personality;
263 unsigned char per_encoding;
264 unsigned char lsda_encoding;
265 unsigned char fde_encoding;
266 unsigned char initial_insn_length;
267 unsigned char make_relative;
268 unsigned char make_lsda_relative;
269 unsigned char initial_instructions[50];
277 unsigned int new_offset;
278 unsigned char fde_encoding;
279 unsigned char lsda_encoding;
280 unsigned char lsda_offset;
281 unsigned char cie : 1;
282 unsigned char removed : 1;
283 unsigned char make_relative : 1;
284 unsigned char make_lsda_relative : 1;
285 unsigned char per_encoding_relative : 1;
288 struct eh_frame_sec_info
291 unsigned int alloced;
292 struct eh_cie_fde entry[1];
295 struct eh_frame_array_ent
301 struct eh_frame_hdr_info
304 asection *last_cie_sec;
306 unsigned int last_cie_offset;
307 unsigned int fde_count, array_count;
308 struct eh_frame_array_ent *array;
309 /* TRUE if .eh_frame_hdr should contain the sorted search table.
310 We build it if we successfully read all .eh_frame input sections
311 and recognize them. */
315 /* ELF linker hash table. */
317 struct elf_link_hash_table
319 struct bfd_link_hash_table root;
321 /* Whether we have created the special dynamic sections required
322 when linking against or generating a shared object. */
323 bfd_boolean dynamic_sections_created;
325 /* The BFD used to hold special sections created by the linker.
326 This will be the first BFD found which requires these sections to
330 /* The value to use when initialising got.refcount/offset and
331 plt.refcount/offset in an elf_link_hash_entry. Set to zero when
332 the values are refcounts. Set to init_offset in
333 size_dynamic_sections when the values may be offsets. */
334 union gotplt_union init_refcount;
336 /* The value to use for got.refcount/offset and plt.refcount/offset
337 when the values may be offsets. Normally (bfd_vma) -1. */
338 union gotplt_union init_offset;
340 /* The number of symbols found in the link which must be put into
341 the .dynsym section. */
342 bfd_size_type dynsymcount;
344 /* The string table of dynamic symbols, which becomes the .dynstr
346 struct elf_strtab_hash *dynstr;
348 /* The number of buckets in the hash table in the .hash section.
349 This is based on the number of dynamic symbols. */
350 bfd_size_type bucketcount;
352 /* A linked list of DT_NEEDED names found in dynamic objects
353 included in the link. */
354 struct bfd_link_needed_list *needed;
356 /* The _GLOBAL_OFFSET_TABLE_ symbol. */
357 struct elf_link_hash_entry *hgot;
359 /* A pointer to information used to link stabs in sections. */
362 /* A pointer to information used to merge SEC_MERGE sections. */
365 /* Used by eh_frame code when editing .eh_frame. */
366 struct eh_frame_hdr_info eh_info;
368 /* A linked list of local symbols to be added to .dynsym. */
369 struct elf_link_local_dynamic_entry *dynlocal;
371 /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic
372 objects included in the link. */
373 struct bfd_link_needed_list *runpath;
375 /* Cached first output tls section and size of PT_TLS segment. */
377 bfd_size_type tls_size;
379 /* A linked list of BFD's loaded in the link. */
380 struct elf_link_loaded_list *loaded;
383 /* Look up an entry in an ELF linker hash table. */
385 #define elf_link_hash_lookup(table, string, create, copy, follow) \
386 ((struct elf_link_hash_entry *) \
387 bfd_link_hash_lookup (&(table)->root, (string), (create), \
390 /* Traverse an ELF linker hash table. */
392 #define elf_link_hash_traverse(table, func, info) \
393 (bfd_link_hash_traverse \
395 (bfd_boolean (*) (struct bfd_link_hash_entry *, void *)) (func), \
398 /* Get the ELF linker hash table from a link_info structure. */
400 #define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash))
402 /* Returns TRUE if the hash table is a struct elf_link_hash_table. */
403 #define is_elf_hash_table(htab) \
404 (((struct bfd_link_hash_table *) (htab))->type == bfd_link_elf_hash_table)
406 /* Used by bfd_section_from_r_symndx to cache a small number of local
407 symbol to section mappings. */
408 #define LOCAL_SYM_CACHE_SIZE 32
412 unsigned long indx[LOCAL_SYM_CACHE_SIZE];
413 asection *sec[LOCAL_SYM_CACHE_SIZE];
416 /* Constant information held for an ELF backend. */
418 struct elf_size_info {
419 unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
420 unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
422 /* The size of entries in the .hash section. */
423 unsigned char sizeof_hash_entry;
425 /* The number of internal relocations to allocate per external
427 unsigned char int_rels_per_ext_rel;
428 /* We use some fixed size arrays. This should be large enough to
429 handle all back-ends. */
430 #define MAX_INT_RELS_PER_EXT_REL 3
432 unsigned char arch_size, log_file_align;
433 unsigned char elfclass, ev_current;
434 int (*write_out_phdrs)
435 (bfd *, const Elf_Internal_Phdr *, unsigned int);
437 (*write_shdrs_and_ehdr) (bfd *);
439 (bfd *, asection *, void *);
440 void (*swap_symbol_in)
441 (bfd *, const void *, const void *, Elf_Internal_Sym *);
442 void (*swap_symbol_out)
443 (bfd *, const Elf_Internal_Sym *, void *, void *);
444 bfd_boolean (*slurp_reloc_table)
445 (bfd *, asection *, asymbol **, bfd_boolean);
446 long (*slurp_symbol_table)
447 (bfd *, asymbol **, bfd_boolean);
449 (bfd *, const void *, Elf_Internal_Dyn *);
451 (bfd *, const Elf_Internal_Dyn *, void *);
453 /* This function is called to swap in a REL relocation. If an
454 external relocation corresponds to more than one internal
455 relocation, then all relocations are swapped in at once. */
456 void (*swap_reloc_in)
457 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
459 /* This function is called to swap out a REL relocation. */
460 void (*swap_reloc_out)
461 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
463 /* This function is called to swap in a RELA relocation. If an
464 external relocation corresponds to more than one internal
465 relocation, then all relocations are swapped in at once. */
466 void (*swap_reloca_in)
467 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
469 /* This function is called to swap out a RELA relocation. */
470 void (*swap_reloca_out)
471 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
474 #define elf_symbol_from(ABFD,S) \
475 (((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
476 && (S)->the_bfd->tdata.elf_obj_data != 0) \
477 ? (elf_symbol_type *) (S) \
480 enum elf_reloc_type_class {
482 reloc_class_relative,
487 struct elf_reloc_cookie
489 Elf_Internal_Rela *rels, *rel, *relend;
490 Elf_Internal_Sym *locsyms;
494 struct elf_link_hash_entry **sym_hashes;
496 bfd_boolean bad_symtab;
499 /* The level of IRIX compatibility we're striving for. */
507 /* Mapping of ELF section names and types. */
508 struct bfd_elf_special_section
512 /* 0 means name must match PREFIX exactly.
513 -1 means name must start with PREFIX followed by an arbitrary string.
514 -2 means name must match PREFIX exactly or consist of PREFIX followed
515 by a dot then anything.
516 > 0 means name must start with the first PREFIX_LENGTH chars of
517 PREFIX and finish with the last SUFFIX_LENGTH chars of PREFIX. */
523 struct elf_backend_data
525 /* The architecture for this backend. */
526 enum bfd_architecture arch;
528 /* The ELF machine code (EM_xxxx) for this backend. */
529 int elf_machine_code;
531 /* The maximum page size for this backend. */
534 /* A function to translate an ELF RELA relocation to a BFD arelent
536 void (*elf_info_to_howto)
537 (bfd *, arelent *, Elf_Internal_Rela *);
539 /* A function to translate an ELF REL relocation to a BFD arelent
541 void (*elf_info_to_howto_rel)
542 (bfd *, arelent *, Elf_Internal_Rela *);
544 /* A function to determine whether a symbol is global when
545 partitioning the symbol table into local and global symbols.
546 This should be NULL for most targets, in which case the correct
547 thing will be done. MIPS ELF, at least on the Irix 5, has
548 special requirements. */
549 bfd_boolean (*elf_backend_sym_is_global)
552 /* The remaining functions are hooks which are called only if they
555 /* A function to permit a backend specific check on whether a
556 particular BFD format is relevant for an object file, and to
557 permit the backend to set any global information it wishes. When
558 this is called elf_elfheader is set, but anything else should be
559 used with caution. If this returns FALSE, the check_format
560 routine will return a bfd_error_wrong_format error. */
561 bfd_boolean (*elf_backend_object_p)
564 /* A function to do additional symbol processing when reading the
565 ELF symbol table. This is where any processor-specific special
566 section indices are handled. */
567 void (*elf_backend_symbol_processing)
570 /* A function to do additional symbol processing after reading the
571 entire ELF symbol table. */
572 bfd_boolean (*elf_backend_symbol_table_processing)
573 (bfd *, elf_symbol_type *, unsigned int);
575 /* A function to set the type of the info field. Processor-specific
576 types should be handled here. */
577 int (*elf_backend_get_symbol_type)
578 (Elf_Internal_Sym *, int);
580 /* Return true if local section symbols should have a non-null st_name.
581 NULL implies false. */
582 bfd_boolean (*elf_backend_name_local_section_symbols)
585 /* A function to do additional processing on the ELF section header
586 just before writing it out. This is used to set the flags and
587 type fields for some sections, or to actually write out data for
589 bfd_boolean (*elf_backend_section_processing)
590 (bfd *, Elf_Internal_Shdr *);
592 /* A function to handle unusual section types when creating BFD
593 sections from ELF sections. */
594 bfd_boolean (*elf_backend_section_from_shdr)
595 (bfd *, Elf_Internal_Shdr *, const char *);
597 /* A function to convert machine dependent section header flags to
598 BFD internal section header flags. */
599 bfd_boolean (*elf_backend_section_flags)
600 (flagword *, const Elf_Internal_Shdr *);
602 /* A function to handle unusual program segment types when creating BFD
603 sections from ELF program segments. */
604 bfd_boolean (*elf_backend_section_from_phdr)
605 (bfd *, Elf_Internal_Phdr *, int);
607 /* A function to set up the ELF section header for a BFD section in
608 preparation for writing it out. This is where the flags and type
609 fields are set for unusual sections. */
610 bfd_boolean (*elf_backend_fake_sections)
611 (bfd *, Elf_Internal_Shdr *, asection *);
613 /* A function to get the ELF section index for a BFD section. If
614 this returns TRUE, the section was found. If it is a normal ELF
615 section, *RETVAL should be left unchanged. If it is not a normal
616 ELF section *RETVAL should be set to the SHN_xxxx index. */
617 bfd_boolean (*elf_backend_section_from_bfd_section)
618 (bfd *, asection *, int *retval);
620 /* If this field is not NULL, it is called by the add_symbols phase
621 of a link just before adding a symbol to the global linker hash
622 table. It may modify any of the fields as it wishes. If *NAME
623 is set to NULL, the symbol will be skipped rather than being
624 added to the hash table. This function is responsible for
625 handling all processor dependent symbol bindings and section
626 indices, and must set at least *FLAGS and *SEC for each processor
627 dependent case; failure to do so will cause a link error. */
628 bfd_boolean (*elf_add_symbol_hook)
629 (bfd *abfd, struct bfd_link_info *info, Elf_Internal_Sym *,
630 const char **name, flagword *flags, asection **sec, bfd_vma *value);
632 /* If this field is not NULL, it is called by the elf_link_output_sym
633 phase of a link for each symbol which will appear in the object file. */
634 bfd_boolean (*elf_backend_link_output_symbol_hook)
635 (struct bfd_link_info *info, const char *, Elf_Internal_Sym *,
636 asection *, struct elf_link_hash_entry *);
638 /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
639 linker the first time it encounters a dynamic object in the link.
640 This function must create any sections required for dynamic
641 linking. The ABFD argument is a dynamic object. The .interp,
642 .dynamic, .dynsym, .dynstr, and .hash functions have already been
643 created, and this function may modify the section flags if
644 desired. This function will normally create the .got and .plt
645 sections, but different backends have different requirements. */
646 bfd_boolean (*elf_backend_create_dynamic_sections)
647 (bfd *abfd, struct bfd_link_info *info);
649 /* The CHECK_RELOCS function is called by the add_symbols phase of
650 the ELF backend linker. It is called once for each section with
651 relocs of an object file, just after the symbols for the object
652 file have been added to the global linker hash table. The
653 function must look through the relocs and do any special handling
654 required. This generally means allocating space in the global
655 offset table, and perhaps allocating space for a reloc. The
656 relocs are always passed as Rela structures; if the section
657 actually uses Rel structures, the r_addend field will always be
659 bfd_boolean (*check_relocs)
660 (bfd *abfd, struct bfd_link_info *info, asection *o,
661 const Elf_Internal_Rela *relocs);
663 /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
664 linker for every symbol which is defined by a dynamic object and
665 referenced by a regular object. This is called after all the
666 input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
667 function has been called. The hash table entry should be
668 bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
669 defined in a section from a dynamic object. Dynamic object
670 sections are not included in the final link, and this function is
671 responsible for changing the value to something which the rest of
672 the link can deal with. This will normally involve adding an
673 entry to the .plt or .got or some such section, and setting the
674 symbol to point to that. */
675 bfd_boolean (*elf_backend_adjust_dynamic_symbol)
676 (struct bfd_link_info *info, struct elf_link_hash_entry *h);
678 /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
679 after all the linker input files have been seen but before the
680 section sizes have been set. This is called after
681 ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS. */
682 bfd_boolean (*elf_backend_always_size_sections)
683 (bfd *output_bfd, struct bfd_link_info *info);
685 /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
686 linker after all the linker input files have been seen but before
687 the sections sizes have been set. This is called after
688 ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
689 It is only called when linking against a dynamic object. It must
690 set the sizes of the dynamic sections, and may fill in their
691 contents as well. The generic ELF linker can handle the .dynsym,
692 .dynstr and .hash sections. This function must handle the
693 .interp section and any sections created by the
694 CREATE_DYNAMIC_SECTIONS entry point. */
695 bfd_boolean (*elf_backend_size_dynamic_sections)
696 (bfd *output_bfd, struct bfd_link_info *info);
698 /* The RELOCATE_SECTION function is called by the ELF backend linker
699 to handle the relocations for a section.
701 The relocs are always passed as Rela structures; if the section
702 actually uses Rel structures, the r_addend field will always be
705 This function is responsible for adjust the section contents as
706 necessary, and (if using Rela relocs and generating a
707 relocatable output file) adjusting the reloc addend as
710 This function does not have to worry about setting the reloc
711 address or the reloc symbol index.
713 LOCAL_SYMS is a pointer to the swapped in local symbols.
715 LOCAL_SECTIONS is an array giving the section in the input file
716 corresponding to the st_shndx field of each local symbol.
718 The global hash table entry for the global symbols can be found
719 via elf_sym_hashes (input_bfd).
721 When generating relocatable output, this function must handle
722 STB_LOCAL/STT_SECTION symbols specially. The output symbol is
723 going to be the section symbol corresponding to the output
724 section, which means that the addend must be adjusted
726 bfd_boolean (*elf_backend_relocate_section)
727 (bfd *output_bfd, struct bfd_link_info *info, bfd *input_bfd,
728 asection *input_section, bfd_byte *contents, Elf_Internal_Rela *relocs,
729 Elf_Internal_Sym *local_syms, asection **local_sections);
731 /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
732 linker just before it writes a symbol out to the .dynsym section.
733 The processor backend may make any required adjustment to the
734 symbol. It may also take the opportunity to set contents of the
735 dynamic sections. Note that FINISH_DYNAMIC_SYMBOL is called on
736 all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
737 on those symbols which are defined by a dynamic object. */
738 bfd_boolean (*elf_backend_finish_dynamic_symbol)
739 (bfd *output_bfd, struct bfd_link_info *info,
740 struct elf_link_hash_entry *h, Elf_Internal_Sym *sym);
742 /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
743 linker just before it writes all the dynamic sections out to the
744 output file. The FINISH_DYNAMIC_SYMBOL will have been called on
745 all dynamic symbols. */
746 bfd_boolean (*elf_backend_finish_dynamic_sections)
747 (bfd *output_bfd, struct bfd_link_info *info);
749 /* A function to do any beginning processing needed for the ELF file
750 before building the ELF headers and computing file positions. */
751 void (*elf_backend_begin_write_processing)
752 (bfd *, struct bfd_link_info *);
754 /* A function to do any final processing needed for the ELF file
755 before writing it out. The LINKER argument is TRUE if this BFD
756 was created by the ELF backend linker. */
757 void (*elf_backend_final_write_processing)
758 (bfd *, bfd_boolean linker);
760 /* This function is called by get_program_header_size. It should
761 return the number of additional program segments which this BFD
762 will need. It should return -1 on error. */
763 int (*elf_backend_additional_program_headers)
766 /* This function is called to modify an existing segment map in a
767 backend specific fashion. */
768 bfd_boolean (*elf_backend_modify_segment_map)
769 (bfd *, struct bfd_link_info *);
771 /* This function is called during section gc to discover the section a
772 particular relocation refers to. */
773 asection * (*gc_mark_hook)
774 (asection *sec, struct bfd_link_info *, Elf_Internal_Rela *,
775 struct elf_link_hash_entry *h, Elf_Internal_Sym *);
777 /* This function, if defined, is called during the sweep phase of gc
778 in order that a backend might update any data structures it might
780 bfd_boolean (*gc_sweep_hook)
781 (bfd *abfd, struct bfd_link_info *info, asection *o,
782 const Elf_Internal_Rela *relocs);
784 /* This function, if defined, is called after the ELF headers have
785 been created. This allows for things like the OS and ABI versions
787 void (*elf_backend_post_process_headers)
788 (bfd *, struct bfd_link_info *);
790 /* This function, if defined, prints a symbol to file and returns the
791 name of the symbol to be printed. It should return NULL to fall
792 back to default symbol printing. */
793 const char *(*elf_backend_print_symbol_all)
794 (bfd *, void *, asymbol *);
796 /* This function, if defined, is called after all local symbols and
797 global symbols converted to locals are emitted into the symtab
798 section. It allows the backend to emit special global symbols
799 not handled in the hash table. */
800 bfd_boolean (*elf_backend_output_arch_syms)
801 (bfd *, struct bfd_link_info *, void *,
802 bfd_boolean (*) (void *, const char *, Elf_Internal_Sym *, asection *,
803 struct elf_link_hash_entry *));
805 /* Copy any information related to dynamic linking from a pre-existing
806 symbol to a newly created symbol. Also called to copy flags and
807 other back-end info to a weakdef, in which case the symbol is not
808 newly created and plt/got refcounts and dynamic indices should not
810 void (*elf_backend_copy_indirect_symbol)
811 (const struct elf_backend_data *, struct elf_link_hash_entry *,
812 struct elf_link_hash_entry *);
814 /* Modify any information related to dynamic linking such that the
815 symbol is not exported. */
816 void (*elf_backend_hide_symbol)
817 (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
819 /* Merge the backend specific symbol attribute. */
820 void (*elf_backend_merge_symbol_attribute)
821 (struct elf_link_hash_entry *, const Elf_Internal_Sym *, bfd_boolean,
824 /* Emit relocations. Overrides default routine for emitting relocs,
825 except during a relocatable link, or if all relocs are being emitted. */
826 bfd_boolean (*elf_backend_emit_relocs)
827 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *);
829 /* Count relocations. Not called for relocatable links
830 or if all relocs are being preserved in the output. */
831 unsigned int (*elf_backend_count_relocs)
832 (asection *, Elf_Internal_Rela *);
834 /* This function, if defined, is called when an NT_PRSTATUS note is found
836 bfd_boolean (*elf_backend_grok_prstatus)
837 (bfd *, Elf_Internal_Note *);
839 /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
840 note is found in a core file. */
841 bfd_boolean (*elf_backend_grok_psinfo)
842 (bfd *, Elf_Internal_Note *);
844 /* Functions to print VMAs. Special code to handle 64 bit ELF files. */
845 void (* elf_backend_sprintf_vma)
846 (bfd *, char *, bfd_vma);
847 void (* elf_backend_fprintf_vma)
848 (bfd *, void *, bfd_vma);
850 /* This function returns class of a reloc type. */
851 enum elf_reloc_type_class (*elf_backend_reloc_type_class)
852 (const Elf_Internal_Rela *);
854 /* This function, if defined, removes information about discarded functions
855 from other sections which mention them. */
856 bfd_boolean (*elf_backend_discard_info)
857 (bfd *, struct elf_reloc_cookie *, struct bfd_link_info *);
859 /* This function, if defined, signals that the function above has removed
860 the discarded relocations for this section. */
861 bfd_boolean (*elf_backend_ignore_discarded_relocs)
864 /* These functions tell elf-eh-frame whether to attempt to turn
865 absolute or lsda encodings into pc-relative ones. The default
866 definition enables these transformations. */
867 bfd_boolean (*elf_backend_can_make_relative_eh_frame)
868 (bfd *, struct bfd_link_info *, asection *);
869 bfd_boolean (*elf_backend_can_make_lsda_relative_eh_frame)
870 (bfd *, struct bfd_link_info *, asection *);
872 /* This function returns an encoding after computing the encoded
873 value (and storing it in ENCODED) for the given OFFSET into OSEC,
874 to be stored in at LOC_OFFSET into the LOC_SEC input section.
875 The default definition chooses a 32-bit PC-relative encoding. */
876 bfd_byte (*elf_backend_encode_eh_address)
877 (bfd *abfd, struct bfd_link_info *info,
878 asection *osec, bfd_vma offset,
879 asection *loc_sec, bfd_vma loc_offset,
882 /* This function, if defined, may write out the given section.
883 Returns TRUE if it did so and FALSE if the caller should. */
884 bfd_boolean (*elf_backend_write_section)
885 (bfd *, asection *, bfd_byte *);
887 /* The level of IRIX compatibility we're striving for.
888 MIPS ELF specific function. */
889 irix_compat_t (*elf_backend_mips_irix_compat)
892 reloc_howto_type *(*elf_backend_mips_rtype_to_howto)
893 (unsigned int, bfd_boolean);
895 /* The swapping table to use when dealing with ECOFF information.
896 Used for the MIPS ELF .mdebug section. */
897 const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
899 /* This function implements `bfd_elf_bfd_from_remote_memory';
900 see elf.c, elfcode.h. */
901 bfd *(*elf_backend_bfd_from_remote_memory)
902 (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
903 int (*target_read_memory) (bfd_vma vma, char *myaddr, int len));
905 /* This function is used by `_bfd_elf_get_synthetic_symtab';
907 bfd_vma (*plt_sym_val) (bfd_vma, const asection *, const arelent *);
909 /* Name of the PLT relocation section. */
910 const char *relplt_name;
912 /* Alternate EM_xxxx machine codes for this backend. */
913 int elf_machine_alt1;
914 int elf_machine_alt2;
916 const struct elf_size_info *s;
918 /* An array of target specific special section map. */
919 const struct bfd_elf_special_section *special_sections;
921 /* offset of the _GLOBAL_OFFSET_TABLE_ symbol from the start of the
923 bfd_vma got_symbol_offset;
925 /* The size in bytes of the header for the GOT. This includes the
926 so-called reserved entries on some systems. */
927 bfd_vma got_header_size;
929 /* This is TRUE if the linker should act like collect and gather
930 global constructors and destructors by name. This is TRUE for
931 MIPS ELF because the Irix 5 tools can not handle the .init
933 unsigned collect : 1;
935 /* This is TRUE if the linker should ignore changes to the type of a
936 symbol. This is TRUE for MIPS ELF because some Irix 5 objects
937 record undefined functions as STT_OBJECT although the definitions
939 unsigned type_change_ok : 1;
941 /* Whether the backend may use REL relocations. (Some backends use
942 both REL and RELA relocations, and this flag is set for those
944 unsigned may_use_rel_p : 1;
946 /* Whether the backend may use RELA relocations. (Some backends use
947 both REL and RELA relocations, and this flag is set for those
949 unsigned may_use_rela_p : 1;
951 /* Whether the default relocation type is RELA. If a backend with
952 this flag set wants REL relocations for a particular section,
953 it must note that explicitly. Similarly, if this flag is clear,
954 and the backend wants RELA relocations for a particular
956 unsigned default_use_rela_p : 1;
958 /* Set if RELA relocations for a relocatable link can be handled by
959 generic code. Backends that set this flag need do nothing in the
960 backend relocate_section routine for relocatable linking. */
961 unsigned rela_normal : 1;
963 /* TRUE if addresses "naturally" sign extend. This is used when
964 swapping in from Elf32 when BFD64. */
965 unsigned sign_extend_vma : 1;
967 unsigned want_got_plt : 1;
968 unsigned plt_readonly : 1;
969 unsigned want_plt_sym : 1;
970 unsigned plt_not_loaded : 1;
971 unsigned plt_alignment : 4;
972 unsigned can_gc_sections : 1;
973 unsigned can_refcount : 1;
974 unsigned want_got_sym : 1;
975 unsigned want_dynbss : 1;
976 /* Targets which do not support physical addressing often require
977 that the p_paddr field in the section header to be set to zero.
978 This field indicates whether this behavior is required. */
979 unsigned want_p_paddr_set_to_zero : 1;
982 /* Information stored for each BFD section in an ELF file. This
983 structure is allocated by elf_new_section_hook. */
985 struct bfd_elf_section_data
987 /* The ELF header for this section. */
988 Elf_Internal_Shdr this_hdr;
990 /* The ELF header for the reloc section associated with this
992 Elf_Internal_Shdr rel_hdr;
994 /* If there is a second reloc section associated with this section,
995 as can happen on Irix 6, this field points to the header. */
996 Elf_Internal_Shdr *rel_hdr2;
998 /* The number of relocations currently assigned to REL_HDR. */
999 unsigned int rel_count;
1001 /* The number of relocations currently assigned to REL_HDR2. */
1002 unsigned int rel_count2;
1004 /* The ELF section number of this section. Only used for an output
1008 /* The ELF section number of the reloc section indicated by
1009 REL_HDR if any. Only used for an output file. */
1012 /* The ELF section number of the reloc section indicated by
1013 REL_HDR2 if any. Only used for an output file. */
1016 /* Used by the backend linker when generating a shared library to
1017 record the dynamic symbol index for a section symbol
1018 corresponding to this section. A value of 0 means that there is
1019 no dynamic symbol for this section. */
1022 /* Used by the backend linker to store the symbol hash table entries
1023 associated with relocs against global symbols. */
1024 struct elf_link_hash_entry **rel_hashes;
1026 /* A pointer to the swapped relocs. If the section uses REL relocs,
1027 rather than RELA, all the r_addend fields will be zero. This
1028 pointer may be NULL. It is used by the backend linker. */
1029 Elf_Internal_Rela *relocs;
1031 /* A pointer to a linked list tracking dynamic relocs copied for
1035 /* A pointer to the bfd section used for dynamic relocs. */
1039 /* Group name, if this section is a member of a group. */
1042 /* Group signature sym, if this is the SHT_GROUP section. */
1043 struct bfd_symbol *id;
1046 /* A linked list of sections in the group. Circular when used by
1048 asection *next_in_group;
1050 /* A pointer used for various section optimizations. */
1054 #define elf_section_data(sec) ((struct bfd_elf_section_data*)sec->used_by_bfd)
1055 #define elf_section_type(sec) (elf_section_data(sec)->this_hdr.sh_type)
1056 #define elf_section_flags(sec) (elf_section_data(sec)->this_hdr.sh_flags)
1057 #define elf_group_name(sec) (elf_section_data(sec)->group.name)
1058 #define elf_group_id(sec) (elf_section_data(sec)->group.id)
1059 #define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group)
1061 /* Return TRUE if section has been discarded. */
1062 #define elf_discarded_section(sec) \
1063 (!bfd_is_abs_section (sec) \
1064 && bfd_is_abs_section ((sec)->output_section) \
1065 && sec->sec_info_type != ELF_INFO_TYPE_MERGE \
1066 && sec->sec_info_type != ELF_INFO_TYPE_JUST_SYMS)
1068 #define get_elf_backend_data(abfd) \
1069 ((const struct elf_backend_data *) (abfd)->xvec->backend_data)
1071 /* This struct is used to pass information to routines called via
1072 elf_link_hash_traverse which must return failure. */
1074 struct elf_info_failed
1077 struct bfd_link_info *info;
1078 struct bfd_elf_version_tree *verdefs;
1081 /* This structure is used to pass information to
1082 _bfd_elf_link_assign_sym_version. */
1084 struct elf_assign_sym_version_info
1088 /* General link information. */
1089 struct bfd_link_info *info;
1091 struct bfd_elf_version_tree *verdefs;
1092 /* Whether we had a failure. */
1096 /* This structure is used to pass information to
1097 _bfd_elf_link_find_version_dependencies. */
1099 struct elf_find_verdep_info
1103 /* General link information. */
1104 struct bfd_link_info *info;
1105 /* The number of dependencies. */
1107 /* Whether we had a failure. */
1111 /* Some private data is stashed away for future use using the tdata pointer
1112 in the bfd structure. */
1114 struct elf_obj_tdata
1116 Elf_Internal_Ehdr elf_header[1]; /* Actual data, but ref like ptr */
1117 Elf_Internal_Shdr **elf_sect_ptr;
1118 Elf_Internal_Phdr *phdr;
1119 struct elf_segment_map *segment_map;
1120 struct elf_strtab_hash *strtab_ptr;
1123 unsigned int num_elf_sections; /* elf_sect_ptr size */
1124 int num_section_syms;
1125 asymbol **section_syms; /* STT_SECTION symbols for each section */
1126 Elf_Internal_Shdr symtab_hdr;
1127 Elf_Internal_Shdr shstrtab_hdr;
1128 Elf_Internal_Shdr strtab_hdr;
1129 Elf_Internal_Shdr dynsymtab_hdr;
1130 Elf_Internal_Shdr dynstrtab_hdr;
1131 Elf_Internal_Shdr dynversym_hdr;
1132 Elf_Internal_Shdr dynverref_hdr;
1133 Elf_Internal_Shdr dynverdef_hdr;
1134 Elf_Internal_Shdr symtab_shndx_hdr;
1135 unsigned int symtab_section, shstrtab_section;
1136 unsigned int strtab_section, dynsymtab_section;
1137 unsigned int symtab_shndx_section;
1138 unsigned int dynversym_section, dynverdef_section, dynverref_section;
1139 file_ptr next_file_pos;
1140 bfd_vma gp; /* The gp value */
1141 unsigned int gp_size; /* The gp size */
1143 /* Information grabbed from an elf core file. */
1150 /* A mapping from external symbols to entries in the linker hash
1151 table, used when linking. This is indexed by the symbol index
1152 minus the sh_info field of the symbol table header. */
1153 struct elf_link_hash_entry **sym_hashes;
1155 /* Track usage and final offsets of GOT entries for local symbols.
1156 This array is indexed by symbol index. Elements are used
1157 identically to "got" in struct elf_link_hash_entry. */
1160 bfd_signed_vma *refcounts;
1162 struct got_entry **ents;
1165 /* The linker ELF emulation code needs to let the backend ELF linker
1166 know what filename should be used for a dynamic object if the
1167 dynamic object is found using a search. The emulation code then
1168 sometimes needs to know what name was actually used. Until the
1169 file has been added to the linker symbol table, this field holds
1170 the name the linker wants. After it has been added, it holds the
1171 name actually used, which will be the DT_SONAME entry if there is
1173 const char *dt_name;
1175 /* Records the result of `get_program_header_size'. */
1176 bfd_size_type program_header_size;
1178 /* Used by find_nearest_line entry point. */
1181 /* Used by MIPS ELF find_nearest_line entry point. The structure
1182 could be included directly in this one, but there's no point to
1183 wasting the memory just for the infrequently called
1184 find_nearest_line. */
1185 struct mips_elf_find_line *find_line_info;
1187 /* A place to stash dwarf1 info for this bfd. */
1188 struct dwarf1_debug *dwarf1_find_line_info;
1190 /* A place to stash dwarf2 info for this bfd. */
1191 void *dwarf2_find_line_info;
1193 /* An array of stub sections indexed by symbol number, used by the
1194 MIPS ELF linker. FIXME: We should figure out some way to only
1195 include this field for a MIPS ELF target. */
1196 asection **local_stubs;
1198 /* Used to determine if PT_GNU_EH_FRAME segment header should be
1200 asection *eh_frame_hdr;
1202 Elf_Internal_Shdr **group_sect_ptr;
1205 /* Number of symbol version definitions we are about to emit. */
1206 unsigned int cverdefs;
1208 /* Number of symbol version references we are about to emit. */
1209 unsigned int cverrefs;
1211 /* Segment flags for the PT_GNU_STACK segment. */
1212 unsigned int stack_flags;
1214 /* Symbol version definitions in external objects. */
1215 Elf_Internal_Verdef *verdef;
1217 /* Symbol version references to external objects. */
1218 Elf_Internal_Verneed *verref;
1220 /* The Irix 5 support uses two virtual sections, which represent
1221 text/data symbols defined in dynamic objects. */
1222 asymbol *elf_data_symbol;
1223 asymbol *elf_text_symbol;
1224 asection *elf_data_section;
1225 asection *elf_text_section;
1227 /* Whether a dyanmic object was specified normally on the linker
1228 command line, or was specified when --as-needed was in effect,
1229 or was found via a DT_NEEDED entry. */
1230 enum dynamic_lib_link_class dyn_lib_class;
1232 /* This is set to TRUE if the object was created by the backend
1236 /* Irix 5 often screws up the symbol table, sorting local symbols
1237 after global symbols. This flag is set if the symbol table in
1238 this BFD appears to be screwed up. If it is, we ignore the
1239 sh_info field in the symbol table header, and always read all the
1241 bfd_boolean bad_symtab;
1243 /* Used to determine if the e_flags field has been initialized */
1244 bfd_boolean flags_init;
1247 #define elf_tdata(bfd) ((bfd) -> tdata.elf_obj_data)
1248 #define elf_elfheader(bfd) (elf_tdata(bfd) -> elf_header)
1249 #define elf_elfsections(bfd) (elf_tdata(bfd) -> elf_sect_ptr)
1250 #define elf_numsections(bfd) (elf_tdata(bfd) -> num_elf_sections)
1251 #define elf_shstrtab(bfd) (elf_tdata(bfd) -> strtab_ptr)
1252 #define elf_onesymtab(bfd) (elf_tdata(bfd) -> symtab_section)
1253 #define elf_symtab_shndx(bfd) (elf_tdata(bfd) -> symtab_shndx_section)
1254 #define elf_dynsymtab(bfd) (elf_tdata(bfd) -> dynsymtab_section)
1255 #define elf_dynversym(bfd) (elf_tdata(bfd) -> dynversym_section)
1256 #define elf_dynverdef(bfd) (elf_tdata(bfd) -> dynverdef_section)
1257 #define elf_dynverref(bfd) (elf_tdata(bfd) -> dynverref_section)
1258 #define elf_num_locals(bfd) (elf_tdata(bfd) -> num_locals)
1259 #define elf_num_globals(bfd) (elf_tdata(bfd) -> num_globals)
1260 #define elf_section_syms(bfd) (elf_tdata(bfd) -> section_syms)
1261 #define elf_num_section_syms(bfd) (elf_tdata(bfd) -> num_section_syms)
1262 #define core_prpsinfo(bfd) (elf_tdata(bfd) -> prpsinfo)
1263 #define core_prstatus(bfd) (elf_tdata(bfd) -> prstatus)
1264 #define elf_gp(bfd) (elf_tdata(bfd) -> gp)
1265 #define elf_gp_size(bfd) (elf_tdata(bfd) -> gp_size)
1266 #define elf_sym_hashes(bfd) (elf_tdata(bfd) -> sym_hashes)
1267 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
1268 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
1269 #define elf_local_got_ents(bfd) (elf_tdata(bfd) -> local_got.ents)
1270 #define elf_dt_name(bfd) (elf_tdata(bfd) -> dt_name)
1271 #define elf_dyn_lib_class(bfd) (elf_tdata(bfd) -> dyn_lib_class)
1272 #define elf_bad_symtab(bfd) (elf_tdata(bfd) -> bad_symtab)
1273 #define elf_flags_init(bfd) (elf_tdata(bfd) -> flags_init)
1275 extern void _bfd_elf_swap_verdef_in
1276 (bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *);
1277 extern void _bfd_elf_swap_verdef_out
1278 (bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *);
1279 extern void _bfd_elf_swap_verdaux_in
1280 (bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *);
1281 extern void _bfd_elf_swap_verdaux_out
1282 (bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *);
1283 extern void _bfd_elf_swap_verneed_in
1284 (bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *);
1285 extern void _bfd_elf_swap_verneed_out
1286 (bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *);
1287 extern void _bfd_elf_swap_vernaux_in
1288 (bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *);
1289 extern void _bfd_elf_swap_vernaux_out
1290 (bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *);
1291 extern void _bfd_elf_swap_versym_in
1292 (bfd *, const Elf_External_Versym *, Elf_Internal_Versym *);
1293 extern void _bfd_elf_swap_versym_out
1294 (bfd *, const Elf_Internal_Versym *, Elf_External_Versym *);
1296 extern int _bfd_elf_section_from_bfd_section
1297 (bfd *, asection *);
1298 extern char *bfd_elf_string_from_elf_section
1299 (bfd *, unsigned, unsigned);
1300 extern char *bfd_elf_get_str_section
1302 extern Elf_Internal_Sym *bfd_elf_get_elf_syms
1303 (bfd *, Elf_Internal_Shdr *, size_t, size_t, Elf_Internal_Sym *, void *,
1304 Elf_External_Sym_Shndx *);
1305 extern const char *bfd_elf_local_sym_name
1306 (bfd *, Elf_Internal_Sym *);
1308 extern bfd_boolean _bfd_elf_copy_private_bfd_data
1310 extern bfd_boolean _bfd_elf_print_private_bfd_data
1312 extern void bfd_elf_print_symbol
1313 (bfd *, void *, asymbol *, bfd_print_symbol_type);
1315 #define elf_string_from_elf_strtab(abfd, strindex) \
1316 bfd_elf_string_from_elf_section (abfd, elf_elfheader(abfd)->e_shstrndx, \
1319 extern void _bfd_elf_sprintf_vma
1320 (bfd *, char *, bfd_vma);
1321 extern void _bfd_elf_fprintf_vma
1322 (bfd *, void *, bfd_vma);
1324 extern bfd_byte _bfd_elf_encode_eh_address
1325 (bfd *abfd, struct bfd_link_info *info, asection *osec, bfd_vma offset,
1326 asection *loc_sec, bfd_vma loc_offset, bfd_vma *encoded);
1327 extern bfd_boolean _bfd_elf_can_make_relative
1328 (bfd *input_bfd, struct bfd_link_info *info, asection *eh_frame_section);
1330 extern enum elf_reloc_type_class _bfd_elf_reloc_type_class
1331 (const Elf_Internal_Rela *);
1332 extern bfd_vma _bfd_elf_rela_local_sym
1333 (bfd *, Elf_Internal_Sym *, asection **, Elf_Internal_Rela *);
1334 extern bfd_vma _bfd_elf_rel_local_sym
1335 (bfd *, Elf_Internal_Sym *, asection **, bfd_vma);
1336 extern bfd_vma _bfd_elf_section_offset
1337 (bfd *, struct bfd_link_info *, asection *, bfd_vma);
1339 extern unsigned long bfd_elf_hash
1342 extern bfd_reloc_status_type bfd_elf_generic_reloc
1343 (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
1344 extern bfd_boolean bfd_elf_mkobject
1346 extern bfd_boolean bfd_elf_mkcorefile
1348 extern Elf_Internal_Shdr *bfd_elf_find_section
1350 extern bfd_boolean _bfd_elf_make_section_from_shdr
1351 (bfd *, Elf_Internal_Shdr *, const char *);
1352 extern bfd_boolean _bfd_elf_make_section_from_phdr
1353 (bfd *, Elf_Internal_Phdr *, int, const char *);
1354 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
1355 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
1356 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
1358 extern void _bfd_elf_link_hash_copy_indirect
1359 (const struct elf_backend_data *, struct elf_link_hash_entry *,
1360 struct elf_link_hash_entry *);
1361 extern void _bfd_elf_link_hash_hide_symbol
1362 (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
1363 extern bfd_boolean _bfd_elf_link_hash_table_init
1364 (struct elf_link_hash_table *, bfd *,
1365 struct bfd_hash_entry *(*)
1366 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
1367 extern bfd_boolean _bfd_elf_slurp_version_tables
1369 extern bfd_boolean _bfd_elf_merge_sections
1370 (bfd *, struct bfd_link_info *);
1371 extern bfd_boolean bfd_elf_discard_group
1372 (bfd *, struct bfd_section *);
1373 extern void bfd_elf_set_group_contents
1374 (bfd *, asection *, void *);
1375 extern void _bfd_elf_link_just_syms
1376 (asection *, struct bfd_link_info *);
1377 extern bfd_boolean _bfd_elf_copy_private_symbol_data
1378 (bfd *, asymbol *, bfd *, asymbol *);
1379 extern bfd_boolean _bfd_elf_copy_private_section_data
1380 (bfd *, asection *, bfd *, asection *);
1381 extern bfd_boolean _bfd_elf_write_object_contents
1383 extern bfd_boolean _bfd_elf_write_corefile_contents
1385 extern bfd_boolean _bfd_elf_set_section_contents
1386 (bfd *, sec_ptr, const void *, file_ptr, bfd_size_type);
1387 extern long _bfd_elf_get_symtab_upper_bound
1389 extern long _bfd_elf_canonicalize_symtab
1390 (bfd *, asymbol **);
1391 extern long _bfd_elf_get_dynamic_symtab_upper_bound
1393 extern long _bfd_elf_canonicalize_dynamic_symtab
1394 (bfd *, asymbol **);
1395 extern long _bfd_elf_get_synthetic_symtab
1396 (bfd *, asymbol **, asymbol **);
1397 extern long _bfd_elf_get_reloc_upper_bound
1399 extern long _bfd_elf_canonicalize_reloc
1400 (bfd *, sec_ptr, arelent **, asymbol **);
1401 extern long _bfd_elf_get_dynamic_reloc_upper_bound
1403 extern long _bfd_elf_canonicalize_dynamic_reloc
1404 (bfd *, arelent **, asymbol **);
1405 extern asymbol *_bfd_elf_make_empty_symbol
1407 extern void _bfd_elf_get_symbol_info
1408 (bfd *, asymbol *, symbol_info *);
1409 extern bfd_boolean _bfd_elf_is_local_label_name
1410 (bfd *, const char *);
1411 extern alent *_bfd_elf_get_lineno
1413 extern bfd_boolean _bfd_elf_set_arch_mach
1414 (bfd *, enum bfd_architecture, unsigned long);
1415 extern bfd_boolean _bfd_elf_find_nearest_line
1416 (bfd *, asection *, asymbol **, bfd_vma, const char **, const char **,
1418 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
1419 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
1420 extern int _bfd_elf_sizeof_headers
1421 (bfd *, bfd_boolean);
1422 extern bfd_boolean _bfd_elf_new_section_hook
1423 (bfd *, asection *);
1424 extern bfd_boolean _bfd_elf_init_reloc_shdr
1425 (bfd *, Elf_Internal_Shdr *, asection *, bfd_boolean);
1426 extern const struct bfd_elf_special_section *_bfd_elf_get_sec_type_attr
1427 (bfd *, const char *);
1429 /* If the target doesn't have reloc handling written yet: */
1430 extern void _bfd_elf_no_info_to_howto
1431 (bfd *, arelent *, Elf_Internal_Rela *);
1433 extern bfd_boolean bfd_section_from_shdr
1434 (bfd *, unsigned int shindex);
1435 extern bfd_boolean bfd_section_from_phdr
1436 (bfd *, Elf_Internal_Phdr *, int);
1438 extern int _bfd_elf_symbol_from_bfd_symbol
1439 (bfd *, asymbol **);
1441 extern asection *bfd_section_from_r_symndx
1442 (bfd *, struct sym_sec_cache *, asection *, unsigned long);
1443 extern asection *bfd_section_from_elf_index
1444 (bfd *, unsigned int);
1445 extern struct bfd_strtab_hash *_bfd_elf_stringtab_init
1448 extern struct elf_strtab_hash * _bfd_elf_strtab_init
1450 extern void _bfd_elf_strtab_free
1451 (struct elf_strtab_hash *);
1452 extern bfd_size_type _bfd_elf_strtab_add
1453 (struct elf_strtab_hash *, const char *, bfd_boolean);
1454 extern void _bfd_elf_strtab_addref
1455 (struct elf_strtab_hash *, bfd_size_type);
1456 extern void _bfd_elf_strtab_delref
1457 (struct elf_strtab_hash *, bfd_size_type);
1458 extern void _bfd_elf_strtab_clear_all_refs
1459 (struct elf_strtab_hash *);
1460 extern bfd_size_type _bfd_elf_strtab_size
1461 (struct elf_strtab_hash *);
1462 extern bfd_size_type _bfd_elf_strtab_offset
1463 (struct elf_strtab_hash *, bfd_size_type);
1464 extern bfd_boolean _bfd_elf_strtab_emit
1465 (bfd *, struct elf_strtab_hash *);
1466 extern void _bfd_elf_strtab_finalize
1467 (struct elf_strtab_hash *);
1469 extern bfd_boolean _bfd_elf_discard_section_eh_frame
1470 (bfd *, struct bfd_link_info *, asection *,
1471 bfd_boolean (*) (bfd_vma, void *), struct elf_reloc_cookie *);
1472 extern bfd_boolean _bfd_elf_discard_section_eh_frame_hdr
1473 (bfd *, struct bfd_link_info *);
1474 extern bfd_vma _bfd_elf_eh_frame_section_offset
1475 (bfd *, asection *, bfd_vma);
1476 extern bfd_boolean _bfd_elf_write_section_eh_frame
1477 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
1478 extern bfd_boolean _bfd_elf_write_section_eh_frame_hdr
1479 (bfd *, struct bfd_link_info *);
1480 extern bfd_boolean _bfd_elf_maybe_strip_eh_frame_hdr
1481 (struct bfd_link_info *);
1483 extern bfd_boolean _bfd_elf_merge_symbol
1484 (bfd *, struct bfd_link_info *, const char *, Elf_Internal_Sym *,
1485 asection **, bfd_vma *, struct elf_link_hash_entry **, bfd_boolean *,
1486 bfd_boolean *, bfd_boolean *, bfd_boolean *);
1488 extern bfd_boolean _bfd_elf_add_default_symbol
1489 (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *,
1490 const char *, Elf_Internal_Sym *, asection **, bfd_vma *,
1491 bfd_boolean *, bfd_boolean);
1493 extern bfd_boolean _bfd_elf_export_symbol
1494 (struct elf_link_hash_entry *, void *);
1496 extern bfd_boolean _bfd_elf_link_find_version_dependencies
1497 (struct elf_link_hash_entry *, void *);
1499 extern bfd_boolean _bfd_elf_link_assign_sym_version
1500 (struct elf_link_hash_entry *, void *);
1502 extern long _bfd_elf_link_lookup_local_dynindx
1503 (struct bfd_link_info *, bfd *, long);
1504 extern bfd_boolean _bfd_elf_compute_section_file_positions
1505 (bfd *, struct bfd_link_info *);
1506 extern void _bfd_elf_assign_file_positions_for_relocs
1508 extern file_ptr _bfd_elf_assign_file_position_for_section
1509 (Elf_Internal_Shdr *, file_ptr, bfd_boolean);
1511 extern bfd_boolean _bfd_elf_validate_reloc
1514 extern bfd_boolean _bfd_elf_link_create_dynamic_sections
1515 (bfd *, struct bfd_link_info *);
1516 extern bfd_boolean _bfd_elf_create_dynamic_sections
1517 (bfd *, struct bfd_link_info *);
1518 extern bfd_boolean _bfd_elf_create_got_section
1519 (bfd *, struct bfd_link_info *);
1520 extern unsigned long _bfd_elf_link_renumber_dynsyms
1521 (bfd *, struct bfd_link_info *);
1523 extern bfd_boolean _bfd_elfcore_make_pseudosection
1524 (bfd *, char *, size_t, ufile_ptr);
1525 extern char *_bfd_elfcore_strndup
1526 (bfd *, char *, size_t);
1528 extern Elf_Internal_Rela *_bfd_elf_link_read_relocs
1529 (bfd *, asection *, void *, Elf_Internal_Rela *, bfd_boolean);
1531 extern bfd_boolean _bfd_elf_link_size_reloc_section
1532 (bfd *, Elf_Internal_Shdr *, asection *);
1534 extern bfd_boolean _bfd_elf_link_output_relocs
1535 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *);
1537 extern bfd_boolean _bfd_elf_fix_symbol_flags
1538 (struct elf_link_hash_entry *, struct elf_info_failed *);
1540 extern bfd_boolean _bfd_elf_adjust_dynamic_symbol
1541 (struct elf_link_hash_entry *, void *);
1543 extern bfd_boolean _bfd_elf_link_sec_merge_syms
1544 (struct elf_link_hash_entry *, void *);
1546 extern bfd_boolean _bfd_elf_dynamic_symbol_p
1547 (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
1549 extern bfd_boolean _bfd_elf_symbol_refs_local_p
1550 (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
1552 extern const bfd_target *bfd_elf32_object_p
1554 extern const bfd_target *bfd_elf32_core_file_p
1556 extern char *bfd_elf32_core_file_failing_command
1558 extern int bfd_elf32_core_file_failing_signal
1560 extern bfd_boolean bfd_elf32_core_file_matches_executable_p
1563 extern void bfd_elf32_swap_symbol_in
1564 (bfd *, const void *, const void *, Elf_Internal_Sym *);
1565 extern void bfd_elf32_swap_symbol_out
1566 (bfd *, const Elf_Internal_Sym *, void *, void *);
1567 extern void bfd_elf32_swap_reloc_in
1568 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1569 extern void bfd_elf32_swap_reloc_out
1570 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1571 extern void bfd_elf32_swap_reloca_in
1572 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1573 extern void bfd_elf32_swap_reloca_out
1574 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1575 extern void bfd_elf32_swap_phdr_in
1576 (bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *);
1577 extern void bfd_elf32_swap_phdr_out
1578 (bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *);
1579 extern void bfd_elf32_swap_dyn_in
1580 (bfd *, const void *, Elf_Internal_Dyn *);
1581 extern void bfd_elf32_swap_dyn_out
1582 (bfd *, const Elf_Internal_Dyn *, void *);
1583 extern long bfd_elf32_slurp_symbol_table
1584 (bfd *, asymbol **, bfd_boolean);
1585 extern bfd_boolean bfd_elf32_write_shdrs_and_ehdr
1587 extern int bfd_elf32_write_out_phdrs
1588 (bfd *, const Elf_Internal_Phdr *, unsigned int);
1589 extern void bfd_elf32_write_relocs
1590 (bfd *, asection *, void *);
1591 extern bfd_boolean bfd_elf32_slurp_reloc_table
1592 (bfd *, asection *, asymbol **, bfd_boolean);
1594 extern const bfd_target *bfd_elf64_object_p
1596 extern const bfd_target *bfd_elf64_core_file_p
1598 extern char *bfd_elf64_core_file_failing_command
1600 extern int bfd_elf64_core_file_failing_signal
1602 extern bfd_boolean bfd_elf64_core_file_matches_executable_p
1605 extern void bfd_elf64_swap_symbol_in
1606 (bfd *, const void *, const void *, Elf_Internal_Sym *);
1607 extern void bfd_elf64_swap_symbol_out
1608 (bfd *, const Elf_Internal_Sym *, void *, void *);
1609 extern void bfd_elf64_swap_reloc_in
1610 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1611 extern void bfd_elf64_swap_reloc_out
1612 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1613 extern void bfd_elf64_swap_reloca_in
1614 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
1615 extern void bfd_elf64_swap_reloca_out
1616 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
1617 extern void bfd_elf64_swap_phdr_in
1618 (bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *);
1619 extern void bfd_elf64_swap_phdr_out
1620 (bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *);
1621 extern void bfd_elf64_swap_dyn_in
1622 (bfd *, const void *, Elf_Internal_Dyn *);
1623 extern void bfd_elf64_swap_dyn_out
1624 (bfd *, const Elf_Internal_Dyn *, void *);
1625 extern long bfd_elf64_slurp_symbol_table
1626 (bfd *, asymbol **, bfd_boolean);
1627 extern bfd_boolean bfd_elf64_write_shdrs_and_ehdr
1629 extern int bfd_elf64_write_out_phdrs
1630 (bfd *, const Elf_Internal_Phdr *, unsigned int);
1631 extern void bfd_elf64_write_relocs
1632 (bfd *, asection *, void *);
1633 extern bfd_boolean bfd_elf64_slurp_reloc_table
1634 (bfd *, asection *, asymbol **, bfd_boolean);
1636 extern bfd_boolean bfd_elf_link_add_symbols
1637 (bfd *, struct bfd_link_info *);
1638 extern bfd_boolean _bfd_elf_add_dynamic_entry
1639 (struct bfd_link_info *, bfd_vma, bfd_vma);
1641 extern bfd_boolean bfd_elf_link_record_dynamic_symbol
1642 (struct bfd_link_info *, struct elf_link_hash_entry *);
1644 extern int bfd_elf_link_record_local_dynamic_symbol
1645 (struct bfd_link_info *, bfd *, long);
1647 extern bfd_boolean _bfd_elf_close_and_cleanup
1649 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
1650 (bfd *, arelent *, struct bfd_symbol *, void *,
1651 asection *, bfd *, char **);
1653 extern bfd_boolean bfd_elf_final_link
1654 (bfd *, struct bfd_link_info *);
1656 extern bfd_boolean bfd_elf_gc_sections
1657 (bfd *, struct bfd_link_info *);
1659 extern bfd_boolean bfd_elf_gc_record_vtinherit
1660 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
1662 extern bfd_boolean bfd_elf_gc_record_vtentry
1663 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
1665 extern bfd_boolean bfd_elf_gc_common_finalize_got_offsets
1666 (bfd *, struct bfd_link_info *);
1668 extern bfd_boolean bfd_elf_gc_common_final_link
1669 (bfd *, struct bfd_link_info *);
1671 extern bfd_boolean bfd_elf_reloc_symbol_deleted_p
1674 /* Exported interface for writing elf corefile notes. */
1675 extern char *elfcore_write_note
1676 (bfd *, char *, int *, const char *, int, const void *, int);
1677 extern char *elfcore_write_prpsinfo
1678 (bfd *, char *, int *, const char *, const char *);
1679 extern char *elfcore_write_prstatus
1680 (bfd *, char *, int *, long, int, const void *);
1681 extern char * elfcore_write_pstatus
1682 (bfd *, char *, int *, long, int, const void *);
1683 extern char *elfcore_write_prfpreg
1684 (bfd *, char *, int *, const void *, int);
1685 extern char *elfcore_write_prxfpreg
1686 (bfd *, char *, int *, const void *, int);
1687 extern char *elfcore_write_lwpstatus
1688 (bfd *, char *, int *, long, int, const void *);
1690 extern bfd *_bfd_elf32_bfd_from_remote_memory
1691 (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
1692 int (*target_read_memory) (bfd_vma, char *, int));
1693 extern bfd *_bfd_elf64_bfd_from_remote_memory
1694 (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
1695 int (*target_read_memory) (bfd_vma, char *, int));
1697 /* SH ELF specific routine. */
1699 extern bfd_boolean _sh_elf_set_mach_from_flags
1702 /* This is the condition under which finish_dynamic_symbol will be called.
1703 If our finish_dynamic_symbol isn't called, we'll need to do something
1704 about initializing any .plt and .got entries in relocate_section. */
1705 #define WILL_CALL_FINISH_DYNAMIC_SYMBOL(DYN, SHARED, H) \
1708 || ((H)->elf_link_hash_flags & ELF_LINK_FORCED_LOCAL) == 0) \
1709 && ((H)->dynindx != -1 \
1710 || ((H)->elf_link_hash_flags & ELF_LINK_FORCED_LOCAL) != 0))
1712 /* This macro is to avoid lots of duplicated code in the body
1713 of xxx_relocate_section() in the various elfxx-xxxx.c files. */
1714 #define RELOC_FOR_GLOBAL_SYMBOL(info, input_bfd, input_section, rel, \
1715 r_symndx, symtab_hdr, sym_hashes, \
1716 h, sec, relocation, \
1717 unresolved_reloc, warned) \
1720 /* It seems this can happen with erroneous or unsupported \
1721 input (mixing a.out and elf in an archive, for example.) */ \
1722 if (sym_hashes == NULL) \
1725 h = sym_hashes[r_symndx - symtab_hdr->sh_info]; \
1727 while (h->root.type == bfd_link_hash_indirect \
1728 || h->root.type == bfd_link_hash_warning) \
1729 h = (struct elf_link_hash_entry *) h->root.u.i.link; \
1732 unresolved_reloc = FALSE; \
1734 if (h->root.type == bfd_link_hash_defined \
1735 || h->root.type == bfd_link_hash_defweak) \
1737 sec = h->root.u.def.section; \
1739 || sec->output_section == NULL) \
1740 /* Set a flag that will be cleared later if we find a \
1741 relocation value for this symbol. output_section \
1742 is typically NULL for symbols satisfied by a shared \
1744 unresolved_reloc = TRUE; \
1746 relocation = (h->root.u.def.value \
1747 + sec->output_section->vma \
1748 + sec->output_offset); \
1750 else if (h->root.type == bfd_link_hash_undefweak) \
1752 else if (info->unresolved_syms_in_objects == RM_IGNORE \
1753 && ELF_ST_VISIBILITY (h->other) == STV_DEFAULT) \
1758 err = (info->unresolved_syms_in_objects == RM_GENERATE_ERROR \
1759 || ELF_ST_VISIBILITY (h->other) != STV_DEFAULT); \
1760 if (!info->callbacks->undefined_symbol (info, \
1761 h->root.root.string, \
1764 rel->r_offset, err)) \
1771 #endif /* _LIBELF_H_ */