1 /* BFD back-end data structures for ELF files.
2 Copyright (C) 1992-2023 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. */
27 #include "elf/common.h"
28 #include "elf/external.h"
29 #include "elf/internal.h"
32 #ifndef ENABLE_CHECKING
33 #define ENABLE_CHECKING 0
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. */
51 #define NAME(x, y) x ## 64 ## _ ## y
54 #define NAME(x, y) x ## 32 ## _ ## y
59 #define NAME(x, y) x ## NOSIZE ## _ ## y
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. */
74 /* ELF symbol information. */
75 Elf_Internal_Sym internal_elf_sym
;
76 /* Backend specific information. */
79 unsigned int hppa_arg_reloc
;
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
;
92 struct elf_strtab_hash
;
98 bfd_signed_vma refcount
;
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). */
113 /* Virtual table derivation info. */
114 struct elf_link_hash_entry
*parent
;
117 /* ELF symbol version. */
118 enum elf_symbol_version
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. */
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. */
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. */
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
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
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
;
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
247 unsigned long elf_hash_value
;
250 /* Version information. */
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
;
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
;
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
)
284 /* Will references to this symbol always reference the symbol
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. The linker_def test is to
295 handle symbols like __ehdr_start that may be undefweak in early
296 stages of linking but are guaranteed to be defined later. */
297 #define UNDEFWEAK_NO_DYNAMIC_RELOC(INFO, H) \
298 ((H)->root.type == bfd_link_hash_undefweak \
299 && !(H)->root.linker_def \
300 && (ELF_ST_VISIBILITY ((H)->other) != STV_DEFAULT \
301 || (INFO)->dynamic_undefined_weak == 0))
303 /* Common symbols that are turned into definitions don't have the
304 DEF_REGULAR flag set, so they might appear to be undefined.
305 Symbols defined in linker scripts also don't have DEF_REGULAR set. */
306 #define ELF_COMMON_DEF_P(H) \
308 && !(H)->def_dynamic \
309 && (H)->root.type == bfd_link_hash_defined)
311 /* Records local symbols to be emitted in the dynamic symbol table. */
313 struct elf_link_local_dynamic_entry
315 struct elf_link_local_dynamic_entry
*next
;
317 /* The input bfd this symbol came from. */
320 /* The index of the local symbol being copied. */
323 /* The index in the outgoing dynamic symbol table. */
326 /* A copy of the input symbol. */
327 Elf_Internal_Sym isym
;
330 struct elf_link_loaded_list
332 struct elf_link_loaded_list
*next
;
336 /* Structures used by the eh_frame optimization code. */
341 /* If REMOVED == 1, this is the CIE that the FDE originally used.
342 The CIE belongs to the same .eh_frame input section as the FDE.
344 If REMOVED == 0, this is the CIE that we have chosen to use for
345 the output FDE. The CIE's REMOVED field is also 0, but the CIE
346 might belong to a different .eh_frame input section from the FDE.
348 May be NULL to signify that the FDE should be discarded. */
349 struct eh_cie_fde
*cie_inf
;
350 struct eh_cie_fde
*next_for_section
;
353 /* CIEs have three states:
355 - REMOVED && !MERGED: Slated for removal because we haven't yet
356 proven that an FDE needs it. FULL_CIE, if nonnull, points to
357 more detailed information about the CIE.
359 - REMOVED && MERGED: We have merged this CIE with MERGED_WITH,
360 which may not belong to the same input section.
362 - !REMOVED: We have decided to keep this CIE. SEC is the
363 .eh_frame input section that contains the CIE. */
365 struct cie
*full_cie
;
366 struct eh_cie_fde
*merged_with
;
370 /* The offset of the personality data from the start of the CIE,
371 or 0 if the CIE doesn't have any. */
372 unsigned int personality_offset
: 8;
374 /* Length of augmentation. aug_str_len is the length of the
375 string including null terminator. aug_data_len is the length
376 of the rest up to the initial insns. */
377 unsigned int aug_str_len
: 3;
378 unsigned int aug_data_len
: 5;
380 /* True if we have marked relocations associated with this CIE. */
381 unsigned int gc_mark
: 1;
383 /* True if we have decided to turn an absolute LSDA encoding into
384 a PC-relative one. */
385 unsigned int make_lsda_relative
: 1;
387 /* True if we have decided to turn an absolute personality
388 encoding into a PC-relative one. */
389 unsigned int make_per_encoding_relative
: 1;
391 /* True if the CIE contains personality data and if that
392 data uses a PC-relative encoding. Always true when
393 make_per_encoding_relative is. */
394 unsigned int per_encoding_relative
: 1;
396 /* True if the CIE contains personality data aligned to a
397 multiple of eight bytes. */
398 unsigned int per_encoding_aligned8
: 1;
400 /* True if we need to add an 'R' (FDE encoding) entry to the
401 CIE's augmentation data. */
402 unsigned int add_fde_encoding
: 1;
404 /* True if we have merged this CIE with another. */
405 unsigned int merged
: 1;
408 unsigned int pad1
: 9;
411 unsigned int reloc_index
;
414 unsigned int new_offset
;
415 unsigned int fde_encoding
: 8;
416 unsigned int lsda_encoding
: 8;
417 unsigned int lsda_offset
: 8;
419 /* True if this entry represents a CIE, false if it represents an FDE. */
420 unsigned int cie
: 1;
422 /* True if this entry is currently marked for removal. */
423 unsigned int removed
: 1;
425 /* True if we need to add a 'z' (augmentation size) entry to the CIE's
426 augmentation data, and an associated byte to each of the CIE's FDEs. */
427 unsigned int add_augmentation_size
: 1;
429 /* True if we have decided to convert absolute FDE relocations into
430 relative ones. This applies to the first relocation in the FDE,
431 which is against the code that the FDE describes. */
432 unsigned int make_relative
: 1;
435 unsigned int pad1
: 4;
437 unsigned int *set_loc
;
440 struct eh_frame_sec_info
444 struct eh_cie_fde entry
[1];
447 struct eh_frame_array_ent
456 #define DWARF2_EH_HDR 1
457 #define COMPACT_EH_HDR 2
459 /* Endian-neutral code indicating that a function cannot be unwound. */
460 #define COMPACT_EH_CANT_UNWIND_OPCODE 0x015d5d01
462 struct dwarf_eh_frame_hdr_info
465 unsigned int fde_count
;
466 /* TRUE if .eh_frame_hdr should contain the sorted search table.
467 We build it if we successfully read all .eh_frame input sections
468 and recognize them. */
470 struct eh_frame_array_ent
*array
;
473 struct compact_eh_frame_hdr_info
475 unsigned int allocated_entries
;
476 /* eh_frame_entry fragments. */
480 struct eh_frame_hdr_info
483 unsigned int array_count
;
484 bool frame_hdr_is_compact
;
487 struct dwarf_eh_frame_hdr_info dwarf
;
488 struct compact_eh_frame_hdr_info compact
;
493 /* Additional information for each function (used at link time). */
494 struct sframe_func_bfdinfo
496 /* Whether the function has been discarded from the final output. */
498 /* Relocation offset. */
499 unsigned int func_r_offset
;
500 /* Relocation index. */
501 unsigned int func_reloc_index
;
504 /* SFrame decoder info.
505 Contains all information for a decoded .sframe section. */
506 struct sframe_dec_info
508 /* Decoder context. */
509 struct sframe_decoder_ctx
*sfd_ctx
;
510 /* Number of function descriptor entries in this .sframe. */
511 unsigned int sfd_fde_count
;
512 /* Additional information for linking. */
513 struct sframe_func_bfdinfo
*sfd_func_bfdinfo
;
516 /* SFrame encoder info.
517 Contains all information for an encoded .sframe section to be
519 struct sframe_enc_info
521 /* Encoder context. */
522 struct sframe_encoder_ctx
*sfe_ctx
;
523 /* Output section. */
524 asection
*sframe_section
;
527 /* Enum used to identify target specific extensions to the elf_obj_tdata
528 and elf_link_hash_table structures. Note the enums deliberately start
529 from 1 so that we can detect an uninitialized field. The generic value
530 is last so that additions to this enum do not need to modify more than
534 AARCH64_ELF_DATA
= 1,
576 struct elf_sym_strtab
578 Elf_Internal_Sym sym
;
579 unsigned long dest_index
;
582 struct bfd_link_needed_list
584 struct bfd_link_needed_list
*next
;
592 is_solaris
, /* Solaris. */
593 is_vxworks
, /* VxWorks. */
594 is_nacl
/* Native Client. */
597 /* Used by bfd_sym_from_r_symndx to cache a small number of local
599 #define LOCAL_SYM_CACHE_SIZE 32
603 unsigned long indx
[LOCAL_SYM_CACHE_SIZE
];
604 Elf_Internal_Sym sym
[LOCAL_SYM_CACHE_SIZE
];
607 /* ELF linker hash table. */
609 struct elf_link_hash_table
611 struct bfd_link_hash_table root
;
613 /* An identifier used to distinguish different target
614 specific extensions to this structure. */
615 enum elf_target_id hash_table_id
;
617 /* Whether we have created the special dynamic sections required
618 when linking against or generating a shared object. */
619 bool dynamic_sections_created
;
621 /* Whether dynamic relocations are present. */
624 /* True if this target has relocatable executables, so needs dynamic
626 bool is_relocatable_executable
;
628 /* TRUE if there are IFUNC resolvers. */
629 bool ifunc_resolvers
;
631 /* TRUE if DT_PLTGOT is a required dynamic tag. */
632 bool dt_pltgot_required
;
634 /* TRUE if DT_JMPREL is a required dynamic tag. */
635 bool dt_jmprel_required
;
637 /* TRUE when we are handling DT_NEEDED entries. */
638 bool handling_dt_needed
;
640 /* The BFD used to hold special sections created by the linker.
641 This will be the first BFD found which requires these sections to
645 /* The value to use when initialising got.refcount/offset and
646 plt.refcount/offset in an elf_link_hash_entry. Set to zero when
647 the values are refcounts. Set to init_got_offset/init_plt_offset
648 in size_dynamic_sections when the values may be offsets. */
649 union gotplt_union init_got_refcount
;
650 union gotplt_union init_plt_refcount
;
652 /* The value to use for got.refcount/offset and plt.refcount/offset
653 when the values may be offsets. Normally (bfd_vma) -1. */
654 union gotplt_union init_got_offset
;
655 union gotplt_union init_plt_offset
;
657 /* The number of symbols found in the link which is intended for the
658 mandatory DT_SYMTAB tag (.dynsym section) in .dynamic section. */
659 bfd_size_type dynsymcount
;
660 bfd_size_type local_dynsymcount
;
662 /* The string table of dynamic symbols, which becomes the .dynstr
664 struct elf_strtab_hash
*dynstr
;
666 /* The array size of the symbol string table, which becomes the
668 bfd_size_type strtabsize
;
670 /* The array of strings, which becomes the .strtab section. */
671 struct elf_sym_strtab
*strtab
;
673 /* The number of buckets in the hash table in the .hash section.
674 This is based on the number of dynamic symbols. */
675 bfd_size_type bucketcount
;
677 /* A linked list of DT_NEEDED names found in dynamic objects
678 included in the link. */
679 struct bfd_link_needed_list
*needed
;
681 /* Sections in the output bfd that provides a section symbol
682 to be used by relocations emitted against local symbols.
683 Most targets will not use data_index_section. */
684 asection
*text_index_section
;
685 asection
*data_index_section
;
687 /* The _GLOBAL_OFFSET_TABLE_ symbol. */
688 struct elf_link_hash_entry
*hgot
;
690 /* The _PROCEDURE_LINKAGE_TABLE_ symbol. */
691 struct elf_link_hash_entry
*hplt
;
693 /* The _DYNAMIC symbol. */
694 struct elf_link_hash_entry
*hdynamic
;
696 /* A pointer to information used to merge SEC_MERGE sections. */
699 /* Used to link stabs in sections. */
700 struct stab_info stab_info
;
702 /* Used by eh_frame code when editing .eh_frame. */
703 struct eh_frame_hdr_info eh_info
;
705 /* Used to link stack trace info in .sframe sections. */
706 struct sframe_enc_info sfe_info
;
708 /* A linked list of local symbols to be added to .dynsym. */
709 struct elf_link_local_dynamic_entry
*dynlocal
;
711 /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic
712 objects included in the link. */
713 struct bfd_link_needed_list
*runpath
;
715 /* Cached first output tls section and size of PT_TLS segment. */
717 bfd_size_type tls_size
; /* Bytes. */
719 /* The offset into splt of the PLT entry for the TLS descriptor
720 resolver. Special values are 0, if not necessary (or not found
721 to be necessary yet), and -1 if needed but not determined
725 /* The GOT offset for the lazy trampoline. Communicated to the
726 loader via DT_TLSDESC_GOT. The magic value (bfd_vma) -1
727 indicates an offset is not allocated. */
730 /* Target OS for linker output. */
731 enum elf_target_os target_os
;
733 /* A linked list of dynamic BFD's loaded in the link. */
734 struct elf_link_loaded_list
*dyn_loaded
;
736 /* Small local sym cache. */
737 struct sym_cache sym_cache
;
739 /* Short-cuts to get to dynamic linker sections. */
748 asection
*sreldynrelro
;
757 /* Returns TRUE if the hash table is a struct elf_link_hash_table. */
760 is_elf_hash_table (const struct bfd_link_hash_table
*htab
)
762 return htab
->type
== bfd_link_elf_hash_table
;
765 /* Look up an entry in an ELF linker hash table. */
767 static inline struct elf_link_hash_entry
*
768 elf_link_hash_lookup (struct elf_link_hash_table
*table
, const char *string
,
769 bool create
, bool copy
, bool follow
)
771 if (ENABLE_CHECKING
&& !is_elf_hash_table (&table
->root
))
773 return (struct elf_link_hash_entry
*)
774 bfd_link_hash_lookup (&table
->root
, string
, create
, copy
, follow
);
777 /* Traverse an ELF linker hash table. */
780 elf_link_hash_traverse (struct elf_link_hash_table
*table
,
781 bool (*f
) (struct elf_link_hash_entry
*, void *),
784 if (ENABLE_CHECKING
&& !is_elf_hash_table (&table
->root
))
786 bfd_link_hash_traverse (&table
->root
,
787 (bool (*) (struct bfd_link_hash_entry
*, void *)) f
,
791 /* Get the ELF linker hash table from a link_info structure. */
793 static inline struct elf_link_hash_table
*
794 elf_hash_table (const struct bfd_link_info
*info
)
796 return (struct elf_link_hash_table
*) info
->hash
;
799 static inline enum elf_target_id
800 elf_hash_table_id (const struct elf_link_hash_table
*table
)
802 return table
->hash_table_id
;
805 /* Constant information held for an ELF backend. */
807 struct elf_size_info
{
808 unsigned char sizeof_ehdr
, sizeof_phdr
, sizeof_shdr
;
809 unsigned char sizeof_rel
, sizeof_rela
, sizeof_sym
, sizeof_dyn
, sizeof_note
;
811 /* The size of entries in the .hash section. */
812 unsigned char sizeof_hash_entry
;
814 /* The number of internal relocations to allocate per external
816 unsigned char int_rels_per_ext_rel
;
817 /* We use some fixed size arrays. This should be large enough to
818 handle all back-ends. */
819 #define MAX_INT_RELS_PER_EXT_REL 3
821 unsigned char arch_size
, log_file_align
;
822 unsigned char elfclass
, ev_current
;
823 int (*write_out_phdrs
)
824 (bfd
*, const Elf_Internal_Phdr
*, unsigned int);
825 bool (*write_shdrs_and_ehdr
) (bfd
*);
826 bool (*checksum_contents
)
827 (bfd
* , void (*) (const void *, size_t, void *), void *);
829 (bfd
*, asection
*, void *);
830 bool (*swap_symbol_in
)
831 (bfd
*, const void *, const void *, Elf_Internal_Sym
*);
832 void (*swap_symbol_out
)
833 (bfd
*, const Elf_Internal_Sym
*, void *, void *);
834 bool (*slurp_reloc_table
)
835 (bfd
*, asection
*, asymbol
**, bool);
836 long (*slurp_symbol_table
)
837 (bfd
*, asymbol
**, bool);
839 (bfd
*, const void *, Elf_Internal_Dyn
*);
841 (bfd
*, const Elf_Internal_Dyn
*, void *);
843 /* This function is called to swap in a REL relocation. If an
844 external relocation corresponds to more than one internal
845 relocation, then all relocations are swapped in at once. */
846 void (*swap_reloc_in
)
847 (bfd
*, const bfd_byte
*, Elf_Internal_Rela
*);
849 /* This function is called to swap out a REL relocation. */
850 void (*swap_reloc_out
)
851 (bfd
*, const Elf_Internal_Rela
*, bfd_byte
*);
853 /* This function is called to swap in a RELA relocation. If an
854 external relocation corresponds to more than one internal
855 relocation, then all relocations are swapped in at once. */
856 void (*swap_reloca_in
)
857 (bfd
*, const bfd_byte
*, Elf_Internal_Rela
*);
859 /* This function is called to swap out a RELA relocation. */
860 void (*swap_reloca_out
)
861 (bfd
*, const Elf_Internal_Rela
*, bfd_byte
*);
864 #define elf_symbol_from(S) \
865 ((((S)->flags & BSF_SYNTHETIC) == 0 \
866 && (S)->the_bfd != NULL \
867 && (S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
868 && (S)->the_bfd->tdata.elf_obj_data != 0) \
869 ? (elf_symbol_type *) (S) \
872 enum elf_reloc_type_class
{
874 reloc_class_relative
,
880 struct elf_reloc_cookie
882 Elf_Internal_Rela
*rels
, *rel
, *relend
;
883 Elf_Internal_Sym
*locsyms
;
887 struct elf_link_hash_entry
**sym_hashes
;
892 /* The level of IRIX compatibility we're striving for. */
900 /* Mapping of ELF section names and types. */
901 struct bfd_elf_special_section
904 unsigned int prefix_length
;
905 /* 0 means name must match PREFIX exactly.
906 -1 means name must start with PREFIX followed by an arbitrary string.
907 -2 means name must match PREFIX exactly or consist of PREFIX followed
908 by a dot then anything.
909 > 0 means name must start with the first PREFIX_LENGTH chars of
910 PREFIX and finish with the last SUFFIX_LENGTH chars of PREFIX. */
911 signed int suffix_length
;
916 enum action_discarded
922 typedef asection
* (*elf_gc_mark_hook_fn
)
923 (asection
*, struct bfd_link_info
*, Elf_Internal_Rela
*,
924 struct elf_link_hash_entry
*, Elf_Internal_Sym
*);
926 enum elf_property_kind
928 /* A new property. */
929 property_unknown
= 0,
930 /* A property ignored by backend. */
932 /* A corrupt property reported by backend. */
934 /* A property should be removed due to property merge. */
936 /* A property which is a number. */
940 typedef struct elf_property
942 unsigned int pr_type
;
943 unsigned int pr_datasz
;
946 /* For property_number, this is a number. */
948 /* Add a new one if elf_property_kind is updated. */
950 enum elf_property_kind pr_kind
;
953 typedef struct elf_property_list
955 struct elf_property_list
*next
;
956 struct elf_property property
;
959 struct bfd_elf_section_reloc_data
;
961 struct elf_backend_data
963 /* The architecture for this backend. */
964 enum bfd_architecture arch
;
966 /* An identifier used to distinguish different target specific
967 extensions to elf_obj_tdata and elf_link_hash_table structures. */
968 enum elf_target_id target_id
;
971 enum elf_target_os target_os
;
973 /* The ELF machine code (EM_xxxx) for this backend. */
974 int elf_machine_code
;
979 /* The maximum page size for this backend. */
982 /* The minimum page size for this backend. An input object will not be
983 considered page aligned unless its sections are correctly aligned for
984 pages at least this large. May be smaller than maxpagesize. */
987 /* The common page size for this backend. */
988 bfd_vma commonpagesize
;
990 /* The p_align value for this backend. If it is set, p_align of
991 PT_LOAD alignment will be to p_align by default. */
994 /* The BFD flags applied to sections created for dynamic linking. */
995 flagword dynamic_sec_flags
;
997 /* Architecture-specific data for this backend.
998 This is actually a pointer to some type like struct elf_ARCH_data. */
999 const void *arch_data
;
1001 /* A function to translate an ELF RELA relocation to a BFD arelent
1002 structure. Returns TRUE upon success, FALSE otherwise. */
1003 bool (*elf_info_to_howto
)
1004 (bfd
*, arelent
*, Elf_Internal_Rela
*);
1006 /* A function to translate an ELF REL relocation to a BFD arelent
1007 structure. Returns TRUE upon success, FALSE otherwise. */
1008 bool (*elf_info_to_howto_rel
)
1009 (bfd
*, arelent
*, Elf_Internal_Rela
*);
1011 /* A function to determine whether a symbol is global when
1012 partitioning the symbol table into local and global symbols.
1013 This should be NULL for most targets, in which case the correct
1014 thing will be done. MIPS ELF, at least on the Irix 5, has
1015 special requirements. */
1016 bool (*elf_backend_sym_is_global
)
1019 /* The remaining functions are hooks which are called only if they
1022 /* A function to permit a backend specific check on whether a
1023 particular BFD format is relevant for an object file, and to
1024 permit the backend to set any global information it wishes. When
1025 this is called elf_elfheader is set, but anything else should be
1026 used with caution. If this returns FALSE, the check_format
1027 routine will return a bfd_error_wrong_format error. */
1028 bool (*elf_backend_object_p
)
1031 /* A function to do additional symbol processing when reading the
1032 ELF symbol table. This is where any processor-specific special
1033 section indices are handled. */
1034 void (*elf_backend_symbol_processing
)
1037 /* A function to do additional symbol processing after reading the
1038 entire ELF symbol table. */
1039 bool (*elf_backend_symbol_table_processing
)
1040 (bfd
*, elf_symbol_type
*, unsigned int);
1042 /* A function to set the type of the info field. Processor-specific
1043 types should be handled here. */
1044 int (*elf_backend_get_symbol_type
)
1045 (Elf_Internal_Sym
*, int);
1047 /* A function to return the linker hash table entry of a symbol that
1048 might be satisfied by an archive symbol. */
1049 struct bfd_link_hash_entry
* (*elf_backend_archive_symbol_lookup
)
1050 (bfd
*, struct bfd_link_info
*, const char *);
1052 /* Return true if local section symbols should have a non-null st_name.
1053 NULL implies false. */
1054 bool (*elf_backend_name_local_section_symbols
)
1057 /* A function to do additional processing on the ELF section header
1058 just before writing it out. This is used to set the flags and
1059 type fields for some sections, or to actually write out data for
1060 unusual sections. */
1061 bool (*elf_backend_section_processing
)
1062 (bfd
*, Elf_Internal_Shdr
*);
1064 /* A function to handle unusual section types when creating BFD
1065 sections from ELF sections. */
1066 bool (*elf_backend_section_from_shdr
)
1067 (bfd
*, Elf_Internal_Shdr
*, const char *, int);
1069 /* A function to convert machine dependent ELF section header flags to
1070 BFD internal section header flags. */
1071 bool (*elf_backend_section_flags
)
1072 (const Elf_Internal_Shdr
*);
1074 /* A function that returns a struct containing ELF section flags and
1075 type for the given BFD section. */
1076 const struct bfd_elf_special_section
* (*get_sec_type_attr
)
1077 (bfd
*, asection
*);
1079 /* A function to handle unusual program segment types when creating BFD
1080 sections from ELF program segments. */
1081 bool (*elf_backend_section_from_phdr
)
1082 (bfd
*, Elf_Internal_Phdr
*, int, const char *);
1084 /* A function to set up the ELF section header for a BFD section in
1085 preparation for writing it out. This is where the flags and type
1086 fields are set for unusual sections. */
1087 bool (*elf_backend_fake_sections
)
1088 (bfd
*, Elf_Internal_Shdr
*, asection
*);
1090 /* A function to get the ELF section index for a BFD section. If
1091 this returns TRUE, the section was found. If it is a normal ELF
1092 section, *RETVAL should be left unchanged. If it is not a normal
1093 ELF section *RETVAL should be set to the SHN_xxxx index. */
1094 bool (*elf_backend_section_from_bfd_section
)
1095 (bfd
*, asection
*, int *retval
);
1097 /* If this field is not NULL, it is called by the add_symbols phase
1098 of a link just before adding a symbol to the global linker hash
1099 table. It may modify any of the fields as it wishes. If *NAME
1100 is set to NULL, the symbol will be skipped rather than being
1101 added to the hash table. This function is responsible for
1102 handling all processor dependent symbol bindings and section
1103 indices, and must set at least *FLAGS and *SEC for each processor
1104 dependent case; failure to do so will cause a link error. */
1105 bool (*elf_add_symbol_hook
)
1106 (bfd
*abfd
, struct bfd_link_info
*info
, Elf_Internal_Sym
*,
1107 const char **name
, flagword
*flags
, asection
**sec
, bfd_vma
*value
);
1109 /* If this field is not NULL, it is called by the elf_link_output_sym
1110 phase of a link for each symbol which will appear in the object file.
1111 On error, this function returns 0. 1 is returned when the symbol
1112 should be output, 2 is returned when the symbol should be discarded. */
1113 int (*elf_backend_link_output_symbol_hook
)
1114 (struct bfd_link_info
*info
, const char *, Elf_Internal_Sym
*,
1115 asection
*, struct elf_link_hash_entry
*);
1117 /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
1118 linker the first time it encounters a dynamic object in the link.
1119 This function must create any sections required for dynamic
1120 linking. The ABFD argument is a dynamic object. The .interp,
1121 .dynamic, .dynsym, .dynstr, and .hash functions have already been
1122 created, and this function may modify the section flags if
1123 desired. This function will normally create the .got and .plt
1124 sections, but different backends have different requirements. */
1125 bool (*elf_backend_create_dynamic_sections
)
1126 (bfd
*abfd
, struct bfd_link_info
*info
);
1128 /* When creating a shared library, determine whether to omit the
1129 dynamic symbol for the section. */
1130 bool (*elf_backend_omit_section_dynsym
)
1131 (bfd
*output_bfd
, struct bfd_link_info
*info
, asection
*osec
);
1133 /* Return TRUE if relocations of targets are compatible to the extent
1134 that CHECK_RELOCS will properly process them. PR 4424. */
1135 bool (*relocs_compatible
) (const bfd_target
*, const bfd_target
*);
1137 /* The CHECK_RELOCS function is called after all input files have been
1138 opened. It is called once for each section with relocs of an object
1139 file. The function must look through the relocs and do any special
1140 handling required. This generally means allocating space in the
1141 global offset table, and perhaps allocating space for a reloc. The
1142 relocs are always passed as Rela structures; if the section
1143 actually uses Rel structures, the r_addend field will always be
1145 bool (*check_relocs
)
1146 (bfd
*abfd
, struct bfd_link_info
*info
, asection
*o
,
1147 const Elf_Internal_Rela
*relocs
);
1149 /* The SIZE_RELATIVE_RELOCS function is called to size relative
1150 relocations when mappig sections to segments. */
1151 bool (*size_relative_relocs
)
1152 (struct bfd_link_info
*info
, bool *need_layout
);
1154 /* The FINISH_RELATIVE_RELOCS function is called to finish relative
1155 relocations in bfd_elf_final_link. */
1156 bool (*finish_relative_relocs
)
1157 (struct bfd_link_info
*info
);
1159 /* The CHECK_DIRECTIVES function is called once per input file by
1160 the add_symbols phase of the ELF backend linker. The function
1161 must inspect the bfd and create any additional symbols according
1162 to any custom directives in the bfd. */
1163 bool (*check_directives
)
1164 (bfd
*abfd
, struct bfd_link_info
*info
);
1166 /* The NOTICE_AS_NEEDED function is called as the linker is about to
1167 handle an as-needed lib (ACT = notice_as_needed), and after the
1168 linker has decided to keep the lib (ACT = notice_needed) or when
1169 the lib is not needed (ACT = notice_not_needed). */
1170 bool (*notice_as_needed
)
1171 (bfd
*abfd
, struct bfd_link_info
*info
, enum notice_asneeded_action act
);
1173 /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
1174 linker for every symbol which is defined by a dynamic object and
1175 referenced by a regular object. This is called after all the
1176 input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
1177 function has been called. The hash table entry should be
1178 bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
1179 defined in a section from a dynamic object. Dynamic object
1180 sections are not included in the final link, and this function is
1181 responsible for changing the value to something which the rest of
1182 the link can deal with. This will normally involve adding an
1183 entry to the .plt or .got or some such section, and setting the
1184 symbol to point to that. */
1185 bool (*elf_backend_adjust_dynamic_symbol
)
1186 (struct bfd_link_info
*info
, struct elf_link_hash_entry
*h
);
1188 /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
1189 after all the linker input files have been seen but before the
1190 section sizes have been set. This is called after
1191 ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS. */
1192 bool (*elf_backend_always_size_sections
)
1193 (bfd
*output_bfd
, struct bfd_link_info
*info
);
1195 /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
1196 linker after all the linker input files have been seen but before
1197 the sections sizes have been set. This is called after
1198 ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
1199 It is only called when linking against a dynamic object. It must
1200 set the sizes of the dynamic sections, and may fill in their
1201 contents as well. The generic ELF linker can handle the .dynsym,
1202 .dynstr and .hash sections. This function must handle the
1203 .interp section and any sections created by the
1204 CREATE_DYNAMIC_SECTIONS entry point. */
1205 bool (*elf_backend_size_dynamic_sections
)
1206 (bfd
*output_bfd
, struct bfd_link_info
*info
);
1208 /* The STRIP_ZERO_SIZED_DYNAMIC_SECTIONS function is called by the
1209 ELF backend linker to strip zero-sized dynamic sections after
1210 the section sizes have been set. */
1211 bool (*elf_backend_strip_zero_sized_dynamic_sections
)
1212 (struct bfd_link_info
*info
);
1214 /* Set TEXT_INDEX_SECTION and DATA_INDEX_SECTION, the output sections
1215 we keep to use as a base for relocs and symbols. */
1216 void (*elf_backend_init_index_section
)
1217 (bfd
*output_bfd
, struct bfd_link_info
*info
);
1219 /* The RELOCATE_SECTION function is called by the ELF backend linker
1220 to handle the relocations for a section.
1222 The relocs are always passed as Rela structures; if the section
1223 actually uses Rel structures, the r_addend field will always be
1226 This function is responsible for adjust the section contents as
1227 necessary, and (if using Rela relocs and generating a
1228 relocatable output file) adjusting the reloc addend as
1231 This function does not have to worry about setting the reloc
1232 address or the reloc symbol index.
1234 LOCAL_SYMS is a pointer to the swapped in local symbols.
1236 LOCAL_SECTIONS is an array giving the section in the input file
1237 corresponding to the st_shndx field of each local symbol.
1239 The global hash table entry for the global symbols can be found
1240 via elf_sym_hashes (input_bfd).
1242 When generating relocatable output, this function must handle
1243 STB_LOCAL/STT_SECTION symbols specially. The output symbol is
1244 going to be the section symbol corresponding to the output
1245 section, which means that the addend must be adjusted
1248 Returns FALSE on error, TRUE on success, 2 if successful and
1249 relocations should be written for this section. */
1250 int (*elf_backend_relocate_section
)
1251 (bfd
*output_bfd
, struct bfd_link_info
*info
, bfd
*input_bfd
,
1252 asection
*input_section
, bfd_byte
*contents
, Elf_Internal_Rela
*relocs
,
1253 Elf_Internal_Sym
*local_syms
, asection
**local_sections
);
1255 /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
1256 linker just before it writes a symbol out to the .dynsym section.
1257 The processor backend may make any required adjustment to the
1258 symbol. It may also take the opportunity to set contents of the
1259 dynamic sections. Note that FINISH_DYNAMIC_SYMBOL is called on
1260 all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
1261 on those symbols which are defined by a dynamic object. */
1262 bool (*elf_backend_finish_dynamic_symbol
)
1263 (bfd
*output_bfd
, struct bfd_link_info
*info
,
1264 struct elf_link_hash_entry
*h
, Elf_Internal_Sym
*sym
);
1266 /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
1267 linker just before it writes all the dynamic sections out to the
1268 output file. The FINISH_DYNAMIC_SYMBOL will have been called on
1269 all dynamic symbols. */
1270 bool (*elf_backend_finish_dynamic_sections
)
1271 (bfd
*output_bfd
, struct bfd_link_info
*info
);
1273 /* A function to do any beginning processing needed for the ELF file
1274 before building the ELF headers and computing file positions. */
1275 void (*elf_backend_begin_write_processing
)
1276 (bfd
*, struct bfd_link_info
*);
1278 /* A function to do any final processing needed for the ELF file
1279 before writing it out. */
1280 bool (*elf_backend_final_write_processing
)
1283 /* This function is called by get_program_header_size. It should
1284 return the number of additional program segments which this BFD
1285 will need. It should return -1 on error. */
1286 int (*elf_backend_additional_program_headers
)
1287 (bfd
*, struct bfd_link_info
*);
1289 /* This function is called to modify an existing segment map in a
1290 backend specific fashion. */
1291 bool (*elf_backend_modify_segment_map
)
1292 (bfd
*, struct bfd_link_info
*);
1294 /* This function is called to modify program headers just before
1295 they are written. */
1296 bool (*elf_backend_modify_headers
)
1297 (bfd
*, struct bfd_link_info
*);
1299 /* This function is called to see if the PHDR header should be
1300 checked for validity. */
1301 bool (*elf_backend_allow_non_load_phdr
)
1302 (bfd
*, const Elf_Internal_Phdr
*, unsigned);
1304 /* This function is called before section garbage collection to
1305 mark entry symbol sections. */
1307 (struct bfd_link_info
*);
1309 /* This function is called during section garbage collection to
1310 mark sections that define global symbols. */
1311 bool (*gc_mark_dynamic_ref
)
1312 (struct elf_link_hash_entry
*, void *);
1314 /* This function is called during section gc to discover the section a
1315 particular relocation refers to. */
1316 elf_gc_mark_hook_fn gc_mark_hook
;
1318 /* This function, if defined, is called after the first gc marking pass
1319 to allow the backend to mark additional sections. */
1320 bool (*gc_mark_extra_sections
)
1321 (struct bfd_link_info
*, elf_gc_mark_hook_fn
);
1323 /* This function is called to initialise ELF file header info.
1324 Customised versions can modify things like the OS and ABI version. */
1325 bool (*elf_backend_init_file_header
)
1326 (bfd
*, struct bfd_link_info
*);
1328 /* This function, if defined, prints a symbol to file and returns the
1329 name of the symbol to be printed. It should return NULL to fall
1330 back to default symbol printing. */
1331 const char *(*elf_backend_print_symbol_all
)
1332 (bfd
*, void *, asymbol
*);
1334 /* This function, if defined, is called after all local symbols and
1335 global symbols converted to locals are emitted into the symtab
1336 section. It allows the backend to emit special local symbols
1337 not handled in the hash table. */
1338 bool (*elf_backend_output_arch_local_syms
)
1339 (bfd
*, struct bfd_link_info
*, void *,
1340 int (*) (void *, const char *, Elf_Internal_Sym
*, asection
*,
1341 struct elf_link_hash_entry
*));
1343 /* This function, if defined, is called after all symbols are emitted
1344 into the symtab section. It allows the backend to emit special
1345 global symbols not handled in the hash table. */
1346 bool (*elf_backend_output_arch_syms
)
1347 (bfd
*, struct bfd_link_info
*, void *,
1348 int (*) (void *, const char *, Elf_Internal_Sym
*, asection
*,
1349 struct elf_link_hash_entry
*));
1351 /* Filter what symbols of the output file to include in the import
1352 library if one is created. */
1353 unsigned int (*elf_backend_filter_implib_symbols
)
1354 (bfd
*, struct bfd_link_info
*, asymbol
**, long);
1356 /* Copy any information related to dynamic linking from a pre-existing
1357 symbol to a newly created symbol. Also called to copy flags and
1358 other back-end info to a weakdef, in which case the symbol is not
1359 newly created and plt/got refcounts and dynamic indices should not
1361 void (*elf_backend_copy_indirect_symbol
)
1362 (struct bfd_link_info
*, struct elf_link_hash_entry
*,
1363 struct elf_link_hash_entry
*);
1365 /* Modify any information related to dynamic linking such that the
1366 symbol is not exported. */
1367 void (*elf_backend_hide_symbol
)
1368 (struct bfd_link_info
*, struct elf_link_hash_entry
*, bool);
1370 /* A function to do additional symbol fixup, called by
1371 _bfd_elf_fix_symbol_flags. */
1372 bool (*elf_backend_fixup_symbol
)
1373 (struct bfd_link_info
*, struct elf_link_hash_entry
*);
1375 /* Merge the backend specific symbol attribute. */
1376 void (*elf_backend_merge_symbol_attribute
)
1377 (struct elf_link_hash_entry
*, unsigned int, bool, bool);
1379 /* This function, if defined, will return a string containing the
1380 name of a target-specific dynamic tag. */
1381 char *(*elf_backend_get_target_dtag
)
1384 /* Decide whether an undefined symbol is special and can be ignored.
1385 This is the case for OPTIONAL symbols on IRIX. */
1386 bool (*elf_backend_ignore_undef_symbol
)
1387 (struct elf_link_hash_entry
*);
1389 /* Emit relocations. Overrides default routine for emitting relocs,
1390 except during a relocatable link, or if all relocs are being emitted. */
1391 bool (*elf_backend_emit_relocs
)
1392 (bfd
*, asection
*, Elf_Internal_Shdr
*, Elf_Internal_Rela
*,
1393 struct elf_link_hash_entry
**);
1395 /* Update relocations. It is allowed to change the number and the order.
1396 In such a case hashes should be invalidated. */
1397 void (*elf_backend_update_relocs
)
1398 (asection
*, struct bfd_elf_section_reloc_data
*);
1400 /* Count relocations. Not called for relocatable links
1401 or if all relocs are being preserved in the output. */
1402 unsigned int (*elf_backend_count_relocs
)
1403 (struct bfd_link_info
*, asection
*);
1405 /* Count additionals relocations. Called for relocatable links if
1406 additional relocations needs to be created. */
1407 unsigned int (*elf_backend_count_additional_relocs
)
1410 /* Say whether to sort relocs output by ld -r and ld --emit-relocs,
1411 by r_offset. If NULL, default to true. */
1412 bool (*sort_relocs_p
)
1415 /* This function, if defined, is called when an NT_PRSTATUS note is found
1417 bool (*elf_backend_grok_prstatus
)
1418 (bfd
*, Elf_Internal_Note
*);
1420 /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
1421 note is found in a core file. */
1422 bool (*elf_backend_grok_psinfo
)
1423 (bfd
*, Elf_Internal_Note
*);
1425 /* This function, if defined, is called when a "FreeBSD" NT_PRSTATUS
1426 note is found in a core file. */
1427 bool (*elf_backend_grok_freebsd_prstatus
)
1428 (bfd
*, Elf_Internal_Note
*);
1430 /* This function, if defined, is called to write a note to a corefile. */
1431 char *(*elf_backend_write_core_note
)
1432 (bfd
*abfd
, char *buf
, int *bufsiz
, int note_type
, ...);
1434 /* This function, if defined, is called to convert target-specific
1435 section flag names into hex values. */
1436 flagword (*elf_backend_lookup_section_flags_hook
)
1439 /* This function returns class of a reloc type. */
1440 enum elf_reloc_type_class (*elf_backend_reloc_type_class
)
1441 (const struct bfd_link_info
*, const asection
*, const Elf_Internal_Rela
*);
1443 /* This function, if defined, removes information about discarded functions
1444 from other sections which mention them. */
1445 bool (*elf_backend_discard_info
)
1446 (bfd
*, struct elf_reloc_cookie
*, struct bfd_link_info
*);
1448 /* This function, if defined, signals that the function above has removed
1449 the discarded relocations for this section. */
1450 bool (*elf_backend_ignore_discarded_relocs
)
1453 /* What to do when ld finds relocations against symbols defined in
1454 discarded sections. */
1455 unsigned int (*action_discarded
)
1458 /* This function returns the width of FDE pointers in bytes, or 0 if
1459 that can't be determined for some reason. The default definition
1460 goes by the bfd's EI_CLASS. */
1461 unsigned int (*elf_backend_eh_frame_address_size
)
1462 (bfd
*, const asection
*);
1464 /* These functions tell elf-eh-frame whether to attempt to turn
1465 absolute or lsda encodings into pc-relative ones. The default
1466 definition enables these transformations. */
1467 bool (*elf_backend_can_make_relative_eh_frame
)
1468 (bfd
*, struct bfd_link_info
*, asection
*);
1469 bool (*elf_backend_can_make_lsda_relative_eh_frame
)
1470 (bfd
*, struct bfd_link_info
*, asection
*);
1472 /* Tell linker to support multiple eh_frame sections. */
1473 bool elf_backend_can_make_multiple_eh_frame
;
1475 /* This function returns an encoding after computing the encoded
1476 value (and storing it in ENCODED) for the given OFFSET into OSEC,
1477 to be stored in at LOC_OFFSET into the LOC_SEC input section.
1478 The default definition chooses a 32-bit PC-relative encoding. */
1479 bfd_byte (*elf_backend_encode_eh_address
)
1480 (bfd
*abfd
, struct bfd_link_info
*info
,
1481 asection
*osec
, bfd_vma offset
,
1482 asection
*loc_sec
, bfd_vma loc_offset
,
1485 /* This function, if defined, may write out the given section.
1486 Returns TRUE if it did so and FALSE if the caller should. */
1487 bool (*elf_backend_write_section
)
1488 (bfd
*, struct bfd_link_info
*, asection
*, bfd_byte
*);
1490 /* This function, if defined, returns TRUE if it is section symbols
1491 only that are considered local for the purpose of partitioning the
1492 symbol table into local and global symbols. This should be NULL
1493 for most targets, in which case the correct thing will be done.
1494 MIPS ELF, at least on the Irix 5, has special requirements. */
1495 bool (*elf_backend_elfsym_local_is_section
)
1498 /* The level of IRIX compatibility we're striving for.
1499 MIPS ELF specific function. */
1500 irix_compat_t (*elf_backend_mips_irix_compat
)
1503 reloc_howto_type
*(*elf_backend_mips_rtype_to_howto
)
1504 (bfd
*, unsigned int, bool);
1506 /* The swapping table to use when dealing with ECOFF information.
1507 Used for the MIPS ELF .mdebug section. */
1508 const struct ecoff_debug_swap
*elf_backend_ecoff_debug_swap
;
1510 /* This function implements `bfd_elf_bfd_from_remote_memory';
1511 see elf.c, elfcode.h. */
1512 bfd
*(*elf_backend_bfd_from_remote_memory
)
1513 (bfd
*templ
, bfd_vma ehdr_vma
, bfd_size_type size
, bfd_vma
*loadbasep
,
1514 int (*target_read_memory
) (bfd_vma vma
, bfd_byte
*myaddr
,
1515 bfd_size_type len
));
1517 bool (*elf_backend_core_find_build_id
) (bfd
*, bfd_vma
);
1519 /* This function is used by `_bfd_elf_get_synthetic_symtab';
1521 bfd_vma (*plt_sym_val
) (bfd_vma
, const asection
*, const arelent
*);
1523 /* Is symbol defined in common section? */
1524 bool (*common_definition
) (Elf_Internal_Sym
*);
1526 /* Return a common section index for section. */
1527 unsigned int (*common_section_index
) (asection
*);
1529 /* Return a common section for section. */
1530 asection
*(*common_section
) (asection
*);
1532 /* Return TRUE if we can merge 2 definitions. */
1533 bool (*merge_symbol
) (struct elf_link_hash_entry
*,
1534 const Elf_Internal_Sym
*, asection
**,
1536 bfd
*, const asection
*);
1538 /* Return TRUE if symbol should be hashed in the `.gnu.hash' section. */
1539 bool (*elf_hash_symbol
) (struct elf_link_hash_entry
*);
1541 /* If non-NULL, called to register the location of XLAT_LOC within
1542 .MIPS.xhash at which real final dynindx for H will be written.
1543 If XLAT_LOC is zero, the symbol is not included in
1544 .MIPS.xhash and no dynindx will be written. */
1545 void (*record_xhash_symbol
)
1546 (struct elf_link_hash_entry
*h
, bfd_vma xlat_loc
);
1548 /* Return TRUE if type is a function symbol type. */
1549 bool (*is_function_type
) (unsigned int type
);
1551 /* If the ELF symbol SYM might be a function in SEC, return the
1552 function size and set *CODE_OFF to the function's entry point,
1553 otherwise return zero. */
1554 bfd_size_type (*maybe_function_sym
) (const asymbol
*sym
, asection
*sec
,
1557 /* Given NAME, the name of a relocation section stripped of its
1558 .rel/.rela prefix, return the section in ABFD to which the
1559 relocations apply. */
1560 asection
*(*get_reloc_section
) (bfd
*abfd
, const char *name
);
1562 /* Called to set the sh_flags, sh_link and sh_info fields of OSECTION which
1563 has a type >= SHT_LOOS. Returns TRUE if the fields were initialised,
1564 FALSE otherwise. Can be called multiple times for a given section,
1565 until it returns TRUE. Most of the times it is called ISECTION will be
1566 set to an input section that might be associated with the output section.
1567 The last time that it is called, ISECTION will be set to NULL. */
1568 bool (*elf_backend_copy_special_section_fields
)
1569 (const bfd
*ibfd
, bfd
*obfd
, const Elf_Internal_Shdr
*isection
,
1570 Elf_Internal_Shdr
*osection
);
1572 /* Used to handle bad SHF_LINK_ORDER input. */
1573 void (*link_order_error_handler
) (const char *, ...);
1575 /* Name of the PLT relocation section. */
1576 const char *relplt_name
;
1578 /* Alternate EM_xxxx machine codes for this backend. */
1579 int elf_machine_alt1
;
1580 int elf_machine_alt2
;
1582 const struct elf_size_info
*s
;
1584 /* An array of target specific special sections. */
1585 const struct bfd_elf_special_section
*special_sections
;
1587 /* The size in bytes of the header for the GOT. This includes the
1588 so-called reserved entries on some systems. */
1589 bfd_vma got_header_size
;
1591 /* The size of the GOT entry for the symbol pointed to by H if non-NULL,
1592 otherwise by the local symbol with index SYMNDX in IBFD. */
1593 bfd_vma (*got_elt_size
) (bfd
*, struct bfd_link_info
*,
1594 struct elf_link_hash_entry
*h
,
1595 bfd
*ibfd
, unsigned long symndx
);
1597 /* The vendor name to use for a processor-standard attributes section. */
1598 const char *obj_attrs_vendor
;
1600 /* The section name to use for a processor-standard attributes section. */
1601 const char *obj_attrs_section
;
1603 /* Return 1, 2 or 3 to indicate what type of arguments a
1604 processor-specific tag takes. */
1605 int (*obj_attrs_arg_type
) (int);
1607 /* The section type to use for an attributes section. */
1608 unsigned int obj_attrs_section_type
;
1610 /* This function determines the order in which any attributes are
1611 written. It must be defined for input in the range
1612 LEAST_KNOWN_OBJ_ATTRIBUTE..NUM_KNOWN_OBJ_ATTRIBUTES-1 (this range
1613 is used in order to make unity easy). The returned value is the
1614 actual tag number to place in the input position. */
1615 int (*obj_attrs_order
) (int);
1617 /* Handle merging unknown attributes; either warn and return TRUE,
1618 or give an error and return FALSE. */
1619 bool (*obj_attrs_handle_unknown
) (bfd
*, int);
1621 /* Parse GNU properties. Return the property kind. If the property
1622 is corrupt, issue an error message and return property_corrupt. */
1623 enum elf_property_kind (*parse_gnu_properties
) (bfd
*, unsigned int,
1627 /* Merge GNU properties. Return TRUE if property is updated. */
1628 bool (*merge_gnu_properties
) (struct bfd_link_info
*, bfd
*, bfd
*,
1629 elf_property
*, elf_property
*);
1631 /* Set up GNU properties. */
1632 bfd
*(*setup_gnu_properties
) (struct bfd_link_info
*);
1634 /* Fix up GNU properties. */
1635 void (*fixup_gnu_properties
) (struct bfd_link_info
*,
1636 elf_property_list
**);
1638 /* Encoding used for compact EH tables. */
1639 int (*compact_eh_encoding
) (struct bfd_link_info
*);
1641 /* Opcode representing no unwind. */
1642 int (*cant_unwind_opcode
) (struct bfd_link_info
*);
1644 /* Called when emitting an ELF symbol whoes input version had an
1645 ST_SHNDX field set to a value in the range SHN_LOPROC..SHN_HIOS.
1646 Returns the value to be installed in the ST_SHNDX field of the
1647 emitted symbol. If not defined, the value is left unchanged. */
1648 unsigned int (*symbol_section_index
) (bfd
*, elf_symbol_type
*);
1650 /* Called when a section has extra reloc sections. */
1651 bool (*init_secondary_reloc_section
) (bfd
*, Elf_Internal_Shdr
*,
1652 const char *, unsigned int);
1654 /* Called when after loading the normal relocs for a section. */
1655 bool (*slurp_secondary_relocs
) (bfd
*, asection
*, asymbol
**, bool);
1657 /* Called after writing the normal relocs for a section. */
1658 bool (*write_secondary_relocs
) (bfd
*, asection
*);
1660 /* This is non-zero if static TLS segments require a special alignment. */
1661 unsigned static_tls_alignment
;
1663 /* Alignment for the PT_GNU_STACK segment. */
1664 unsigned stack_align
;
1666 /* Flag bits to assign to a section of type SHT_STRTAB. */
1667 unsigned long elf_strtab_flags
;
1669 /* This is TRUE if the linker should act like collect and gather
1670 global constructors and destructors by name. This is TRUE for
1671 MIPS ELF because the Irix 5 tools can not handle the .init
1673 unsigned collect
: 1;
1675 /* This is TRUE if the linker should ignore changes to the type of a
1676 symbol. This is TRUE for MIPS ELF because some Irix 5 objects
1677 record undefined functions as STT_OBJECT although the definitions
1679 unsigned type_change_ok
: 1;
1681 /* Whether the backend may use REL relocations. (Some backends use
1682 both REL and RELA relocations, and this flag is set for those
1684 unsigned may_use_rel_p
: 1;
1686 /* Whether the backend may use RELA relocations. (Some backends use
1687 both REL and RELA relocations, and this flag is set for those
1689 unsigned may_use_rela_p
: 1;
1691 /* Whether the default relocation type is RELA. If a backend with
1692 this flag set wants REL relocations for a particular section,
1693 it must note that explicitly. Similarly, if this flag is clear,
1694 and the backend wants RELA relocations for a particular
1696 unsigned default_use_rela_p
: 1;
1698 /* True if PLT and copy relocations should be RELA by default. */
1699 unsigned rela_plts_and_copies_p
: 1;
1701 /* Set if RELA relocations for a relocatable link can be handled by
1702 generic code. Backends that set this flag need do nothing in the
1703 backend relocate_section routine for relocatable linking. */
1704 unsigned rela_normal
: 1;
1706 /* Set if DT_REL/DT_RELA/DT_RELSZ/DT_RELASZ should not include PLT
1708 unsigned dtrel_excludes_plt
: 1;
1710 /* TRUE if addresses "naturally" sign extend. This is used when
1711 swapping in from Elf32 when BFD64. */
1712 unsigned sign_extend_vma
: 1;
1714 unsigned want_got_plt
: 1;
1715 unsigned plt_readonly
: 1;
1716 unsigned want_plt_sym
: 1;
1717 unsigned plt_not_loaded
: 1;
1718 unsigned plt_alignment
: 4;
1719 unsigned can_gc_sections
: 1;
1720 unsigned can_refcount
: 1;
1721 unsigned want_got_sym
: 1;
1722 unsigned want_dynbss
: 1;
1723 unsigned want_dynrelro
: 1;
1725 /* Targets which do not support physical addressing often require
1726 that the p_paddr field in the section header to be set to zero.
1727 This field indicates whether this behavior is required. */
1728 unsigned want_p_paddr_set_to_zero
: 1;
1730 /* Target has broken hardware and/or kernel that requires pages not
1731 to be mapped twice with different permissions. */
1732 unsigned no_page_alias
: 1;
1734 /* True if an object file lacking a .note.GNU-stack section
1735 should be assumed to be requesting exec stack. At least one
1736 other file in the link needs to have a .note.GNU-stack section
1737 for a PT_GNU_STACK segment to be created. */
1738 unsigned default_execstack
: 1;
1740 /* True if elf_section_data(sec)->this_hdr.contents is sec->rawsize
1741 in length rather than sec->size in length, if sec->rawsize is
1742 non-zero and smaller than sec->size. */
1743 unsigned caches_rawsize
: 1;
1745 /* Address of protected data defined in the shared library may be
1746 external, i.e., due to copy relocation. */
1747 unsigned extern_protected_data
: 1;
1749 /* True if `_bfd_elf_link_renumber_dynsyms' must be called even for
1751 unsigned always_renumber_dynsyms
: 1;
1753 /* True if the 32-bit Linux PRPSINFO structure's `pr_uid' and `pr_gid'
1754 members use a 16-bit data type. */
1755 unsigned linux_prpsinfo32_ugid16
: 1;
1757 /* True if the 64-bit Linux PRPSINFO structure's `pr_uid' and `pr_gid'
1758 members use a 16-bit data type. */
1759 unsigned linux_prpsinfo64_ugid16
: 1;
1762 /* Information about reloc sections associated with a bfd_elf_section_data
1764 struct bfd_elf_section_reloc_data
1766 /* The ELF header for the reloc section associated with this
1768 Elf_Internal_Shdr
*hdr
;
1769 /* The number of relocations currently assigned to HDR. */
1771 /* The ELF section number of the reloc section. Only used for an
1774 /* Used by the backend linker to store the symbol hash table entries
1775 associated with relocs against global symbols. */
1776 struct elf_link_hash_entry
**hashes
;
1779 /* Information stored for each BFD section in an ELF file. This
1780 structure is allocated by elf_new_section_hook. */
1782 struct bfd_elf_section_data
1784 /* The ELF header for this section. */
1785 Elf_Internal_Shdr this_hdr
;
1787 /* INPUT_SECTION_FLAGS if specified in the linker script. */
1788 struct flag_info
*section_flag_info
;
1790 /* Information about the REL and RELA reloc sections associated
1791 with this section, if any. */
1792 struct bfd_elf_section_reloc_data rel
, rela
;
1794 /* The ELF section number of this section. */
1797 /* Used by the backend linker when generating a shared library to
1798 record the dynamic symbol index for a section symbol
1799 corresponding to this section. A value of 0 means that there is
1800 no dynamic symbol for this section. */
1803 /* A pointer to the linked-to section for SHF_LINK_ORDER. */
1804 asection
*linked_to
;
1806 /* A pointer to the swapped relocs. If the section uses REL relocs,
1807 rather than RELA, all the r_addend fields will be zero. This
1808 pointer may be NULL. It is used by the backend linker. */
1809 Elf_Internal_Rela
*relocs
;
1811 /* A pointer to a linked list tracking dynamic relocs copied for
1815 /* A pointer to the bfd section used for dynamic relocs. */
1819 /* Group name, if this section is a member of a group. */
1822 /* Group signature sym, if this is the SHT_GROUP section. */
1823 struct bfd_symbol
*id
;
1826 /* For a member of a group, points to the SHT_GROUP section.
1827 NULL for the SHT_GROUP section itself and non-group sections. */
1828 asection
*sec_group
;
1830 /* A linked list of member sections in the group. Circular when used by
1831 the linker. For the SHT_GROUP section, points at first member. */
1832 asection
*next_in_group
;
1834 /* The FDEs associated with this section. The u.fde.next_in_section
1835 field acts as a chain pointer. */
1836 struct eh_cie_fde
*fde_list
;
1838 /* Link from a text section to its .eh_frame_entry section. */
1839 asection
*eh_frame_entry
;
1841 /* TRUE if the section has secondary reloc sections associated with it.
1842 FIXME: In the future it might be better to change this into a list
1843 of secondary reloc sections, making lookup easier and faster. */
1844 bool has_secondary_relocs
;
1846 /* A pointer used for various section optimizations. */
1850 #define elf_section_data(sec) ((struct bfd_elf_section_data*)(sec)->used_by_bfd)
1851 #define elf_linked_to_section(sec) (elf_section_data(sec)->linked_to)
1852 #define elf_section_type(sec) (elf_section_data(sec)->this_hdr.sh_type)
1853 #define elf_section_flags(sec) (elf_section_data(sec)->this_hdr.sh_flags)
1854 #define elf_section_info(sec) (elf_section_data(sec)->this_hdr.sh_info)
1855 #define elf_group_name(sec) (elf_section_data(sec)->group.name)
1856 #define elf_group_id(sec) (elf_section_data(sec)->group.id)
1857 #define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group)
1858 #define elf_fde_list(sec) (elf_section_data(sec)->fde_list)
1859 #define elf_sec_group(sec) (elf_section_data(sec)->sec_group)
1860 #define elf_section_eh_frame_entry(sec) (elf_section_data(sec)->eh_frame_entry)
1862 #define xvec_get_elf_backend_data(xvec) \
1863 ((const struct elf_backend_data *) (xvec)->backend_data)
1865 #define get_elf_backend_data(abfd) \
1866 xvec_get_elf_backend_data ((abfd)->xvec)
1868 /* The least object attributes (within an attributes subsection) known
1869 for any target. Some code assumes that the value 0 is not used and
1870 the field for that attribute can instead be used as a marker to
1871 indicate that attributes have been initialized. */
1872 #define LEAST_KNOWN_OBJ_ATTRIBUTE 2
1874 /* The maximum number of known object attributes for any target. */
1875 #define NUM_KNOWN_OBJ_ATTRIBUTES 77
1877 /* The value of an object attribute. The type indicates whether the attribute
1878 holds and integer, a string, or both. It can also indicate that there can
1879 be no default (i.e. all values must be written to file, even zero), or
1880 that the value is in error and should not be written to file. */
1882 typedef struct obj_attribute
1884 #define ATTR_TYPE_FLAG_INT_VAL (1 << 0)
1885 #define ATTR_TYPE_FLAG_STR_VAL (1 << 1)
1886 #define ATTR_TYPE_FLAG_NO_DEFAULT (1 << 2)
1887 #define ATTR_TYPE_FLAG_ERROR (1 << 3)
1889 #define ATTR_TYPE_HAS_INT_VAL(TYPE) ((TYPE) & ATTR_TYPE_FLAG_INT_VAL)
1890 #define ATTR_TYPE_HAS_STR_VAL(TYPE) ((TYPE) & ATTR_TYPE_FLAG_STR_VAL)
1891 #define ATTR_TYPE_HAS_NO_DEFAULT(TYPE) ((TYPE) & ATTR_TYPE_FLAG_NO_DEFAULT)
1892 #define ATTR_TYPE_HAS_ERROR(TYPE) ((TYPE) & ATTR_TYPE_FLAG_ERROR)
1899 typedef struct obj_attribute_list
1901 struct obj_attribute_list
*next
;
1904 } obj_attribute_list
;
1906 /* Object attributes may either be defined by the processor ABI, index
1907 OBJ_ATTR_PROC in the *_obj_attributes arrays, or be GNU-specific
1908 (and possibly also processor-specific), index OBJ_ATTR_GNU. */
1909 #define OBJ_ATTR_PROC 0
1910 #define OBJ_ATTR_GNU 1
1911 #define OBJ_ATTR_FIRST OBJ_ATTR_PROC
1912 #define OBJ_ATTR_LAST OBJ_ATTR_GNU
1914 /* The following object attribute tags are taken as generic, for all
1915 targets and for "gnu" where there is no target standard. */
1922 Tag_compatibility
= 32
1925 /* The following struct stores information about every SystemTap section
1926 found in the object file. */
1929 struct sdt_note
*next
;
1934 /* tdata information grabbed from an elf core file. */
1935 struct core_elf_obj_tdata
1944 /* Extra tdata information held for output ELF BFDs. */
1945 struct output_elf_obj_tdata
1947 struct elf_segment_map
*seg_map
;
1948 struct elf_strtab_hash
*strtab_ptr
;
1950 /* STT_SECTION symbols for each section */
1951 asymbol
**section_syms
;
1953 /* NT_GNU_BUILD_ID note type info. */
1956 bool (*after_write_object_contents
) (bfd
*);
1961 /* FDO_PACKAGING_METADATA note type info. */
1964 bool (*after_write_object_contents
) (bfd
*);
1969 /* Records the result of `get_program_header_size'. */
1970 bfd_size_type program_header_size
;
1972 /* Used when laying out sections. */
1973 file_ptr next_file_pos
;
1975 /* Linker information. */
1976 struct bfd_link_info
*link_info
;
1978 unsigned int num_section_syms
;
1979 unsigned int shstrtab_section
, strtab_section
;
1981 /* Segment flags for the PT_GNU_STACK segment. */
1982 unsigned int stack_flags
;
1984 /* Used to determine if PT_GNU_SFRAME segment header should be
1988 /* Used to determine if the e_flags field has been initialized */
1992 /* Indicate if the bfd contains SHF_GNU_MBIND/SHF_GNU_RETAIN sections or
1993 symbols that have the STT_GNU_IFUNC symbol type or STB_GNU_UNIQUE
1994 binding. Used to set the osabi field in the ELF header structure. */
1997 elf_gnu_osabi_mbind
= 1 << 0,
1998 elf_gnu_osabi_ifunc
= 1 << 1,
1999 elf_gnu_osabi_unique
= 1 << 2,
2000 elf_gnu_osabi_retain
= 1 << 3,
2003 typedef struct elf_section_list
2005 Elf_Internal_Shdr hdr
;
2007 struct elf_section_list
* next
;
2010 enum dynamic_lib_link_class
{
2014 DYN_NO_ADD_NEEDED
= 4,
2018 /* Some private data is stashed away for future use using the tdata pointer
2019 in the bfd structure. */
2021 struct elf_obj_tdata
2023 Elf_Internal_Ehdr elf_header
[1]; /* Actual data, but ref like ptr */
2024 Elf_Internal_Shdr
**elf_sect_ptr
;
2025 Elf_Internal_Phdr
*phdr
;
2026 Elf_Internal_Shdr symtab_hdr
;
2027 Elf_Internal_Shdr shstrtab_hdr
;
2028 Elf_Internal_Shdr strtab_hdr
;
2029 Elf_Internal_Shdr dynsymtab_hdr
;
2030 Elf_Internal_Shdr dynstrtab_hdr
;
2031 Elf_Internal_Shdr dynversym_hdr
;
2032 Elf_Internal_Shdr dynverref_hdr
;
2033 Elf_Internal_Shdr dynverdef_hdr
;
2034 Elf_Internal_Sym
*dt_symtab
;
2035 bfd_byte
*dt_versym
;
2036 bfd_byte
*dt_verdef
;
2037 bfd_byte
*dt_verneed
;
2038 size_t dt_symtab_count
;
2039 size_t dt_verdef_count
;
2040 size_t dt_verneed_count
;
2042 elf_section_list
* symtab_shndx_list
;
2043 bfd_vma gp
; /* The gp value */
2044 unsigned int gp_size
; /* The gp size */
2045 unsigned int num_elf_sections
; /* elf_sect_ptr size */
2046 unsigned char *being_created
;
2048 /* A mapping from external symbols to entries in the linker hash
2049 table, used when linking. This is indexed by the symbol index
2050 minus the sh_info field of the symbol table header. */
2051 struct elf_link_hash_entry
**sym_hashes
;
2053 /* Track usage and final offsets of GOT entries for local symbols.
2054 This array is indexed by symbol index. Elements are used
2055 identically to "got" in struct elf_link_hash_entry. */
2058 bfd_signed_vma
*refcounts
;
2060 struct got_entry
**ents
;
2063 /* The linker ELF emulation code needs to let the backend ELF linker
2064 know what filename should be used for a dynamic object if the
2065 dynamic object is found using a search. The emulation code then
2066 sometimes needs to know what name was actually used. Until the
2067 file has been added to the linker symbol table, this field holds
2068 the name the linker wants. After it has been added, it holds the
2069 name actually used, which will be the DT_SONAME entry if there is
2071 const char *dt_name
;
2073 /* The linker emulation needs to know what audit libs
2074 are used by a dynamic object. */
2075 const char *dt_audit
;
2077 /* Used by find_nearest_line entry point. */
2080 /* A place to stash dwarf1 info for this bfd. */
2081 void *dwarf1_find_line_info
;
2083 /* A place to stash dwarf2 info for this bfd. */
2084 void *dwarf2_find_line_info
;
2086 /* Stash away info for yet another find line/function variant. */
2087 void *elf_find_function_cache
;
2089 /* Number of symbol version definitions we are about to emit. */
2090 unsigned int cverdefs
;
2092 /* Number of symbol version references we are about to emit. */
2093 unsigned int cverrefs
;
2095 /* Symbol version definitions in external objects. */
2096 Elf_Internal_Verdef
*verdef
;
2098 /* Symbol version references to external objects. */
2099 Elf_Internal_Verneed
*verref
;
2101 /* A pointer to the .eh_frame section. */
2102 asection
*eh_frame_section
;
2104 /* Symbol buffer. */
2107 /* List of GNU properties. Will be updated by setup_gnu_properties
2108 after all input GNU properties are merged for output. */
2109 elf_property_list
*properties
;
2111 obj_attribute known_obj_attributes
[2][NUM_KNOWN_OBJ_ATTRIBUTES
];
2112 obj_attribute_list
*other_obj_attributes
[2];
2114 /* Linked-list containing information about every Systemtap section
2115 found in the object file. Each section corresponds to one entry
2117 struct sdt_note
*sdt_note_head
;
2119 Elf_Internal_Shdr
**group_sect_ptr
;
2120 unsigned int num_group
;
2122 /* Index into group_sect_ptr, updated by setup_group when finding a
2123 section's group. Used to optimize subsequent group searches. */
2124 unsigned int group_search_offset
;
2126 unsigned int symtab_section
, dynsymtab_section
;
2127 unsigned int dynversym_section
, dynverdef_section
, dynverref_section
;
2129 /* An identifier used to distinguish different target
2130 specific extensions to this structure. */
2131 ENUM_BITFIELD (elf_target_id
) object_id
: 6;
2133 /* Whether a dyanmic object was specified normally on the linker
2134 command line, or was specified when --as-needed was in effect,
2135 or was found via a DT_NEEDED entry. */
2136 ENUM_BITFIELD (dynamic_lib_link_class
) dyn_lib_class
: 4;
2138 /* Whether the bfd uses OS specific bits that require ELFOSABI_GNU. */
2139 ENUM_BITFIELD (elf_gnu_osabi
) has_gnu_osabi
: 4;
2141 /* Whether if the bfd contains the GNU_PROPERTY_NO_COPY_ON_PROTECTED
2143 unsigned int has_no_copy_on_protected
: 1;
2145 /* Whether if the bfd contains the
2146 GNU_PROPERTY_1_NEEDED_INDIRECT_EXTERN_ACCESS property. */
2147 unsigned int has_indirect_extern_access
: 1;
2149 /* Irix 5 often screws up the symbol table, sorting local symbols
2150 after global symbols. This flag is set if the symbol table in
2151 this BFD appears to be screwed up. If it is, we ignore the
2152 sh_info field in the symbol table header, and always read all the
2154 unsigned int bad_symtab
: 1;
2156 /* Set if DT_FLAGS_1 has DF_1_PIE set. */
2157 unsigned int is_pie
: 1;
2159 /* Information grabbed from an elf core file. */
2160 struct core_elf_obj_tdata
*core
;
2162 /* More information held for output ELF BFDs. */
2163 struct output_elf_obj_tdata
*o
;
2166 #define elf_tdata(bfd) ((bfd) -> tdata.elf_obj_data)
2168 #define elf_object_id(bfd) (elf_tdata(bfd) -> object_id)
2169 #define elf_program_header_size(bfd) (elf_tdata(bfd) -> o->program_header_size)
2170 #define elf_elfheader(bfd) (elf_tdata(bfd) -> elf_header)
2171 #define elf_elfsections(bfd) (elf_tdata(bfd) -> elf_sect_ptr)
2172 #define elf_numsections(bfd) (elf_tdata(bfd) -> num_elf_sections)
2173 #define elf_seg_map(bfd) (elf_tdata(bfd) -> o->seg_map)
2174 #define elf_link_info(bfd) (elf_tdata(bfd) -> o->link_info)
2175 #define elf_next_file_pos(bfd) (elf_tdata(bfd) -> o->next_file_pos)
2176 #define elf_stack_flags(bfd) (elf_tdata(bfd) -> o->stack_flags)
2177 #define elf_sframe(bfd) (elf_tdata(bfd) -> o->sframe)
2178 #define elf_shstrtab(bfd) (elf_tdata(bfd) -> o->strtab_ptr)
2179 #define elf_onesymtab(bfd) (elf_tdata(bfd) -> symtab_section)
2180 #define elf_symtab_shndx_list(bfd) (elf_tdata(bfd) -> symtab_shndx_list)
2181 #define elf_strtab_sec(bfd) (elf_tdata(bfd) -> o->strtab_section)
2182 #define elf_shstrtab_sec(bfd) (elf_tdata(bfd) -> o->shstrtab_section)
2183 #define elf_symtab_hdr(bfd) (elf_tdata(bfd) -> symtab_hdr)
2184 #define elf_dynsymtab(bfd) (elf_tdata(bfd) -> dynsymtab_section)
2185 #define elf_dynversym(bfd) (elf_tdata(bfd) -> dynversym_section)
2186 #define elf_dynverdef(bfd) (elf_tdata(bfd) -> dynverdef_section)
2187 #define elf_dynverref(bfd) (elf_tdata(bfd) -> dynverref_section)
2188 #define elf_eh_frame_section(bfd) \
2189 (elf_tdata(bfd) -> eh_frame_section)
2190 #define elf_section_syms(bfd) (elf_tdata(bfd) -> o->section_syms)
2191 #define elf_num_section_syms(bfd) (elf_tdata(bfd) -> o->num_section_syms)
2192 #define core_prpsinfo(bfd) (elf_tdata(bfd) -> prpsinfo)
2193 #define core_prstatus(bfd) (elf_tdata(bfd) -> prstatus)
2194 #define elf_gp(bfd) (elf_tdata(bfd) -> gp)
2195 #define elf_gp_size(bfd) (elf_tdata(bfd) -> gp_size)
2196 #define elf_sym_hashes(bfd) (elf_tdata(bfd) -> sym_hashes)
2197 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
2198 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
2199 #define elf_local_got_ents(bfd) (elf_tdata(bfd) -> local_got.ents)
2200 #define elf_dt_name(bfd) (elf_tdata(bfd) -> dt_name)
2201 #define elf_dt_audit(bfd) (elf_tdata(bfd) -> dt_audit)
2202 #define elf_dyn_lib_class(bfd) (elf_tdata(bfd) -> dyn_lib_class)
2203 #define elf_bad_symtab(bfd) (elf_tdata(bfd) -> bad_symtab)
2204 #define elf_flags_init(bfd) (elf_tdata(bfd) -> o->flags_init)
2205 #define elf_use_dt_symtab_p(bfd) (elf_tdata(bfd) -> dt_symtab_count != 0)
2206 #define elf_known_obj_attributes(bfd) (elf_tdata (bfd) -> known_obj_attributes)
2207 #define elf_other_obj_attributes(bfd) (elf_tdata (bfd) -> other_obj_attributes)
2208 #define elf_known_obj_attributes_proc(bfd) \
2209 (elf_known_obj_attributes (bfd) [OBJ_ATTR_PROC])
2210 #define elf_other_obj_attributes_proc(bfd) \
2211 (elf_other_obj_attributes (bfd) [OBJ_ATTR_PROC])
2212 #define elf_properties(bfd) (elf_tdata (bfd) -> properties)
2213 #define elf_has_no_copy_on_protected(bfd) \
2214 (elf_tdata(bfd) -> has_no_copy_on_protected)
2215 #define elf_has_indirect_extern_access(bfd) \
2216 (elf_tdata(bfd) -> has_indirect_extern_access)
2218 extern void _bfd_elf_swap_verdef_in
2219 (bfd
*, const Elf_External_Verdef
*, Elf_Internal_Verdef
*);
2220 extern void _bfd_elf_swap_verdef_out
2221 (bfd
*, const Elf_Internal_Verdef
*, Elf_External_Verdef
*);
2222 extern void _bfd_elf_swap_verdaux_in
2223 (bfd
*, const Elf_External_Verdaux
*, Elf_Internal_Verdaux
*);
2224 extern void _bfd_elf_swap_verdaux_out
2225 (bfd
*, const Elf_Internal_Verdaux
*, Elf_External_Verdaux
*);
2226 extern void _bfd_elf_swap_verneed_in
2227 (bfd
*, const Elf_External_Verneed
*, Elf_Internal_Verneed
*);
2228 extern void _bfd_elf_swap_verneed_out
2229 (bfd
*, const Elf_Internal_Verneed
*, Elf_External_Verneed
*);
2230 extern void _bfd_elf_swap_vernaux_in
2231 (bfd
*, const Elf_External_Vernaux
*, Elf_Internal_Vernaux
*);
2232 extern void _bfd_elf_swap_vernaux_out
2233 (bfd
*, const Elf_Internal_Vernaux
*, Elf_External_Vernaux
*);
2234 extern void _bfd_elf_swap_versym_in
2235 (bfd
*, const Elf_External_Versym
*, Elf_Internal_Versym
*);
2236 extern void _bfd_elf_swap_versym_out
2237 (bfd
*, const Elf_Internal_Versym
*, Elf_External_Versym
*);
2239 extern unsigned int _bfd_elf_section_from_bfd_section
2240 (bfd
*, asection
*);
2241 extern char *bfd_elf_string_from_elf_section
2242 (bfd
*, unsigned, unsigned);
2243 extern Elf_Internal_Sym
*bfd_elf_get_elf_syms
2244 (bfd
*, Elf_Internal_Shdr
*, size_t, size_t, Elf_Internal_Sym
*, void *,
2245 Elf_External_Sym_Shndx
*);
2246 extern char * bfd_elf_get_str_section (bfd
*, unsigned int);
2247 extern const char *bfd_elf_sym_name
2248 (bfd
*, Elf_Internal_Shdr
*, Elf_Internal_Sym
*, asection
*);
2250 extern bool _bfd_elf_copy_private_bfd_data
2252 extern bool _bfd_elf_print_private_bfd_data
2254 const char * _bfd_elf_get_symbol_version_string
2255 (bfd
*, asymbol
*, bool, bool *);
2256 extern void bfd_elf_print_symbol
2257 (bfd
*, void *, asymbol
*, bfd_print_symbol_type
);
2259 extern unsigned int _bfd_elf_eh_frame_address_size
2260 (bfd
*, const asection
*);
2261 extern bfd_byte _bfd_elf_encode_eh_address
2262 (bfd
*abfd
, struct bfd_link_info
*info
, asection
*osec
, bfd_vma offset
,
2263 asection
*loc_sec
, bfd_vma loc_offset
, bfd_vma
*encoded
);
2264 extern bool _bfd_elf_can_make_relative
2265 (bfd
*input_bfd
, struct bfd_link_info
*info
, asection
*eh_frame_section
);
2267 extern enum elf_reloc_type_class _bfd_elf_reloc_type_class
2268 (const struct bfd_link_info
*, const asection
*,
2269 const Elf_Internal_Rela
*);
2270 extern bfd_vma _bfd_elf_rela_local_sym
2271 (bfd
*, Elf_Internal_Sym
*, asection
**, Elf_Internal_Rela
*);
2272 extern bfd_vma _bfd_elf_rel_local_sym
2273 (bfd
*, Elf_Internal_Sym
*, asection
**, bfd_vma
);
2274 extern bfd_vma _bfd_elf_section_offset
2275 (bfd
*, struct bfd_link_info
*, asection
*, bfd_vma
);
2277 extern unsigned long bfd_elf_hash
2279 extern unsigned long bfd_elf_gnu_hash
2282 extern bfd_reloc_status_type bfd_elf_generic_reloc
2283 (bfd
*, arelent
*, asymbol
*, void *, asection
*, bfd
*, char **);
2284 extern bool bfd_elf_allocate_object
2285 (bfd
*, size_t, enum elf_target_id
);
2286 extern bool bfd_elf_make_object
2288 extern bool bfd_elf_mkcorefile
2290 extern bool _bfd_elf_make_section_from_shdr
2291 (bfd
*, Elf_Internal_Shdr
*, const char *, int);
2292 extern bool _bfd_elf_make_section_from_phdr
2293 (bfd
*, Elf_Internal_Phdr
*, int, const char *);
2294 extern struct bfd_hash_entry
*_bfd_elf_link_hash_newfunc
2295 (struct bfd_hash_entry
*, struct bfd_hash_table
*, const char *);
2296 extern struct bfd_link_hash_table
*_bfd_elf_link_hash_table_create
2298 extern void _bfd_elf_link_hash_table_free
2300 extern void _bfd_elf_link_hash_copy_indirect
2301 (struct bfd_link_info
*, struct elf_link_hash_entry
*,
2302 struct elf_link_hash_entry
*);
2303 extern void _bfd_elf_link_hash_hide_symbol
2304 (struct bfd_link_info
*, struct elf_link_hash_entry
*, bool);
2305 extern void _bfd_elf_link_hide_symbol
2306 (bfd
*, struct bfd_link_info
*, struct bfd_link_hash_entry
*);
2307 extern bool _bfd_elf_link_hash_fixup_symbol
2308 (struct bfd_link_info
*, struct elf_link_hash_entry
*);
2309 extern bool _bfd_elf_link_hash_table_init
2310 (struct elf_link_hash_table
*, bfd
*,
2311 struct bfd_hash_entry
*(*)
2312 (struct bfd_hash_entry
*, struct bfd_hash_table
*, const char *),
2313 unsigned int, enum elf_target_id
);
2314 extern bool _bfd_elf_slurp_version_tables
2316 extern bool _bfd_elf_merge_sections
2317 (bfd
*, struct bfd_link_info
*);
2318 extern bool _bfd_elf_match_sections_by_type
2319 (bfd
*, const asection
*, bfd
*, const asection
*);
2320 extern bool bfd_elf_is_group_section
2321 (bfd
*, const struct bfd_section
*);
2322 extern const char *bfd_elf_group_name
2323 (bfd
*, const struct bfd_section
*);
2324 extern bool _bfd_elf_section_already_linked
2325 (bfd
*, asection
*, struct bfd_link_info
*);
2326 extern void bfd_elf_set_group_contents
2327 (bfd
*, asection
*, void *);
2328 extern unsigned int _bfd_elf_filter_global_symbols
2329 (bfd
*, struct bfd_link_info
*, asymbol
**, long);
2330 extern asection
*_bfd_elf_check_kept_section
2331 (asection
*, struct bfd_link_info
*);
2332 #define _bfd_elf_link_just_syms _bfd_generic_link_just_syms
2333 extern void _bfd_elf_copy_link_hash_symbol_type
2334 (bfd
*, struct bfd_link_hash_entry
*, struct bfd_link_hash_entry
*);
2335 extern bool _bfd_elf_size_group_sections
2336 (struct bfd_link_info
*);
2337 extern bool _bfd_elf_fixup_group_sections
2338 (bfd
*, asection
*);
2339 extern bool _bfd_elf_copy_private_header_data
2341 extern bool _bfd_elf_copy_private_symbol_data
2342 (bfd
*, asymbol
*, bfd
*, asymbol
*);
2343 #define _bfd_generic_init_private_section_data \
2344 _bfd_elf_init_private_section_data
2345 extern bool _bfd_elf_init_private_section_data
2346 (bfd
*, asection
*, bfd
*, asection
*, struct bfd_link_info
*);
2347 extern bool _bfd_elf_copy_private_section_data
2348 (bfd
*, asection
*, bfd
*, asection
*);
2349 extern bool _bfd_elf_write_object_contents
2351 extern bool _bfd_elf_write_corefile_contents
2353 extern bool _bfd_elf_set_section_contents
2354 (bfd
*, sec_ptr
, const void *, file_ptr
, bfd_size_type
);
2355 extern long _bfd_elf_get_symtab_upper_bound
2357 extern long _bfd_elf_canonicalize_symtab
2358 (bfd
*, asymbol
**);
2359 extern long _bfd_elf_get_dynamic_symtab_upper_bound
2361 extern long _bfd_elf_canonicalize_dynamic_symtab
2362 (bfd
*, asymbol
**);
2363 extern long _bfd_elf_get_synthetic_symtab
2364 (bfd
*, long, asymbol
**, long, asymbol
**, asymbol
**);
2365 extern long _bfd_elf_get_reloc_upper_bound
2367 extern long _bfd_elf_canonicalize_reloc
2368 (bfd
*, sec_ptr
, arelent
**, asymbol
**);
2369 extern asection
* _bfd_elf_get_dynamic_reloc_section
2370 (bfd
*, asection
*, bool);
2371 extern asection
* _bfd_elf_make_dynamic_reloc_section
2372 (asection
*, bfd
*, unsigned int, bfd
*, bool);
2373 extern long _bfd_elf_get_dynamic_reloc_upper_bound
2375 extern long _bfd_elf_canonicalize_dynamic_reloc
2376 (bfd
*, arelent
**, asymbol
**);
2377 extern asymbol
*_bfd_elf_make_empty_symbol
2379 extern void _bfd_elf_get_symbol_info
2380 (bfd
*, asymbol
*, symbol_info
*);
2381 extern bool _bfd_elf_is_local_label_name
2382 (bfd
*, const char *);
2383 extern alent
*_bfd_elf_get_lineno
2385 extern bool _bfd_elf_set_arch_mach
2386 (bfd
*, enum bfd_architecture
, unsigned long);
2387 extern bool _bfd_elf_find_nearest_line
2388 (bfd
*, asymbol
**, asection
*, bfd_vma
,
2389 const char **, const char **, unsigned int *, unsigned int *);
2390 extern bool _bfd_elf_find_nearest_line_with_alt
2391 (bfd
*, const char *, asymbol
**, asection
*, bfd_vma
,
2392 const char **, const char **, unsigned int *, unsigned int *);
2393 extern bool _bfd_elf_find_line
2394 (bfd
*, asymbol
**, asymbol
*, const char **, unsigned int *);
2395 extern bool _bfd_elf_find_inliner_info
2396 (bfd
*, const char **, const char **, unsigned int *);
2397 extern asymbol
*_bfd_elf_find_function
2398 (bfd
*, asymbol
**, asection
*, bfd_vma
, const char **, const char **);
2399 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
2400 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
2401 extern int _bfd_elf_sizeof_headers
2402 (bfd
*, struct bfd_link_info
*);
2403 extern bool _bfd_elf_new_section_hook
2404 (bfd
*, asection
*);
2405 extern const struct bfd_elf_special_section
*_bfd_elf_get_special_section
2406 (const char *, const struct bfd_elf_special_section
*, unsigned int);
2407 extern const struct bfd_elf_special_section
*_bfd_elf_get_sec_type_attr
2408 (bfd
*, asection
*);
2410 extern bool _bfd_elf_link_hide_sym_by_version
2411 (struct bfd_link_info
*, struct elf_link_hash_entry
*);
2413 /* If the target doesn't have reloc handling written yet: */
2414 extern bool _bfd_elf_no_info_to_howto
2415 (bfd
*, arelent
*, Elf_Internal_Rela
*);
2417 extern bool bfd_section_from_shdr
2418 (bfd
*, unsigned int shindex
);
2419 extern bool bfd_section_from_phdr
2420 (bfd
*, Elf_Internal_Phdr
*, int);
2422 extern int _bfd_elf_symbol_from_bfd_symbol
2423 (bfd
*, asymbol
**);
2425 extern Elf_Internal_Sym
*bfd_sym_from_r_symndx
2426 (struct sym_cache
*, bfd
*, unsigned long);
2427 extern asection
*bfd_section_from_elf_index
2428 (bfd
*, unsigned int);
2430 extern struct elf_strtab_hash
* _bfd_elf_strtab_init
2432 extern void _bfd_elf_strtab_free
2433 (struct elf_strtab_hash
*);
2434 extern size_t _bfd_elf_strtab_add
2435 (struct elf_strtab_hash
*, const char *, bool);
2436 extern void _bfd_elf_strtab_addref
2437 (struct elf_strtab_hash
*, size_t);
2438 extern void _bfd_elf_strtab_delref
2439 (struct elf_strtab_hash
*, size_t);
2440 extern unsigned int _bfd_elf_strtab_refcount
2441 (struct elf_strtab_hash
*, size_t);
2442 extern void _bfd_elf_strtab_clear_all_refs
2443 (struct elf_strtab_hash
*);
2444 extern void *_bfd_elf_strtab_save
2445 (struct elf_strtab_hash
*);
2446 extern void _bfd_elf_strtab_restore
2447 (struct elf_strtab_hash
*, void *);
2448 extern bfd_size_type _bfd_elf_strtab_size
2449 (struct elf_strtab_hash
*);
2450 extern bfd_size_type _bfd_elf_strtab_len
2451 (struct elf_strtab_hash
*);
2452 extern bfd_size_type _bfd_elf_strtab_offset
2453 (struct elf_strtab_hash
*, size_t);
2454 extern const char * _bfd_elf_strtab_str
2455 (struct elf_strtab_hash
*, size_t idx
, bfd_size_type
*offset
);
2456 extern bool _bfd_elf_strtab_emit
2457 (bfd
*, struct elf_strtab_hash
*);
2458 extern void _bfd_elf_strtab_finalize
2459 (struct elf_strtab_hash
*);
2461 extern bool bfd_elf_parse_eh_frame_entries
2462 (bfd
*, struct bfd_link_info
*);
2463 extern bool _bfd_elf_parse_eh_frame_entry
2464 (struct bfd_link_info
*, asection
*, struct elf_reloc_cookie
*);
2465 extern void _bfd_elf_parse_eh_frame
2466 (bfd
*, struct bfd_link_info
*, asection
*, struct elf_reloc_cookie
*);
2467 extern bool _bfd_elf_end_eh_frame_parsing
2468 (struct bfd_link_info
*info
);
2470 extern bool _bfd_elf_discard_section_eh_frame
2471 (bfd
*, struct bfd_link_info
*, asection
*,
2472 bool (*) (bfd_vma
, void *), struct elf_reloc_cookie
*);
2473 extern bool _bfd_elf_adjust_eh_frame_global_symbol
2474 (struct elf_link_hash_entry
*, void *);
2475 extern bool _bfd_elf_discard_section_eh_frame_hdr
2476 (struct bfd_link_info
*);
2477 extern bfd_vma _bfd_elf_eh_frame_section_offset
2478 (bfd
*, struct bfd_link_info
*, asection
*, bfd_vma
);
2479 extern bool _bfd_elf_write_section_eh_frame
2480 (bfd
*, struct bfd_link_info
*, asection
*, bfd_byte
*);
2481 bool _bfd_elf_write_section_eh_frame_entry
2482 (bfd
*, struct bfd_link_info
*, asection
*, bfd_byte
*);
2483 extern bool _bfd_elf_fixup_eh_frame_hdr (struct bfd_link_info
*);
2484 extern bool _bfd_elf_write_section_eh_frame_hdr
2485 (bfd
*, struct bfd_link_info
*);
2486 extern bool _bfd_elf_eh_frame_present
2487 (struct bfd_link_info
*);
2488 extern bool _bfd_elf_eh_frame_entry_present
2489 (struct bfd_link_info
*);
2490 extern bool _bfd_elf_maybe_strip_eh_frame_hdr
2491 (struct bfd_link_info
*);
2493 extern bool _bfd_elf_sframe_present
2494 (struct bfd_link_info
*);
2495 extern bool _bfd_elf_parse_sframe
2496 (bfd
*, struct bfd_link_info
*, asection
*, struct elf_reloc_cookie
*);
2497 extern bool _bfd_elf_discard_section_sframe
2498 (asection
*, bool (*) (bfd_vma
, void *), struct elf_reloc_cookie
*);
2499 extern bool _bfd_elf_merge_section_sframe
2500 (bfd
*, struct bfd_link_info
*, asection
*, bfd_byte
*);
2501 extern bool _bfd_elf_write_section_sframe
2502 (bfd
*, struct bfd_link_info
*);
2503 extern bool _bfd_elf_set_section_sframe (bfd
*, struct bfd_link_info
*);
2505 extern bool _bfd_elf_hash_symbol (struct elf_link_hash_entry
*);
2507 extern long _bfd_elf_link_lookup_local_dynindx
2508 (struct bfd_link_info
*, bfd
*, long);
2509 extern bool _bfd_elf_compute_section_file_positions
2510 (bfd
*, struct bfd_link_info
*);
2511 extern file_ptr _bfd_elf_assign_file_position_for_section
2512 (Elf_Internal_Shdr
*, file_ptr
, bool);
2513 extern bool _bfd_elf_modify_headers
2514 (bfd
*, struct bfd_link_info
*);
2516 extern bool _bfd_elf_validate_reloc
2519 extern bool bfd_elf_record_link_assignment
2520 (bfd
*, struct bfd_link_info
*, const char *, bool,
2522 extern bool bfd_elf_stack_segment_size (bfd
*, struct bfd_link_info
*,
2523 const char *, bfd_vma
);
2524 extern bool bfd_elf_size_dynamic_sections
2525 (bfd
*, const char *, const char *, const char *, const char *, const char *,
2526 const char * const *, struct bfd_link_info
*, struct bfd_section
**);
2527 extern bool bfd_elf_size_dynsym_hash_dynstr
2528 (bfd
*, struct bfd_link_info
*);
2529 extern bool bfd_elf_get_bfd_needed_list
2530 (bfd
*, struct bfd_link_needed_list
**);
2531 extern struct bfd_link_needed_list
*bfd_elf_get_needed_list
2532 (bfd
*, struct bfd_link_info
*);
2533 extern void bfd_elf_set_dt_needed_name
2534 (bfd
*, const char *);
2535 extern const char *bfd_elf_get_dt_soname
2537 extern void bfd_elf_set_dyn_lib_class
2538 (bfd
*, enum dynamic_lib_link_class
);
2539 extern int bfd_elf_get_dyn_lib_class
2541 extern struct bfd_link_needed_list
*bfd_elf_get_runpath_list
2542 (bfd
*, struct bfd_link_info
*);
2543 extern int bfd_elf_discard_info
2544 (bfd
*, struct bfd_link_info
*);
2545 extern unsigned int _bfd_elf_default_action_discarded
2546 (struct bfd_section
*);
2547 extern struct bfd_section
*_bfd_elf_tls_setup
2548 (bfd
*, struct bfd_link_info
*);
2550 extern bool _bfd_elf_link_create_dynamic_sections
2551 (bfd
*, struct bfd_link_info
*);
2552 extern bool _bfd_elf_omit_section_dynsym_default
2553 (bfd
*, struct bfd_link_info
*, asection
*);
2554 extern bool _bfd_elf_omit_section_dynsym_all
2555 (bfd
*, struct bfd_link_info
*, asection
*);
2556 extern bool _bfd_elf_create_dynamic_sections
2557 (bfd
*, struct bfd_link_info
*);
2558 extern bool _bfd_elf_create_got_section
2559 (bfd
*, struct bfd_link_info
*);
2560 extern asection
*_bfd_elf_section_for_symbol
2561 (struct elf_reloc_cookie
*, unsigned long, bool);
2562 extern struct elf_link_hash_entry
*_bfd_elf_define_linkage_sym
2563 (bfd
*, struct bfd_link_info
*, asection
*, const char *);
2564 extern void _bfd_elf_init_1_index_section
2565 (bfd
*, struct bfd_link_info
*);
2566 extern void _bfd_elf_init_2_index_sections
2567 (bfd
*, struct bfd_link_info
*);
2569 extern bool _bfd_elfcore_make_pseudosection
2570 (bfd
*, char *, size_t, ufile_ptr
);
2571 extern char *_bfd_elfcore_strndup
2572 (bfd
*, char *, size_t);
2574 extern Elf_Internal_Rela
*_bfd_elf_link_read_relocs
2575 (bfd
*, asection
*, void *, Elf_Internal_Rela
*, bool);
2576 extern Elf_Internal_Rela
*_bfd_elf_link_info_read_relocs
2577 (bfd
*, struct bfd_link_info
*, asection
*, void *, Elf_Internal_Rela
*,
2580 extern bool _bfd_elf_link_output_relocs
2581 (bfd
*, asection
*, Elf_Internal_Shdr
*, Elf_Internal_Rela
*,
2582 struct elf_link_hash_entry
**);
2584 extern bool _bfd_elf_adjust_dynamic_copy
2585 (struct bfd_link_info
*, struct elf_link_hash_entry
*, asection
*);
2587 extern bool _bfd_elf_dynamic_symbol_p
2588 (struct elf_link_hash_entry
*, struct bfd_link_info
*, bool);
2590 extern bool _bfd_elf_symbol_refs_local_p
2591 (struct elf_link_hash_entry
*, struct bfd_link_info
*, bool);
2593 extern bfd_reloc_status_type bfd_elf_perform_complex_relocation
2594 (bfd
*, asection
*, bfd_byte
*, Elf_Internal_Rela
*, bfd_vma
);
2596 extern bool _bfd_elf_setup_sections
2599 extern bool _bfd_elf_get_dynamic_symbols
2600 (bfd
*, Elf_Internal_Phdr
*, Elf_Internal_Phdr
*, size_t,
2602 extern asection
*_bfd_elf_get_section_from_dynamic_symbol
2603 (bfd
*, Elf_Internal_Sym
*);
2605 extern struct bfd_link_hash_entry
*bfd_elf_define_start_stop
2606 (struct bfd_link_info
*, const char *, asection
*);
2608 extern bool _bfd_elf_init_file_header (bfd
*, struct bfd_link_info
*);
2610 extern bool _bfd_elf_final_write_processing (bfd
*);
2612 extern bfd_cleanup bfd_elf32_object_p
2614 extern bfd_cleanup bfd_elf32_core_file_p
2616 extern char *bfd_elf32_core_file_failing_command
2618 extern int bfd_elf32_core_file_failing_signal
2620 extern bool bfd_elf32_core_file_matches_executable_p
2622 extern int bfd_elf32_core_file_pid
2624 extern bool _bfd_elf32_core_find_build_id
2627 extern bool bfd_elf32_swap_symbol_in
2628 (bfd
*, const void *, const void *, Elf_Internal_Sym
*);
2629 extern void bfd_elf32_swap_symbol_out
2630 (bfd
*, const Elf_Internal_Sym
*, void *, void *);
2631 extern void bfd_elf32_swap_reloc_in
2632 (bfd
*, const bfd_byte
*, Elf_Internal_Rela
*);
2633 extern void bfd_elf32_swap_reloc_out
2634 (bfd
*, const Elf_Internal_Rela
*, bfd_byte
*);
2635 extern void bfd_elf32_swap_reloca_in
2636 (bfd
*, const bfd_byte
*, Elf_Internal_Rela
*);
2637 extern void bfd_elf32_swap_reloca_out
2638 (bfd
*, const Elf_Internal_Rela
*, bfd_byte
*);
2639 extern void bfd_elf32_swap_phdr_in
2640 (bfd
*, const Elf32_External_Phdr
*, Elf_Internal_Phdr
*);
2641 extern void bfd_elf32_swap_phdr_out
2642 (bfd
*, const Elf_Internal_Phdr
*, Elf32_External_Phdr
*);
2643 extern void bfd_elf32_swap_dyn_in
2644 (bfd
*, const void *, Elf_Internal_Dyn
*);
2645 extern void bfd_elf32_swap_dyn_out
2646 (bfd
*, const Elf_Internal_Dyn
*, void *);
2647 extern long bfd_elf32_slurp_symbol_table
2648 (bfd
*, asymbol
**, bool);
2649 extern bool bfd_elf32_write_shdrs_and_ehdr
2651 extern int bfd_elf32_write_out_phdrs
2652 (bfd
*, const Elf_Internal_Phdr
*, unsigned int);
2653 extern bool bfd_elf32_checksum_contents
2654 (bfd
* , void (*) (const void *, size_t, void *), void *);
2655 extern void bfd_elf32_write_relocs
2656 (bfd
*, asection
*, void *);
2657 extern bool bfd_elf32_slurp_reloc_table
2658 (bfd
*, asection
*, asymbol
**, bool);
2660 extern bfd_cleanup bfd_elf64_object_p
2662 extern bfd_cleanup bfd_elf64_core_file_p
2664 extern char *bfd_elf64_core_file_failing_command
2666 extern int bfd_elf64_core_file_failing_signal
2668 extern bool bfd_elf64_core_file_matches_executable_p
2670 extern int bfd_elf64_core_file_pid
2672 extern bool _bfd_elf64_core_find_build_id
2675 extern bool bfd_elf64_swap_symbol_in
2676 (bfd
*, const void *, const void *, Elf_Internal_Sym
*);
2677 extern void bfd_elf64_swap_symbol_out
2678 (bfd
*, const Elf_Internal_Sym
*, void *, void *);
2679 extern void bfd_elf64_swap_reloc_in
2680 (bfd
*, const bfd_byte
*, Elf_Internal_Rela
*);
2681 extern void bfd_elf64_swap_reloc_out
2682 (bfd
*, const Elf_Internal_Rela
*, bfd_byte
*);
2683 extern void bfd_elf64_swap_reloca_in
2684 (bfd
*, const bfd_byte
*, Elf_Internal_Rela
*);
2685 extern void bfd_elf64_swap_reloca_out
2686 (bfd
*, const Elf_Internal_Rela
*, bfd_byte
*);
2687 extern void bfd_elf64_swap_phdr_in
2688 (bfd
*, const Elf64_External_Phdr
*, Elf_Internal_Phdr
*);
2689 extern void bfd_elf64_swap_phdr_out
2690 (bfd
*, const Elf_Internal_Phdr
*, Elf64_External_Phdr
*);
2691 extern void bfd_elf64_swap_dyn_in
2692 (bfd
*, const void *, Elf_Internal_Dyn
*);
2693 extern void bfd_elf64_swap_dyn_out
2694 (bfd
*, const Elf_Internal_Dyn
*, void *);
2695 extern long bfd_elf64_slurp_symbol_table
2696 (bfd
*, asymbol
**, bool);
2697 extern bool bfd_elf64_write_shdrs_and_ehdr
2699 extern int bfd_elf64_write_out_phdrs
2700 (bfd
*, const Elf_Internal_Phdr
*, unsigned int);
2701 extern bool bfd_elf64_checksum_contents
2702 (bfd
* , void (*) (const void *, size_t, void *), void *);
2703 extern void bfd_elf64_write_relocs
2704 (bfd
*, asection
*, void *);
2705 extern bool bfd_elf64_slurp_reloc_table
2706 (bfd
*, asection
*, asymbol
**, bool);
2708 extern bool _bfd_elf_default_relocs_compatible
2709 (const bfd_target
*, const bfd_target
*);
2711 extern bool _bfd_elf_relocs_compatible
2712 (const bfd_target
*, const bfd_target
*);
2713 extern bool _bfd_elf_notice_as_needed
2714 (bfd
*, struct bfd_link_info
*, enum notice_asneeded_action
);
2716 extern struct bfd_link_hash_entry
*_bfd_elf_archive_symbol_lookup
2717 (bfd
*, struct bfd_link_info
*, const char *);
2718 extern bool bfd_elf_link_add_symbols
2719 (bfd
*, struct bfd_link_info
*);
2720 extern bool _bfd_elf_add_dynamic_entry
2721 (struct bfd_link_info
*, bfd_vma
, bfd_vma
);
2722 extern bool _bfd_elf_strip_zero_sized_dynamic_sections
2723 (struct bfd_link_info
*);
2724 extern int bfd_elf_add_dt_needed_tag
2725 (bfd
*, struct bfd_link_info
*);
2726 extern bool _bfd_elf_link_check_relocs
2727 (bfd
*, struct bfd_link_info
*);
2728 extern bool _bfd_elf_link_iterate_on_relocs
2729 (bfd
*, struct bfd_link_info
*,
2730 bool (*) (bfd
*, struct bfd_link_info
*, asection
*,
2731 const Elf_Internal_Rela
*));
2733 extern bool bfd_elf_link_record_dynamic_symbol
2734 (struct bfd_link_info
*, struct elf_link_hash_entry
*);
2736 extern int bfd_elf_link_record_local_dynamic_symbol
2737 (struct bfd_link_info
*, bfd
*, long);
2739 extern bool _bfd_elf_free_cached_info
2742 extern bool _bfd_elf_common_definition
2743 (Elf_Internal_Sym
*);
2745 extern unsigned int _bfd_elf_common_section_index
2748 extern asection
*_bfd_elf_common_section
2751 extern bfd_vma _bfd_elf_default_got_elt_size
2752 (bfd
*, struct bfd_link_info
*, struct elf_link_hash_entry
*, bfd
*,
2755 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
2756 (bfd
*, arelent
*, struct bfd_symbol
*, void *,
2757 asection
*, bfd
*, char **);
2759 extern bool bfd_elf_final_link
2760 (bfd
*, struct bfd_link_info
*);
2762 extern void _bfd_elf_gc_keep
2763 (struct bfd_link_info
*info
);
2765 extern bool bfd_elf_gc_mark_dynamic_ref_symbol
2766 (struct elf_link_hash_entry
*h
, void *inf
);
2768 extern bool bfd_elf_gc_sections
2769 (bfd
*, struct bfd_link_info
*);
2771 extern bool bfd_elf_gc_record_vtinherit
2772 (bfd
*, asection
*, struct elf_link_hash_entry
*, bfd_vma
);
2774 extern bool bfd_elf_gc_record_vtentry
2775 (bfd
*, asection
*, struct elf_link_hash_entry
*, bfd_vma
);
2777 extern asection
*_bfd_elf_gc_mark_hook
2778 (asection
*, struct bfd_link_info
*, Elf_Internal_Rela
*,
2779 struct elf_link_hash_entry
*, Elf_Internal_Sym
*);
2781 extern asection
*_bfd_elf_gc_mark_rsec
2782 (struct bfd_link_info
*, asection
*, elf_gc_mark_hook_fn
,
2783 struct elf_reloc_cookie
*, bool *);
2785 extern bool _bfd_elf_gc_mark_reloc
2786 (struct bfd_link_info
*, asection
*, elf_gc_mark_hook_fn
,
2787 struct elf_reloc_cookie
*);
2789 extern bool _bfd_elf_gc_mark_fdes
2790 (struct bfd_link_info
*, asection
*, asection
*, elf_gc_mark_hook_fn
,
2791 struct elf_reloc_cookie
*);
2793 extern bool _bfd_elf_gc_mark
2794 (struct bfd_link_info
*, asection
*, elf_gc_mark_hook_fn
);
2796 extern bool _bfd_elf_gc_mark_extra_sections
2797 (struct bfd_link_info
*, elf_gc_mark_hook_fn
);
2799 extern bool bfd_elf_gc_common_finalize_got_offsets
2800 (bfd
*, struct bfd_link_info
*);
2802 extern bool bfd_elf_gc_common_final_link
2803 (bfd
*, struct bfd_link_info
*);
2805 extern bool bfd_elf_reloc_symbol_deleted_p
2808 extern struct elf_segment_map
* _bfd_elf_make_dynamic_segment
2809 (bfd
*, asection
*);
2811 extern bool _bfd_elf_map_sections_to_segments
2812 (bfd
*, struct bfd_link_info
*, bool *);
2814 extern bool _bfd_elf_is_function_type (unsigned int);
2816 extern bfd_size_type
_bfd_elf_maybe_function_sym (const asymbol
*, asection
*,
2819 extern asection
*_bfd_elf_plt_get_reloc_section (bfd
*, const char *);
2821 extern int bfd_elf_get_default_section_type (flagword
);
2823 extern bool bfd_elf_lookup_section_flags
2824 (struct bfd_link_info
*, struct flag_info
*, asection
*);
2826 extern Elf_Internal_Phdr
* _bfd_elf_find_segment_containing_section
2827 (bfd
* abfd
, asection
* section
);
2829 /* PowerPC @tls opcode transform/validate. */
2830 extern unsigned int _bfd_elf_ppc_at_tls_transform
2831 (unsigned int, unsigned int);
2832 /* PowerPC @tprel opcode transform/validate. */
2833 extern unsigned int _bfd_elf_ppc_at_tprel_transform
2834 (unsigned int, unsigned int);
2835 /* PowerPC elf_object_p tweak. */
2836 extern bool _bfd_elf_ppc_set_arch (bfd
*);
2837 /* PowerPC .gnu.attributes handling common to both 32-bit and 64-bit. */
2838 extern bool _bfd_elf_ppc_merge_fp_attributes
2839 (bfd
*, struct bfd_link_info
*);
2841 /* Return an upper bound on the number of bytes required to store a
2842 copy of ABFD's program header table entries. Return -1 if an error
2843 occurs; bfd_get_error will return an appropriate code. */
2844 extern long bfd_get_elf_phdr_upper_bound
2847 /* Copy ABFD's program header table entries to *PHDRS. The entries
2848 will be stored as an array of Elf_Internal_Phdr structures, as
2849 defined in include/elf/internal.h. To find out how large the
2850 buffer needs to be, call bfd_get_elf_phdr_upper_bound.
2852 Return the number of program header table entries read, or -1 if an
2853 error occurs; bfd_get_error will return an appropriate code. */
2854 extern int bfd_get_elf_phdrs
2855 (bfd
*abfd
, void *phdrs
);
2857 /* Exported interface for writing elf corefile notes. */
2858 extern char *elfcore_write_note
2859 (bfd
*, char *, int *, const char *, int, const void *, int);
2860 extern char *elfcore_write_prpsinfo
2861 (bfd
*, char *, int *, const char *, const char *);
2862 extern char *elfcore_write_prstatus
2863 (bfd
*, char *, int *, long, int, const void *);
2864 extern char * elfcore_write_pstatus
2865 (bfd
*, char *, int *, long, int, const void *);
2866 extern char *elfcore_write_prfpreg
2867 (bfd
*, char *, int *, const void *, int);
2868 extern char *elfcore_write_prxfpreg
2869 (bfd
*, char *, int *, const void *, int);
2870 extern char *elfcore_write_xstatereg
2871 (bfd
*, char *, int *, const void *, int);
2872 extern char *elfcore_write_x86_segbases
2873 (bfd
*, char *, int *, const void *, int);
2874 extern char *elfcore_write_ppc_vmx
2875 (bfd
*, char *, int *, const void *, int);
2876 extern char *elfcore_write_ppc_vsx
2877 (bfd
*, char *, int *, const void *, int);
2878 extern char *elfcore_write_ppc_tar
2879 (bfd
*, char *, int *, const void *, int);
2880 extern char *elfcore_write_ppc_ppr
2881 (bfd
*, char *, int *, const void *, int);
2882 extern char *elfcore_write_ppc_dscr
2883 (bfd
*, char *, int *, const void *, int);
2884 extern char *elfcore_write_ppc_ebb
2885 (bfd
*, char *, int *, const void *, int);
2886 extern char *elfcore_write_ppc_pmu
2887 (bfd
*, char *, int *, const void *, int);
2888 extern char *elfcore_write_ppc_tm_cgpr
2889 (bfd
*, char *, int *, const void *, int);
2890 extern char *elfcore_write_ppc_tm_cfpr
2891 (bfd
*, char *, int *, const void *, int);
2892 extern char *elfcore_write_ppc_tm_cvmx
2893 (bfd
*, char *, int *, const void *, int);
2894 extern char *elfcore_write_ppc_tm_cvsx
2895 (bfd
*, char *, int *, const void *, int);
2896 extern char *elfcore_write_ppc_tm_spr
2897 (bfd
*, char *, int *, const void *, int);
2898 extern char *elfcore_write_ppc_tm_ctar
2899 (bfd
*, char *, int *, const void *, int);
2900 extern char *elfcore_write_ppc_tm_cppr
2901 (bfd
*, char *, int *, const void *, int);
2902 extern char *elfcore_write_ppc_tm_cdscr
2903 (bfd
*, char *, int *, const void *, int);
2904 extern char *elfcore_write_s390_timer
2905 (bfd
*, char *, int *, const void *, int);
2906 extern char *elfcore_write_s390_todcmp
2907 (bfd
*, char *, int *, const void *, int);
2908 extern char *elfcore_write_s390_todpreg
2909 (bfd
*, char *, int *, const void *, int);
2910 extern char *elfcore_write_s390_ctrs
2911 (bfd
*, char *, int *, const void *, int);
2912 extern char *elfcore_write_s390_prefix
2913 (bfd
*, char *, int *, const void *, int);
2914 extern char *elfcore_write_s390_last_break
2915 (bfd
*, char *, int *, const void *, int);
2916 extern char *elfcore_write_s390_system_call
2917 (bfd
*, char *, int *, const void *, int);
2918 extern char *elfcore_write_s390_tdb
2919 (bfd
*, char *, int *, const void *, int);
2920 extern char *elfcore_write_s390_vxrs_low
2921 (bfd
*, char *, int *, const void *, int);
2922 extern char *elfcore_write_s390_vxrs_high
2923 (bfd
*, char *, int *, const void *, int);
2924 extern char *elfcore_write_s390_gs_cb
2925 (bfd
*, char *, int *, const void *, int);
2926 extern char *elfcore_write_s390_gs_bc
2927 (bfd
*, char *, int *, const void *, int);
2928 extern char *elfcore_write_arm_vfp
2929 (bfd
*, char *, int *, const void *, int);
2930 extern char *elfcore_write_aarch_tls
2931 (bfd
*, char *, int *, const void *, int);
2932 extern char *elfcore_write_aarch_hw_break
2933 (bfd
*, char *, int *, const void *, int);
2934 extern char *elfcore_write_aarch_hw_watch
2935 (bfd
*, char *, int *, const void *, int);
2936 extern char *elfcore_write_aarch_sve
2937 (bfd
*, char *, int *, const void *, int);
2938 extern char *elfcore_write_aarch_pauth
2939 (bfd
*, char *, int *, const void *, int);
2940 extern char *elfcore_write_aarch_mte
2941 (bfd
*, char *, int *, const void *, int);
2942 extern char *elfcore_write_arc_v2
2943 (bfd
*, char *, int *, const void *, int);
2944 extern char *elfcore_write_riscv_csr
2945 (bfd
*, char *, int *, const void *, int);
2946 extern char *elfcore_write_gdb_tdesc
2947 (bfd
*, char *, int *, const void *, int);
2948 extern char *elfcore_write_lwpstatus
2949 (bfd
*, char *, int *, long, int, const void *);
2950 extern char *elfcore_write_register_note
2951 (bfd
*, char *, int *, const char *, const void *, int);
2952 extern char *elfcore_write_file_note
2953 (bfd
*, char *, int *, const void*, int);
2954 extern char *elfcore_write_loongarch_cpucfg
2955 (bfd
*, char *, int *, const void*, int);
2956 extern char *elfcore_write_loongarch_lbt
2957 (bfd
*, char *, int *, const void*, int);
2958 extern char *elfcore_write_loongarch_lsx
2959 (bfd
*, char *, int *, const void*, int);
2960 extern char *elfcore_write_loongarch_lasx
2961 (bfd
*, char *, int *, const void*, int);
2963 /* Internal structure which holds information to be included in the
2964 PRPSINFO section of Linux core files.
2966 This is an "internal" structure in the sense that it should be used
2967 to pass information to BFD (via the `elfcore_write_linux_prpsinfo'
2968 function), so things like endianess shouldn't be an issue. This
2969 structure will eventually be converted in one of the
2970 `elf_external_linux_*' structures and written out to an output bfd
2971 by one of the functions declared below. */
2973 struct elf_internal_linux_prpsinfo
2975 char pr_state
; /* Numeric process state. */
2976 char pr_sname
; /* Char for pr_state. */
2977 char pr_zomb
; /* Zombie. */
2978 char pr_nice
; /* Nice val. */
2979 unsigned long pr_flag
; /* Flags. */
2980 unsigned int pr_uid
;
2981 unsigned int pr_gid
;
2982 int pr_pid
, pr_ppid
, pr_pgrp
, pr_sid
;
2983 char pr_fname
[16 + 1]; /* Filename of executable. */
2984 char pr_psargs
[80 + 1]; /* Initial part of arg list. */
2987 /* Linux/most 32-bit archs. */
2988 extern char *elfcore_write_linux_prpsinfo32
2989 (bfd
*, char *, int *, const struct elf_internal_linux_prpsinfo
*);
2991 /* Linux/most 64-bit archs. */
2992 extern char *elfcore_write_linux_prpsinfo64
2993 (bfd
*, char *, int *, const struct elf_internal_linux_prpsinfo
*);
2995 extern bfd
*_bfd_elf32_bfd_from_remote_memory
2996 (bfd
*templ
, bfd_vma ehdr_vma
, bfd_size_type size
, bfd_vma
*loadbasep
,
2997 int (*target_read_memory
) (bfd_vma
, bfd_byte
*, bfd_size_type
));
2998 extern bfd
*_bfd_elf64_bfd_from_remote_memory
2999 (bfd
*templ
, bfd_vma ehdr_vma
, bfd_size_type size
, bfd_vma
*loadbasep
,
3000 int (*target_read_memory
) (bfd_vma
, bfd_byte
*, bfd_size_type
));
3002 extern bfd_vma
bfd_elf_obj_attr_size (bfd
*);
3003 extern void bfd_elf_set_obj_attr_contents (bfd
*, bfd_byte
*, bfd_vma
);
3004 extern int bfd_elf_get_obj_attr_int (bfd
*, int, unsigned int);
3005 extern void bfd_elf_add_obj_attr_int (bfd
*, int, unsigned int, unsigned int);
3006 #define bfd_elf_add_proc_attr_int(BFD, TAG, VALUE) \
3007 bfd_elf_add_obj_attr_int ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
3008 extern void bfd_elf_add_obj_attr_string (bfd
*, int, unsigned int, const char *);
3009 #define bfd_elf_add_proc_attr_string(BFD, TAG, VALUE) \
3010 bfd_elf_add_obj_attr_string ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
3011 extern void bfd_elf_add_obj_attr_int_string (bfd
*, int, unsigned int,
3012 unsigned int, const char *);
3013 #define bfd_elf_add_proc_attr_int_string(BFD, TAG, INTVAL, STRVAL) \
3014 bfd_elf_add_obj_attr_int_string ((BFD), OBJ_ATTR_PROC, (TAG), \
3017 extern char *_bfd_elf_attr_strdup (bfd
*, const char *);
3018 extern void _bfd_elf_copy_obj_attributes (bfd
*, bfd
*);
3019 extern int _bfd_elf_obj_attrs_arg_type (bfd
*, int, unsigned int);
3020 extern void _bfd_elf_parse_attributes (bfd
*, Elf_Internal_Shdr
*);
3021 extern bool _bfd_elf_merge_object_attributes
3022 (bfd
*, struct bfd_link_info
*);
3023 extern bool _bfd_elf_merge_unknown_attribute_low (bfd
*, bfd
*, int);
3024 extern bool _bfd_elf_merge_unknown_attribute_list (bfd
*, bfd
*);
3025 extern Elf_Internal_Shdr
*_bfd_elf_single_rel_hdr (asection
*sec
);
3026 extern bool elf_read_notes (bfd
*, file_ptr
, bfd_size_type
, size_t);
3028 extern bool _bfd_elf_parse_gnu_properties
3029 (bfd
*, Elf_Internal_Note
*);
3030 extern elf_property
* _bfd_elf_get_property
3031 (bfd
*, unsigned int, unsigned int);
3032 extern bfd
*_bfd_elf_link_setup_gnu_properties
3033 (struct bfd_link_info
*);
3034 extern bfd_size_type _bfd_elf_convert_gnu_property_size
3036 extern bool _bfd_elf_convert_gnu_properties
3037 (bfd
*, asection
*, bfd
*, bfd_byte
**, bfd_size_type
*);
3039 /* The linker may need to keep track of the number of relocs that it
3040 decides to copy as dynamic relocs in check_relocs for each symbol.
3041 This is so that it can later discard them if they are found to be
3042 unnecessary. We can store the information in a field extending the
3043 regular ELF linker hash table. */
3045 struct elf_dyn_relocs
3047 struct elf_dyn_relocs
*next
;
3049 /* The input section of the reloc. */
3052 /* Total number of relocs copied for the input section. */
3053 bfd_size_type count
;
3055 /* Number of pc-relative relocs copied for the input section. */
3056 bfd_size_type pc_count
;
3059 extern bool _bfd_elf_create_ifunc_sections
3060 (bfd
*, struct bfd_link_info
*);
3061 extern bool _bfd_elf_allocate_ifunc_dyn_relocs
3062 (struct bfd_link_info
*, struct elf_link_hash_entry
*,
3063 struct elf_dyn_relocs
**, unsigned int, unsigned int,
3064 unsigned int, bool);
3066 extern void elf_append_rela (bfd
*, asection
*, Elf_Internal_Rela
*);
3067 extern void elf_append_rel (bfd
*, asection
*, Elf_Internal_Rela
*);
3069 extern bfd_vma
elf64_r_info (bfd_vma
, bfd_vma
);
3070 extern bfd_vma
elf64_r_sym (bfd_vma
);
3071 extern bfd_vma
elf32_r_info (bfd_vma
, bfd_vma
);
3072 extern bfd_vma
elf32_r_sym (bfd_vma
);
3074 extern bool is_debuginfo_file (bfd
*);
3077 extern bool _bfd_elf_init_secondary_reloc_section
3078 (bfd
*, Elf_Internal_Shdr
*, const char *, unsigned int);
3079 extern bool _bfd_elf_slurp_secondary_reloc_section
3080 (bfd
*, asection
*, asymbol
**, bool);
3081 extern bool _bfd_elf_copy_special_section_fields
3082 (const bfd
*, bfd
*, const Elf_Internal_Shdr
*, Elf_Internal_Shdr
*);
3083 extern bool _bfd_elf_write_secondary_reloc_section
3084 (bfd
*, asection
*);
3085 extern unsigned int _bfd_elf_symbol_section_index
3086 (bfd
*, elf_symbol_type
*);
3088 extern asection
*_bfd_elf_readonly_dynrelocs
3089 (struct elf_link_hash_entry
*);
3090 extern bool _bfd_elf_maybe_set_textrel
3091 (struct elf_link_hash_entry
*, void *);
3093 extern bool _bfd_elf_add_dynamic_tags
3094 (bfd
*, struct bfd_link_info
*, bool);
3096 /* Large common section. */
3097 extern asection _bfd_elf_large_com_section
;
3099 /* Hash for local symbol with the first section id, ID, in the input
3100 file and the local symbol index, SYM. */
3101 #define ELF_LOCAL_SYMBOL_HASH(ID, SYM) \
3102 (((((ID) & 0xffU) << 24) | (((ID) & 0xff00) << 8)) \
3103 ^ (SYM) ^ (((ID) & 0xffff0000U) >> 16))
3105 /* This is the condition under which finish_dynamic_symbol will be called.
3106 If our finish_dynamic_symbol isn't called, we'll need to do something
3107 about initializing any .plt and .got entries in relocate_section. */
3108 #define WILL_CALL_FINISH_DYNAMIC_SYMBOL(DYN, SHARED, H) \
3110 && ((SHARED) || !(H)->forced_local) \
3111 && ((H)->dynindx != -1 || (H)->forced_local))
3113 /* This macro is to avoid lots of duplicated code in the body
3114 of xxx_relocate_section() in the various elfxx-xxxx.c files. */
3115 #define RELOC_FOR_GLOBAL_SYMBOL(info, input_bfd, input_section, rel, \
3116 r_symndx, symtab_hdr, sym_hashes, \
3117 h, sec, relocation, \
3118 unresolved_reloc, warned, ignored) \
3121 /* It seems this can happen with erroneous or unsupported \
3122 input (mixing a.out and elf in an archive, for example.) */ \
3123 if (sym_hashes == NULL) \
3126 h = sym_hashes[r_symndx - symtab_hdr->sh_info]; \
3128 if (info->wrap_hash != NULL \
3129 && (input_section->flags & SEC_DEBUGGING) != 0) \
3130 h = ((struct elf_link_hash_entry *) \
3131 unwrap_hash_lookup (info, input_bfd, &h->root)); \
3133 while (h->root.type == bfd_link_hash_indirect \
3134 || h->root.type == bfd_link_hash_warning) \
3135 h = (struct elf_link_hash_entry *) h->root.u.i.link; \
3139 unresolved_reloc = false; \
3141 if (h->root.type == bfd_link_hash_defined \
3142 || h->root.type == bfd_link_hash_defweak) \
3144 sec = h->root.u.def.section; \
3146 || sec->output_section == NULL) \
3147 /* Set a flag that will be cleared later if we find a \
3148 relocation value for this symbol. output_section \
3149 is typically NULL for symbols satisfied by a shared \
3151 unresolved_reloc = true; \
3153 relocation = (h->root.u.def.value \
3154 + sec->output_section->vma \
3155 + sec->output_offset); \
3157 else if (h->root.type == bfd_link_hash_undefweak) \
3159 else if (info->unresolved_syms_in_objects == RM_IGNORE \
3160 && ELF_ST_VISIBILITY (h->other) == STV_DEFAULT) \
3162 else if (!bfd_link_relocatable (info)) \
3164 bool err = ((info->unresolved_syms_in_objects == RM_DIAGNOSE \
3165 && !info->warn_unresolved_syms) \
3166 || ELF_ST_VISIBILITY (h->other) != STV_DEFAULT); \
3167 (*info->callbacks->undefined_symbol) (info, \
3168 h->root.root.string, \
3171 rel->r_offset, err); \
3174 (void) unresolved_reloc; \
3180 /* This macro is to avoid lots of duplicated code in the body of the
3181 loop over relocations in xxx_relocate_section() in the various
3184 Handle relocations against symbols from removed linkonce sections,
3185 or sections discarded by a linker script. When doing a relocatable
3186 link, we remove such relocations. Otherwise, we just want the
3187 section contents zeroed and avoid any special processing. */
3188 #define RELOC_AGAINST_DISCARDED_SECTION(info, input_bfd, input_section, \
3189 rel, count, relend, \
3190 howto, index, contents) \
3193 _bfd_clear_contents (howto, input_bfd, input_section, \
3194 contents, rel[index].r_offset); \
3196 if (bfd_link_relocatable (info) \
3197 && (input_section->flags & SEC_DEBUGGING)) \
3199 /* Only remove relocations in debug sections since other \
3200 sections may require relocations. */ \
3201 Elf_Internal_Shdr *rel_hdr; \
3203 rel_hdr = _bfd_elf_single_rel_hdr (input_section->output_section); \
3205 /* Avoid empty output section. */ \
3206 if (rel_hdr->sh_size > rel_hdr->sh_entsize) \
3208 rel_hdr->sh_size -= rel_hdr->sh_entsize; \
3209 rel_hdr = _bfd_elf_single_rel_hdr (input_section); \
3210 rel_hdr->sh_size -= rel_hdr->sh_entsize; \
3212 memmove (rel, rel + count, \
3213 (relend - rel - count) * sizeof (*rel)); \
3215 input_section->reloc_count -= count; \
3222 for (i_ = 0; i_ < count; i_++) \
3224 rel[i_].r_info = 0; \
3225 rel[i_].r_addend = 0; \
3231 /* Will a symbol be bound to the definition within the shared
3232 library, if any. A unique symbol can never be bound locally. */
3233 #define SYMBOLIC_BIND(INFO, H) \
3234 (!(H)->unique_global \
3235 && ((INFO)->symbolic \
3236 || (H)->start_stop \
3237 || ((INFO)->dynamic && !(H)->dynamic)))
3239 /* Determine if a section contains CTF data, using its name. */
3241 bfd_section_is_ctf (const asection
*sec
)
3243 const char *name
= bfd_section_name (sec
);
3244 return startswith (name
, ".ctf") && (name
[4] == 0 || name
[4] == '.');
3250 #endif /* _LIBELF_H_ */