Mon Aug 21 17:49:28 1995 steve chamberlain <sac@slash.cygnus.com>
[deliverable/binutils-gdb.git] / bfd / libcoff.h
1 /* BFD COFF object file private structure.
2 Copyright (C) 1990, 91, 92, 93, 94, 1995 Free Software Foundation, Inc.
3 Written by Cygnus Support.
4
5 This file is part of BFD, the Binary File Descriptor library.
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
20
21 #include "bfdlink.h"
22
23 /* Object file tdata; access macros */
24
25 #define coff_data(bfd) ((bfd)->tdata.coff_obj_data)
26 #define exec_hdr(bfd) (coff_data(bfd)->hdr)
27 #define obj_pe(bfd) (coff_data(bfd)->pe)
28 #define obj_symbols(bfd) (coff_data(bfd)->symbols)
29 #define obj_sym_filepos(bfd) (coff_data(bfd)->sym_filepos)
30
31 #define obj_relocbase(bfd) (coff_data(bfd)->relocbase)
32 #define obj_raw_syments(bfd) (coff_data(bfd)->raw_syments)
33 #define obj_raw_syment_count(bfd) (coff_data(bfd)->raw_syment_count)
34 #define obj_convert(bfd) (coff_data(bfd)->conversion_table)
35 #define obj_conv_table_size(bfd) (coff_data(bfd)->conv_table_size)
36
37 #define obj_coff_external_syms(bfd) (coff_data (bfd)->external_syms)
38 #define obj_coff_keep_syms(bfd) (coff_data (bfd)->keep_syms)
39 #define obj_coff_strings(bfd) (coff_data (bfd)->strings)
40 #define obj_coff_keep_strings(bfd) (coff_data (bfd)->keep_strings)
41 #define obj_coff_sym_hashes(bfd) (coff_data (bfd)->sym_hashes)
42
43 /* `Tdata' information kept for COFF files. */
44
45 typedef struct coff_tdata
46 {
47 struct coff_symbol_struct *symbols; /* symtab for input bfd */
48 unsigned int *conversion_table;
49 int conv_table_size;
50 file_ptr sym_filepos;
51
52 struct coff_ptr_struct *raw_syments;
53 unsigned int raw_syment_count;
54
55 /* These are only valid once writing has begun */
56 long int relocbase;
57
58 /* These members communicate important constants about the symbol table
59 to GDB's symbol-reading code. These `constants' unfortunately vary
60 from coff implementation to implementation... */
61 unsigned local_n_btmask;
62 unsigned local_n_btshft;
63 unsigned local_n_tmask;
64 unsigned local_n_tshift;
65 unsigned local_symesz;
66 unsigned local_auxesz;
67 unsigned local_linesz;
68
69 /* The unswapped external symbols. May be NULL. Read by
70 _bfd_coff_get_external_symbols. */
71 PTR external_syms;
72 /* If this is true, the external_syms may not be freed. */
73 boolean keep_syms;
74
75 /* The string table. May be NULL. Read by
76 _bfd_coff_read_string_table. */
77 char *strings;
78 /* If this is true, the strings may not be freed. */
79 boolean keep_strings;
80
81 /* is this a PE format coff file */
82 int pe;
83 /* Used by the COFF backend linker. */
84 struct coff_link_hash_entry **sym_hashes;
85 struct bfd_link_info *link_info;
86 } coff_data_type;
87
88 /* We take the address of the first element of a asymbol to ensure that the
89 * macro is only ever applied to an asymbol. */
90 #define coffsymbol(asymbol) ((coff_symbol_type *)(&((asymbol)->the_bfd)))
91
92 /* The used_by_bfd field of a section may be set to a pointer to this
93 structure. */
94
95 struct coff_section_tdata
96 {
97 /* The relocs, swapped into COFF internal form. This may be NULL. */
98 struct internal_reloc *relocs;
99 /* If this is true, the relocs entry may not be freed. */
100 boolean keep_relocs;
101 /* The section contents. This may be NULL. */
102 bfd_byte *contents;
103 /* If this is true, the contents entry may not be freed. */
104 boolean keep_contents;
105 };
106
107 /* An accessor macro for the coff_section_tdata structure. */
108 #define coff_section_data(abfd, sec) \
109 ((struct coff_section_tdata *) (sec)->used_by_bfd)
110
111 /* COFF linker hash table entries. */
112
113 struct coff_link_hash_entry
114 {
115 struct bfd_link_hash_entry root;
116
117 /* Symbol index in output file. Set to -1 initially. Set to -2 if
118 there is a reloc against this symbol. */
119 long indx;
120
121 /* Symbol type. */
122 unsigned short type;
123
124 /* Symbol class. */
125 unsigned char class;
126
127 /* Number of auxiliary entries. */
128 char numaux;
129
130 /* BFD to take auxiliary entries from. */
131 bfd *auxbfd;
132
133 /* Pointer to array of auxiliary entries, if any. */
134 union internal_auxent *aux;
135 };
136
137 /* COFF linker hash table. */
138
139 struct coff_link_hash_table
140 {
141 struct bfd_link_hash_table root;
142 };
143
144 /* Look up an entry in a COFF linker hash table. */
145
146 #define coff_link_hash_lookup(table, string, create, copy, follow) \
147 ((struct coff_link_hash_entry *) \
148 bfd_link_hash_lookup (&(table)->root, (string), (create), \
149 (copy), (follow)))
150
151 /* Traverse a COFF linker hash table. */
152
153 #define coff_link_hash_traverse(table, func, info) \
154 (bfd_link_hash_traverse \
155 (&(table)->root, \
156 (boolean (*) PARAMS ((struct bfd_link_hash_entry *, PTR))) (func), \
157 (info)))
158
159 /* Get the COFF linker hash table from a link_info structure. */
160
161 #define coff_hash_table(p) ((struct coff_link_hash_table *) ((p)->hash))
162
163 /* Functions in coffgen.c. */
164 extern const bfd_target *coff_object_p PARAMS ((bfd *));
165 extern struct sec *coff_section_from_bfd_index PARAMS ((bfd *, int));
166 extern long coff_get_symtab_upper_bound PARAMS ((bfd *));
167 extern long coff_get_symtab PARAMS ((bfd *, asymbol **));
168 extern int coff_count_linenumbers PARAMS ((bfd *));
169 extern struct coff_symbol_struct *coff_symbol_from PARAMS ((bfd *, asymbol *));
170 extern boolean coff_renumber_symbols PARAMS ((bfd *, int *));
171 extern void coff_mangle_symbols PARAMS ((bfd *));
172 extern boolean coff_write_symbols PARAMS ((bfd *));
173 extern boolean coff_write_linenumbers PARAMS ((bfd *));
174 extern alent *coff_get_lineno PARAMS ((bfd *, asymbol *));
175 extern asymbol *coff_section_symbol PARAMS ((bfd *, char *));
176 extern boolean _bfd_coff_get_external_symbols PARAMS ((bfd *));
177 extern const char *_bfd_coff_read_string_table PARAMS ((bfd *));
178 extern boolean _bfd_coff_free_symbols PARAMS ((bfd *));
179 extern struct coff_ptr_struct *coff_get_normalized_symtab PARAMS ((bfd *));
180 extern long coff_get_reloc_upper_bound PARAMS ((bfd *, sec_ptr));
181 extern asymbol *coff_make_empty_symbol PARAMS ((bfd *));
182 extern void coff_print_symbol PARAMS ((bfd *, PTR filep, asymbol *,
183 bfd_print_symbol_type how));
184 extern void coff_get_symbol_info PARAMS ((bfd *, asymbol *,
185 symbol_info *ret));
186 extern asymbol *coff_bfd_make_debug_symbol PARAMS ((bfd *, PTR,
187 unsigned long));
188 extern boolean coff_find_nearest_line PARAMS ((bfd *,
189 asection *,
190 asymbol **,
191 bfd_vma offset,
192 CONST char **filename_ptr,
193 CONST char **functionname_ptr,
194 unsigned int *line_ptr));
195 extern int coff_sizeof_headers PARAMS ((bfd *, boolean reloc));
196 extern boolean bfd_coff_reloc16_relax_section
197 PARAMS ((bfd *, asection *, struct bfd_link_info *, boolean *));
198 extern bfd_byte *bfd_coff_reloc16_get_relocated_section_contents
199 PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *,
200 bfd_byte *, boolean relocateable, asymbol **));
201 extern bfd_vma bfd_coff_reloc16_get_value PARAMS ((arelent *,
202 struct bfd_link_info *,
203 asection *));
204 extern void bfd_perform_slip PARAMS ((bfd *abfd, unsigned int slip,
205 asection *input_section,
206 bfd_vma val));
207
208 /* Functions in cofflink.c. */
209
210 extern struct bfd_link_hash_table *_bfd_coff_link_hash_table_create
211 PARAMS ((bfd *));
212 extern boolean _bfd_coff_link_add_symbols
213 PARAMS ((bfd *, struct bfd_link_info *));
214 extern boolean _bfd_coff_final_link
215 PARAMS ((bfd *, struct bfd_link_info *));
216 extern struct internal_reloc *_bfd_coff_read_internal_relocs
217 PARAMS ((bfd *, asection *, boolean, bfd_byte *, boolean,
218 struct internal_reloc *));
219 extern boolean _bfd_coff_generic_relocate_section
220 PARAMS ((bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
221 struct internal_reloc *, struct internal_syment *, asection **));
222
223 /* And more taken from the source .. */
224
225 typedef struct coff_ptr_struct
226 {
227
228 /* Remembers the offset from the first symbol in the file for
229 this symbol. Generated by coff_renumber_symbols. */
230 unsigned int offset;
231
232 /* Should the value of this symbol be renumbered. Used for
233 XCOFF C_BSTAT symbols. Set by coff_slurp_symbol_table. */
234 unsigned int fix_value : 1;
235
236 /* Should the tag field of this symbol be renumbered.
237 Created by coff_pointerize_aux. */
238 unsigned int fix_tag : 1;
239
240 /* Should the endidx field of this symbol be renumbered.
241 Created by coff_pointerize_aux. */
242 unsigned int fix_end : 1;
243
244 /* Should the x_csect.x_scnlen field be renumbered.
245 Created by coff_slurp_symbol_table. */
246 unsigned int fix_scnlen : 1;
247
248 /* The container for the symbol structure as read and translated
249 from the file. */
250
251 union {
252 union internal_auxent auxent;
253 struct internal_syment syment;
254 } u;
255 } combined_entry_type;
256
257
258 /* Each canonical asymbol really looks like this: */
259
260 typedef struct coff_symbol_struct
261 {
262 /* The actual symbol which the rest of BFD works with */
263 asymbol symbol;
264
265 /* A pointer to the hidden information for this symbol */
266 combined_entry_type *native;
267
268 /* A pointer to the linenumber information for this symbol */
269 struct lineno_cache_entry *lineno;
270
271 /* Have the line numbers been relocated yet ? */
272 boolean done_lineno;
273 } coff_symbol_type;
274 typedef struct
275 {
276 void (*_bfd_coff_swap_aux_in) PARAMS ((
277 bfd *abfd,
278 PTR ext,
279 int type,
280 int class,
281 int indaux,
282 int numaux,
283 PTR in));
284
285 void (*_bfd_coff_swap_sym_in) PARAMS ((
286 bfd *abfd ,
287 PTR ext,
288 PTR in));
289
290 void (*_bfd_coff_swap_lineno_in) PARAMS ((
291 bfd *abfd,
292 PTR ext,
293 PTR in));
294
295 unsigned int (*_bfd_coff_swap_aux_out) PARAMS ((
296 bfd *abfd,
297 PTR in,
298 int type,
299 int class,
300 int indaux,
301 int numaux,
302 PTR ext));
303
304 unsigned int (*_bfd_coff_swap_sym_out) PARAMS ((
305 bfd *abfd,
306 PTR in,
307 PTR ext));
308
309 unsigned int (*_bfd_coff_swap_lineno_out) PARAMS ((
310 bfd *abfd,
311 PTR in,
312 PTR ext));
313
314 unsigned int (*_bfd_coff_swap_reloc_out) PARAMS ((
315 bfd *abfd,
316 PTR src,
317 PTR dst));
318
319 unsigned int (*_bfd_coff_swap_filehdr_out) PARAMS ((
320 bfd *abfd,
321 PTR in,
322 PTR out));
323
324 unsigned int (*_bfd_coff_swap_aouthdr_out) PARAMS ((
325 bfd *abfd,
326 PTR in,
327 PTR out));
328
329 unsigned int (*_bfd_coff_swap_scnhdr_out) PARAMS ((
330 bfd *abfd,
331 PTR in,
332 PTR out));
333
334 unsigned int _bfd_filhsz;
335 unsigned int _bfd_aoutsz;
336 unsigned int _bfd_scnhsz;
337 unsigned int _bfd_symesz;
338 unsigned int _bfd_auxesz;
339 unsigned int _bfd_relsz;
340 unsigned int _bfd_linesz;
341 boolean _bfd_coff_long_filenames;
342 void (*_bfd_coff_swap_filehdr_in) PARAMS ((
343 bfd *abfd,
344 PTR ext,
345 PTR in));
346 void (*_bfd_coff_swap_aouthdr_in) PARAMS ((
347 bfd *abfd,
348 PTR ext,
349 PTR in));
350 void (*_bfd_coff_swap_scnhdr_in) PARAMS ((
351 bfd *abfd,
352 PTR ext,
353 PTR in));
354 void (*_bfd_coff_swap_reloc_in) PARAMS ((
355 bfd *abfd,
356 PTR ext,
357 PTR in));
358 boolean (*_bfd_coff_bad_format_hook) PARAMS ((
359 bfd *abfd,
360 PTR internal_filehdr));
361 boolean (*_bfd_coff_set_arch_mach_hook) PARAMS ((
362 bfd *abfd,
363 PTR internal_filehdr));
364 PTR (*_bfd_coff_mkobject_hook) PARAMS ((
365 bfd *abfd,
366 PTR internal_filehdr,
367 PTR internal_aouthdr));
368 flagword (*_bfd_styp_to_sec_flags_hook) PARAMS ((
369 bfd *abfd,
370 PTR internal_scnhdr,
371 const char *name));
372 asection *(*_bfd_make_section_hook) PARAMS ((
373 bfd *abfd,
374 char *name));
375 void (*_bfd_set_alignment_hook) PARAMS ((
376 bfd *abfd,
377 asection *sec,
378 PTR internal_scnhdr));
379 boolean (*_bfd_coff_slurp_symbol_table) PARAMS ((
380 bfd *abfd));
381 boolean (*_bfd_coff_symname_in_debug) PARAMS ((
382 bfd *abfd,
383 struct internal_syment *sym));
384 void (*_bfd_coff_reloc16_extra_cases) PARAMS ((
385 bfd *abfd,
386 struct bfd_link_info *link_info,
387 struct bfd_link_order *link_order,
388 arelent *reloc,
389 bfd_byte *data,
390 unsigned int *src_ptr,
391 unsigned int *dst_ptr));
392 int (*_bfd_coff_reloc16_estimate) PARAMS ((
393 bfd *abfd,
394 asection *input_section,
395 arelent *r,
396 unsigned int shrink,
397 struct bfd_link_info *link_info));
398 boolean (*_bfd_coff_sym_is_global) PARAMS ((
399 bfd *abfd,
400 struct internal_syment *));
401 void (*_bfd_coff_compute_section_file_positions) PARAMS ((
402 bfd *abfd));
403 boolean (*_bfd_coff_relocate_section) PARAMS ((
404 bfd *output_bfd,
405 struct bfd_link_info *info,
406 bfd *input_bfd,
407 asection *input_section,
408 bfd_byte *contents,
409 struct internal_reloc *relocs,
410 struct internal_syment *syms,
411 asection **sections));
412 reloc_howto_type *(*_bfd_coff_rtype_to_howto) PARAMS ((
413 bfd *abfd,
414 asection *sec,
415 struct internal_reloc *rel,
416 struct coff_link_hash_entry *h,
417 struct internal_syment *sym,
418 bfd_vma *addendp));
419 boolean (*_bfd_coff_adjust_symndx) PARAMS ((
420 bfd *obfd,
421 struct bfd_link_info *info,
422 bfd *ibfd,
423 asection *sec,
424 struct internal_reloc *reloc,
425 boolean *adjustedp));
426
427 } bfd_coff_backend_data;
428
429 #define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
430
431 #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
432 ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
433
434 #define bfd_coff_swap_sym_in(a,e,i) \
435 ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
436
437 #define bfd_coff_swap_lineno_in(a,e,i) \
438 ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
439
440 #define bfd_coff_swap_reloc_out(abfd, i, o) \
441 ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
442
443 #define bfd_coff_swap_lineno_out(abfd, i, o) \
444 ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
445
446 #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
447 ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
448
449 #define bfd_coff_swap_sym_out(abfd, i,o) \
450 ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
451
452 #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
453 ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
454
455 #define bfd_coff_swap_filehdr_out(abfd, i,o) \
456 ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
457
458 #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
459 ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
460
461 #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
462 #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
463 #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
464 #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
465 #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
466 #define bfd_coff_relsz(abfd) (coff_backend_info (abfd)->_bfd_relsz)
467 #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
468 #define bfd_coff_long_filenames(abfd) (coff_backend_info (abfd)->_bfd_coff_long_filenames)
469 #define bfd_coff_swap_filehdr_in(abfd, i,o) \
470 ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
471
472 #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
473 ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
474
475 #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
476 ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
477
478 #define bfd_coff_swap_reloc_in(abfd, i, o) \
479 ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
480
481 #define bfd_coff_bad_format_hook(abfd, filehdr) \
482 ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
483
484 #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
485 ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
486 #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
487 ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook) (abfd, filehdr, aouthdr))
488
489 #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name)\
490 ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook) (abfd, scnhdr, name))
491
492 #define bfd_coff_make_section_hook(abfd, name)\
493 ((coff_backend_info (abfd)->_bfd_make_section_hook) (abfd, name))
494
495 #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
496 ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
497
498 #define bfd_coff_slurp_symbol_table(abfd)\
499 ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
500
501 #define bfd_coff_symname_in_debug(abfd, sym)\
502 ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
503
504 #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr)\
505 ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
506 (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
507
508 #define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
509 ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
510 (abfd, section, reloc, shrink, link_info))
511
512 #define bfd_coff_sym_is_global(abfd, sym)\
513 ((coff_backend_info (abfd)->_bfd_coff_sym_is_global)\
514 (abfd, sym))
515
516 #define bfd_coff_compute_section_file_positions(abfd)\
517 ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
518 (abfd))
519
520 #define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
521 ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
522 (obfd, info, ibfd, o, con, rel, isyms, secs))
523 #define bfd_coff_rtype_to_howto(abfd, sec, rel, h, sym, addendp)\
524 ((coff_backend_info (abfd)->_bfd_coff_rtype_to_howto)\
525 (abfd, sec, rel, h, sym, addendp))
526 #define bfd_coff_adjust_symndx(obfd, info, ibfd, sec, rel, adjustedp)\
527 ((coff_backend_info (abfd)->_bfd_coff_adjust_symndx)\
528 (obfd, info, ibfd, sec, rel, adjustedp))
529
This page took 0.041644 seconds and 5 git commands to generate.