Commit | Line | Data |
---|---|---|
252b5132 | 1 | /* BFD back-end data structures for ELF files. |
e5094212 AM |
2 | Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, |
3 | 2002 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 | 35 | /* If size isn't specified as 64 or 32, NAME macro should fail. */ |
e43d48cc AM |
36 | /* Do not "beautify" the CONCAT* macro args. Traditional C will not |
37 | remove whitespace added here, and thus will fail to concatenate | |
38 | the tokens. */ | |
252b5132 RH |
39 | #ifndef NAME |
40 | #if ARCH_SIZE==64 | |
e43d48cc | 41 | #define NAME(x,y) CONCAT4 (x,64,_,y) |
252b5132 RH |
42 | #endif |
43 | #if ARCH_SIZE==32 | |
e43d48cc | 44 | #define NAME(x,y) CONCAT4 (x,32,_,y) |
252b5132 RH |
45 | #endif |
46 | #endif | |
47 | ||
48 | #ifndef NAME | |
e43d48cc | 49 | #define NAME(x,y) CONCAT4 (x,NOSIZE,_,y) |
252b5132 RH |
50 | #endif |
51 | ||
52 | #define ElfNAME(X) NAME(Elf,X) | |
53 | #define elfNAME(X) NAME(elf,X) | |
54 | ||
55 | /* Information held for an ELF symbol. The first field is the | |
56 | corresponding asymbol. Every symbol is an ELF file is actually a | |
57 | pointer to this structure, although it is often handled as a | |
58 | pointer to an asymbol. */ | |
59 | ||
60 | typedef struct | |
61 | { | |
62 | /* The BFD symbol. */ | |
63 | asymbol symbol; | |
64 | /* ELF symbol information. */ | |
65 | Elf_Internal_Sym internal_elf_sym; | |
66 | /* Backend specific information. */ | |
67 | union | |
68 | { | |
69 | unsigned int hppa_arg_reloc; | |
70 | PTR mips_extr; | |
71 | PTR any; | |
72 | } | |
73 | tc_data; | |
74 | ||
75 | /* Version information. This is from an Elf_Internal_Versym | |
76 | structure in a SHT_GNU_versym section. It is zero if there is no | |
77 | version information. */ | |
78 | unsigned short version; | |
79 | ||
80 | } elf_symbol_type; | |
81 | \f | |
2b0f7ef9 JJ |
82 | struct elf_strtab_hash; |
83 | ||
252b5132 RH |
84 | /* ELF linker hash table entries. */ |
85 | ||
86 | struct elf_link_hash_entry | |
87 | { | |
88 | struct bfd_link_hash_entry root; | |
89 | ||
90 | /* Symbol index in output file. This is initialized to -1. It is | |
91 | set to -2 if the symbol is used by a reloc. */ | |
92 | long indx; | |
93 | ||
252b5132 RH |
94 | /* Symbol index as a dynamic symbol. Initialized to -1, and remains |
95 | -1 if this is not a dynamic symbol. */ | |
30b30c21 RH |
96 | /* ??? Note that this is consistently used as a synonym for tests |
97 | against whether we can perform various simplifying transformations | |
98 | to the code. (E.g. changing a pc-relative jump to a PLT entry | |
99 | into a pc-relative jump to the target function.) That test, which | |
100 | is often relatively complex, and someplaces wrong or incomplete, | |
101 | should really be replaced by a predicate in elflink.c. | |
102 | ||
103 | End result: this field -1 does not indicate that the symbol is | |
104 | not in the dynamic symbol table, but rather that the symbol is | |
105 | not visible outside this DSO. */ | |
252b5132 RH |
106 | long dynindx; |
107 | ||
108 | /* String table index in .dynstr if this is a dynamic symbol. */ | |
109 | unsigned long dynstr_index; | |
110 | ||
a90b9fca AM |
111 | /* Hash value of the name computed using the ELF hash function. */ |
112 | unsigned long elf_hash_value; | |
113 | ||
252b5132 RH |
114 | /* If this is a weak defined symbol from a dynamic object, this |
115 | field points to a defined symbol with the same value, if there is | |
116 | one. Otherwise it is NULL. */ | |
117 | struct elf_link_hash_entry *weakdef; | |
118 | ||
252b5132 RH |
119 | /* If this symbol is used in the linker created sections, the processor |
120 | specific backend uses this field to map the field into the offset | |
121 | from the beginning of the section. */ | |
122 | struct elf_linker_section_pointers *linker_section_pointer; | |
123 | ||
124 | /* Version information. */ | |
125 | union | |
126 | { | |
127 | /* This field is used for a symbol which is not defined in a | |
128 | regular object. It points to the version information read in | |
129 | from the dynamic object. */ | |
130 | Elf_Internal_Verdef *verdef; | |
131 | /* This field is used for a symbol which is defined in a regular | |
132 | object. It is set up in size_dynamic_sections. It points to | |
133 | the version information we should write out for this symbol. */ | |
134 | struct bfd_elf_version_tree *vertree; | |
135 | } verinfo; | |
136 | ||
137 | /* Virtual table entry use information. This array is nominally of size | |
138 | size/sizeof(target_void_pointer), though we have to be able to assume | |
139 | and track a size while the symbol is still undefined. It is indexed | |
140 | via offset/sizeof(target_void_pointer). */ | |
141 | size_t vtable_entries_size; | |
142 | boolean *vtable_entries_used; | |
143 | ||
144 | /* Virtual table derivation info. */ | |
145 | struct elf_link_hash_entry *vtable_parent; | |
146 | ||
a90b9fca AM |
147 | /* If this symbol requires an entry in the global offset table, the |
148 | processor specific backend uses this field to track usage and | |
149 | final offset. We use a union and two names primarily to document | |
150 | the intent of any particular piece of code. The field should be | |
151 | used as a count until size_dynamic_sections, at which point the | |
152 | contents of the .got is fixed. Afterward, if this field is -1, | |
153 | then the symbol does not require a global offset table entry. */ | |
154 | union | |
155 | { | |
156 | bfd_signed_vma refcount; | |
157 | bfd_vma offset; | |
158 | } got; | |
159 | ||
160 | /* Same, but tracks a procedure linkage table entry. */ | |
161 | union | |
162 | { | |
163 | bfd_signed_vma refcount; | |
164 | bfd_vma offset; | |
165 | } plt; | |
166 | ||
167 | /* Symbol size. */ | |
168 | bfd_size_type size; | |
169 | ||
252b5132 RH |
170 | /* Symbol type (STT_NOTYPE, STT_OBJECT, etc.). */ |
171 | char type; | |
172 | ||
9b234ee9 | 173 | /* Symbol st_other value, symbol visibility. */ |
252b5132 RH |
174 | unsigned char other; |
175 | ||
252b5132 RH |
176 | /* Some flags; legal values follow. */ |
177 | unsigned short elf_link_hash_flags; | |
178 | /* Symbol is referenced by a non-shared object. */ | |
179 | #define ELF_LINK_HASH_REF_REGULAR 01 | |
180 | /* Symbol is defined by a non-shared object. */ | |
181 | #define ELF_LINK_HASH_DEF_REGULAR 02 | |
182 | /* Symbol is referenced by a shared object. */ | |
183 | #define ELF_LINK_HASH_REF_DYNAMIC 04 | |
184 | /* Symbol is defined by a shared object. */ | |
185 | #define ELF_LINK_HASH_DEF_DYNAMIC 010 | |
186 | /* Symbol has a non-weak reference from a non-shared object. */ | |
187 | #define ELF_LINK_HASH_REF_REGULAR_NONWEAK 020 | |
188 | /* Dynamic symbol has been adjustd. */ | |
189 | #define ELF_LINK_HASH_DYNAMIC_ADJUSTED 040 | |
190 | /* Symbol needs a copy reloc. */ | |
191 | #define ELF_LINK_HASH_NEEDS_COPY 0100 | |
192 | /* Symbol needs a procedure linkage table entry. */ | |
193 | #define ELF_LINK_HASH_NEEDS_PLT 0200 | |
194 | /* Symbol appears in a non-ELF input file. */ | |
195 | #define ELF_LINK_NON_ELF 0400 | |
196 | /* Symbol should be marked as hidden in the version information. */ | |
197 | #define ELF_LINK_HIDDEN 01000 | |
198 | /* Symbol was forced to local scope due to a version script file. */ | |
199 | #define ELF_LINK_FORCED_LOCAL 02000 | |
200 | /* Symbol was marked during garbage collection. */ | |
201 | #define ELF_LINK_HASH_MARK 04000 | |
7843f00e ILT |
202 | /* Symbol is referenced by a non-GOT/non-PLT relocation. This is |
203 | not currently set by all the backends. */ | |
204 | #define ELF_LINK_NON_GOT_REF 010000 | |
252b5132 RH |
205 | }; |
206 | ||
30b30c21 RH |
207 | /* Records local symbols to be emitted in the dynamic symbol table. */ |
208 | ||
209 | struct elf_link_local_dynamic_entry | |
210 | { | |
211 | struct elf_link_local_dynamic_entry *next; | |
212 | ||
213 | /* The input bfd this symbol came from. */ | |
214 | bfd *input_bfd; | |
215 | ||
216 | /* The index of the local symbol being copied. */ | |
217 | long input_indx; | |
218 | ||
219 | /* The index in the outgoing dynamic symbol table. */ | |
220 | long dynindx; | |
3e932841 | 221 | |
30b30c21 RH |
222 | /* A copy of the input symbol. */ |
223 | Elf_Internal_Sym isym; | |
224 | }; | |
225 | ||
f5d44ba0 AM |
226 | struct elf_link_loaded_list |
227 | { | |
228 | struct elf_link_loaded_list *next; | |
229 | bfd *abfd; | |
230 | }; | |
231 | ||
65765700 JJ |
232 | enum elf_link_info_type |
233 | { | |
234 | ELF_INFO_TYPE_NONE, | |
235 | ELF_INFO_TYPE_STABS, | |
236 | ELF_INFO_TYPE_MERGE, | |
237 | ELF_INFO_TYPE_EH_FRAME, | |
2d653fc7 | 238 | ELF_INFO_TYPE_JUST_SYMS, |
65765700 JJ |
239 | ELF_INFO_TYPE_LAST |
240 | }; | |
241 | ||
126495ed AM |
242 | /* Structures used by the eh_frame optimization code. */ |
243 | struct cie_header | |
244 | { | |
245 | unsigned int length; | |
246 | unsigned int id; | |
247 | }; | |
248 | ||
249 | struct cie | |
250 | { | |
251 | struct cie_header hdr; | |
252 | unsigned char version; | |
253 | unsigned char augmentation[20]; | |
254 | unsigned int code_align; | |
255 | int data_align; | |
256 | unsigned int ra_column; | |
257 | unsigned int augmentation_size; | |
258 | struct elf_link_hash_entry *personality; | |
259 | unsigned char per_encoding; | |
260 | unsigned char lsda_encoding; | |
261 | unsigned char fde_encoding; | |
262 | unsigned char initial_insn_length; | |
263 | unsigned char make_relative; | |
264 | unsigned char make_lsda_relative; | |
265 | unsigned char initial_instructions[50]; | |
266 | }; | |
267 | ||
268 | struct eh_cie_fde | |
269 | { | |
270 | unsigned int offset; | |
271 | unsigned int size; | |
272 | asection *sec; | |
273 | unsigned int new_offset; | |
274 | unsigned char fde_encoding; | |
275 | unsigned char lsda_encoding; | |
276 | unsigned char lsda_offset; | |
277 | unsigned char cie : 1; | |
278 | unsigned char removed : 1; | |
279 | unsigned char make_relative : 1; | |
280 | unsigned char make_lsda_relative : 1; | |
281 | unsigned char per_encoding_relative : 1; | |
282 | }; | |
283 | ||
284 | struct eh_frame_sec_info | |
285 | { | |
286 | unsigned int count; | |
287 | unsigned int alloced; | |
288 | struct eh_cie_fde entry[1]; | |
289 | }; | |
290 | ||
291 | struct eh_frame_array_ent | |
292 | { | |
293 | bfd_vma initial_loc; | |
294 | bfd_vma fde; | |
295 | }; | |
296 | ||
297 | struct eh_frame_hdr_info | |
298 | { | |
299 | struct cie last_cie; | |
300 | asection *last_cie_sec; | |
301 | asection *hdr_sec; | |
302 | unsigned int last_cie_offset; | |
303 | unsigned int fde_count, array_count; | |
304 | struct eh_frame_array_ent *array; | |
305 | /* TRUE if .eh_frame_hdr should contain the sorted search table. | |
306 | We build it if we successfully read all .eh_frame input sections | |
307 | and recognize them. */ | |
308 | boolean table; | |
309 | }; | |
310 | ||
13ae64f3 JJ |
311 | /* Cached start, size and alignment of PT_TLS segment. */ |
312 | struct elf_link_tls_segment | |
313 | { | |
314 | bfd_vma start; | |
315 | bfd_size_type size; | |
316 | unsigned int align; | |
317 | }; | |
318 | ||
252b5132 RH |
319 | /* ELF linker hash table. */ |
320 | ||
321 | struct elf_link_hash_table | |
322 | { | |
323 | struct bfd_link_hash_table root; | |
51b64d56 | 324 | |
252b5132 RH |
325 | /* Whether we have created the special dynamic sections required |
326 | when linking against or generating a shared object. */ | |
327 | boolean dynamic_sections_created; | |
51b64d56 | 328 | |
252b5132 RH |
329 | /* The BFD used to hold special sections created by the linker. |
330 | This will be the first BFD found which requires these sections to | |
331 | be created. */ | |
332 | bfd *dynobj; | |
51b64d56 AM |
333 | |
334 | /* The value to use when initialising got.refcount/offset and | |
335 | plt.refcount/offset in an elf_link_hash_entry. Set to zero when | |
336 | the values are refcounts. Set to -1 in size_dynamic_sections | |
337 | when the values may be offsets. */ | |
338 | bfd_signed_vma init_refcount; | |
339 | ||
252b5132 RH |
340 | /* The number of symbols found in the link which must be put into |
341 | the .dynsym section. */ | |
342 | bfd_size_type dynsymcount; | |
51b64d56 | 343 | |
252b5132 RH |
344 | /* The string table of dynamic symbols, which becomes the .dynstr |
345 | section. */ | |
2b0f7ef9 | 346 | struct elf_strtab_hash *dynstr; |
51b64d56 | 347 | |
252b5132 RH |
348 | /* The number of buckets in the hash table in the .hash section. |
349 | This is based on the number of dynamic symbols. */ | |
350 | bfd_size_type bucketcount; | |
51b64d56 | 351 | |
252b5132 RH |
352 | /* A linked list of DT_NEEDED names found in dynamic objects |
353 | included in the link. */ | |
354 | struct bfd_link_needed_list *needed; | |
51b64d56 | 355 | |
252b5132 RH |
356 | /* The _GLOBAL_OFFSET_TABLE_ symbol. */ |
357 | struct elf_link_hash_entry *hgot; | |
51b64d56 | 358 | |
252b5132 RH |
359 | /* A pointer to information used to link stabs in sections. */ |
360 | PTR stab_info; | |
51b64d56 | 361 | |
f5fa8ca2 JJ |
362 | /* A pointer to information used to merge SEC_MERGE sections. */ |
363 | PTR merge_info; | |
51b64d56 | 364 | |
126495ed AM |
365 | /* Used by eh_frame code when editing .eh_frame. */ |
366 | struct eh_frame_hdr_info eh_info; | |
367 | ||
30b30c21 RH |
368 | /* A linked list of local symbols to be added to .dynsym. */ |
369 | struct elf_link_local_dynamic_entry *dynlocal; | |
51b64d56 | 370 | |
a963dc6a L |
371 | /* A linked list of DT_RPATH/DT_RUNPATH names found in dynamic |
372 | objects included in the link. */ | |
373 | struct bfd_link_needed_list *runpath; | |
13ae64f3 JJ |
374 | |
375 | /* Cached start, size and alignment of PT_TLS segment. */ | |
376 | struct elf_link_tls_segment *tls_segment; | |
f5d44ba0 AM |
377 | |
378 | /* A linked list of BFD's loaded in the link. */ | |
379 | struct elf_link_loaded_list *loaded; | |
252b5132 RH |
380 | }; |
381 | ||
382 | /* Look up an entry in an ELF linker hash table. */ | |
383 | ||
384 | #define elf_link_hash_lookup(table, string, create, copy, follow) \ | |
385 | ((struct elf_link_hash_entry *) \ | |
386 | bfd_link_hash_lookup (&(table)->root, (string), (create), \ | |
387 | (copy), (follow))) | |
388 | ||
389 | /* Traverse an ELF linker hash table. */ | |
390 | ||
391 | #define elf_link_hash_traverse(table, func, info) \ | |
392 | (bfd_link_hash_traverse \ | |
393 | (&(table)->root, \ | |
394 | (boolean (*) PARAMS ((struct bfd_link_hash_entry *, PTR))) (func), \ | |
395 | (info))) | |
396 | ||
397 | /* Get the ELF linker hash table from a link_info structure. */ | |
398 | ||
399 | #define elf_hash_table(p) ((struct elf_link_hash_table *) ((p)->hash)) | |
8ea2e4bd NC |
400 | |
401 | /* Returns true if the hash table is a struct elf_link_hash_table. */ | |
402 | #define is_elf_hash_table(p) \ | |
403 | ((p)->hash->type == bfd_link_elf_hash_table) | |
ec338859 AM |
404 | |
405 | /* Used by bfd_section_from_r_symndx to cache a small number of local | |
406 | symbol to section mappings. */ | |
407 | #define LOCAL_SYM_CACHE_SIZE 32 | |
408 | struct sym_sec_cache | |
409 | { | |
410 | bfd *abfd; | |
411 | unsigned long indx[LOCAL_SYM_CACHE_SIZE]; | |
412 | asection *sec[LOCAL_SYM_CACHE_SIZE]; | |
413 | }; | |
252b5132 RH |
414 | \f |
415 | /* Constant information held for an ELF backend. */ | |
416 | ||
417 | struct elf_size_info { | |
418 | unsigned char sizeof_ehdr, sizeof_phdr, sizeof_shdr; | |
419 | unsigned char sizeof_rel, sizeof_rela, sizeof_sym, sizeof_dyn, sizeof_note; | |
420 | ||
c7ac6ff8 MM |
421 | /* The size of entries in the .hash section. */ |
422 | unsigned char sizeof_hash_entry; | |
423 | ||
424 | /* The number of internal relocations to allocate per external | |
425 | relocation entry. */ | |
426 | unsigned char int_rels_per_ext_rel; | |
427 | ||
252b5132 RH |
428 | unsigned char arch_size, file_align; |
429 | unsigned char elfclass, ev_current; | |
dc810e39 AM |
430 | int (*write_out_phdrs) |
431 | PARAMS ((bfd *, const Elf_Internal_Phdr *, unsigned int)); | |
432 | boolean (*write_shdrs_and_ehdr) | |
433 | PARAMS ((bfd *)); | |
434 | void (*write_relocs) | |
435 | PARAMS ((bfd *, asection *, PTR)); | |
73ff0d56 | 436 | void (*swap_symbol_in) |
f8ecb12b | 437 | PARAMS ((bfd *, const PTR, const PTR, Elf_Internal_Sym *)); |
dc810e39 | 438 | void (*swap_symbol_out) |
9ad5cbcf | 439 | PARAMS ((bfd *, const Elf_Internal_Sym *, PTR, PTR)); |
252b5132 RH |
440 | boolean (*slurp_reloc_table) |
441 | PARAMS ((bfd *, asection *, asymbol **, boolean)); | |
dc810e39 AM |
442 | long (*slurp_symbol_table) |
443 | PARAMS ((bfd *, asymbol **, boolean)); | |
444 | void (*swap_dyn_in) | |
445 | PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *)); | |
446 | void (*swap_dyn_out) | |
447 | PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR)); | |
c7ac6ff8 MM |
448 | |
449 | /* This function, if defined, is called to swap in a REL | |
450 | relocation. If an external relocation corresponds to more than | |
451 | one internal relocation, then all relocations are swapped in at | |
452 | once. */ | |
453 | void (*swap_reloc_in) | |
454 | PARAMS ((bfd *, const bfd_byte *, Elf_Internal_Rel *)); | |
455 | ||
456 | /* This function, if defined, is called to swap out a REL | |
457 | relocation. */ | |
458 | void (*swap_reloc_out) | |
459 | PARAMS ((bfd *, const Elf_Internal_Rel *, bfd_byte *)); | |
460 | ||
461 | /* This function, if defined, is called to swap in a RELA | |
462 | relocation. If an external relocation corresponds to more than | |
463 | one internal relocation, then all relocations are swapped in at | |
464 | once. */ | |
465 | void (*swap_reloca_in) | |
466 | PARAMS ((bfd *, const bfd_byte *, Elf_Internal_Rela *)); | |
467 | ||
468 | /* This function, if defined, is called to swap out a RELA | |
469 | relocation. */ | |
470 | void (*swap_reloca_out) | |
471 | PARAMS ((bfd *, const Elf_Internal_Rela *, bfd_byte *)); | |
472 | ||
252b5132 RH |
473 | }; |
474 | ||
475 | #define elf_symbol_from(ABFD,S) \ | |
476 | (((S)->the_bfd->xvec->flavour == bfd_target_elf_flavour \ | |
477 | && (S)->the_bfd->tdata.elf_obj_data != 0) \ | |
478 | ? (elf_symbol_type *) (S) \ | |
479 | : 0) | |
480 | ||
db6751f2 JJ |
481 | enum elf_reloc_type_class { |
482 | reloc_class_normal, | |
483 | reloc_class_relative, | |
484 | reloc_class_plt, | |
485 | reloc_class_copy | |
486 | }; | |
487 | ||
73d074b4 DJ |
488 | struct elf_reloc_cookie |
489 | { | |
490 | Elf_Internal_Rela *rels, *rel, *relend; | |
6cdc0ccc | 491 | Elf_Internal_Sym *locsyms; |
73d074b4 DJ |
492 | bfd *abfd; |
493 | size_t locsymcount; | |
494 | size_t extsymoff; | |
495 | struct elf_link_hash_entry **sym_hashes; | |
496 | boolean bad_symtab; | |
497 | }; | |
498 | ||
c6e90b02 TS |
499 | /* The level of IRIX compatibility we're striving for. */ |
500 | ||
501 | typedef enum { | |
502 | ict_none, | |
503 | ict_irix5, | |
504 | ict_irix6 | |
505 | } irix_compat_t; | |
506 | ||
252b5132 RH |
507 | struct elf_backend_data |
508 | { | |
252b5132 RH |
509 | /* The architecture for this backend. */ |
510 | enum bfd_architecture arch; | |
511 | ||
512 | /* The ELF machine code (EM_xxxx) for this backend. */ | |
513 | int elf_machine_code; | |
514 | ||
515 | /* The maximum page size for this backend. */ | |
516 | bfd_vma maxpagesize; | |
517 | ||
252b5132 RH |
518 | /* A function to translate an ELF RELA relocation to a BFD arelent |
519 | structure. */ | |
dc810e39 AM |
520 | void (*elf_info_to_howto) |
521 | PARAMS ((bfd *, arelent *, Elf_Internal_Rela *)); | |
252b5132 RH |
522 | |
523 | /* A function to translate an ELF REL relocation to a BFD arelent | |
524 | structure. */ | |
dc810e39 AM |
525 | void (*elf_info_to_howto_rel) |
526 | PARAMS ((bfd *, arelent *, Elf_Internal_Rel *)); | |
252b5132 RH |
527 | |
528 | /* A function to determine whether a symbol is global when | |
529 | partitioning the symbol table into local and global symbols. | |
530 | This should be NULL for most targets, in which case the correct | |
531 | thing will be done. MIPS ELF, at least on the Irix 5, has | |
532 | special requirements. */ | |
dc810e39 AM |
533 | boolean (*elf_backend_sym_is_global) |
534 | PARAMS ((bfd *, asymbol *)); | |
252b5132 RH |
535 | |
536 | /* The remaining functions are hooks which are called only if they | |
537 | are not NULL. */ | |
538 | ||
539 | /* A function to permit a backend specific check on whether a | |
540 | particular BFD format is relevant for an object file, and to | |
541 | permit the backend to set any global information it wishes. When | |
542 | this is called elf_elfheader is set, but anything else should be | |
543 | used with caution. If this returns false, the check_format | |
544 | routine will return a bfd_error_wrong_format error. */ | |
dc810e39 AM |
545 | boolean (*elf_backend_object_p) |
546 | PARAMS ((bfd *)); | |
252b5132 RH |
547 | |
548 | /* A function to do additional symbol processing when reading the | |
549 | ELF symbol table. This is where any processor-specific special | |
550 | section indices are handled. */ | |
dc810e39 AM |
551 | void (*elf_backend_symbol_processing) |
552 | PARAMS ((bfd *, asymbol *)); | |
252b5132 RH |
553 | |
554 | /* A function to do additional symbol processing after reading the | |
555 | entire ELF symbol table. */ | |
dc810e39 AM |
556 | boolean (*elf_backend_symbol_table_processing) |
557 | PARAMS ((bfd *, elf_symbol_type *, unsigned int)); | |
252b5132 RH |
558 | |
559 | /* A function to set the type of the info field. Processor-specific | |
3e932841 | 560 | types should be handled here. */ |
dc810e39 AM |
561 | int (*elf_backend_get_symbol_type) |
562 | PARAMS (( Elf_Internal_Sym *, int)); | |
60bcf0fa | 563 | |
252b5132 RH |
564 | /* A function to do additional processing on the ELF section header |
565 | just before writing it out. This is used to set the flags and | |
566 | type fields for some sections, or to actually write out data for | |
567 | unusual sections. */ | |
dc810e39 AM |
568 | boolean (*elf_backend_section_processing) |
569 | PARAMS ((bfd *, Elf32_Internal_Shdr *)); | |
252b5132 RH |
570 | |
571 | /* A function to handle unusual section types when creating BFD | |
572 | sections from ELF sections. */ | |
dc810e39 | 573 | boolean (*elf_backend_section_from_shdr) |
90937f86 | 574 | PARAMS ((bfd *, Elf32_Internal_Shdr *, const char *)); |
252b5132 | 575 | |
fa152c49 JW |
576 | /* A function to convert machine dependent section header flags to |
577 | BFD internal section header flags. */ | |
dc810e39 AM |
578 | boolean (*elf_backend_section_flags) |
579 | PARAMS ((flagword *, Elf32_Internal_Shdr *)); | |
fa152c49 | 580 | |
20cfcaae | 581 | /* A function to handle unusual program segment types when creating BFD |
3e932841 | 582 | sections from ELF program segments. */ |
dc810e39 AM |
583 | boolean (*elf_backend_section_from_phdr) |
584 | PARAMS ((bfd *, Elf32_Internal_Phdr *, int)); | |
20cfcaae | 585 | |
252b5132 RH |
586 | /* A function to set up the ELF section header for a BFD section in |
587 | preparation for writing it out. This is where the flags and type | |
588 | fields are set for unusual sections. */ | |
dc810e39 AM |
589 | boolean (*elf_backend_fake_sections) |
590 | PARAMS ((bfd *, Elf32_Internal_Shdr *, asection *)); | |
252b5132 RH |
591 | |
592 | /* A function to get the ELF section index for a BFD section. If | |
593 | this returns true, the section was found. If it is a normal ELF | |
594 | section, *RETVAL should be left unchanged. If it is not a normal | |
595 | ELF section *RETVAL should be set to the SHN_xxxx index. */ | |
596 | boolean (*elf_backend_section_from_bfd_section) | |
af746e92 | 597 | PARAMS ((bfd *, asection *, int *retval)); |
252b5132 RH |
598 | |
599 | /* If this field is not NULL, it is called by the add_symbols phase | |
600 | of a link just before adding a symbol to the global linker hash | |
601 | table. It may modify any of the fields as it wishes. If *NAME | |
602 | is set to NULL, the symbol will be skipped rather than being | |
603 | added to the hash table. This function is responsible for | |
604 | handling all processor dependent symbol bindings and section | |
605 | indices, and must set at least *FLAGS and *SEC for each processor | |
606 | dependent case; failure to do so will cause a link error. */ | |
607 | boolean (*elf_add_symbol_hook) | |
608 | PARAMS ((bfd *abfd, struct bfd_link_info *info, | |
609 | const Elf_Internal_Sym *, const char **name, | |
610 | flagword *flags, asection **sec, bfd_vma *value)); | |
611 | ||
612 | /* If this field is not NULL, it is called by the elf_link_output_sym | |
613 | phase of a link for each symbol which will appear in the object file. */ | |
614 | boolean (*elf_backend_link_output_symbol_hook) | |
615 | PARAMS ((bfd *, struct bfd_link_info *info, const char *, | |
616 | Elf_Internal_Sym *, asection *)); | |
617 | ||
618 | /* The CREATE_DYNAMIC_SECTIONS function is called by the ELF backend | |
619 | linker the first time it encounters a dynamic object in the link. | |
620 | This function must create any sections required for dynamic | |
621 | linking. The ABFD argument is a dynamic object. The .interp, | |
622 | .dynamic, .dynsym, .dynstr, and .hash functions have already been | |
623 | created, and this function may modify the section flags if | |
624 | desired. This function will normally create the .got and .plt | |
625 | sections, but different backends have different requirements. */ | |
626 | boolean (*elf_backend_create_dynamic_sections) | |
627 | PARAMS ((bfd *abfd, struct bfd_link_info *info)); | |
628 | ||
629 | /* The CHECK_RELOCS function is called by the add_symbols phase of | |
630 | the ELF backend linker. It is called once for each section with | |
631 | relocs of an object file, just after the symbols for the object | |
632 | file have been added to the global linker hash table. The | |
633 | function must look through the relocs and do any special handling | |
634 | required. This generally means allocating space in the global | |
635 | offset table, and perhaps allocating space for a reloc. The | |
636 | relocs are always passed as Rela structures; if the section | |
637 | actually uses Rel structures, the r_addend field will always be | |
638 | zero. */ | |
639 | boolean (*check_relocs) | |
640 | PARAMS ((bfd *abfd, struct bfd_link_info *info, asection *o, | |
641 | const Elf_Internal_Rela *relocs)); | |
642 | ||
643 | /* The ADJUST_DYNAMIC_SYMBOL function is called by the ELF backend | |
644 | linker for every symbol which is defined by a dynamic object and | |
645 | referenced by a regular object. This is called after all the | |
646 | input files have been seen, but before the SIZE_DYNAMIC_SECTIONS | |
647 | function has been called. The hash table entry should be | |
648 | bfd_link_hash_defined ore bfd_link_hash_defweak, and it should be | |
649 | defined in a section from a dynamic object. Dynamic object | |
650 | sections are not included in the final link, and this function is | |
651 | responsible for changing the value to something which the rest of | |
652 | the link can deal with. This will normally involve adding an | |
653 | entry to the .plt or .got or some such section, and setting the | |
654 | symbol to point to that. */ | |
655 | boolean (*elf_backend_adjust_dynamic_symbol) | |
656 | PARAMS ((struct bfd_link_info *info, struct elf_link_hash_entry *h)); | |
657 | ||
658 | /* The ALWAYS_SIZE_SECTIONS function is called by the backend linker | |
659 | after all the linker input files have been seen but before the | |
660 | section sizes have been set. This is called after | |
661 | ADJUST_DYNAMIC_SYMBOL, but before SIZE_DYNAMIC_SECTIONS. */ | |
662 | boolean (*elf_backend_always_size_sections) | |
663 | PARAMS ((bfd *output_bfd, struct bfd_link_info *info)); | |
664 | ||
665 | /* The SIZE_DYNAMIC_SECTIONS function is called by the ELF backend | |
666 | linker after all the linker input files have been seen but before | |
667 | the sections sizes have been set. This is called after | |
668 | ADJUST_DYNAMIC_SYMBOL has been called on all appropriate symbols. | |
669 | It is only called when linking against a dynamic object. It must | |
670 | set the sizes of the dynamic sections, and may fill in their | |
671 | contents as well. The generic ELF linker can handle the .dynsym, | |
672 | .dynstr and .hash sections. This function must handle the | |
673 | .interp section and any sections created by the | |
674 | CREATE_DYNAMIC_SECTIONS entry point. */ | |
675 | boolean (*elf_backend_size_dynamic_sections) | |
676 | PARAMS ((bfd *output_bfd, struct bfd_link_info *info)); | |
677 | ||
678 | /* The RELOCATE_SECTION function is called by the ELF backend linker | |
679 | to handle the relocations for a section. | |
680 | ||
681 | The relocs are always passed as Rela structures; if the section | |
682 | actually uses Rel structures, the r_addend field will always be | |
683 | zero. | |
684 | ||
685 | This function is responsible for adjust the section contents as | |
686 | necessary, and (if using Rela relocs and generating a | |
687 | relocateable output file) adjusting the reloc addend as | |
688 | necessary. | |
689 | ||
690 | This function does not have to worry about setting the reloc | |
691 | address or the reloc symbol index. | |
692 | ||
693 | LOCAL_SYMS is a pointer to the swapped in local symbols. | |
694 | ||
695 | LOCAL_SECTIONS is an array giving the section in the input file | |
696 | corresponding to the st_shndx field of each local symbol. | |
697 | ||
698 | The global hash table entry for the global symbols can be found | |
699 | via elf_sym_hashes (input_bfd). | |
700 | ||
701 | When generating relocateable output, this function must handle | |
702 | STB_LOCAL/STT_SECTION symbols specially. The output symbol is | |
703 | going to be the section symbol corresponding to the output | |
704 | section, which means that the addend must be adjusted | |
705 | accordingly. */ | |
706 | boolean (*elf_backend_relocate_section) | |
707 | PARAMS ((bfd *output_bfd, struct bfd_link_info *info, | |
708 | bfd *input_bfd, asection *input_section, bfd_byte *contents, | |
709 | Elf_Internal_Rela *relocs, Elf_Internal_Sym *local_syms, | |
710 | asection **local_sections)); | |
711 | ||
712 | /* The FINISH_DYNAMIC_SYMBOL function is called by the ELF backend | |
713 | linker just before it writes a symbol out to the .dynsym section. | |
714 | The processor backend may make any required adjustment to the | |
715 | symbol. It may also take the opportunity to set contents of the | |
716 | dynamic sections. Note that FINISH_DYNAMIC_SYMBOL is called on | |
717 | all .dynsym symbols, while ADJUST_DYNAMIC_SYMBOL is only called | |
718 | on those symbols which are defined by a dynamic object. */ | |
719 | boolean (*elf_backend_finish_dynamic_symbol) | |
720 | PARAMS ((bfd *output_bfd, struct bfd_link_info *info, | |
721 | struct elf_link_hash_entry *h, Elf_Internal_Sym *sym)); | |
722 | ||
723 | /* The FINISH_DYNAMIC_SECTIONS function is called by the ELF backend | |
724 | linker just before it writes all the dynamic sections out to the | |
725 | output file. The FINISH_DYNAMIC_SYMBOL will have been called on | |
726 | all dynamic symbols. */ | |
727 | boolean (*elf_backend_finish_dynamic_sections) | |
728 | PARAMS ((bfd *output_bfd, struct bfd_link_info *info)); | |
729 | ||
730 | /* A function to do any beginning processing needed for the ELF file | |
731 | before building the ELF headers and computing file positions. */ | |
732 | void (*elf_backend_begin_write_processing) | |
733 | PARAMS ((bfd *, struct bfd_link_info *)); | |
734 | ||
735 | /* A function to do any final processing needed for the ELF file | |
736 | before writing it out. The LINKER argument is true if this BFD | |
737 | was created by the ELF backend linker. */ | |
738 | void (*elf_backend_final_write_processing) | |
739 | PARAMS ((bfd *, boolean linker)); | |
740 | ||
741 | /* This function is called by get_program_header_size. It should | |
742 | return the number of additional program segments which this BFD | |
743 | will need. It should return -1 on error. */ | |
dc810e39 AM |
744 | int (*elf_backend_additional_program_headers) |
745 | PARAMS ((bfd *)); | |
252b5132 RH |
746 | |
747 | /* This function is called to modify an existing segment map in a | |
748 | backend specific fashion. */ | |
dc810e39 AM |
749 | boolean (*elf_backend_modify_segment_map) |
750 | PARAMS ((bfd *)); | |
252b5132 RH |
751 | |
752 | /* This function is called during section gc to discover the section a | |
1e2f5b6e | 753 | particular relocation refers to. */ |
252b5132 | 754 | asection * (*gc_mark_hook) |
1e2f5b6e | 755 | PARAMS ((asection *sec, struct bfd_link_info *, Elf_Internal_Rela *, |
252b5132 RH |
756 | struct elf_link_hash_entry *h, Elf_Internal_Sym *)); |
757 | ||
758 | /* This function, if defined, is called during the sweep phase of gc | |
759 | in order that a backend might update any data structures it might | |
760 | be maintaining. */ | |
761 | boolean (*gc_sweep_hook) | |
762 | PARAMS ((bfd *abfd, struct bfd_link_info *info, asection *o, | |
763 | const Elf_Internal_Rela *relocs)); | |
764 | ||
e6c51ed4 NC |
765 | /* This function, if defined, is called after the ELF headers have |
766 | been created. This allows for things like the OS and ABI versions | |
767 | to be changed. */ | |
768 | void (*elf_backend_post_process_headers) | |
769 | PARAMS ((bfd *, struct bfd_link_info *)); | |
770 | ||
587ff49e RH |
771 | /* This function, if defined, prints a symbol to file and returns the |
772 | name of the symbol to be printed. It should return NULL to fall | |
773 | back to default symbol printing. */ | |
774 | const char *(*elf_backend_print_symbol_all) | |
775 | PARAMS ((bfd *, PTR, asymbol *)); | |
776 | ||
777 | /* This function, if defined, is called after all local symbols and | |
778 | global symbols converted to locals are emited into the symtab | |
779 | section. It allows the backend to emit special global symbols | |
780 | not handled in the hash table. */ | |
781 | boolean (*elf_backend_output_arch_syms) | |
782 | PARAMS ((bfd *, struct bfd_link_info *, PTR, | |
dc810e39 | 783 | boolean (*) (PTR, const char *, Elf_Internal_Sym *, asection *))); |
587ff49e | 784 | |
d4c88bbb | 785 | /* Copy any information related to dynamic linking from a pre-existing |
0a991dfe AM |
786 | symbol to a newly created symbol. Also called to copy flags and |
787 | other back-end info to a weakdef, in which case the symbol is not | |
788 | newly created and plt/got refcounts and dynamic indices should not | |
789 | be copied. */ | |
c61b8717 | 790 | void (*elf_backend_copy_indirect_symbol) |
b48fa14c AM |
791 | PARAMS ((struct elf_backend_data *, struct elf_link_hash_entry *, |
792 | struct elf_link_hash_entry *)); | |
c61b8717 RH |
793 | |
794 | /* Modify any information related to dynamic linking such that the | |
795 | symbol is not exported. */ | |
796 | void (*elf_backend_hide_symbol) | |
e5094212 | 797 | PARAMS ((struct bfd_link_info *, struct elf_link_hash_entry *, boolean)); |
c61b8717 | 798 | |
9317eacc CM |
799 | /* Emit relocations. Overrides default routine for emitting relocs, |
800 | except during a relocatable link, or if all relocs are being emitted. */ | |
41241523 | 801 | boolean (*elf_backend_emit_relocs) |
9317eacc CM |
802 | PARAMS ((bfd *, asection *, Elf_Internal_Shdr *, Elf_Internal_Rela *)); |
803 | ||
804 | /* Count relocations. Not called for relocatable links | |
805 | or if all relocs are being preserved in the output. */ | |
806 | unsigned int (*elf_backend_count_relocs) | |
807 | PARAMS ((asection *, Elf_Internal_Rela *)); | |
808 | ||
bb0082d6 AM |
809 | /* This function, if defined, is called when an NT_PRSTATUS note is found |
810 | in a core file. */ | |
dc810e39 AM |
811 | boolean (*elf_backend_grok_prstatus) |
812 | PARAMS ((bfd *, Elf_Internal_Note *)); | |
bb0082d6 AM |
813 | |
814 | /* This function, if defined, is called when an NT_PSINFO or NT_PRPSINFO | |
815 | note is found in a core file. */ | |
dc810e39 AM |
816 | boolean (*elf_backend_grok_psinfo) |
817 | PARAMS ((bfd *, Elf_Internal_Note *)); | |
bb0082d6 | 818 | |
db6751f2 | 819 | /* Functions to print VMAs. Special code to handle 64 bit ELF files. */ |
dc810e39 AM |
820 | void (* elf_backend_sprintf_vma) |
821 | PARAMS ((bfd *, char *, bfd_vma)); | |
822 | void (* elf_backend_fprintf_vma) | |
823 | PARAMS ((bfd *, PTR, bfd_vma)); | |
4e771d61 | 824 | |
db6751f2 | 825 | /* This function returns class of a reloc type. */ |
f51e552e AM |
826 | enum elf_reloc_type_class (*elf_backend_reloc_type_class) |
827 | PARAMS ((const Elf_Internal_Rela *)); | |
db6751f2 | 828 | |
73d074b4 DJ |
829 | /* This function, if defined, removes information about discarded functions |
830 | from other sections which mention them. */ | |
831 | boolean (*elf_backend_discard_info) | |
832 | PARAMS ((bfd *, struct elf_reloc_cookie *, struct bfd_link_info *)); | |
833 | ||
834 | /* This function, if defined, signals that the function above has removed | |
835 | the discarded relocations for this section. */ | |
836 | boolean (*elf_backend_ignore_discarded_relocs) | |
837 | PARAMS ((asection *)); | |
838 | ||
839 | /* This function, if defined, may write out the given section. | |
840 | Returns true if it did so and false if the caller should. */ | |
841 | boolean (*elf_backend_write_section) | |
842 | PARAMS ((bfd *, asection *, bfd_byte *)); | |
843 | ||
c6e90b02 TS |
844 | /* The level of IRIX compatibility we're striving for. |
845 | MIPS ELF specific function. */ | |
846 | irix_compat_t (*elf_backend_mips_irix_compat) | |
847 | PARAMS ((bfd *)); | |
848 | ||
849 | reloc_howto_type *(*elf_backend_mips_rtype_to_howto) | |
850 | PARAMS ((unsigned int, boolean)); | |
851 | ||
252b5132 RH |
852 | /* The swapping table to use when dealing with ECOFF information. |
853 | Used for the MIPS ELF .mdebug section. */ | |
854 | const struct ecoff_debug_swap *elf_backend_ecoff_debug_swap; | |
855 | ||
856 | /* Alternate EM_xxxx machine codes for this backend. */ | |
857 | int elf_machine_alt1; | |
858 | int elf_machine_alt2; | |
859 | ||
860 | const struct elf_size_info *s; | |
861 | ||
862 | /* offset of the _GLOBAL_OFFSET_TABLE_ symbol from the start of the | |
863 | .got section */ | |
864 | bfd_vma got_symbol_offset; | |
865 | ||
866 | /* The size in bytes of the headers for the GOT and PLT. This includes | |
867 | the so-called reserved entries on some systems. */ | |
868 | bfd_vma got_header_size; | |
869 | bfd_vma plt_header_size; | |
870 | ||
86dc0f79 RH |
871 | /* This is true if the linker should act like collect and gather |
872 | global constructors and destructors by name. This is true for | |
873 | MIPS ELF because the Irix 5 tools can not handle the .init | |
874 | section. */ | |
875 | unsigned collect : 1; | |
876 | ||
877 | /* This is true if the linker should ignore changes to the type of a | |
878 | symbol. This is true for MIPS ELF because some Irix 5 objects | |
879 | record undefined functions as STT_OBJECT although the definitions | |
880 | are STT_FUNC. */ | |
881 | unsigned type_change_ok : 1; | |
882 | ||
bf572ba0 MM |
883 | /* Whether the backend may use REL relocations. (Some backends use |
884 | both REL and RELA relocations, and this flag is set for those | |
885 | backends.) */ | |
886 | unsigned may_use_rel_p : 1; | |
60bcf0fa | 887 | |
bf572ba0 MM |
888 | /* Whether the backend may use RELA relocations. (Some backends use |
889 | both REL and RELA relocations, and this flag is set for those | |
890 | backends.) */ | |
891 | unsigned may_use_rela_p : 1; | |
892 | ||
893 | /* Whether the default relocation type is RELA. If a backend with | |
894 | this flag set wants REL relocations for a particular section, | |
895 | it must note that explicitly. Similarly, if this flag is clear, | |
60bcf0fa NC |
896 | and the backend wants RELA relocations for a particular |
897 | section. */ | |
bf572ba0 MM |
898 | unsigned default_use_rela_p : 1; |
899 | ||
b491616a AM |
900 | /* Set if RELA relocations for a relocatable link can be handled by |
901 | generic code. Backends that set this flag need do nothing in the | |
902 | backend relocate_section routine for relocatable linking. */ | |
903 | unsigned rela_normal : 1; | |
904 | ||
86dc0f79 RH |
905 | /* True if addresses "naturally" sign extend. This is used when |
906 | swapping in from Elf32 when BFD64. */ | |
907 | unsigned sign_extend_vma : 1; | |
908 | ||
252b5132 RH |
909 | unsigned want_got_plt : 1; |
910 | unsigned plt_readonly : 1; | |
911 | unsigned want_plt_sym : 1; | |
912 | unsigned plt_not_loaded : 1; | |
913 | unsigned plt_alignment : 4; | |
914 | unsigned can_gc_sections : 1; | |
51b64d56 | 915 | unsigned can_refcount : 1; |
2517a57f | 916 | unsigned want_got_sym : 1; |
3018b441 | 917 | unsigned want_dynbss : 1; |
5e8d7549 NC |
918 | /* Targets which do not support physical addressing often require |
919 | that the p_paddr field in the section header to be set to zero. | |
920 | This field indicates whether this behavior is required. */ | |
921 | unsigned want_p_paddr_set_to_zero : 1; | |
252b5132 RH |
922 | }; |
923 | ||
924 | /* Information stored for each BFD section in an ELF file. This | |
925 | structure is allocated by elf_new_section_hook. */ | |
926 | ||
927 | struct bfd_elf_section_data | |
928 | { | |
929 | /* The ELF header for this section. */ | |
930 | Elf_Internal_Shdr this_hdr; | |
0c715baa | 931 | |
252b5132 RH |
932 | /* The ELF header for the reloc section associated with this |
933 | section, if any. */ | |
934 | Elf_Internal_Shdr rel_hdr; | |
0c715baa | 935 | |
252b5132 RH |
936 | /* If there is a second reloc section associated with this section, |
937 | as can happen on Irix 6, this field points to the header. */ | |
938 | Elf_Internal_Shdr *rel_hdr2; | |
0c715baa | 939 | |
23bc299b MM |
940 | /* The number of relocations currently assigned to REL_HDR. */ |
941 | unsigned int rel_count; | |
0c715baa | 942 | |
23bc299b MM |
943 | /* The number of relocations currently assigned to REL_HDR2. */ |
944 | unsigned int rel_count2; | |
0c715baa | 945 | |
ec338859 AM |
946 | /* A pointer to a linked list tracking dynamic relocs copied for |
947 | local symbols. */ | |
948 | PTR local_dynrel; | |
0c715baa AM |
949 | |
950 | /* A pointer to the bfd section used for dynamic relocs. */ | |
951 | asection *sreloc; | |
952 | ||
252b5132 RH |
953 | /* The ELF section number of this section. Only used for an output |
954 | file. */ | |
955 | int this_idx; | |
0c715baa | 956 | |
23bc299b MM |
957 | /* The ELF section number of the reloc section indicated by |
958 | REL_HDR if any. Only used for an output file. */ | |
252b5132 | 959 | int rel_idx; |
0c715baa | 960 | |
23bc299b MM |
961 | /* The ELF section number of the reloc section indicated by |
962 | REL_HDR2 if any. Only used for an output file. */ | |
963 | int rel_idx2; | |
0c715baa | 964 | |
252b5132 RH |
965 | /* Used by the backend linker to store the symbol hash table entries |
966 | associated with relocs against global symbols. */ | |
967 | struct elf_link_hash_entry **rel_hashes; | |
0c715baa | 968 | |
252b5132 RH |
969 | /* A pointer to the swapped relocs. If the section uses REL relocs, |
970 | rather than RELA, all the r_addend fields will be zero. This | |
971 | pointer may be NULL. It is used by the backend linker. */ | |
972 | Elf_Internal_Rela *relocs; | |
0c715baa | 973 | |
252b5132 RH |
974 | /* Used by the backend linker when generating a shared library to |
975 | record the dynamic symbol index for a section symbol | |
75945f9f ILT |
976 | corresponding to this section. A value of 0 means that there is |
977 | no dynamic symbol for this section. */ | |
252b5132 | 978 | long dynindx; |
0c715baa | 979 | |
65765700 JJ |
980 | /* A pointer used for various section optimizations. */ |
981 | PTR sec_info; | |
0c715baa | 982 | |
65765700 JJ |
983 | /* Type of that information. */ |
984 | enum elf_link_info_type sec_info_type; | |
0c715baa | 985 | |
1126897b AM |
986 | union { |
987 | /* Group name, if this section is a member of a group. */ | |
988 | const char *name; | |
989 | ||
990 | /* Group signature sym, if this is the SHT_GROUP section. */ | |
991 | struct symbol_cache_entry *id; | |
992 | } group; | |
dbb410c3 AM |
993 | |
994 | /* A linked list of sections in the group. Circular when used by | |
995 | the linker. */ | |
996 | asection *next_in_group; | |
997 | ||
252b5132 RH |
998 | /* A pointer available for the processor specific ELF backend. */ |
999 | PTR tdata; | |
0c715baa | 1000 | |
bf572ba0 MM |
1001 | /* Nonzero if this section uses RELA relocations, rather than REL. */ |
1002 | unsigned int use_rela_p:1; | |
b885599b AM |
1003 | |
1004 | /* Nonzero when a group is COMDAT. */ | |
1005 | unsigned int linkonce_p:1; | |
252b5132 RH |
1006 | }; |
1007 | ||
1008 | #define elf_section_data(sec) ((struct bfd_elf_section_data*)sec->used_by_bfd) | |
1126897b AM |
1009 | #define elf_group_name(sec) (elf_section_data(sec)->group.name) |
1010 | #define elf_group_id(sec) (elf_section_data(sec)->group.id) | |
945906ff | 1011 | #define elf_next_in_group(sec) (elf_section_data(sec)->next_in_group) |
b885599b | 1012 | #define elf_linkonce_p(sec) (elf_section_data(sec)->linkonce_p) |
252b5132 | 1013 | |
ed4de5e2 JJ |
1014 | /* Return true if section has been discarded. */ |
1015 | #define elf_discarded_section(sec) \ | |
1016 | (!bfd_is_abs_section(sec) \ | |
1017 | && bfd_is_abs_section((sec)->output_section) \ | |
2d653fc7 AM |
1018 | && elf_section_data (sec)->sec_info_type != ELF_INFO_TYPE_MERGE \ |
1019 | && elf_section_data (sec)->sec_info_type != ELF_INFO_TYPE_JUST_SYMS) | |
ed4de5e2 | 1020 | |
252b5132 RH |
1021 | #define get_elf_backend_data(abfd) \ |
1022 | ((struct elf_backend_data *) (abfd)->xvec->backend_data) | |
1023 | ||
1024 | /* Enumeration to specify the special section. */ | |
1025 | typedef enum elf_linker_section_enum | |
1026 | { | |
1027 | LINKER_SECTION_UNKNOWN, /* not used */ | |
1028 | LINKER_SECTION_GOT, /* .got section for global offset pointers */ | |
1029 | LINKER_SECTION_PLT, /* .plt section for generated procedure stubs */ | |
1030 | LINKER_SECTION_SDATA, /* .sdata/.sbss section for PowerPC */ | |
1031 | LINKER_SECTION_SDATA2, /* .sdata2/.sbss2 section for PowerPC */ | |
1032 | LINKER_SECTION_MAX /* # of linker sections */ | |
1033 | } elf_linker_section_enum_t; | |
1034 | ||
1035 | /* Sections created by the linker. */ | |
1036 | ||
1037 | typedef struct elf_linker_section | |
1038 | { | |
1039 | char *name; /* name of the section */ | |
1040 | char *rel_name; /* name of the associated .rel{,a}. section */ | |
1041 | char *bss_name; /* name of a related .bss section */ | |
1042 | char *sym_name; /* name of symbol to reference this section */ | |
1043 | asection *section; /* pointer to the section */ | |
1044 | asection *bss_section; /* pointer to the bss section associated with this */ | |
1045 | asection *rel_section; /* pointer to the relocations needed for this section */ | |
1046 | struct elf_link_hash_entry *sym_hash; /* pointer to the created symbol hash value */ | |
1047 | bfd_vma initial_size; /* initial size before any linker generated allocations */ | |
1048 | bfd_vma sym_offset; /* offset of symbol from beginning of section */ | |
1049 | bfd_vma hole_size; /* size of reserved address hole in allocation */ | |
1050 | bfd_vma hole_offset; /* current offset for the hole */ | |
1051 | bfd_vma max_hole_offset; /* maximum offset for the hole */ | |
1052 | elf_linker_section_enum_t which; /* which section this is */ | |
1053 | boolean hole_written_p; /* whether the hole has been initialized */ | |
1054 | unsigned int alignment; /* alignment for the section */ | |
1055 | flagword flags; /* flags to use to create the section */ | |
1056 | } elf_linker_section_t; | |
1057 | ||
1058 | /* Linked list of allocated pointer entries. This hangs off of the symbol lists, and | |
1059 | provides allows us to return different pointers, based on different addend's. */ | |
1060 | ||
1061 | typedef struct elf_linker_section_pointers | |
1062 | { | |
1063 | struct elf_linker_section_pointers *next; /* next allocated pointer for this symbol */ | |
1064 | bfd_vma offset; /* offset of pointer from beginning of section */ | |
dc810e39 | 1065 | bfd_vma addend; /* addend used */ |
252b5132 RH |
1066 | elf_linker_section_enum_t which; /* which linker section this is */ |
1067 | boolean written_address_p; /* whether address was written yet */ | |
1068 | } elf_linker_section_pointers_t; | |
1069 | ||
1070 | /* Some private data is stashed away for future use using the tdata pointer | |
1071 | in the bfd structure. */ | |
1072 | ||
1073 | struct elf_obj_tdata | |
1074 | { | |
1075 | Elf_Internal_Ehdr elf_header[1]; /* Actual data, but ref like ptr */ | |
1076 | Elf_Internal_Shdr **elf_sect_ptr; | |
1077 | Elf_Internal_Phdr *phdr; | |
1078 | struct elf_segment_map *segment_map; | |
2b0f7ef9 | 1079 | struct elf_strtab_hash *strtab_ptr; |
252b5132 RH |
1080 | int num_locals; |
1081 | int num_globals; | |
9ad5cbcf | 1082 | unsigned int num_elf_sections; /* elf_sect_ptr size */ |
4e89ac30 | 1083 | int num_section_syms; |
252b5132 RH |
1084 | asymbol **section_syms; /* STT_SECTION symbols for each section */ |
1085 | Elf_Internal_Shdr symtab_hdr; | |
1086 | Elf_Internal_Shdr shstrtab_hdr; | |
1087 | Elf_Internal_Shdr strtab_hdr; | |
1088 | Elf_Internal_Shdr dynsymtab_hdr; | |
1089 | Elf_Internal_Shdr dynstrtab_hdr; | |
1090 | Elf_Internal_Shdr dynversym_hdr; | |
1091 | Elf_Internal_Shdr dynverref_hdr; | |
1092 | Elf_Internal_Shdr dynverdef_hdr; | |
9ad5cbcf | 1093 | Elf_Internal_Shdr symtab_shndx_hdr; |
252b5132 RH |
1094 | unsigned int symtab_section, shstrtab_section; |
1095 | unsigned int strtab_section, dynsymtab_section; | |
9ad5cbcf | 1096 | unsigned int symtab_shndx_section; |
252b5132 RH |
1097 | unsigned int dynversym_section, dynverdef_section, dynverref_section; |
1098 | file_ptr next_file_pos; | |
1099 | #if 0 | |
1100 | /* we don't need these inside bfd anymore, and I think | |
3e932841 | 1101 | these weren't used outside bfd. */ |
252b5132 RH |
1102 | void *prstatus; /* The raw /proc prstatus structure */ |
1103 | void *prpsinfo; /* The raw /proc prpsinfo structure */ | |
1104 | #endif | |
dbb410c3 AM |
1105 | bfd_vma gp; /* The gp value */ |
1106 | unsigned int gp_size; /* The gp size */ | |
1107 | ||
1108 | Elf_Internal_Shdr **group_sect_ptr; | |
1109 | int num_group; | |
252b5132 | 1110 | |
3e932841 | 1111 | /* Information grabbed from an elf core file. */ |
252b5132 RH |
1112 | int core_signal; |
1113 | int core_pid; | |
1114 | int core_lwpid; | |
1115 | char* core_program; | |
1116 | char* core_command; | |
1117 | ||
1118 | /* This is set to true if the object was created by the backend | |
1119 | linker. */ | |
1120 | boolean linker; | |
1121 | ||
1122 | /* A mapping from external symbols to entries in the linker hash | |
1123 | table, used when linking. This is indexed by the symbol index | |
1124 | minus the sh_info field of the symbol table header. */ | |
1125 | struct elf_link_hash_entry **sym_hashes; | |
1126 | ||
1127 | /* A mapping from local symbols to offsets into the global offset | |
1128 | table, used when linking. This is indexed by the symbol index. | |
1129 | Like for the globals, we use a union and two names primarily to | |
1130 | document the intent of any particular piece of code. The field | |
1131 | should be used as a count until size_dynamic_sections, at which | |
1132 | point the contents of the .got is fixed. Afterward, if an entry | |
3e932841 | 1133 | is -1, then the symbol does not require a global offset table entry. */ |
252b5132 RH |
1134 | union |
1135 | { | |
1136 | bfd_signed_vma *refcounts; | |
1137 | bfd_vma *offsets; | |
1138 | } local_got; | |
1139 | ||
1140 | /* A mapping from local symbols to offsets into the various linker | |
1141 | sections added. This is index by the symbol index. */ | |
1142 | elf_linker_section_pointers_t **linker_section_pointers; | |
1143 | ||
1144 | /* The linker ELF emulation code needs to let the backend ELF linker | |
1145 | know what filename should be used for a dynamic object if the | |
1146 | dynamic object is found using a search. The emulation code then | |
1147 | sometimes needs to know what name was actually used. Until the | |
1148 | file has been added to the linker symbol table, this field holds | |
1149 | the name the linker wants. After it has been added, it holds the | |
1150 | name actually used, which will be the DT_SONAME entry if there is | |
1151 | one. */ | |
1152 | const char *dt_name; | |
1153 | ||
74816898 L |
1154 | /* When a reference in a regular object is resolved by a shared |
1155 | object is loaded into via the DT_NEEDED entries by the linker | |
1156 | ELF emulation code, we need to add the shared object to the | |
1157 | DT_NEEDED list of the resulting binary to indicate the dependency | |
1158 | as if the -l option is passed to the linker. This field holds the | |
3e932841 | 1159 | name of the loaded shared object. */ |
74816898 L |
1160 | const char *dt_soname; |
1161 | ||
252b5132 RH |
1162 | /* Irix 5 often screws up the symbol table, sorting local symbols |
1163 | after global symbols. This flag is set if the symbol table in | |
1164 | this BFD appears to be screwed up. If it is, we ignore the | |
1165 | sh_info field in the symbol table header, and always read all the | |
1166 | symbols. */ | |
1167 | boolean bad_symtab; | |
1168 | ||
1169 | /* Records the result of `get_program_header_size'. */ | |
1170 | bfd_size_type program_header_size; | |
1171 | ||
1172 | /* Used by find_nearest_line entry point. */ | |
1173 | PTR line_info; | |
1174 | ||
1175 | /* Used by MIPS ELF find_nearest_line entry point. The structure | |
1176 | could be included directly in this one, but there's no point to | |
1177 | wasting the memory just for the infrequently called | |
1178 | find_nearest_line. */ | |
1179 | struct mips_elf_find_line *find_line_info; | |
1180 | ||
3e932841 | 1181 | /* A place to stash dwarf1 info for this bfd. */ |
252b5132 RH |
1182 | struct dwarf1_debug *dwarf1_find_line_info; |
1183 | ||
3e932841 | 1184 | /* A place to stash dwarf2 info for this bfd. */ |
51db3708 | 1185 | PTR dwarf2_find_line_info; |
252b5132 RH |
1186 | |
1187 | /* An array of stub sections indexed by symbol number, used by the | |
1188 | MIPS ELF linker. FIXME: We should figure out some way to only | |
1189 | include this field for a MIPS ELF target. */ | |
1190 | asection **local_stubs; | |
1191 | ||
65765700 JJ |
1192 | /* Used to determine if PT_GNU_EH_FRAME segment header should be |
1193 | created. */ | |
126495ed AM |
1194 | asection *eh_frame_hdr; |
1195 | ||
1196 | /* Used to determine if the e_flags field has been initialized */ | |
1197 | boolean flags_init; | |
65765700 | 1198 | |
252b5132 RH |
1199 | /* Number of symbol version definitions we are about to emit. */ |
1200 | unsigned int cverdefs; | |
1201 | ||
1202 | /* Number of symbol version references we are about to emit. */ | |
1203 | unsigned int cverrefs; | |
1204 | ||
1205 | /* Symbol version definitions in external objects. */ | |
1206 | Elf_Internal_Verdef *verdef; | |
1207 | ||
1208 | /* Symbol version references to external objects. */ | |
1209 | Elf_Internal_Verneed *verref; | |
1210 | ||
1211 | /* Linker sections that we are interested in. */ | |
1212 | struct elf_linker_section *linker_section[ (int)LINKER_SECTION_MAX ]; | |
b305ef96 UC |
1213 | |
1214 | /* The Irix 5 support uses two virtual sections, which represent | |
1215 | text/data symbols defined in dynamic objects. */ | |
1216 | asymbol *elf_data_symbol; | |
1217 | asymbol *elf_text_symbol; | |
1218 | asection *elf_data_section; | |
1219 | asection *elf_text_section; | |
252b5132 RH |
1220 | }; |
1221 | ||
1222 | #define elf_tdata(bfd) ((bfd) -> tdata.elf_obj_data) | |
1223 | #define elf_elfheader(bfd) (elf_tdata(bfd) -> elf_header) | |
1224 | #define elf_elfsections(bfd) (elf_tdata(bfd) -> elf_sect_ptr) | |
9ad5cbcf | 1225 | #define elf_numsections(bfd) (elf_tdata(bfd) -> num_elf_sections) |
252b5132 RH |
1226 | #define elf_shstrtab(bfd) (elf_tdata(bfd) -> strtab_ptr) |
1227 | #define elf_onesymtab(bfd) (elf_tdata(bfd) -> symtab_section) | |
9ad5cbcf | 1228 | #define elf_symtab_shndx(bfd) (elf_tdata(bfd) -> symtab_shndx_section) |
252b5132 RH |
1229 | #define elf_dynsymtab(bfd) (elf_tdata(bfd) -> dynsymtab_section) |
1230 | #define elf_dynversym(bfd) (elf_tdata(bfd) -> dynversym_section) | |
1231 | #define elf_dynverdef(bfd) (elf_tdata(bfd) -> dynverdef_section) | |
1232 | #define elf_dynverref(bfd) (elf_tdata(bfd) -> dynverref_section) | |
1233 | #define elf_num_locals(bfd) (elf_tdata(bfd) -> num_locals) | |
1234 | #define elf_num_globals(bfd) (elf_tdata(bfd) -> num_globals) | |
1235 | #define elf_section_syms(bfd) (elf_tdata(bfd) -> section_syms) | |
4e89ac30 | 1236 | #define elf_num_section_syms(bfd) (elf_tdata(bfd) -> num_section_syms) |
252b5132 RH |
1237 | #define core_prpsinfo(bfd) (elf_tdata(bfd) -> prpsinfo) |
1238 | #define core_prstatus(bfd) (elf_tdata(bfd) -> prstatus) | |
1239 | #define elf_gp(bfd) (elf_tdata(bfd) -> gp) | |
1240 | #define elf_gp_size(bfd) (elf_tdata(bfd) -> gp_size) | |
1241 | #define elf_sym_hashes(bfd) (elf_tdata(bfd) -> sym_hashes) | |
1242 | #define elf_local_got_refcounts(bfd) (elf_tdata(bfd) -> local_got.refcounts) | |
1243 | #define elf_local_got_offsets(bfd) (elf_tdata(bfd) -> local_got.offsets) | |
1244 | #define elf_local_ptr_offsets(bfd) (elf_tdata(bfd) -> linker_section_pointers) | |
1245 | #define elf_dt_name(bfd) (elf_tdata(bfd) -> dt_name) | |
74816898 | 1246 | #define elf_dt_soname(bfd) (elf_tdata(bfd) -> dt_soname) |
252b5132 RH |
1247 | #define elf_bad_symtab(bfd) (elf_tdata(bfd) -> bad_symtab) |
1248 | #define elf_flags_init(bfd) (elf_tdata(bfd) -> flags_init) | |
1249 | #define elf_linker_section(bfd,n) (elf_tdata(bfd) -> linker_section[(int)n]) | |
1250 | \f | |
1251 | extern void _bfd_elf_swap_verdef_in | |
1252 | PARAMS ((bfd *, const Elf_External_Verdef *, Elf_Internal_Verdef *)); | |
1253 | extern void _bfd_elf_swap_verdef_out | |
1254 | PARAMS ((bfd *, const Elf_Internal_Verdef *, Elf_External_Verdef *)); | |
1255 | extern void _bfd_elf_swap_verdaux_in | |
1256 | PARAMS ((bfd *, const Elf_External_Verdaux *, Elf_Internal_Verdaux *)); | |
1257 | extern void _bfd_elf_swap_verdaux_out | |
1258 | PARAMS ((bfd *, const Elf_Internal_Verdaux *, Elf_External_Verdaux *)); | |
1259 | extern void _bfd_elf_swap_verneed_in | |
1260 | PARAMS ((bfd *, const Elf_External_Verneed *, Elf_Internal_Verneed *)); | |
1261 | extern void _bfd_elf_swap_verneed_out | |
1262 | PARAMS ((bfd *, const Elf_Internal_Verneed *, Elf_External_Verneed *)); | |
1263 | extern void _bfd_elf_swap_vernaux_in | |
1264 | PARAMS ((bfd *, const Elf_External_Vernaux *, Elf_Internal_Vernaux *)); | |
1265 | extern void _bfd_elf_swap_vernaux_out | |
1266 | PARAMS ((bfd *, const Elf_Internal_Vernaux *, Elf_External_Vernaux *)); | |
1267 | extern void _bfd_elf_swap_versym_in | |
1268 | PARAMS ((bfd *, const Elf_External_Versym *, Elf_Internal_Versym *)); | |
1269 | extern void _bfd_elf_swap_versym_out | |
1270 | PARAMS ((bfd *, const Elf_Internal_Versym *, Elf_External_Versym *)); | |
1271 | ||
dc810e39 AM |
1272 | extern int _bfd_elf_section_from_bfd_section |
1273 | PARAMS ((bfd *, asection *)); | |
252b5132 RH |
1274 | extern char *bfd_elf_string_from_elf_section |
1275 | PARAMS ((bfd *, unsigned, unsigned)); | |
dc810e39 AM |
1276 | extern char *bfd_elf_get_str_section |
1277 | PARAMS ((bfd *, unsigned)); | |
6cdc0ccc AM |
1278 | extern Elf_Internal_Sym *bfd_elf_get_elf_syms |
1279 | PARAMS ((bfd *, Elf_Internal_Shdr *, size_t, size_t, | |
1280 | Elf_Internal_Sym *, PTR, Elf_External_Sym_Shndx *)); | |
252b5132 | 1281 | |
2d502050 L |
1282 | extern boolean _bfd_elf_copy_private_bfd_data |
1283 | PARAMS ((bfd *, bfd *)); | |
dc810e39 AM |
1284 | extern boolean _bfd_elf_print_private_bfd_data |
1285 | PARAMS ((bfd *, PTR)); | |
1286 | extern void bfd_elf_print_symbol | |
1287 | PARAMS ((bfd *, PTR, asymbol *, bfd_print_symbol_type)); | |
1288 | ||
1289 | #define elf_string_from_elf_strtab(abfd, strindex) \ | |
1290 | bfd_elf_string_from_elf_section(abfd, elf_elfheader(abfd)->e_shstrndx, \ | |
1291 | strindex) | |
252b5132 RH |
1292 | |
1293 | #define bfd_elf32_print_symbol bfd_elf_print_symbol | |
1294 | #define bfd_elf64_print_symbol bfd_elf_print_symbol | |
1295 | ||
dc810e39 AM |
1296 | extern void _bfd_elf_sprintf_vma |
1297 | PARAMS ((bfd *, char *, bfd_vma)); | |
1298 | extern void _bfd_elf_fprintf_vma | |
1299 | PARAMS ((bfd *, PTR, bfd_vma)); | |
d69bb69b | 1300 | |
dc810e39 | 1301 | extern enum elf_reloc_type_class _bfd_elf_reloc_type_class |
f51e552e | 1302 | PARAMS ((const Elf_Internal_Rela *)); |
f8df10f4 JJ |
1303 | extern bfd_vma _bfd_elf_rela_local_sym |
1304 | PARAMS ((bfd *, Elf_Internal_Sym *, asection *, Elf_Internal_Rela *)); | |
c629eae0 JJ |
1305 | extern bfd_vma _bfd_elf_rel_local_sym |
1306 | PARAMS ((bfd *, Elf_Internal_Sym *, asection **, bfd_vma)); | |
1307 | extern bfd_vma _bfd_elf_section_offset | |
1308 | PARAMS ((bfd *, struct bfd_link_info *, asection *, bfd_vma)); | |
db6751f2 | 1309 | |
dc810e39 AM |
1310 | extern unsigned long bfd_elf_hash |
1311 | PARAMS ((const char *)); | |
252b5132 | 1312 | |
dc810e39 AM |
1313 | extern bfd_reloc_status_type bfd_elf_generic_reloc |
1314 | PARAMS ((bfd *, arelent *, asymbol *, PTR, asection *, bfd *, char **)); | |
1315 | extern boolean bfd_elf_mkobject | |
1316 | PARAMS ((bfd *)); | |
1317 | extern boolean bfd_elf_mkcorefile | |
1318 | PARAMS ((bfd *)); | |
1319 | extern Elf_Internal_Shdr *bfd_elf_find_section | |
1320 | PARAMS ((bfd *, char *)); | |
252b5132 | 1321 | extern boolean _bfd_elf_make_section_from_shdr |
dc810e39 | 1322 | PARAMS ((bfd *, Elf_Internal_Shdr *, const char *)); |
20cfcaae | 1323 | extern boolean _bfd_elf_make_section_from_phdr |
dc810e39 | 1324 | PARAMS ((bfd *, Elf_Internal_Phdr *, int, const char *)); |
252b5132 RH |
1325 | extern struct bfd_hash_entry *_bfd_elf_link_hash_newfunc |
1326 | PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *, const char *)); | |
1327 | extern struct bfd_link_hash_table *_bfd_elf_link_hash_table_create | |
1328 | PARAMS ((bfd *)); | |
c61b8717 | 1329 | extern void _bfd_elf_link_hash_copy_indirect |
b48fa14c AM |
1330 | PARAMS ((struct elf_backend_data *, struct elf_link_hash_entry *, |
1331 | struct elf_link_hash_entry *)); | |
c61b8717 | 1332 | extern void _bfd_elf_link_hash_hide_symbol |
e5094212 | 1333 | PARAMS ((struct bfd_link_info *, struct elf_link_hash_entry *, boolean)); |
252b5132 RH |
1334 | extern boolean _bfd_elf_link_hash_table_init |
1335 | PARAMS ((struct elf_link_hash_table *, bfd *, | |
1336 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, | |
1337 | struct bfd_hash_table *, | |
1338 | const char *))); | |
dc810e39 AM |
1339 | extern boolean _bfd_elf_slurp_version_tables |
1340 | PARAMS ((bfd *)); | |
8550eb6e JJ |
1341 | extern boolean _bfd_elf_merge_sections |
1342 | PARAMS ((bfd *, struct bfd_link_info *)); | |
e61463e1 AM |
1343 | extern boolean bfd_elf_discard_group |
1344 | PARAMS ((bfd *, struct sec *)); | |
1126897b AM |
1345 | extern void bfd_elf_set_group_contents |
1346 | PARAMS ((bfd *, asection *, PTR)); | |
2d653fc7 AM |
1347 | extern void _bfd_elf_link_just_syms |
1348 | PARAMS ((asection *, struct bfd_link_info *)); | |
252b5132 RH |
1349 | extern boolean _bfd_elf_copy_private_symbol_data |
1350 | PARAMS ((bfd *, asymbol *, bfd *, asymbol *)); | |
1351 | extern boolean _bfd_elf_copy_private_section_data | |
1352 | PARAMS ((bfd *, asection *, bfd *, asection *)); | |
dc810e39 AM |
1353 | extern boolean _bfd_elf_write_object_contents |
1354 | PARAMS ((bfd *)); | |
1355 | extern boolean _bfd_elf_write_corefile_contents | |
1356 | PARAMS ((bfd *)); | |
1357 | extern boolean _bfd_elf_set_section_contents | |
1358 | PARAMS ((bfd *, sec_ptr, PTR, file_ptr, bfd_size_type)); | |
1359 | extern long _bfd_elf_get_symtab_upper_bound | |
1360 | PARAMS ((bfd *)); | |
1361 | extern long _bfd_elf_get_symtab | |
1362 | PARAMS ((bfd *, asymbol **)); | |
1363 | extern long _bfd_elf_get_dynamic_symtab_upper_bound | |
1364 | PARAMS ((bfd *)); | |
1365 | extern long _bfd_elf_canonicalize_dynamic_symtab | |
1366 | PARAMS ((bfd *, asymbol **)); | |
1367 | extern long _bfd_elf_get_reloc_upper_bound | |
1368 | PARAMS ((bfd *, sec_ptr)); | |
1369 | extern long _bfd_elf_canonicalize_reloc | |
1370 | PARAMS ((bfd *, sec_ptr, arelent **, asymbol **)); | |
1371 | extern long _bfd_elf_get_dynamic_reloc_upper_bound | |
1372 | PARAMS ((bfd *)); | |
1373 | extern long _bfd_elf_canonicalize_dynamic_reloc | |
1374 | PARAMS ((bfd *, arelent **, asymbol **)); | |
1375 | extern asymbol *_bfd_elf_make_empty_symbol | |
1376 | PARAMS ((bfd *)); | |
1377 | extern void _bfd_elf_get_symbol_info | |
1378 | PARAMS ((bfd *, asymbol *, symbol_info *)); | |
1379 | extern boolean _bfd_elf_is_local_label_name | |
1380 | PARAMS ((bfd *, const char *)); | |
1381 | extern alent *_bfd_elf_get_lineno | |
1382 | PARAMS ((bfd *, asymbol *)); | |
1383 | extern boolean _bfd_elf_set_arch_mach | |
1384 | PARAMS ((bfd *, enum bfd_architecture, unsigned long)); | |
1385 | extern boolean _bfd_elf_find_nearest_line | |
1386 | PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **, | |
1387 | const char **, unsigned int *)); | |
252b5132 RH |
1388 | #define _bfd_elf_read_minisymbols _bfd_generic_read_minisymbols |
1389 | #define _bfd_elf_minisymbol_to_symbol _bfd_generic_minisymbol_to_symbol | |
dc810e39 AM |
1390 | extern int _bfd_elf_sizeof_headers |
1391 | PARAMS ((bfd *, boolean)); | |
1392 | extern boolean _bfd_elf_new_section_hook | |
1393 | PARAMS ((bfd *, asection *)); | |
60bcf0fa | 1394 | extern boolean _bfd_elf_init_reloc_shdr |
23bc299b | 1395 | PARAMS ((bfd *, Elf_Internal_Shdr *, asection *, boolean)); |
252b5132 RH |
1396 | |
1397 | /* If the target doesn't have reloc handling written yet: */ | |
dc810e39 AM |
1398 | extern void _bfd_elf_no_info_to_howto |
1399 | PARAMS ((bfd *, arelent *, Elf_Internal_Rela *)); | |
1400 | ||
1401 | extern boolean bfd_section_from_shdr | |
1402 | PARAMS ((bfd *, unsigned int shindex)); | |
1403 | extern boolean bfd_section_from_phdr | |
1404 | PARAMS ((bfd *, Elf_Internal_Phdr *, int)); | |
1405 | ||
1406 | extern int _bfd_elf_symbol_from_bfd_symbol | |
1407 | PARAMS ((bfd *, asymbol **)); | |
1408 | ||
ec338859 AM |
1409 | extern asection *bfd_section_from_r_symndx |
1410 | PARAMS ((bfd *, struct sym_sec_cache *, asection *, unsigned long)); | |
dc810e39 AM |
1411 | extern asection *bfd_section_from_elf_index |
1412 | PARAMS ((bfd *, unsigned int)); | |
1413 | extern boolean _bfd_elf_create_dynamic_sections | |
1414 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1415 | extern struct bfd_strtab_hash *_bfd_elf_stringtab_init | |
1416 | PARAMS ((void)); | |
2b0f7ef9 JJ |
1417 | |
1418 | extern struct elf_strtab_hash * _bfd_elf_strtab_init | |
1419 | PARAMS ((void)); | |
1420 | extern void _bfd_elf_strtab_free | |
1421 | PARAMS ((struct elf_strtab_hash *)); | |
1422 | extern bfd_size_type _bfd_elf_strtab_add | |
1423 | PARAMS ((struct elf_strtab_hash *, const char *, boolean)); | |
1424 | extern void _bfd_elf_strtab_addref | |
1425 | PARAMS ((struct elf_strtab_hash *, bfd_size_type)); | |
1426 | extern void _bfd_elf_strtab_delref | |
1427 | PARAMS ((struct elf_strtab_hash *, bfd_size_type)); | |
1428 | extern void _bfd_elf_strtab_clear_all_refs | |
1429 | PARAMS ((struct elf_strtab_hash *)); | |
1430 | extern bfd_size_type _bfd_elf_strtab_size | |
1431 | PARAMS ((struct elf_strtab_hash *)); | |
1432 | extern bfd_size_type _bfd_elf_strtab_offset | |
1433 | PARAMS ((struct elf_strtab_hash *, bfd_size_type)); | |
1434 | extern boolean _bfd_elf_strtab_emit | |
1435 | PARAMS ((bfd *, struct elf_strtab_hash *)); | |
1436 | extern void _bfd_elf_strtab_finalize | |
1437 | PARAMS ((struct elf_strtab_hash *)); | |
1438 | ||
65765700 | 1439 | extern boolean _bfd_elf_discard_section_eh_frame |
126495ed | 1440 | PARAMS ((bfd *, struct bfd_link_info *, asection *, |
65765700 JJ |
1441 | boolean (*) (bfd_vma, PTR), struct elf_reloc_cookie *)); |
1442 | extern boolean _bfd_elf_discard_section_eh_frame_hdr | |
126495ed | 1443 | PARAMS ((bfd *, struct bfd_link_info *)); |
65765700 JJ |
1444 | extern bfd_vma _bfd_elf_eh_frame_section_offset |
1445 | PARAMS ((bfd *, asection *, bfd_vma)); | |
1446 | extern boolean _bfd_elf_write_section_eh_frame | |
126495ed | 1447 | PARAMS ((bfd *, struct bfd_link_info *, asection *, bfd_byte *)); |
65765700 | 1448 | extern boolean _bfd_elf_write_section_eh_frame_hdr |
126495ed | 1449 | PARAMS ((bfd *, struct bfd_link_info *)); |
68f69152 JJ |
1450 | extern boolean _bfd_elf_maybe_strip_eh_frame_hdr |
1451 | PARAMS ((struct bfd_link_info *)); | |
65765700 | 1452 | |
dc810e39 AM |
1453 | extern boolean _bfd_elf_link_record_dynamic_symbol |
1454 | PARAMS ((struct bfd_link_info *, struct elf_link_hash_entry *)); | |
1455 | extern long _bfd_elf_link_lookup_local_dynindx | |
1456 | PARAMS ((struct bfd_link_info *, bfd *, long)); | |
1457 | extern boolean _bfd_elf_compute_section_file_positions | |
1458 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1459 | extern void _bfd_elf_assign_file_positions_for_relocs | |
1460 | PARAMS ((bfd *)); | |
1461 | extern file_ptr _bfd_elf_assign_file_position_for_section | |
1462 | PARAMS ((Elf_Internal_Shdr *, file_ptr, boolean)); | |
1463 | ||
1464 | extern boolean _bfd_elf_validate_reloc | |
1465 | PARAMS ((bfd *, arelent *)); | |
1466 | ||
1467 | extern boolean _bfd_elf_create_dynamic_sections | |
1468 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1469 | extern boolean _bfd_elf_create_got_section | |
1470 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1471 | extern unsigned long _bfd_elf_link_renumber_dynsyms | |
1472 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1473 | ||
1474 | extern boolean _bfd_elfcore_make_pseudosection | |
1475 | PARAMS ((bfd *, char *, size_t, ufile_ptr)); | |
1476 | extern char *_bfd_elfcore_strndup | |
1477 | PARAMS ((bfd *, char *, size_t)); | |
1478 | ||
1479 | extern elf_linker_section_t *_bfd_elf_create_linker_section | |
1480 | PARAMS ((bfd *, struct bfd_link_info *, enum elf_linker_section_enum, | |
1481 | elf_linker_section_t *)); | |
1482 | ||
1483 | extern elf_linker_section_pointers_t *_bfd_elf_find_pointer_linker_section | |
1484 | PARAMS ((elf_linker_section_pointers_t *, bfd_vma, | |
1485 | elf_linker_section_enum_t)); | |
1486 | ||
1487 | extern boolean bfd_elf32_create_pointer_linker_section | |
1488 | PARAMS ((bfd *, struct bfd_link_info *, elf_linker_section_t *, | |
1489 | struct elf_link_hash_entry *, const Elf32_Internal_Rela *)); | |
1490 | ||
1491 | extern bfd_vma bfd_elf32_finish_pointer_linker_section | |
1492 | PARAMS ((bfd *, bfd *, struct bfd_link_info *, elf_linker_section_t *, | |
1493 | struct elf_link_hash_entry *, bfd_vma, | |
1494 | const Elf32_Internal_Rela *, int)); | |
1495 | ||
1496 | extern boolean bfd_elf64_create_pointer_linker_section | |
1497 | PARAMS ((bfd *, struct bfd_link_info *, elf_linker_section_t *, | |
1498 | struct elf_link_hash_entry *, const Elf64_Internal_Rela *)); | |
1499 | ||
1500 | extern bfd_vma bfd_elf64_finish_pointer_linker_section | |
1501 | PARAMS ((bfd *, bfd *, struct bfd_link_info *, elf_linker_section_t *, | |
1502 | struct elf_link_hash_entry *, bfd_vma, | |
1503 | const Elf64_Internal_Rela *, int)); | |
1504 | ||
1505 | extern boolean _bfd_elf_make_linker_section_rela | |
1506 | PARAMS ((bfd *, elf_linker_section_t *, int)); | |
1507 | ||
1508 | extern const bfd_target *bfd_elf32_object_p | |
1509 | PARAMS ((bfd *)); | |
1510 | extern const bfd_target *bfd_elf32_core_file_p | |
1511 | PARAMS ((bfd *)); | |
1512 | extern char *bfd_elf32_core_file_failing_command | |
1513 | PARAMS ((bfd *)); | |
1514 | extern int bfd_elf32_core_file_failing_signal | |
1515 | PARAMS ((bfd *)); | |
1516 | extern boolean bfd_elf32_core_file_matches_executable_p | |
1517 | PARAMS ((bfd *, bfd *)); | |
252b5132 RH |
1518 | |
1519 | extern boolean bfd_elf32_bfd_link_add_symbols | |
1520 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1521 | extern boolean bfd_elf32_bfd_final_link | |
1522 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1523 | ||
1524 | extern void bfd_elf32_swap_symbol_in | |
f8ecb12b | 1525 | PARAMS ((bfd *, const PTR, const PTR, Elf_Internal_Sym *)); |
252b5132 | 1526 | extern void bfd_elf32_swap_symbol_out |
9ad5cbcf | 1527 | PARAMS ((bfd *, const Elf_Internal_Sym *, PTR, PTR)); |
252b5132 RH |
1528 | extern void bfd_elf32_swap_reloc_in |
1529 | PARAMS ((bfd *, const Elf32_External_Rel *, Elf_Internal_Rel *)); | |
1530 | extern void bfd_elf32_swap_reloc_out | |
1531 | PARAMS ((bfd *, const Elf_Internal_Rel *, Elf32_External_Rel *)); | |
1532 | extern void bfd_elf32_swap_reloca_in | |
1533 | PARAMS ((bfd *, const Elf32_External_Rela *, Elf_Internal_Rela *)); | |
1534 | extern void bfd_elf32_swap_reloca_out | |
1535 | PARAMS ((bfd *, const Elf_Internal_Rela *, Elf32_External_Rela *)); | |
1536 | extern void bfd_elf32_swap_phdr_in | |
1537 | PARAMS ((bfd *, const Elf32_External_Phdr *, Elf_Internal_Phdr *)); | |
1538 | extern void bfd_elf32_swap_phdr_out | |
1539 | PARAMS ((bfd *, const Elf_Internal_Phdr *, Elf32_External_Phdr *)); | |
1540 | extern void bfd_elf32_swap_dyn_in | |
1541 | PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *)); | |
1542 | extern void bfd_elf32_swap_dyn_out | |
c7ac6ff8 | 1543 | PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR)); |
252b5132 RH |
1544 | extern long bfd_elf32_slurp_symbol_table |
1545 | PARAMS ((bfd *, asymbol **, boolean)); | |
dc810e39 AM |
1546 | extern boolean bfd_elf32_write_shdrs_and_ehdr |
1547 | PARAMS ((bfd *)); | |
252b5132 | 1548 | extern int bfd_elf32_write_out_phdrs |
dc810e39 | 1549 | PARAMS ((bfd *, const Elf_Internal_Phdr *, unsigned int)); |
b9f66672 JL |
1550 | extern void bfd_elf32_write_relocs |
1551 | PARAMS ((bfd *, asection *, PTR)); | |
1552 | extern boolean bfd_elf32_slurp_reloc_table | |
1553 | PARAMS ((bfd *, asection *, asymbol **, boolean)); | |
252b5132 RH |
1554 | extern boolean bfd_elf32_add_dynamic_entry |
1555 | PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma)); | |
1556 | extern boolean bfd_elf32_link_create_dynamic_sections | |
1557 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1558 | extern Elf_Internal_Rela *_bfd_elf32_link_read_relocs | |
1559 | PARAMS ((bfd *, asection *, PTR, Elf_Internal_Rela *, boolean)); | |
1560 | ||
dc810e39 AM |
1561 | extern const bfd_target *bfd_elf64_object_p |
1562 | PARAMS ((bfd *)); | |
1563 | extern const bfd_target *bfd_elf64_core_file_p | |
1564 | PARAMS ((bfd *)); | |
1565 | extern char *bfd_elf64_core_file_failing_command | |
1566 | PARAMS ((bfd *)); | |
1567 | extern int bfd_elf64_core_file_failing_signal | |
1568 | PARAMS ((bfd *)); | |
1569 | extern boolean bfd_elf64_core_file_matches_executable_p | |
1570 | PARAMS ((bfd *, bfd *)); | |
252b5132 RH |
1571 | extern boolean bfd_elf64_bfd_link_add_symbols |
1572 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1573 | extern boolean bfd_elf64_bfd_final_link | |
1574 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1575 | ||
1576 | extern void bfd_elf64_swap_symbol_in | |
f8ecb12b | 1577 | PARAMS ((bfd *, const PTR, const PTR, Elf_Internal_Sym *)); |
252b5132 | 1578 | extern void bfd_elf64_swap_symbol_out |
9ad5cbcf | 1579 | PARAMS ((bfd *, const Elf_Internal_Sym *, PTR, PTR)); |
252b5132 RH |
1580 | extern void bfd_elf64_swap_reloc_in |
1581 | PARAMS ((bfd *, const Elf64_External_Rel *, Elf_Internal_Rel *)); | |
1582 | extern void bfd_elf64_swap_reloc_out | |
1583 | PARAMS ((bfd *, const Elf_Internal_Rel *, Elf64_External_Rel *)); | |
1584 | extern void bfd_elf64_swap_reloca_in | |
1585 | PARAMS ((bfd *, const Elf64_External_Rela *, Elf_Internal_Rela *)); | |
1586 | extern void bfd_elf64_swap_reloca_out | |
1587 | PARAMS ((bfd *, const Elf_Internal_Rela *, Elf64_External_Rela *)); | |
1588 | extern void bfd_elf64_swap_phdr_in | |
1589 | PARAMS ((bfd *, const Elf64_External_Phdr *, Elf_Internal_Phdr *)); | |
1590 | extern void bfd_elf64_swap_phdr_out | |
1591 | PARAMS ((bfd *, const Elf_Internal_Phdr *, Elf64_External_Phdr *)); | |
1592 | extern void bfd_elf64_swap_dyn_in | |
1593 | PARAMS ((bfd *, const PTR, Elf_Internal_Dyn *)); | |
1594 | extern void bfd_elf64_swap_dyn_out | |
c7ac6ff8 | 1595 | PARAMS ((bfd *, const Elf_Internal_Dyn *, PTR)); |
252b5132 RH |
1596 | extern long bfd_elf64_slurp_symbol_table |
1597 | PARAMS ((bfd *, asymbol **, boolean)); | |
dc810e39 AM |
1598 | extern boolean bfd_elf64_write_shdrs_and_ehdr |
1599 | PARAMS ((bfd *)); | |
252b5132 | 1600 | extern int bfd_elf64_write_out_phdrs |
dc810e39 | 1601 | PARAMS ((bfd *, const Elf_Internal_Phdr *, unsigned int)); |
b9f66672 JL |
1602 | extern void bfd_elf64_write_relocs |
1603 | PARAMS ((bfd *, asection *, PTR)); | |
1604 | extern boolean bfd_elf64_slurp_reloc_table | |
1605 | PARAMS ((bfd *, asection *, asymbol **, boolean)); | |
252b5132 RH |
1606 | extern boolean bfd_elf64_add_dynamic_entry |
1607 | PARAMS ((struct bfd_link_info *, bfd_vma, bfd_vma)); | |
1608 | extern boolean bfd_elf64_link_create_dynamic_sections | |
1609 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1610 | extern Elf_Internal_Rela *_bfd_elf64_link_read_relocs | |
1611 | PARAMS ((bfd *, asection *, PTR, Elf_Internal_Rela *, boolean)); | |
1612 | ||
30b30c21 RH |
1613 | #define bfd_elf32_link_record_dynamic_symbol \ |
1614 | _bfd_elf_link_record_dynamic_symbol | |
1615 | #define bfd_elf64_link_record_dynamic_symbol \ | |
1616 | _bfd_elf_link_record_dynamic_symbol | |
1617 | ||
8c58d23b | 1618 | extern int elf_link_record_local_dynamic_symbol |
30b30c21 | 1619 | PARAMS ((struct bfd_link_info *, bfd *, long)); |
8c58d23b AM |
1620 | #define _bfd_elf32_link_record_local_dynamic_symbol \ |
1621 | elf_link_record_local_dynamic_symbol | |
1622 | #define _bfd_elf64_link_record_local_dynamic_symbol \ | |
1623 | elf_link_record_local_dynamic_symbol | |
252b5132 | 1624 | |
dc810e39 AM |
1625 | extern boolean _bfd_elf_close_and_cleanup |
1626 | PARAMS ((bfd *)); | |
252b5132 RH |
1627 | extern bfd_reloc_status_type _bfd_elf_rel_vtable_reloc_fn |
1628 | PARAMS ((bfd *, arelent *, struct symbol_cache_entry *, PTR, | |
1629 | asection *, bfd *, char **)); | |
1630 | ||
dc810e39 AM |
1631 | extern boolean _bfd_elf32_gc_sections |
1632 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1633 | extern boolean _bfd_elf32_gc_common_finalize_got_offsets | |
1634 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1635 | extern boolean _bfd_elf32_gc_common_final_link | |
252b5132 | 1636 | PARAMS ((bfd *, struct bfd_link_info *)); |
dc810e39 | 1637 | extern boolean _bfd_elf32_gc_record_vtinherit |
252b5132 | 1638 | PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma)); |
dc810e39 | 1639 | extern boolean _bfd_elf32_gc_record_vtentry |
252b5132 RH |
1640 | PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma)); |
1641 | ||
dc810e39 | 1642 | extern boolean _bfd_elf64_gc_sections |
252b5132 | 1643 | PARAMS ((bfd *, struct bfd_link_info *)); |
dc810e39 AM |
1644 | extern boolean _bfd_elf64_gc_common_finalize_got_offsets |
1645 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1646 | extern boolean _bfd_elf64_gc_common_final_link | |
1647 | PARAMS ((bfd *, struct bfd_link_info *)); | |
1648 | extern boolean _bfd_elf64_gc_record_vtinherit | |
252b5132 | 1649 | PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma)); |
dc810e39 | 1650 | extern boolean _bfd_elf64_gc_record_vtentry |
252b5132 RH |
1651 | PARAMS ((bfd *, asection *, struct elf_link_hash_entry *, bfd_vma)); |
1652 | ||
73d074b4 DJ |
1653 | extern boolean _bfd_elf32_reloc_symbol_deleted_p |
1654 | PARAMS ((bfd_vma, PTR)); | |
1655 | extern boolean _bfd_elf64_reloc_symbol_deleted_p | |
1656 | PARAMS ((bfd_vma, PTR)); | |
1657 | ||
7c76fa91 | 1658 | /* Exported interface for writing elf corefile notes. */ |
d4c88bbb AM |
1659 | extern char *elfcore_write_note |
1660 | PARAMS ((bfd *, char *, int *, const char *, int, const PTR, int)); | |
1661 | extern char *elfcore_write_prpsinfo | |
1662 | PARAMS ((bfd *, char *, int *, const char *, const char *)); | |
1663 | extern char *elfcore_write_prstatus | |
1664 | PARAMS ((bfd *, char *, int *, long, int, const PTR)); | |
1665 | extern char * elfcore_write_pstatus | |
1666 | PARAMS ((bfd *, char *, int *, long, int, const PTR)); | |
1667 | extern char *elfcore_write_prfpreg | |
1668 | PARAMS ((bfd *, char *, int *, const PTR, int)); | |
1669 | extern char *elfcore_write_prxfpreg | |
1670 | PARAMS ((bfd *, char *, int *, const PTR, int)); | |
1671 | extern char *elfcore_write_lwpstatus | |
1672 | PARAMS ((bfd *, char *, int *, long, int, const PTR)); | |
7c76fa91 | 1673 | |
d4845d57 JR |
1674 | /* SH ELF specific routine. */ |
1675 | ||
dc810e39 AM |
1676 | extern boolean _sh_elf_set_mach_from_flags |
1677 | PARAMS ((bfd *)); | |
d4845d57 | 1678 | |
252b5132 | 1679 | #endif /* _LIBELF_H_ */ |