]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - bfd/libcoff.h
2007-07-03 Markus Deuling <deuling@de.ibm.com>
[thirdparty/binutils-gdb.git] / bfd / libcoff.h
CommitLineData
4eef72c7 1/* DO NOT EDIT! -*- buffer-read-only: t -*- This file is automatically
59bc061d 2 generated from "libcoff-in.h" and "coffcode.h".
4eef72c7
AM
3 Run "make headers" in your build bfd/ to regenerate. */
4
252b5132 5/* BFD COFF object file private structure.
7898deda 6 Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
7b81dfbb 7 2000, 2001, 2002, 2003, 2004, 2005, 2006
252b5132
RH
8 Free Software Foundation, Inc.
9 Written by Cygnus Support.
10
7920ce38 11 This file is part of BFD, the Binary File Descriptor library.
252b5132 12
7920ce38
NC
13 This program is free software; you can redistribute it and/or modify
14 it under the terms of the GNU General Public License as published by
15 the Free Software Foundation; either version 2 of the License, or
16 (at your option) any later version.
252b5132 17
7920ce38
NC
18 This program is distributed in the hope that it will be useful,
19 but WITHOUT ANY WARRANTY; without even the implied warranty of
20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 GNU General Public License for more details.
252b5132 22
7920ce38
NC
23 You should have received a copy of the GNU General Public License
24 along with this program; if not, write to the Free Software
3e110533 25 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */
252b5132
RH
26
27#include "bfdlink.h"
28
7920ce38
NC
29/* Object file tdata; access macros. */
30
31#define coff_data(bfd) ((bfd)->tdata.coff_obj_data)
32#define exec_hdr(bfd) (coff_data (bfd)->hdr)
33#define obj_pe(bfd) (coff_data (bfd)->pe)
34#define obj_symbols(bfd) (coff_data (bfd)->symbols)
35#define obj_sym_filepos(bfd) (coff_data (bfd)->sym_filepos)
36#define obj_relocbase(bfd) (coff_data (bfd)->relocbase)
37#define obj_raw_syments(bfd) (coff_data (bfd)->raw_syments)
38#define obj_raw_syment_count(bfd) (coff_data (bfd)->raw_syment_count)
39#define obj_convert(bfd) (coff_data (bfd)->conversion_table)
40#define obj_conv_table_size(bfd) (coff_data (bfd)->conv_table_size)
41#define obj_coff_external_syms(bfd) (coff_data (bfd)->external_syms)
42#define obj_coff_keep_syms(bfd) (coff_data (bfd)->keep_syms)
43#define obj_coff_strings(bfd) (coff_data (bfd)->strings)
44#define obj_coff_keep_strings(bfd) (coff_data (bfd)->keep_strings)
45#define obj_coff_sym_hashes(bfd) (coff_data (bfd)->sym_hashes)
d71f672e 46#define obj_coff_strings_written(bfd) (coff_data (bfd)->strings_written)
7920ce38 47#define obj_coff_local_toc_table(bfd) (coff_data (bfd)->local_toc_sym_map)
252b5132
RH
48
49/* `Tdata' information kept for COFF files. */
50
51typedef struct coff_tdata
52{
7920ce38 53 struct coff_symbol_struct *symbols; /* Symtab for input bfd. */
252b5132
RH
54 unsigned int *conversion_table;
55 int conv_table_size;
56 file_ptr sym_filepos;
57
58 struct coff_ptr_struct *raw_syments;
00692651 59 unsigned long raw_syment_count;
252b5132 60
7920ce38 61 /* These are only valid once writing has begun. */
252b5132
RH
62 long int relocbase;
63
64 /* These members communicate important constants about the symbol table
65 to GDB's symbol-reading code. These `constants' unfortunately vary
66 from coff implementation to implementation... */
67 unsigned local_n_btmask;
68 unsigned local_n_btshft;
69 unsigned local_n_tmask;
70 unsigned local_n_tshift;
71 unsigned local_symesz;
72 unsigned local_auxesz;
73 unsigned local_linesz;
74
75 /* The unswapped external symbols. May be NULL. Read by
76 _bfd_coff_get_external_symbols. */
7920ce38 77 void * external_syms;
b34976b6
AM
78 /* If this is TRUE, the external_syms may not be freed. */
79 bfd_boolean keep_syms;
252b5132
RH
80
81 /* The string table. May be NULL. Read by
82 _bfd_coff_read_string_table. */
83 char *strings;
b34976b6
AM
84 /* If this is TRUE, the strings may not be freed. */
85 bfd_boolean keep_strings;
86 /* If this is TRUE, the strings have been written out already. */
87 bfd_boolean strings_written;
252b5132 88
7920ce38 89 /* Is this a PE format coff file? */
252b5132
RH
90 int pe;
91 /* Used by the COFF backend linker. */
92 struct coff_link_hash_entry **sym_hashes;
93
7920ce38 94 /* Used by the pe linker for PowerPC. */
252b5132
RH
95 int *local_toc_sym_map;
96
97 struct bfd_link_info *link_info;
98
99 /* Used by coff_find_nearest_line. */
7920ce38 100 void * line_info;
252b5132 101
7920ce38
NC
102 /* A place to stash dwarf2 info for this bfd. */
103 void * dwarf2_find_line_info;
51db3708 104
00692651
ILT
105 /* The timestamp from the COFF file header. */
106 long timestamp;
107
252b5132
RH
108 /* Copy of some of the f_flags bits in the COFF filehdr structure,
109 used by ARM code. */
110 flagword flags;
111
112} coff_data_type;
113
7920ce38 114/* Tdata for pe image files. */
252b5132
RH
115typedef struct pe_tdata
116{
117 coff_data_type coff;
118 struct internal_extra_pe_aouthdr pe_opthdr;
119 int dll;
120 int has_reloc_section;
7920ce38 121 bfd_boolean (*in_reloc_p) (bfd *, reloc_howto_type *);
252b5132 122 flagword real_flags;
cbff5e0d 123 int target_subsystem;
b34976b6 124 bfd_boolean force_minimum_alignment;
252b5132
RH
125} pe_data_type;
126
127#define pe_data(bfd) ((bfd)->tdata.pe_obj_data)
128
129/* Tdata for XCOFF files. */
130
131struct xcoff_tdata
132{
133 /* Basic COFF information. */
134 coff_data_type coff;
135
b34976b6
AM
136 /* TRUE if this is an XCOFF64 file. */
137 bfd_boolean xcoff64;
a2fdf270 138
b34976b6
AM
139 /* TRUE if a large a.out header should be generated. */
140 bfd_boolean full_aouthdr;
252b5132
RH
141
142 /* TOC value. */
143 bfd_vma toc;
144
145 /* Index of section holding TOC. */
146 int sntoc;
147
148 /* Index of section holding entry point. */
149 int snentry;
150
151 /* .text alignment from optional header. */
152 int text_align_power;
153
154 /* .data alignment from optional header. */
155 int data_align_power;
156
157 /* modtype from optional header. */
158 short modtype;
159
160 /* cputype from optional header. */
161 short cputype;
162
163 /* maxdata from optional header. */
f34d8777 164 bfd_vma maxdata;
252b5132
RH
165
166 /* maxstack from optional header. */
f34d8777 167 bfd_vma maxstack;
252b5132
RH
168
169 /* Used by the XCOFF backend linker. */
170 asection **csects;
171 unsigned long *debug_indices;
172 unsigned int import_file_id;
173};
174
175#define xcoff_data(abfd) ((abfd)->tdata.xcoff_obj_data)
176
08da05b0 177/* We take the address of the first element of an asymbol to ensure that the
7920ce38 178 macro is only ever applied to an asymbol. */
252b5132
RH
179#define coffsymbol(asymbol) ((coff_symbol_type *)(&((asymbol)->the_bfd)))
180
181/* The used_by_bfd field of a section may be set to a pointer to this
182 structure. */
183
184struct coff_section_tdata
185{
186 /* The relocs, swapped into COFF internal form. This may be NULL. */
187 struct internal_reloc *relocs;
b34976b6
AM
188 /* If this is TRUE, the relocs entry may not be freed. */
189 bfd_boolean keep_relocs;
252b5132
RH
190 /* The section contents. This may be NULL. */
191 bfd_byte *contents;
b34976b6
AM
192 /* If this is TRUE, the contents entry may not be freed. */
193 bfd_boolean keep_contents;
252b5132
RH
194 /* Information cached by coff_find_nearest_line. */
195 bfd_vma offset;
196 unsigned int i;
197 const char *function;
082b7297
L
198 /* Optional information about a COMDAT entry; NULL if not COMDAT. */
199 struct coff_comdat_info *comdat;
252b5132
RH
200 int line_base;
201 /* A pointer used for .stab linking optimizations. */
7920ce38 202 void * stab_info;
252b5132 203 /* Available for individual backends. */
7920ce38 204 void * tdata;
252b5132
RH
205};
206
207/* An accessor macro for the coff_section_tdata structure. */
208#define coff_section_data(abfd, sec) \
209 ((struct coff_section_tdata *) (sec)->used_by_bfd)
210
211/* Tdata for sections in XCOFF files. This is used by the linker. */
212
213struct xcoff_section_tdata
214{
215 /* Used for XCOFF csects created by the linker; points to the real
216 XCOFF section which contains this csect. */
217 asection *enclosing;
218 /* The lineno_count field for the enclosing section, because we are
219 going to clobber it there. */
220 unsigned int lineno_count;
221 /* The first and one past the last symbol indices for symbols used
222 by this csect. */
223 unsigned long first_symndx;
224 unsigned long last_symndx;
225};
226
227/* An accessor macro the xcoff_section_tdata structure. */
228#define xcoff_section_data(abfd, sec) \
229 ((struct xcoff_section_tdata *) coff_section_data ((abfd), (sec))->tdata)
230
8d3ad4e1 231/* Tdata for sections in PE files. */
252b5132
RH
232
233struct pei_section_tdata
234{
235 /* The virtual size of the section. */
236 bfd_size_type virt_size;
8d3ad4e1
ILT
237 /* The PE section flags. */
238 long pe_flags;
252b5132
RH
239};
240
241/* An accessor macro for the pei_section_tdata structure. */
242#define pei_section_data(abfd, sec) \
243 ((struct pei_section_tdata *) coff_section_data ((abfd), (sec))->tdata)
244
245/* COFF linker hash table entries. */
246
247struct coff_link_hash_entry
248{
249 struct bfd_link_hash_entry root;
250
251 /* Symbol index in output file. Set to -1 initially. Set to -2 if
252 there is a reloc against this symbol. */
253 long indx;
254
255 /* Symbol type. */
256 unsigned short type;
257
258 /* Symbol class. */
259 unsigned char class;
260
261 /* Number of auxiliary entries. */
262 char numaux;
263
264 /* BFD to take auxiliary entries from. */
265 bfd *auxbfd;
266
267 /* Pointer to array of auxiliary entries, if any. */
268 union internal_auxent *aux;
7fd9c191
ILT
269
270 /* Flag word; legal values follow. */
271 unsigned short coff_link_hash_flags;
272 /* Symbol is a PE section symbol. */
273#define COFF_LINK_HASH_PE_SECTION_SYMBOL (01)
252b5132
RH
274};
275
276/* COFF linker hash table. */
277
278struct coff_link_hash_table
279{
280 struct bfd_link_hash_table root;
281 /* A pointer to information used to link stabs in sections. */
3722b82f 282 struct stab_info stab_info;
252b5132
RH
283};
284
285/* Look up an entry in a COFF linker hash table. */
286
287#define coff_link_hash_lookup(table, string, create, copy, follow) \
288 ((struct coff_link_hash_entry *) \
289 bfd_link_hash_lookup (&(table)->root, (string), (create), \
290 (copy), (follow)))
291
292/* Traverse a COFF linker hash table. */
293
294#define coff_link_hash_traverse(table, func, info) \
295 (bfd_link_hash_traverse \
296 (&(table)->root, \
7920ce38 297 (bfd_boolean (*) (struct bfd_link_hash_entry *, void *)) (func), \
252b5132
RH
298 (info)))
299
300/* Get the COFF linker hash table from a link_info structure. */
301
302#define coff_hash_table(p) ((struct coff_link_hash_table *) ((p)->hash))
303
304/* Functions in coffgen.c. */
dc810e39 305extern const bfd_target *coff_object_p
7920ce38 306 (bfd *);
198beae2 307extern struct bfd_section *coff_section_from_bfd_index
7920ce38 308 (bfd *, int);
dc810e39 309extern long coff_get_symtab_upper_bound
7920ce38 310 (bfd *);
6cee3f79 311extern long coff_canonicalize_symtab
7920ce38 312 (bfd *, asymbol **);
dc810e39 313extern int coff_count_linenumbers
7920ce38 314 (bfd *);
dc810e39 315extern struct coff_symbol_struct *coff_symbol_from
7920ce38 316 (bfd *, asymbol *);
b34976b6 317extern bfd_boolean coff_renumber_symbols
7920ce38 318 (bfd *, int *);
dc810e39 319extern void coff_mangle_symbols
7920ce38 320 (bfd *);
b34976b6 321extern bfd_boolean coff_write_symbols
7920ce38 322 (bfd *);
b34976b6 323extern bfd_boolean coff_write_linenumbers
7920ce38 324 (bfd *);
dc810e39 325extern alent *coff_get_lineno
7920ce38 326 (bfd *, asymbol *);
dc810e39 327extern asymbol *coff_section_symbol
7920ce38 328 (bfd *, char *);
b34976b6 329extern bfd_boolean _bfd_coff_get_external_symbols
7920ce38 330 (bfd *);
dc810e39 331extern const char *_bfd_coff_read_string_table
7920ce38 332 (bfd *);
b34976b6 333extern bfd_boolean _bfd_coff_free_symbols
7920ce38 334 (bfd *);
dc810e39 335extern struct coff_ptr_struct *coff_get_normalized_symtab
7920ce38 336 (bfd *);
dc810e39 337extern long coff_get_reloc_upper_bound
7920ce38 338 (bfd *, sec_ptr);
dc810e39 339extern asymbol *coff_make_empty_symbol
7920ce38 340 (bfd *);
dc810e39 341extern void coff_print_symbol
7920ce38 342 (bfd *, void * filep, asymbol *, bfd_print_symbol_type);
dc810e39 343extern void coff_get_symbol_info
7920ce38 344 (bfd *, asymbol *, symbol_info *ret);
b34976b6 345extern bfd_boolean _bfd_coff_is_local_label_name
7920ce38 346 (bfd *, const char *);
dc810e39 347extern asymbol *coff_bfd_make_debug_symbol
7920ce38 348 (bfd *, void *, unsigned long);
b34976b6 349extern bfd_boolean coff_find_nearest_line
7920ce38
NC
350 (bfd *, asection *, asymbol **, bfd_vma, const char **,
351 const char **, unsigned int *);
4ab527b0
FF
352extern bfd_boolean coff_find_inliner_info
353 (bfd *, const char **, const char **, unsigned int *);
dc810e39 354extern int coff_sizeof_headers
a6b96beb 355 (bfd *, struct bfd_link_info *);
b34976b6 356extern bfd_boolean bfd_coff_reloc16_relax_section
7920ce38 357 (bfd *, asection *, struct bfd_link_info *, bfd_boolean *);
252b5132 358extern bfd_byte *bfd_coff_reloc16_get_relocated_section_contents
7920ce38
NC
359 (bfd *, struct bfd_link_info *, struct bfd_link_order *,
360 bfd_byte *, bfd_boolean, asymbol **);
dc810e39 361extern bfd_vma bfd_coff_reloc16_get_value
7920ce38 362 (arelent *, struct bfd_link_info *, asection *);
dc810e39 363extern void bfd_perform_slip
7920ce38 364 (bfd *, unsigned int, asection *, bfd_vma);
252b5132
RH
365
366/* Functions and types in cofflink.c. */
367
ceae3e33 368#define STRING_SIZE_SIZE 4
252b5132
RH
369
370/* We use a hash table to merge identical enum, struct, and union
371 definitions in the linker. */
372
373/* Information we keep for a single element (an enum value, a
374 structure or union field) in the debug merge hash table. */
375
376struct coff_debug_merge_element
377{
378 /* Next element. */
379 struct coff_debug_merge_element *next;
380
381 /* Name. */
382 const char *name;
383
384 /* Type. */
385 unsigned int type;
386
387 /* Symbol index for complex type. */
388 long tagndx;
389};
390
391/* A linked list of debug merge entries for a given name. */
392
393struct coff_debug_merge_type
394{
395 /* Next type with the same name. */
396 struct coff_debug_merge_type *next;
397
398 /* Class of type. */
399 int class;
400
401 /* Symbol index where this type is defined. */
402 long indx;
403
404 /* List of elements. */
405 struct coff_debug_merge_element *elements;
406};
407
408/* Information we store in the debug merge hash table. */
409
410struct coff_debug_merge_hash_entry
411{
412 struct bfd_hash_entry root;
413
414 /* A list of types with this name. */
415 struct coff_debug_merge_type *types;
416};
417
418/* The debug merge hash table. */
419
420struct coff_debug_merge_hash_table
421{
422 struct bfd_hash_table root;
423};
424
425/* Initialize a COFF debug merge hash table. */
426
427#define coff_debug_merge_hash_table_init(table) \
66eb6687
AM
428 (bfd_hash_table_init (&(table)->root, _bfd_coff_debug_merge_hash_newfunc, \
429 sizeof (struct coff_debug_merge_hash_entry)))
252b5132
RH
430
431/* Free a COFF debug merge hash table. */
432
433#define coff_debug_merge_hash_table_free(table) \
434 (bfd_hash_table_free (&(table)->root))
435
436/* Look up an entry in a COFF debug merge hash table. */
437
438#define coff_debug_merge_hash_lookup(table, string, create, copy) \
439 ((struct coff_debug_merge_hash_entry *) \
440 bfd_hash_lookup (&(table)->root, (string), (create), (copy)))
441
442/* Information we keep for each section in the output file when doing
1049f94e 443 a relocatable link. */
252b5132
RH
444
445struct coff_link_section_info
446{
447 /* The relocs to be output. */
448 struct internal_reloc *relocs;
449 /* For each reloc against a global symbol whose index was not known
450 when the reloc was handled, the global hash table entry. */
451 struct coff_link_hash_entry **rel_hashes;
452};
453
454/* Information that we pass around while doing the final link step. */
455
456struct coff_final_link_info
457{
458 /* General link information. */
459 struct bfd_link_info *info;
460 /* Output BFD. */
461 bfd *output_bfd;
462 /* Used to indicate failure in traversal routine. */
b34976b6 463 bfd_boolean failed;
252b5132
RH
464 /* If doing "task linking" set only during the time when we want the
465 global symbol writer to convert the storage class of defined global
466 symbols from global to static. */
b34976b6 467 bfd_boolean global_to_static;
252b5132
RH
468 /* Hash table for long symbol names. */
469 struct bfd_strtab_hash *strtab;
1049f94e 470 /* When doing a relocatable link, an array of information kept for
252b5132
RH
471 each output section, indexed by the target_index field. */
472 struct coff_link_section_info *section_info;
473 /* Symbol index of last C_FILE symbol (-1 if none). */
474 long last_file_index;
475 /* Contents of last C_FILE symbol. */
476 struct internal_syment last_file;
477 /* Symbol index of first aux entry of last .bf symbol with an empty
478 endndx field (-1 if none). */
479 long last_bf_index;
480 /* Contents of last_bf_index aux entry. */
481 union internal_auxent last_bf;
482 /* Hash table used to merge debug information. */
483 struct coff_debug_merge_hash_table debug_merge;
484 /* Buffer large enough to hold swapped symbols of any input file. */
485 struct internal_syment *internal_syms;
486 /* Buffer large enough to hold sections of symbols of any input file. */
487 asection **sec_ptrs;
488 /* Buffer large enough to hold output indices of symbols of any
489 input file. */
490 long *sym_indices;
491 /* Buffer large enough to hold output symbols for any input file. */
492 bfd_byte *outsyms;
493 /* Buffer large enough to hold external line numbers for any input
494 section. */
495 bfd_byte *linenos;
496 /* Buffer large enough to hold any input section. */
497 bfd_byte *contents;
498 /* Buffer large enough to hold external relocs of any input section. */
499 bfd_byte *external_relocs;
500 /* Buffer large enough to hold swapped relocs of any input section. */
501 struct internal_reloc *internal_relocs;
502};
503
5dccc1dd
ILT
504/* Most COFF variants have no way to record the alignment of a
505 section. This struct is used to set a specific alignment based on
506 the name of the section. */
507
508struct coff_section_alignment_entry
509{
510 /* The section name. */
511 const char *name;
512
513 /* This is either (unsigned int) -1, indicating that the section
514 name must match exactly, or it is the number of letters which
515 must match at the start of the name. */
516 unsigned int comparison_length;
517
518 /* These macros may be used to fill in the first two fields in a
519 structure initialization. */
520#define COFF_SECTION_NAME_EXACT_MATCH(name) (name), ((unsigned int) -1)
521#define COFF_SECTION_NAME_PARTIAL_MATCH(name) (name), (sizeof (name) - 1)
522
523 /* Only use this entry if the default section alignment for this
524 target is at least that much (as a power of two). If this field
525 is COFF_ALIGNMENT_FIELD_EMPTY, it should be ignored. */
526 unsigned int default_alignment_min;
527
528 /* Only use this entry if the default section alignment for this
529 target is no greater than this (as a power of two). If this
530 field is COFF_ALIGNMENT_FIELD_EMPTY, it should be ignored. */
531 unsigned int default_alignment_max;
532
533#define COFF_ALIGNMENT_FIELD_EMPTY ((unsigned int) -1)
534
535 /* The desired alignment for this section (as a power of two). */
536 unsigned int alignment_power;
537};
538
252b5132 539extern struct bfd_hash_entry *_bfd_coff_link_hash_newfunc
7920ce38 540 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
b34976b6 541extern bfd_boolean _bfd_coff_link_hash_table_init
7920ce38
NC
542 (struct coff_link_hash_table *, bfd *,
543 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
544 struct bfd_hash_table *,
66eb6687
AM
545 const char *),
546 unsigned int);
252b5132 547extern struct bfd_link_hash_table *_bfd_coff_link_hash_table_create
7920ce38 548 (bfd *);
252b5132 549extern const char *_bfd_coff_internal_syment_name
7920ce38 550 (bfd *, const struct internal_syment *, char *);
b34976b6 551extern bfd_boolean _bfd_coff_link_add_symbols
7920ce38 552 (bfd *, struct bfd_link_info *);
b34976b6 553extern bfd_boolean _bfd_coff_final_link
7920ce38 554 (bfd *, struct bfd_link_info *);
252b5132 555extern struct internal_reloc *_bfd_coff_read_internal_relocs
7920ce38
NC
556 (bfd *, asection *, bfd_boolean, bfd_byte *, bfd_boolean,
557 struct internal_reloc *);
b34976b6 558extern bfd_boolean _bfd_coff_generic_relocate_section
7920ce38
NC
559 (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
560 struct internal_reloc *, struct internal_syment *, asection **);
252b5132 561extern struct bfd_hash_entry *_bfd_coff_debug_merge_hash_newfunc
7920ce38 562 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
b34976b6 563extern bfd_boolean _bfd_coff_write_global_sym
7920ce38 564 (struct coff_link_hash_entry *, void *);
b34976b6 565extern bfd_boolean _bfd_coff_write_task_globals
7920ce38 566 (struct coff_link_hash_entry *, void *);
b34976b6 567extern bfd_boolean _bfd_coff_link_input_bfd
7920ce38 568 (struct coff_final_link_info *, bfd *);
b34976b6 569extern bfd_boolean _bfd_coff_reloc_link_order
7920ce38
NC
570 (bfd *, struct coff_final_link_info *, asection *,
571 struct bfd_link_order *);
252b5132
RH
572
573
574#define coff_get_section_contents_in_window \
575 _bfd_generic_get_section_contents_in_window
576
f34d8777
L
577/* Functions in xcofflink.c. */
578
dc810e39 579extern long _bfd_xcoff_get_dynamic_symtab_upper_bound
7920ce38 580 (bfd *);
f34d8777 581extern long _bfd_xcoff_canonicalize_dynamic_symtab
7920ce38 582 (bfd *, asymbol **);
dc810e39 583extern long _bfd_xcoff_get_dynamic_reloc_upper_bound
7920ce38 584 (bfd *);
f34d8777 585extern long _bfd_xcoff_canonicalize_dynamic_reloc
7920ce38 586 (bfd *, arelent **, asymbol **);
f34d8777 587extern struct bfd_link_hash_table *_bfd_xcoff_bfd_link_hash_table_create
7920ce38 588 (bfd *);
e2d34d7d 589extern void _bfd_xcoff_bfd_link_hash_table_free
7920ce38 590 (struct bfd_link_hash_table *);
b34976b6 591extern bfd_boolean _bfd_xcoff_bfd_link_add_symbols
7920ce38 592 (bfd *, struct bfd_link_info *);
b34976b6 593extern bfd_boolean _bfd_xcoff_bfd_final_link
7920ce38 594 (bfd *, struct bfd_link_info *);
b34976b6 595extern bfd_boolean _bfd_ppc_xcoff_relocate_section
7920ce38
NC
596 (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
597 struct internal_reloc *, struct internal_syment *, asection **);
f34d8777 598
252b5132
RH
599/* Functions in coff-ppc.c. FIXME: These are called be pe.em in the
600 linker, and so should start with bfd and be declared in bfd.h. */
601
b34976b6 602extern bfd_boolean ppc_allocate_toc_section
7920ce38 603 (struct bfd_link_info *);
b34976b6 604extern bfd_boolean ppc_process_before_allocation
7920ce38 605 (bfd *, struct bfd_link_info *);
252b5132 606
e61463e1 607/* Extracted from coffcode.h. */
252b5132
RH
608typedef struct coff_ptr_struct
609{
dc810e39
AM
610 /* Remembers the offset from the first symbol in the file for
611 this symbol. Generated by coff_renumber_symbols. */
612 unsigned int offset;
613
614 /* Should the value of this symbol be renumbered. Used for
615 XCOFF C_BSTAT symbols. Set by coff_slurp_symbol_table. */
616 unsigned int fix_value : 1;
617
618 /* Should the tag field of this symbol be renumbered.
619 Created by coff_pointerize_aux. */
620 unsigned int fix_tag : 1;
621
622 /* Should the endidx field of this symbol be renumbered.
623 Created by coff_pointerize_aux. */
624 unsigned int fix_end : 1;
625
626 /* Should the x_csect.x_scnlen field be renumbered.
627 Created by coff_pointerize_aux. */
628 unsigned int fix_scnlen : 1;
629
630 /* Fix up an XCOFF C_BINCL/C_EINCL symbol. The value is the
631 index into the line number entries. Set by coff_slurp_symbol_table. */
632 unsigned int fix_line : 1;
633
634 /* The container for the symbol structure as read and translated
635 from the file. */
636 union
637 {
638 union internal_auxent auxent;
639 struct internal_syment syment;
640 } u;
252b5132
RH
641} combined_entry_type;
642
643
52b219b5 644/* Each canonical asymbol really looks like this: */
252b5132
RH
645
646typedef struct coff_symbol_struct
647{
dc810e39
AM
648 /* The actual symbol which the rest of BFD works with */
649 asymbol symbol;
252b5132 650
dc810e39
AM
651 /* A pointer to the hidden information for this symbol */
652 combined_entry_type *native;
252b5132 653
dc810e39
AM
654 /* A pointer to the linenumber information for this symbol */
655 struct lineno_cache_entry *lineno;
252b5132 656
dc810e39 657 /* Have the line numbers been relocated yet ? */
b34976b6 658 bfd_boolean done_lineno;
252b5132 659} coff_symbol_type;
52b219b5 660/* COFF symbol classifications. */
5d54c628
ILT
661
662enum coff_symbol_classification
663{
52b219b5 664 /* Global symbol. */
5d54c628 665 COFF_SYMBOL_GLOBAL,
52b219b5 666 /* Common symbol. */
5d54c628 667 COFF_SYMBOL_COMMON,
52b219b5 668 /* Undefined symbol. */
5d54c628 669 COFF_SYMBOL_UNDEFINED,
52b219b5 670 /* Local symbol. */
5d54c628 671 COFF_SYMBOL_LOCAL,
52b219b5 672 /* PE section symbol. */
5d54c628
ILT
673 COFF_SYMBOL_PE_SECTION
674};
675
252b5132
RH
676typedef struct
677{
dc810e39 678 void (*_bfd_coff_swap_aux_in)
7920ce38 679 (bfd *, void *, int, int, int, int, void *);
dc810e39
AM
680
681 void (*_bfd_coff_swap_sym_in)
7920ce38 682 (bfd *, void *, void *);
dc810e39
AM
683
684 void (*_bfd_coff_swap_lineno_in)
7920ce38 685 (bfd *, void *, void *);
dc810e39
AM
686
687 unsigned int (*_bfd_coff_swap_aux_out)
7920ce38 688 (bfd *, void *, int, int, int, int, void *);
dc810e39
AM
689
690 unsigned int (*_bfd_coff_swap_sym_out)
7920ce38 691 (bfd *, void *, void *);
dc810e39
AM
692
693 unsigned int (*_bfd_coff_swap_lineno_out)
7920ce38 694 (bfd *, void *, void *);
dc810e39
AM
695
696 unsigned int (*_bfd_coff_swap_reloc_out)
7920ce38 697 (bfd *, void *, void *);
dc810e39
AM
698
699 unsigned int (*_bfd_coff_swap_filehdr_out)
7920ce38 700 (bfd *, void *, void *);
dc810e39
AM
701
702 unsigned int (*_bfd_coff_swap_aouthdr_out)
7920ce38 703 (bfd *, void *, void *);
dc810e39
AM
704
705 unsigned int (*_bfd_coff_swap_scnhdr_out)
7920ce38 706 (bfd *, void *, void *);
dc810e39
AM
707
708 unsigned int _bfd_filhsz;
709 unsigned int _bfd_aoutsz;
710 unsigned int _bfd_scnhsz;
711 unsigned int _bfd_symesz;
712 unsigned int _bfd_auxesz;
713 unsigned int _bfd_relsz;
714 unsigned int _bfd_linesz;
715 unsigned int _bfd_filnmlen;
b34976b6
AM
716 bfd_boolean _bfd_coff_long_filenames;
717 bfd_boolean _bfd_coff_long_section_names;
dc810e39 718 unsigned int _bfd_coff_default_section_alignment_power;
b34976b6 719 bfd_boolean _bfd_coff_force_symnames_in_strings;
dc810e39
AM
720 unsigned int _bfd_coff_debug_string_prefix_length;
721
722 void (*_bfd_coff_swap_filehdr_in)
7920ce38 723 (bfd *, void *, void *);
dc810e39
AM
724
725 void (*_bfd_coff_swap_aouthdr_in)
7920ce38 726 (bfd *, void *, void *);
dc810e39
AM
727
728 void (*_bfd_coff_swap_scnhdr_in)
7920ce38 729 (bfd *, void *, void *);
dc810e39
AM
730
731 void (*_bfd_coff_swap_reloc_in)
7920ce38 732 (bfd *abfd, void *, void *);
dc810e39 733
b34976b6 734 bfd_boolean (*_bfd_coff_bad_format_hook)
7920ce38 735 (bfd *, void *);
dc810e39 736
b34976b6 737 bfd_boolean (*_bfd_coff_set_arch_mach_hook)
7920ce38 738 (bfd *, void *);
dc810e39 739
7920ce38
NC
740 void * (*_bfd_coff_mkobject_hook)
741 (bfd *, void *, void *);
dc810e39 742
b34976b6 743 bfd_boolean (*_bfd_styp_to_sec_flags_hook)
7920ce38 744 (bfd *, void *, const char *, asection *, flagword *);
dc810e39
AM
745
746 void (*_bfd_set_alignment_hook)
7920ce38 747 (bfd *, asection *, void *);
dc810e39 748
b34976b6 749 bfd_boolean (*_bfd_coff_slurp_symbol_table)
7920ce38 750 (bfd *);
dc810e39 751
b34976b6 752 bfd_boolean (*_bfd_coff_symname_in_debug)
7920ce38 753 (bfd *, struct internal_syment *);
dc810e39 754
b34976b6 755 bfd_boolean (*_bfd_coff_pointerize_aux_hook)
7920ce38
NC
756 (bfd *, combined_entry_type *, combined_entry_type *,
757 unsigned int, combined_entry_type *);
dc810e39 758
b34976b6 759 bfd_boolean (*_bfd_coff_print_aux)
7920ce38
NC
760 (bfd *, FILE *, combined_entry_type *, combined_entry_type *,
761 combined_entry_type *, unsigned int);
dc810e39
AM
762
763 void (*_bfd_coff_reloc16_extra_cases)
7920ce38
NC
764 (bfd *, struct bfd_link_info *, struct bfd_link_order *, arelent *,
765 bfd_byte *, unsigned int *, unsigned int *);
dc810e39
AM
766
767 int (*_bfd_coff_reloc16_estimate)
7920ce38
NC
768 (bfd *, asection *, arelent *, unsigned int,
769 struct bfd_link_info *);
dc810e39
AM
770
771 enum coff_symbol_classification (*_bfd_coff_classify_symbol)
7920ce38 772 (bfd *, struct internal_syment *);
dc810e39 773
b34976b6 774 bfd_boolean (*_bfd_coff_compute_section_file_positions)
7920ce38 775 (bfd *);
dc810e39 776
b34976b6 777 bfd_boolean (*_bfd_coff_start_final_link)
7920ce38 778 (bfd *, struct bfd_link_info *);
dc810e39 779
b34976b6 780 bfd_boolean (*_bfd_coff_relocate_section)
7920ce38
NC
781 (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
782 struct internal_reloc *, struct internal_syment *, asection **);
dc810e39
AM
783
784 reloc_howto_type *(*_bfd_coff_rtype_to_howto)
7920ce38 785 (bfd *, asection *, struct internal_reloc *,
dc810e39 786 struct coff_link_hash_entry *, struct internal_syment *,
7920ce38 787 bfd_vma *);
dc810e39 788
b34976b6 789 bfd_boolean (*_bfd_coff_adjust_symndx)
7920ce38
NC
790 (bfd *, struct bfd_link_info *, bfd *, asection *,
791 struct internal_reloc *, bfd_boolean *);
dc810e39 792
b34976b6 793 bfd_boolean (*_bfd_coff_link_add_one_symbol)
7920ce38 794 (struct bfd_link_info *, bfd *, const char *, flagword,
b34976b6 795 asection *, bfd_vma, const char *, bfd_boolean, bfd_boolean,
7920ce38 796 struct bfd_link_hash_entry **);
dc810e39 797
b34976b6 798 bfd_boolean (*_bfd_coff_link_output_has_begun)
7920ce38 799 (bfd *, struct coff_final_link_info *);
dc810e39 800
b34976b6 801 bfd_boolean (*_bfd_coff_final_link_postscript)
7920ce38 802 (bfd *, struct coff_final_link_info *);
252b5132
RH
803
804} bfd_coff_backend_data;
805
dc810e39
AM
806#define coff_backend_info(abfd) \
807 ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
252b5132
RH
808
809#define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
dc810e39 810 ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
252b5132
RH
811
812#define bfd_coff_swap_sym_in(a,e,i) \
dc810e39 813 ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
252b5132
RH
814
815#define bfd_coff_swap_lineno_in(a,e,i) \
dc810e39 816 ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
252b5132
RH
817
818#define bfd_coff_swap_reloc_out(abfd, i, o) \
dc810e39 819 ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
252b5132
RH
820
821#define bfd_coff_swap_lineno_out(abfd, i, o) \
dc810e39 822 ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
252b5132
RH
823
824#define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
dc810e39 825 ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
252b5132
RH
826
827#define bfd_coff_swap_sym_out(abfd, i,o) \
dc810e39 828 ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
252b5132
RH
829
830#define bfd_coff_swap_scnhdr_out(abfd, i,o) \
dc810e39 831 ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
252b5132
RH
832
833#define bfd_coff_swap_filehdr_out(abfd, i,o) \
dc810e39 834 ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
252b5132
RH
835
836#define bfd_coff_swap_aouthdr_out(abfd, i,o) \
dc810e39 837 ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
252b5132
RH
838
839#define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
840#define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
841#define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
842#define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
843#define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
844#define bfd_coff_relsz(abfd) (coff_backend_info (abfd)->_bfd_relsz)
845#define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
692b7d62 846#define bfd_coff_filnmlen(abfd) (coff_backend_info (abfd)->_bfd_filnmlen)
dc810e39
AM
847#define bfd_coff_long_filenames(abfd) \
848 (coff_backend_info (abfd)->_bfd_coff_long_filenames)
252b5132 849#define bfd_coff_long_section_names(abfd) \
dc810e39 850 (coff_backend_info (abfd)->_bfd_coff_long_section_names)
252b5132 851#define bfd_coff_default_section_alignment_power(abfd) \
dc810e39 852 (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power)
252b5132 853#define bfd_coff_swap_filehdr_in(abfd, i,o) \
dc810e39 854 ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
252b5132
RH
855
856#define bfd_coff_swap_aouthdr_in(abfd, i,o) \
dc810e39 857 ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
252b5132
RH
858
859#define bfd_coff_swap_scnhdr_in(abfd, i,o) \
dc810e39 860 ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
252b5132
RH
861
862#define bfd_coff_swap_reloc_in(abfd, i, o) \
dc810e39 863 ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
252b5132
RH
864
865#define bfd_coff_bad_format_hook(abfd, filehdr) \
dc810e39 866 ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
252b5132
RH
867
868#define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
dc810e39 869 ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
252b5132 870#define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
ed781d5d
NC
871 ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook)\
872 (abfd, filehdr, aouthdr))
252b5132 873
7c8ca0e4 874#define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name, section, flags_ptr)\
dc810e39
AM
875 ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook)\
876 (abfd, scnhdr, name, section, flags_ptr))
252b5132
RH
877
878#define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
dc810e39 879 ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
252b5132
RH
880
881#define bfd_coff_slurp_symbol_table(abfd)\
dc810e39 882 ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
252b5132
RH
883
884#define bfd_coff_symname_in_debug(abfd, sym)\
dc810e39 885 ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
252b5132 886
7f6d05e8 887#define bfd_coff_force_symnames_in_strings(abfd)\
dc810e39 888 (coff_backend_info (abfd)->_bfd_coff_force_symnames_in_strings)
7f6d05e8
CP
889
890#define bfd_coff_debug_string_prefix_length(abfd)\
dc810e39 891 (coff_backend_info (abfd)->_bfd_coff_debug_string_prefix_length)
7f6d05e8 892
252b5132 893#define bfd_coff_print_aux(abfd, file, base, symbol, aux, indaux)\
dc810e39
AM
894 ((coff_backend_info (abfd)->_bfd_coff_print_aux)\
895 (abfd, file, base, symbol, aux, indaux))
252b5132 896
ed781d5d
NC
897#define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order,\
898 reloc, data, src_ptr, dst_ptr)\
dc810e39
AM
899 ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
900 (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
252b5132
RH
901
902#define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
dc810e39
AM
903 ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
904 (abfd, section, reloc, shrink, link_info))
252b5132 905
5d54c628 906#define bfd_coff_classify_symbol(abfd, sym)\
dc810e39
AM
907 ((coff_backend_info (abfd)->_bfd_coff_classify_symbol)\
908 (abfd, sym))
252b5132
RH
909
910#define bfd_coff_compute_section_file_positions(abfd)\
dc810e39
AM
911 ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
912 (abfd))
252b5132
RH
913
914#define bfd_coff_start_final_link(obfd, info)\
dc810e39
AM
915 ((coff_backend_info (obfd)->_bfd_coff_start_final_link)\
916 (obfd, info))
252b5132 917#define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
dc810e39
AM
918 ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
919 (obfd, info, ibfd, o, con, rel, isyms, secs))
252b5132 920#define bfd_coff_rtype_to_howto(abfd, sec, rel, h, sym, addendp)\
dc810e39
AM
921 ((coff_backend_info (abfd)->_bfd_coff_rtype_to_howto)\
922 (abfd, sec, rel, h, sym, addendp))
252b5132 923#define bfd_coff_adjust_symndx(obfd, info, ibfd, sec, rel, adjustedp)\
dc810e39
AM
924 ((coff_backend_info (abfd)->_bfd_coff_adjust_symndx)\
925 (obfd, info, ibfd, sec, rel, adjustedp))
ed781d5d
NC
926#define bfd_coff_link_add_one_symbol(info, abfd, name, flags, section,\
927 value, string, cp, coll, hashp)\
dc810e39
AM
928 ((coff_backend_info (abfd)->_bfd_coff_link_add_one_symbol)\
929 (info, abfd, name, flags, section, value, string, cp, coll, hashp))
252b5132
RH
930
931#define bfd_coff_link_output_has_begun(a,p) \
7920ce38 932 ((coff_backend_info (a)->_bfd_coff_link_output_has_begun) (a, p))
252b5132 933#define bfd_coff_final_link_postscript(a,p) \
7920ce38 934 ((coff_backend_info (a)->_bfd_coff_final_link_postscript) (a, p))
252b5132 935