]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - bfd/elf-bfd.h
* bfd/bin-in.h (bfd_elf32_arm_set_target_relocs): Update prototype.
[thirdparty/binutils-gdb.git] / bfd / elf-bfd.h
CommitLineData
252b5132 1/* BFD back-end data structures for ELF files.
e5094212 2 Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
2c42be65 3 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
252b5132
RH
4 Written by Cygnus Support.
5
5e8d7549 6 This file is part of BFD, the Binary File Descriptor library.
252b5132 7
5e8d7549
NC
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
252b5132 12
5e8d7549
NC
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
252b5132 17
5e8d7549
NC
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
252b5132
RH
21
22#ifndef _LIBELF_H_
23#define _LIBELF_H_ 1
24
25#include "elf/common.h"
26#include "elf/internal.h"
27#include "elf/external.h"
28#include "bfdlink.h"
29
d9bc7a44 30/* The number of entries in a section is its size divided by the size
51b64d56 31 of a single entry. This is normally only applicable to reloc and
d9bc7a44
NC
32 symbol table sections. */
33#define NUM_SHDR_ENTRIES(shdr) ((shdr)->sh_size / (shdr)->sh_entsize)
34
252b5132
RH
35/* If size isn't specified as 64 or 32, NAME macro should fail. */
36#ifndef NAME
c39a58e6
AM
37#if ARCH_SIZE == 64
38#define NAME(x, y) x ## 64 ## _ ## y
252b5132 39#endif
c39a58e6
AM
40#if ARCH_SIZE == 32
41#define NAME(x, y) x ## 32 ## _ ## y
252b5132
RH
42#endif
43#endif
44
45#ifndef NAME
c39a58e6 46#define NAME(x, y) x ## NOSIZE ## _ ## y
252b5132
RH
47#endif
48
49#define ElfNAME(X) NAME(Elf,X)
50#define elfNAME(X) NAME(elf,X)
51
52/* Information held for an ELF symbol. The first field is the
53 corresponding asymbol. Every symbol is an ELF file is actually a
54 pointer to this structure, although it is often handled as a
55 pointer to an asymbol. */
56
57typedef struct
58{
59 /* The BFD symbol. */
60 asymbol symbol;
61 /* ELF symbol information. */
62 Elf_Internal_Sym internal_elf_sym;
63 /* Backend specific information. */
64 union
65 {
66 unsigned int hppa_arg_reloc;
c39a58e6
AM
67 void *mips_extr;
68 void *any;
252b5132
RH
69 }
70 tc_data;
71
72 /* Version information. This is from an Elf_Internal_Versym
73 structure in a SHT_GNU_versym section. It is zero if there is no
74 version information. */
75 unsigned short version;
76
77} elf_symbol_type;
78\f
2b0f7ef9 79struct elf_strtab_hash;
5cab59f6
AM
80struct got_entry;
81struct plt_entry;
2b0f7ef9 82
252b5132
RH
83/* ELF linker hash table entries. */
84
85struct elf_link_hash_entry
86{
87 struct bfd_link_hash_entry root;
88
89 /* Symbol index in output file. This is initialized to -1. It is
90 set to -2 if the symbol is used by a reloc. */
91 long indx;
92
252b5132
RH
93 /* Symbol index as a dynamic symbol. Initialized to -1, and remains
94 -1 if this is not a dynamic symbol. */
30b30c21
RH
95 /* ??? Note that this is consistently used as a synonym for tests
96 against whether we can perform various simplifying transformations
97 to the code. (E.g. changing a pc-relative jump to a PLT entry
98 into a pc-relative jump to the target function.) That test, which
99 is often relatively complex, and someplaces wrong or incomplete,
100 should really be replaced by a predicate in elflink.c.
101
102 End result: this field -1 does not indicate that the symbol is
103 not in the dynamic symbol table, but rather that the symbol is
104 not visible outside this DSO. */
252b5132
RH
105 long dynindx;
106
a90b9fca
AM
107 /* If this symbol requires an entry in the global offset table, the
108 processor specific backend uses this field to track usage and
5cab59f6
AM
109 final offset. Two schemes are supported: The first assumes that
110 a symbol may only have one GOT entry, and uses REFCOUNT until
111 size_dynamic_sections, at which point the contents of the .got is
112 fixed. Afterward, if OFFSET is -1, then the symbol does not
113 require a global offset table entry. The second scheme allows
114 multiple GOT entries per symbol, managed via a linked list
115 pointed to by GLIST. */
116 union gotplt_union
a90b9fca
AM
117 {
118 bfd_signed_vma refcount;
119 bfd_vma offset;
5cab59f6
AM
120 struct got_entry *glist;
121 struct plt_entry *plist;
a90b9fca
AM
122 } got;
123
124 /* Same, but tracks a procedure linkage table entry. */
5cab59f6 125 union gotplt_union plt;
a90b9fca
AM
126
127 /* Symbol size. */
128 bfd_size_type size;
129
252b5132 130 /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.). */
f5385ebf 131 unsigned int type : 8;
252b5132 132
9b234ee9 133 /* Symbol st_other value, symbol visibility. */
f5385ebf 134 unsigned int other : 8;
252b5132 135
252b5132 136 /* Symbol is referenced by a non-shared object. */
f5385ebf 137 unsigned int ref_regular : 1;
252b5132 138 /* Symbol is defined by a non-shared object. */
f5385ebf 139 unsigned int def_regular : 1;
252b5132 140 /* Symbol is referenced by a shared object. */
f5385ebf 141 unsigned int ref_dynamic : 1;
252b5132 142 /* Symbol is defined by a shared object. */
f5385ebf 143 unsigned int def_dynamic : 1;
252b5132 144 /* Symbol has a non-weak reference from a non-shared object. */
f5385ebf 145 unsigned int ref_regular_nonweak : 1;
252b5132 146 /* Dynamic symbol has been adjustd. */
f5385ebf 147 unsigned int dynamic_adjusted : 1;
252b5132 148 /* Symbol needs a copy reloc. */
f5385ebf 149 unsigned int needs_copy : 1;
252b5132 150 /* Symbol needs a procedure linkage table entry. */
f5385ebf 151 unsigned int needs_plt : 1;
252b5132 152 /* Symbol appears in a non-ELF input file. */
f5385ebf 153 unsigned int non_elf : 1;
252b5132 154 /* Symbol should be marked as hidden in the version information. */
f5385ebf 155 unsigned int hidden : 1;
252b5132 156 /* Symbol was forced to local scope due to a version script file. */
f5385ebf 157 unsigned int forced_local : 1;
252b5132 158 /* Symbol was marked during garbage collection. */
f5385ebf 159 unsigned int mark : 1;
7843f00e
ILT
160 /* Symbol is referenced by a non-GOT/non-PLT relocation. This is
161 not currently set by all the backends. */
f5385ebf 162 unsigned int non_got_ref : 1;
f6e332e6
AM
163 /* Symbol has a definition in a shared object.
164 FIXME: There is no real need for this field if def_dynamic is never
165 cleared and all places that test def_dynamic also test def_regular. */
f5385ebf 166 unsigned int dynamic_def : 1;
1b1fe8fe 167 /* Symbol is weak in all shared objects. */
f5385ebf 168 unsigned int dynamic_weak : 1;
c6585bbb
JJ
169 /* Symbol is referenced with a relocation where C/C++ pointer equality
170 matters. */
f5385ebf 171 unsigned int pointer_equality_needed : 1;
f6e332e6
AM
172
173 /* String table index in .dynstr if this is a dynamic symbol. */
174 unsigned long dynstr_index;
175
176 union
177 {
178 /* If this is a weak defined symbol from a dynamic object, this
179 field points to a defined symbol with the same value, if there is
180 one. Otherwise it is NULL. */
181 struct elf_link_hash_entry *weakdef;
182
183 /* Hash value of the name computed using the ELF hash function.
184 Used part way through size_dynamic_sections, after we've finished
185 with weakdefs. */
186 unsigned long elf_hash_value;
187 } u;
188
189 /* Version information. */
190 union
191 {
192 /* This field is used for a symbol which is not defined in a
193 regular object. It points to the version information read in
194 from the dynamic object. */
195 Elf_Internal_Verdef *verdef;
196 /* This field is used for a symbol which is defined in a regular
197 object. It is set up in size_dynamic_sections. It points to
198 the version information we should write out for this symbol. */
199 struct bfd_elf_version_tree *vertree;
200 } verinfo;
201
202 struct
203 {
204 /* Virtual table entry use information. This array is nominally of size
205 size/sizeof(target_void_pointer), though we have to be able to assume
206 and track a size while the symbol is still undefined. It is indexed
207 via offset/sizeof(target_void_pointer). */
208 size_t size;
209 bfd_boolean *used;
210
211 /* Virtual table derivation info. */
212 struct elf_link_hash_entry *parent;
213 } *vtable;
252b5132
RH
214};
215
586119b3
AM
216/* Will references to this symbol always reference the symbol
217 in this object? STV_PROTECTED is excluded from the visibility test
218 here so that function pointer comparisons work properly. Since
219 function symbols not defined in an app are set to their .plt entry,
220 it's necessary for shared libs to also reference the .plt even
221 though the symbol is really local to the shared lib. */
986a241f 222#define SYMBOL_REFERENCES_LOCAL(INFO, H) \
f6c52c13 223 _bfd_elf_symbol_refs_local_p (H, INFO, 0)
586119b3
AM
224
225/* Will _calls_ to this symbol always call the version in this object? */
986a241f 226#define SYMBOL_CALLS_LOCAL(INFO, H) \
f6c52c13 227 _bfd_elf_symbol_refs_local_p (H, INFO, 1)
586119b3 228
7e2294f9
AO
229/* Common symbols that are turned into definitions don't have the
230 DEF_REGULAR flag set, so they might appear to be undefined. */
231#define ELF_COMMON_DEF_P(H) \
f5385ebf
AM
232 (!(H)->def_regular \
233 && !(H)->def_dynamic \
7e2294f9
AO
234 && (H)->root.type == bfd_link_hash_defined)
235
30b30c21
RH
236/* Records local symbols to be emitted in the dynamic symbol table. */
237
238struct elf_link_local_dynamic_entry
239{
240 struct elf_link_local_dynamic_entry *next;
241
242 /* The input bfd this symbol came from. */
243 bfd *input_bfd;
244
245 /* The index of the local symbol being copied. */
246 long input_indx;
247
248 /* The index in the outgoing dynamic symbol table. */
249 long dynindx;
3e932841 250
30b30c21
RH
251 /* A copy of the input symbol. */
252 Elf_Internal_Sym isym;
253};
254
f5d44ba0
AM
255struct elf_link_loaded_list
256{
257 struct elf_link_loaded_list *next;
258 bfd *abfd;
259};
260
126495ed
AM
261/* Structures used by the eh_frame optimization code. */
262struct cie_header
263{
264 unsigned int length;
265 unsigned int id;
266};
267
268struct cie
269{
270 struct cie_header hdr;
271 unsigned char version;
272 unsigned char augmentation[20];
2c42be65
RS
273 bfd_vma code_align;
274 bfd_signed_vma data_align;
275 bfd_vma ra_column;
276 bfd_vma augmentation_size;
126495ed
AM
277 struct elf_link_hash_entry *personality;
278 unsigned char per_encoding;
279 unsigned char lsda_encoding;
280 unsigned char fde_encoding;
281 unsigned char initial_insn_length;
282 unsigned char make_relative;
283 unsigned char make_lsda_relative;
284 unsigned char initial_instructions[50];
285};
286
287struct eh_cie_fde
288{
fda3ecf2
AM
289 /* For FDEs, this points to the CIE used. */
290 struct eh_cie_fde *cie_inf;
126495ed 291 unsigned int size;
fda3ecf2 292 unsigned int offset;
126495ed
AM
293 unsigned int new_offset;
294 unsigned char fde_encoding;
295 unsigned char lsda_encoding;
296 unsigned char lsda_offset;
822392ce
DJ
297 unsigned int cie : 1;
298 unsigned int removed : 1;
353057a5
RS
299 unsigned int add_augmentation_size : 1;
300 unsigned int add_fde_encoding : 1;
822392ce
DJ
301 unsigned int make_relative : 1;
302 unsigned int make_lsda_relative : 1;
8935b81f 303 unsigned int need_lsda_relative : 1;
822392ce 304 unsigned int per_encoding_relative : 1;
126495ed
AM
305};
306
307struct eh_frame_sec_info
308{
309 unsigned int count;
310 unsigned int alloced;
311 struct eh_cie_fde entry[1];
312};
313
314struct eh_frame_array_ent
315{
316 bfd_vma initial_loc;
317 bfd_vma fde;
318};
319
320struct eh_frame_hdr_info
321{
322 struct cie last_cie;
323 asection *last_cie_sec;
fda3ecf2 324 struct eh_cie_fde *last_cie_inf;
126495ed 325 asection *hdr_sec;
126495ed
AM
326 unsigned int fde_count, array_count;
327 struct eh_frame_array_ent *array;
328 /* TRUE if .eh_frame_hdr should contain the sorted search table.
329 We build it if we successfully read all .eh_frame input sections
330 and recognize them. */
b34976b6 331 bfd_boolean table;
3472e2e9 332 bfd_boolean offsets_adjusted;
126495ed
AM
333};
334
252b5132
RH
335/* ELF linker hash table. */
336
337struct elf_link_hash_table
338{
339 struct bfd_link_hash_table root;
51b64d56 340
252b5132
RH
341 /* Whether we have created the special dynamic sections required
342 when linking against or generating a shared object. */
b34976b6 343 bfd_boolean dynamic_sections_created;
51b64d56 344
252b5132
RH
345 /* The BFD used to hold special sections created by the linker.
346 This will be the first BFD found which requires these sections to
347 be created. */
348 bfd *dynobj;
51b64d56
AM
349
350 /* The value to use when initialising got.refcount/offset and
351 plt.refcount/offset in an elf_link_hash_entry. Set to zero when
5cab59f6
AM
352 the values are refcounts. Set to init_offset in
353 size_dynamic_sections when the values may be offsets. */
354 union gotplt_union init_refcount;
355
356 /* The value to use for got.refcount/offset and plt.refcount/offset
357 when the values may be offsets. Normally (bfd_vma) -1. */
358 union gotplt_union init_offset;
51b64d56 359
252b5132
RH
360 /* The number of symbols found in the link which must be put into
361 the .dynsym section. */
362 bfd_size_type dynsymcount;
51b64d56 363
252b5132
RH
364 /* The string table of dynamic symbols, which becomes the .dynstr
365 section. */
2b0f7ef9 366 struct elf_strtab_hash *dynstr;
51b64d56 367
252b5132
RH
368 /* The number of buckets in the hash table in the .hash section.
369 This is based on the number of dynamic symbols. */
370 bfd_size_type bucketcount;
51b64d56 371
252b5132
RH
372 /* A linked list of DT_NEEDED names found in dynamic objects
373 included in the link. */
374 struct bfd_link_needed_list *needed;
51b64d56 375
252b5132
RH
376 /* The _GLOBAL_OFFSET_TABLE_ symbol. */
377 struct elf_link_hash_entry *hgot;
51b64d56 378
f5fa8ca2 379 /* A pointer to information used to merge SEC_MERGE sections. */
c39a58e6 380 void *merge_info;
51b64d56 381
3722b82f
AM
382 /* Used to link stabs in sections. */
383 struct stab_info stab_info;
384
126495ed
AM
385 /* Used by eh_frame code when editing .eh_frame. */
386 struct eh_frame_hdr_info eh_info;
387
30b30c21
RH
388 /* A linked list of local symbols to be added to .dynsym. */
389 struct elf_link_local_dynamic_entry *dynlocal;
51b64d56 390
a963dc6a
L
391 /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic
392 objects included in the link. */
393 struct bfd_link_needed_list *runpath;
13ae64f3 394
e1918d23
AM
395 /* Cached first output tls section and size of PT_TLS segment. */
396 asection *tls_sec;
397 bfd_size_type tls_size;
f5d44ba0
AM
398
399 /* A linked list of BFD's loaded in the link. */
400 struct elf_link_loaded_list *loaded;
252b5132
RH
401};
402
403/* Look up an entry in an ELF linker hash table. */
404
405#define elf_link_hash_lookup(table, string, create, copy, follow) \
406 ((struct elf_link_hash_entry *) \
407 bfd_link_hash_lookup (&(table)->root, (string), (create), \
408 (copy), (follow)))
409
410/* Traverse an ELF linker hash table. */
411
412#define elf_link_hash_traverse(table, func, info) \
413 (bfd_link_hash_traverse \
414 (&(table)->root, \
c39a58e6 415 (bfd_boolean (*) (struct bfd_link_hash_entry *, void *)) (func), \
252b5132
RH
416 (info)))
417
418/* Get the ELF linker hash table from a link_info structure. */
419
420#define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash))
8ea2e4bd 421
b34976b6 422/* Returns TRUE if the hash table is a struct elf_link_hash_table. */
0eddce27
AM
423#define is_elf_hash_table(htab) \
424 (((struct bfd_link_hash_table *) (htab))->type == bfd_link_elf_hash_table)
ec338859
AM
425
426/* Used by bfd_section_from_r_symndx to cache a small number of local
427 symbol to section mappings. */
428#define LOCAL_SYM_CACHE_SIZE 32
429struct sym_sec_cache
430{
431 bfd *abfd;
432 unsigned long indx[LOCAL_SYM_CACHE_SIZE];
433 asection *sec[LOCAL_SYM_CACHE_SIZE];
434};
252b5132
RH
435\f
436/* Constant information held for an ELF backend. */
437
438struct elf_size_info {
439 unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr;
440 unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note;
441
c7ac6ff8
MM
442 /* The size of entries in the .hash section. */
443 unsigned char sizeof_hash_entry;
444
445 /* The number of internal relocations to allocate per external
446 relocation entry. */
447 unsigned char int_rels_per_ext_rel;
947216bf
AM
448 /* We use some fixed size arrays. This should be large enough to
449 handle all back-ends. */
450#define MAX_INT_RELS_PER_EXT_REL 3
c7ac6ff8 451
45d6a902 452 unsigned char arch_size, log_file_align;
252b5132 453 unsigned char elfclass, ev_current;
dc810e39 454 int (*write_out_phdrs)
c39a58e6
AM
455 (bfd *, const Elf_Internal_Phdr *, unsigned int);
456 bfd_boolean
457 (*write_shdrs_and_ehdr) (bfd *);
dc810e39 458 void (*write_relocs)
c39a58e6 459 (bfd *, asection *, void *);
73ff0d56 460 void (*swap_symbol_in)
c39a58e6 461 (bfd *, const void *, const void *, Elf_Internal_Sym *);
dc810e39 462 void (*swap_symbol_out)
c39a58e6 463 (bfd *, const Elf_Internal_Sym *, void *, void *);
b34976b6 464 bfd_boolean (*slurp_reloc_table)
c39a58e6 465 (bfd *, asection *, asymbol **, bfd_boolean);
dc810e39 466 long (*slurp_symbol_table)
c39a58e6 467 (bfd *, asymbol **, bfd_boolean);
dc810e39 468 void (*swap_dyn_in)
c39a58e6 469 (bfd *, const void *, Elf_Internal_Dyn *);
dc810e39 470 void (*swap_dyn_out)
c39a58e6 471 (bfd *, const Elf_Internal_Dyn *, void *);
c7ac6ff8 472
947216bf
AM
473 /* This function is called to swap in a REL relocation. If an
474 external relocation corresponds to more than one internal
475 relocation, then all relocations are swapped in at once. */
c7ac6ff8 476 void (*swap_reloc_in)
c39a58e6 477 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
c7ac6ff8 478
947216bf 479 /* This function is called to swap out a REL relocation. */
c7ac6ff8 480 void (*swap_reloc_out)
c39a58e6 481 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
c7ac6ff8 482
947216bf
AM
483 /* This function is called to swap in a RELA relocation. If an
484 external relocation corresponds to more than one internal
485 relocation, then all relocations are swapped in at once. */
c7ac6ff8 486 void (*swap_reloca_in)
c39a58e6 487 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
c7ac6ff8 488
947216bf 489 /* This function is called to swap out a RELA relocation. */
c7ac6ff8 490 void (*swap_reloca_out)
c39a58e6 491 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
252b5132
RH
492};
493
494#define elf_symbol_from(ABFD,S) \
495 (((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \
496 && (S)->the_bfd->tdata.elf_obj_data != 0) \
497 ? (elf_symbol_type *) (S) \
498 : 0)
499
db6751f2
JJ
500enum elf_reloc_type_class {
501 reloc_class_normal,
502 reloc_class_relative,
503 reloc_class_plt,
504 reloc_class_copy
505};
506
73d074b4
DJ
507struct elf_reloc_cookie
508{
509 Elf_Internal_Rela *rels, *rel, *relend;
6cdc0ccc 510 Elf_Internal_Sym *locsyms;
73d074b4
DJ
511 bfd *abfd;
512 size_t locsymcount;
513 size_t extsymoff;
514 struct elf_link_hash_entry **sym_hashes;
140f6c8e 515 int r_sym_shift;
b34976b6 516 bfd_boolean bad_symtab;
73d074b4
DJ
517};
518
c6e90b02
TS
519/* The level of IRIX compatibility we're striving for. */
520
521typedef enum {
522 ict_none,
523 ict_irix5,
524 ict_irix6
525} irix_compat_t;
526
2f89ff8d
L
527/* Mapping of ELF section names and types. */
528struct bfd_elf_special_section
529{
530 const char *prefix;
7dcb9820
AM
531 int prefix_length;
532 /* 0 means name must match PREFIX exactly.
533 -1 means name must start with PREFIX followed by an arbitrary string.
534 -2 means name must match PREFIX exactly or consist of PREFIX followed
535 by a dot then anything.
536 > 0 means name must start with the first PREFIX_LENGTH chars of
537 PREFIX and finish with the last SUFFIX_LENGTH chars of PREFIX. */
538 int suffix_length;
2f89ff8d 539 int type;
7dcb9820 540 int attr;
2f89ff8d
L
541};
542
252b5132
RH
543struct elf_backend_data
544{
252b5132
RH
545 /* The architecture for this backend. */
546 enum bfd_architecture arch;
547
548 /* The ELF machine code (EM_xxxx) for this backend. */
549 int elf_machine_code;
550
551 /* The maximum page size for this backend. */
552 bfd_vma maxpagesize;
553
e5a52504
MM
554 /* The BFD flags applied to sections created for dynamic linking. */
555 flagword dynamic_sec_flags;
556
252b5132
RH
557 /* A function to translate an ELF RELA relocation to a BFD arelent
558 structure. */
dc810e39 559 void (*elf_info_to_howto)
c39a58e6 560 (bfd *, arelent *, Elf_Internal_Rela *);
252b5132
RH
561
562 /* A function to translate an ELF REL relocation to a BFD arelent
563 structure. */
dc810e39 564 void (*elf_info_to_howto_rel)
c39a58e6 565 (bfd *, arelent *, Elf_Internal_Rela *);
252b5132
RH
566
567 /* A function to determine whether a symbol is global when
568 partitioning the symbol table into local and global symbols.
569 This should be NULL for most targets, in which case the correct
570 thing will be done. MIPS ELF, at least on the Irix 5, has
571 special requirements. */
b34976b6 572 bfd_boolean (*elf_backend_sym_is_global)
c39a58e6 573 (bfd *, asymbol *);
252b5132
RH
574
575 /* The remaining functions are hooks which are called only if they
576 are not NULL. */
577
578 /* A function to permit a backend specific check on whether a
579 particular BFD format is relevant for an object file, and to
580 permit the backend to set any global information it wishes. When
581 this is called elf_elfheader is set, but anything else should be
b34976b6 582 used with caution. If this returns FALSE, the check_format
252b5132 583 routine will return a bfd_error_wrong_format error. */
b34976b6 584 bfd_boolean (*elf_backend_object_p)
c39a58e6 585 (bfd *);
252b5132
RH
586
587 /* A function to do additional symbol processing when reading the
588 ELF symbol table. This is where any processor-specific special
589 section indices are handled. */
dc810e39 590 void (*elf_backend_symbol_processing)
c39a58e6 591 (bfd *, asymbol *);
252b5132
RH
592
593 /* A function to do additional symbol processing after reading the
594 entire ELF symbol table. */
b34976b6 595 bfd_boolean (*elf_backend_symbol_table_processing)
c39a58e6 596 (bfd *, elf_symbol_type *, unsigned int);
252b5132 597
8387904d 598 /* A function to set the type of the info field. Processor-specific
3e932841 599 types should be handled here. */
dc810e39 600 int (*elf_backend_get_symbol_type)
c39a58e6 601 (Elf_Internal_Sym *, int);
60bcf0fa 602
8387904d
AM
603 /* A function to return the linker hash table entry of a symbol that
604 might be satisfied by an archive symbol. */
605 struct elf_link_hash_entry * (*elf_backend_archive_symbol_lookup)
606 (bfd *, struct bfd_link_info *, const char *);
607
174fd7f9
RS
608 /* Return true if local section symbols should have a non-null st_name.
609 NULL implies false. */
610 bfd_boolean (*elf_backend_name_local_section_symbols)
611 (bfd *);
612
252b5132
RH
613 /* A function to do additional processing on the ELF section header
614 just before writing it out. This is used to set the flags and
615 type fields for some sections, or to actually write out data for
616 unusual sections. */
b34976b6 617 bfd_boolean (*elf_backend_section_processing)
c39a58e6 618 (bfd *, Elf_Internal_Shdr *);
252b5132
RH
619
620 /* A function to handle unusual section types when creating BFD
621 sections from ELF sections. */
b34976b6 622 bfd_boolean (*elf_backend_section_from_shdr)
c39a58e6 623 (bfd *, Elf_Internal_Shdr *, const char *);
252b5132 624
fa152c49
JW
625 /* A function to convert machine dependent section header flags to
626 BFD internal section header flags. */
b34976b6 627 bfd_boolean (*elf_backend_section_flags)
1829f4b2 628 (flagword *, const Elf_Internal_Shdr *);
fa152c49 629
20cfcaae 630 /* A function to handle unusual program segment types when creating BFD
3e932841 631 sections from ELF program segments. */
b34976b6 632 bfd_boolean (*elf_backend_section_from_phdr)
c39a58e6 633 (bfd *, Elf_Internal_Phdr *, int);
20cfcaae 634
252b5132
RH
635 /* A function to set up the ELF section header for a BFD section in
636 preparation for writing it out. This is where the flags and type
637 fields are set for unusual sections. */
b34976b6 638 bfd_boolean (*elf_backend_fake_sections)
c39a58e6 639 (bfd *, Elf_Internal_Shdr *, asection *);
252b5132
RH
640
641 /* A function to get the ELF section index for a BFD section. If
b34976b6 642 this returns TRUE, the section was found. If it is a normal ELF
252b5132
RH
643 section, *RETVAL should be left unchanged. If it is not a normal
644 ELF section *RETVAL should be set to the SHN_xxxx index. */
b34976b6 645 bfd_boolean (*elf_backend_section_from_bfd_section)
c39a58e6 646 (bfd *, asection *, int *retval);
252b5132
RH
647
648 /* If this field is not NULL, it is called by the add_symbols phase
649 of a link just before adding a symbol to the global linker hash
650 table. It may modify any of the fields as it wishes. If *NAME
651 is set to NULL, the symbol will be skipped rather than being
652 added to the hash table. This function is responsible for
653 handling all processor dependent symbol bindings and section
654 indices, and must set at least *FLAGS and *SEC for each processor
655 dependent case; failure to do so will cause a link error. */
b34976b6 656 bfd_boolean (*elf_add_symbol_hook)
555cd476 657 (bfd *abfd, struct bfd_link_info *info, Elf_Internal_Sym *,
c39a58e6 658 const char **name, flagword *flags, asection **sec, bfd_vma *value);
252b5132
RH
659
660 /* If this field is not NULL, it is called by the elf_link_output_sym
661 phase of a link for each symbol which will appear in the object file. */
b34976b6 662 bfd_boolean (*elf_backend_link_output_symbol_hook)
754021d0
AM
663 (struct bfd_link_info *info, const char *, Elf_Internal_Sym *,
664 asection *, struct elf_link_hash_entry *);
252b5132
RH
665
666 /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend
667 linker the first time it encounters a dynamic object in the link.
668 This function must create any sections required for dynamic
669 linking. The ABFD argument is a dynamic object. The .interp,
670 .dynamic, .dynsym, .dynstr, and .hash functions have already been
671 created, and this function may modify the section flags if
672 desired. This function will normally create the .got and .plt
673 sections, but different backends have different requirements. */
b34976b6 674 bfd_boolean (*elf_backend_create_dynamic_sections)
c39a58e6 675 (bfd *abfd, struct bfd_link_info *info);
252b5132 676
aee6f5b4
AO
677 /* When creating a shared library, determine whether to omit the
678 dynamic symbol for the section. */
679 bfd_boolean (*elf_backend_omit_section_dynsym)
680 (bfd *output_bfd, struct bfd_link_info *info, asection *osec);
681
252b5132
RH
682 /* The CHECK_RELOCS function is called by the add_symbols phase of
683 the ELF backend linker. It is called once for each section with
684 relocs of an object file, just after the symbols for the object
685 file have been added to the global linker hash table. The
686 function must look through the relocs and do any special handling
687 required. This generally means allocating space in the global
688 offset table, and perhaps allocating space for a reloc. The
689 relocs are always passed as Rela structures; if the section
690 actually uses Rel structures, the r_addend field will always be
691 zero. */
b34976b6 692 bfd_boolean (*check_relocs)
c39a58e6
AM
693 (bfd *abfd, struct bfd_link_info *info, asection *o,
694 const Elf_Internal_Rela *relocs);
252b5132 695
85fbca6a
NC
696 /* The CHECK_DIRECTIVES function is called once per input file by
697 the add_symbols phase of the ELF backend linker. The function
698 must inspect the bfd and create any additional symbols according
699 to any custom directives in the bfd. */
700 bfd_boolean (*check_directives)
701 (bfd *abfd, struct bfd_link_info *info);
702
252b5132
RH
703 /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend
704 linker for every symbol which is defined by a dynamic object and
705 referenced by a regular object. This is called after all the
706 input files have been seen, but before the SIZE_DYNAMIC_SECTIONS
707 function has been called. The hash table entry should be
708 bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be
709 defined in a section from a dynamic object. Dynamic object
710 sections are not included in the final link, and this function is
711 responsible for changing the value to something which the rest of
712 the link can deal with. This will normally involve adding an
713 entry to the .plt or .got or some such section, and setting the
714 symbol to point to that. */
b34976b6 715 bfd_boolean (*elf_backend_adjust_dynamic_symbol)
c39a58e6 716 (struct bfd_link_info *info, struct elf_link_hash_entry *h);
252b5132
RH
717
718 /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker
719 after all the linker input files have been seen but before the
720 section sizes have been set. This is called after
721 ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS. */
b34976b6 722 bfd_boolean (*elf_backend_always_size_sections)
c39a58e6 723 (bfd *output_bfd, struct bfd_link_info *info);
252b5132
RH
724
725 /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend
726 linker after all the linker input files have been seen but before
727 the sections sizes have been set. This is called after
728 ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols.
729 It is only called when linking against a dynamic object. It must
730 set the sizes of the dynamic sections, and may fill in their
731 contents as well. The generic ELF linker can handle the .dynsym,
732 .dynstr and .hash sections. This function must handle the
733 .interp section and any sections created by the
734 CREATE_DYNAMIC_SECTIONS entry point. */
b34976b6 735 bfd_boolean (*elf_backend_size_dynamic_sections)
c39a58e6 736 (bfd *output_bfd, struct bfd_link_info *info);
252b5132
RH
737
738 /* The RELOCATE_SECTION function is called by the ELF backend linker
739 to handle the relocations for a section.
740
741 The relocs are always passed as Rela structures; if the section
742 actually uses Rel structures, the r_addend field will always be
743 zero.
744
745 This function is responsible for adjust the section contents as
746 necessary, and (if using Rela relocs and generating a
1049f94e 747 relocatable output file) adjusting the reloc addend as
252b5132
RH
748 necessary.
749
750 This function does not have to worry about setting the reloc
751 address or the reloc symbol index.
752
753 LOCAL_SYMS is a pointer to the swapped in local symbols.
754
755 LOCAL_SECTIONS is an array giving the section in the input file
756 corresponding to the st_shndx field of each local symbol.
757
758 The global hash table entry for the global symbols can be found
759 via elf_sym_hashes (input_bfd).
760
1049f94e 761 When generating relocatable output, this function must handle
252b5132
RH
762 STB_LOCAL/STT_SECTION symbols specially. The output symbol is
763 going to be the section symbol corresponding to the output
764 section, which means that the addend must be adjusted
765 accordingly. */
b34976b6 766 bfd_boolean (*elf_backend_relocate_section)
c39a58e6
AM
767 (bfd *output_bfd, struct bfd_link_info *info, bfd *input_bfd,
768 asection *input_section, bfd_byte *contents, Elf_Internal_Rela *relocs,
769 Elf_Internal_Sym *local_syms, asection **local_sections);
252b5132
RH
770
771 /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend
772 linker just before it writes a symbol out to the .dynsym section.
773 The processor backend may make any required adjustment to the
774 symbol. It may also take the opportunity to set contents of the
775 dynamic sections. Note that FINISH_DYNAMIC_SYMBOL is called on
776 all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called
777 on those symbols which are defined by a dynamic object. */
b34976b6 778 bfd_boolean (*elf_backend_finish_dynamic_symbol)
c39a58e6
AM
779 (bfd *output_bfd, struct bfd_link_info *info,
780 struct elf_link_hash_entry *h, Elf_Internal_Sym *sym);
252b5132
RH
781
782 /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend
783 linker just before it writes all the dynamic sections out to the
784 output file. The FINISH_DYNAMIC_SYMBOL will have been called on
785 all dynamic symbols. */
b34976b6 786 bfd_boolean (*elf_backend_finish_dynamic_sections)
c39a58e6 787 (bfd *output_bfd, struct bfd_link_info *info);
252b5132
RH
788
789 /* A function to do any beginning processing needed for the ELF file
790 before building the ELF headers and computing file positions. */
791 void (*elf_backend_begin_write_processing)
c39a58e6 792 (bfd *, struct bfd_link_info *);
252b5132
RH
793
794 /* A function to do any final processing needed for the ELF file
b34976b6 795 before writing it out. The LINKER argument is TRUE if this BFD
252b5132
RH
796 was created by the ELF backend linker. */
797 void (*elf_backend_final_write_processing)
c39a58e6 798 (bfd *, bfd_boolean linker);
252b5132
RH
799
800 /* This function is called by get_program_header_size. It should
801 return the number of additional program segments which this BFD
802 will need. It should return -1 on error. */
dc810e39 803 int (*elf_backend_additional_program_headers)
c39a58e6 804 (bfd *);
252b5132
RH
805
806 /* This function is called to modify an existing segment map in a
807 backend specific fashion. */
b34976b6 808 bfd_boolean (*elf_backend_modify_segment_map)
c84fca4d 809 (bfd *, struct bfd_link_info *);
252b5132
RH
810
811 /* This function is called during section gc to discover the section a
1e2f5b6e 812 particular relocation refers to. */
252b5132 813 asection * (*gc_mark_hook)
c39a58e6
AM
814 (asection *sec, struct bfd_link_info *, Elf_Internal_Rela *,
815 struct elf_link_hash_entry *h, Elf_Internal_Sym *);
252b5132
RH
816
817 /* This function, if defined, is called during the sweep phase of gc
818 in order that a backend might update any data structures it might
819 be maintaining. */
b34976b6 820 bfd_boolean (*gc_sweep_hook)
c39a58e6
AM
821 (bfd *abfd, struct bfd_link_info *info, asection *o,
822 const Elf_Internal_Rela *relocs);
252b5132 823
e6c51ed4
NC
824 /* This function, if defined, is called after the ELF headers have
825 been created. This allows for things like the OS and ABI versions
826 to be changed. */
827 void (*elf_backend_post_process_headers)
c39a58e6 828 (bfd *, struct bfd_link_info *);
e6c51ed4 829
587ff49e
RH
830 /* This function, if defined, prints a symbol to file and returns the
831 name of the symbol to be printed. It should return NULL to fall
832 back to default symbol printing. */
833 const char *(*elf_backend_print_symbol_all)
c39a58e6 834 (bfd *, void *, asymbol *);
587ff49e
RH
835
836 /* This function, if defined, is called after all local symbols and
4cc11e76 837 global symbols converted to locals are emitted into the symtab
587ff49e
RH
838 section. It allows the backend to emit special global symbols
839 not handled in the hash table. */
b34976b6 840 bfd_boolean (*elf_backend_output_arch_syms)
c39a58e6 841 (bfd *, struct bfd_link_info *, void *,
754021d0
AM
842 bfd_boolean (*) (void *, const char *, Elf_Internal_Sym *, asection *,
843 struct elf_link_hash_entry *));
587ff49e 844
d4c88bbb 845 /* Copy any information related to dynamic linking from a pre-existing
0a991dfe
AM
846 symbol to a newly created symbol. Also called to copy flags and
847 other back-end info to a weakdef, in which case the symbol is not
848 newly created and plt/got refcounts and dynamic indices should not
849 be copied. */
c61b8717 850 void (*elf_backend_copy_indirect_symbol)
9c5bfbb7 851 (const struct elf_backend_data *, struct elf_link_hash_entry *,
c39a58e6 852 struct elf_link_hash_entry *);
c61b8717
RH
853
854 /* Modify any information related to dynamic linking such that the
855 symbol is not exported. */
856 void (*elf_backend_hide_symbol)
c39a58e6 857 (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
c61b8717 858
9bf7216d
KK
859 /* Merge the backend specific symbol attribute. */
860 void (*elf_backend_merge_symbol_attribute)
861 (struct elf_link_hash_entry *, const Elf_Internal_Sym *, bfd_boolean,
862 bfd_boolean);
863
9317eacc
CM
864 /* Emit relocations. Overrides default routine for emitting relocs,
865 except during a relocatable link, or if all relocs are being emitted. */
b34976b6 866 bfd_boolean (*elf_backend_emit_relocs)
c39a58e6 867 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *);
9317eacc
CM
868
869 /* Count relocations. Not called for relocatable links
870 or if all relocs are being preserved in the output. */
871 unsigned int (*elf_backend_count_relocs)
c39a58e6 872 (asection *, Elf_Internal_Rela *);
9317eacc 873
bb0082d6
AM
874 /* This function, if defined, is called when an NT_PRSTATUS note is found
875 in a core file. */
b34976b6 876 bfd_boolean (*elf_backend_grok_prstatus)
c39a58e6 877 (bfd *, Elf_Internal_Note *);
bb0082d6
AM
878
879 /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO
880 note is found in a core file. */
b34976b6 881 bfd_boolean (*elf_backend_grok_psinfo)
c39a58e6 882 (bfd *, Elf_Internal_Note *);
bb0082d6 883
db6751f2 884 /* Functions to print VMAs. Special code to handle 64 bit ELF files. */
dc810e39 885 void (* elf_backend_sprintf_vma)
c39a58e6 886 (bfd *, char *, bfd_vma);
dc810e39 887 void (* elf_backend_fprintf_vma)
c39a58e6 888 (bfd *, void *, bfd_vma);
4e771d61 889
db6751f2 890 /* This function returns class of a reloc type. */
f51e552e 891 enum elf_reloc_type_class (*elf_backend_reloc_type_class)
c39a58e6 892 (const Elf_Internal_Rela *);
db6751f2 893
73d074b4
DJ
894 /* This function, if defined, removes information about discarded functions
895 from other sections which mention them. */
b34976b6 896 bfd_boolean (*elf_backend_discard_info)
c39a58e6 897 (bfd *, struct elf_reloc_cookie *, struct bfd_link_info *);
73d074b4
DJ
898
899 /* This function, if defined, signals that the function above has removed
900 the discarded relocations for this section. */
b34976b6 901 bfd_boolean (*elf_backend_ignore_discarded_relocs)
c39a58e6 902 (asection *);
73d074b4 903
ec3391e7
AO
904 /* These functions tell elf-eh-frame whether to attempt to turn
905 absolute or lsda encodings into pc-relative ones. The default
906 definition enables these transformations. */
907 bfd_boolean (*elf_backend_can_make_relative_eh_frame)
908 (bfd *, struct bfd_link_info *, asection *);
909 bfd_boolean (*elf_backend_can_make_lsda_relative_eh_frame)
910 (bfd *, struct bfd_link_info *, asection *);
911
912 /* This function returns an encoding after computing the encoded
913 value (and storing it in ENCODED) for the given OFFSET into OSEC,
914 to be stored in at LOC_OFFSET into the LOC_SEC input section.
915 The default definition chooses a 32-bit PC-relative encoding. */
916 bfd_byte (*elf_backend_encode_eh_address)
917 (bfd *abfd, struct bfd_link_info *info,
918 asection *osec, bfd_vma offset,
919 asection *loc_sec, bfd_vma loc_offset,
920 bfd_vma *encoded);
921
73d074b4 922 /* This function, if defined, may write out the given section.
b34976b6
AM
923 Returns TRUE if it did so and FALSE if the caller should. */
924 bfd_boolean (*elf_backend_write_section)
c39a58e6 925 (bfd *, asection *, bfd_byte *);
73d074b4 926
c6e90b02
TS
927 /* The level of IRIX compatibility we're striving for.
928 MIPS ELF specific function. */
929 irix_compat_t (*elf_backend_mips_irix_compat)
c39a58e6 930 (bfd *);
c6e90b02
TS
931
932 reloc_howto_type *(*elf_backend_mips_rtype_to_howto)
c39a58e6 933 (unsigned int, bfd_boolean);
c6e90b02 934
252b5132
RH
935 /* The swapping table to use when dealing with ECOFF information.
936 Used for the MIPS ELF .mdebug section. */
937 const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap;
938
8d6337fe
RM
939 /* This function implements `bfd_elf_bfd_from_remote_memory';
940 see elf.c, elfcode.h. */
941 bfd *(*elf_backend_bfd_from_remote_memory)
c39a58e6
AM
942 (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
943 int (*target_read_memory) (bfd_vma vma, char *myaddr, int len));
8d6337fe 944
4c45e5c9
JJ
945 /* This function is used by `_bfd_elf_get_synthetic_symtab';
946 see elf.c. */
947 bfd_vma (*plt_sym_val) (bfd_vma, const asection *, const arelent *);
948
185d09ad
L
949 /* Used to handle bad SHF_LINK_ORDER input. */
950 bfd_error_handler_type link_order_error_handler;
951
4c45e5c9
JJ
952 /* Name of the PLT relocation section. */
953 const char *relplt_name;
954
252b5132
RH
955 /* Alternate EM_xxxx machine codes for this backend. */
956 int elf_machine_alt1;
957 int elf_machine_alt2;
958
959 const struct elf_size_info *s;
960
2f89ff8d
L
961 /* An array of target specific special section map. */
962 const struct bfd_elf_special_section *special_sections;
963
252b5132
RH
964 /* offset of the _GLOBAL_OFFSET_TABLE_ symbol from the start of the
965 .got section */
966 bfd_vma got_symbol_offset;
967
6f2f2c9d
DJ
968 /* The size in bytes of the header for the GOT. This includes the
969 so-called reserved entries on some systems. */
252b5132 970 bfd_vma got_header_size;
252b5132 971
b34976b6
AM
972 /* This is TRUE if the linker should act like collect and gather
973 global constructors and destructors by name. This is TRUE for
86dc0f79
RH
974 MIPS ELF because the Irix 5 tools can not handle the .init
975 section. */
976 unsigned collect : 1;
977
b34976b6
AM
978 /* This is TRUE if the linker should ignore changes to the type of a
979 symbol. This is TRUE for MIPS ELF because some Irix 5 objects
86dc0f79
RH
980 record undefined functions as STT_OBJECT although the definitions
981 are STT_FUNC. */
982 unsigned type_change_ok : 1;
983
bf572ba0
MM
984 /* Whether the backend may use REL relocations. (Some backends use
985 both REL and RELA relocations, and this flag is set for those
986 backends.) */
987 unsigned may_use_rel_p : 1;
60bcf0fa 988
bf572ba0
MM
989 /* Whether the backend may use RELA relocations. (Some backends use
990 both REL and RELA relocations, and this flag is set for those
991 backends.) */
992 unsigned may_use_rela_p : 1;
993
994 /* Whether the default relocation type is RELA. If a backend with
995 this flag set wants REL relocations for a particular section,
996 it must note that explicitly. Similarly, if this flag is clear,
60bcf0fa
NC
997 and the backend wants RELA relocations for a particular
998 section. */
bf572ba0
MM
999 unsigned default_use_rela_p : 1;
1000
b491616a
AM
1001 /* Set if RELA relocations for a relocatable link can be handled by
1002 generic code. Backends that set this flag need do nothing in the
1003 backend relocate_section routine for relocatable linking. */
1004 unsigned rela_normal : 1;
1005
b34976b6 1006 /* TRUE if addresses "naturally" sign extend. This is used when
86dc0f79
RH
1007 swapping in from Elf32 when BFD64. */
1008 unsigned sign_extend_vma : 1;
1009
252b5132
RH
1010 unsigned want_got_plt : 1;
1011 unsigned plt_readonly : 1;
1012 unsigned want_plt_sym : 1;
1013 unsigned plt_not_loaded : 1;
1014 unsigned plt_alignment : 4;
1015 unsigned can_gc_sections : 1;
51b64d56 1016 unsigned can_refcount : 1;
2517a57f 1017 unsigned want_got_sym : 1;
3018b441 1018 unsigned want_dynbss : 1;
5e8d7549
NC
1019 /* Targets which do not support physical addressing often require
1020 that the p_paddr field in the section header to be set to zero.
1021 This field indicates whether this behavior is required. */
1022 unsigned want_p_paddr_set_to_zero : 1;
252b5132
RH
1023};
1024
1025/* Information stored for each BFD section in an ELF file. This
1026 structure is allocated by elf_new_section_hook. */
1027
1028struct bfd_elf_section_data
1029{
1030 /* The ELF header for this section. */
1031 Elf_Internal_Shdr this_hdr;
0c715baa 1032
252b5132
RH
1033 /* The ELF header for the reloc section associated with this
1034 section, if any. */
1035 Elf_Internal_Shdr rel_hdr;
0c715baa 1036
252b5132
RH
1037 /* If there is a second reloc section associated with this section,
1038 as can happen on Irix 6, this field points to the header. */
1039 Elf_Internal_Shdr *rel_hdr2;
0c715baa 1040
23bc299b
MM
1041 /* The number of relocations currently assigned to REL_HDR. */
1042 unsigned int rel_count;
0c715baa 1043
23bc299b
MM
1044 /* The number of relocations currently assigned to REL_HDR2. */
1045 unsigned int rel_count2;
0c715baa 1046
252b5132
RH
1047 /* The ELF section number of this section. Only used for an output
1048 file. */
1049 int this_idx;
0c715baa 1050
23bc299b
MM
1051 /* The ELF section number of the reloc section indicated by
1052 REL_HDR if any. Only used for an output file. */
252b5132 1053 int rel_idx;
0c715baa 1054
23bc299b
MM
1055 /* The ELF section number of the reloc section indicated by
1056 REL_HDR2 if any. Only used for an output file. */
1057 int rel_idx2;
0c715baa 1058
f0abc2a1
AM
1059 /* Used by the backend linker when generating a shared library to
1060 record the dynamic symbol index for a section symbol
1061 corresponding to this section. A value of 0 means that there is
1062 no dynamic symbol for this section. */
1063 int dynindx;
1064
38ce5b11
L
1065 /* A pointer to the linked-to section for SHF_LINK_ORDER. */
1066 asection *linked_to;
1067
252b5132
RH
1068 /* Used by the backend linker to store the symbol hash table entries
1069 associated with relocs against global symbols. */
1070 struct elf_link_hash_entry **rel_hashes;
0c715baa 1071
252b5132
RH
1072 /* A pointer to the swapped relocs. If the section uses REL relocs,
1073 rather than RELA, all the r_addend fields will be zero. This
1074 pointer may be NULL. It is used by the backend linker. */
1075 Elf_Internal_Rela *relocs;
0c715baa 1076
f0abc2a1
AM
1077 /* A pointer to a linked list tracking dynamic relocs copied for
1078 local symbols. */
c39a58e6 1079 void *local_dynrel;
0c715baa 1080
f0abc2a1
AM
1081 /* A pointer to the bfd section used for dynamic relocs. */
1082 asection *sreloc;
0c715baa 1083
1126897b
AM
1084 union {
1085 /* Group name, if this section is a member of a group. */
1086 const char *name;
1087
1088 /* Group signature sym, if this is the SHT_GROUP section. */
fc0a2244 1089 struct bfd_symbol *id;
1126897b 1090 } group;
dbb410c3 1091
3d7f7666
L
1092 /* Optional information about section group; NULL if it doesn't
1093 belongs to any section group. */
1094 asection *sec_group;
1095
dbb410c3
AM
1096 /* A linked list of sections in the group. Circular when used by
1097 the linker. */
1098 asection *next_in_group;
1099
f0abc2a1 1100 /* A pointer used for various section optimizations. */
c39a58e6 1101 void *sec_info;
252b5132
RH
1102};
1103
1104#define elf_section_data(sec) ((struct bfd_elf_section_data*)sec->used_by_bfd)
38ce5b11 1105#define elf_linked_to_section(sec) (elf_section_data(sec)->linked_to)
2f89ff8d
L
1106#define elf_section_type(sec) (elf_section_data(sec)->this_hdr.sh_type)
1107#define elf_section_flags(sec) (elf_section_data(sec)->this_hdr.sh_flags)
1126897b
AM
1108#define elf_group_name(sec) (elf_section_data(sec)->group.name)
1109#define elf_group_id(sec) (elf_section_data(sec)->group.id)
945906ff 1110#define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group)
3d7f7666 1111#define elf_sec_group(sec) (elf_section_data(sec)->sec_group)
252b5132 1112
b34976b6 1113/* Return TRUE if section has been discarded. */
68bfbfcc
AM
1114#define elf_discarded_section(sec) \
1115 (!bfd_is_abs_section (sec) \
1116 && bfd_is_abs_section ((sec)->output_section) \
cdd3575c
AM
1117 && (sec)->sec_info_type != ELF_INFO_TYPE_MERGE \
1118 && (sec)->sec_info_type != ELF_INFO_TYPE_JUST_SYMS)
ed4de5e2 1119
252b5132 1120#define get_elf_backend_data(abfd) \
9c5bfbb7 1121 ((const struct elf_backend_data *) (abfd)->xvec->backend_data)
252b5132 1122
45d6a902
AM
1123/* This struct is used to pass information to routines called via
1124 elf_link_hash_traverse which must return failure. */
1125
1126struct elf_info_failed
1127{
1128 bfd_boolean failed;
1129 struct bfd_link_info *info;
1130 struct bfd_elf_version_tree *verdefs;
1131};
1132
1133/* This structure is used to pass information to
1134 _bfd_elf_link_assign_sym_version. */
1135
1136struct elf_assign_sym_version_info
1137{
1138 /* Output BFD. */
1139 bfd *output_bfd;
1140 /* General link information. */
1141 struct bfd_link_info *info;
1142 /* Version tree. */
1143 struct bfd_elf_version_tree *verdefs;
1144 /* Whether we had a failure. */
1145 bfd_boolean failed;
1146};
1147
1148/* This structure is used to pass information to
1149 _bfd_elf_link_find_version_dependencies. */
1150
1151struct elf_find_verdep_info
1152{
1153 /* Output BFD. */
1154 bfd *output_bfd;
1155 /* General link information. */
1156 struct bfd_link_info *info;
1157 /* The number of dependencies. */
1158 unsigned int vers;
1159 /* Whether we had a failure. */
1160 bfd_boolean failed;
1161};
1162
252b5132
RH
1163/* Some private data is stashed away for future use using the tdata pointer
1164 in the bfd structure. */
1165
1166struct elf_obj_tdata
1167{
1168 Elf_Internal_Ehdr elf_header[1]; /* Actual data, but ref like ptr */
1169 Elf_Internal_Shdr **elf_sect_ptr;
1170 Elf_Internal_Phdr *phdr;
1171 struct elf_segment_map *segment_map;
2b0f7ef9 1172 struct elf_strtab_hash *strtab_ptr;
252b5132
RH
1173 int num_locals;
1174 int num_globals;
9ad5cbcf 1175 unsigned int num_elf_sections; /* elf_sect_ptr size */
4e89ac30 1176 int num_section_syms;
252b5132
RH
1177 asymbol **section_syms; /* STT_SECTION symbols for each section */
1178 Elf_Internal_Shdr symtab_hdr;
1179 Elf_Internal_Shdr shstrtab_hdr;
1180 Elf_Internal_Shdr strtab_hdr;
1181 Elf_Internal_Shdr dynsymtab_hdr;
1182 Elf_Internal_Shdr dynstrtab_hdr;
1183 Elf_Internal_Shdr dynversym_hdr;
1184 Elf_Internal_Shdr dynverref_hdr;
1185 Elf_Internal_Shdr dynverdef_hdr;
9ad5cbcf 1186 Elf_Internal_Shdr symtab_shndx_hdr;
252b5132
RH
1187 unsigned int symtab_section, shstrtab_section;
1188 unsigned int strtab_section, dynsymtab_section;
9ad5cbcf 1189 unsigned int symtab_shndx_section;
252b5132
RH
1190 unsigned int dynversym_section, dynverdef_section, dynverref_section;
1191 file_ptr next_file_pos;
dbb410c3
AM
1192 bfd_vma gp; /* The gp value */
1193 unsigned int gp_size; /* The gp size */
1194
3e932841 1195 /* Information grabbed from an elf core file. */
252b5132
RH
1196 int core_signal;
1197 int core_pid;
1198 int core_lwpid;
1199 char* core_program;
1200 char* core_command;
1201
252b5132
RH
1202 /* A mapping from external symbols to entries in the linker hash
1203 table, used when linking. This is indexed by the symbol index
1204 minus the sh_info field of the symbol table header. */
1205 struct elf_link_hash_entry **sym_hashes;
1206
5cab59f6
AM
1207 /* Track usage and final offsets of GOT entries for local symbols.
1208 This array is indexed by symbol index. Elements are used
1209 identically to "got" in struct elf_link_hash_entry. */
252b5132
RH
1210 union
1211 {
1212 bfd_signed_vma *refcounts;
1213 bfd_vma *offsets;
5cab59f6 1214 struct got_entry **ents;
252b5132
RH
1215 } local_got;
1216
252b5132
RH
1217 /* The linker ELF emulation code needs to let the backend ELF linker
1218 know what filename should be used for a dynamic object if the
1219 dynamic object is found using a search. The emulation code then
1220 sometimes needs to know what name was actually used. Until the
1221 file has been added to the linker symbol table, this field holds
1222 the name the linker wants. After it has been added, it holds the
1223 name actually used, which will be the DT_SONAME entry if there is
1224 one. */
1225 const char *dt_name;
1226
252b5132
RH
1227 /* Records the result of `get_program_header_size'. */
1228 bfd_size_type program_header_size;
1229
1230 /* Used by find_nearest_line entry point. */
c39a58e6 1231 void *line_info;
252b5132
RH
1232
1233 /* Used by MIPS ELF find_nearest_line entry point. The structure
1234 could be included directly in this one, but there's no point to
1235 wasting the memory just for the infrequently called
1236 find_nearest_line. */
1237 struct mips_elf_find_line *find_line_info;
1238
3e932841 1239 /* A place to stash dwarf1 info for this bfd. */
252b5132
RH
1240 struct dwarf1_debug *dwarf1_find_line_info;
1241
3e932841 1242 /* A place to stash dwarf2 info for this bfd. */
c39a58e6 1243 void *dwarf2_find_line_info;
252b5132
RH
1244
1245 /* An array of stub sections indexed by symbol number, used by the
1246 MIPS ELF linker. FIXME: We should figure out some way to only
1247 include this field for a MIPS ELF target. */
1248 asection **local_stubs;
1249
65765700
JJ
1250 /* Used to determine if PT_GNU_EH_FRAME segment header should be
1251 created. */
126495ed
AM
1252 asection *eh_frame_hdr;
1253
4a43e768
AM
1254 Elf_Internal_Shdr **group_sect_ptr;
1255 int num_group;
65765700 1256
252b5132
RH
1257 /* Number of symbol version definitions we are about to emit. */
1258 unsigned int cverdefs;
1259
1260 /* Number of symbol version references we are about to emit. */
1261 unsigned int cverrefs;
1262
9ee5e499 1263 /* Segment flags for the PT_GNU_STACK segment. */
3472e2e9 1264 unsigned int stack_flags;
9ee5e499 1265
8c37241b
JJ
1266 /* Should the PT_GNU_RELRO segment be emitted? */
1267 bfd_boolean relro;
1268
252b5132
RH
1269 /* Symbol version definitions in external objects. */
1270 Elf_Internal_Verdef *verdef;
1271
1272 /* Symbol version references to external objects. */
1273 Elf_Internal_Verneed *verref;
1274
b305ef96
UC
1275 /* The Irix 5 support uses two virtual sections, which represent
1276 text/data symbols defined in dynamic objects. */
1277 asymbol *elf_data_symbol;
1278 asymbol *elf_text_symbol;
1279 asection *elf_data_section;
1280 asection *elf_text_section;
4a43e768
AM
1281
1282 /* Whether a dyanmic object was specified normally on the linker
1283 command line, or was specified when --as-needed was in effect,
1284 or was found via a DT_NEEDED entry. */
1285 enum dynamic_lib_link_class dyn_lib_class;
1286
1287 /* This is set to TRUE if the object was created by the backend
1288 linker. */
1289 bfd_boolean linker;
1290
1291 /* Irix 5 often screws up the symbol table, sorting local symbols
1292 after global symbols. This flag is set if the symbol table in
1293 this BFD appears to be screwed up. If it is, we ignore the
1294 sh_info field in the symbol table header, and always read all the
1295 symbols. */
1296 bfd_boolean bad_symtab;
1297
1298 /* Used to determine if the e_flags field has been initialized */
1299 bfd_boolean flags_init;
252b5132
RH
1300};
1301
1302#define elf_tdata(bfd) ((bfd) -> tdata.elf_obj_data)
1303#define elf_elfheader(bfd) (elf_tdata(bfd) -> elf_header)
1304#define elf_elfsections(bfd) (elf_tdata(bfd) -> elf_sect_ptr)
9ad5cbcf 1305#define elf_numsections(bfd) (elf_tdata(bfd) -> num_elf_sections)
252b5132
RH
1306#define elf_shstrtab(bfd) (elf_tdata(bfd) -> strtab_ptr)
1307#define elf_onesymtab(bfd) (elf_tdata(bfd) -> symtab_section)
9ad5cbcf 1308#define elf_symtab_shndx(bfd) (elf_tdata(bfd) -> symtab_shndx_section)
252b5132
RH
1309#define elf_dynsymtab(bfd) (elf_tdata(bfd) -> dynsymtab_section)
1310#define elf_dynversym(bfd) (elf_tdata(bfd) -> dynversym_section)
1311#define elf_dynverdef(bfd) (elf_tdata(bfd) -> dynverdef_section)
1312#define elf_dynverref(bfd) (elf_tdata(bfd) -> dynverref_section)
1313#define elf_num_locals(bfd) (elf_tdata(bfd) -> num_locals)
1314#define elf_num_globals(bfd) (elf_tdata(bfd) -> num_globals)
1315#define elf_section_syms(bfd) (elf_tdata(bfd) -> section_syms)
4e89ac30 1316#define elf_num_section_syms(bfd) (elf_tdata(bfd) -> num_section_syms)
252b5132
RH
1317#define core_prpsinfo(bfd) (elf_tdata(bfd) -> prpsinfo)
1318#define core_prstatus(bfd) (elf_tdata(bfd) -> prstatus)
1319#define elf_gp(bfd) (elf_tdata(bfd) -> gp)
1320#define elf_gp_size(bfd) (elf_tdata(bfd) -> gp_size)
1321#define elf_sym_hashes(bfd) (elf_tdata(bfd) -> sym_hashes)
1322#define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts)
1323#define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets)
5cab59f6 1324#define elf_local_got_ents(bfd) (elf_tdata(bfd) -> local_got.ents)
252b5132 1325#define elf_dt_name(bfd) (elf_tdata(bfd) -> dt_name)
4a43e768 1326#define elf_dyn_lib_class(bfd) (elf_tdata(bfd) -> dyn_lib_class)
252b5132
RH
1327#define elf_bad_symtab(bfd) (elf_tdata(bfd) -> bad_symtab)
1328#define elf_flags_init(bfd) (elf_tdata(bfd) -> flags_init)
252b5132
RH
1329\f
1330extern void _bfd_elf_swap_verdef_in
c39a58e6 1331 (bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *);
252b5132 1332extern void _bfd_elf_swap_verdef_out
c39a58e6 1333 (bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *);
252b5132 1334extern void _bfd_elf_swap_verdaux_in
c39a58e6 1335 (bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *);
252b5132 1336extern void _bfd_elf_swap_verdaux_out
c39a58e6 1337 (bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *);
252b5132 1338extern void _bfd_elf_swap_verneed_in
c39a58e6 1339 (bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *);
252b5132 1340extern void _bfd_elf_swap_verneed_out
c39a58e6 1341 (bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *);
252b5132 1342extern void _bfd_elf_swap_vernaux_in
c39a58e6 1343 (bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *);
252b5132 1344extern void _bfd_elf_swap_vernaux_out
c39a58e6 1345 (bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *);
252b5132 1346extern void _bfd_elf_swap_versym_in
c39a58e6 1347 (bfd *, const Elf_External_Versym *, Elf_Internal_Versym *);
252b5132 1348extern void _bfd_elf_swap_versym_out
c39a58e6 1349 (bfd *, const Elf_Internal_Versym *, Elf_External_Versym *);
252b5132 1350
dc810e39 1351extern int _bfd_elf_section_from_bfd_section
c39a58e6 1352 (bfd *, asection *);
252b5132 1353extern char *bfd_elf_string_from_elf_section
c39a58e6 1354 (bfd *, unsigned, unsigned);
dc810e39 1355extern char *bfd_elf_get_str_section
c39a58e6 1356 (bfd *, unsigned);
6cdc0ccc 1357extern Elf_Internal_Sym *bfd_elf_get_elf_syms
c39a58e6
AM
1358 (bfd *, Elf_Internal_Shdr *, size_t, size_t, Elf_Internal_Sym *, void *,
1359 Elf_External_Sym_Shndx *);
0e2cfdce 1360extern const char *bfd_elf_sym_name
be8dd2ca 1361 (bfd *, Elf_Internal_Shdr *, Elf_Internal_Sym *);
252b5132 1362
b34976b6 1363extern bfd_boolean _bfd_elf_copy_private_bfd_data
c39a58e6 1364 (bfd *, bfd *);
b34976b6 1365extern bfd_boolean _bfd_elf_print_private_bfd_data
c39a58e6 1366 (bfd *, void *);
dc810e39 1367extern void bfd_elf_print_symbol
c39a58e6 1368 (bfd *, void *, asymbol *, bfd_print_symbol_type);
dc810e39
AM
1369
1370#define elf_string_from_elf_strtab(abfd, strindex) \
c39a58e6
AM
1371 bfd_elf_string_from_elf_section (abfd, elf_elfheader(abfd)->e_shstrndx, \
1372 strindex)
252b5132 1373
dc810e39 1374extern void _bfd_elf_sprintf_vma
c39a58e6 1375 (bfd *, char *, bfd_vma);
dc810e39 1376extern void _bfd_elf_fprintf_vma
c39a58e6 1377 (bfd *, void *, bfd_vma);
d69bb69b 1378
ec3391e7
AO
1379extern bfd_byte _bfd_elf_encode_eh_address
1380 (bfd *abfd, struct bfd_link_info *info, asection *osec, bfd_vma offset,
1381 asection *loc_sec, bfd_vma loc_offset, bfd_vma *encoded);
1382extern bfd_boolean _bfd_elf_can_make_relative
1383 (bfd *input_bfd, struct bfd_link_info *info, asection *eh_frame_section);
1384
dc810e39 1385extern enum elf_reloc_type_class _bfd_elf_reloc_type_class
c39a58e6 1386 (const Elf_Internal_Rela *);
f8df10f4 1387extern bfd_vma _bfd_elf_rela_local_sym
8517fae7 1388 (bfd *, Elf_Internal_Sym *, asection **, Elf_Internal_Rela *);
c629eae0 1389extern bfd_vma _bfd_elf_rel_local_sym
c39a58e6 1390 (bfd *, Elf_Internal_Sym *, asection **, bfd_vma);
c629eae0 1391extern bfd_vma _bfd_elf_section_offset
c39a58e6 1392 (bfd *, struct bfd_link_info *, asection *, bfd_vma);
db6751f2 1393
dc810e39 1394extern unsigned long bfd_elf_hash
c39a58e6 1395 (const char *);
252b5132 1396
dc810e39 1397extern bfd_reloc_status_type bfd_elf_generic_reloc
c39a58e6 1398 (bfd *, arelent *, asymbol *, void *, asection *, bfd *, char **);
b34976b6 1399extern bfd_boolean bfd_elf_mkobject
c39a58e6 1400 (bfd *);
b34976b6 1401extern bfd_boolean bfd_elf_mkcorefile
c39a58e6 1402 (bfd *);
dc810e39 1403extern Elf_Internal_Shdr *bfd_elf_find_section
c39a58e6 1404 (bfd *, char *);
b34976b6 1405extern bfd_boolean _bfd_elf_make_section_from_shdr
c39a58e6 1406 (bfd *, Elf_Internal_Shdr *, const char *);
b34976b6 1407extern bfd_boolean _bfd_elf_make_section_from_phdr
c39a58e6 1408 (bfd *, Elf_Internal_Phdr *, int, const char *);
252b5132 1409extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc
c39a58e6 1410 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
252b5132 1411extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create
c39a58e6 1412 (bfd *);
c61b8717 1413extern void _bfd_elf_link_hash_copy_indirect
9c5bfbb7 1414 (const struct elf_backend_data *, struct elf_link_hash_entry *,
c39a58e6 1415 struct elf_link_hash_entry *);
c61b8717 1416extern void _bfd_elf_link_hash_hide_symbol
c39a58e6 1417 (struct bfd_link_info *, struct elf_link_hash_entry *, bfd_boolean);
b34976b6 1418extern bfd_boolean _bfd_elf_link_hash_table_init
c39a58e6
AM
1419 (struct elf_link_hash_table *, bfd *,
1420 struct bfd_hash_entry *(*)
1421 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
b34976b6 1422extern bfd_boolean _bfd_elf_slurp_version_tables
fc0e6df6 1423 (bfd *, bfd_boolean);
b34976b6 1424extern bfd_boolean _bfd_elf_merge_sections
c39a58e6 1425 (bfd *, struct bfd_link_info *);
72adc230
AM
1426extern bfd_boolean bfd_elf_is_group_section
1427 (bfd *, const struct bfd_section *);
b34976b6 1428extern bfd_boolean bfd_elf_discard_group
198beae2 1429 (bfd *, struct bfd_section *);
082b7297
L
1430extern void _bfd_elf_section_already_linked
1431 (bfd *, struct bfd_section *);
1126897b 1432extern void bfd_elf_set_group_contents
c39a58e6 1433 (bfd *, asection *, void *);
2d653fc7 1434extern void _bfd_elf_link_just_syms
c39a58e6 1435 (asection *, struct bfd_link_info *);
80fccad2
BW
1436extern bfd_boolean _bfd_elf_copy_private_header_data
1437 (bfd *, bfd *);
b34976b6 1438extern bfd_boolean _bfd_elf_copy_private_symbol_data
c39a58e6 1439 (bfd *, asymbol *, bfd *, asymbol *);
b34976b6 1440extern bfd_boolean _bfd_elf_copy_private_section_data
c39a58e6 1441 (bfd *, asection *, bfd *, asection *);
b34976b6 1442extern bfd_boolean _bfd_elf_write_object_contents
c39a58e6 1443 (bfd *);
b34976b6 1444extern bfd_boolean _bfd_elf_write_corefile_contents
c39a58e6 1445 (bfd *);
b34976b6 1446extern bfd_boolean _bfd_elf_set_section_contents
0f867abe 1447 (bfd *, sec_ptr, const void *, file_ptr, bfd_size_type);
dc810e39 1448extern long _bfd_elf_get_symtab_upper_bound
c39a58e6 1449 (bfd *);
6cee3f79 1450extern long _bfd_elf_canonicalize_symtab
c39a58e6 1451 (bfd *, asymbol **);
dc810e39 1452extern long _bfd_elf_get_dynamic_symtab_upper_bound
c39a58e6 1453 (bfd *);
dc810e39 1454extern long _bfd_elf_canonicalize_dynamic_symtab
c39a58e6 1455 (bfd *, asymbol **);
4c45e5c9 1456extern long _bfd_elf_get_synthetic_symtab
c9727e01 1457 (bfd *, long, asymbol **, long, asymbol **, asymbol **);
dc810e39 1458extern long _bfd_elf_get_reloc_upper_bound
c39a58e6 1459 (bfd *, sec_ptr);
dc810e39 1460extern long _bfd_elf_canonicalize_reloc
c39a58e6 1461 (bfd *, sec_ptr, arelent **, asymbol **);
dc810e39 1462extern long _bfd_elf_get_dynamic_reloc_upper_bound
c39a58e6 1463 (bfd *);
dc810e39 1464extern long _bfd_elf_canonicalize_dynamic_reloc
c39a58e6 1465 (bfd *, arelent **, asymbol **);
dc810e39 1466extern asymbol *_bfd_elf_make_empty_symbol
c39a58e6 1467 (bfd *);
dc810e39 1468extern void _bfd_elf_get_symbol_info
c39a58e6 1469 (bfd *, asymbol *, symbol_info *);
b34976b6 1470extern bfd_boolean _bfd_elf_is_local_label_name
c39a58e6 1471 (bfd *, const char *);
dc810e39 1472extern alent *_bfd_elf_get_lineno
c39a58e6 1473 (bfd *, asymbol *);
b34976b6 1474extern bfd_boolean _bfd_elf_set_arch_mach
c39a58e6 1475 (bfd *, enum bfd_architecture, unsigned long);
b34976b6 1476extern bfd_boolean _bfd_elf_find_nearest_line
c39a58e6
AM
1477 (bfd *, asection *, asymbol **, bfd_vma, const char **, const char **,
1478 unsigned int *);
252b5132
RH
1479#define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols
1480#define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol
dc810e39 1481extern int _bfd_elf_sizeof_headers
c39a58e6 1482 (bfd *, bfd_boolean);
b34976b6 1483extern bfd_boolean _bfd_elf_new_section_hook
c39a58e6 1484 (bfd *, asection *);
b34976b6 1485extern bfd_boolean _bfd_elf_init_reloc_shdr
c39a58e6 1486 (bfd *, Elf_Internal_Shdr *, asection *, bfd_boolean);
7dcb9820
AM
1487extern const struct bfd_elf_special_section *_bfd_elf_get_sec_type_attr
1488 (bfd *, const char *);
252b5132
RH
1489
1490/* If the target doesn't have reloc handling written yet: */
dc810e39 1491extern void _bfd_elf_no_info_to_howto
c39a58e6 1492 (bfd *, arelent *, Elf_Internal_Rela *);
dc810e39 1493
b34976b6 1494extern bfd_boolean bfd_section_from_shdr
c39a58e6 1495 (bfd *, unsigned int shindex);
b34976b6 1496extern bfd_boolean bfd_section_from_phdr
c39a58e6 1497 (bfd *, Elf_Internal_Phdr *, int);
dc810e39
AM
1498
1499extern int _bfd_elf_symbol_from_bfd_symbol
c39a58e6 1500 (bfd *, asymbol **);
dc810e39 1501
ec338859 1502extern asection *bfd_section_from_r_symndx
c39a58e6 1503 (bfd *, struct sym_sec_cache *, asection *, unsigned long);
dc810e39 1504extern asection *bfd_section_from_elf_index
c39a58e6 1505 (bfd *, unsigned int);
dc810e39 1506extern struct bfd_strtab_hash *_bfd_elf_stringtab_init
c39a58e6 1507 (void);
2b0f7ef9
JJ
1508
1509extern struct elf_strtab_hash * _bfd_elf_strtab_init
c39a58e6 1510 (void);
2b0f7ef9 1511extern void _bfd_elf_strtab_free
c39a58e6 1512 (struct elf_strtab_hash *);
2b0f7ef9 1513extern bfd_size_type _bfd_elf_strtab_add
c39a58e6 1514 (struct elf_strtab_hash *, const char *, bfd_boolean);
2b0f7ef9 1515extern void _bfd_elf_strtab_addref
c39a58e6 1516 (struct elf_strtab_hash *, bfd_size_type);
2b0f7ef9 1517extern void _bfd_elf_strtab_delref
c39a58e6 1518 (struct elf_strtab_hash *, bfd_size_type);
2b0f7ef9 1519extern void _bfd_elf_strtab_clear_all_refs
c39a58e6 1520 (struct elf_strtab_hash *);
2b0f7ef9 1521extern bfd_size_type _bfd_elf_strtab_size
c39a58e6 1522 (struct elf_strtab_hash *);
2b0f7ef9 1523extern bfd_size_type _bfd_elf_strtab_offset
c39a58e6 1524 (struct elf_strtab_hash *, bfd_size_type);
b34976b6 1525extern bfd_boolean _bfd_elf_strtab_emit
c39a58e6 1526 (bfd *, struct elf_strtab_hash *);
2b0f7ef9 1527extern void _bfd_elf_strtab_finalize
c39a58e6 1528 (struct elf_strtab_hash *);
2b0f7ef9 1529
b34976b6 1530extern bfd_boolean _bfd_elf_discard_section_eh_frame
c39a58e6
AM
1531 (bfd *, struct bfd_link_info *, asection *,
1532 bfd_boolean (*) (bfd_vma, void *), struct elf_reloc_cookie *);
b34976b6 1533extern bfd_boolean _bfd_elf_discard_section_eh_frame_hdr
c39a58e6 1534 (bfd *, struct bfd_link_info *);
65765700 1535extern bfd_vma _bfd_elf_eh_frame_section_offset
92e4ec35 1536 (bfd *, struct bfd_link_info *, asection *, bfd_vma);
b34976b6 1537extern bfd_boolean _bfd_elf_write_section_eh_frame
c39a58e6 1538 (bfd *, struct bfd_link_info *, asection *, bfd_byte *);
b34976b6 1539extern bfd_boolean _bfd_elf_write_section_eh_frame_hdr
c39a58e6 1540 (bfd *, struct bfd_link_info *);
b34976b6 1541extern bfd_boolean _bfd_elf_maybe_strip_eh_frame_hdr
c39a58e6 1542 (struct bfd_link_info *);
65765700 1543
45d6a902 1544extern bfd_boolean _bfd_elf_merge_symbol
c39a58e6
AM
1545 (bfd *, struct bfd_link_info *, const char *, Elf_Internal_Sym *,
1546 asection **, bfd_vma *, struct elf_link_hash_entry **, bfd_boolean *,
0f8a2703 1547 bfd_boolean *, bfd_boolean *, bfd_boolean *);
45d6a902
AM
1548
1549extern bfd_boolean _bfd_elf_add_default_symbol
c39a58e6
AM
1550 (bfd *, struct bfd_link_info *, struct elf_link_hash_entry *,
1551 const char *, Elf_Internal_Sym *, asection **, bfd_vma *,
0f8a2703 1552 bfd_boolean *, bfd_boolean);
45d6a902
AM
1553
1554extern bfd_boolean _bfd_elf_export_symbol
c39a58e6 1555 (struct elf_link_hash_entry *, void *);
45d6a902
AM
1556
1557extern bfd_boolean _bfd_elf_link_find_version_dependencies
c39a58e6 1558 (struct elf_link_hash_entry *, void *);
45d6a902
AM
1559
1560extern bfd_boolean _bfd_elf_link_assign_sym_version
c39a58e6 1561 (struct elf_link_hash_entry *, void *);
45d6a902 1562
dc810e39 1563extern long _bfd_elf_link_lookup_local_dynindx
c39a58e6 1564 (struct bfd_link_info *, bfd *, long);
b34976b6 1565extern bfd_boolean _bfd_elf_compute_section_file_positions
c39a58e6 1566 (bfd *, struct bfd_link_info *);
dc810e39 1567extern void _bfd_elf_assign_file_positions_for_relocs
c39a58e6 1568 (bfd *);
dc810e39 1569extern file_ptr _bfd_elf_assign_file_position_for_section
c39a58e6 1570 (Elf_Internal_Shdr *, file_ptr, bfd_boolean);
dc810e39 1571
b34976b6 1572extern bfd_boolean _bfd_elf_validate_reloc
c39a58e6 1573 (bfd *, arelent *);
dc810e39 1574
45d6a902 1575extern bfd_boolean _bfd_elf_link_create_dynamic_sections
c39a58e6 1576 (bfd *, struct bfd_link_info *);
aee6f5b4
AO
1577extern bfd_boolean _bfd_elf_link_omit_section_dynsym
1578 (bfd *, struct bfd_link_info *, asection *);
b34976b6 1579extern bfd_boolean _bfd_elf_create_dynamic_sections
c39a58e6 1580 (bfd *, struct bfd_link_info *);
b34976b6 1581extern bfd_boolean _bfd_elf_create_got_section
c39a58e6 1582 (bfd *, struct bfd_link_info *);
dc810e39 1583extern unsigned long _bfd_elf_link_renumber_dynsyms
c39a58e6 1584 (bfd *, struct bfd_link_info *);
dc810e39 1585
b34976b6 1586extern bfd_boolean _bfd_elfcore_make_pseudosection
c39a58e6 1587 (bfd *, char *, size_t, ufile_ptr);
dc810e39 1588extern char *_bfd_elfcore_strndup
c39a58e6 1589 (bfd *, char *, size_t);
dc810e39 1590
45d6a902 1591extern Elf_Internal_Rela *_bfd_elf_link_read_relocs
c39a58e6 1592 (bfd *, asection *, void *, Elf_Internal_Rela *, bfd_boolean);
45d6a902
AM
1593
1594extern bfd_boolean _bfd_elf_link_size_reloc_section
c39a58e6 1595 (bfd *, Elf_Internal_Shdr *, asection *);
45d6a902
AM
1596
1597extern bfd_boolean _bfd_elf_link_output_relocs
c39a58e6 1598 (bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *);
45d6a902
AM
1599
1600extern bfd_boolean _bfd_elf_fix_symbol_flags
c39a58e6 1601 (struct elf_link_hash_entry *, struct elf_info_failed *);
45d6a902
AM
1602
1603extern bfd_boolean _bfd_elf_adjust_dynamic_symbol
c39a58e6 1604 (struct elf_link_hash_entry *, void *);
45d6a902
AM
1605
1606extern bfd_boolean _bfd_elf_link_sec_merge_syms
c39a58e6 1607 (struct elf_link_hash_entry *, void *);
45d6a902 1608
986a241f 1609extern bfd_boolean _bfd_elf_dynamic_symbol_p
c39a58e6 1610 (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
f6c52c13
AM
1611
1612extern bfd_boolean _bfd_elf_symbol_refs_local_p
c39a58e6 1613 (struct elf_link_hash_entry *, struct bfd_link_info *, bfd_boolean);
986a241f 1614
3d7f7666
L
1615extern bfd_boolean bfd_elf_match_symbols_in_sections
1616 (asection *sec1, asection *sec2);
1617
1618extern bfd_boolean _bfd_elf_setup_group_pointers
1619 (bfd *);
1620
dc810e39 1621extern const bfd_target *bfd_elf32_object_p
c39a58e6 1622 (bfd *);
dc810e39 1623extern const bfd_target *bfd_elf32_core_file_p
c39a58e6 1624 (bfd *);
dc810e39 1625extern char *bfd_elf32_core_file_failing_command
c39a58e6 1626 (bfd *);
dc810e39 1627extern int bfd_elf32_core_file_failing_signal
c39a58e6 1628 (bfd *);
b34976b6 1629extern bfd_boolean bfd_elf32_core_file_matches_executable_p
c39a58e6 1630 (bfd *, bfd *);
252b5132 1631
252b5132 1632extern void bfd_elf32_swap_symbol_in
c39a58e6 1633 (bfd *, const void *, const void *, Elf_Internal_Sym *);
252b5132 1634extern void bfd_elf32_swap_symbol_out
c39a58e6 1635 (bfd *, const Elf_Internal_Sym *, void *, void *);
252b5132 1636extern void bfd_elf32_swap_reloc_in
c39a58e6 1637 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
252b5132 1638extern void bfd_elf32_swap_reloc_out
c39a58e6 1639 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
252b5132 1640extern void bfd_elf32_swap_reloca_in
c39a58e6 1641 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
252b5132 1642extern void bfd_elf32_swap_reloca_out
c39a58e6 1643 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
252b5132 1644extern void bfd_elf32_swap_phdr_in
c39a58e6 1645 (bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *);
252b5132 1646extern void bfd_elf32_swap_phdr_out
c39a58e6 1647 (bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *);
252b5132 1648extern void bfd_elf32_swap_dyn_in
c39a58e6 1649 (bfd *, const void *, Elf_Internal_Dyn *);
252b5132 1650extern void bfd_elf32_swap_dyn_out
c39a58e6 1651 (bfd *, const Elf_Internal_Dyn *, void *);
252b5132 1652extern long bfd_elf32_slurp_symbol_table
c39a58e6 1653 (bfd *, asymbol **, bfd_boolean);
b34976b6 1654extern bfd_boolean bfd_elf32_write_shdrs_and_ehdr
c39a58e6 1655 (bfd *);
252b5132 1656extern int bfd_elf32_write_out_phdrs
c39a58e6 1657 (bfd *, const Elf_Internal_Phdr *, unsigned int);
b9f66672 1658extern void bfd_elf32_write_relocs
c39a58e6 1659 (bfd *, asection *, void *);
b34976b6 1660extern bfd_boolean bfd_elf32_slurp_reloc_table
c39a58e6 1661 (bfd *, asection *, asymbol **, bfd_boolean);
252b5132 1662
dc810e39 1663extern const bfd_target *bfd_elf64_object_p
c39a58e6 1664 (bfd *);
dc810e39 1665extern const bfd_target *bfd_elf64_core_file_p
c39a58e6 1666 (bfd *);
dc810e39 1667extern char *bfd_elf64_core_file_failing_command
c39a58e6 1668 (bfd *);
dc810e39 1669extern int bfd_elf64_core_file_failing_signal
c39a58e6 1670 (bfd *);
b34976b6 1671extern bfd_boolean bfd_elf64_core_file_matches_executable_p
c39a58e6 1672 (bfd *, bfd *);
252b5132
RH
1673
1674extern void bfd_elf64_swap_symbol_in
c39a58e6 1675 (bfd *, const void *, const void *, Elf_Internal_Sym *);
252b5132 1676extern void bfd_elf64_swap_symbol_out
c39a58e6 1677 (bfd *, const Elf_Internal_Sym *, void *, void *);
252b5132 1678extern void bfd_elf64_swap_reloc_in
c39a58e6 1679 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
252b5132 1680extern void bfd_elf64_swap_reloc_out
c39a58e6 1681 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
252b5132 1682extern void bfd_elf64_swap_reloca_in
c39a58e6 1683 (bfd *, const bfd_byte *, Elf_Internal_Rela *);
252b5132 1684extern void bfd_elf64_swap_reloca_out
c39a58e6 1685 (bfd *, const Elf_Internal_Rela *, bfd_byte *);
252b5132 1686extern void bfd_elf64_swap_phdr_in
c39a58e6 1687 (bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *);
252b5132 1688extern void bfd_elf64_swap_phdr_out
c39a58e6 1689 (bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *);
252b5132 1690extern void bfd_elf64_swap_dyn_in
c39a58e6 1691 (bfd *, const void *, Elf_Internal_Dyn *);
252b5132 1692extern void bfd_elf64_swap_dyn_out
c39a58e6 1693 (bfd *, const Elf_Internal_Dyn *, void *);
252b5132 1694extern long bfd_elf64_slurp_symbol_table
c39a58e6 1695 (bfd *, asymbol **, bfd_boolean);
b34976b6 1696extern bfd_boolean bfd_elf64_write_shdrs_and_ehdr
c39a58e6 1697 (bfd *);
252b5132 1698extern int bfd_elf64_write_out_phdrs
c39a58e6 1699 (bfd *, const Elf_Internal_Phdr *, unsigned int);
b9f66672 1700extern void bfd_elf64_write_relocs
c39a58e6 1701 (bfd *, asection *, void *);
b34976b6 1702extern bfd_boolean bfd_elf64_slurp_reloc_table
c39a58e6 1703 (bfd *, asection *, asymbol **, bfd_boolean);
5a580b3a 1704
8387904d
AM
1705extern struct elf_link_hash_entry *_bfd_elf_archive_symbol_lookup
1706 (bfd *, struct bfd_link_info *, const char *);
4ad4eba5
AM
1707extern bfd_boolean bfd_elf_link_add_symbols
1708 (bfd *, struct bfd_link_info *);
5a580b3a 1709extern bfd_boolean _bfd_elf_add_dynamic_entry
c39a58e6 1710 (struct bfd_link_info *, bfd_vma, bfd_vma);
252b5132 1711
c152c796
AM
1712extern bfd_boolean bfd_elf_link_record_dynamic_symbol
1713 (struct bfd_link_info *, struct elf_link_hash_entry *);
30b30c21 1714
c152c796 1715extern int bfd_elf_link_record_local_dynamic_symbol
c39a58e6 1716 (struct bfd_link_info *, bfd *, long);
252b5132 1717
b34976b6 1718extern bfd_boolean _bfd_elf_close_and_cleanup
c39a58e6 1719 (bfd *);
252b5132 1720extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn
fc0a2244 1721 (bfd *, arelent *, struct bfd_symbol *, void *,
c39a58e6 1722 asection *, bfd *, char **);
252b5132 1723
c152c796 1724extern bfd_boolean bfd_elf_final_link
c39a58e6 1725 (bfd *, struct bfd_link_info *);
c152c796
AM
1726
1727extern bfd_boolean bfd_elf_gc_sections
c39a58e6 1728 (bfd *, struct bfd_link_info *);
c152c796
AM
1729
1730extern bfd_boolean bfd_elf_gc_record_vtinherit
c39a58e6 1731 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
c152c796
AM
1732
1733extern bfd_boolean bfd_elf_gc_record_vtentry
c39a58e6 1734 (bfd *, asection *, struct elf_link_hash_entry *, bfd_vma);
252b5132 1735
ccfa59ea
AM
1736extern bfd_boolean _bfd_elf_gc_mark
1737 (struct bfd_link_info *, asection *,
1738 asection * (*) (asection *, struct bfd_link_info *, Elf_Internal_Rela *,
1739 struct elf_link_hash_entry *, Elf_Internal_Sym *));
1740
c152c796 1741extern bfd_boolean bfd_elf_gc_common_finalize_got_offsets
c39a58e6 1742 (bfd *, struct bfd_link_info *);
c152c796
AM
1743
1744extern bfd_boolean bfd_elf_gc_common_final_link
c39a58e6 1745 (bfd *, struct bfd_link_info *);
252b5132 1746
c152c796 1747extern bfd_boolean bfd_elf_reloc_symbol_deleted_p
c39a58e6 1748 (bfd_vma, void *);
73d074b4 1749
229fcec5
MM
1750extern struct elf_segment_map *
1751_bfd_elf_make_dynamic_segment
1752 (bfd *, asection *);
1753
7c76fa91 1754/* Exported interface for writing elf corefile notes. */
d4c88bbb 1755extern char *elfcore_write_note
c39a58e6 1756 (bfd *, char *, int *, const char *, int, const void *, int);
d4c88bbb 1757extern char *elfcore_write_prpsinfo
c39a58e6 1758 (bfd *, char *, int *, const char *, const char *);
d4c88bbb 1759extern char *elfcore_write_prstatus
c39a58e6 1760 (bfd *, char *, int *, long, int, const void *);
d4c88bbb 1761extern char * elfcore_write_pstatus
c39a58e6 1762 (bfd *, char *, int *, long, int, const void *);
d4c88bbb 1763extern char *elfcore_write_prfpreg
c39a58e6 1764 (bfd *, char *, int *, const void *, int);
d4c88bbb 1765extern char *elfcore_write_prxfpreg
c39a58e6 1766 (bfd *, char *, int *, const void *, int);
d4c88bbb 1767extern char *elfcore_write_lwpstatus
c39a58e6 1768 (bfd *, char *, int *, long, int, const void *);
7c76fa91 1769
8d6337fe 1770extern bfd *_bfd_elf32_bfd_from_remote_memory
c39a58e6
AM
1771 (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
1772 int (*target_read_memory) (bfd_vma, char *, int));
8d6337fe 1773extern bfd *_bfd_elf64_bfd_from_remote_memory
c39a58e6
AM
1774 (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
1775 int (*target_read_memory) (bfd_vma, char *, int));
8d6337fe 1776
d4845d57
JR
1777/* SH ELF specific routine. */
1778
b34976b6 1779extern bfd_boolean _sh_elf_set_mach_from_flags
c39a58e6 1780 (bfd *);
d4845d57 1781
c152c796
AM
1782/* This is the condition under which finish_dynamic_symbol will be called.
1783 If our finish_dynamic_symbol isn't called, we'll need to do something
1784 about initializing any .plt and .got entries in relocate_section. */
1785#define WILL_CALL_FINISH_DYNAMIC_SYMBOL(DYN, SHARED, H) \
1786 ((DYN) \
f5385ebf
AM
1787 && ((SHARED) || !(H)->forced_local) \
1788 && ((H)->dynindx != -1 || (H)->forced_local))
c152c796 1789
560e09e9
NC
1790/* This macro is to avoid lots of duplicated code in the body
1791 of xxx_relocate_section() in the various elfxx-xxxx.c files. */
b2a8e766
AM
1792#define RELOC_FOR_GLOBAL_SYMBOL(info, input_bfd, input_section, rel, \
1793 r_symndx, symtab_hdr, sym_hashes, \
1794 h, sec, relocation, \
1795 unresolved_reloc, warned) \
1796 do \
1797 { \
1798 /* It seems this can happen with erroneous or unsupported \
1799 input (mixing a.out and elf in an archive, for example.) */ \
1800 if (sym_hashes == NULL) \
1801 return FALSE; \
1802 \
1803 h = sym_hashes[r_symndx - symtab_hdr->sh_info]; \
1804 \
1805 while (h->root.type == bfd_link_hash_indirect \
1806 || h->root.type == bfd_link_hash_warning) \
1807 h = (struct elf_link_hash_entry *) h->root.u.i.link; \
1808 \
1809 warned = FALSE; \
1810 unresolved_reloc = FALSE; \
1811 relocation = 0; \
1812 if (h->root.type == bfd_link_hash_defined \
1813 || h->root.type == bfd_link_hash_defweak) \
1814 { \
1815 sec = h->root.u.def.section; \
1816 if (sec == NULL \
1817 || sec->output_section == NULL) \
1818 /* Set a flag that will be cleared later if we find a \
1819 relocation value for this symbol. output_section \
1820 is typically NULL for symbols satisfied by a shared \
1821 library. */ \
1822 unresolved_reloc = TRUE; \
1823 else \
1824 relocation = (h->root.u.def.value \
1825 + sec->output_section->vma \
1826 + sec->output_offset); \
1827 } \
1828 else if (h->root.type == bfd_link_hash_undefweak) \
1829 ; \
1830 else if (info->unresolved_syms_in_objects == RM_IGNORE \
1831 && ELF_ST_VISIBILITY (h->other) == STV_DEFAULT) \
1832 ; \
1833 else \
1834 { \
5a580b3a
AM
1835 bfd_boolean err; \
1836 err = (info->unresolved_syms_in_objects == RM_GENERATE_ERROR \
1837 || ELF_ST_VISIBILITY (h->other) != STV_DEFAULT); \
1838 if (!info->callbacks->undefined_symbol (info, \
1839 h->root.root.string, \
1840 input_bfd, \
1841 input_section, \
1842 rel->r_offset, err)) \
b2a8e766
AM
1843 return FALSE; \
1844 warned = TRUE; \
1845 } \
1846 } \
560e09e9
NC
1847 while (0)
1848
252b5132 1849#endif /* _LIBELF_H_ */