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