elf: Update comments for check_relocs in elf_backend_data
[binutils-gdb.git] / bfd / elf-bfd.h
1 /* BFD back-end data structures for ELF files.
2 Copyright (C) 1992-2021 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 BFD flags applied to sections created for dynamic linking. */
949 flagword dynamic_sec_flags;
950
951 /* Architecture-specific data for this backend.
952 This is actually a pointer to some type like struct elf_ARCH_data. */
953 const void *arch_data;
954
955 /* A function to translate an ELF RELA relocation to a BFD arelent
956 structure. Returns TRUE upon success, FALSE otherwise. */
957 bool (*elf_info_to_howto)
958 (bfd *, arelent *, Elf_Internal_Rela *);
959
960 /* A function to translate an ELF REL relocation to a BFD arelent
961 structure. Returns TRUE upon success, FALSE otherwise. */
962 bool (*elf_info_to_howto_rel)
963 (bfd *, arelent *, Elf_Internal_Rela *);
964
965 /* A function to determine whether a symbol is global when
966 partitioning the symbol table into local and global symbols.
967 This should be NULL for most targets, in which case the correct
968 thing will be done. MIPS ELF, at least on the Irix 5, has
969 special requirements. */
970 bool (*elf_backend_sym_is_global)
971 (bfd *, asymbol *);
972
973 /* The remaining functions are hooks which are called only if they
974 are not NULL. */
975
976 /* A function to permit a backend specific check on whether a
977 particular BFD format is relevant for an object file, and to
978 permit the backend to set any global information it wishes. When
979 this is called elf_elfheader is set, but anything else should be
980 used with caution. If this returns FALSE, the check_format
981 routine will return a bfd_error_wrong_format error. */
982 bool (*elf_backend_object_p)
983 (bfd *);
984
985 /* A function to do additional symbol processing when reading the
986 ELF symbol table. This is where any processor-specific special
987 section indices are handled. */
988 void (*elf_backend_symbol_processing)
989 (bfd *, asymbol *);
990
991 /* A function to do additional symbol processing after reading the
992 entire ELF symbol table. */
993 bool (*elf_backend_symbol_table_processing)
994 (bfd *, elf_symbol_type *, unsigned int);
995
996 /* A function to set the type of the info field. Processor-specific
997 types should be handled here. */
998 int (*elf_backend_get_symbol_type)
999 (Elf_Internal_Sym *, int);
1000
1001 /* A function to return the linker hash table entry of a symbol that
1002 might be satisfied by an archive symbol. */
1003 struct bfd_link_hash_entry * (*elf_backend_archive_symbol_lookup)
1004 (bfd *, struct bfd_link_info *, const char *);
1005
1006 /* Return true if local section symbols should have a non-null st_name.
1007 NULL implies false. */
1008 bool (*elf_backend_name_local_section_symbols)
1009 (bfd *);
1010
1011 /* A function to do additional processing on the ELF section header
1012 just before writing it out. This is used to set the flags and
1013 type fields for some sections, or to actually write out data for
1014 unusual sections. */
1015 bool (*elf_backend_section_processing)
1016 (bfd *, Elf_Internal_Shdr *);
1017
1018 /* A function to handle unusual section types when creating BFD
1019 sections from ELF sections. */
1020 bool (*elf_backend_section_from_shdr)
1021 (bfd *, Elf_Internal_Shdr *, const char *, int);
1022
1023 /* A function to convert machine dependent ELF section header flags to
1024 BFD internal section header flags. */
1025 bool (*elf_backend_section_flags)
1026 (const Elf_Internal_Shdr *);
1027
1028 /* A function that returns a struct containing ELF section flags and
1029 type for the given BFD section. */
1030 const struct bfd_elf_special_section * (*get_sec_type_attr)
1031 (bfd *, asection *);
1032
1033 /* A function to handle unusual program segment types when creating BFD
1034 sections from ELF program segments. */
1035 bool (*elf_backend_section_from_phdr)
1036 (bfd *, Elf_Internal_Phdr *, int, const char *);
1037
1038 /* A function to set up the ELF section header for a BFD section in
1039 preparation for writing it out. This is where the flags and type
1040 fields are set for unusual sections. */
1041 bool (*elf_backend_fake_sections)
1042 (bfd *, Elf_Internal_Shdr *, asection *);
1043
1044 /* A function to get the ELF section index for a BFD section. If
1045 this returns TRUE, the section was found. If it is a normal ELF
1046 section, *RETVAL should be left unchanged. If it is not a normal
1047 ELF section *RETVAL should be set to the SHN_xxxx index. */
1048 bool (*elf_backend_section_from_bfd_section)
1049 (bfd *, asection *, int *retval);
1050
1051 /* If this field is not NULL, it is called by the add_symbols phase
1052 of a link just before adding a symbol to the global linker hash
1053 table. It may modify any of the fields as it wishes. If *NAME
1054 is set to NULL, the symbol will be skipped rather than being
1055 added to the hash table. This function is responsible for
1056 handling all processor dependent symbol bindings and section
1057 indices, and must set at least *FLAGS and *SEC for each processor
1058 dependent case; failure to do so will cause a link error. */
1059 bool (*elf_add_symbol_hook)
1060 (bfd *abfd, struct bfd_link_info *info, Elf_Internal_Sym *,
1061 const char **name, flagword *flags, asection **sec, bfd_vma *value);
1062
1063 /* If this field is not NULL, it is called by the elf_link_output_sym
1064 phase of a link for each symbol which will appear in the object file.
1065 On error, this function returns 0. 1 is returned when the symbol
1066 should be output, 2 is returned when the symbol should be discarded. */
1067 int (*elf_backend_link_output_symbol_hook)
1068 (struct bfd_link_info *info, const char *, Elf_Internal_Sym *,
1069 asection *, struct elf_link_hash_entry *);
1070
1071 /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
1072 linker the first time it encounters a dynamic object in the link.
1073 This function must create any sections required for dynamic
1074 linking. The ABFD argument is a dynamic object. The .interp,
1075 .dynamic, .dynsym, .dynstr, and .hash functions have already been
1076 created, and this function may modify the section flags if
1077 desired. This function will normally create the .got and .plt
1078 sections, but different backends have different requirements. */
1079 bool (*elf_backend_create_dynamic_sections)
1080 (bfd *abfd, struct bfd_link_info *info);
1081
1082 /* When creating a shared library, determine whether to omit the
1083 dynamic symbol for the section. */
1084 bool (*elf_backend_omit_section_dynsym)
1085 (bfd *output_bfd, struct bfd_link_info *info, asection *osec);
1086
1087 /* Return TRUE if relocations of targets are compatible to the extent
1088 that CHECK_RELOCS will properly process them. PR 4424. */
1089 bool (*relocs_compatible) (const bfd_target *, const bfd_target *);
1090
1091 /* The CHECK_RELOCS function is called after all input files have been
1092 opened. It is called once for each section with relocs of an object
1093 file. The function must look through the relocs and do any special
1094 handling required. This generally means allocating space in the
1095 global offset table, and perhaps allocating space for a reloc. The
1096 relocs are always passed as Rela structures; if the section
1097 actually uses Rel structures, the r_addend field will always be
1098 zero. */
1099 bool (*check_relocs)
1100 (bfd *abfd, struct bfd_link_info *info, asection *o,
1101 const Elf_Internal_Rela *relocs);
1102
1103 /* The CHECK_DIRECTIVES function is called once per input file by
1104 the add_symbols phase of the ELF backend linker. The function
1105 must inspect the bfd and create any additional symbols according
1106 to any custom directives in the bfd. */
1107 bool (*check_directives)
1108 (bfd *abfd, struct bfd_link_info *info);
1109
1110 /* The NOTICE_AS_NEEDED function is called as the linker is about to
1111 handle an as-needed lib (ACT = notice_as_needed), and after the
1112 linker has decided to keep the lib (ACT = notice_needed) or when
1113 the lib is not needed (ACT = notice_not_needed). */
1114 bool (*notice_as_needed)
1115 (bfd *abfd, struct bfd_link_info *info, enum notice_asneeded_action act);
1116
1117 /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
1118 linker for every symbol which is defined by a dynamic object and
1119 referenced by a regular object. This is called after all the
1120 input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
1121 function has been called. The hash table entry should be
1122 bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
1123 defined in a section from a dynamic object. Dynamic object
1124 sections are not included in the final link, and this function is
1125 responsible for changing the value to something which the rest of
1126 the link can deal with. This will normally involve adding an
1127 entry to the .plt or .got or some such section, and setting the
1128 symbol to point to that. */
1129 bool (*elf_backend_adjust_dynamic_symbol)
1130 (struct bfd_link_info *info, struct elf_link_hash_entry *h);
1131
1132 /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
1133 after all the linker input files have been seen but before the
1134 section sizes have been set. This is called after
1135 ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS. */
1136 bool (*elf_backend_always_size_sections)
1137 (bfd *output_bfd, struct bfd_link_info *info);
1138
1139 /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
1140 linker after all the linker input files have been seen but before
1141 the sections sizes have been set. This is called after
1142 ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
1143 It is only called when linking against a dynamic object. It must
1144 set the sizes of the dynamic sections, and may fill in their
1145 contents as well. The generic ELF linker can handle the .dynsym,
1146 .dynstr and .hash sections. This function must handle the
1147 .interp section and any sections created by the
1148 CREATE_DYNAMIC_SECTIONS entry point. */
1149 bool (*elf_backend_size_dynamic_sections)
1150 (bfd *output_bfd, struct bfd_link_info *info);
1151
1152 /* The STRIP_ZERO_SIZED_DYNAMIC_SECTIONS function is called by the
1153 ELF backend linker to strip zero-sized dynamic sections after
1154 the section sizes have been set. */
1155 bool (*elf_backend_strip_zero_sized_dynamic_sections)
1156 (struct bfd_link_info *info);
1157
1158 /* Set TEXT_INDEX_SECTION and DATA_INDEX_SECTION, the output sections
1159 we keep to use as a base for relocs and symbols. */
1160 void (*elf_backend_init_index_section)
1161 (bfd *output_bfd, struct bfd_link_info *info);
1162
1163 /* The RELOCATE_SECTION function is called by the ELF backend linker
1164 to handle the relocations for a section.
1165
1166 The relocs are always passed as Rela structures; if the section
1167 actually uses Rel structures, the r_addend field will always be
1168 zero.
1169
1170 This function is responsible for adjust the section contents as
1171 necessary, and (if using Rela relocs and generating a
1172 relocatable output file) adjusting the reloc addend as
1173 necessary.
1174
1175 This function does not have to worry about setting the reloc
1176 address or the reloc symbol index.
1177
1178 LOCAL_SYMS is a pointer to the swapped in local symbols.
1179
1180 LOCAL_SECTIONS is an array giving the section in the input file
1181 corresponding to the st_shndx field of each local symbol.
1182
1183 The global hash table entry for the global symbols can be found
1184 via elf_sym_hashes (input_bfd).
1185
1186 When generating relocatable output, this function must handle
1187 STB_LOCAL/STT_SECTION symbols specially. The output symbol is
1188 going to be the section symbol corresponding to the output
1189 section, which means that the addend must be adjusted
1190 accordingly.
1191
1192 Returns FALSE on error, TRUE on success, 2 if successful and
1193 relocations should be written for this section. */
1194 int (*elf_backend_relocate_section)
1195 (bfd *output_bfd, struct bfd_link_info *info, bfd *input_bfd,
1196 asection *input_section, bfd_byte *contents, Elf_Internal_Rela *relocs,
1197 Elf_Internal_Sym *local_syms, asection **local_sections);
1198
1199 /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
1200 linker just before it writes a symbol out to the .dynsym section.
1201 The processor backend may make any required adjustment to the
1202 symbol. It may also take the opportunity to set contents of the
1203 dynamic sections. Note that FINISH_DYNAMIC_SYMBOL is called on
1204 all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
1205 on those symbols which are defined by a dynamic object. */
1206 bool (*elf_backend_finish_dynamic_symbol)
1207 (bfd *output_bfd, struct bfd_link_info *info,
1208 struct elf_link_hash_entry *h, Elf_Internal_Sym *sym);
1209
1210 /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
1211 linker just before it writes all the dynamic sections out to the
1212 output file. The FINISH_DYNAMIC_SYMBOL will have been called on
1213 all dynamic symbols. */
1214 bool (*elf_backend_finish_dynamic_sections)
1215 (bfd *output_bfd, struct bfd_link_info *info);
1216
1217 /* A function to do any beginning processing needed for the ELF file
1218 before building the ELF headers and computing file positions. */
1219 void (*elf_backend_begin_write_processing)
1220 (bfd *, struct bfd_link_info *);
1221
1222 /* A function to do any final processing needed for the ELF file
1223 before writing it out. */
1224 bool (*elf_backend_final_write_processing)
1225 (bfd *);
1226
1227 /* This function is called by get_program_header_size. It should
1228 return the number of additional program segments which this BFD
1229 will need. It should return -1 on error. */
1230 int (*elf_backend_additional_program_headers)
1231 (bfd *, struct bfd_link_info *);
1232
1233 /* This function is called to modify an existing segment map in a
1234 backend specific fashion. */
1235 bool (*elf_backend_modify_segment_map)
1236 (bfd *, struct bfd_link_info *);
1237
1238 /* This function is called to modify program headers just before
1239 they are written. */
1240 bool (*elf_backend_modify_headers)
1241 (bfd *, struct bfd_link_info *);
1242
1243 /* This function is called to see if the PHDR header should be
1244 checked for validity. */
1245 bool (*elf_backend_allow_non_load_phdr)
1246 (bfd *, const Elf_Internal_Phdr *, unsigned);
1247
1248 /* This function is called before section garbage collection to
1249 mark entry symbol sections. */
1250 void (*gc_keep)
1251 (struct bfd_link_info *);
1252
1253 /* This function is called during section garbage collection to
1254 mark sections that define global symbols. */
1255 bool (*gc_mark_dynamic_ref)
1256 (struct elf_link_hash_entry *, void *);
1257
1258 /* This function is called during section gc to discover the section a
1259 particular relocation refers to. */
1260 elf_gc_mark_hook_fn gc_mark_hook;
1261
1262 /* This function, if defined, is called after the first gc marking pass
1263 to allow the backend to mark additional sections. */
1264 bool (*gc_mark_extra_sections)
1265 (struct bfd_link_info *, elf_gc_mark_hook_fn);
1266
1267 /* This function is called to initialise ELF file header info.
1268 Customised versions can modify things like the OS and ABI version. */
1269 bool (*elf_backend_init_file_header)
1270 (bfd *, struct bfd_link_info *);
1271
1272 /* This function, if defined, prints a symbol to file and returns the
1273 name of the symbol to be printed. It should return NULL to fall
1274 back to default symbol printing. */
1275 const char *(*elf_backend_print_symbol_all)
1276 (bfd *, void *, asymbol *);
1277
1278 /* This function, if defined, is called after all local symbols and
1279 global symbols converted to locals are emitted into the symtab
1280 section. It allows the backend to emit special local symbols
1281 not handled in the hash table. */
1282 bool (*elf_backend_output_arch_local_syms)
1283 (bfd *, struct bfd_link_info *, void *,
1284 int (*) (void *, const char *, Elf_Internal_Sym *, asection *,
1285 struct elf_link_hash_entry *));
1286
1287 /* This function, if defined, is called after all symbols are emitted
1288 into the symtab section. It allows the backend to emit special
1289 global symbols not handled in the hash table. */
1290 bool (*elf_backend_output_arch_syms)
1291 (bfd *, struct bfd_link_info *, void *,
1292 int (*) (void *, const char *, Elf_Internal_Sym *, asection *,
1293 struct elf_link_hash_entry *));
1294
1295 /* Filter what symbols of the output file to include in the import
1296 library if one is created. */
1297 unsigned int (*elf_backend_filter_implib_symbols)
1298 (bfd *, struct bfd_link_info *, asymbol **, long);
1299
1300 /* Copy any information related to dynamic linking from a pre-existing
1301 symbol to a newly created symbol. Also called to copy flags and
1302 other back-end info to a weakdef, in which case the symbol is not
1303 newly created and plt/got refcounts and dynamic indices should not
1304 be copied. */
1305 void (*elf_backend_copy_indirect_symbol)
1306 (struct bfd_link_info *, struct elf_link_hash_entry *,
1307 struct elf_link_hash_entry *);
1308
1309 /* Modify any information related to dynamic linking such that the
1310 symbol is not exported. */
1311 void (*elf_backend_hide_symbol)
1312 (struct bfd_link_info *, struct elf_link_hash_entry *, bool);
1313
1314 /* A function to do additional symbol fixup, called by
1315 _bfd_elf_fix_symbol_flags. */
1316 bool (*elf_backend_fixup_symbol)
1317 (struct bfd_link_info *, struct elf_link_hash_entry *);
1318
1319 /* Merge the backend specific symbol attribute. */
1320 void (*elf_backend_merge_symbol_attribute)
1321 (struct elf_link_hash_entry *, unsigned int, bool, bool);
1322
1323 /* This function, if defined, will return a string containing the
1324 name of a target-specific dynamic tag. */
1325 char *(*elf_backend_get_target_dtag)
1326 (bfd_vma);
1327
1328 /* Decide whether an undefined symbol is special and can be ignored.
1329 This is the case for OPTIONAL symbols on IRIX. */
1330 bool (*elf_backend_ignore_undef_symbol)
1331 (struct elf_link_hash_entry *);
1332
1333 /* Emit relocations. Overrides default routine for emitting relocs,
1334 except during a relocatable link, or if all relocs are being emitted. */
1335 bool (*elf_backend_emit_relocs)
1336 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *,
1337 struct elf_link_hash_entry **);
1338
1339 /* Update relocations. It is allowed to change the number and the order.
1340 In such a case hashes should be invalidated. */
1341 void (*elf_backend_update_relocs)
1342 (asection *, struct bfd_elf_section_reloc_data *);
1343
1344 /* Count relocations. Not called for relocatable links
1345 or if all relocs are being preserved in the output. */
1346 unsigned int (*elf_backend_count_relocs)
1347 (struct bfd_link_info *, asection *);
1348
1349 /* Count additionals relocations. Called for relocatable links if
1350 additional relocations needs to be created. */
1351 unsigned int (*elf_backend_count_additional_relocs)
1352 (asection *);
1353
1354 /* Say whether to sort relocs output by ld -r and ld --emit-relocs,
1355 by r_offset. If NULL, default to true. */
1356 bool (*sort_relocs_p)
1357 (asection *);
1358
1359 /* This function, if defined, is called when an NT_PRSTATUS note is found
1360 in a core file. */
1361 bool (*elf_backend_grok_prstatus)
1362 (bfd *, Elf_Internal_Note *);
1363
1364 /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
1365 note is found in a core file. */
1366 bool (*elf_backend_grok_psinfo)
1367 (bfd *, Elf_Internal_Note *);
1368
1369 /* This function, if defined, is called when a "FreeBSD" NT_PRSTATUS
1370 note is found in a core file. */
1371 bool (*elf_backend_grok_freebsd_prstatus)
1372 (bfd *, Elf_Internal_Note *);
1373
1374 /* This function, if defined, is called to write a note to a corefile. */
1375 char *(*elf_backend_write_core_note)
1376 (bfd *abfd, char *buf, int *bufsiz, int note_type, ...);
1377
1378 /* This function, if defined, is called to convert target-specific
1379 section flag names into hex values. */
1380 flagword (*elf_backend_lookup_section_flags_hook)
1381 (char *);
1382
1383 /* This function returns class of a reloc type. */
1384 enum elf_reloc_type_class (*elf_backend_reloc_type_class)
1385 (const struct bfd_link_info *, const asection *, const Elf_Internal_Rela *);
1386
1387 /* This function, if defined, removes information about discarded functions
1388 from other sections which mention them. */
1389 bool (*elf_backend_discard_info)
1390 (bfd *, struct elf_reloc_cookie *, struct bfd_link_info *);
1391
1392 /* This function, if defined, signals that the function above has removed
1393 the discarded relocations for this section. */
1394 bool (*elf_backend_ignore_discarded_relocs)
1395 (asection *);
1396
1397 /* What to do when ld finds relocations against symbols defined in
1398 discarded sections. */
1399 unsigned int (*action_discarded)
1400 (asection *);
1401
1402 /* This function returns the width of FDE pointers in bytes, or 0 if
1403 that can't be determined for some reason. The default definition
1404 goes by the bfd's EI_CLASS. */
1405 unsigned int (*elf_backend_eh_frame_address_size)
1406 (bfd *, const asection *);
1407
1408 /* These functions tell elf-eh-frame whether to attempt to turn
1409 absolute or lsda encodings into pc-relative ones. The default
1410 definition enables these transformations. */
1411 bool (*elf_backend_can_make_relative_eh_frame)
1412 (bfd *, struct bfd_link_info *, asection *);
1413 bool (*elf_backend_can_make_lsda_relative_eh_frame)
1414 (bfd *, struct bfd_link_info *, asection *);
1415
1416 /* This function returns an encoding after computing the encoded
1417 value (and storing it in ENCODED) for the given OFFSET into OSEC,
1418 to be stored in at LOC_OFFSET into the LOC_SEC input section.
1419 The default definition chooses a 32-bit PC-relative encoding. */
1420 bfd_byte (*elf_backend_encode_eh_address)
1421 (bfd *abfd, struct bfd_link_info *info,
1422 asection *osec, bfd_vma offset,
1423 asection *loc_sec, bfd_vma loc_offset,
1424 bfd_vma *encoded);
1425
1426 /* This function, if defined, may write out the given section.
1427 Returns TRUE if it did so and FALSE if the caller should. */
1428 bool (*elf_backend_write_section)
1429 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
1430
1431 /* This function, if defined, returns TRUE if it is section symbols
1432 only that are considered local for the purpose of partitioning the
1433 symbol table into local and global symbols. This should be NULL
1434 for most targets, in which case the correct thing will be done.
1435 MIPS ELF, at least on the Irix 5, has special requirements. */
1436 bool (*elf_backend_elfsym_local_is_section)
1437 (bfd *);
1438
1439 /* The level of IRIX compatibility we're striving for.
1440 MIPS ELF specific function. */
1441 irix_compat_t (*elf_backend_mips_irix_compat)
1442 (bfd *);
1443
1444 reloc_howto_type *(*elf_backend_mips_rtype_to_howto)
1445 (bfd *, unsigned int, bool);
1446
1447 /* The swapping table to use when dealing with ECOFF information.
1448 Used for the MIPS ELF .mdebug section. */
1449 const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
1450
1451 /* This function implements `bfd_elf_bfd_from_remote_memory';
1452 see elf.c, elfcode.h. */
1453 bfd *(*elf_backend_bfd_from_remote_memory)
1454 (bfd *templ, bfd_vma ehdr_vma, bfd_size_type size, bfd_vma *loadbasep,
1455 int (*target_read_memory) (bfd_vma vma, bfd_byte *myaddr,
1456 bfd_size_type len));
1457
1458 bool (*elf_backend_core_find_build_id) (bfd *, bfd_vma);
1459
1460 /* This function is used by `_bfd_elf_get_synthetic_symtab';
1461 see elf.c. */
1462 bfd_vma (*plt_sym_val) (bfd_vma, const asection *, const arelent *);
1463
1464 /* Is symbol defined in common section? */
1465 bool (*common_definition) (Elf_Internal_Sym *);
1466
1467 /* Return a common section index for section. */
1468 unsigned int (*common_section_index) (asection *);
1469
1470 /* Return a common section for section. */
1471 asection *(*common_section) (asection *);
1472
1473 /* Return TRUE if we can merge 2 definitions. */
1474 bool (*merge_symbol) (struct elf_link_hash_entry *,
1475 const Elf_Internal_Sym *, asection **,
1476 bool, bool,
1477 bfd *, const asection *);
1478
1479 /* Return TRUE if symbol should be hashed in the `.gnu.hash' section. */
1480 bool (*elf_hash_symbol) (struct elf_link_hash_entry *);
1481
1482 /* If non-NULL, called to register the location of XLAT_LOC within
1483 .MIPS.xhash at which real final dynindx for H will be written.
1484 If XLAT_LOC is zero, the symbol is not included in
1485 .MIPS.xhash and no dynindx will be written. */
1486 void (*record_xhash_symbol)
1487 (struct elf_link_hash_entry *h, bfd_vma xlat_loc);
1488
1489 /* Return TRUE if type is a function symbol type. */
1490 bool (*is_function_type) (unsigned int type);
1491
1492 /* If the ELF symbol SYM might be a function in SEC, return the
1493 function size and set *CODE_OFF to the function's entry point,
1494 otherwise return zero. */
1495 bfd_size_type (*maybe_function_sym) (const asymbol *sym, asection *sec,
1496 bfd_vma *code_off);
1497
1498 /* Given NAME, the name of a relocation section stripped of its
1499 .rel/.rela prefix, return the section in ABFD to which the
1500 relocations apply. */
1501 asection *(*get_reloc_section) (bfd *abfd, const char *name);
1502
1503 /* Called to set the sh_flags, sh_link and sh_info fields of OSECTION which
1504 has a type >= SHT_LOOS. Returns TRUE if the fields were initialised,
1505 FALSE otherwise. Can be called multiple times for a given section,
1506 until it returns TRUE. Most of the times it is called ISECTION will be
1507 set to an input section that might be associated with the output section.
1508 The last time that it is called, ISECTION will be set to NULL. */
1509 bool (*elf_backend_copy_special_section_fields)
1510 (const bfd *ibfd, bfd *obfd, const Elf_Internal_Shdr *isection,
1511 Elf_Internal_Shdr *osection);
1512
1513 /* Used to handle bad SHF_LINK_ORDER input. */
1514 void (*link_order_error_handler) (const char *, ...);
1515
1516 /* Name of the PLT relocation section. */
1517 const char *relplt_name;
1518
1519 /* Alternate EM_xxxx machine codes for this backend. */
1520 int elf_machine_alt1;
1521 int elf_machine_alt2;
1522
1523 const struct elf_size_info *s;
1524
1525 /* An array of target specific special sections. */
1526 const struct bfd_elf_special_section *special_sections;
1527
1528 /* The size in bytes of the header for the GOT. This includes the
1529 so-called reserved entries on some systems. */
1530 bfd_vma got_header_size;
1531
1532 /* The size of the GOT entry for the symbol pointed to by H if non-NULL,
1533 otherwise by the local symbol with index SYMNDX in IBFD. */
1534 bfd_vma (*got_elt_size) (bfd *, struct bfd_link_info *,
1535 struct elf_link_hash_entry *h,
1536 bfd *ibfd, unsigned long symndx);
1537
1538 /* The vendor name to use for a processor-standard attributes section. */
1539 const char *obj_attrs_vendor;
1540
1541 /* The section name to use for a processor-standard attributes section. */
1542 const char *obj_attrs_section;
1543
1544 /* Return 1, 2 or 3 to indicate what type of arguments a
1545 processor-specific tag takes. */
1546 int (*obj_attrs_arg_type) (int);
1547
1548 /* The section type to use for an attributes section. */
1549 unsigned int obj_attrs_section_type;
1550
1551 /* This function determines the order in which any attributes are
1552 written. It must be defined for input in the range
1553 LEAST_KNOWN_OBJ_ATTRIBUTE..NUM_KNOWN_OBJ_ATTRIBUTES-1 (this range
1554 is used in order to make unity easy). The returned value is the
1555 actual tag number to place in the input position. */
1556 int (*obj_attrs_order) (int);
1557
1558 /* Handle merging unknown attributes; either warn and return TRUE,
1559 or give an error and return FALSE. */
1560 bool (*obj_attrs_handle_unknown) (bfd *, int);
1561
1562 /* Parse GNU properties. Return the property kind. If the property
1563 is corrupt, issue an error message and return property_corrupt. */
1564 enum elf_property_kind (*parse_gnu_properties) (bfd *, unsigned int,
1565 bfd_byte *,
1566 unsigned int);
1567
1568 /* Merge GNU properties. Return TRUE if property is updated. */
1569 bool (*merge_gnu_properties) (struct bfd_link_info *, bfd *, bfd *,
1570 elf_property *, elf_property *);
1571
1572 /* Set up GNU properties. */
1573 bfd *(*setup_gnu_properties) (struct bfd_link_info *);
1574
1575 /* Fix up GNU properties. */
1576 void (*fixup_gnu_properties) (struct bfd_link_info *,
1577 elf_property_list **);
1578
1579 /* Encoding used for compact EH tables. */
1580 int (*compact_eh_encoding) (struct bfd_link_info *);
1581
1582 /* Opcode representing no unwind. */
1583 int (*cant_unwind_opcode) (struct bfd_link_info *);
1584
1585 /* Called when emitting an ELF symbol whoes input version had an
1586 ST_SHNDX field set to a value in the range SHN_LOPROC..SHN_HIOS.
1587 Returns the value to be installed in the ST_SHNDX field of the
1588 emitted symbol. If not defined, the value is left unchanged. */
1589 unsigned int (*symbol_section_index) (bfd *, elf_symbol_type *);
1590
1591 /* Called when a section has extra reloc sections. */
1592 bool (*init_secondary_reloc_section) (bfd *, Elf_Internal_Shdr *,
1593 const char *, unsigned int);
1594
1595 /* Called when after loading the normal relocs for a section. */
1596 bool (*slurp_secondary_relocs) (bfd *, asection *, asymbol **, bool);
1597
1598 /* Called after writing the normal relocs for a section. */
1599 bool (*write_secondary_relocs) (bfd *, asection *);
1600
1601 /* This is non-zero if static TLS segments require a special alignment. */
1602 unsigned static_tls_alignment;
1603
1604 /* Alignment for the PT_GNU_STACK segment. */
1605 unsigned stack_align;
1606
1607 /* Flag bits to assign to a section of type SHT_STRTAB. */
1608 unsigned long elf_strtab_flags;
1609
1610 /* This is TRUE if the linker should act like collect and gather
1611 global constructors and destructors by name. This is TRUE for
1612 MIPS ELF because the Irix 5 tools can not handle the .init
1613 section. */
1614 unsigned collect : 1;
1615
1616 /* This is TRUE if the linker should ignore changes to the type of a
1617 symbol. This is TRUE for MIPS ELF because some Irix 5 objects
1618 record undefined functions as STT_OBJECT although the definitions
1619 are STT_FUNC. */
1620 unsigned type_change_ok : 1;
1621
1622 /* Whether the backend may use REL relocations. (Some backends use
1623 both REL and RELA relocations, and this flag is set for those
1624 backends.) */
1625 unsigned may_use_rel_p : 1;
1626
1627 /* Whether the backend may use RELA relocations. (Some backends use
1628 both REL and RELA relocations, and this flag is set for those
1629 backends.) */
1630 unsigned may_use_rela_p : 1;
1631
1632 /* Whether the default relocation type is RELA. If a backend with
1633 this flag set wants REL relocations for a particular section,
1634 it must note that explicitly. Similarly, if this flag is clear,
1635 and the backend wants RELA relocations for a particular
1636 section. */
1637 unsigned default_use_rela_p : 1;
1638
1639 /* True if PLT and copy relocations should be RELA by default. */
1640 unsigned rela_plts_and_copies_p : 1;
1641
1642 /* Set if RELA relocations for a relocatable link can be handled by
1643 generic code. Backends that set this flag need do nothing in the
1644 backend relocate_section routine for relocatable linking. */
1645 unsigned rela_normal : 1;
1646
1647 /* Set if DT_REL/DT_RELA/DT_RELSZ/DT_RELASZ should not include PLT
1648 relocations. */
1649 unsigned dtrel_excludes_plt : 1;
1650
1651 /* TRUE if addresses "naturally" sign extend. This is used when
1652 swapping in from Elf32 when BFD64. */
1653 unsigned sign_extend_vma : 1;
1654
1655 unsigned want_got_plt : 1;
1656 unsigned plt_readonly : 1;
1657 unsigned want_plt_sym : 1;
1658 unsigned plt_not_loaded : 1;
1659 unsigned plt_alignment : 4;
1660 unsigned can_gc_sections : 1;
1661 unsigned can_refcount : 1;
1662 unsigned want_got_sym : 1;
1663 unsigned want_dynbss : 1;
1664 unsigned want_dynrelro : 1;
1665
1666 /* Targets which do not support physical addressing often require
1667 that the p_paddr field in the section header to be set to zero.
1668 This field indicates whether this behavior is required. */
1669 unsigned want_p_paddr_set_to_zero : 1;
1670
1671 /* Target has broken hardware and/or kernel that requires pages not
1672 to be mapped twice with different permissions. */
1673 unsigned no_page_alias : 1;
1674
1675 /* True if an object file lacking a .note.GNU-stack section
1676 should be assumed to be requesting exec stack. At least one
1677 other file in the link needs to have a .note.GNU-stack section
1678 for a PT_GNU_STACK segment to be created. */
1679 unsigned default_execstack : 1;
1680
1681 /* True if elf_section_data(sec)->this_hdr.contents is sec->rawsize
1682 in length rather than sec->size in length, if sec->rawsize is
1683 non-zero and smaller than sec->size. */
1684 unsigned caches_rawsize : 1;
1685
1686 /* Address of protected data defined in the shared library may be
1687 external, i.e., due to copy relocation. */
1688 unsigned extern_protected_data : 1;
1689
1690 /* True if `_bfd_elf_link_renumber_dynsyms' must be called even for
1691 static binaries. */
1692 unsigned always_renumber_dynsyms : 1;
1693
1694 /* True if the 32-bit Linux PRPSINFO structure's `pr_uid' and `pr_gid'
1695 members use a 16-bit data type. */
1696 unsigned linux_prpsinfo32_ugid16 : 1;
1697
1698 /* True if the 64-bit Linux PRPSINFO structure's `pr_uid' and `pr_gid'
1699 members use a 16-bit data type. */
1700 unsigned linux_prpsinfo64_ugid16 : 1;
1701 };
1702
1703 /* Information about reloc sections associated with a bfd_elf_section_data
1704 structure. */
1705 struct bfd_elf_section_reloc_data
1706 {
1707 /* The ELF header for the reloc section associated with this
1708 section, if any. */
1709 Elf_Internal_Shdr *hdr;
1710 /* The number of relocations currently assigned to HDR. */
1711 unsigned int count;
1712 /* The ELF section number of the reloc section. Only used for an
1713 output file. */
1714 int idx;
1715 /* Used by the backend linker to store the symbol hash table entries
1716 associated with relocs against global symbols. */
1717 struct elf_link_hash_entry **hashes;
1718 };
1719
1720 /* Information stored for each BFD section in an ELF file. This
1721 structure is allocated by elf_new_section_hook. */
1722
1723 struct bfd_elf_section_data
1724 {
1725 /* The ELF header for this section. */
1726 Elf_Internal_Shdr this_hdr;
1727
1728 /* INPUT_SECTION_FLAGS if specified in the linker script. */
1729 struct flag_info *section_flag_info;
1730
1731 /* Information about the REL and RELA reloc sections associated
1732 with this section, if any. */
1733 struct bfd_elf_section_reloc_data rel, rela;
1734
1735 /* The ELF section number of this section. */
1736 int this_idx;
1737
1738 /* Used by the backend linker when generating a shared library to
1739 record the dynamic symbol index for a section symbol
1740 corresponding to this section. A value of 0 means that there is
1741 no dynamic symbol for this section. */
1742 int dynindx;
1743
1744 /* A pointer to the linked-to section for SHF_LINK_ORDER. */
1745 asection *linked_to;
1746
1747 /* A pointer to the swapped relocs. If the section uses REL relocs,
1748 rather than RELA, all the r_addend fields will be zero. This
1749 pointer may be NULL. It is used by the backend linker. */
1750 Elf_Internal_Rela *relocs;
1751
1752 /* A pointer to a linked list tracking dynamic relocs copied for
1753 local symbols. */
1754 void *local_dynrel;
1755
1756 /* A pointer to the bfd section used for dynamic relocs. */
1757 asection *sreloc;
1758
1759 union {
1760 /* Group name, if this section is a member of a group. */
1761 const char *name;
1762
1763 /* Group signature sym, if this is the SHT_GROUP section. */
1764 struct bfd_symbol *id;
1765 } group;
1766
1767 /* For a member of a group, points to the SHT_GROUP section.
1768 NULL for the SHT_GROUP section itself and non-group sections. */
1769 asection *sec_group;
1770
1771 /* A linked list of member sections in the group. Circular when used by
1772 the linker. For the SHT_GROUP section, points at first member. */
1773 asection *next_in_group;
1774
1775 /* The FDEs associated with this section. The u.fde.next_in_section
1776 field acts as a chain pointer. */
1777 struct eh_cie_fde *fde_list;
1778
1779 /* Link from a text section to its .eh_frame_entry section. */
1780 asection *eh_frame_entry;
1781
1782 /* TRUE if the section has secondary reloc sections associated with it.
1783 FIXME: In the future it might be better to change this into a list
1784 of secondary reloc sections, making lookup easier and faster. */
1785 bool has_secondary_relocs;
1786
1787 /* A pointer used for various section optimizations. */
1788 void *sec_info;
1789 };
1790
1791 #define elf_section_data(sec) ((struct bfd_elf_section_data*)(sec)->used_by_bfd)
1792 #define elf_linked_to_section(sec) (elf_section_data(sec)->linked_to)
1793 #define elf_section_type(sec) (elf_section_data(sec)->this_hdr.sh_type)
1794 #define elf_section_flags(sec) (elf_section_data(sec)->this_hdr.sh_flags)
1795 #define elf_section_info(sec) (elf_section_data(sec)->this_hdr.sh_info)
1796 #define elf_group_name(sec) (elf_section_data(sec)->group.name)
1797 #define elf_group_id(sec) (elf_section_data(sec)->group.id)
1798 #define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group)
1799 #define elf_fde_list(sec) (elf_section_data(sec)->fde_list)
1800 #define elf_sec_group(sec) (elf_section_data(sec)->sec_group)
1801 #define elf_section_eh_frame_entry(sec) (elf_section_data(sec)->eh_frame_entry)
1802
1803 #define xvec_get_elf_backend_data(xvec) \
1804 ((const struct elf_backend_data *) (xvec)->backend_data)
1805
1806 #define get_elf_backend_data(abfd) \
1807 xvec_get_elf_backend_data ((abfd)->xvec)
1808
1809 /* The least object attributes (within an attributes subsection) known
1810 for any target. Some code assumes that the value 0 is not used and
1811 the field for that attribute can instead be used as a marker to
1812 indicate that attributes have been initialized. */
1813 #define LEAST_KNOWN_OBJ_ATTRIBUTE 2
1814
1815 /* The maximum number of known object attributes for any target. */
1816 #define NUM_KNOWN_OBJ_ATTRIBUTES 77
1817
1818 /* The value of an object attribute. The type indicates whether the attribute
1819 holds and integer, a string, or both. It can also indicate that there can
1820 be no default (i.e. all values must be written to file, even zero), or
1821 that the value is in error and should not be written to file. */
1822
1823 typedef struct obj_attribute
1824 {
1825 #define ATTR_TYPE_FLAG_INT_VAL (1 << 0)
1826 #define ATTR_TYPE_FLAG_STR_VAL (1 << 1)
1827 #define ATTR_TYPE_FLAG_NO_DEFAULT (1 << 2)
1828 #define ATTR_TYPE_FLAG_ERROR (1 << 3)
1829
1830 #define ATTR_TYPE_HAS_INT_VAL(TYPE) ((TYPE) & ATTR_TYPE_FLAG_INT_VAL)
1831 #define ATTR_TYPE_HAS_STR_VAL(TYPE) ((TYPE) & ATTR_TYPE_FLAG_STR_VAL)
1832 #define ATTR_TYPE_HAS_NO_DEFAULT(TYPE) ((TYPE) & ATTR_TYPE_FLAG_NO_DEFAULT)
1833 #define ATTR_TYPE_HAS_ERROR(TYPE) ((TYPE) & ATTR_TYPE_FLAG_ERROR)
1834
1835 int type;
1836 unsigned int i;
1837 char *s;
1838 } obj_attribute;
1839
1840 typedef struct obj_attribute_list
1841 {
1842 struct obj_attribute_list *next;
1843 unsigned int tag;
1844 obj_attribute attr;
1845 } obj_attribute_list;
1846
1847 /* Object attributes may either be defined by the processor ABI, index
1848 OBJ_ATTR_PROC in the *_obj_attributes arrays, or be GNU-specific
1849 (and possibly also processor-specific), index OBJ_ATTR_GNU. */
1850 #define OBJ_ATTR_PROC 0
1851 #define OBJ_ATTR_GNU 1
1852 #define OBJ_ATTR_FIRST OBJ_ATTR_PROC
1853 #define OBJ_ATTR_LAST OBJ_ATTR_GNU
1854
1855 /* The following object attribute tags are taken as generic, for all
1856 targets and for "gnu" where there is no target standard. */
1857 enum
1858 {
1859 Tag_NULL = 0,
1860 Tag_File = 1,
1861 Tag_Section = 2,
1862 Tag_Symbol = 3,
1863 Tag_compatibility = 32
1864 };
1865
1866 /* The following struct stores information about every SystemTap section
1867 found in the object file. */
1868 struct sdt_note
1869 {
1870 struct sdt_note *next;
1871 bfd_size_type size;
1872 bfd_byte data[1];
1873 };
1874
1875 /* tdata information grabbed from an elf core file. */
1876 struct core_elf_obj_tdata
1877 {
1878 int signal;
1879 int pid;
1880 int lwpid;
1881 char* program;
1882 char* command;
1883 };
1884
1885 /* Extra tdata information held for output ELF BFDs. */
1886 struct output_elf_obj_tdata
1887 {
1888 struct elf_segment_map *seg_map;
1889 struct elf_strtab_hash *strtab_ptr;
1890
1891 /* STT_SECTION symbols for each section */
1892 asymbol **section_syms;
1893
1894 /* Used to determine if PT_GNU_EH_FRAME segment header should be
1895 created. */
1896 asection *eh_frame_hdr;
1897
1898 /* NT_GNU_BUILD_ID note type info. */
1899 struct
1900 {
1901 bool (*after_write_object_contents) (bfd *);
1902 const char *style;
1903 asection *sec;
1904 } build_id;
1905
1906 /* Records the result of `get_program_header_size'. */
1907 bfd_size_type program_header_size;
1908
1909 /* Used when laying out sections. */
1910 file_ptr next_file_pos;
1911
1912 /* Linker information. */
1913 struct bfd_link_info *link_info;
1914
1915 unsigned int num_section_syms;
1916 unsigned int shstrtab_section, strtab_section;
1917
1918 /* Segment flags for the PT_GNU_STACK segment. */
1919 unsigned int stack_flags;
1920
1921 /* Used to determine if the e_flags field has been initialized */
1922 bool flags_init;
1923 };
1924
1925 /* Indicate if the bfd contains SHF_GNU_MBIND/SHF_GNU_RETAIN sections or
1926 symbols that have the STT_GNU_IFUNC symbol type or STB_GNU_UNIQUE
1927 binding. Used to set the osabi field in the ELF header structure. */
1928 enum elf_gnu_osabi
1929 {
1930 elf_gnu_osabi_mbind = 1 << 0,
1931 elf_gnu_osabi_ifunc = 1 << 1,
1932 elf_gnu_osabi_unique = 1 << 2,
1933 elf_gnu_osabi_retain = 1 << 3,
1934 };
1935
1936 typedef struct elf_section_list
1937 {
1938 Elf_Internal_Shdr hdr;
1939 unsigned int ndx;
1940 struct elf_section_list * next;
1941 } elf_section_list;
1942
1943 enum dynamic_lib_link_class {
1944 DYN_NORMAL = 0,
1945 DYN_AS_NEEDED = 1,
1946 DYN_DT_NEEDED = 2,
1947 DYN_NO_ADD_NEEDED = 4,
1948 DYN_NO_NEEDED = 8
1949 };
1950
1951 /* Some private data is stashed away for future use using the tdata pointer
1952 in the bfd structure. */
1953
1954 struct elf_obj_tdata
1955 {
1956 Elf_Internal_Ehdr elf_header[1]; /* Actual data, but ref like ptr */
1957 Elf_Internal_Shdr **elf_sect_ptr;
1958 Elf_Internal_Phdr *phdr;
1959 Elf_Internal_Shdr symtab_hdr;
1960 Elf_Internal_Shdr shstrtab_hdr;
1961 Elf_Internal_Shdr strtab_hdr;
1962 Elf_Internal_Shdr dynsymtab_hdr;
1963 Elf_Internal_Shdr dynstrtab_hdr;
1964 Elf_Internal_Shdr dynversym_hdr;
1965 Elf_Internal_Shdr dynverref_hdr;
1966 Elf_Internal_Shdr dynverdef_hdr;
1967 elf_section_list * symtab_shndx_list;
1968 bfd_vma gp; /* The gp value */
1969 unsigned int gp_size; /* The gp size */
1970 unsigned int num_elf_sections; /* elf_sect_ptr size */
1971 unsigned char *being_created;
1972
1973 /* A mapping from external symbols to entries in the linker hash
1974 table, used when linking. This is indexed by the symbol index
1975 minus the sh_info field of the symbol table header. */
1976 struct elf_link_hash_entry **sym_hashes;
1977
1978 /* Track usage and final offsets of GOT entries for local symbols.
1979 This array is indexed by symbol index. Elements are used
1980 identically to "got" in struct elf_link_hash_entry. */
1981 union
1982 {
1983 bfd_signed_vma *refcounts;
1984 bfd_vma *offsets;
1985 struct got_entry **ents;
1986 } local_got;
1987
1988 /* The linker ELF emulation code needs to let the backend ELF linker
1989 know what filename should be used for a dynamic object if the
1990 dynamic object is found using a search. The emulation code then
1991 sometimes needs to know what name was actually used. Until the
1992 file has been added to the linker symbol table, this field holds
1993 the name the linker wants. After it has been added, it holds the
1994 name actually used, which will be the DT_SONAME entry if there is
1995 one. */
1996 const char *dt_name;
1997
1998 /* The linker emulation needs to know what audit libs
1999 are used by a dynamic object. */
2000 const char *dt_audit;
2001
2002 /* Used by find_nearest_line entry point. */
2003 void *line_info;
2004
2005 /* A place to stash dwarf1 info for this bfd. */
2006 struct dwarf1_debug *dwarf1_find_line_info;
2007
2008 /* A place to stash dwarf2 info for this bfd. */
2009 void *dwarf2_find_line_info;
2010
2011 /* Stash away info for yet another find line/function variant. */
2012 void *elf_find_function_cache;
2013
2014 /* Number of symbol version definitions we are about to emit. */
2015 unsigned int cverdefs;
2016
2017 /* Number of symbol version references we are about to emit. */
2018 unsigned int cverrefs;
2019
2020 /* Symbol version definitions in external objects. */
2021 Elf_Internal_Verdef *verdef;
2022
2023 /* Symbol version references to external objects. */
2024 Elf_Internal_Verneed *verref;
2025
2026 /* A pointer to the .eh_frame section. */
2027 asection *eh_frame_section;
2028
2029 /* Symbol buffer. */
2030 void *symbuf;
2031
2032 /* List of GNU properties. Will be updated by setup_gnu_properties
2033 after all input GNU properties are merged for output. */
2034 elf_property_list *properties;
2035
2036 obj_attribute known_obj_attributes[2][NUM_KNOWN_OBJ_ATTRIBUTES];
2037 obj_attribute_list *other_obj_attributes[2];
2038
2039 /* Linked-list containing information about every Systemtap section
2040 found in the object file. Each section corresponds to one entry
2041 in the list. */
2042 struct sdt_note *sdt_note_head;
2043
2044 Elf_Internal_Shdr **group_sect_ptr;
2045 unsigned int num_group;
2046
2047 /* Index into group_sect_ptr, updated by setup_group when finding a
2048 section's group. Used to optimize subsequent group searches. */
2049 unsigned int group_search_offset;
2050
2051 unsigned int symtab_section, dynsymtab_section;
2052 unsigned int dynversym_section, dynverdef_section, dynverref_section;
2053
2054 /* An identifier used to distinguish different target
2055 specific extensions to this structure. */
2056 ENUM_BITFIELD (elf_target_id) object_id : 6;
2057
2058 /* Whether a dyanmic object was specified normally on the linker
2059 command line, or was specified when --as-needed was in effect,
2060 or was found via a DT_NEEDED entry. */
2061 ENUM_BITFIELD (dynamic_lib_link_class) dyn_lib_class : 4;
2062
2063 /* Whether the bfd uses OS specific bits that require ELFOSABI_GNU. */
2064 ENUM_BITFIELD (elf_gnu_osabi) has_gnu_osabi : 4;
2065
2066 /* Whether if the bfd contains the GNU_PROPERTY_NO_COPY_ON_PROTECTED
2067 property. */
2068 unsigned int has_no_copy_on_protected : 1;
2069
2070 /* Whether if the bfd contains the
2071 GNU_PROPERTY_1_NEEDED_INDIRECT_EXTERN_ACCESS property. */
2072 unsigned int has_indirect_extern_access : 1;
2073
2074 /* Irix 5 often screws up the symbol table, sorting local symbols
2075 after global symbols. This flag is set if the symbol table in
2076 this BFD appears to be screwed up. If it is, we ignore the
2077 sh_info field in the symbol table header, and always read all the
2078 symbols. */
2079 unsigned int bad_symtab : 1;
2080
2081 /* Set if DT_FLAGS_1 has DF_1_PIE set. */
2082 unsigned int is_pie : 1;
2083
2084 /* Information grabbed from an elf core file. */
2085 struct core_elf_obj_tdata *core;
2086
2087 /* More information held for output ELF BFDs. */
2088 struct output_elf_obj_tdata *o;
2089 };
2090
2091 #define elf_tdata(bfd) ((bfd) -> tdata.elf_obj_data)
2092
2093 #define elf_object_id(bfd) (elf_tdata(bfd) -> object_id)
2094 #define elf_program_header_size(bfd) (elf_tdata(bfd) -> o->program_header_size)
2095 #define elf_elfheader(bfd) (elf_tdata(bfd) -> elf_header)
2096 #define elf_elfsections(bfd) (elf_tdata(bfd) -> elf_sect_ptr)
2097 #define elf_numsections(bfd) (elf_tdata(bfd) -> num_elf_sections)
2098 #define elf_seg_map(bfd) (elf_tdata(bfd) -> o->seg_map)
2099 #define elf_link_info(bfd) (elf_tdata(bfd) -> o->link_info)
2100 #define elf_next_file_pos(bfd) (elf_tdata(bfd) -> o->next_file_pos)
2101 #define elf_eh_frame_hdr(bfd) (elf_tdata(bfd) -> o->eh_frame_hdr)
2102 #define elf_stack_flags(bfd) (elf_tdata(bfd) -> o->stack_flags)
2103 #define elf_shstrtab(bfd) (elf_tdata(bfd) -> o->strtab_ptr)
2104 #define elf_onesymtab(bfd) (elf_tdata(bfd) -> symtab_section)
2105 #define elf_symtab_shndx_list(bfd) (elf_tdata(bfd) -> symtab_shndx_list)
2106 #define elf_strtab_sec(bfd) (elf_tdata(bfd) -> o->strtab_section)
2107 #define elf_shstrtab_sec(bfd) (elf_tdata(bfd) -> o->shstrtab_section)
2108 #define elf_symtab_hdr(bfd) (elf_tdata(bfd) -> symtab_hdr)
2109 #define elf_dynsymtab(bfd) (elf_tdata(bfd) -> dynsymtab_section)
2110 #define elf_dynversym(bfd) (elf_tdata(bfd) -> dynversym_section)
2111 #define elf_dynverdef(bfd) (elf_tdata(bfd) -> dynverdef_section)
2112 #define elf_dynverref(bfd) (elf_tdata(bfd) -> dynverref_section)
2113 #define elf_eh_frame_section(bfd) \
2114 (elf_tdata(bfd) -> eh_frame_section)
2115 #define elf_section_syms(bfd) (elf_tdata(bfd) -> o->section_syms)
2116 #define elf_num_section_syms(bfd) (elf_tdata(bfd) -> o->num_section_syms)
2117 #define core_prpsinfo(bfd) (elf_tdata(bfd) -> prpsinfo)
2118 #define core_prstatus(bfd) (elf_tdata(bfd) -> prstatus)
2119 #define elf_gp(bfd) (elf_tdata(bfd) -> gp)
2120 #define elf_gp_size(bfd) (elf_tdata(bfd) -> gp_size)
2121 #define elf_sym_hashes(bfd) (elf_tdata(bfd) -> sym_hashes)
2122 #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
2123 #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
2124 #define elf_local_got_ents(bfd) (elf_tdata(bfd) -> local_got.ents)
2125 #define elf_dt_name(bfd) (elf_tdata(bfd) -> dt_name)
2126 #define elf_dt_audit(bfd) (elf_tdata(bfd) -> dt_audit)
2127 #define elf_dyn_lib_class(bfd) (elf_tdata(bfd) -> dyn_lib_class)
2128 #define elf_bad_symtab(bfd) (elf_tdata(bfd) -> bad_symtab)
2129 #define elf_flags_init(bfd) (elf_tdata(bfd) -> o->flags_init)
2130 #define elf_known_obj_attributes(bfd) (elf_tdata (bfd) -> known_obj_attributes)
2131 #define elf_other_obj_attributes(bfd) (elf_tdata (bfd) -> other_obj_attributes)
2132 #define elf_known_obj_attributes_proc(bfd) \
2133 (elf_known_obj_attributes (bfd) [OBJ_ATTR_PROC])
2134 #define elf_other_obj_attributes_proc(bfd) \
2135 (elf_other_obj_attributes (bfd) [OBJ_ATTR_PROC])
2136 #define elf_properties(bfd) (elf_tdata (bfd) -> properties)
2137 #define elf_has_no_copy_on_protected(bfd) \
2138 (elf_tdata(bfd) -> has_no_copy_on_protected)
2139 #define elf_has_indirect_extern_access(bfd) \
2140 (elf_tdata(bfd) -> has_indirect_extern_access)
2141 \f
2142 extern void _bfd_elf_swap_verdef_in
2143 (bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *);
2144 extern void _bfd_elf_swap_verdef_out
2145 (bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *);
2146 extern void _bfd_elf_swap_verdaux_in
2147 (bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *);
2148 extern void _bfd_elf_swap_verdaux_out
2149 (bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *);
2150 extern void _bfd_elf_swap_verneed_in
2151 (bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *);
2152 extern void _bfd_elf_swap_verneed_out
2153 (bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *);
2154 extern void _bfd_elf_swap_vernaux_in
2155 (bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *);
2156 extern void _bfd_elf_swap_vernaux_out
2157 (bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *);
2158 extern void _bfd_elf_swap_versym_in
2159 (bfd *, const Elf_External_Versym *, Elf_Internal_Versym *);
2160 extern void _bfd_elf_swap_versym_out
2161 (bfd *, const Elf_Internal_Versym *, Elf_External_Versym *);
2162
2163 extern unsigned int _bfd_elf_section_from_bfd_section
2164 (bfd *, asection *);
2165 extern char *bfd_elf_string_from_elf_section
2166 (bfd *, unsigned, unsigned);
2167 extern Elf_Internal_Sym *bfd_elf_get_elf_syms
2168 (bfd *, Elf_Internal_Shdr *, size_t, size_t, Elf_Internal_Sym *, void *,
2169 Elf_External_Sym_Shndx *);
2170 extern char * bfd_elf_get_str_section (bfd *, unsigned int);
2171 extern const char *bfd_elf_sym_name
2172 (bfd *, Elf_Internal_Shdr *, Elf_Internal_Sym *, asection *);
2173
2174 extern bool _bfd_elf_copy_private_bfd_data
2175 (bfd *, bfd *);
2176 extern bool _bfd_elf_print_private_bfd_data
2177 (bfd *, void *);
2178 const char * _bfd_elf_get_symbol_version_string
2179 (bfd *, asymbol *, bool, bool *);
2180 extern void bfd_elf_print_symbol
2181 (bfd *, void *, asymbol *, bfd_print_symbol_type);
2182
2183 extern unsigned int _bfd_elf_eh_frame_address_size
2184 (bfd *, const asection *);
2185 extern bfd_byte _bfd_elf_encode_eh_address
2186 (bfd *abfd, struct bfd_link_info *info, asection *osec, bfd_vma offset,
2187 asection *loc_sec, bfd_vma loc_offset, bfd_vma *encoded);
2188 extern bool _bfd_elf_can_make_relative
2189 (bfd *input_bfd, struct bfd_link_info *info, asection *eh_frame_section);
2190
2191 extern enum elf_reloc_type_class _bfd_elf_reloc_type_class
2192 (const struct bfd_link_info *, const asection *,
2193 const Elf_Internal_Rela *);
2194 extern bfd_vma _bfd_elf_rela_local_sym
2195 (bfd *, Elf_Internal_Sym *, asection **, Elf_Internal_Rela *);
2196 extern bfd_vma _bfd_elf_rel_local_sym
2197 (bfd *, Elf_Internal_Sym *, asection **, bfd_vma);
2198 extern bfd_vma _bfd_elf_section_offset
2199 (bfd *, struct bfd_link_info *, asection *, bfd_vma);
2200
2201 extern unsigned long bfd_elf_hash
2202 (const char *);
2203 extern unsigned long bfd_elf_gnu_hash
2204 (const char *);
2205
2206 extern bfd_reloc_status_type bfd_elf_generic_reloc
2207 (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
2208 extern bool bfd_elf_allocate_object
2209 (bfd *, size_t, enum elf_target_id);
2210 extern bool bfd_elf_make_object
2211 (bfd *);
2212 extern bool bfd_elf_mkcorefile
2213 (bfd *);
2214 extern bool _bfd_elf_make_section_from_shdr
2215 (bfd *, Elf_Internal_Shdr *, const char *, int);
2216 extern bool _bfd_elf_make_section_from_phdr
2217 (bfd *, Elf_Internal_Phdr *, int, const char *);
2218 extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
2219 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
2220 extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
2221 (bfd *);
2222 extern void _bfd_elf_link_hash_table_free
2223 (bfd *);
2224 extern void _bfd_elf_link_hash_copy_indirect
2225 (struct bfd_link_info *, struct elf_link_hash_entry *,
2226 struct elf_link_hash_entry *);
2227 extern void _bfd_elf_link_hash_hide_symbol
2228 (struct bfd_link_info *, struct elf_link_hash_entry *, bool);
2229 extern void _bfd_elf_link_hide_symbol
2230 (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *);
2231 extern bool _bfd_elf_link_hash_fixup_symbol
2232 (struct bfd_link_info *, struct elf_link_hash_entry *);
2233 extern bool _bfd_elf_link_hash_table_init
2234 (struct elf_link_hash_table *, bfd *,
2235 struct bfd_hash_entry *(*)
2236 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *),
2237 unsigned int, enum elf_target_id);
2238 extern bool _bfd_elf_slurp_version_tables
2239 (bfd *, bool);
2240 extern bool _bfd_elf_merge_sections
2241 (bfd *, struct bfd_link_info *);
2242 extern bool _bfd_elf_match_sections_by_type
2243 (bfd *, const asection *, bfd *, const asection *);
2244 extern bool bfd_elf_is_group_section
2245 (bfd *, const struct bfd_section *);
2246 extern const char *bfd_elf_group_name
2247 (bfd *, const struct bfd_section *);
2248 extern bool _bfd_elf_section_already_linked
2249 (bfd *, asection *, struct bfd_link_info *);
2250 extern void bfd_elf_set_group_contents
2251 (bfd *, asection *, void *);
2252 extern unsigned int _bfd_elf_filter_global_symbols
2253 (bfd *, struct bfd_link_info *, asymbol **, long);
2254 extern asection *_bfd_elf_check_kept_section
2255 (asection *, struct bfd_link_info *);
2256 #define _bfd_elf_link_just_syms _bfd_generic_link_just_syms
2257 extern void _bfd_elf_copy_link_hash_symbol_type
2258 (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *);
2259 extern bool _bfd_elf_size_group_sections
2260 (struct bfd_link_info *);
2261 extern bool _bfd_elf_fixup_group_sections
2262 (bfd *, asection *);
2263 extern bool _bfd_elf_copy_private_header_data
2264 (bfd *, bfd *);
2265 extern bool _bfd_elf_copy_private_symbol_data
2266 (bfd *, asymbol *, bfd *, asymbol *);
2267 #define _bfd_generic_init_private_section_data \
2268 _bfd_elf_init_private_section_data
2269 extern bool _bfd_elf_init_private_section_data
2270 (bfd *, asection *, bfd *, asection *, struct bfd_link_info *);
2271 extern bool _bfd_elf_copy_private_section_data
2272 (bfd *, asection *, bfd *, asection *);
2273 extern bool _bfd_elf_write_object_contents
2274 (bfd *);
2275 extern bool _bfd_elf_write_corefile_contents
2276 (bfd *);
2277 extern bool _bfd_elf_set_section_contents
2278 (bfd *, sec_ptr, const void *, file_ptr, bfd_size_type);
2279 extern long _bfd_elf_get_symtab_upper_bound
2280 (bfd *);
2281 extern long _bfd_elf_canonicalize_symtab
2282 (bfd *, asymbol **);
2283 extern long _bfd_elf_get_dynamic_symtab_upper_bound
2284 (bfd *);
2285 extern long _bfd_elf_canonicalize_dynamic_symtab
2286 (bfd *, asymbol **);
2287 extern long _bfd_elf_get_synthetic_symtab
2288 (bfd *, long, asymbol **, long, asymbol **, asymbol **);
2289 extern long _bfd_elf_get_reloc_upper_bound
2290 (bfd *, sec_ptr);
2291 extern long _bfd_elf_canonicalize_reloc
2292 (bfd *, sec_ptr, arelent **, asymbol **);
2293 extern asection * _bfd_elf_get_dynamic_reloc_section
2294 (bfd *, asection *, bool);
2295 extern asection * _bfd_elf_make_dynamic_reloc_section
2296 (asection *, bfd *, unsigned int, bfd *, bool);
2297 extern long _bfd_elf_get_dynamic_reloc_upper_bound
2298 (bfd *);
2299 extern long _bfd_elf_canonicalize_dynamic_reloc
2300 (bfd *, arelent **, asymbol **);
2301 extern asymbol *_bfd_elf_make_empty_symbol
2302 (bfd *);
2303 extern void _bfd_elf_get_symbol_info
2304 (bfd *, asymbol *, symbol_info *);
2305 extern bool _bfd_elf_is_local_label_name
2306 (bfd *, const char *);
2307 extern alent *_bfd_elf_get_lineno
2308 (bfd *, asymbol *);
2309 extern bool _bfd_elf_set_arch_mach
2310 (bfd *, enum bfd_architecture, unsigned long);
2311 extern bool _bfd_elf_find_nearest_line
2312 (bfd *, asymbol **, asection *, bfd_vma,
2313 const char **, const char **, unsigned int *, unsigned int *);
2314 extern bool _bfd_elf_find_line
2315 (bfd *, asymbol **, asymbol *, const char **, unsigned int *);
2316 extern bool _bfd_elf_find_inliner_info
2317 (bfd *, const char **, const char **, unsigned int *);
2318 extern asymbol *_bfd_elf_find_function
2319 (bfd *, asymbol **, asection *, bfd_vma, const char **, const char **);
2320 #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
2321 #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
2322 extern int _bfd_elf_sizeof_headers
2323 (bfd *, struct bfd_link_info *);
2324 extern bool _bfd_elf_new_section_hook
2325 (bfd *, asection *);
2326 extern const struct bfd_elf_special_section *_bfd_elf_get_special_section
2327 (const char *, const struct bfd_elf_special_section *, unsigned int);
2328 extern const struct bfd_elf_special_section *_bfd_elf_get_sec_type_attr
2329 (bfd *, asection *);
2330
2331 extern bool _bfd_elf_link_hide_sym_by_version
2332 (struct bfd_link_info *, struct elf_link_hash_entry *);
2333
2334 /* If the target doesn't have reloc handling written yet: */
2335 extern bool _bfd_elf_no_info_to_howto
2336 (bfd *, arelent *, Elf_Internal_Rela *);
2337
2338 extern bool bfd_section_from_shdr
2339 (bfd *, unsigned int shindex);
2340 extern bool bfd_section_from_phdr
2341 (bfd *, Elf_Internal_Phdr *, int);
2342
2343 extern int _bfd_elf_symbol_from_bfd_symbol
2344 (bfd *, asymbol **);
2345
2346 extern Elf_Internal_Sym *bfd_sym_from_r_symndx
2347 (struct sym_cache *, bfd *, unsigned long);
2348 extern asection *bfd_section_from_elf_index
2349 (bfd *, unsigned int);
2350
2351 extern struct elf_strtab_hash * _bfd_elf_strtab_init
2352 (void);
2353 extern void _bfd_elf_strtab_free
2354 (struct elf_strtab_hash *);
2355 extern size_t _bfd_elf_strtab_add
2356 (struct elf_strtab_hash *, const char *, bool);
2357 extern void _bfd_elf_strtab_addref
2358 (struct elf_strtab_hash *, size_t);
2359 extern void _bfd_elf_strtab_delref
2360 (struct elf_strtab_hash *, size_t);
2361 extern unsigned int _bfd_elf_strtab_refcount
2362 (struct elf_strtab_hash *, size_t);
2363 extern void _bfd_elf_strtab_clear_all_refs
2364 (struct elf_strtab_hash *);
2365 extern void *_bfd_elf_strtab_save
2366 (struct elf_strtab_hash *);
2367 extern void _bfd_elf_strtab_restore
2368 (struct elf_strtab_hash *, void *);
2369 extern bfd_size_type _bfd_elf_strtab_size
2370 (struct elf_strtab_hash *);
2371 extern bfd_size_type _bfd_elf_strtab_len
2372 (struct elf_strtab_hash *);
2373 extern bfd_size_type _bfd_elf_strtab_offset
2374 (struct elf_strtab_hash *, size_t);
2375 extern const char * _bfd_elf_strtab_str
2376 (struct elf_strtab_hash *, size_t idx, bfd_size_type *offset);
2377 extern bool _bfd_elf_strtab_emit
2378 (bfd *, struct elf_strtab_hash *);
2379 extern void _bfd_elf_strtab_finalize
2380 (struct elf_strtab_hash *);
2381
2382 extern bool bfd_elf_parse_eh_frame_entries
2383 (bfd *, struct bfd_link_info *);
2384 extern bool _bfd_elf_parse_eh_frame_entry
2385 (struct bfd_link_info *, asection *, struct elf_reloc_cookie *);
2386 extern void _bfd_elf_parse_eh_frame
2387 (bfd *, struct bfd_link_info *, asection *, struct elf_reloc_cookie *);
2388 extern bool _bfd_elf_end_eh_frame_parsing
2389 (struct bfd_link_info *info);
2390
2391 extern bool _bfd_elf_discard_section_eh_frame
2392 (bfd *, struct bfd_link_info *, asection *,
2393 bool (*) (bfd_vma, void *), struct elf_reloc_cookie *);
2394 extern bool _bfd_elf_adjust_eh_frame_global_symbol
2395 (struct elf_link_hash_entry *, void *);
2396 extern bool _bfd_elf_discard_section_eh_frame_hdr
2397 (bfd *, struct bfd_link_info *);
2398 extern bfd_vma _bfd_elf_eh_frame_section_offset
2399 (bfd *, struct bfd_link_info *, asection *, bfd_vma);
2400 extern bool _bfd_elf_write_section_eh_frame
2401 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
2402 bool _bfd_elf_write_section_eh_frame_entry
2403 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
2404 extern bool _bfd_elf_fixup_eh_frame_hdr (struct bfd_link_info *);
2405 extern bool _bfd_elf_write_section_eh_frame_hdr
2406 (bfd *, struct bfd_link_info *);
2407 extern bool _bfd_elf_eh_frame_present
2408 (struct bfd_link_info *);
2409 extern bool _bfd_elf_eh_frame_entry_present
2410 (struct bfd_link_info *);
2411 extern bool _bfd_elf_maybe_strip_eh_frame_hdr
2412 (struct bfd_link_info *);
2413
2414 extern bool _bfd_elf_hash_symbol (struct elf_link_hash_entry *);
2415
2416 extern long _bfd_elf_link_lookup_local_dynindx
2417 (struct bfd_link_info *, bfd *, long);
2418 extern bool _bfd_elf_compute_section_file_positions
2419 (bfd *, struct bfd_link_info *);
2420 extern file_ptr _bfd_elf_assign_file_position_for_section
2421 (Elf_Internal_Shdr *, file_ptr, bool);
2422 extern bool _bfd_elf_modify_headers
2423 (bfd *, struct bfd_link_info *);
2424
2425 extern bool _bfd_elf_validate_reloc
2426 (bfd *, arelent *);
2427
2428 extern bool bfd_elf_record_link_assignment
2429 (bfd *, struct bfd_link_info *, const char *, bool,
2430 bool);
2431 extern bool bfd_elf_stack_segment_size (bfd *, struct bfd_link_info *,
2432 const char *, bfd_vma);
2433 extern bool bfd_elf_size_dynamic_sections
2434 (bfd *, const char *, const char *, const char *, const char *, const char *,
2435 const char * const *, struct bfd_link_info *, struct bfd_section **);
2436 extern bool bfd_elf_size_dynsym_hash_dynstr
2437 (bfd *, struct bfd_link_info *);
2438 extern bool bfd_elf_get_bfd_needed_list
2439 (bfd *, struct bfd_link_needed_list **);
2440 extern struct bfd_link_needed_list *bfd_elf_get_needed_list
2441 (bfd *, struct bfd_link_info *);
2442 extern void bfd_elf_set_dt_needed_name
2443 (bfd *, const char *);
2444 extern const char *bfd_elf_get_dt_soname
2445 (bfd *);
2446 extern void bfd_elf_set_dyn_lib_class
2447 (bfd *, enum dynamic_lib_link_class);
2448 extern int bfd_elf_get_dyn_lib_class
2449 (bfd *);
2450 extern struct bfd_link_needed_list *bfd_elf_get_runpath_list
2451 (bfd *, struct bfd_link_info *);
2452 extern int bfd_elf_discard_info
2453 (bfd *, struct bfd_link_info *);
2454 extern unsigned int _bfd_elf_default_action_discarded
2455 (struct bfd_section *);
2456 extern struct bfd_section *_bfd_elf_tls_setup
2457 (bfd *, struct bfd_link_info *);
2458
2459 extern bool _bfd_elf_link_create_dynamic_sections
2460 (bfd *, struct bfd_link_info *);
2461 extern bool _bfd_elf_omit_section_dynsym_default
2462 (bfd *, struct bfd_link_info *, asection *);
2463 extern bool _bfd_elf_omit_section_dynsym_all
2464 (bfd *, struct bfd_link_info *, asection *);
2465 extern bool _bfd_elf_create_dynamic_sections
2466 (bfd *, struct bfd_link_info *);
2467 extern bool _bfd_elf_create_got_section
2468 (bfd *, struct bfd_link_info *);
2469 extern asection *_bfd_elf_section_for_symbol
2470 (struct elf_reloc_cookie *, unsigned long, bool);
2471 extern struct elf_link_hash_entry *_bfd_elf_define_linkage_sym
2472 (bfd *, struct bfd_link_info *, asection *, const char *);
2473 extern void _bfd_elf_init_1_index_section
2474 (bfd *, struct bfd_link_info *);
2475 extern void _bfd_elf_init_2_index_sections
2476 (bfd *, struct bfd_link_info *);
2477
2478 extern bool _bfd_elfcore_make_pseudosection
2479 (bfd *, char *, size_t, ufile_ptr);
2480 extern char *_bfd_elfcore_strndup
2481 (bfd *, char *, size_t);
2482
2483 extern Elf_Internal_Rela *_bfd_elf_link_read_relocs
2484 (bfd *, asection *, void *, Elf_Internal_Rela *, bool);
2485 extern Elf_Internal_Rela *_bfd_elf_link_info_read_relocs
2486 (bfd *, struct bfd_link_info *, asection *, void *, Elf_Internal_Rela *,
2487 bool);
2488
2489 extern bool _bfd_elf_link_output_relocs
2490 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *,
2491 struct elf_link_hash_entry **);
2492
2493 extern bool _bfd_elf_adjust_dynamic_copy
2494 (struct bfd_link_info *, struct elf_link_hash_entry *, asection *);
2495
2496 extern bool _bfd_elf_dynamic_symbol_p
2497 (struct elf_link_hash_entry *, struct bfd_link_info *, bool);
2498
2499 extern bool _bfd_elf_symbol_refs_local_p
2500 (struct elf_link_hash_entry *, struct bfd_link_info *, bool);
2501
2502 extern bfd_reloc_status_type bfd_elf_perform_complex_relocation
2503 (bfd *, asection *, bfd_byte *, Elf_Internal_Rela *, bfd_vma);
2504
2505 extern bool _bfd_elf_setup_sections
2506 (bfd *);
2507
2508 extern struct bfd_link_hash_entry *bfd_elf_define_start_stop
2509 (struct bfd_link_info *, const char *, asection *);
2510
2511 extern bool _bfd_elf_init_file_header (bfd *, struct bfd_link_info *);
2512
2513 extern bool _bfd_elf_final_write_processing (bfd *);
2514
2515 extern bfd_cleanup bfd_elf32_object_p
2516 (bfd *);
2517 extern bfd_cleanup bfd_elf32_core_file_p
2518 (bfd *);
2519 extern char *bfd_elf32_core_file_failing_command
2520 (bfd *);
2521 extern int bfd_elf32_core_file_failing_signal
2522 (bfd *);
2523 extern bool bfd_elf32_core_file_matches_executable_p
2524 (bfd *, bfd *);
2525 extern int bfd_elf32_core_file_pid
2526 (bfd *);
2527 extern bool _bfd_elf32_core_find_build_id
2528 (bfd *, bfd_vma);
2529
2530 extern bool bfd_elf32_swap_symbol_in
2531 (bfd *, const void *, const void *, Elf_Internal_Sym *);
2532 extern void bfd_elf32_swap_symbol_out
2533 (bfd *, const Elf_Internal_Sym *, void *, void *);
2534 extern void bfd_elf32_swap_reloc_in
2535 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2536 extern void bfd_elf32_swap_reloc_out
2537 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2538 extern void bfd_elf32_swap_reloca_in
2539 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2540 extern void bfd_elf32_swap_reloca_out
2541 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2542 extern void bfd_elf32_swap_phdr_in
2543 (bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *);
2544 extern void bfd_elf32_swap_phdr_out
2545 (bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *);
2546 extern void bfd_elf32_swap_dyn_in
2547 (bfd *, const void *, Elf_Internal_Dyn *);
2548 extern void bfd_elf32_swap_dyn_out
2549 (bfd *, const Elf_Internal_Dyn *, void *);
2550 extern long bfd_elf32_slurp_symbol_table
2551 (bfd *, asymbol **, bool);
2552 extern bool bfd_elf32_write_shdrs_and_ehdr
2553 (bfd *);
2554 extern int bfd_elf32_write_out_phdrs
2555 (bfd *, const Elf_Internal_Phdr *, unsigned int);
2556 extern bool bfd_elf32_checksum_contents
2557 (bfd * , void (*) (const void *, size_t, void *), void *);
2558 extern void bfd_elf32_write_relocs
2559 (bfd *, asection *, void *);
2560 extern bool bfd_elf32_slurp_reloc_table
2561 (bfd *, asection *, asymbol **, bool);
2562
2563 extern bfd_cleanup bfd_elf64_object_p
2564 (bfd *);
2565 extern bfd_cleanup bfd_elf64_core_file_p
2566 (bfd *);
2567 extern char *bfd_elf64_core_file_failing_command
2568 (bfd *);
2569 extern int bfd_elf64_core_file_failing_signal
2570 (bfd *);
2571 extern bool bfd_elf64_core_file_matches_executable_p
2572 (bfd *, bfd *);
2573 extern int bfd_elf64_core_file_pid
2574 (bfd *);
2575 extern bool _bfd_elf64_core_find_build_id
2576 (bfd *, bfd_vma);
2577
2578 extern bool bfd_elf64_swap_symbol_in
2579 (bfd *, const void *, const void *, Elf_Internal_Sym *);
2580 extern void bfd_elf64_swap_symbol_out
2581 (bfd *, const Elf_Internal_Sym *, void *, void *);
2582 extern void bfd_elf64_swap_reloc_in
2583 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2584 extern void bfd_elf64_swap_reloc_out
2585 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2586 extern void bfd_elf64_swap_reloca_in
2587 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
2588 extern void bfd_elf64_swap_reloca_out
2589 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
2590 extern void bfd_elf64_swap_phdr_in
2591 (bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *);
2592 extern void bfd_elf64_swap_phdr_out
2593 (bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *);
2594 extern void bfd_elf64_swap_dyn_in
2595 (bfd *, const void *, Elf_Internal_Dyn *);
2596 extern void bfd_elf64_swap_dyn_out
2597 (bfd *, const Elf_Internal_Dyn *, void *);
2598 extern long bfd_elf64_slurp_symbol_table
2599 (bfd *, asymbol **, bool);
2600 extern bool bfd_elf64_write_shdrs_and_ehdr
2601 (bfd *);
2602 extern int bfd_elf64_write_out_phdrs
2603 (bfd *, const Elf_Internal_Phdr *, unsigned int);
2604 extern bool bfd_elf64_checksum_contents
2605 (bfd * , void (*) (const void *, size_t, void *), void *);
2606 extern void bfd_elf64_write_relocs
2607 (bfd *, asection *, void *);
2608 extern bool bfd_elf64_slurp_reloc_table
2609 (bfd *, asection *, asymbol **, bool);
2610
2611 extern bool _bfd_elf_default_relocs_compatible
2612 (const bfd_target *, const bfd_target *);
2613
2614 extern bool _bfd_elf_relocs_compatible
2615 (const bfd_target *, const bfd_target *);
2616 extern bool _bfd_elf_notice_as_needed
2617 (bfd *, struct bfd_link_info *, enum notice_asneeded_action);
2618
2619 extern struct bfd_link_hash_entry *_bfd_elf_archive_symbol_lookup
2620 (bfd *, struct bfd_link_info *, const char *);
2621 extern bool bfd_elf_link_add_symbols
2622 (bfd *, struct bfd_link_info *);
2623 extern bool _bfd_elf_add_dynamic_entry
2624 (struct bfd_link_info *, bfd_vma, bfd_vma);
2625 extern bool _bfd_elf_strip_zero_sized_dynamic_sections
2626 (struct bfd_link_info *);
2627 extern int bfd_elf_add_dt_needed_tag
2628 (bfd *, struct bfd_link_info *);
2629 extern bool _bfd_elf_link_check_relocs
2630 (bfd *, struct bfd_link_info *);
2631
2632 extern bool bfd_elf_link_record_dynamic_symbol
2633 (struct bfd_link_info *, struct elf_link_hash_entry *);
2634
2635 extern int bfd_elf_link_record_local_dynamic_symbol
2636 (struct bfd_link_info *, bfd *, long);
2637
2638 extern bool _bfd_elf_close_and_cleanup
2639 (bfd *);
2640
2641 extern bool _bfd_elf_common_definition
2642 (Elf_Internal_Sym *);
2643
2644 extern unsigned int _bfd_elf_common_section_index
2645 (asection *);
2646
2647 extern asection *_bfd_elf_common_section
2648 (asection *);
2649
2650 extern bfd_vma _bfd_elf_default_got_elt_size
2651 (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *, bfd *,
2652 unsigned long);
2653
2654 extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
2655 (bfd *, arelent *, struct bfd_symbol *, void *,
2656 asection *, bfd *, char **);
2657
2658 extern bool bfd_elf_final_link
2659 (bfd *, struct bfd_link_info *);
2660
2661 extern void _bfd_elf_gc_keep
2662 (struct bfd_link_info *info);
2663
2664 extern bool bfd_elf_gc_mark_dynamic_ref_symbol
2665 (struct elf_link_hash_entry *h, void *inf);
2666
2667 extern bool bfd_elf_gc_sections
2668 (bfd *, struct bfd_link_info *);
2669
2670 extern bool bfd_elf_gc_record_vtinherit
2671 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
2672
2673 extern bool bfd_elf_gc_record_vtentry
2674 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
2675
2676 extern asection *_bfd_elf_gc_mark_hook
2677 (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
2678 struct elf_link_hash_entry *, Elf_Internal_Sym *);
2679
2680 extern asection *_bfd_elf_gc_mark_rsec
2681 (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn,
2682 struct elf_reloc_cookie *, bool *);
2683
2684 extern bool _bfd_elf_gc_mark_reloc
2685 (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn,
2686 struct elf_reloc_cookie *);
2687
2688 extern bool _bfd_elf_gc_mark_fdes
2689 (struct bfd_link_info *, asection *, asection *, elf_gc_mark_hook_fn,
2690 struct elf_reloc_cookie *);
2691
2692 extern bool _bfd_elf_gc_mark
2693 (struct bfd_link_info *, asection *, elf_gc_mark_hook_fn);
2694
2695 extern bool _bfd_elf_gc_mark_extra_sections
2696 (struct bfd_link_info *, elf_gc_mark_hook_fn);
2697
2698 extern bool bfd_elf_gc_common_finalize_got_offsets
2699 (bfd *, struct bfd_link_info *);
2700
2701 extern bool bfd_elf_gc_common_final_link
2702 (bfd *, struct bfd_link_info *);
2703
2704 extern bool bfd_elf_reloc_symbol_deleted_p
2705 (bfd_vma, void *);
2706
2707 extern struct elf_segment_map * _bfd_elf_make_dynamic_segment
2708 (bfd *, asection *);
2709
2710 extern bool _bfd_elf_map_sections_to_segments
2711 (bfd *, struct bfd_link_info *);
2712
2713 extern bool _bfd_elf_is_function_type (unsigned int);
2714
2715 extern bfd_size_type _bfd_elf_maybe_function_sym (const asymbol *, asection *,
2716 bfd_vma *);
2717
2718 extern asection *_bfd_elf_plt_get_reloc_section (bfd *, const char *);
2719
2720 extern int bfd_elf_get_default_section_type (flagword);
2721
2722 extern bool bfd_elf_lookup_section_flags
2723 (struct bfd_link_info *, struct flag_info *, asection *);
2724
2725 extern Elf_Internal_Phdr * _bfd_elf_find_segment_containing_section
2726 (bfd * abfd, asection * section);
2727
2728 /* PowerPC @tls opcode transform/validate. */
2729 extern unsigned int _bfd_elf_ppc_at_tls_transform
2730 (unsigned int, unsigned int);
2731 /* PowerPC @tprel opcode transform/validate. */
2732 extern unsigned int _bfd_elf_ppc_at_tprel_transform
2733 (unsigned int, unsigned int);
2734 /* PowerPC elf_object_p tweak. */
2735 extern bool _bfd_elf_ppc_set_arch (bfd *);
2736 /* PowerPC .gnu.attributes handling common to both 32-bit and 64-bit. */
2737 extern bool _bfd_elf_ppc_merge_fp_attributes
2738 (bfd *, struct bfd_link_info *);
2739
2740 /* Return an upper bound on the number of bytes required to store a
2741 copy of ABFD's program header table entries. Return -1 if an error
2742 occurs; bfd_get_error will return an appropriate code. */
2743 extern long bfd_get_elf_phdr_upper_bound
2744 (bfd *abfd);
2745
2746 /* Copy ABFD's program header table entries to *PHDRS. The entries
2747 will be stored as an array of Elf_Internal_Phdr structures, as
2748 defined in include/elf/internal.h. To find out how large the
2749 buffer needs to be, call bfd_get_elf_phdr_upper_bound.
2750
2751 Return the number of program header table entries read, or -1 if an
2752 error occurs; bfd_get_error will return an appropriate code. */
2753 extern int bfd_get_elf_phdrs
2754 (bfd *abfd, void *phdrs);
2755
2756 /* Exported interface for writing elf corefile notes. */
2757 extern char *elfcore_write_note
2758 (bfd *, char *, int *, const char *, int, const void *, int);
2759 extern char *elfcore_write_prpsinfo
2760 (bfd *, char *, int *, const char *, const char *);
2761 extern char *elfcore_write_prstatus
2762 (bfd *, char *, int *, long, int, const void *);
2763 extern char * elfcore_write_pstatus
2764 (bfd *, char *, int *, long, int, const void *);
2765 extern char *elfcore_write_prfpreg
2766 (bfd *, char *, int *, const void *, int);
2767 extern char *elfcore_write_prxfpreg
2768 (bfd *, char *, int *, const void *, int);
2769 extern char *elfcore_write_xstatereg
2770 (bfd *, char *, int *, const void *, int);
2771 extern char *elfcore_write_ppc_vmx
2772 (bfd *, char *, int *, const void *, int);
2773 extern char *elfcore_write_ppc_vsx
2774 (bfd *, char *, int *, const void *, int);
2775 extern char *elfcore_write_ppc_tar
2776 (bfd *, char *, int *, const void *, int);
2777 extern char *elfcore_write_ppc_ppr
2778 (bfd *, char *, int *, const void *, int);
2779 extern char *elfcore_write_ppc_dscr
2780 (bfd *, char *, int *, const void *, int);
2781 extern char *elfcore_write_ppc_ebb
2782 (bfd *, char *, int *, const void *, int);
2783 extern char *elfcore_write_ppc_pmu
2784 (bfd *, char *, int *, const void *, int);
2785 extern char *elfcore_write_ppc_tm_cgpr
2786 (bfd *, char *, int *, const void *, int);
2787 extern char *elfcore_write_ppc_tm_cfpr
2788 (bfd *, char *, int *, const void *, int);
2789 extern char *elfcore_write_ppc_tm_cvmx
2790 (bfd *, char *, int *, const void *, int);
2791 extern char *elfcore_write_ppc_tm_cvsx
2792 (bfd *, char *, int *, const void *, int);
2793 extern char *elfcore_write_ppc_tm_spr
2794 (bfd *, char *, int *, const void *, int);
2795 extern char *elfcore_write_ppc_tm_ctar
2796 (bfd *, char *, int *, const void *, int);
2797 extern char *elfcore_write_ppc_tm_cppr
2798 (bfd *, char *, int *, const void *, int);
2799 extern char *elfcore_write_ppc_tm_cdscr
2800 (bfd *, char *, int *, const void *, int);
2801 extern char *elfcore_write_s390_timer
2802 (bfd *, char *, int *, const void *, int);
2803 extern char *elfcore_write_s390_todcmp
2804 (bfd *, char *, int *, const void *, int);
2805 extern char *elfcore_write_s390_todpreg
2806 (bfd *, char *, int *, const void *, int);
2807 extern char *elfcore_write_s390_ctrs
2808 (bfd *, char *, int *, const void *, int);
2809 extern char *elfcore_write_s390_prefix
2810 (bfd *, char *, int *, const void *, int);
2811 extern char *elfcore_write_s390_last_break
2812 (bfd *, char *, int *, const void *, int);
2813 extern char *elfcore_write_s390_system_call
2814 (bfd *, char *, int *, const void *, int);
2815 extern char *elfcore_write_s390_tdb
2816 (bfd *, char *, int *, const void *, int);
2817 extern char *elfcore_write_s390_vxrs_low
2818 (bfd *, char *, int *, const void *, int);
2819 extern char *elfcore_write_s390_vxrs_high
2820 (bfd *, char *, int *, const void *, int);
2821 extern char *elfcore_write_s390_gs_cb
2822 (bfd *, char *, int *, const void *, int);
2823 extern char *elfcore_write_s390_gs_bc
2824 (bfd *, char *, int *, const void *, int);
2825 extern char *elfcore_write_arm_vfp
2826 (bfd *, char *, int *, const void *, int);
2827 extern char *elfcore_write_aarch_tls
2828 (bfd *, char *, int *, const void *, int);
2829 extern char *elfcore_write_aarch_hw_break
2830 (bfd *, char *, int *, const void *, int);
2831 extern char *elfcore_write_aarch_hw_watch
2832 (bfd *, char *, int *, const void *, int);
2833 extern char *elfcore_write_aarch_sve
2834 (bfd *, char *, int *, const void *, int);
2835 extern char *elfcore_write_aarch_pauth
2836 (bfd *, char *, int *, const void *, int);
2837 extern char *elfcore_write_aarch_mte
2838 (bfd *, char *, int *, const void *, int);
2839 extern char *elfcore_write_arc_v2
2840 (bfd *, char *, int *, const void *, int);
2841 extern char *elfcore_write_riscv_csr
2842 (bfd *, char *, int *, const void *, int);
2843 extern char *elfcore_write_gdb_tdesc
2844 (bfd *, char *, int *, const void *, int);
2845 extern char *elfcore_write_lwpstatus
2846 (bfd *, char *, int *, long, int, const void *);
2847 extern char *elfcore_write_register_note
2848 (bfd *, char *, int *, const char *, const void *, int);
2849 extern char *elfcore_write_file_note
2850 (bfd *, char *, int *, const void*, int);
2851 extern char *elfcore_write_loongarch_cpucfg
2852 (bfd *, char *, int *, const void*, int);
2853 extern char *elfcore_write_loongarch_lbt
2854 (bfd *, char *, int *, const void*, int);
2855 extern char *elfcore_write_loongarch_lsx
2856 (bfd *, char *, int *, const void*, int);
2857 extern char *elfcore_write_loongarch_lasx
2858 (bfd *, char *, int *, const void*, int);
2859
2860 /* Internal structure which holds information to be included in the
2861 PRPSINFO section of Linux core files.
2862
2863 This is an "internal" structure in the sense that it should be used
2864 to pass information to BFD (via the `elfcore_write_linux_prpsinfo'
2865 function), so things like endianess shouldn't be an issue. This
2866 structure will eventually be converted in one of the
2867 `elf_external_linux_*' structures and written out to an output bfd
2868 by one of the functions declared below. */
2869
2870 struct elf_internal_linux_prpsinfo
2871 {
2872 char pr_state; /* Numeric process state. */
2873 char pr_sname; /* Char for pr_state. */
2874 char pr_zomb; /* Zombie. */
2875 char pr_nice; /* Nice val. */
2876 unsigned long pr_flag; /* Flags. */
2877 unsigned int pr_uid;
2878 unsigned int pr_gid;
2879 int pr_pid, pr_ppid, pr_pgrp, pr_sid;
2880 char pr_fname[16 + 1]; /* Filename of executable. */
2881 char pr_psargs[80 + 1]; /* Initial part of arg list. */
2882 };
2883
2884 /* Linux/most 32-bit archs. */
2885 extern char *elfcore_write_linux_prpsinfo32
2886 (bfd *, char *, int *, const struct elf_internal_linux_prpsinfo *);
2887
2888 /* Linux/most 64-bit archs. */
2889 extern char *elfcore_write_linux_prpsinfo64
2890 (bfd *, char *, int *, const struct elf_internal_linux_prpsinfo *);
2891
2892 extern bfd *_bfd_elf32_bfd_from_remote_memory
2893 (bfd *templ, bfd_vma ehdr_vma, bfd_size_type size, bfd_vma *loadbasep,
2894 int (*target_read_memory) (bfd_vma, bfd_byte *, bfd_size_type));
2895 extern bfd *_bfd_elf64_bfd_from_remote_memory
2896 (bfd *templ, bfd_vma ehdr_vma, bfd_size_type size, bfd_vma *loadbasep,
2897 int (*target_read_memory) (bfd_vma, bfd_byte *, bfd_size_type));
2898
2899 extern bfd_vma bfd_elf_obj_attr_size (bfd *);
2900 extern void bfd_elf_set_obj_attr_contents (bfd *, bfd_byte *, bfd_vma);
2901 extern int bfd_elf_get_obj_attr_int (bfd *, int, unsigned int);
2902 extern void bfd_elf_add_obj_attr_int (bfd *, int, unsigned int, unsigned int);
2903 #define bfd_elf_add_proc_attr_int(BFD, TAG, VALUE) \
2904 bfd_elf_add_obj_attr_int ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
2905 extern void bfd_elf_add_obj_attr_string (bfd *, int, unsigned int, const char *);
2906 #define bfd_elf_add_proc_attr_string(BFD, TAG, VALUE) \
2907 bfd_elf_add_obj_attr_string ((BFD), OBJ_ATTR_PROC, (TAG), (VALUE))
2908 extern void bfd_elf_add_obj_attr_int_string (bfd *, int, unsigned int,
2909 unsigned int, const char *);
2910 #define bfd_elf_add_proc_attr_int_string(BFD, TAG, INTVAL, STRVAL) \
2911 bfd_elf_add_obj_attr_int_string ((BFD), OBJ_ATTR_PROC, (TAG), \
2912 (INTVAL), (STRVAL))
2913
2914 extern char *_bfd_elf_attr_strdup (bfd *, const char *);
2915 extern void _bfd_elf_copy_obj_attributes (bfd *, bfd *);
2916 extern int _bfd_elf_obj_attrs_arg_type (bfd *, int, unsigned int);
2917 extern void _bfd_elf_parse_attributes (bfd *, Elf_Internal_Shdr *);
2918 extern bool _bfd_elf_merge_object_attributes
2919 (bfd *, struct bfd_link_info *);
2920 extern bool _bfd_elf_merge_unknown_attribute_low (bfd *, bfd *, int);
2921 extern bool _bfd_elf_merge_unknown_attribute_list (bfd *, bfd *);
2922 extern Elf_Internal_Shdr *_bfd_elf_single_rel_hdr (asection *sec);
2923 extern bool elf_read_notes (bfd *, file_ptr, bfd_size_type, size_t);
2924
2925 extern bool _bfd_elf_parse_gnu_properties
2926 (bfd *, Elf_Internal_Note *);
2927 extern elf_property * _bfd_elf_get_property
2928 (bfd *, unsigned int, unsigned int);
2929 extern bfd *_bfd_elf_link_setup_gnu_properties
2930 (struct bfd_link_info *);
2931 extern bfd_size_type _bfd_elf_convert_gnu_property_size
2932 (bfd *, bfd *);
2933 extern bool _bfd_elf_convert_gnu_properties
2934 (bfd *, asection *, bfd *, bfd_byte **, bfd_size_type *);
2935
2936 /* The linker may need to keep track of the number of relocs that it
2937 decides to copy as dynamic relocs in check_relocs for each symbol.
2938 This is so that it can later discard them if they are found to be
2939 unnecessary. We can store the information in a field extending the
2940 regular ELF linker hash table. */
2941
2942 struct elf_dyn_relocs
2943 {
2944 struct elf_dyn_relocs *next;
2945
2946 /* The input section of the reloc. */
2947 asection *sec;
2948
2949 /* Total number of relocs copied for the input section. */
2950 bfd_size_type count;
2951
2952 /* Number of pc-relative relocs copied for the input section. */
2953 bfd_size_type pc_count;
2954 };
2955
2956 extern bool _bfd_elf_create_ifunc_sections
2957 (bfd *, struct bfd_link_info *);
2958 extern bool _bfd_elf_allocate_ifunc_dyn_relocs
2959 (struct bfd_link_info *, struct elf_link_hash_entry *,
2960 struct elf_dyn_relocs **, unsigned int, unsigned int,
2961 unsigned int, bool);
2962
2963 extern void elf_append_rela (bfd *, asection *, Elf_Internal_Rela *);
2964 extern void elf_append_rel (bfd *, asection *, Elf_Internal_Rela *);
2965
2966 extern bfd_vma elf64_r_info (bfd_vma, bfd_vma);
2967 extern bfd_vma elf64_r_sym (bfd_vma);
2968 extern bfd_vma elf32_r_info (bfd_vma, bfd_vma);
2969 extern bfd_vma elf32_r_sym (bfd_vma);
2970
2971 extern bool is_debuginfo_file (bfd *);
2972
2973
2974 extern bool _bfd_elf_init_secondary_reloc_section
2975 (bfd *, Elf_Internal_Shdr *, const char *, unsigned int);
2976 extern bool _bfd_elf_slurp_secondary_reloc_section
2977 (bfd *, asection *, asymbol **, bool);
2978 extern bool _bfd_elf_copy_special_section_fields
2979 (const bfd *, bfd *, const Elf_Internal_Shdr *, Elf_Internal_Shdr *);
2980 extern bool _bfd_elf_write_secondary_reloc_section
2981 (bfd *, asection *);
2982 extern unsigned int _bfd_elf_symbol_section_index
2983 (bfd *, elf_symbol_type *);
2984
2985 extern asection *_bfd_elf_readonly_dynrelocs
2986 (struct elf_link_hash_entry *);
2987 extern bool _bfd_elf_maybe_set_textrel
2988 (struct elf_link_hash_entry *, void *);
2989
2990 extern bool _bfd_elf_add_dynamic_tags
2991 (bfd *, struct bfd_link_info *, bool);
2992
2993 /* Large common section. */
2994 extern asection _bfd_elf_large_com_section;
2995
2996 /* Hash for local symbol with the first section id, ID, in the input
2997 file and the local symbol index, SYM. */
2998 #define ELF_LOCAL_SYMBOL_HASH(ID, SYM) \
2999 (((((ID) & 0xffU) << 24) | (((ID) & 0xff00) << 8)) \
3000 ^ (SYM) ^ (((ID) & 0xffff0000U) >> 16))
3001
3002 /* This is the condition under which finish_dynamic_symbol will be called.
3003 If our finish_dynamic_symbol isn't called, we'll need to do something
3004 about initializing any .plt and .got entries in relocate_section. */
3005 #define WILL_CALL_FINISH_DYNAMIC_SYMBOL(DYN, SHARED, H) \
3006 ((DYN) \
3007 && ((SHARED) || !(H)->forced_local) \
3008 && ((H)->dynindx != -1 || (H)->forced_local))
3009
3010 /* This macro is to avoid lots of duplicated code in the body
3011 of xxx_relocate_section() in the various elfxx-xxxx.c files. */
3012 #define RELOC_FOR_GLOBAL_SYMBOL(info, input_bfd, input_section, rel, \
3013 r_symndx, symtab_hdr, sym_hashes, \
3014 h, sec, relocation, \
3015 unresolved_reloc, warned, ignored) \
3016 do \
3017 { \
3018 /* It seems this can happen with erroneous or unsupported \
3019 input (mixing a.out and elf in an archive, for example.) */ \
3020 if (sym_hashes == NULL) \
3021 return false; \
3022 \
3023 h = sym_hashes[r_symndx - symtab_hdr->sh_info]; \
3024 \
3025 if (info->wrap_hash != NULL \
3026 && (input_section->flags & SEC_DEBUGGING) != 0) \
3027 h = ((struct elf_link_hash_entry *) \
3028 unwrap_hash_lookup (info, input_bfd, &h->root)); \
3029 \
3030 while (h->root.type == bfd_link_hash_indirect \
3031 || h->root.type == bfd_link_hash_warning) \
3032 h = (struct elf_link_hash_entry *) h->root.u.i.link; \
3033 \
3034 warned = false; \
3035 ignored = false; \
3036 unresolved_reloc = false; \
3037 relocation = 0; \
3038 if (h->root.type == bfd_link_hash_defined \
3039 || h->root.type == bfd_link_hash_defweak) \
3040 { \
3041 sec = h->root.u.def.section; \
3042 if (sec == NULL \
3043 || sec->output_section == NULL) \
3044 /* Set a flag that will be cleared later if we find a \
3045 relocation value for this symbol. output_section \
3046 is typically NULL for symbols satisfied by a shared \
3047 library. */ \
3048 unresolved_reloc = true; \
3049 else \
3050 relocation = (h->root.u.def.value \
3051 + sec->output_section->vma \
3052 + sec->output_offset); \
3053 } \
3054 else if (h->root.type == bfd_link_hash_undefweak) \
3055 ; \
3056 else if (info->unresolved_syms_in_objects == RM_IGNORE \
3057 && ELF_ST_VISIBILITY (h->other) == STV_DEFAULT) \
3058 ignored = true; \
3059 else if (!bfd_link_relocatable (info)) \
3060 { \
3061 bool err = ((info->unresolved_syms_in_objects == RM_DIAGNOSE \
3062 && !info->warn_unresolved_syms) \
3063 || ELF_ST_VISIBILITY (h->other) != STV_DEFAULT); \
3064 (*info->callbacks->undefined_symbol) (info, \
3065 h->root.root.string, \
3066 input_bfd, \
3067 input_section, \
3068 rel->r_offset, err); \
3069 warned = true; \
3070 } \
3071 (void) unresolved_reloc; \
3072 (void) warned; \
3073 (void) ignored; \
3074 } \
3075 while (0)
3076
3077 /* This macro is to avoid lots of duplicated code in the body of the
3078 loop over relocations in xxx_relocate_section() in the various
3079 elfxx-xxxx.c files.
3080
3081 Handle relocations against symbols from removed linkonce sections,
3082 or sections discarded by a linker script. When doing a relocatable
3083 link, we remove such relocations. Otherwise, we just want the
3084 section contents zeroed and avoid any special processing. */
3085 #define RELOC_AGAINST_DISCARDED_SECTION(info, input_bfd, input_section, \
3086 rel, count, relend, \
3087 howto, index, contents) \
3088 { \
3089 int i_; \
3090 _bfd_clear_contents (howto, input_bfd, input_section, \
3091 contents, rel[index].r_offset); \
3092 \
3093 if (bfd_link_relocatable (info) \
3094 && (input_section->flags & SEC_DEBUGGING)) \
3095 { \
3096 /* Only remove relocations in debug sections since other \
3097 sections may require relocations. */ \
3098 Elf_Internal_Shdr *rel_hdr; \
3099 \
3100 rel_hdr = _bfd_elf_single_rel_hdr (input_section->output_section); \
3101 \
3102 /* Avoid empty output section. */ \
3103 if (rel_hdr->sh_size > rel_hdr->sh_entsize) \
3104 { \
3105 rel_hdr->sh_size -= rel_hdr->sh_entsize; \
3106 rel_hdr = _bfd_elf_single_rel_hdr (input_section); \
3107 rel_hdr->sh_size -= rel_hdr->sh_entsize; \
3108 \
3109 memmove (rel, rel + count, \
3110 (relend - rel - count) * sizeof (*rel)); \
3111 \
3112 input_section->reloc_count -= count; \
3113 relend -= count; \
3114 rel--; \
3115 continue; \
3116 } \
3117 } \
3118 \
3119 for (i_ = 0; i_ < count; i_++) \
3120 { \
3121 rel[i_].r_info = 0; \
3122 rel[i_].r_addend = 0; \
3123 } \
3124 rel += count - 1; \
3125 continue; \
3126 }
3127
3128 /* Will a symbol be bound to the definition within the shared
3129 library, if any. A unique symbol can never be bound locally. */
3130 #define SYMBOLIC_BIND(INFO, H) \
3131 (!(H)->unique_global \
3132 && ((INFO)->symbolic \
3133 || (H)->start_stop \
3134 || ((INFO)->dynamic && !(H)->dynamic)))
3135
3136 /* Determine if a section contains CTF data, using its name. */
3137 static inline bool
3138 bfd_section_is_ctf (const asection *sec)
3139 {
3140 const char *name = bfd_section_name (sec);
3141 return startswith (name, ".ctf") && (name[4] == 0 || name[4] == '.');
3142 }
3143
3144 #ifdef __cplusplus
3145 }
3146 #endif
3147 #endif /* _LIBELF_H_ */