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