readelf: Support RELR in -S and -d and output
[binutils-gdb.git] / bfd / elf-bfd.h
blob91bb1b2b8bdd48e05cca93f20f1f309cadef2808
1 /* BFD back-end data structures for ELF files.
2 Copyright (C) 1992-2021 Free Software Foundation, Inc.
3 Written by Cygnus Support.
5 This file is part of BFD, the Binary File Descriptor library.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
20 MA 02110-1301, USA. */
22 #ifndef _LIBELF_H_
23 #define _LIBELF_H_ 1
25 #include <stdlib.h>
27 #include "elf/common.h"
28 #include "elf/external.h"
29 #include "elf/internal.h"
30 #include "bfdlink.h"
32 #ifndef ENABLE_CHECKING
33 #define ENABLE_CHECKING 0
34 #endif
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
40 /* The number of entries in a section is its size divided by the size
41 of a single entry. This is normally only applicable to reloc and
42 symbol table sections.
43 PR 9934: It is possible to have relocations that do not refer to
44 symbols, thus it is also possible to have a relocation section in
45 an object file, but no symbol table. */
46 #define NUM_SHDR_ENTRIES(shdr) ((shdr)->sh_entsize > 0 ? (shdr)->sh_size / (shdr)->sh_entsize : 0)
48 /* If size isn't specified as 64 or 32, NAME macro should fail. */
49 #ifndef NAME
50 #if ARCH_SIZE == 64
51 #define NAME(x, y) x ## 64 ## _ ## y
52 #endif
53 #if ARCH_SIZE == 32
54 #define NAME(x, y) x ## 32 ## _ ## y
55 #endif
56 #endif
58 #ifndef NAME
59 #define NAME(x, y) x ## NOSIZE ## _ ## y
60 #endif
62 #define ElfNAME(X) NAME(Elf,X)
63 #define elfNAME(X) NAME(elf,X)
65 /* Information held for an ELF symbol. The first field is the
66 corresponding asymbol. Every symbol is an ELF file is actually a
67 pointer to this structure, although it is often handled as a
68 pointer to an asymbol. */
70 typedef struct
72 /* The BFD symbol. */
73 asymbol symbol;
74 /* ELF symbol information. */
75 Elf_Internal_Sym internal_elf_sym;
76 /* Backend specific information. */
77 union
79 unsigned int hppa_arg_reloc;
80 void *mips_extr;
81 void *any;
83 tc_data;
85 /* Version information. This is from an Elf_Internal_Versym
86 structure in a SHT_GNU_versym section. It is zero if there is no
87 version information. */
88 unsigned short version;
90 } elf_symbol_type;
92 struct elf_strtab_hash;
93 struct got_entry;
94 struct plt_entry;
96 union gotplt_union
98 bfd_signed_vma refcount;
99 bfd_vma offset;
100 struct got_entry *glist;
101 struct plt_entry *plist;
104 struct elf_link_virtual_table_entry
106 /* Virtual table entry use information. This array is nominally of size
107 size/sizeof(target_void_pointer), though we have to be able to assume
108 and track a size while the symbol is still undefined. It is indexed
109 via offset/sizeof(target_void_pointer). */
110 size_t size;
111 bool *used;
113 /* Virtual table derivation info. */
114 struct elf_link_hash_entry *parent;
117 /* ELF symbol version. */
118 enum elf_symbol_version
120 unknown = 0,
121 unversioned,
122 versioned,
123 versioned_hidden
126 /* ELF linker hash table entries. */
128 struct elf_link_hash_entry
130 struct bfd_link_hash_entry root;
132 /* Symbol index in output file. This is initialized to -1. It is
133 set to -2 if the symbol is used by a reloc. It is set to -3 if
134 this symbol is defined in a discarded section. */
135 long indx;
137 /* Symbol index as a dynamic symbol. Initialized to -1, and remains
138 -1 if this is not a dynamic symbol. */
139 /* ??? Note that this is consistently used as a synonym for tests
140 against whether we can perform various simplifying transformations
141 to the code. (E.g. changing a pc-relative jump to a PLT entry
142 into a pc-relative jump to the target function.) That test, which
143 is often relatively complex, and someplaces wrong or incomplete,
144 should really be replaced by a predicate in elflink.c.
146 End result: this field -1 does not indicate that the symbol is
147 not in the dynamic symbol table, but rather that the symbol is
148 not visible outside this DSO. */
149 long dynindx;
151 /* If this symbol requires an entry in the global offset table, the
152 processor specific backend uses this field to track usage and
153 final offset. Two schemes are supported: The first assumes that
154 a symbol may only have one GOT entry, and uses REFCOUNT until
155 size_dynamic_sections, at which point the contents of the .got is
156 fixed. Afterward, if OFFSET is -1, then the symbol does not
157 require a global offset table entry. The second scheme allows
158 multiple GOT entries per symbol, managed via a linked list
159 pointed to by GLIST. */
160 union gotplt_union got;
162 /* Same, but tracks a procedure linkage table entry. */
163 union gotplt_union plt;
165 /* Symbol size. NB: All fields starting from here are cleared by
166 _bfd_elf_link_hash_newfunc. */
167 bfd_size_type size;
169 /* Track dynamic relocs copied for this symbol. */
170 struct elf_dyn_relocs *dyn_relocs;
172 /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.). */
173 unsigned int type : 8;
175 /* Symbol st_other value, symbol visibility. */
176 unsigned int other : 8;
178 /* The symbol's st_target_internal value (see Elf_Internal_Sym). */
179 unsigned int target_internal : 8;
181 /* Symbol is referenced by a non-shared object (other than the object
182 in which it is defined). */
183 unsigned int ref_regular : 1;
184 /* Symbol is defined by a non-shared object. */
185 unsigned int def_regular : 1;
186 /* Symbol is referenced by a shared object. */
187 unsigned int ref_dynamic : 1;
188 /* Symbol is defined by a shared object. */
189 unsigned int def_dynamic : 1;
190 /* Symbol has a non-weak reference from a non-shared object (other than
191 the object in which it is defined). */
192 unsigned int ref_regular_nonweak : 1;
193 /* Symbol has a non-weak reference from a LTO IR object file. */
194 unsigned int ref_ir_nonweak : 1;
195 /* Dynamic symbol has been adjustd. */
196 unsigned int dynamic_adjusted : 1;
197 /* Symbol needs a copy reloc. */
198 unsigned int needs_copy : 1;
199 /* Symbol needs a procedure linkage table entry. */
200 unsigned int needs_plt : 1;
201 /* Symbol appears in a non-ELF input file. */
202 unsigned int non_elf : 1;
203 /* Symbol version information. */
204 ENUM_BITFIELD (elf_symbol_version) versioned : 2;
205 /* Symbol was forced to local scope due to a version script file. */
206 unsigned int forced_local : 1;
207 /* Symbol was forced to be dynamic due to a version script file. */
208 unsigned int dynamic : 1;
209 /* Symbol was marked during garbage collection. */
210 unsigned int mark : 1;
211 /* Symbol is referenced by a non-GOT/non-PLT relocation. This is
212 not currently set by all the backends. */
213 unsigned int non_got_ref : 1;
214 /* Symbol has a definition in a shared object.
215 FIXME: There is no real need for this field if def_dynamic is never
216 cleared and all places that test def_dynamic also test def_regular. */
217 unsigned int dynamic_def : 1;
218 /* Symbol has a non-weak reference from a shared object. */
219 unsigned int ref_dynamic_nonweak : 1;
220 /* Symbol is referenced with a relocation where C/C++ pointer equality
221 matters. */
222 unsigned int pointer_equality_needed : 1;
223 /* Symbol is a unique global symbol. */
224 unsigned int unique_global : 1;
225 /* Symbol is defined by a shared library with non-default visibility
226 in a read/write section. */
227 unsigned int protected_def : 1;
228 /* Symbol is __start_SECNAME or __stop_SECNAME to mark section
229 SECNAME. */
230 unsigned int start_stop : 1;
231 /* Symbol is or was a weak defined symbol from a dynamic object with
232 a strong defined symbol alias. U.ALIAS points to a list of aliases,
233 the definition having is_weakalias clear. */
234 unsigned int is_weakalias : 1;
236 /* String table index in .dynstr if this is a dynamic symbol. */
237 unsigned long dynstr_index;
239 union
241 /* Points to a circular list of non-function symbol aliases. */
242 struct elf_link_hash_entry *alias;
244 /* Hash value of the name computed using the ELF hash function.
245 Used part way through size_dynamic_sections, after we've finished
246 with aliases. */
247 unsigned long elf_hash_value;
248 } u;
250 /* Version information. */
251 union
253 /* This field is used for a symbol which is not defined in a
254 regular object. It points to the version information read in
255 from the dynamic object. */
256 Elf_Internal_Verdef *verdef;
257 /* This field is used for a symbol which is defined in a regular
258 object. It is set up in size_dynamic_sections. It points to
259 the version information we should write out for this symbol. */
260 struct bfd_elf_version_tree *vertree;
261 } verinfo;
263 union
265 /* For __start_SECNAME and __stop_SECNAME symbols, record the first
266 input section whose section name is SECNAME. */
267 asection *start_stop_section;
269 /* Vtable information. */
270 struct elf_link_virtual_table_entry *vtable;
271 } u2;
274 /* Return the strong definition for a weak symbol with aliases. */
276 static inline struct elf_link_hash_entry *
277 weakdef (struct elf_link_hash_entry *h)
279 while (h->is_weakalias)
280 h = h->u.alias;
281 return h;
284 /* Will references to this symbol always reference the symbol
285 in this object? */
286 #define SYMBOL_REFERENCES_LOCAL(INFO, H) \
287 _bfd_elf_symbol_refs_local_p (H, INFO, 0)
289 /* Will _calls_ to this symbol always call the version in this object? */
290 #define SYMBOL_CALLS_LOCAL(INFO, H) \
291 _bfd_elf_symbol_refs_local_p (H, INFO, 1)
293 /* Whether an undefined weak symbol should resolve to its link-time
294 value, even in PIC or PIE objects. */
295 #define UNDEFWEAK_NO_DYNAMIC_RELOC(INFO, H) \
296 ((H)->root.type == bfd_link_hash_undefweak \
297 && (ELF_ST_VISIBILITY ((H)->other) != STV_DEFAULT \
298 || (INFO)->dynamic_undefined_weak == 0))
300 /* Common symbols that are turned into definitions don't have the
301 DEF_REGULAR flag set, so they might appear to be undefined.
302 Symbols defined in linker scripts also don't have DEF_REGULAR set. */
303 #define ELF_COMMON_DEF_P(H) \
304 (!(H)->def_regular \
305 && !(H)->def_dynamic \
306 && (H)->root.type == bfd_link_hash_defined)
308 /* Records local symbols to be emitted in the dynamic symbol table. */
310 struct elf_link_local_dynamic_entry
312 struct elf_link_local_dynamic_entry *next;
314 /* The input bfd this symbol came from. */
315 bfd *input_bfd;
317 /* The index of the local symbol being copied. */
318 long input_indx;
320 /* The index in the outgoing dynamic symbol table. */
321 long dynindx;
323 /* A copy of the input symbol. */
324 Elf_Internal_Sym isym;
327 struct elf_link_loaded_list
329 struct elf_link_loaded_list *next;
330 bfd *abfd;
333 /* Structures used by the eh_frame optimization code. */
334 struct eh_cie_fde
336 union {
337 struct {
338 /* If REMOVED == 1, this is the CIE that the FDE originally used.
339 The CIE belongs to the same .eh_frame input section as the FDE.
341 If REMOVED == 0, this is the CIE that we have chosen to use for
342 the output FDE. The CIE's REMOVED field is also 0, but the CIE
343 might belong to a different .eh_frame input section from the FDE.
345 May be NULL to signify that the FDE should be discarded. */
346 struct eh_cie_fde *cie_inf;
347 struct eh_cie_fde *next_for_section;
348 } fde;
349 struct {
350 /* CIEs have three states:
352 - REMOVED && !MERGED: Slated for removal because we haven't yet
353 proven that an FDE needs it. FULL_CIE, if nonnull, points to
354 more detailed information about the CIE.
356 - REMOVED && MERGED: We have merged this CIE with MERGED_WITH,
357 which may not belong to the same input section.
359 - !REMOVED: We have decided to keep this CIE. SEC is the
360 .eh_frame input section that contains the CIE. */
361 union {
362 struct cie *full_cie;
363 struct eh_cie_fde *merged_with;
364 asection *sec;
365 } u;
367 /* The offset of the personality data from the start of the CIE,
368 or 0 if the CIE doesn't have any. */
369 unsigned int personality_offset : 8;
371 /* Length of augmentation. aug_str_len is the length of the
372 string including null terminator. aug_data_len is the length
373 of the rest up to the initial insns. */
374 unsigned int aug_str_len : 3;
375 unsigned int aug_data_len : 5;
377 /* True if we have marked relocations associated with this CIE. */
378 unsigned int gc_mark : 1;
380 /* True if we have decided to turn an absolute LSDA encoding into
381 a PC-relative one. */
382 unsigned int make_lsda_relative : 1;
384 /* True if we have decided to turn an absolute personality
385 encoding into a PC-relative one. */
386 unsigned int make_per_encoding_relative : 1;
388 /* True if the CIE contains personality data and if that
389 data uses a PC-relative encoding. Always true when
390 make_per_encoding_relative is. */
391 unsigned int per_encoding_relative : 1;
393 /* True if the CIE contains personality data aligned to a
394 multiple of eight bytes. */
395 unsigned int per_encoding_aligned8 : 1;
397 /* True if we need to add an 'R' (FDE encoding) entry to the
398 CIE's augmentation data. */
399 unsigned int add_fde_encoding : 1;
401 /* True if we have merged this CIE with another. */
402 unsigned int merged : 1;
404 /* Unused bits. */
405 unsigned int pad1 : 9;
406 } cie;
407 } u;
408 unsigned int reloc_index;
409 unsigned int size;
410 unsigned int offset;
411 unsigned int new_offset;
412 unsigned int fde_encoding : 8;
413 unsigned int lsda_encoding : 8;
414 unsigned int lsda_offset : 8;
416 /* True if this entry represents a CIE, false if it represents an FDE. */
417 unsigned int cie : 1;
419 /* True if this entry is currently marked for removal. */
420 unsigned int removed : 1;
422 /* True if we need to add a 'z' (augmentation size) entry to the CIE's
423 augmentation data, and an associated byte to each of the CIE's FDEs. */
424 unsigned int add_augmentation_size : 1;
426 /* True if we have decided to convert absolute FDE relocations into
427 relative ones. This applies to the first relocation in the FDE,
428 which is against the code that the FDE describes. */
429 unsigned int make_relative : 1;
431 /* Unused bits. */
432 unsigned int pad1 : 4;
434 unsigned int *set_loc;
437 struct eh_frame_sec_info
439 unsigned int count;
440 struct cie *cies;
441 struct eh_cie_fde entry[1];
444 struct eh_frame_array_ent
446 bfd_vma initial_loc;
447 bfd_size_type range;
448 bfd_vma fde;
451 struct htab;
453 #define DWARF2_EH_HDR 1
454 #define COMPACT_EH_HDR 2
456 /* Endian-neutral code indicating that a function cannot be unwound. */
457 #define COMPACT_EH_CANT_UNWIND_OPCODE 0x015d5d01
459 struct dwarf_eh_frame_hdr_info
461 struct htab *cies;
462 unsigned int fde_count;
463 /* TRUE if .eh_frame_hdr should contain the sorted search table.
464 We build it if we successfully read all .eh_frame input sections
465 and recognize them. */
466 bool table;
467 struct eh_frame_array_ent *array;
470 struct compact_eh_frame_hdr_info
472 unsigned int allocated_entries;
473 /* eh_frame_entry fragments. */
474 asection **entries;
477 struct eh_frame_hdr_info
479 asection *hdr_sec;
480 unsigned int array_count;
481 bool frame_hdr_is_compact;
482 union
484 struct dwarf_eh_frame_hdr_info dwarf;
485 struct compact_eh_frame_hdr_info compact;
490 /* Enum used to identify target specific extensions to the elf_obj_tdata
491 and elf_link_hash_table structures. Note the enums deliberately start
492 from 1 so that we can detect an uninitialized field. The generic value
493 is last so that additions to this enum do not need to modify more than
494 one line. */
495 enum elf_target_id
497 AARCH64_ELF_DATA = 1,
498 ALPHA_ELF_DATA,
499 ARC_ELF_DATA,
500 ARM_ELF_DATA,
501 AVR_ELF_DATA,
502 BFIN_ELF_DATA,
503 CRIS_ELF_DATA,
504 CSKY_ELF_DATA,
505 FRV_ELF_DATA,
506 HPPA32_ELF_DATA,
507 HPPA64_ELF_DATA,
508 I386_ELF_DATA,
509 IA64_ELF_DATA,
510 LM32_ELF_DATA,
511 LARCH_ELF_DATA,
512 M32R_ELF_DATA,
513 M68HC11_ELF_DATA,
514 M68K_ELF_DATA,
515 METAG_ELF_DATA,
516 MICROBLAZE_ELF_DATA,
517 MIPS_ELF_DATA,
518 MN10300_ELF_DATA,
519 NDS32_ELF_DATA,
520 NIOS2_ELF_DATA,
521 OR1K_ELF_DATA,
522 PPC32_ELF_DATA,
523 PPC64_ELF_DATA,
524 PRU_ELF_DATA,
525 S390_ELF_DATA,
526 SH_ELF_DATA,
527 SPARC_ELF_DATA,
528 SPU_ELF_DATA,
529 TIC6X_ELF_DATA,
530 X86_64_ELF_DATA,
531 XTENSA_ELF_DATA,
532 TILEGX_ELF_DATA,
533 TILEPRO_ELF_DATA,
534 RISCV_ELF_DATA,
535 GENERIC_ELF_DATA
538 struct elf_sym_strtab
540 Elf_Internal_Sym sym;
541 unsigned long dest_index;
544 struct bfd_link_needed_list
546 struct bfd_link_needed_list *next;
547 bfd *by;
548 const char *name;
551 enum elf_target_os
553 is_normal,
554 is_solaris, /* Solaris. */
555 is_vxworks, /* VxWorks. */
556 is_nacl /* Native Client. */
559 /* Used by bfd_sym_from_r_symndx to cache a small number of local
560 symbols. */
561 #define LOCAL_SYM_CACHE_SIZE 32
562 struct sym_cache
564 bfd *abfd;
565 unsigned long indx[LOCAL_SYM_CACHE_SIZE];
566 Elf_Internal_Sym sym[LOCAL_SYM_CACHE_SIZE];
569 /* ELF linker hash table. */
571 struct elf_link_hash_table
573 struct bfd_link_hash_table root;
575 /* An identifier used to distinguish different target
576 specific extensions to this structure. */
577 enum elf_target_id hash_table_id;
579 /* Whether we have created the special dynamic sections required
580 when linking against or generating a shared object. */
581 bool dynamic_sections_created;
583 /* Whether dynamic relocations are present. */
584 bool dynamic_relocs;
586 /* True if this target has relocatable executables, so needs dynamic
587 section symbols. */
588 bool is_relocatable_executable;
590 /* TRUE if there are IFUNC resolvers. */
591 bool ifunc_resolvers;
593 /* TRUE if DT_PLTGOT is a required dynamic tag. */
594 bool dt_pltgot_required;
596 /* TRUE if DT_JMPREL is a required dynamic tag. */
597 bool dt_jmprel_required;
599 /* The BFD used to hold special sections created by the linker.
600 This will be the first BFD found which requires these sections to
601 be created. */
602 bfd *dynobj;
604 /* The value to use when initialising got.refcount/offset and
605 plt.refcount/offset in an elf_link_hash_entry. Set to zero when
606 the values are refcounts. Set to init_got_offset/init_plt_offset
607 in size_dynamic_sections when the values may be offsets. */
608 union gotplt_union init_got_refcount;
609 union gotplt_union init_plt_refcount;
611 /* The value to use for got.refcount/offset and plt.refcount/offset
612 when the values may be offsets. Normally (bfd_vma) -1. */
613 union gotplt_union init_got_offset;
614 union gotplt_union init_plt_offset;
616 /* The number of symbols found in the link which is intended for the
617 mandatory DT_SYMTAB tag (.dynsym section) in .dynamic section. */
618 bfd_size_type dynsymcount;
619 bfd_size_type local_dynsymcount;
621 /* The string table of dynamic symbols, which becomes the .dynstr
622 section. */
623 struct elf_strtab_hash *dynstr;
625 /* The array size of the symbol string table, which becomes the
626 .strtab section. */
627 bfd_size_type strtabsize;
629 /* The array of strings, which becomes the .strtab section. */
630 struct elf_sym_strtab *strtab;
632 /* The number of buckets in the hash table in the .hash section.
633 This is based on the number of dynamic symbols. */
634 bfd_size_type bucketcount;
636 /* A linked list of DT_NEEDED names found in dynamic objects
637 included in the link. */
638 struct bfd_link_needed_list *needed;
640 /* Sections in the output bfd that provides a section symbol
641 to be used by relocations emitted against local symbols.
642 Most targets will not use data_index_section. */
643 asection *text_index_section;
644 asection *data_index_section;
646 /* The _GLOBAL_OFFSET_TABLE_ symbol. */
647 struct elf_link_hash_entry *hgot;
649 /* The _PROCEDURE_LINKAGE_TABLE_ symbol. */
650 struct elf_link_hash_entry *hplt;
652 /* The _DYNAMIC symbol. */
653 struct elf_link_hash_entry *hdynamic;
655 /* A pointer to information used to merge SEC_MERGE sections. */
656 void *merge_info;
658 /* Used to link stabs in sections. */
659 struct stab_info stab_info;
661 /* Used by eh_frame code when editing .eh_frame. */
662 struct eh_frame_hdr_info eh_info;
664 /* A linked list of local symbols to be added to .dynsym. */
665 struct elf_link_local_dynamic_entry *dynlocal;
667 /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic
668 objects included in the link. */
669 struct bfd_link_needed_list *runpath;
671 /* Cached first output tls section and size of PT_TLS segment. */
672 asection *tls_sec;
673 bfd_size_type tls_size; /* Bytes. */
675 /* The offset into splt of the PLT entry for the TLS descriptor
676 resolver. Special values are 0, if not necessary (or not found
677 to be necessary yet), and -1 if needed but not determined
678 yet. */
679 bfd_vma tlsdesc_plt;
681 /* The GOT offset for the lazy trampoline. Communicated to the
682 loader via DT_TLSDESC_GOT. The magic value (bfd_vma) -1
683 indicates an offset is not allocated. */
684 bfd_vma tlsdesc_got;
686 /* Target OS for linker output. */
687 enum elf_target_os target_os;
689 /* A linked list of dynamic BFD's loaded in the link. */
690 struct elf_link_loaded_list *dyn_loaded;
692 /* Small local sym cache. */
693 struct sym_cache sym_cache;
695 /* Short-cuts to get to dynamic linker sections. */
696 asection *sgot;
697 asection *sgotplt;
698 asection *srelgot;
699 asection *splt;
700 asection *srelplt;
701 asection *sdynbss;
702 asection *srelbss;
703 asection *sdynrelro;
704 asection *sreldynrelro;
705 asection *igotplt;
706 asection *iplt;
707 asection *irelplt;
708 asection *irelifunc;
709 asection *dynsym;
712 /* Returns TRUE if the hash table is a struct elf_link_hash_table. */
714 static inline bool
715 is_elf_hash_table (const struct bfd_link_hash_table *htab)
717 return htab->type == bfd_link_elf_hash_table;
720 /* Look up an entry in an ELF linker hash table. */
722 static inline struct elf_link_hash_entry *
723 elf_link_hash_lookup (struct elf_link_hash_table *table, const char *string,
724 bool create, bool copy, bool follow)
726 if (ENABLE_CHECKING && !is_elf_hash_table (&table->root))
727 abort ();
728 return (struct elf_link_hash_entry *)
729 bfd_link_hash_lookup (&table->root, string, create, copy, follow);
732 /* Traverse an ELF linker hash table. */
734 static inline void
735 elf_link_hash_traverse (struct elf_link_hash_table *table,
736 bool (*f) (struct elf_link_hash_entry *, void *),
737 void *info)
739 if (ENABLE_CHECKING && !is_elf_hash_table (&table->root))
740 abort ();
741 bfd_link_hash_traverse (&table->root,
742 (bool (*) (struct bfd_link_hash_entry *, void *)) f,
743 info);
746 /* Get the ELF linker hash table from a link_info structure. */
748 static inline struct elf_link_hash_table *
749 elf_hash_table (const struct bfd_link_info *info)
751 return (struct elf_link_hash_table *) info->hash;
754 static inline enum elf_target_id
755 elf_hash_table_id (const struct elf_link_hash_table *table)
757 return table->hash_table_id;
760 /* Constant information held for an ELF backend. */
762 struct elf_size_info {
763 unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
764 unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
766 /* The size of entries in the .hash section. */
767 unsigned char sizeof_hash_entry;
769 /* The number of internal relocations to allocate per external
770 relocation entry. */
771 unsigned char int_rels_per_ext_rel;
772 /* We use some fixed size arrays. This should be large enough to
773 handle all back-ends. */
774 #define MAX_INT_RELS_PER_EXT_REL 3
776 unsigned char arch_size, log_file_align;
777 unsigned char elfclass, ev_current;
778 int (*write_out_phdrs)
779 (bfd *, const Elf_Internal_Phdr *, unsigned int);
780 bool (*write_shdrs_and_ehdr) (bfd *);
781 bool (*checksum_contents)
782 (bfd * , void (*) (const void *, size_t, void *), void *);
783 void (*write_relocs)
784 (bfd *, asection *, void *);
785 bool (*swap_symbol_in)
786 (bfd *, const void *, const void *, Elf_Internal_Sym *);
787 void (*swap_symbol_out)
788 (bfd *, const Elf_Internal_Sym *, void *, void *);
789 bool (*slurp_reloc_table)
790 (bfd *, asection *, asymbol **, bool);
791 long (*slurp_symbol_table)
792 (bfd *, asymbol **, bool);
793 void (*swap_dyn_in)
794 (bfd *, const void *, Elf_Internal_Dyn *);
795 void (*swap_dyn_out)
796 (bfd *, const Elf_Internal_Dyn *, void *);
798 /* This function is called to swap in a REL relocation. If an
799 external relocation corresponds to more than one internal
800 relocation, then all relocations are swapped in at once. */
801 void (*swap_reloc_in)
802 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
804 /* This function is called to swap out a REL relocation. */
805 void (*swap_reloc_out)
806 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
808 /* This function is called to swap in a RELA relocation. If an
809 external relocation corresponds to more than one internal
810 relocation, then all relocations are swapped in at once. */
811 void (*swap_reloca_in)
812 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
814 /* This function is called to swap out a RELA relocation. */
815 void (*swap_reloca_out)
816 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
819 #define elf_symbol_from(S) \
820 ((((S)->flags & BSF_SYNTHETIC) == 0 \
821 && (S)->the_bfd != NULL \
822 && (S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
823 && (S)->the_bfd->tdata.elf_obj_data != 0) \
824 ? (elf_symbol_type *) (S) \
825 : 0)
827 enum elf_reloc_type_class {
828 reloc_class_normal,
829 reloc_class_relative,
830 reloc_class_copy,
831 reloc_class_ifunc,
832 reloc_class_plt
835 struct elf_reloc_cookie
837 Elf_Internal_Rela *rels, *rel, *relend;
838 Elf_Internal_Sym *locsyms;
839 bfd *abfd;
840 size_t locsymcount;
841 size_t extsymoff;
842 struct elf_link_hash_entry **sym_hashes;
843 int r_sym_shift;
844 bool bad_symtab;
847 /* The level of IRIX compatibility we're striving for. */
849 typedef enum {
850 ict_none,
851 ict_irix5,
852 ict_irix6
853 } irix_compat_t;
855 /* Mapping of ELF section names and types. */
856 struct bfd_elf_special_section
858 const char *prefix;
859 unsigned int prefix_length;
860 /* 0 means name must match PREFIX exactly.
861 -1 means name must start with PREFIX followed by an arbitrary string.
862 -2 means name must match PREFIX exactly or consist of PREFIX followed
863 by a dot then anything.
864 > 0 means name must start with the first PREFIX_LENGTH chars of
865 PREFIX and finish with the last SUFFIX_LENGTH chars of PREFIX. */
866 signed int suffix_length;
867 unsigned int type;
868 bfd_vma attr;
871 enum action_discarded
873 COMPLAIN = 1,
874 PRETEND = 2
877 typedef asection * (*elf_gc_mark_hook_fn)
878 (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
879 struct elf_link_hash_entry *, Elf_Internal_Sym *);
881 enum elf_property_kind
883 /* A new property. */
884 property_unknown = 0,
885 /* A property ignored by backend. */
886 property_ignored,
887 /* A corrupt property reported by backend. */
888 property_corrupt,
889 /* A property should be removed due to property merge. */
890 property_remove,
891 /* A property which is a number. */
892 property_number
895 typedef struct elf_property
897 unsigned int pr_type;
898 unsigned int pr_datasz;
899 union
901 /* For property_number, this is a number. */
902 bfd_vma number;
903 /* Add a new one if elf_property_kind is updated. */
904 } u;
905 enum elf_property_kind pr_kind;
906 } elf_property;
908 typedef struct elf_property_list
910 struct elf_property_list *next;
911 struct elf_property property;
912 } elf_property_list;
914 struct bfd_elf_section_reloc_data;
916 struct elf_backend_data
918 /* The architecture for this backend. */
919 enum bfd_architecture arch;
921 /* An identifier used to distinguish different target specific
922 extensions to elf_obj_tdata and elf_link_hash_table structures. */
923 enum elf_target_id target_id;
925 /* Target OS. */
926 enum elf_target_os target_os;
928 /* The ELF machine code (EM_xxxx) for this backend. */
929 int elf_machine_code;
931 /* EI_OSABI. */
932 int elf_osabi;
934 /* The maximum page size for this backend. */
935 bfd_vma maxpagesize;
937 /* The minimum page size for this backend. An input object will not be
938 considered page aligned unless its sections are correctly aligned for
939 pages at least this large. May be smaller than maxpagesize. */
940 bfd_vma minpagesize;
942 /* The common page size for this backend. */
943 bfd_vma commonpagesize;
945 /* The value of commonpagesize to use when -z relro for this backend. */
946 bfd_vma relropagesize;
948 /* The BFD flags applied to sections created for dynamic linking. */
949 flagword dynamic_sec_flags;
951 /* Architecture-specific data for this backend.
952 This is actually a pointer to some type like struct elf_ARCH_data. */
953 const void *arch_data;
955 /* A function to translate an ELF RELA relocation to a BFD arelent
956 structure. Returns TRUE upon success, FALSE otherwise. */
957 bool (*elf_info_to_howto)
958 (bfd *, arelent *, Elf_Internal_Rela *);
960 /* A function to translate an ELF REL relocation to a BFD arelent
961 structure. Returns TRUE upon success, FALSE otherwise. */
962 bool (*elf_info_to_howto_rel)
963 (bfd *, arelent *, Elf_Internal_Rela *);
965 /* A function to determine whether a symbol is global when
966 partitioning the symbol table into local and global symbols.
967 This should be NULL for most targets, in which case the correct
968 thing will be done. MIPS ELF, at least on the Irix 5, has
969 special requirements. */
970 bool (*elf_backend_sym_is_global)
971 (bfd *, asymbol *);
973 /* The remaining functions are hooks which are called only if they
974 are not NULL. */
976 /* A function to permit a backend specific check on whether a
977 particular BFD format is relevant for an object file, and to
978 permit the backend to set any global information it wishes. When
979 this is called elf_elfheader is set, but anything else should be
980 used with caution. If this returns FALSE, the check_format
981 routine will return a bfd_error_wrong_format error. */
982 bool (*elf_backend_object_p)
983 (bfd *);
985 /* A function to do additional symbol processing when reading the
986 ELF symbol table. This is where any processor-specific special
987 section indices are handled. */
988 void (*elf_backend_symbol_processing)
989 (bfd *, asymbol *);
991 /* A function to do additional symbol processing after reading the
992 entire ELF symbol table. */
993 bool (*elf_backend_symbol_table_processing)
994 (bfd *, elf_symbol_type *, unsigned int);
996 /* A function to set the type of the info field. Processor-specific
997 types should be handled here. */
998 int (*elf_backend_get_symbol_type)
999 (Elf_Internal_Sym *, int);
1001 /* A function to return the linker hash table entry of a symbol that
1002 might be satisfied by an archive symbol. */
1003 struct bfd_link_hash_entry * (*elf_backend_archive_symbol_lookup)
1004 (bfd *, struct bfd_link_info *, const char *);
1006 /* Return true if local section symbols should have a non-null st_name.
1007 NULL implies false. */
1008 bool (*elf_backend_name_local_section_symbols)
1009 (bfd *);
1011 /* A function to do additional processing on the ELF section header
1012 just before writing it out. This is used to set the flags and
1013 type fields for some sections, or to actually write out data for
1014 unusual sections. */
1015 bool (*elf_backend_section_processing)
1016 (bfd *, Elf_Internal_Shdr *);
1018 /* A function to handle unusual section types when creating BFD
1019 sections from ELF sections. */
1020 bool (*elf_backend_section_from_shdr)
1021 (bfd *, Elf_Internal_Shdr *, const char *, int);
1023 /* A function to convert machine dependent ELF section header flags to
1024 BFD internal section header flags. */
1025 bool (*elf_backend_section_flags)
1026 (const Elf_Internal_Shdr *);
1028 /* A function that returns a struct containing ELF section flags and
1029 type for the given BFD section. */
1030 const struct bfd_elf_special_section * (*get_sec_type_attr)
1031 (bfd *, asection *);
1033 /* A function to handle unusual program segment types when creating BFD
1034 sections from ELF program segments. */
1035 bool (*elf_backend_section_from_phdr)
1036 (bfd *, Elf_Internal_Phdr *, int, const char *);
1038 /* A function to set up the ELF section header for a BFD section in
1039 preparation for writing it out. This is where the flags and type
1040 fields are set for unusual sections. */
1041 bool (*elf_backend_fake_sections)
1042 (bfd *, Elf_Internal_Shdr *, asection *);
1044 /* A function to get the ELF section index for a BFD section. If
1045 this returns TRUE, the section was found. If it is a normal ELF
1046 section, *RETVAL should be left unchanged. If it is not a normal
1047 ELF section *RETVAL should be set to the SHN_xxxx index. */
1048 bool (*elf_backend_section_from_bfd_section)
1049 (bfd *, asection *, int *retval);
1051 /* If this field is not NULL, it is called by the add_symbols phase
1052 of a link just before adding a symbol to the global linker hash
1053 table. It may modify any of the fields as it wishes. If *NAME
1054 is set to NULL, the symbol will be skipped rather than being
1055 added to the hash table. This function is responsible for
1056 handling all processor dependent symbol bindings and section
1057 indices, and must set at least *FLAGS and *SEC for each processor
1058 dependent case; failure to do so will cause a link error. */
1059 bool (*elf_add_symbol_hook)
1060 (bfd *abfd, struct bfd_link_info *info, Elf_Internal_Sym *,
1061 const char **name, flagword *flags, asection **sec, bfd_vma *value);
1063 /* If this field is not NULL, it is called by the elf_link_output_sym
1064 phase of a link for each symbol which will appear in the object file.
1065 On error, this function returns 0. 1 is returned when the symbol
1066 should be output, 2 is returned when the symbol should be discarded. */
1067 int (*elf_backend_link_output_symbol_hook)
1068 (struct bfd_link_info *info, const char *, Elf_Internal_Sym *,
1069 asection *, struct elf_link_hash_entry *);
1071 /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
1072 linker the first time it encounters a dynamic object in the link.
1073 This function must create any sections required for dynamic
1074 linking. The ABFD argument is a dynamic object. The .interp,
1075 .dynamic, .dynsym, .dynstr, and .hash functions have already been
1076 created, and this function may modify the section flags if
1077 desired. This function will normally create the .got and .plt
1078 sections, but different backends have different requirements. */
1079 bool (*elf_backend_create_dynamic_sections)
1080 (bfd *abfd, struct bfd_link_info *info);
1082 /* When creating a shared library, determine whether to omit the
1083 dynamic symbol for the section. */
1084 bool (*elf_backend_omit_section_dynsym)
1085 (bfd *output_bfd, struct bfd_link_info *info, asection *osec);
1087 /* Return TRUE if relocations of targets are compatible to the extent
1088 that CHECK_RELOCS will properly process them. PR 4424. */
1089 bool (*relocs_compatible) (const bfd_target *, const bfd_target *);
1091 /* The CHECK_RELOCS function is called by the add_symbols phase of
1092 the ELF backend linker. It is called once for each section with
1093 relocs of an object file, just after the symbols for the object
1094 file have been added to the global linker hash table. The
1095 function must look through the relocs and do any special handling
1096 required. This generally means allocating space in the global
1097 offset table, and perhaps allocating space for a reloc. The
1098 relocs are always passed as Rela structures; if the section
1099 actually uses Rel structures, the r_addend field will always be
1100 zero. */
1101 bool (*check_relocs)
1102 (bfd *abfd, struct bfd_link_info *info, asection *o,
1103 const Elf_Internal_Rela *relocs);
1105 /* The CHECK_DIRECTIVES function is called once per input file by
1106 the add_symbols phase of the ELF backend linker. The function
1107 must inspect the bfd and create any additional symbols according
1108 to any custom directives in the bfd. */
1109 bool (*check_directives)
1110 (bfd *abfd, struct bfd_link_info *info);
1112 /* The NOTICE_AS_NEEDED function is called as the linker is about to
1113 handle an as-needed lib (ACT = notice_as_needed), and after the
1114 linker has decided to keep the lib (ACT = notice_needed) or when
1115 the lib is not needed (ACT = notice_not_needed). */
1116 bool (*notice_as_needed)
1117 (bfd *abfd, struct bfd_link_info *info, enum notice_asneeded_action act);
1119 /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
1120 linker for every symbol which is defined by a dynamic object and
1121 referenced by a regular object. This is called after all the
1122 input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
1123 function has been called. The hash table entry should be
1124 bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
1125 defined in a section from a dynamic object. Dynamic object
1126 sections are not included in the final link, and this function is
1127 responsible for changing the value to something which the rest of
1128 the link can deal with. This will normally involve adding an
1129 entry to the .plt or .got or some such section, and setting the
1130 symbol to point to that. */
1131 bool (*elf_backend_adjust_dynamic_symbol)
1132 (struct bfd_link_info *info, struct elf_link_hash_entry *h);
1134 /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
1135 after all the linker input files have been seen but before the
1136 section sizes have been set. This is called after
1137 ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS. */
1138 bool (*elf_backend_always_size_sections)
1139 (bfd *output_bfd, struct bfd_link_info *info);
1141 /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
1142 linker after all the linker input files have been seen but before
1143 the sections sizes have been set. This is called after
1144 ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
1145 It is only called when linking against a dynamic object. It must
1146 set the sizes of the dynamic sections, and may fill in their
1147 contents as well. The generic ELF linker can handle the .dynsym,
1148 .dynstr and .hash sections. This function must handle the
1149 .interp section and any sections created by the
1150 CREATE_DYNAMIC_SECTIONS entry point. */
1151 bool (*elf_backend_size_dynamic_sections)
1152 (bfd *output_bfd, struct bfd_link_info *info);
1154 /* The STRIP_ZERO_SIZED_DYNAMIC_SECTIONS function is called by the
1155 ELF backend linker to strip zero-sized dynamic sections after
1156 the section sizes have been set. */
1157 bool (*elf_backend_strip_zero_sized_dynamic_sections)
1158 (struct bfd_link_info *info);
1160 /* Set TEXT_INDEX_SECTION and DATA_INDEX_SECTION, the output sections
1161 we keep to use as a base for relocs and symbols. */
1162 void (*elf_backend_init_index_section)
1163 (bfd *output_bfd, struct bfd_link_info *info);
1165 /* The RELOCATE_SECTION function is called by the ELF backend linker
1166 to handle the relocations for a section.
1168 The relocs are always passed as Rela structures; if the section
1169 actually uses Rel structures, the r_addend field will always be
1170 zero.
1172 This function is responsible for adjust the section contents as
1173 necessary, and (if using Rela relocs and generating a
1174 relocatable output file) adjusting the reloc addend as
1175 necessary.
1177 This function does not have to worry about setting the reloc
1178 address or the reloc symbol index.
1180 LOCAL_SYMS is a pointer to the swapped in local symbols.
1182 LOCAL_SECTIONS is an array giving the section in the input file
1183 corresponding to the st_shndx field of each local symbol.
1185 The global hash table entry for the global symbols can be found
1186 via elf_sym_hashes (input_bfd).
1188 When generating relocatable output, this function must handle
1189 STB_LOCAL/STT_SECTION symbols specially. The output symbol is
1190 going to be the section symbol corresponding to the output
1191 section, which means that the addend must be adjusted
1192 accordingly.
1194 Returns FALSE on error, TRUE on success, 2 if successful and
1195 relocations should be written for this section. */
1196 int (*elf_backend_relocate_section)
1197 (bfd *output_bfd, struct bfd_link_info *info, bfd *input_bfd,
1198 asection *input_section, bfd_byte *contents, Elf_Internal_Rela *relocs,
1199 Elf_Internal_Sym *local_syms, asection **local_sections);
1201 /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
1202 linker just before it writes a symbol out to the .dynsym section.
1203 The processor backend may make any required adjustment to the
1204 symbol. It may also take the opportunity to set contents of the
1205 dynamic sections. Note that FINISH_DYNAMIC_SYMBOL is called on
1206 all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
1207 on those symbols which are defined by a dynamic object. */
1208 bool (*elf_backend_finish_dynamic_symbol)
1209 (bfd *output_bfd, struct bfd_link_info *info,
1210 struct elf_link_hash_entry *h, Elf_Internal_Sym *sym);
1212 /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
1213 linker just before it writes all the dynamic sections out to the
1214 output file. The FINISH_DYNAMIC_SYMBOL will have been called on
1215 all dynamic symbols. */
1216 bool (*elf_backend_finish_dynamic_sections)
1217 (bfd *output_bfd, struct bfd_link_info *info);
1219 /* A function to do any beginning processing needed for the ELF file
1220 before building the ELF headers and computing file positions. */
1221 void (*elf_backend_begin_write_processing)
1222 (bfd *, struct bfd_link_info *);
1224 /* A function to do any final processing needed for the ELF file
1225 before writing it out. */
1226 bool (*elf_backend_final_write_processing)
1227 (bfd *);
1229 /* This function is called by get_program_header_size. It should
1230 return the number of additional program segments which this BFD
1231 will need. It should return -1 on error. */
1232 int (*elf_backend_additional_program_headers)
1233 (bfd *, struct bfd_link_info *);
1235 /* This function is called to modify an existing segment map in a
1236 backend specific fashion. */
1237 bool (*elf_backend_modify_segment_map)
1238 (bfd *, struct bfd_link_info *);
1240 /* This function is called to modify program headers just before
1241 they are written. */
1242 bool (*elf_backend_modify_headers)
1243 (bfd *, struct bfd_link_info *);
1245 /* This function is called to see if the PHDR header should be
1246 checked for validity. */
1247 bool (*elf_backend_allow_non_load_phdr)
1248 (bfd *, const Elf_Internal_Phdr *, unsigned);
1250 /* This function is called before section garbage collection to
1251 mark entry symbol sections. */
1252 void (*gc_keep)
1253 (struct bfd_link_info *);
1255 /* This function is called during section garbage collection to
1256 mark sections that define global symbols. */
1257 bool (*gc_mark_dynamic_ref)
1258 (struct elf_link_hash_entry *, void *);
1260 /* This function is called during section gc to discover the section a
1261 particular relocation refers to. */
1262 elf_gc_mark_hook_fn gc_mark_hook;
1264 /* This function, if defined, is called after the first gc marking pass
1265 to allow the backend to mark additional sections. */
1266 bool (*gc_mark_extra_sections)
1267 (struct bfd_link_info *, elf_gc_mark_hook_fn);
1269 /* This function is called to initialise ELF file header info.
1270 Customised versions can modify things like the OS and ABI version. */
1271 bool (*elf_backend_init_file_header)
1272 (bfd *, struct bfd_link_info *);
1274 /* This function, if defined, prints a symbol to file and returns the
1275 name of the symbol to be printed. It should return NULL to fall
1276 back to default symbol printing. */
1277 const char *(*elf_backend_print_symbol_all)
1278 (bfd *, void *, asymbol *);
1280 /* This function, if defined, is called after all local symbols and
1281 global symbols converted to locals are emitted into the symtab
1282 section. It allows the backend to emit special local symbols
1283 not handled in the hash table. */
1284 bool (*elf_backend_output_arch_local_syms)
1285 (bfd *, struct bfd_link_info *, void *,
1286 int (*) (void *, const char *, Elf_Internal_Sym *, asection *,
1287 struct elf_link_hash_entry *));
1289 /* This function, if defined, is called after all symbols are emitted
1290 into the symtab section. It allows the backend to emit special
1291 global symbols not handled in the hash table. */
1292 bool (*elf_backend_output_arch_syms)
1293 (bfd *, struct bfd_link_info *, void *,
1294 int (*) (void *, const char *, Elf_Internal_Sym *, asection *,
1295 struct elf_link_hash_entry *));
1297 /* Filter what symbols of the output file to include in the import
1298 library if one is created. */
1299 unsigned int (*elf_backend_filter_implib_symbols)
1300 (bfd *, struct bfd_link_info *, asymbol **, long);
1302 /* Copy any information related to dynamic linking from a pre-existing
1303 symbol to a newly created symbol. Also called to copy flags and
1304 other back-end info to a weakdef, in which case the symbol is not
1305 newly created and plt/got refcounts and dynamic indices should not
1306 be copied. */
1307 void (*elf_backend_copy_indirect_symbol)
1308 (struct bfd_link_info *, struct elf_link_hash_entry *,
1309 struct elf_link_hash_entry *);
1311 /* Modify any information related to dynamic linking such that the
1312 symbol is not exported. */
1313 void (*elf_backend_hide_symbol)
1314 (struct bfd_link_info *, struct elf_link_hash_entry *, bool);
1316 /* A function to do additional symbol fixup, called by
1317 _bfd_elf_fix_symbol_flags. */
1318 bool (*elf_backend_fixup_symbol)
1319 (struct bfd_link_info *, struct elf_link_hash_entry *);
1321 /* Merge the backend specific symbol attribute. */
1322 void (*elf_backend_merge_symbol_attribute)
1323 (struct elf_link_hash_entry *, unsigned int, bool, bool);
1325 /* This function, if defined, will return a string containing the
1326 name of a target-specific dynamic tag. */
1327 char *(*elf_backend_get_target_dtag)
1328 (bfd_vma);
1330 /* Decide whether an undefined symbol is special and can be ignored.
1331 This is the case for OPTIONAL symbols on IRIX. */
1332 bool (*elf_backend_ignore_undef_symbol)
1333 (struct elf_link_hash_entry *);
1335 /* Emit relocations. Overrides default routine for emitting relocs,
1336 except during a relocatable link, or if all relocs are being emitted. */
1337 bool (*elf_backend_emit_relocs)
1338 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *,
1339 struct elf_link_hash_entry **);
1341 /* Update relocations. It is allowed to change the number and the order.
1342 In such a case hashes should be invalidated. */
1343 void (*elf_backend_update_relocs)
1344 (asection *, struct bfd_elf_section_reloc_data *);
1346 /* Count relocations. Not called for relocatable links
1347 or if all relocs are being preserved in the output. */
1348 unsigned int (*elf_backend_count_relocs)
1349 (struct bfd_link_info *, asection *);
1351 /* Count additionals relocations. Called for relocatable links if
1352 additional relocations needs to be created. */
1353 unsigned int (*elf_backend_count_additional_relocs)
1354 (asection *);
1356 /* Say whether to sort relocs output by ld -r and ld --emit-relocs,
1357 by r_offset. If NULL, default to true. */
1358 bool (*sort_relocs_p)
1359 (asection *);
1361 /* This function, if defined, is called when an NT_PRSTATUS note is found
1362 in a core file. */
1363 bool (*elf_backend_grok_prstatus)
1364 (bfd *, Elf_Internal_Note *);
1366 /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
1367 note is found in a core file. */
1368 bool (*elf_backend_grok_psinfo)
1369 (bfd *, Elf_Internal_Note *);
1371 /* This function, if defined, is called when a "FreeBSD" NT_PRSTATUS
1372 note is found in a core file. */
1373 bool (*elf_backend_grok_freebsd_prstatus)
1374 (bfd *, Elf_Internal_Note *);
1376 /* This function, if defined, is called to write a note to a corefile. */
1377 char *(*elf_backend_write_core_note)
1378 (bfd *abfd, char *buf, int *bufsiz, int note_type, ...);
1380 /* This function, if defined, is called to convert target-specific
1381 section flag names into hex values. */
1382 flagword (*elf_backend_lookup_section_flags_hook)
1383 (char *);
1385 /* This function returns class of a reloc type. */
1386 enum elf_reloc_type_class (*elf_backend_reloc_type_class)
1387 (const struct bfd_link_info *, const asection *, const Elf_Internal_Rela *);
1389 /* This function, if defined, removes information about discarded functions
1390 from other sections which mention them. */
1391 bool (*elf_backend_discard_info)
1392 (bfd *, struct elf_reloc_cookie *, struct bfd_link_info *);
1394 /* This function, if defined, signals that the function above has removed
1395 the discarded relocations for this section. */
1396 bool (*elf_backend_ignore_discarded_relocs)
1397 (asection *);
1399 /* What to do when ld finds relocations against symbols defined in
1400 discarded sections. */
1401 unsigned int (*action_discarded)
1402 (asection *);
1404 /* This function returns the width of FDE pointers in bytes, or 0 if
1405 that can't be determined for some reason. The default definition
1406 goes by the bfd's EI_CLASS. */
1407 unsigned int (*elf_backend_eh_frame_address_size)
1408 (bfd *, const asection *);
1410 /* These functions tell elf-eh-frame whether to attempt to turn
1411 absolute or lsda encodings into pc-relative ones. The default
1412 definition enables these transformations. */
1413 bool (*elf_backend_can_make_relative_eh_frame)
1414 (bfd *, struct bfd_link_info *, asection *);
1415 bool (*elf_backend_can_make_lsda_relative_eh_frame)
1416 (bfd *, struct bfd_link_info *, asection *);
1418 /* This function returns an encoding after computing the encoded
1419 value (and storing it in ENCODED) for the given OFFSET into OSEC,
1420 to be stored in at LOC_OFFSET into the LOC_SEC input section.
1421 The default definition chooses a 32-bit PC-relative encoding. */
1422 bfd_byte (*elf_backend_encode_eh_address)
1423 (bfd *abfd, struct bfd_link_info *info,
1424 asection *osec, bfd_vma offset,
1425 asection *loc_sec, bfd_vma loc_offset,
1426 bfd_vma *encoded);
1428 /* This function, if defined, may write out the given section.
1429 Returns TRUE if it did so and FALSE if the caller should. */
1430 bool (*elf_backend_write_section)
1431 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
1433 /* This function, if defined, returns TRUE if it is section symbols
1434 only that are considered local for the purpose of partitioning the
1435 symbol table into local and global symbols. This should be NULL
1436 for most targets, in which case the correct thing will be done.
1437 MIPS ELF, at least on the Irix 5, has special requirements. */
1438 bool (*elf_backend_elfsym_local_is_section)
1439 (bfd *);
1441 /* The level of IRIX compatibility we're striving for.
1442 MIPS ELF specific function. */
1443 irix_compat_t (*elf_backend_mips_irix_compat)
1444 (bfd *);
1446 reloc_howto_type *(*elf_backend_mips_rtype_to_howto)
1447 (bfd *, unsigned int, bool);
1449 /* The swapping table to use when dealing with ECOFF information.
1450 Used for the MIPS ELF .mdebug section. */
1451 const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
1453 /* This function implements `bfd_elf_bfd_from_remote_memory';
1454 see elf.c, elfcode.h. */
1455 bfd *(*elf_backend_bfd_from_remote_memory)
1456 (bfd *templ, bfd_vma ehdr_vma, bfd_size_type size, bfd_vma *loadbasep,
1457 int (*target_read_memory) (bfd_vma vma, bfd_byte *myaddr,
1458 bfd_size_type len));
1460 bool (*elf_backend_core_find_build_id) (bfd *, bfd_vma);
1462 /* This function is used by `_bfd_elf_get_synthetic_symtab';
1463 see elf.c. */
1464 bfd_vma (*plt_sym_val) (bfd_vma, const asection *, const arelent *);
1466 /* Is symbol defined in common section? */
1467 bool (*common_definition) (Elf_Internal_Sym *);
1469 /* Return a common section index for section. */
1470 unsigned int (*common_section_index) (asection *);
1472 /* Return a common section for section. */
1473 asection *(*common_section) (asection *);
1475 /* Return TRUE if we can merge 2 definitions. */
1476 bool (*merge_symbol) (struct elf_link_hash_entry *,
1477 const Elf_Internal_Sym *, asection **,
1478 bool, bool,
1479 bfd *, const asection *);
1481 /* Return TRUE if symbol should be hashed in the `.gnu.hash' section. */
1482 bool (*elf_hash_symbol) (struct elf_link_hash_entry *);
1484 /* If non-NULL, called to register the location of XLAT_LOC within
1485 .MIPS.xhash at which real final dynindx for H will be written.
1486 If XLAT_LOC is zero, the symbol is not included in
1487 .MIPS.xhash and no dynindx will be written. */
1488 void (*record_xhash_symbol)
1489 (struct elf_link_hash_entry *h, bfd_vma xlat_loc);
1491 /* Return TRUE if type is a function symbol type. */
1492 bool (*is_function_type) (unsigned int type);
1494 /* If the ELF symbol SYM might be a function in SEC, return the
1495 function size and set *CODE_OFF to the function's entry point,
1496 otherwise return zero. */
1497 bfd_size_type (*maybe_function_sym) (const asymbol *sym, asection *sec,
1498 bfd_vma *code_off);
1500 /* Given NAME, the name of a relocation section stripped of its
1501 .rel/.rela prefix, return the section in ABFD to which the
1502 relocations apply. */
1503 asection *(*get_reloc_section) (bfd *abfd, const char *name);
1505 /* Called to set the sh_flags, sh_link and sh_info fields of OSECTION which
1506 has a type >= SHT_LOOS. Returns TRUE if the fields were initialised,
1507 FALSE otherwise. Can be called multiple times for a given section,
1508 until it returns TRUE. Most of the times it is called ISECTION will be
1509 set to an input section that might be associated with the output section.
1510 The last time that it is called, ISECTION will be set to NULL. */
1511 bool (*elf_backend_copy_special_section_fields)
1512 (const bfd *ibfd, bfd *obfd, const Elf_Internal_Shdr *isection,
1513 Elf_Internal_Shdr *osection);
1515 /* Used to handle bad SHF_LINK_ORDER input. */
1516 void (*link_order_error_handler) (const char *, ...);
1518 /* Name of the PLT relocation section. */
1519 const char *relplt_name;
1521 /* Alternate EM_xxxx machine codes for this backend. */
1522 int elf_machine_alt1;
1523 int elf_machine_alt2;
1525 const struct elf_size_info *s;
1527 /* An array of target specific special sections. */
1528 const struct bfd_elf_special_section *special_sections;
1530 /* The size in bytes of the header for the GOT. This includes the
1531 so-called reserved entries on some systems. */
1532 bfd_vma got_header_size;
1534 /* The size of the GOT entry for the symbol pointed to by H if non-NULL,
1535 otherwise by the local symbol with index SYMNDX in IBFD. */
1536 bfd_vma (*got_elt_size) (bfd *, struct bfd_link_info *,
1537 struct elf_link_hash_entry *h,
1538 bfd *ibfd, unsigned long symndx);
1540 /* The vendor name to use for a processor-standard attributes section. */
1541 const char *obj_attrs_vendor;
1543 /* The section name to use for a processor-standard attributes section. */
1544 const char *obj_attrs_section;
1546 /* Return 1, 2 or 3 to indicate what type of arguments a
1547 processor-specific tag takes. */
1548 int (*obj_attrs_arg_type) (int);
1550 /* The section type to use for an attributes section. */
1551 unsigned int obj_attrs_section_type;
1553 /* This function determines the order in which any attributes are
1554 written. It must be defined for input in the range
1555 LEAST_KNOWN_OBJ_ATTRIBUTE..NUM_KNOWN_OBJ_ATTRIBUTES-1 (this range
1556 is used in order to make unity easy). The returned value is the
1557 actual tag number to place in the input position. */
1558 int (*obj_attrs_order) (int);
1560 /* Handle merging unknown attributes; either warn and return TRUE,
1561 or give an error and return FALSE. */
1562 bool (*obj_attrs_handle_unknown) (bfd *, int);
1564 /* Parse GNU properties. Return the property kind. If the property
1565 is corrupt, issue an error message and return property_corrupt. */
1566 enum elf_property_kind (*parse_gnu_properties) (bfd *, unsigned int,
1567 bfd_byte *,
1568 unsigned int);
1570 /* Merge GNU properties. Return TRUE if property is updated. */
1571 bool (*merge_gnu_properties) (struct bfd_link_info *, bfd *, bfd *,
1572 elf_property *, elf_property *);
1574 /* Set up GNU properties. */
1575 bfd *(*setup_gnu_properties) (struct bfd_link_info *);
1577 /* Fix up GNU properties. */
1578 void (*fixup_gnu_properties) (struct bfd_link_info *,
1579 elf_property_list **);
1581 /* Encoding used for compact EH tables. */
1582 int (*compact_eh_encoding) (struct bfd_link_info *);
1584 /* Opcode representing no unwind. */
1585 int (*cant_unwind_opcode) (struct bfd_link_info *);
1587 /* Called when emitting an ELF symbol whoes input version had an
1588 ST_SHNDX field set to a value in the range SHN_LOPROC..SHN_HIOS.
1589 Returns the value to be installed in the ST_SHNDX field of the
1590 emitted symbol. If not defined, the value is left unchanged. */
1591 unsigned int (*symbol_section_index) (bfd *, elf_symbol_type *);
1593 /* Called when a section has extra reloc sections. */
1594 bool (*init_secondary_reloc_section) (bfd *, Elf_Internal_Shdr *,
1595 const char *, unsigned int);
1597 /* Called when after loading the normal relocs for a section. */
1598 bool (*slurp_secondary_relocs) (bfd *, asection *, asymbol **, bool);
1600 /* Called after writing the normal relocs for a section. */
1601 bool (*write_secondary_relocs) (bfd *, asection *);
1603 /* This is non-zero if static TLS segments require a special alignment. */
1604 unsigned static_tls_alignment;
1606 /* Alignment for the PT_GNU_STACK segment. */
1607 unsigned stack_align;
1609 /* Flag bits to assign to a section of type SHT_STRTAB. */
1610 unsigned long elf_strtab_flags;
1612 /* This is TRUE if the linker should act like collect and gather
1613 global constructors and destructors by name. This is TRUE for
1614 MIPS ELF because the Irix 5 tools can not handle the .init
1615 section. */
1616 unsigned collect : 1;
1618 /* This is TRUE if the linker should ignore changes to the type of a
1619 symbol. This is TRUE for MIPS ELF because some Irix 5 objects
1620 record undefined functions as STT_OBJECT although the definitions
1621 are STT_FUNC. */
1622 unsigned type_change_ok : 1;
1624 /* Whether the backend may use REL relocations. (Some backends use
1625 both REL and RELA relocations, and this flag is set for those
1626 backends.) */
1627 unsigned may_use_rel_p : 1;
1629 /* Whether the backend may use RELA relocations. (Some backends use
1630 both REL and RELA relocations, and this flag is set for those
1631 backends.) */
1632 unsigned may_use_rela_p : 1;
1634 /* Whether the default relocation type is RELA. If a backend with
1635 this flag set wants REL relocations for a particular section,
1636 it must note that explicitly. Similarly, if this flag is clear,
1637 and the backend wants RELA relocations for a particular
1638 section. */
1639 unsigned default_use_rela_p : 1;
1641 /* True if PLT and copy relocations should be RELA by default. */
1642 unsigned rela_plts_and_copies_p : 1;
1644 /* Set if RELA relocations for a relocatable link can be handled by
1645 generic code. Backends that set this flag need do nothing in the
1646 backend relocate_section routine for relocatable linking. */
1647 unsigned rela_normal : 1;
1649 /* Set if DT_REL/DT_RELA/DT_RELSZ/DT_RELASZ should not include PLT
1650 relocations. */
1651 unsigned dtrel_excludes_plt : 1;
1653 /* TRUE if addresses "naturally" sign extend. This is used when
1654 swapping in from Elf32 when BFD64. */
1655 unsigned sign_extend_vma : 1;
1657 unsigned want_got_plt : 1;
1658 unsigned plt_readonly : 1;
1659 unsigned want_plt_sym : 1;
1660 unsigned plt_not_loaded : 1;
1661 unsigned plt_alignment : 4;
1662 unsigned can_gc_sections : 1;
1663 unsigned can_refcount : 1;
1664 unsigned want_got_sym : 1;
1665 unsigned want_dynbss : 1;
1666 unsigned want_dynrelro : 1;
1668 /* Targets which do not support physical addressing often require
1669 that the p_paddr field in the section header to be set to zero.
1670 This field indicates whether this behavior is required. */
1671 unsigned want_p_paddr_set_to_zero : 1;
1673 /* Target has broken hardware and/or kernel that requires pages not
1674 to be mapped twice with different permissions. */
1675 unsigned no_page_alias : 1;
1677 /* True if an object file lacking a .note.GNU-stack section
1678 should be assumed to be requesting exec stack. At least one
1679 other file in the link needs to have a .note.GNU-stack section
1680 for a PT_GNU_STACK segment to be created. */
1681 unsigned default_execstack : 1;
1683 /* True if elf_section_data(sec)->this_hdr.contents is sec->rawsize
1684 in length rather than sec->size in length, if sec->rawsize is
1685 non-zero and smaller than sec->size. */
1686 unsigned caches_rawsize : 1;
1688 /* Address of protected data defined in the shared library may be
1689 external, i.e., due to copy relocation. */
1690 unsigned extern_protected_data : 1;
1692 /* True if `_bfd_elf_link_renumber_dynsyms' must be called even for
1693 static binaries. */
1694 unsigned always_renumber_dynsyms : 1;
1696 /* True if the 32-bit Linux PRPSINFO structure's `pr_uid' and `pr_gid'
1697 members use a 16-bit data type. */
1698 unsigned linux_prpsinfo32_ugid16 : 1;
1700 /* True if the 64-bit Linux PRPSINFO structure's `pr_uid' and `pr_gid'
1701 members use a 16-bit data type. */
1702 unsigned linux_prpsinfo64_ugid16 : 1;
1705 /* Information about reloc sections associated with a bfd_elf_section_data
1706 structure. */
1707 struct bfd_elf_section_reloc_data
1709 /* The ELF header for the reloc section associated with this
1710 section, if any. */
1711 Elf_Internal_Shdr *hdr;
1712 /* The number of relocations currently assigned to HDR. */
1713 unsigned int count;
1714 /* The ELF section number of the reloc section. Only used for an
1715 output file. */
1716 int idx;
1717 /* Used by the backend linker to store the symbol hash table entries
1718 associated with relocs against global symbols. */
1719 struct elf_link_hash_entry **hashes;
1722 /* Information stored for each BFD section in an ELF file. This
1723 structure is allocated by elf_new_section_hook. */
1725 struct bfd_elf_section_data
1727 /* The ELF header for this section. */
1728 Elf_Internal_Shdr this_hdr;
1730 /* INPUT_SECTION_FLAGS if specified in the linker script. */
1731 struct flag_info *section_flag_info;
1733 /* Information about the REL and RELA reloc sections associated
1734 with this section, if any. */
1735 struct bfd_elf_section_reloc_data rel, rela;
1737 /* The ELF section number of this section. */
1738 int this_idx;
1740 /* Used by the backend linker when generating a shared library to
1741 record the dynamic symbol index for a section symbol
1742 corresponding to this section. A value of 0 means that there is
1743 no dynamic symbol for this section. */
1744 int dynindx;
1746 /* A pointer to the linked-to section for SHF_LINK_ORDER. */
1747 asection *linked_to;
1749 /* A pointer to the swapped relocs. If the section uses REL relocs,
1750 rather than RELA, all the r_addend fields will be zero. This
1751 pointer may be NULL. It is used by the backend linker. */
1752 Elf_Internal_Rela *relocs;
1754 /* A pointer to a linked list tracking dynamic relocs copied for
1755 local symbols. */
1756 void *local_dynrel;
1758 /* A pointer to the bfd section used for dynamic relocs. */
1759 asection *sreloc;
1761 union {
1762 /* Group name, if this section is a member of a group. */
1763 const char *name;
1765 /* Group signature sym, if this is the SHT_GROUP section. */
1766 struct bfd_symbol *id;
1767 } group;
1769 /* For a member of a group, points to the SHT_GROUP section.
1770 NULL for the SHT_GROUP section itself and non-group sections. */
1771 asection *sec_group;
1773 /* A linked list of member sections in the group. Circular when used by
1774 the linker. For the SHT_GROUP section, points at first member. */
1775 asection *next_in_group;
1777 /* The FDEs associated with this section. The u.fde.next_in_section
1778 field acts as a chain pointer. */
1779 struct eh_cie_fde *fde_list;
1781 /* Link from a text section to its .eh_frame_entry section. */
1782 asection *eh_frame_entry;
1784 /* TRUE if the section has secondary reloc sections associated with it.
1785 FIXME: In the future it might be better to change this into a list
1786 of secondary reloc sections, making lookup easier and faster. */
1787 bool has_secondary_relocs;
1789 /* A pointer used for various section optimizations. */
1790 void *sec_info;
1793 #define elf_section_data(sec) ((struct bfd_elf_section_data*)(sec)->used_by_bfd)
1794 #define elf_linked_to_section(sec) (elf_section_data(sec)->linked_to)
1795 #define elf_section_type(sec) (elf_section_data(sec)->this_hdr.sh_type)
1796 #define elf_section_flags(sec) (elf_section_data(sec)->this_hdr.sh_flags)
1797 #define elf_section_info(sec) (elf_section_data(sec)->this_hdr.sh_info)
1798 #define elf_group_name(sec) (elf_section_data(sec)->group.name)
1799 #define elf_group_id(sec) (elf_section_data(sec)->group.id)
1800 #define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group)
1801 #define elf_fde_list(sec) (elf_section_data(sec)->fde_list)
1802 #define elf_sec_group(sec) (elf_section_data(sec)->sec_group)
1803 #define elf_section_eh_frame_entry(sec) (elf_section_data(sec)->eh_frame_entry)
1805 #define xvec_get_elf_backend_data(xvec) \
1806 ((const struct elf_backend_data *) (xvec)->backend_data)
1808 #define get_elf_backend_data(abfd) \
1809 xvec_get_elf_backend_data ((abfd)->xvec)
1811 /* The least object attributes (within an attributes subsection) known
1812 for any target. Some code assumes that the value 0 is not used and
1813 the field for that attribute can instead be used as a marker to
1814 indicate that attributes have been initialized. */
1815 #define LEAST_KNOWN_OBJ_ATTRIBUTE 2
1817 /* The maximum number of known object attributes for any target. */
1818 #define NUM_KNOWN_OBJ_ATTRIBUTES 77
1820 /* The value of an object attribute. The type indicates whether the attribute
1821 holds and integer, a string, or both. It can also indicate that there can
1822 be no default (i.e. all values must be written to file, even zero), or
1823 that the value is in error and should not be written to file. */
1825 typedef struct obj_attribute
1827 #define ATTR_TYPE_FLAG_INT_VAL (1 << 0)
1828 #define ATTR_TYPE_FLAG_STR_VAL (1 << 1)
1829 #define ATTR_TYPE_FLAG_NO_DEFAULT (1 << 2)
1830 #define ATTR_TYPE_FLAG_ERROR (1 << 3)
1832 #define ATTR_TYPE_HAS_INT_VAL(TYPE) ((TYPE) & ATTR_TYPE_FLAG_INT_VAL)
1833 #define ATTR_TYPE_HAS_STR_VAL(TYPE) ((TYPE) & ATTR_TYPE_FLAG_STR_VAL)
1834 #define ATTR_TYPE_HAS_NO_DEFAULT(TYPE) ((TYPE) & ATTR_TYPE_FLAG_NO_DEFAULT)
1835 #define ATTR_TYPE_HAS_ERROR(TYPE) ((TYPE) & ATTR_TYPE_FLAG_ERROR)
1837 int type;
1838 unsigned int i;
1839 char *s;
1840 } obj_attribute;
1842 typedef struct obj_attribute_list
1844 struct obj_attribute_list *next;
1845 unsigned int tag;
1846 obj_attribute attr;
1847 } obj_attribute_list;
1849 /* Object attributes may either be defined by the processor ABI, index
1850 OBJ_ATTR_PROC in the *_obj_attributes arrays, or be GNU-specific
1851 (and possibly also processor-specific), index OBJ_ATTR_GNU. */
1852 #define OBJ_ATTR_PROC 0
1853 #define OBJ_ATTR_GNU 1
1854 #define OBJ_ATTR_FIRST OBJ_ATTR_PROC
1855 #define OBJ_ATTR_LAST OBJ_ATTR_GNU
1857 /* The following object attribute tags are taken as generic, for all
1858 targets and for "gnu" where there is no target standard. */
1859 enum
1861 Tag_NULL = 0,
1862 Tag_File = 1,
1863 Tag_Section = 2,
1864 Tag_Symbol = 3,
1865 Tag_compatibility = 32
1868 /* The following struct stores information about every SystemTap section
1869 found in the object file. */
1870 struct sdt_note
1872 struct sdt_note *next;
1873 bfd_size_type size;
1874 bfd_byte data[1];
1877 /* tdata information grabbed from an elf core file. */
1878 struct core_elf_obj_tdata
1880 int signal;
1881 int pid;
1882 int lwpid;
1883 char* program;
1884 char* command;
1887 /* Extra tdata information held for output ELF BFDs. */
1888 struct output_elf_obj_tdata
1890 struct elf_segment_map *seg_map;
1891 struct elf_strtab_hash *strtab_ptr;
1893 /* STT_SECTION symbols for each section */
1894 asymbol **section_syms;
1896 /* Used to determine if PT_GNU_EH_FRAME segment header should be
1897 created. */
1898 asection *eh_frame_hdr;
1900 /* NT_GNU_BUILD_ID note type info. */
1901 struct
1903 bool (*after_write_object_contents) (bfd *);
1904 const char *style;
1905 asection *sec;
1906 } build_id;
1908 /* Records the result of `get_program_header_size'. */
1909 bfd_size_type program_header_size;
1911 /* Used when laying out sections. */
1912 file_ptr next_file_pos;
1914 /* Linker information. */
1915 struct bfd_link_info *link_info;
1917 int num_section_syms;
1918 unsigned int shstrtab_section, strtab_section;
1920 /* Segment flags for the PT_GNU_STACK segment. */
1921 unsigned int stack_flags;
1923 /* Used to determine if the e_flags field has been initialized */
1924 bool flags_init;
1927 /* Indicate if the bfd contains SHF_GNU_MBIND/SHF_GNU_RETAIN sections or
1928 symbols that have the STT_GNU_IFUNC symbol type or STB_GNU_UNIQUE
1929 binding. Used to set the osabi field in the ELF header structure. */
1930 enum elf_gnu_osabi
1932 elf_gnu_osabi_mbind = 1 << 0,
1933 elf_gnu_osabi_ifunc = 1 << 1,
1934 elf_gnu_osabi_unique = 1 << 2,
1935 elf_gnu_osabi_retain = 1 << 3,
1938 typedef struct elf_section_list
1940 Elf_Internal_Shdr hdr;
1941 unsigned int ndx;
1942 struct elf_section_list * next;
1943 } elf_section_list;
1945 enum dynamic_lib_link_class {
1946 DYN_NORMAL = 0,
1947 DYN_AS_NEEDED = 1,
1948 DYN_DT_NEEDED = 2,
1949 DYN_NO_ADD_NEEDED = 4,
1950 DYN_NO_NEEDED = 8
1953 /* Some private data is stashed away for future use using the tdata pointer
1954 in the bfd structure. */
1956 struct elf_obj_tdata
1958 Elf_Internal_Ehdr elf_header[1]; /* Actual data, but ref like ptr */
1959 Elf_Internal_Shdr **elf_sect_ptr;
1960 Elf_Internal_Phdr *phdr;
1961 Elf_Internal_Shdr symtab_hdr;
1962 Elf_Internal_Shdr shstrtab_hdr;
1963 Elf_Internal_Shdr strtab_hdr;
1964 Elf_Internal_Shdr dynsymtab_hdr;
1965 Elf_Internal_Shdr dynstrtab_hdr;
1966 Elf_Internal_Shdr dynversym_hdr;
1967 Elf_Internal_Shdr dynverref_hdr;
1968 Elf_Internal_Shdr dynverdef_hdr;
1969 elf_section_list * symtab_shndx_list;
1970 bfd_vma gp; /* The gp value */
1971 unsigned int gp_size; /* The gp size */
1972 unsigned int num_elf_sections; /* elf_sect_ptr size */
1973 unsigned char *being_created;
1975 /* A mapping from external symbols to entries in the linker hash
1976 table, used when linking. This is indexed by the symbol index
1977 minus the sh_info field of the symbol table header. */
1978 struct elf_link_hash_entry **sym_hashes;
1980 /* Track usage and final offsets of GOT entries for local symbols.
1981 This array is indexed by symbol index. Elements are used
1982 identically to "got" in struct elf_link_hash_entry. */
1983 union
1985 bfd_signed_vma *refcounts;
1986 bfd_vma *offsets;
1987 struct got_entry **ents;
1988 } local_got;
1990 /* The linker ELF emulation code needs to let the backend ELF linker
1991 know what filename should be used for a dynamic object if the
1992 dynamic object is found using a search. The emulation code then
1993 sometimes needs to know what name was actually used. Until the
1994 file has been added to the linker symbol table, this field holds
1995 the name the linker wants. After it has been added, it holds the
1996 name actually used, which will be the DT_SONAME entry if there is
1997 one. */
1998 const char *dt_name;
2000 /* The linker emulation needs to know what audit libs
2001 are used by a dynamic object. */
2002 const char *dt_audit;
2004 /* Used by find_nearest_line entry point. */
2005 void *line_info;
2007 /* A place to stash dwarf1 info for this bfd. */
2008 struct dwarf1_debug *dwarf1_find_line_info;
2010 /* A place to stash dwarf2 info for this bfd. */
2011 void *dwarf2_find_line_info;
2013 /* Stash away info for yet another find line/function variant. */
2014 void *elf_find_function_cache;
2016 /* Number of symbol version definitions we are about to emit. */
2017 unsigned int cverdefs;
2019 /* Number of symbol version references we are about to emit. */
2020 unsigned int cverrefs;
2022 /* Symbol version definitions in external objects. */
2023 Elf_Internal_Verdef *verdef;
2025 /* Symbol version references to external objects. */
2026 Elf_Internal_Verneed *verref;
2028 /* A pointer to the .eh_frame section. */
2029 asection *eh_frame_section;
2031 /* Symbol buffer. */
2032 void *symbuf;
2034 /* List of GNU properties. Will be updated by setup_gnu_properties
2035 after all input GNU properties are merged for output. */
2036 elf_property_list *properties;
2038 obj_attribute known_obj_attributes[2][NUM_KNOWN_OBJ_ATTRIBUTES];
2039 obj_attribute_list *other_obj_attributes[2];
2041 /* Linked-list containing information about every Systemtap section
2042 found in the object file. Each section corresponds to one entry
2043 in the list. */
2044 struct sdt_note *sdt_note_head;
2046 Elf_Internal_Shdr **group_sect_ptr;
2047 unsigned int num_group;
2049 /* Index into group_sect_ptr, updated by setup_group when finding a
2050 section's group. Used to optimize subsequent group searches. */
2051 unsigned int group_search_offset;
2053 unsigned int symtab_section, dynsymtab_section;
2054 unsigned int dynversym_section, dynverdef_section, dynverref_section;
2056 /* An identifier used to distinguish different target
2057 specific extensions to this structure. */
2058 ENUM_BITFIELD (elf_target_id) object_id : 6;
2060 /* Whether a dyanmic object was specified normally on the linker
2061 command line, or was specified when --as-needed was in effect,
2062 or was found via a DT_NEEDED entry. */
2063 ENUM_BITFIELD (dynamic_lib_link_class) dyn_lib_class : 4;
2065 /* Whether the bfd uses OS specific bits that require ELFOSABI_GNU. */
2066 ENUM_BITFIELD (elf_gnu_osabi) has_gnu_osabi : 4;
2068 /* Whether if the bfd contains the GNU_PROPERTY_NO_COPY_ON_PROTECTED
2069 property. */
2070 unsigned int has_no_copy_on_protected : 1;
2072 /* Whether if the bfd contains the
2073 GNU_PROPERTY_1_NEEDED_INDIRECT_EXTERN_ACCESS property. */
2074 unsigned int has_indirect_extern_access : 1;
2076 /* Irix 5 often screws up the symbol table, sorting local symbols
2077 after global symbols. This flag is set if the symbol table in
2078 this BFD appears to be screwed up. If it is, we ignore the
2079 sh_info field in the symbol table header, and always read all the
2080 symbols. */
2081 unsigned int bad_symtab : 1;
2083 /* Set if DT_FLAGS_1 has DF_1_PIE set. */
2084 unsigned int is_pie : 1;
2086 /* Information grabbed from an elf core file. */
2087 struct core_elf_obj_tdata *core;
2089 /* More information held for output ELF BFDs. */
2090 struct output_elf_obj_tdata *o;
2093 #define elf_tdata(bfd) ((bfd) -> tdata.elf_obj_data)
2095 #define elf_object_id(bfd) (elf_tdata(bfd) -> object_id)
2096 #define elf_program_header_size(bfd) (elf_tdata(bfd) -> o->program_header_size)
2097 #define elf_elfheader(bfd) (elf_tdata(bfd) -> elf_header)
2098 #define elf_elfsections(bfd) (elf_tdata(bfd) -> elf_sect_ptr)
2099 #define elf_numsections(bfd) (elf_tdata(bfd) -> num_elf_sections)
2100 #define elf_seg_map(bfd) (elf_tdata(bfd) -> o->seg_map)
2101 #define elf_link_info(bfd) (elf_tdata(bfd) -> o->link_info)
2102 #define elf_next_file_pos(bfd) (elf_tdata(bfd) -> o->next_file_pos)
2103 #define elf_eh_frame_hdr(bfd) (elf_tdata(bfd) -> o->eh_frame_hdr)
2104 #define elf_stack_flags(bfd) (elf_tdata(bfd) -> o->stack_flags)
2105 #define elf_shstrtab(bfd) (elf_tdata(bfd) -> o->strtab_ptr)
2106 #define elf_onesymtab(bfd) (elf_tdata(bfd) -> symtab_section)
2107 #define elf_symtab_shndx_list(bfd) (elf_tdata(bfd) -> symtab_shndx_list)
2108 #define elf_strtab_sec(bfd) (elf_tdata(bfd) -> o->strtab_section)
2109 #define elf_shstrtab_sec(bfd) (elf_tdata(bfd) -> o->shstrtab_section)
2110 #define elf_symtab_hdr(bfd) (elf_tdata(bfd) -> symtab_hdr)
2111 #define elf_dynsymtab(bfd) (elf_tdata(bfd) -> dynsymtab_section)
2112 #define elf_dynversym(bfd) (elf_tdata(bfd) -> dynversym_section)
2113 #define elf_dynverdef(bfd) (elf_tdata(bfd) -> dynverdef_section)
2114 #define elf_dynverref(bfd) (elf_tdata(bfd) -> dynverref_section)
2115 #define elf_eh_frame_section(bfd) \
2116 (elf_tdata(bfd) -> eh_frame_section)
2117 #define elf_section_syms(bfd) (elf_tdata(bfd) -> o->section_syms)
2118 #define elf_num_section_syms(bfd) (elf_tdata(bfd) -> o->num_section_syms)
2119 #define core_prpsinfo(bfd) (elf_tdata(bfd) -> prpsinfo)
2120 #define core_prstatus(bfd) (elf_tdata(bfd) -> prstatus)
2121 #define elf_gp(bfd) (elf_tdata(bfd) -> gp)
2122 #define elf_gp_size(bfd) (elf_tdata(bfd) -> gp_size)
2123 #define elf_sym_hashes(bfd) (elf_tdata(bfd) -> sym_hashes)
2124 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
2125 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
2126 #define elf_local_got_ents(bfd) (elf_tdata(bfd) -> local_got.ents)
2127 #define elf_dt_name(bfd) (elf_tdata(bfd) -> dt_name)
2128 #define elf_dt_audit(bfd) (elf_tdata(bfd) -> dt_audit)
2129 #define elf_dyn_lib_class(bfd) (elf_tdata(bfd) -> dyn_lib_class)
2130 #define elf_bad_symtab(bfd) (elf_tdata(bfd) -> bad_symtab)
2131 #define elf_flags_init(bfd) (elf_tdata(bfd) -> o->flags_init)
2132 #define elf_known_obj_attributes(bfd) (elf_tdata (bfd) -> known_obj_attributes)
2133 #define elf_other_obj_attributes(bfd) (elf_tdata (bfd) -> other_obj_attributes)
2134 #define elf_known_obj_attributes_proc(bfd) \
2135 (elf_known_obj_attributes (bfd) [OBJ_ATTR_PROC])
2136 #define elf_other_obj_attributes_proc(bfd) \
2137 (elf_other_obj_attributes (bfd) [OBJ_ATTR_PROC])
2138 #define elf_properties(bfd) (elf_tdata (bfd) -> properties)
2139 #define elf_has_no_copy_on_protected(bfd) \
2140 (elf_tdata(bfd) -> has_no_copy_on_protected)
2141 #define elf_has_indirect_extern_access(bfd) \
2142 (elf_tdata(bfd) -> has_indirect_extern_access)
2144 extern void _bfd_elf_swap_verdef_in
2145 (bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *);
2146 extern void _bfd_elf_swap_verdef_out
2147 (bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *);
2148 extern void _bfd_elf_swap_verdaux_in
2149 (bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *);
2150 extern void _bfd_elf_swap_verdaux_out
2151 (bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *);
2152 extern void _bfd_elf_swap_verneed_in
2153 (bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *);
2154 extern void _bfd_elf_swap_verneed_out
2155 (bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *);
2156 extern void _bfd_elf_swap_vernaux_in
2157 (bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *);
2158 extern void _bfd_elf_swap_vernaux_out
2159 (bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *);
2160 extern void _bfd_elf_swap_versym_in
2161 (bfd *, const Elf_External_Versym *, Elf_Internal_Versym *);
2162 extern void _bfd_elf_swap_versym_out
2163 (bfd *, const Elf_Internal_Versym *, Elf_External_Versym *);
2165 extern unsigned int _bfd_elf_section_from_bfd_section
2166 (bfd *, asection *);
2167 extern char *bfd_elf_string_from_elf_section
2168 (bfd *, unsigned, unsigned);
2169 extern Elf_Internal_Sym *bfd_elf_get_elf_syms
2170 (bfd *, Elf_Internal_Shdr *, size_t, size_t, Elf_Internal_Sym *, void *,
2171 Elf_External_Sym_Shndx *);
2172 extern char * bfd_elf_get_str_section (bfd *, unsigned int);
2173 extern const char *bfd_elf_sym_name
2174 (bfd *, Elf_Internal_Shdr *, Elf_Internal_Sym *, asection *);
2176 extern bool _bfd_elf_copy_private_bfd_data
2177 (bfd *, bfd *);
2178 extern bool _bfd_elf_print_private_bfd_data
2179 (bfd *, void *);
2180 const char * _bfd_elf_get_symbol_version_string
2181 (bfd *, asymbol *, bool, bool *);
2182 extern void bfd_elf_print_symbol
2183 (bfd *, void *, asymbol *, bfd_print_symbol_type);
2185 extern unsigned int _bfd_elf_eh_frame_address_size
2186 (bfd *, const asection *);
2187 extern bfd_byte _bfd_elf_encode_eh_address
2188 (bfd *abfd, struct bfd_link_info *info, asection *osec, bfd_vma offset,
2189 asection *loc_sec, bfd_vma loc_offset, bfd_vma *encoded);
2190 extern bool _bfd_elf_can_make_relative
2191 (bfd *input_bfd, struct bfd_link_info *info, asection *eh_frame_section);
2193 extern enum elf_reloc_type_class _bfd_elf_reloc_type_class
2194 (const struct bfd_link_info *, const asection *,
2195 const Elf_Internal_Rela *);
2196 extern bfd_vma _bfd_elf_rela_local_sym
2197 (bfd *, Elf_Internal_Sym *, asection **, Elf_Internal_Rela *);
2198 extern bfd_vma _bfd_elf_rel_local_sym
2199 (bfd *, Elf_Internal_Sym *, asection **, bfd_vma);
2200 extern bfd_vma _bfd_elf_section_offset
2201 (bfd *, struct bfd_link_info *, asection *, bfd_vma);
2203 extern unsigned long bfd_elf_hash
2204 (const char *);
2205 extern unsigned long bfd_elf_gnu_hash
2206 (const char *);
2208 extern bfd_reloc_status_type bfd_elf_generic_reloc
2209 (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
2210 extern bool bfd_elf_allocate_object
2211 (bfd *, size_t, enum elf_target_id);
2212 extern bool bfd_elf_make_object
2213 (bfd *);
2214 extern bool bfd_elf_mkcorefile
2215 (bfd *);
2216 extern bool _bfd_elf_make_section_from_shdr
2217 (bfd *, Elf_Internal_Shdr *, const char *, int);
2218 extern bool _bfd_elf_make_section_from_phdr
2219 (bfd *, Elf_Internal_Phdr *, int, const char *);
2220 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
2221 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
2222 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
2223 (bfd *);
2224 extern void _bfd_elf_link_hash_table_free
2225 (bfd *);
2226 extern void _bfd_elf_link_hash_copy_indirect
2227 (struct bfd_link_info *, struct elf_link_hash_entry *,
2228 struct elf_link_hash_entry *);
2229 extern void _bfd_elf_link_hash_hide_symbol
2230 (struct bfd_link_info *, struct elf_link_hash_entry *, bool);
2231 extern void _bfd_elf_link_hide_symbol
2232 (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *);
2233 extern bool _bfd_elf_link_hash_fixup_symbol
2234 (struct bfd_link_info *, struct elf_link_hash_entry *);
2235 extern bool _bfd_elf_link_hash_table_init
2236 (struct elf_link_hash_table *, bfd *,
2237 struct bfd_hash_entry *(*)
2238 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *),
2239 unsigned int, enum elf_target_id);
2240 extern bool _bfd_elf_slurp_version_tables
2241 (bfd *, bool);
2242 extern bool _bfd_elf_merge_sections
2243 (bfd *, struct bfd_link_info *);
2244 extern bool _bfd_elf_match_sections_by_type
2245 (bfd *, const asection *, bfd *, const asection *);
2246 extern bool bfd_elf_is_group_section
2247 (bfd *, const struct bfd_section *);
2248 extern const char *bfd_elf_group_name
2249 (bfd *, const struct bfd_section *);
2250 extern bool _bfd_elf_section_already_linked
2251 (bfd *, asection *, struct bfd_link_info *);
2252 extern void bfd_elf_set_group_contents
2253 (bfd *, asection *, void *);
2254 extern unsigned int _bfd_elf_filter_global_symbols
2255 (bfd *, struct bfd_link_info *, asymbol **, long);
2256 extern asection *_bfd_elf_check_kept_section
2257 (asection *, struct bfd_link_info *);
2258 #define _bfd_elf_link_just_syms _bfd_generic_link_just_syms
2259 extern void _bfd_elf_copy_link_hash_symbol_type
2260 (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *);
2261 extern bool _bfd_elf_size_group_sections
2262 (struct bfd_link_info *);
2263 extern bool _bfd_elf_fixup_group_sections
2264 (bfd *, asection *);
2265 extern bool _bfd_elf_copy_private_header_data
2266 (bfd *, bfd *);
2267 extern bool _bfd_elf_copy_private_symbol_data
2268 (bfd *, asymbol *, bfd *, asymbol *);
2269 #define _bfd_generic_init_private_section_data \
2270 _bfd_elf_init_private_section_data
2271 extern bool _bfd_elf_init_private_section_data
2272 (bfd *, asection *, bfd *, asection *, struct bfd_link_info *);
2273 extern bool _bfd_elf_copy_private_section_data
2274 (bfd *, asection *, bfd *, asection *);
2275 extern bool _bfd_elf_write_object_contents
2276 (bfd *);
2277 extern bool _bfd_elf_write_corefile_contents
2278 (bfd *);
2279 extern bool _bfd_elf_set_section_contents
2280 (bfd *, sec_ptr, const void *, file_ptr, bfd_size_type);
2281 extern long _bfd_elf_get_symtab_upper_bound
2282 (bfd *);
2283 extern long _bfd_elf_canonicalize_symtab
2284 (bfd *, asymbol **);
2285 extern long _bfd_elf_get_dynamic_symtab_upper_bound
2286 (bfd *);
2287 extern long _bfd_elf_canonicalize_dynamic_symtab
2288 (bfd *, asymbol **);
2289 extern long _bfd_elf_get_synthetic_symtab
2290 (bfd *, long, asymbol **, long, asymbol **, asymbol **);
2291 extern long _bfd_elf_get_reloc_upper_bound
2292 (bfd *, sec_ptr);
2293 extern long _bfd_elf_canonicalize_reloc
2294 (bfd *, sec_ptr, arelent **, asymbol **);
2295 extern asection * _bfd_elf_get_dynamic_reloc_section
2296 (bfd *, asection *, bool);
2297 extern asection * _bfd_elf_make_dynamic_reloc_section
2298 (asection *, bfd *, unsigned int, bfd *, bool);
2299 extern long _bfd_elf_get_dynamic_reloc_upper_bound
2300 (bfd *);
2301 extern long _bfd_elf_canonicalize_dynamic_reloc
2302 (bfd *, arelent **, asymbol **);
2303 extern asymbol *_bfd_elf_make_empty_symbol
2304 (bfd *);
2305 extern void _bfd_elf_get_symbol_info
2306 (bfd *, asymbol *, symbol_info *);
2307 extern bool _bfd_elf_is_local_label_name
2308 (bfd *, const char *);
2309 extern alent *_bfd_elf_get_lineno
2310 (bfd *, asymbol *);
2311 extern bool _bfd_elf_set_arch_mach
2312 (bfd *, enum bfd_architecture, unsigned long);
2313 extern bool _bfd_elf_find_nearest_line
2314 (bfd *, asymbol **, asection *, bfd_vma,
2315 const char **, const char **, unsigned int *, unsigned int *);
2316 extern bool _bfd_elf_find_line
2317 (bfd *, asymbol **, asymbol *, const char **, unsigned int *);
2318 extern bool _bfd_elf_find_inliner_info
2319 (bfd *, const char **, const char **, unsigned int *);
2320 extern asymbol *_bfd_elf_find_function
2321 (bfd *, asymbol **, asection *, bfd_vma, const char **, const char **);
2322 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
2323 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
2324 extern int _bfd_elf_sizeof_headers
2325 (bfd *, struct bfd_link_info *);
2326 extern bool _bfd_elf_new_section_hook
2327 (bfd *, asection *);
2328 extern const struct bfd_elf_special_section *_bfd_elf_get_special_section
2329 (const char *, const struct bfd_elf_special_section *, unsigned int);
2330 extern const struct bfd_elf_special_section *_bfd_elf_get_sec_type_attr
2331 (bfd *, asection *);
2333 extern bool _bfd_elf_link_hide_sym_by_version
2334 (struct bfd_link_info *, struct elf_link_hash_entry *);
2336 /* If the target doesn't have reloc handling written yet: */
2337 extern bool _bfd_elf_no_info_to_howto
2338 (bfd *, arelent *, Elf_Internal_Rela *);
2340 extern bool bfd_section_from_shdr
2341 (bfd *, unsigned int shindex);
2342 extern bool bfd_section_from_phdr
2343 (bfd *, Elf_Internal_Phdr *, int);
2345 extern int _bfd_elf_symbol_from_bfd_symbol
2346 (bfd *, asymbol **);
2348 extern Elf_Internal_Sym *bfd_sym_from_r_symndx
2349 (struct sym_cache *, bfd *, unsigned long);
2350 extern asection *bfd_section_from_elf_index
2351 (bfd *, unsigned int);
2353 extern struct elf_strtab_hash * _bfd_elf_strtab_init
2354 (void);
2355 extern void _bfd_elf_strtab_free
2356 (struct elf_strtab_hash *);
2357 extern size_t _bfd_elf_strtab_add
2358 (struct elf_strtab_hash *, const char *, bool);
2359 extern void _bfd_elf_strtab_addref
2360 (struct elf_strtab_hash *, size_t);
2361 extern void _bfd_elf_strtab_delref
2362 (struct elf_strtab_hash *, size_t);
2363 extern unsigned int _bfd_elf_strtab_refcount
2364 (struct elf_strtab_hash *, size_t);
2365 extern void _bfd_elf_strtab_clear_all_refs
2366 (struct elf_strtab_hash *);
2367 extern void *_bfd_elf_strtab_save
2368 (struct elf_strtab_hash *);
2369 extern void _bfd_elf_strtab_restore
2370 (struct elf_strtab_hash *, void *);
2371 extern bfd_size_type _bfd_elf_strtab_size
2372 (struct elf_strtab_hash *);
2373 extern bfd_size_type _bfd_elf_strtab_len
2374 (struct elf_strtab_hash *);
2375 extern bfd_size_type _bfd_elf_strtab_offset
2376 (struct elf_strtab_hash *, size_t);
2377 extern const char * _bfd_elf_strtab_str
2378 (struct elf_strtab_hash *, size_t idx, bfd_size_type *offset);
2379 extern bool _bfd_elf_strtab_emit
2380 (bfd *, struct elf_strtab_hash *);
2381 extern void _bfd_elf_strtab_finalize
2382 (struct elf_strtab_hash *);
2384 extern bool bfd_elf_parse_eh_frame_entries
2385 (bfd *, struct bfd_link_info *);
2386 extern bool _bfd_elf_parse_eh_frame_entry
2387 (struct bfd_link_info *, asection *, struct elf_reloc_cookie *);
2388 extern void _bfd_elf_parse_eh_frame
2389 (bfd *, struct bfd_link_info *, asection *, struct elf_reloc_cookie *);
2390 extern bool _bfd_elf_end_eh_frame_parsing
2391 (struct bfd_link_info *info);
2393 extern bool _bfd_elf_discard_section_eh_frame
2394 (bfd *, struct bfd_link_info *, asection *,
2395 bool (*) (bfd_vma, void *), struct elf_reloc_cookie *);
2396 extern bool _bfd_elf_adjust_eh_frame_global_symbol
2397 (struct elf_link_hash_entry *, void *);
2398 extern bool _bfd_elf_discard_section_eh_frame_hdr
2399 (bfd *, struct bfd_link_info *);
2400 extern bfd_vma _bfd_elf_eh_frame_section_offset
2401 (bfd *, struct bfd_link_info *, asection *, bfd_vma);
2402 extern bool _bfd_elf_write_section_eh_frame
2403 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
2404 bool _bfd_elf_write_section_eh_frame_entry
2405 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
2406 extern bool _bfd_elf_fixup_eh_frame_hdr (struct bfd_link_info *);
2407 extern bool _bfd_elf_write_section_eh_frame_hdr
2408 (bfd *, struct bfd_link_info *);
2409 extern bool _bfd_elf_eh_frame_present
2410 (struct bfd_link_info *);
2411 extern bool _bfd_elf_eh_frame_entry_present
2412 (struct bfd_link_info *);
2413 extern bool _bfd_elf_maybe_strip_eh_frame_hdr
2414 (struct bfd_link_info *);
2416 extern bool _bfd_elf_hash_symbol (struct elf_link_hash_entry *);
2418 extern long _bfd_elf_link_lookup_local_dynindx
2419 (struct bfd_link_info *, bfd *, long);
2420 extern bool _bfd_elf_compute_section_file_positions
2421 (bfd *, struct bfd_link_info *);
2422 extern file_ptr _bfd_elf_assign_file_position_for_section
2423 (Elf_Internal_Shdr *, file_ptr, bool);
2424 extern bool _bfd_elf_modify_headers
2425 (bfd *, struct bfd_link_info *);
2427 extern bool _bfd_elf_validate_reloc
2428 (bfd *, arelent *);
2430 extern bool bfd_elf_record_link_assignment
2431 (bfd *, struct bfd_link_info *, const char *, bool,
2432 bool);
2433 extern bool bfd_elf_stack_segment_size (bfd *, struct bfd_link_info *,
2434 const char *, bfd_vma);
2435 extern bool bfd_elf_size_dynamic_sections
2436 (bfd *, const char *, const char *, const char *, const char *, const char *,
2437 const char * const *, struct bfd_link_info *, struct bfd_section **);
2438 extern bool bfd_elf_size_dynsym_hash_dynstr
2439 (bfd *, struct bfd_link_info *);
2440 extern bool bfd_elf_get_bfd_needed_list
2441 (bfd *, struct bfd_link_needed_list **);
2442 extern struct bfd_link_needed_list *bfd_elf_get_needed_list
2443 (bfd *, struct bfd_link_info *);
2444 extern void bfd_elf_set_dt_needed_name
2445 (bfd *, const char *);
2446 extern const char *bfd_elf_get_dt_soname
2447 (bfd *);
2448 extern void bfd_elf_set_dyn_lib_class
2449 (bfd *, enum dynamic_lib_link_class);
2450 extern int bfd_elf_get_dyn_lib_class
2451 (bfd *);
2452 extern struct bfd_link_needed_list *bfd_elf_get_runpath_list
2453 (bfd *, struct bfd_link_info *);
2454 extern int bfd_elf_discard_info
2455 (bfd *, struct bfd_link_info *);
2456 extern unsigned int _bfd_elf_default_action_discarded
2457 (struct bfd_section *);
2458 extern struct bfd_section *_bfd_elf_tls_setup
2459 (bfd *, struct bfd_link_info *);
2461 extern bool _bfd_elf_link_create_dynamic_sections
2462 (bfd *, struct bfd_link_info *);
2463 extern bool _bfd_elf_omit_section_dynsym_default
2464 (bfd *, struct bfd_link_info *, asection *);
2465 extern bool _bfd_elf_omit_section_dynsym_all
2466 (bfd *, struct bfd_link_info *, asection *);
2467 extern bool _bfd_elf_create_dynamic_sections
2468 (bfd *, struct bfd_link_info *);
2469 extern bool _bfd_elf_create_got_section
2470 (bfd *, struct bfd_link_info *);
2471 extern asection *_bfd_elf_section_for_symbol
2472 (struct elf_reloc_cookie *, unsigned long, bool);
2473 extern struct elf_link_hash_entry *_bfd_elf_define_linkage_sym
2474 (bfd *, struct bfd_link_info *, asection *, const char *);
2475 extern void _bfd_elf_init_1_index_section
2476 (bfd *, struct bfd_link_info *);
2477 extern void _bfd_elf_init_2_index_sections
2478 (bfd *, struct bfd_link_info *);
2480 extern bool _bfd_elfcore_make_pseudosection
2481 (bfd *, char *, size_t, ufile_ptr);
2482 extern char *_bfd_elfcore_strndup
2483 (bfd *, char *, size_t);
2485 extern Elf_Internal_Rela *_bfd_elf_link_read_relocs
2486 (bfd *, asection *, void *, Elf_Internal_Rela *, bool);
2487 extern Elf_Internal_Rela *_bfd_elf_link_info_read_relocs
2488 (bfd *, struct bfd_link_info *, asection *, void *, Elf_Internal_Rela *,
2489 bool);
2491 extern bool _bfd_elf_link_output_relocs
2492 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *,
2493 struct elf_link_hash_entry **);
2495 extern bool _bfd_elf_adjust_dynamic_copy
2496 (struct bfd_link_info *, struct elf_link_hash_entry *, asection *);
2498 extern bool _bfd_elf_dynamic_symbol_p
2499 (struct elf_link_hash_entry *, struct bfd_link_info *, bool);
2501 extern bool _bfd_elf_symbol_refs_local_p
2502 (struct elf_link_hash_entry *, struct bfd_link_info *, bool);
2504 extern bfd_reloc_status_type bfd_elf_perform_complex_relocation
2505 (bfd *, asection *, bfd_byte *, Elf_Internal_Rela *, bfd_vma);
2507 extern bool _bfd_elf_setup_sections
2508 (bfd *);
2510 extern struct bfd_link_hash_entry *bfd_elf_define_start_stop
2511 (struct bfd_link_info *, const char *, asection *);
2513 extern bool _bfd_elf_init_file_header (bfd *, struct bfd_link_info *);
2515 extern bool _bfd_elf_final_write_processing (bfd *);
2517 extern bfd_cleanup bfd_elf32_object_p
2518 (bfd *);
2519 extern bfd_cleanup bfd_elf32_core_file_p
2520 (bfd *);
2521 extern char *bfd_elf32_core_file_failing_command
2522 (bfd *);
2523 extern int bfd_elf32_core_file_failing_signal
2524 (bfd *);
2525 extern bool bfd_elf32_core_file_matches_executable_p
2526 (bfd *, bfd *);
2527 extern int bfd_elf32_core_file_pid
2528 (bfd *);
2529 extern bool _bfd_elf32_core_find_build_id
2530 (bfd *, bfd_vma);
2532 extern bool bfd_elf32_swap_symbol_in
2533 (bfd *, const void *, const void *, Elf_Internal_Sym *);
2534 extern void bfd_elf32_swap_symbol_out
2535 (bfd *, const Elf_Internal_Sym *, void *, void *);
2536 extern void bfd_elf32_swap_reloc_in
2537 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2538 extern void bfd_elf32_swap_reloc_out
2539 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2540 extern void bfd_elf32_swap_reloca_in
2541 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2542 extern void bfd_elf32_swap_reloca_out
2543 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2544 extern void bfd_elf32_swap_phdr_in
2545 (bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *);
2546 extern void bfd_elf32_swap_phdr_out
2547 (bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *);
2548 extern void bfd_elf32_swap_dyn_in
2549 (bfd *, const void *, Elf_Internal_Dyn *);
2550 extern void bfd_elf32_swap_dyn_out
2551 (bfd *, const Elf_Internal_Dyn *, void *);
2552 extern long bfd_elf32_slurp_symbol_table
2553 (bfd *, asymbol **, bool);
2554 extern bool bfd_elf32_write_shdrs_and_ehdr
2555 (bfd *);
2556 extern int bfd_elf32_write_out_phdrs
2557 (bfd *, const Elf_Internal_Phdr *, unsigned int);
2558 extern bool bfd_elf32_checksum_contents
2559 (bfd * , void (*) (const void *, size_t, void *), void *);
2560 extern void bfd_elf32_write_relocs
2561 (bfd *, asection *, void *);
2562 extern bool bfd_elf32_slurp_reloc_table
2563 (bfd *, asection *, asymbol **, bool);
2565 extern bfd_cleanup bfd_elf64_object_p
2566 (bfd *);
2567 extern bfd_cleanup bfd_elf64_core_file_p
2568 (bfd *);
2569 extern char *bfd_elf64_core_file_failing_command
2570 (bfd *);
2571 extern int bfd_elf64_core_file_failing_signal
2572 (bfd *);
2573 extern bool bfd_elf64_core_file_matches_executable_p
2574 (bfd *, bfd *);
2575 extern int bfd_elf64_core_file_pid
2576 (bfd *);
2577 extern bool _bfd_elf64_core_find_build_id
2578 (bfd *, bfd_vma);
2580 extern bool bfd_elf64_swap_symbol_in
2581 (bfd *, const void *, const void *, Elf_Internal_Sym *);
2582 extern void bfd_elf64_swap_symbol_out
2583 (bfd *, const Elf_Internal_Sym *, void *, void *);
2584 extern void bfd_elf64_swap_reloc_in
2585 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2586 extern void bfd_elf64_swap_reloc_out
2587 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2588 extern void bfd_elf64_swap_reloca_in
2589 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2590 extern void bfd_elf64_swap_reloca_out
2591 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2592 extern void bfd_elf64_swap_phdr_in
2593 (bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *);
2594 extern void bfd_elf64_swap_phdr_out
2595 (bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *);
2596 extern void bfd_elf64_swap_dyn_in
2597 (bfd *, const void *, Elf_Internal_Dyn *);
2598 extern void bfd_elf64_swap_dyn_out
2599 (bfd *, const Elf_Internal_Dyn *, void *);
2600 extern long bfd_elf64_slurp_symbol_table
2601 (bfd *, asymbol **, bool);
2602 extern bool bfd_elf64_write_shdrs_and_ehdr
2603 (bfd *);
2604 extern int bfd_elf64_write_out_phdrs
2605 (bfd *, const Elf_Internal_Phdr *, unsigned int);
2606 extern bool bfd_elf64_checksum_contents
2607 (bfd * , void (*) (const void *, size_t, void *), void *);
2608 extern void bfd_elf64_write_relocs
2609 (bfd *, asection *, void *);
2610 extern bool bfd_elf64_slurp_reloc_table
2611 (bfd *, asection *, asymbol **, bool);
2613 extern bool _bfd_elf_default_relocs_compatible
2614 (const bfd_target *, const bfd_target *);
2616 extern bool _bfd_elf_relocs_compatible
2617 (const bfd_target *, const bfd_target *);
2618 extern bool _bfd_elf_notice_as_needed
2619 (bfd *, struct bfd_link_info *, enum notice_asneeded_action);
2621 extern struct bfd_link_hash_entry *_bfd_elf_archive_symbol_lookup
2622 (bfd *, struct bfd_link_info *, const char *);
2623 extern bool bfd_elf_link_add_symbols
2624 (bfd *, struct bfd_link_info *);
2625 extern bool _bfd_elf_add_dynamic_entry
2626 (struct bfd_link_info *, bfd_vma, bfd_vma);
2627 extern bool _bfd_elf_strip_zero_sized_dynamic_sections
2628 (struct bfd_link_info *);
2629 extern int bfd_elf_add_dt_needed_tag
2630 (bfd *, struct bfd_link_info *);
2631 extern bool _bfd_elf_link_check_relocs
2632 (bfd *, struct bfd_link_info *);
2634 extern bool bfd_elf_link_record_dynamic_symbol
2635 (struct bfd_link_info *, struct elf_link_hash_entry *);
2637 extern int bfd_elf_link_record_local_dynamic_symbol
2638 (struct bfd_link_info *, bfd *, long);
2640 extern bool _bfd_elf_close_and_cleanup
2641 (bfd *);
2643 extern bool _bfd_elf_common_definition
2644 (Elf_Internal_Sym *);
2646 extern unsigned int _bfd_elf_common_section_index
2647 (asection *);
2649 extern asection *_bfd_elf_common_section
2650 (asection *);
2652 extern bfd_vma _bfd_elf_default_got_elt_size
2653 (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *, bfd *,
2654 unsigned long);
2656 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
2657 (bfd *, arelent *, struct bfd_symbol *, void *,
2658 asection *, bfd *, char **);
2660 extern bool bfd_elf_final_link
2661 (bfd *, struct bfd_link_info *);
2663 extern void _bfd_elf_gc_keep
2664 (struct bfd_link_info *info);
2666 extern bool bfd_elf_gc_mark_dynamic_ref_symbol
2667 (struct elf_link_hash_entry *h, void *inf);
2669 extern bool bfd_elf_gc_sections
2670 (bfd *, struct bfd_link_info *);
2672 extern bool bfd_elf_gc_record_vtinherit
2673 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
2675 extern bool bfd_elf_gc_record_vtentry
2676 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
2678 extern asection *_bfd_elf_gc_mark_hook
2679 (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
2680 struct elf_link_hash_entry *, Elf_Internal_Sym *);
2682 extern asection *_bfd_elf_gc_mark_rsec
2683 (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn,
2684 struct elf_reloc_cookie *, bool *);
2686 extern bool _bfd_elf_gc_mark_reloc
2687 (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn,
2688 struct elf_reloc_cookie *);
2690 extern bool _bfd_elf_gc_mark_fdes
2691 (struct bfd_link_info *, asection *, asection *, elf_gc_mark_hook_fn,
2692 struct elf_reloc_cookie *);
2694 extern bool _bfd_elf_gc_mark
2695 (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn);
2697 extern bool _bfd_elf_gc_mark_extra_sections
2698 (struct bfd_link_info *, elf_gc_mark_hook_fn);
2700 extern bool bfd_elf_gc_common_finalize_got_offsets
2701 (bfd *, struct bfd_link_info *);
2703 extern bool bfd_elf_gc_common_final_link
2704 (bfd *, struct bfd_link_info *);
2706 extern bool bfd_elf_reloc_symbol_deleted_p
2707 (bfd_vma, void *);
2709 extern struct elf_segment_map * _bfd_elf_make_dynamic_segment
2710 (bfd *, asection *);
2712 extern bool _bfd_elf_map_sections_to_segments
2713 (bfd *, struct bfd_link_info *);
2715 extern bool _bfd_elf_is_function_type (unsigned int);
2717 extern bfd_size_type _bfd_elf_maybe_function_sym (const asymbol *, asection *,
2718 bfd_vma *);
2720 extern asection *_bfd_elf_plt_get_reloc_section (bfd *, const char *);
2722 extern int bfd_elf_get_default_section_type (flagword);
2724 extern bool bfd_elf_lookup_section_flags
2725 (struct bfd_link_info *, struct flag_info *, asection *);
2727 extern Elf_Internal_Phdr * _bfd_elf_find_segment_containing_section
2728 (bfd * abfd, asection * section);
2730 /* PowerPC @tls opcode transform/validate. */
2731 extern unsigned int _bfd_elf_ppc_at_tls_transform
2732 (unsigned int, unsigned int);
2733 /* PowerPC @tprel opcode transform/validate. */
2734 extern unsigned int _bfd_elf_ppc_at_tprel_transform
2735 (unsigned int, unsigned int);
2736 /* PowerPC elf_object_p tweak. */
2737 extern bool _bfd_elf_ppc_set_arch (bfd *);
2738 /* PowerPC .gnu.attributes handling common to both 32-bit and 64-bit. */
2739 extern bool _bfd_elf_ppc_merge_fp_attributes
2740 (bfd *, struct bfd_link_info *);
2742 /* Return an upper bound on the number of bytes required to store a
2743 copy of ABFD's program header table entries. Return -1 if an error
2744 occurs; bfd_get_error will return an appropriate code. */
2745 extern long bfd_get_elf_phdr_upper_bound
2746 (bfd *abfd);
2748 /* Copy ABFD's program header table entries to *PHDRS. The entries
2749 will be stored as an array of Elf_Internal_Phdr structures, as
2750 defined in include/elf/internal.h. To find out how large the
2751 buffer needs to be, call bfd_get_elf_phdr_upper_bound.
2753 Return the number of program header table entries read, or -1 if an
2754 error occurs; bfd_get_error will return an appropriate code. */
2755 extern int bfd_get_elf_phdrs
2756 (bfd *abfd, void *phdrs);
2758 /* Exported interface for writing elf corefile notes. */
2759 extern char *elfcore_write_note
2760 (bfd *, char *, int *, const char *, int, const void *, int);
2761 extern char *elfcore_write_prpsinfo
2762 (bfd *, char *, int *, const char *, const char *);
2763 extern char *elfcore_write_prstatus
2764 (bfd *, char *, int *, long, int, const void *);
2765 extern char * elfcore_write_pstatus
2766 (bfd *, char *, int *, long, int, const void *);
2767 extern char *elfcore_write_prfpreg
2768 (bfd *, char *, int *, const void *, int);
2769 extern char *elfcore_write_prxfpreg
2770 (bfd *, char *, int *, const void *, int);
2771 extern char *elfcore_write_xstatereg
2772 (bfd *, char *, int *, const void *, int);
2773 extern char *elfcore_write_ppc_vmx
2774 (bfd *, char *, int *, const void *, int);
2775 extern char *elfcore_write_ppc_vsx
2776 (bfd *, char *, int *, const void *, int);
2777 extern char *elfcore_write_ppc_tar
2778 (bfd *, char *, int *, const void *, int);
2779 extern char *elfcore_write_ppc_ppr
2780 (bfd *, char *, int *, const void *, int);
2781 extern char *elfcore_write_ppc_dscr
2782 (bfd *, char *, int *, const void *, int);
2783 extern char *elfcore_write_ppc_ebb
2784 (bfd *, char *, int *, const void *, int);
2785 extern char *elfcore_write_ppc_pmu
2786 (bfd *, char *, int *, const void *, int);
2787 extern char *elfcore_write_ppc_tm_cgpr
2788 (bfd *, char *, int *, const void *, int);
2789 extern char *elfcore_write_ppc_tm_cfpr
2790 (bfd *, char *, int *, const void *, int);
2791 extern char *elfcore_write_ppc_tm_cvmx
2792 (bfd *, char *, int *, const void *, int);
2793 extern char *elfcore_write_ppc_tm_cvsx
2794 (bfd *, char *, int *, const void *, int);
2795 extern char *elfcore_write_ppc_tm_spr
2796 (bfd *, char *, int *, const void *, int);
2797 extern char *elfcore_write_ppc_tm_ctar
2798 (bfd *, char *, int *, const void *, int);
2799 extern char *elfcore_write_ppc_tm_cppr
2800 (bfd *, char *, int *, const void *, int);
2801 extern char *elfcore_write_ppc_tm_cdscr
2802 (bfd *, char *, int *, const void *, int);
2803 extern char *elfcore_write_s390_timer
2804 (bfd *, char *, int *, const void *, int);
2805 extern char *elfcore_write_s390_todcmp
2806 (bfd *, char *, int *, const void *, int);
2807 extern char *elfcore_write_s390_todpreg
2808 (bfd *, char *, int *, const void *, int);
2809 extern char *elfcore_write_s390_ctrs
2810 (bfd *, char *, int *, const void *, int);
2811 extern char *elfcore_write_s390_prefix
2812 (bfd *, char *, int *, const void *, int);
2813 extern char *elfcore_write_s390_last_break
2814 (bfd *, char *, int *, const void *, int);
2815 extern char *elfcore_write_s390_system_call
2816 (bfd *, char *, int *, const void *, int);
2817 extern char *elfcore_write_s390_tdb
2818 (bfd *, char *, int *, const void *, int);
2819 extern char *elfcore_write_s390_vxrs_low
2820 (bfd *, char *, int *, const void *, int);
2821 extern char *elfcore_write_s390_vxrs_high
2822 (bfd *, char *, int *, const void *, int);
2823 extern char *elfcore_write_s390_gs_cb
2824 (bfd *, char *, int *, const void *, int);
2825 extern char *elfcore_write_s390_gs_bc
2826 (bfd *, char *, int *, const void *, int);
2827 extern char *elfcore_write_arm_vfp
2828 (bfd *, char *, int *, const void *, int);
2829 extern char *elfcore_write_aarch_tls
2830 (bfd *, char *, int *, const void *, int);
2831 extern char *elfcore_write_aarch_hw_break
2832 (bfd *, char *, int *, const void *, int);
2833 extern char *elfcore_write_aarch_hw_watch
2834 (bfd *, char *, int *, const void *, int);
2835 extern char *elfcore_write_aarch_sve
2836 (bfd *, char *, int *, const void *, int);
2837 extern char *elfcore_write_aarch_pauth
2838 (bfd *, char *, int *, const void *, int);
2839 extern char *elfcore_write_aarch_mte
2840 (bfd *, char *, int *, const void *, int);
2841 extern char *elfcore_write_arc_v2
2842 (bfd *, char *, int *, const void *, int);
2843 extern char *elfcore_write_riscv_csr
2844 (bfd *, char *, int *, const void *, int);
2845 extern char *elfcore_write_gdb_tdesc
2846 (bfd *, char *, int *, const void *, int);
2847 extern char *elfcore_write_lwpstatus
2848 (bfd *, char *, int *, long, int, const void *);
2849 extern char *elfcore_write_register_note
2850 (bfd *, char *, int *, const char *, const void *, int);
2851 extern char *elfcore_write_file_note
2852 (bfd *, char *, int *, const void*, int);
2853 extern char *elfcore_write_loongarch_cpucfg
2854 (bfd *, char *, int *, const void*, int);
2855 extern char *elfcore_write_loongarch_lbt
2856 (bfd *, char *, int *, const void*, int);
2857 extern char *elfcore_write_loongarch_lsx
2858 (bfd *, char *, int *, const void*, int);
2859 extern char *elfcore_write_loongarch_lasx
2860 (bfd *, char *, int *, const void*, int);
2862 /* Internal structure which holds information to be included in the
2863 PRPSINFO section of Linux core files.
2865 This is an "internal" structure in the sense that it should be used
2866 to pass information to BFD (via the `elfcore_write_linux_prpsinfo'
2867 function), so things like endianess shouldn't be an issue. This
2868 structure will eventually be converted in one of the
2869 `elf_external_linux_*' structures and written out to an output bfd
2870 by one of the functions declared below. */
2872 struct elf_internal_linux_prpsinfo
2874 char pr_state; /* Numeric process state. */
2875 char pr_sname; /* Char for pr_state. */
2876 char pr_zomb; /* Zombie. */
2877 char pr_nice; /* Nice val. */
2878 unsigned long pr_flag; /* Flags. */
2879 unsigned int pr_uid;
2880 unsigned int pr_gid;
2881 int pr_pid, pr_ppid, pr_pgrp, pr_sid;
2882 char pr_fname[16 + 1]; /* Filename of executable. */
2883 char pr_psargs[80 + 1]; /* Initial part of arg list. */
2886 /* Linux/most 32-bit archs. */
2887 extern char *elfcore_write_linux_prpsinfo32
2888 (bfd *, char *, int *, const struct elf_internal_linux_prpsinfo *);
2890 /* Linux/most 64-bit archs. */
2891 extern char *elfcore_write_linux_prpsinfo64
2892 (bfd *, char *, int *, const struct elf_internal_linux_prpsinfo *);
2894 extern bfd *_bfd_elf32_bfd_from_remote_memory
2895 (bfd *templ, bfd_vma ehdr_vma, bfd_size_type size, bfd_vma *loadbasep,
2896 int (*target_read_memory) (bfd_vma, bfd_byte *, bfd_size_type));
2897 extern bfd *_bfd_elf64_bfd_from_remote_memory
2898 (bfd *templ, bfd_vma ehdr_vma, bfd_size_type size, bfd_vma *loadbasep,
2899 int (*target_read_memory) (bfd_vma, bfd_byte *, bfd_size_type));
2901 extern bfd_vma bfd_elf_obj_attr_size (bfd *);
2902 extern void bfd_elf_set_obj_attr_contents (bfd *, bfd_byte *, bfd_vma);
2903 extern int bfd_elf_get_obj_attr_int (bfd *, int, unsigned int);
2904 extern void bfd_elf_add_obj_attr_int (bfd *, int, unsigned int, unsigned int);
2905 #define bfd_elf_add_proc_attr_int(BFD, TAG, VALUE) \
2906 bfd_elf_add_obj_attr_int ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
2907 extern void bfd_elf_add_obj_attr_string (bfd *, int, unsigned int, const char *);
2908 #define bfd_elf_add_proc_attr_string(BFD, TAG, VALUE) \
2909 bfd_elf_add_obj_attr_string ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
2910 extern void bfd_elf_add_obj_attr_int_string (bfd *, int, unsigned int,
2911 unsigned int, const char *);
2912 #define bfd_elf_add_proc_attr_int_string(BFD, TAG, INTVAL, STRVAL) \
2913 bfd_elf_add_obj_attr_int_string ((BFD), OBJ_ATTR_PROC, (TAG), \
2914 (INTVAL), (STRVAL))
2916 extern char *_bfd_elf_attr_strdup (bfd *, const char *);
2917 extern void _bfd_elf_copy_obj_attributes (bfd *, bfd *);
2918 extern int _bfd_elf_obj_attrs_arg_type (bfd *, int, unsigned int);
2919 extern void _bfd_elf_parse_attributes (bfd *, Elf_Internal_Shdr *);
2920 extern bool _bfd_elf_merge_object_attributes
2921 (bfd *, struct bfd_link_info *);
2922 extern bool _bfd_elf_merge_unknown_attribute_low (bfd *, bfd *, int);
2923 extern bool _bfd_elf_merge_unknown_attribute_list (bfd *, bfd *);
2924 extern Elf_Internal_Shdr *_bfd_elf_single_rel_hdr (asection *sec);
2925 extern bool elf_read_notes (bfd *, file_ptr, bfd_size_type, size_t);
2927 extern bool _bfd_elf_parse_gnu_properties
2928 (bfd *, Elf_Internal_Note *);
2929 extern elf_property * _bfd_elf_get_property
2930 (bfd *, unsigned int, unsigned int);
2931 extern bfd *_bfd_elf_link_setup_gnu_properties
2932 (struct bfd_link_info *);
2933 extern bfd_size_type _bfd_elf_convert_gnu_property_size
2934 (bfd *, bfd *);
2935 extern bool _bfd_elf_convert_gnu_properties
2936 (bfd *, asection *, bfd *, bfd_byte **, bfd_size_type *);
2938 /* The linker may need to keep track of the number of relocs that it
2939 decides to copy as dynamic relocs in check_relocs for each symbol.
2940 This is so that it can later discard them if they are found to be
2941 unnecessary. We can store the information in a field extending the
2942 regular ELF linker hash table. */
2944 struct elf_dyn_relocs
2946 struct elf_dyn_relocs *next;
2948 /* The input section of the reloc. */
2949 asection *sec;
2951 /* Total number of relocs copied for the input section. */
2952 bfd_size_type count;
2954 /* Number of pc-relative relocs copied for the input section. */
2955 bfd_size_type pc_count;
2958 extern bool _bfd_elf_create_ifunc_sections
2959 (bfd *, struct bfd_link_info *);
2960 extern bool _bfd_elf_allocate_ifunc_dyn_relocs
2961 (struct bfd_link_info *, struct elf_link_hash_entry *,
2962 struct elf_dyn_relocs **, unsigned int, unsigned int,
2963 unsigned int, bool);
2965 extern void elf_append_rela (bfd *, asection *, Elf_Internal_Rela *);
2966 extern void elf_append_rel (bfd *, asection *, Elf_Internal_Rela *);
2968 extern bfd_vma elf64_r_info (bfd_vma, bfd_vma);
2969 extern bfd_vma elf64_r_sym (bfd_vma);
2970 extern bfd_vma elf32_r_info (bfd_vma, bfd_vma);
2971 extern bfd_vma elf32_r_sym (bfd_vma);
2973 extern bool is_debuginfo_file (bfd *);
2976 extern bool _bfd_elf_init_secondary_reloc_section
2977 (bfd *, Elf_Internal_Shdr *, const char *, unsigned int);
2978 extern bool _bfd_elf_slurp_secondary_reloc_section
2979 (bfd *, asection *, asymbol **, bool);
2980 extern bool _bfd_elf_copy_special_section_fields
2981 (const bfd *, bfd *, const Elf_Internal_Shdr *, Elf_Internal_Shdr *);
2982 extern bool _bfd_elf_write_secondary_reloc_section
2983 (bfd *, asection *);
2984 extern unsigned int _bfd_elf_symbol_section_index
2985 (bfd *, elf_symbol_type *);
2987 extern asection *_bfd_elf_readonly_dynrelocs
2988 (struct elf_link_hash_entry *);
2989 extern bool _bfd_elf_maybe_set_textrel
2990 (struct elf_link_hash_entry *, void *);
2992 extern bool _bfd_elf_add_dynamic_tags
2993 (bfd *, struct bfd_link_info *, bool);
2995 /* Large common section. */
2996 extern asection _bfd_elf_large_com_section;
2998 /* Hash for local symbol with the first section id, ID, in the input
2999 file and the local symbol index, SYM. */
3000 #define ELF_LOCAL_SYMBOL_HASH(ID, SYM) \
3001 (((((ID) & 0xffU) << 24) | (((ID) & 0xff00) << 8)) \
3002 ^ (SYM) ^ (((ID) & 0xffff0000U) >> 16))
3004 /* This is the condition under which finish_dynamic_symbol will be called.
3005 If our finish_dynamic_symbol isn't called, we'll need to do something
3006 about initializing any .plt and .got entries in relocate_section. */
3007 #define WILL_CALL_FINISH_DYNAMIC_SYMBOL(DYN, SHARED, H) \
3008 ((DYN) \
3009 && ((SHARED) || !(H)->forced_local) \
3010 && ((H)->dynindx != -1 || (H)->forced_local))
3012 /* This macro is to avoid lots of duplicated code in the body
3013 of xxx_relocate_section() in the various elfxx-xxxx.c files. */
3014 #define RELOC_FOR_GLOBAL_SYMBOL(info, input_bfd, input_section, rel, \
3015 r_symndx, symtab_hdr, sym_hashes, \
3016 h, sec, relocation, \
3017 unresolved_reloc, warned, ignored) \
3018 do \
3020 /* It seems this can happen with erroneous or unsupported \
3021 input (mixing a.out and elf in an archive, for example.) */ \
3022 if (sym_hashes == NULL) \
3023 return false; \
3025 h = sym_hashes[r_symndx - symtab_hdr->sh_info]; \
3027 if (info->wrap_hash != NULL \
3028 && (input_section->flags & SEC_DEBUGGING) != 0) \
3029 h = ((struct elf_link_hash_entry *) \
3030 unwrap_hash_lookup (info, input_bfd, &h->root)); \
3032 while (h->root.type == bfd_link_hash_indirect \
3033 || h->root.type == bfd_link_hash_warning) \
3034 h = (struct elf_link_hash_entry *) h->root.u.i.link; \
3036 warned = false; \
3037 ignored = false; \
3038 unresolved_reloc = false; \
3039 relocation = 0; \
3040 if (h->root.type == bfd_link_hash_defined \
3041 || h->root.type == bfd_link_hash_defweak) \
3043 sec = h->root.u.def.section; \
3044 if (sec == NULL \
3045 || sec->output_section == NULL) \
3046 /* Set a flag that will be cleared later if we find a \
3047 relocation value for this symbol. output_section \
3048 is typically NULL for symbols satisfied by a shared \
3049 library. */ \
3050 unresolved_reloc = true; \
3051 else \
3052 relocation = (h->root.u.def.value \
3053 + sec->output_section->vma \
3054 + sec->output_offset); \
3056 else if (h->root.type == bfd_link_hash_undefweak) \
3058 else if (info->unresolved_syms_in_objects == RM_IGNORE \
3059 && ELF_ST_VISIBILITY (h->other) == STV_DEFAULT) \
3060 ignored = true; \
3061 else if (!bfd_link_relocatable (info)) \
3063 bool err = ((info->unresolved_syms_in_objects == RM_DIAGNOSE \
3064 && !info->warn_unresolved_syms) \
3065 || ELF_ST_VISIBILITY (h->other) != STV_DEFAULT); \
3066 (*info->callbacks->undefined_symbol) (info, \
3067 h->root.root.string, \
3068 input_bfd, \
3069 input_section, \
3070 rel->r_offset, err); \
3071 warned = true; \
3073 (void) unresolved_reloc; \
3074 (void) warned; \
3075 (void) ignored; \
3077 while (0)
3079 /* This macro is to avoid lots of duplicated code in the body of the
3080 loop over relocations in xxx_relocate_section() in the various
3081 elfxx-xxxx.c files.
3083 Handle relocations against symbols from removed linkonce sections,
3084 or sections discarded by a linker script. When doing a relocatable
3085 link, we remove such relocations. Otherwise, we just want the
3086 section contents zeroed and avoid any special processing. */
3087 #define RELOC_AGAINST_DISCARDED_SECTION(info, input_bfd, input_section, \
3088 rel, count, relend, \
3089 howto, index, contents) \
3091 int i_; \
3092 _bfd_clear_contents (howto, input_bfd, input_section, \
3093 contents, rel[index].r_offset); \
3095 if (bfd_link_relocatable (info) \
3096 && (input_section->flags & SEC_DEBUGGING)) \
3098 /* Only remove relocations in debug sections since other \
3099 sections may require relocations. */ \
3100 Elf_Internal_Shdr *rel_hdr; \
3102 rel_hdr = _bfd_elf_single_rel_hdr (input_section->output_section); \
3104 /* Avoid empty output section. */ \
3105 if (rel_hdr->sh_size > rel_hdr->sh_entsize) \
3107 rel_hdr->sh_size -= rel_hdr->sh_entsize; \
3108 rel_hdr = _bfd_elf_single_rel_hdr (input_section); \
3109 rel_hdr->sh_size -= rel_hdr->sh_entsize; \
3111 memmove (rel, rel + count, \
3112 (relend - rel - count) * sizeof (*rel)); \
3114 input_section->reloc_count -= count; \
3115 relend -= count; \
3116 rel--; \
3117 continue; \
3121 for (i_ = 0; i_ < count; i_++) \
3123 rel[i_].r_info = 0; \
3124 rel[i_].r_addend = 0; \
3126 rel += count - 1; \
3127 continue; \
3130 /* Will a symbol be bound to the definition within the shared
3131 library, if any. A unique symbol can never be bound locally. */
3132 #define SYMBOLIC_BIND(INFO, H) \
3133 (!(H)->unique_global \
3134 && ((INFO)->symbolic \
3135 || (H)->start_stop \
3136 || ((INFO)->dynamic && !(H)->dynamic)))
3138 /* Determine if a section contains CTF data, using its name. */
3139 static inline bool
3140 bfd_section_is_ctf (const asection *sec)
3142 const char *name = bfd_section_name (sec);
3143 return startswith (name, ".ctf") && (name[4] == 0 || name[4] == '.');
3146 #ifdef __cplusplus
3148 #endif
3149 #endif /* _LIBELF_H_ */