* i386.h: a.out magic numbers from
[deliverable/binutils-gdb.git] / include / bfd.h
CommitLineData
095c7223
JG
1/* A -*- C -*- header file for the bfd library
2 Copyright 1990, 1991 Free Software Foundation, Inc.
3 Contributed by Cygnus Support.
a07cc613 4
2c346475 5This file is part of BFD, the Binary File Descriptor library.
a07cc613 6
095c7223 7This program is free software; you can redistribute it and/or modify
a07cc613 8it under the terms of the GNU General Public License as published by
095c7223
JG
9the Free Software Foundation; either version 2 of the License, or
10(at your option) any later version.
a07cc613 11
095c7223 12This program is distributed in the hope that it will be useful,
a07cc613
JG
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
095c7223
JG
18along with this program; if not, write to the Free Software
19Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
20
21/* bfd.h -- The only header file required by users of the bfd library
22
23This file is generated from various .c files, if you change it, your
24bits may be lost.
25
26All the prototypes and definitions following the comment "THE FOLLOWING
27IS EXTRACTED FROM THE SOURCE" are extracted from the source files for
28BFD. If you change it, someone oneday will extract it from the source
29again, and your changes will be lost. To save yourself from this bind,
30change the definitions in the source in the bfd directory. Type "make
31docs" and then "make headers" in that directory, and magically this file
32will change to reflect your changes.
33
34If you don't have the tools to perform the extraction, then you are
35safe from someone on your system trampling over your header files.
36You should still maintain the equivalence between the source and this
37file though; every change you make to the .c file should be reflected
38here. */
a07cc613 39
a07cc613
JG
40#ifndef __BFD_H_SEEN__
41#define __BFD_H_SEEN__
42
43#include "ansidecl.h"
44#include "obstack.h"
45
46/* Make it easier to declare prototypes (puts conditional here) */
47#ifndef PROTO
48# if __STDC__
49# define PROTO(type, name, arglist) type name arglist
50# else
51# define PROTO(type, name, arglist) type name ()
52# endif
53#endif
54
c72b7dca 55#define BFD_VERSION "1.97"
ec08b077 56
a07cc613 57/* forward declaration */
9c6a9c92 58typedef struct _bfd bfd;
a07cc613 59
ec08b077
JG
60/* General rules: functions which are boolean return true on success
61 and false on failure (unless they're a predicate). -- bfd.doc */
a07cc613
JG
62/* I'm sure this is going to break something and someone is going to
63 force me to change it. */
f7cfc4a6
JG
64/* typedef enum boolean {false, true} boolean; */
65/* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h> -fnf */
66typedef enum bfd_boolean {false, true} boolean;
a07cc613
JG
67
68/* Try to avoid breaking stuff */
69typedef long int file_ptr;
70
9b9c5c39 71/* Support for different sizes of target format ints and addresses */
19b03b7a 72
9b9c5c39 73#ifdef HOST_64_BIT
7ed4093a
SC
74typedef HOST_64_BIT rawdata_offset;
75typedef HOST_64_BIT bfd_vma;
76typedef HOST_64_BIT bfd_word;
77typedef HOST_64_BIT bfd_offset;
78typedef HOST_64_BIT bfd_size_type;
9b9c5c39 79typedef HOST_64_BIT symvalue;
7ed4093a 80typedef HOST_64_BIT bfd_64_type;
9b9c5c39
JG
81#define fprintf_vma(s,x) \
82 fprintf(s,"%08x%08x", uint64_typeHIGH(x), uint64_typeLOW(x))
19b03b7a 83#else
9b9c5c39
JG
84typedef struct {int a,b;} bfd_64_type;
85typedef unsigned long rawdata_offset;
a07cc613
JG
86typedef unsigned long bfd_vma;
87typedef unsigned long bfd_offset;
19b03b7a
SC
88typedef unsigned long bfd_word;
89typedef unsigned long bfd_size;
90typedef unsigned long symvalue;
91typedef unsigned long bfd_size_type;
a737c70b 92#define fprintf_vma(s,x) fprintf(s, "%08lx", x)
19b03b7a 93#endif
1d2c5574 94#define printf_vma(x) fprintf_vma(stdout,x)
a07cc613
JG
95
96typedef unsigned int flagword; /* 32 bits of flags */
97\f
98/** File formats */
99
100typedef enum bfd_format {
101 bfd_unknown = 0, /* file format is unknown */
102 bfd_object, /* linker/assember/compiler output */
103 bfd_archive, /* object archive file */
104 bfd_core, /* core dump */
105 bfd_type_end} /* marks the end; don't use it! */
106 bfd_format;
107
108/* Object file flag values */
9b9c5c39 109#define NO_FLAGS 0
a07cc613
JG
110#define HAS_RELOC 001
111#define EXEC_P 002
112#define HAS_LINENO 004
113#define HAS_DEBUG 010
114#define HAS_SYMS 020
115#define HAS_LOCALS 040
116#define DYNAMIC 0100
117#define WP_TEXT 0200
118#define D_PAGED 0400
119
a07cc613
JG
120\f
121/* symbols and relocation */
122
123typedef unsigned long symindex;
124
125#define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
126
fb3ee1c0
JG
127typedef enum bfd_symclass {
128 bfd_symclass_unknown = 0,
a07cc613
JG
129 bfd_symclass_fcommon, /* fortran common symbols */
130 bfd_symclass_global, /* global symbol, what a surprise */
131 bfd_symclass_debugger, /* some debugger symbol */
132 bfd_symclass_undefined /* none known */
133 } symclass;
134
19b03b7a 135
a07cc613 136typedef int symtype; /* Who knows, yet? */
19b03b7a 137
a07cc613 138
9b9c5c39
JG
139/* general purpose part of a symbol;
140 target specific parts will be found in libcoff.h, liba.out.h etc */
7a276b09 141
a07cc613
JG
142
143#define bfd_get_section(x) ((x)->section)
144#define bfd_get_output_section(x) ((x)->section->output_section)
145#define bfd_set_section(x,y) ((x)->section) = (y)
146#define bfd_asymbol_base(x) ((x)->section?((x)->section->vma):0)
147#define bfd_asymbol_value(x) (bfd_asymbol_base(x) + x->value)
148#define bfd_asymbol_name(x) ((x)->name)
149
a07cc613 150/* This is a type pun with struct ranlib on purpose! */
9c6a9c92 151typedef struct carsym {
a07cc613
JG
152 char *name;
153 file_ptr file_offset; /* look here to find the file */
154} carsym; /* to make these you call a carsymogen */
155
a07cc613
JG
156
157/* Used in generating armaps. Perhaps just a forward definition would do? */
158struct orl { /* output ranlib */
159 char **name; /* symbol name */
c93e2c55 160 file_ptr pos; /* bfd* or file position */
a07cc613
JG
161 int namidx; /* index into string table */
162};
163
164\f
165
166/* Linenumber stuff */
167typedef struct lineno_cache_entry {
168 unsigned int line_number; /* Linenumber from start of function*/
169 union {
7a276b09 170 struct symbol_cache_entry *sym; /* Function name */
a07cc613
JG
171 unsigned long offset; /* Offset into section */
172 } u;
173} alent;
174\f
175/* object and core file sections */
176
a07cc613
JG
177
178#define align_power(addr, align) \
179 ( ((addr) + ((1<<(align))-1)) & (-1 << (align)))
180
9c6a9c92 181typedef struct sec *sec_ptr;
a07cc613 182
d5ceae78
KR
183#define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
184#define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
185#define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
a07cc613 186#define bfd_section_name(bfd, ptr) ((ptr)->name)
9a7c5449 187#define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr))
a07cc613
JG
188#define bfd_section_vma(bfd, ptr) ((ptr)->vma)
189#define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
d5ceae78 190#define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
a07cc613
JG
191#define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
192
193#define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (val)), true)
194#define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true)
195#define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true)
4322f04d
SC
196
197typedef struct stat stat_type;
a07cc613
JG
198\f
199/** Error handling */
200
fb3ee1c0
JG
201typedef enum bfd_error {
202 no_error = 0, system_call_error, invalid_target,
a07cc613
JG
203 wrong_format, invalid_operation, no_memory,
204 no_symbols, no_relocation_info,
205 no_more_archived_files, malformed_archive,
206 symbol_not_found, file_not_recognized,
207 file_ambiguously_recognized, no_contents,
6603bf38 208 bfd_error_nonrepresentable_section,
d5ceae78 209 no_debug_section, bad_value,
a07cc613
JG
210 invalid_error_code} bfd_ec;
211
212extern bfd_ec bfd_error;
9a7c5449
SC
213struct reloc_cache_entry;
214struct bfd_seclet_struct ;
215
a07cc613 216
9c6a9c92 217typedef struct bfd_error_vector {
a07cc613
JG
218 PROTO(void,(* nonrepresentable_section ),(CONST bfd *CONST abfd,
219 CONST char *CONST name));
9a7c5449
SC
220 PROTO(void,(* undefined_symbol),(CONST struct reloc_cache_entry *rel,
221 CONST struct bfd_seclet_struct *sec
222 ));
223 PROTO(void, (* reloc_value_truncated),(CONST struct
224 reloc_cache_entry *rel,
225 struct bfd_seclet_struct *sec));
226
227 PROTO(void, (* reloc_dangerous),(CONST struct reloc_cache_entry *rel,
228 CONST struct bfd_seclet_struct *sec));
229
a07cc613
JG
230} bfd_error_vector_type;
231
d5ceae78 232PROTO (CONST char *, bfd_errmsg, (bfd_ec error_tag));
a07cc613
JG
233PROTO (void, bfd_perror, (CONST char *message));
234\f
235
9b9c5c39 236typedef enum bfd_print_symbol
a07cc613 237{
81f8fee9
JG
238 bfd_print_symbol_name,
239 bfd_print_symbol_more,
b941cb35 240 bfd_print_symbol_all,
0aa70210 241 bfd_print_symbol_nm /* Pretty format suitable for nm program. */
81f8fee9 242} bfd_print_symbol_type;
a07cc613
JG
243
244\f
a07cc613
JG
245\f
246/* The code that implements targets can initialize a jump table with this
247 macro. It must name all its routines the same way (a prefix plus
248 the standard routine suffix), or it must #define the routines that
249 are not so named, before calling JUMP_TABLE in the initializer. */
250
251/* Semi-portable string concatenation in cpp */
252#ifndef CAT
253#ifdef __STDC__
254#define CAT(a,b) a##b
255#else
256#define CAT(a,b) a/**/b
257#endif
258#endif
259
260#define JUMP_TABLE(NAME)\
261CAT(NAME,_core_file_failing_command),\
262CAT(NAME,_core_file_failing_signal),\
263CAT(NAME,_core_file_matches_executable_p),\
264CAT(NAME,_slurp_armap),\
265CAT(NAME,_slurp_extended_name_table),\
266CAT(NAME,_truncate_arname),\
267CAT(NAME,_write_armap),\
268CAT(NAME,_close_and_cleanup), \
269CAT(NAME,_set_section_contents),\
270CAT(NAME,_get_section_contents),\
271CAT(NAME,_new_section_hook),\
272CAT(NAME,_get_symtab_upper_bound),\
273CAT(NAME,_get_symtab),\
274CAT(NAME,_get_reloc_upper_bound),\
275CAT(NAME,_canonicalize_reloc),\
276CAT(NAME,_make_empty_symbol),\
277CAT(NAME,_print_symbol),\
278CAT(NAME,_get_lineno),\
279CAT(NAME,_set_arch_mach),\
280CAT(NAME,_openr_next_archived_file),\
281CAT(NAME,_find_nearest_line),\
282CAT(NAME,_generic_stat_arch_elt),\
7a276b09
SC
283CAT(NAME,_sizeof_headers),\
284CAT(NAME,_bfd_debug_info_start),\
285CAT(NAME,_bfd_debug_info_end),\
9a7c5449 286CAT(NAME,_bfd_debug_info_accumulate),\
daa91756
SC
287CAT(NAME,_bfd_get_relocated_section_contents),\
288CAT(NAME,_bfd_relax_section)
2700c3c7 289
0c210c9c
SC
290#define COFF_SWAP_TABLE \
291 coff_swap_aux_in, coff_swap_sym_in, coff_swap_lineno_in, \
292 coff_swap_aux_out, coff_swap_sym_out, \
293 coff_swap_lineno_out, coff_swap_reloc_out, \
294 coff_swap_filehdr_out, coff_swap_aouthdr_out, \
295 coff_swap_scnhdr_out
296
297
a07cc613
JG
298\f
299/* User program access to BFD facilities */
300
301extern CONST short _bfd_host_big_endian;
302#define HOST_BYTE_ORDER_BIG_P (*(char *)&_bfd_host_big_endian)
303
304/* The bfd itself */
305
8c01a0ea
JK
306/* Cast from const char * to char * so that caller can assign to
307 a char * without a warning. */
308#define bfd_get_filename(abfd) ((char *) (abfd)->filename)
a07cc613
JG
309#define bfd_get_format(abfd) ((abfd)->format)
310#define bfd_get_target(abfd) ((abfd)->xvec->name)
311#define bfd_get_file_flags(abfd) ((abfd)->flags)
312#define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
313#define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
22ef104a 314#define bfd_my_archive(abfd) ((abfd)->my_archive)
a07cc613
JG
315#define bfd_has_map(abfd) ((abfd)->has_armap)
316#define bfd_header_twiddle_required(abfd) \
317 ((((abfd)->xvec->header_byteorder_big_p) \
318 != (boolean)HOST_BYTE_ORDER_BIG_P) ? true:false)
319
320#define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
321#define bfd_usrdata(abfd) ((abfd)->usrdata)
322
323#define bfd_get_start_address(abfd) ((abfd)->start_address)
324#define bfd_get_symcount(abfd) ((abfd)->symcount)
325#define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
326#define bfd_count_sections(abfd) ((abfd)->section_count)
327#define bfd_get_architecture(abfd) ((abfd)->obj_arch)
328#define bfd_get_machine(abfd) ((abfd)->obj_machine)
329
a07cc613 330
a07cc613 331
7a276b09
SC
332#define BYTE_SIZE 1
333#define SHORT_SIZE 2
334#define LONG_SIZE 4
335
d5ceae78 336/* And more from the source. */
6d56c69a
SC
337void EXFUN(bfd_init, (void));
338bfd *EXFUN(bfd_openr, (CONST char *filename, CONST char*target));
339bfd *EXFUN(bfd_fdopenr, (CONST char *filename, CONST char *target, int fd));
340bfd *EXFUN(bfd_openw, (CONST char *filename, CONST char *target));
341boolean EXFUN(bfd_close, (bfd *));
342boolean EXFUN(bfd_close_all_done, (bfd *));
6d56c69a 343bfd_size_type EXFUN(bfd_alloc_size, (bfd *abfd));
332b6327 344bfd *EXFUN(bfd_create, (CONST char *filename, bfd *template));
7a276b09
SC
345#define bfd_put_8(abfd, val, ptr) \
346 (*((char *)ptr) = (char)val)
347#define bfd_get_8(abfd, ptr) \
348 (*((char *)ptr))
349#define bfd_put_16(abfd, val, ptr) \
350 BFD_SEND(abfd, bfd_putx16, (val,ptr))
351#define bfd_get_16(abfd, ptr) \
352 BFD_SEND(abfd, bfd_getx16, (ptr))
353#define bfd_put_32(abfd, val, ptr) \
354 BFD_SEND(abfd, bfd_putx32, (val,ptr))
355#define bfd_get_32(abfd, ptr) \
356 BFD_SEND(abfd, bfd_getx32, (ptr))
357#define bfd_put_64(abfd, val, ptr) \
358 BFD_SEND(abfd, bfd_putx64, (val, ptr))
359#define bfd_get_64(abfd, ptr) \
360 BFD_SEND(abfd, bfd_getx64, (ptr))
7a276b09
SC
361#define bfd_h_put_8(abfd, val, ptr) \
362 (*((char *)ptr) = (char)val)
363#define bfd_h_get_8(abfd, ptr) \
364 (*((char *)ptr))
365#define bfd_h_put_16(abfd, val, ptr) \
366 BFD_SEND(abfd, bfd_h_putx16,(val,ptr))
367#define bfd_h_get_16(abfd, ptr) \
368 BFD_SEND(abfd, bfd_h_getx16,(ptr))
369#define bfd_h_put_32(abfd, val, ptr) \
370 BFD_SEND(abfd, bfd_h_putx32,(val,ptr))
371#define bfd_h_get_32(abfd, ptr) \
372 BFD_SEND(abfd, bfd_h_getx32,(ptr))
373#define bfd_h_put_64(abfd, val, ptr) \
374 BFD_SEND(abfd, bfd_h_putx64,(val, ptr))
375#define bfd_h_get_64(abfd, ptr) \
376 BFD_SEND(abfd, bfd_h_getx64,(ptr))
332b6327
SC
377typedef struct sec
378{
379 /* The name of the section, the name isn't a copy, the pointer is
380 the same as that passed to bfd_make_section. */
381
7a276b09 382 CONST char *name;
332b6327 383
9a7c5449
SC
384
385 /* Which section is it 0.nth */
386
387 int index;
388
332b6327
SC
389 /* The next section in the list belonging to the BFD, or NULL. */
390
7a276b09 391 struct sec *next;
332b6327
SC
392
393 /* The field flags contains attributes of the section. Some of
394 flags are read in from the object file, and some are
395 synthesized from other information. */
396
6d56c69a 397 flagword flags;
332b6327 398
7a276b09 399#define SEC_NO_FLAGS 0x000
332b6327
SC
400
401 /* Tells the OS to allocate space for this section when loaded.
402 This would clear for a section containing debug information
403 only. */
404
405
7a276b09 406#define SEC_ALLOC 0x001
332b6327
SC
407 /* Tells the OS to load the section from the file when loading.
408 This would be clear for a .bss section */
409
7a276b09 410#define SEC_LOAD 0x002
332b6327
SC
411 /* The section contains data still to be relocated, so there will
412 be some relocation information too. */
413
7a276b09 414#define SEC_RELOC 0x004
332b6327
SC
415
416 /* Obsolete ? */
417
7a276b09 418#define SEC_BALIGN 0x008
332b6327
SC
419
420 /* A signal to the OS that the section contains read only
421 data. */
7a276b09 422#define SEC_READONLY 0x010
332b6327
SC
423
424 /* The section contains code only. */
425
7a276b09 426#define SEC_CODE 0x020
332b6327
SC
427
428 /* The section contains data only. */
429
7a276b09 430#define SEC_DATA 0x040
332b6327
SC
431
432 /* The section will reside in ROM. */
433
7a276b09 434#define SEC_ROM 0x080
332b6327
SC
435
436 /* The section contains constructor information. This section
437 type is used by the linker to create lists of constructors and
438 destructors used by <<g++>>. When a back end sees a symbol
439 which should be used in a constructor list, it creates a new
440 section for the type of name (eg <<__CTOR_LIST__>>), attaches
441 the symbol to it and builds a relocation. To build the lists
442 of constructors, all the linker has to to is catenate all the
443 sections called <<__CTOR_LIST__>> and relocte the data
444 contained within - exactly the operations it would peform on
445 standard data. */
446
7a276b09 447#define SEC_CONSTRUCTOR 0x100
332b6327
SC
448
449 /* The section is a constuctor, and should be placed at the
450 end of the . */
451
452
1c6c6598 453#define SEC_CONSTRUCTOR_TEXT 0x1100
332b6327 454
1c6c6598 455#define SEC_CONSTRUCTOR_DATA 0x2100
332b6327 456
1c6c6598 457#define SEC_CONSTRUCTOR_BSS 0x3100
332b6327
SC
458
459
460 /* The section has contents - a bss section could be
461 <<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>, a debug section could be
462 <<SEC_HAS_CONTENTS>> */
463
7a276b09 464#define SEC_HAS_CONTENTS 0x200
332b6327
SC
465
466 /* An instruction to the linker not to output sections
467 containing this flag even if they have information which
468 would normally be written. */
469
7a276b09 470#define SEC_NEVER_LOAD 0x400
332b6327 471
9a7c5449 472
332b6327 473
7a276b09 474 bfd_vma vma;
332b6327 475
9a7c5449 476 /* The size of the section in bytes, as it will be output.
332b6327 477 contains a value even if the section has no contents (eg, the
9a7c5449 478 size of <<.bss>>). This will be filled in after relocation */
332b6327 479
9a7c5449
SC
480 bfd_size_type _cooked_size;
481
482 /* The size on disk of the section in bytes originally. Normally this
483 value is the same as the size, but if some relaxing has
484 been done, then this value will be bigger. */
485
486 bfd_size_type _raw_size;
332b6327
SC
487
488 /* If this section is going to be output, then this value is the
489 offset into the output section of the first byte in the input
490 section. Eg, if this was going to start at the 100th byte in
491 the output section, this value would be 100. */
492
7a276b09 493 bfd_vma output_offset;
332b6327
SC
494
495 /* The output section through which to map on output. */
496
7a276b09 497 struct sec *output_section;
332b6327
SC
498
499 /* The alignment requirement of the section, as an exponent - eg
500 3 aligns to 2^3 (or 8) */
501
7a276b09 502 unsigned int alignment_power;
332b6327
SC
503
504 /* If an input section, a pointer to a vector of relocation
505 records for the data in this section. */
506
7a276b09 507 struct reloc_cache_entry *relocation;
332b6327
SC
508
509 /* If an output section, a pointer to a vector of pointers to
510 relocation records for the data in this section. */
511
7a276b09 512 struct reloc_cache_entry **orelocation;
332b6327
SC
513
514 /* The number of relocation records in one of the above */
515
7a276b09 516 unsigned reloc_count;
332b6327 517
332b6327
SC
518 /* Information below is back end specific - and not always used
519 or updated
520
521 File position of section data */
522
7a276b09 523 file_ptr filepos;
332b6327
SC
524
525 /* File position of relocation info */
526
7a276b09 527 file_ptr rel_filepos;
332b6327
SC
528
529 /* File position of line data */
530
7a276b09 531 file_ptr line_filepos;
332b6327
SC
532
533 /* Pointer to data for applications */
534
7a276b09 535 PTR userdata;
332b6327 536
7a276b09 537 struct lang_output_section *otheruserdata;
332b6327
SC
538
539 /* Attached line number information */
540
7a276b09 541 alent *lineno;
332b6327
SC
542
543 /* Number of line number records */
544
7a276b09 545 unsigned int lineno_count;
332b6327
SC
546
547 /* When a section is being output, this value changes as more
548 linenumbers are written out */
549
7a276b09 550 file_ptr moving_line_filepos;
332b6327
SC
551
552 /* what the section number is in the target world */
553
9a7c5449 554 int target_index;
332b6327 555
7a276b09 556 PTR used_by_bfd;
332b6327
SC
557
558 /* If this is a constructor section then here is a list of the
559 relocations created to relocate items within it. */
560
7a276b09 561 struct relent_chain *constructor_chain;
332b6327
SC
562
563 /* The BFD which owns the section. */
564
7a276b09 565 bfd *owner;
332b6327 566
9a7c5449
SC
567 boolean reloc_done;
568 /* A symbol which points at this section only */
569 struct symbol_cache_entry *symbol;
570 struct symbol_cache_entry **symbol_ptr_ptr;
571 struct bfd_seclet_struct *seclets_head;
572 struct bfd_seclet_struct *seclets_tail;
7a276b09 573} asection ;
9a7c5449
SC
574
575
576#define BFD_ABS_SECTION_NAME "*ABS*"
577#define BFD_UND_SECTION_NAME "*UND*"
578#define BFD_COM_SECTION_NAME "*COM*"
579
580 /* the absolute section */
581 extern asection bfd_abs_section;
582 /* Pointer to the undefined section */
583 extern asection bfd_und_section;
584 /* Pointer to the common section */
585 extern asection bfd_com_section;
586
587 extern struct symbol_cache_entry *bfd_abs_symbol;
588 extern struct symbol_cache_entry *bfd_com_symbol;
589 extern struct symbol_cache_entry *bfd_und_symbol;
590#define bfd_get_section_size_before_reloc(section) \
591 (section->reloc_done ? (abort(),1): (section)->_raw_size)
592#define bfd_get_section_size_after_reloc(section) \
593 ((section->reloc_done) ? (section)->_cooked_size: (abort(),1))
6d56c69a
SC
594asection *EXFUN(bfd_get_section_by_name, (bfd *abfd, CONST char *name));
595asection *EXFUN(bfd_make_section_old_way, (bfd *, CONST char *name));
596asection * EXFUN(bfd_make_section, (bfd *, CONST char *name));
597boolean EXFUN(bfd_set_section_flags, (bfd *, asection *, flagword));
f48e5efe
JG
598void EXFUN(bfd_map_over_sections, (bfd *abfd,
599 void (*func)(bfd *abfd,
600 asection *sect,
601 PTR obj),
602 PTR obj));
6d56c69a
SC
603boolean EXFUN(bfd_set_section_size, (bfd *, asection *, bfd_size_type val));
604boolean EXFUN(bfd_set_section_contents
332b6327
SC
605 , (bfd *abfd,
606 asection *section,
607 PTR data,
608 file_ptr offset,
609 bfd_size_type count));
6d56c69a 610boolean EXFUN(bfd_get_section_contents
332b6327
SC
611 , (bfd *abfd, asection *section, PTR location,
612 file_ptr offset, bfd_size_type count));
b39096a4 613enum bfd_architecture
7a276b09 614{
6d56c69a
SC
615 bfd_arch_unknown, /* File arch not known */
616 bfd_arch_obscure, /* Arch known, not one of these */
617 bfd_arch_m68k, /* Motorola 68xxx */
618 bfd_arch_vax, /* DEC Vax */
619 bfd_arch_i960, /* Intel 960 */
620 /* The order of the following is important.
b39096a4
SC
621 lower number indicates a machine type that
622 only accepts a subset of the instructions
623 available to machines with higher numbers.
624 The exception is the "ca", which is
625 incompatible with all other machines except
626 "core". */
7a276b09 627
b39096a4
SC
628#define bfd_mach_i960_core 1
629#define bfd_mach_i960_ka_sa 2
630#define bfd_mach_i960_kb_sb 3
631#define bfd_mach_i960_mc 4
632#define bfd_mach_i960_xa 5
633#define bfd_mach_i960_ca 6
634
6d56c69a
SC
635 bfd_arch_a29k, /* AMD 29000 */
636 bfd_arch_sparc, /* SPARC */
637 bfd_arch_mips, /* MIPS Rxxxx */
638 bfd_arch_i386, /* Intel 386 */
639 bfd_arch_ns32k, /* National Semiconductor 32xxx */
640 bfd_arch_tahoe, /* CCI/Harris Tahoe */
641 bfd_arch_i860, /* Intel 860 */
642 bfd_arch_romp, /* IBM ROMP PC/RT */
643 bfd_arch_alliant, /* Alliant */
644 bfd_arch_convex, /* Convex */
645 bfd_arch_m88k, /* Motorola 88xxx */
646 bfd_arch_pyramid, /* Pyramid Technology */
647 bfd_arch_h8300, /* Hitachi H8/300 */
648 bfd_arch_rs6000, /* IBM RS/6000 */
b39096a4
SC
649 bfd_arch_last
650 };
81f8fee9 651typedef int bfd_reloc_code_type;
bded7de2 652
81f8fee9 653typedef struct bfd_arch_info
b39096a4
SC
654{
655 int bits_per_word;
656 int bits_per_address;
657 int bits_per_byte;
658 enum bfd_architecture arch;
659 long mach;
660 char *arch_name;
661 CONST char *printable_name;
43857158
SC
662 /* true if this is the default machine for the architecture */
663 unsigned int section_align_power;
b39096a4 664 boolean the_default;
6d56c69a
SC
665 CONST struct bfd_arch_info * EXFUN((*compatible),
666 (CONST struct bfd_arch_info *a,
667 CONST struct bfd_arch_info *b));
b39096a4 668
81f8fee9 669 boolean EXFUN((*scan),(CONST struct bfd_arch_info *,CONST char *));
b39096a4
SC
670 unsigned int EXFUN((*disassemble),(bfd_vma addr, CONST char *data,
671 PTR stream));
b39096a4 672
81f8fee9 673 struct bfd_arch_info *next;
b39096a4 674
81f8fee9 675} bfd_arch_info_type;
6d56c69a
SC
676CONST char *EXFUN(bfd_printable_name, (bfd *abfd));
677bfd_arch_info_type *EXFUN(bfd_scan_arch, (CONST char *));
678CONST bfd_arch_info_type *EXFUN(bfd_arch_get_compatible, (
332b6327
SC
679 CONST bfd *abfd,
680 CONST bfd *bbfd));
6d56c69a
SC
681void EXFUN(bfd_set_arch_info, (bfd *, bfd_arch_info_type *));
682enum bfd_architecture EXFUN(bfd_get_arch, (bfd *abfd));
683unsigned long EXFUN(bfd_get_mach, (bfd *abfd));
684unsigned int EXFUN(bfd_arch_bits_per_byte, (bfd *abfd));
685unsigned int EXFUN(bfd_arch_bits_per_address, (bfd *abfd));
686bfd_arch_info_type * EXFUN(bfd_get_arch_info, (bfd *));
687bfd_arch_info_type *EXFUN(bfd_lookup_arch
332b6327
SC
688 , (enum bfd_architecture
689 arch,
690 long machine));
6d56c69a 691CONST char * EXFUN(bfd_printable_arch_mach
332b6327
SC
692 , (enum bfd_architecture arch, unsigned long machine));
693typedef enum bfd_reloc_status
694{
695 /* No errors detected */
b39096a4 696 bfd_reloc_ok,
332b6327
SC
697
698 /* The relocation was performed, but there was an overflow. */
b39096a4 699 bfd_reloc_overflow,
332b6327
SC
700
701 /* The address to relocate was not within the section supplied*/
b39096a4 702 bfd_reloc_outofrange,
332b6327
SC
703
704 /* Used by special functions */
b39096a4 705 bfd_reloc_continue,
332b6327
SC
706
707 /* Unused */
b39096a4 708 bfd_reloc_notsupported,
332b6327
SC
709
710 /* Unsupported relocation size requested. */
b39096a4 711 bfd_reloc_other,
332b6327
SC
712
713 /* The symbol to relocate against was undefined.*/
b39096a4 714 bfd_reloc_undefined,
332b6327
SC
715
716 /* The relocation was performed, but may not be ok - presently
717 generated only when linking i960 coff files with i960 b.out
718 symbols. */
b39096a4 719 bfd_reloc_dangerous
332b6327 720 }
81f8fee9 721 bfd_reloc_status_type;
332b6327
SC
722
723
b39096a4
SC
724typedef struct reloc_cache_entry
725{
332b6327 726 /* A pointer into the canonical table of pointers */
b39096a4 727 struct symbol_cache_entry **sym_ptr_ptr;
332b6327
SC
728
729 /* offset in section */
b39096a4 730 rawdata_offset address;
332b6327
SC
731
732 /* addend for relocation value */
b39096a4 733 bfd_vma addend;
332b6327 734
332b6327 735 /* Pointer to how to perform the required relocation */
b39096a4 736 CONST struct reloc_howto_struct *howto;
332b6327 737
b39096a4 738} arelent;
f48e5efe 739
b39096a4
SC
740typedef CONST struct reloc_howto_struct
741{
332b6327
SC
742 /* The type field has mainly a documetary use - the back end can
743 to what it wants with it, though the normally the back end's
744 external idea of what a reloc number would be would be stored
745 in this field. For example, the a PC relative word relocation
746 in a coff environment would have the type 023 - because that's
747 what the outside world calls a R_PCRWORD reloc. */
b39096a4 748 unsigned int type;
332b6327
SC
749
750 /* The value the final relocation is shifted right by. This drops
751 unwanted data from the relocation. */
b39096a4 752 unsigned int rightshift;
332b6327
SC
753
754 /* The size of the item to be relocated - 0, is one byte, 1 is 2
755 bytes, 3 is four bytes. */
b39096a4 756 unsigned int size;
332b6327
SC
757
758 /* Now obsolete */
b39096a4 759 unsigned int bitsize;
332b6327
SC
760
761 /* Notes that the relocation is relative to the location in the
762 data section of the addend. The relocation function will
763 subtract from the relocation value the address of the location
764 being relocated. */
b39096a4 765 boolean pc_relative;
332b6327
SC
766
767 /* Now obsolete */
b39096a4 768 unsigned int bitpos;
332b6327
SC
769
770 /* Now obsolete */
b39096a4 771 boolean absolute;
332b6327
SC
772
773 /* Causes the relocation routine to return an error if overflow
774 is detected when relocating. */
b39096a4 775 boolean complain_on_overflow;
332b6327
SC
776
777 /* If this field is non null, then the supplied function is
778 called rather than the normal function. This allows really
779 strange relocation methods to be accomodated (eg, i960 callj
780 instructions). */
f48e5efe
JG
781 bfd_reloc_status_type EXFUN ((*special_function),
782 (bfd *abfd,
783 arelent *reloc_entry,
784 struct symbol_cache_entry *symbol,
785 PTR data,
2d690b0a
SC
786 asection *input_section,
787 bfd *output_bfd ));
332b6327
SC
788
789 /* The textual name of the relocation type. */
b39096a4 790 char *name;
332b6327
SC
791
792 /* When performing a partial link, some formats must modify the
793 relocations rather than the data - this flag signals this.*/
b39096a4 794 boolean partial_inplace;
332b6327
SC
795
796 /* The src_mask is used to select what parts of the read in data
797 are to be used in the relocation sum. Eg, if this was an 8 bit
798 bit of data which we read and relocated, this would be
799 0x000000ff. When we have relocs which have an addend, such as
800 sun4 extended relocs, the value in the offset part of a
801 relocating field is garbage so we never use it. In this case
802 the mask would be 0x00000000. */
b39096a4 803 bfd_word src_mask;
332b6327
SC
804
805 /* The dst_mask is what parts of the instruction are replaced
806 into the instruction. In most cases src_mask == dst_mask,
807 except in the above special case, where dst_mask would be
808 0x000000ff, and src_mask would be 0x00000000. */
b39096a4 809 bfd_word dst_mask;
332b6327
SC
810
811 /* When some formats create PC relative instructions, they leave
812 the value of the pc of the place being relocated in the offset
813 slot of the instruction, so that a PC relative relocation can
814 be made just by adding in an ordinary offset (eg sun3 a.out).
815 Some formats leave the displacement part of an instruction
816 empty (eg m88k bcs), this flag signals the fact.*/
b39096a4 817 boolean pcrel_offset;
332b6327 818
b39096a4 819} reloc_howto_type;
b39096a4
SC
820#define HOWTO(C, R,S,B, P, BI, ABS, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
821 {(unsigned)C,R,S,B, P, BI, ABS,O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC}
46773090 822#define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,false,false,FUNCTION, NAME,false,0,0,IN)
7a276b09 823
332b6327
SC
824#define HOWTO_PREPARE(relocation, symbol) \
825 { \
826 if (symbol != (asymbol *)NULL) { \
9a7c5449 827 if (symbol->section == &bfd_com_section) { \
332b6327
SC
828 relocation = 0; \
829 } \
830 else { \
831 relocation = symbol->value; \
832 } \
833 } \
332b6327 834}
b39096a4 835typedef unsigned char bfd_byte;
bded7de2 836
b39096a4
SC
837typedef struct relent_chain {
838 arelent relent;
839 struct relent_chain *next;
840} arelent_chain;
6d56c69a
SC
841bfd_reloc_status_type
842EXFUN(bfd_perform_relocation
332b6327
SC
843 , (bfd * abfd,
844 arelent *reloc_entry,
845 PTR data,
846 asection *input_section,
847 bfd *output_bfd));
848typedef enum bfd_reloc_code_real
849{
850 /* 16 bits wide, simple reloc */
851 BFD_RELOC_16,
852
853 /* 8 bits wide, but used to form an address like 0xffnn */
de7e640d 854 BFD_RELOC_8_FFnn,
332b6327
SC
855
856 /* 8 bits wide, simple */
de7e640d 857 BFD_RELOC_8,
332b6327
SC
858
859 /* 8 bits wide, pc relative */
358c1d4d 860 BFD_RELOC_8_PCREL,
332b6327
SC
861
862 /* The type of reloc used to build a contructor table - at the
863 moment probably a 32 bit wide abs address, but the cpu can
864 choose. */
865
d5ceae78
KR
866 BFD_RELOC_CTOR,
867
868 /* 32 bits wide, simple reloc */
869 BFD_RELOC_32,
870 /* 32 bits, PC-relative */
871 BFD_RELOC_32_PCREL,
872
873 /* High 22 bits of 32-bit value; simple reloc. */
874 BFD_RELOC_HI22,
875 /* Low 10 bits. */
876 BFD_RELOC_LO10,
877
878 /* Reloc types used for i960/b.out. */
879 BFD_RELOC_24_PCREL,
880 BFD_RELOC_I960_CALLJ,
881
882 BFD_RELOC_16_PCREL,
883 /* 32-bit pc-relative, shifted right 2 bits (i.e., 30-bit
884 word displacement, e.g. for SPARC) */
885 BFD_RELOC_32_PCREL_S2,
886
887 /* now for the sparc/elf codes */
888 BFD_RELOC_NONE, /* actually used */
889 BFD_RELOC_SPARC_WDISP22,
890 BFD_RELOC_SPARC22,
891 BFD_RELOC_SPARC13,
892 BFD_RELOC_SPARC_BASE13,
893 BFD_RELOC_SPARC_GOT10,
894 BFD_RELOC_SPARC_GOT13,
895 BFD_RELOC_SPARC_GOT22,
896 BFD_RELOC_SPARC_PC10,
897 BFD_RELOC_SPARC_PC22,
898 BFD_RELOC_SPARC_WPLT30,
899 BFD_RELOC_SPARC_COPY,
900 BFD_RELOC_SPARC_GLOB_DAT,
901 BFD_RELOC_SPARC_JMP_SLOT,
902 BFD_RELOC_SPARC_RELATIVE,
903 BFD_RELOC_SPARC_UA32,
904
905 /* this one is a.out specific? */
906 BFD_RELOC_SPARC_BASE22,
907
908 /* this must be the highest numeric value */
909 BFD_RELOC_UNUSED
81f8fee9 910 } bfd_reloc_code_real_type;
6d56c69a 911CONST struct reloc_howto_struct *
d5ceae78 912EXFUN(bfd_reloc_type_lookup , (bfd *abfd, bfd_reloc_code_type code));
b39096a4
SC
913typedef struct symbol_cache_entry
914{
332b6327
SC
915 /* A pointer to the BFD which owns the symbol. This information
916 is necessary so that a back end can work out what additional
917 (invisible to the application writer) information is carried
918 with the symbol. */
919
b39096a4 920 struct _bfd *the_bfd;
332b6327
SC
921
922 /* The text of the symbol. The name is left alone, and not copied - the
923 application may not alter it. */
924 CONST char *name;
925
926 /* The value of the symbol.*/
927 symvalue value;
928
929 /* Attributes of a symbol: */
930
b39096a4 931#define BSF_NO_FLAGS 0x00
332b6327
SC
932
933 /* The symbol has local scope; <<static>> in <<C>>. The value
934 is the offset into the section of the data. */
b39096a4 935#define BSF_LOCAL 0x01
332b6327
SC
936
937 /* The symbol has global scope; initialized data in <<C>>. The
938 value is the offset into the section of the data. */
b39096a4 939#define BSF_GLOBAL 0x02
332b6327
SC
940
941 /* Obsolete */
b39096a4 942#define BSF_IMPORT 0x04
332b6327
SC
943
944 /* The symbol has global scope, and is exported. The value is
945 the offset into the section of the data. */
b39096a4 946#define BSF_EXPORT 0x08
332b6327
SC
947
948 /* The symbol is undefined. <<extern>> in <<C>>. The value has
949 no meaning. */
9a7c5449 950#define BSF_UNDEFINED_OBS 0x10
332b6327
SC
951
952 /* The symbol is common, initialized to zero; default in
953 <<C>>. The value is the size of the object in bytes. */
9a7c5449 954#define BSF_FORT_COMM_OBS 0x20
332b6327
SC
955
956 /* A normal C symbol would be one of:
957 <<BSF_LOCAL>>, <<BSF_FORT_COMM>>, <<BSF_UNDEFINED>> or
958 <<BSF_EXPORT|BSD_GLOBAL>> */
959
960 /* The symbol is a debugging record. The value has an arbitary
961 meaning. */
b39096a4 962#define BSF_DEBUGGING 0x40
332b6327 963
332b6327 964 /* Used by the linker */
b39096a4
SC
965#define BSF_KEEP 0x10000
966#define BSF_KEEP_G 0x80000
332b6327
SC
967
968 /* Unused */
b39096a4
SC
969#define BSF_WEAK 0x100000
970#define BSF_CTOR 0x200000
9a7c5449
SC
971
972 /* This symbol was created to point to a section */
973#define BSF_SECTION_SYM 0x400000
332b6327
SC
974
975 /* The symbol used to be a common symbol, but now it is
976 allocated. */
b39096a4 977#define BSF_OLD_COMMON 0x800000
332b6327
SC
978
979 /* The default value for common data. */
b39096a4 980#define BFD_FORT_COMM_DEFAULT_VALUE 0
332b6327
SC
981
982 /* In some files the type of a symbol sometimes alters its
983 location in an output file - ie in coff a <<ISFCN>> symbol
984 which is also <<C_EXT>> symbol appears where it was
985 declared and not at the end of a section. This bit is set
986 by the target BFD part to convey this information. */
987
b39096a4 988#define BSF_NOT_AT_END 0x40000
332b6327
SC
989
990 /* Signal that the symbol is the label of constructor section. */
b39096a4 991#define BSF_CONSTRUCTOR 0x1000000
332b6327
SC
992
993 /* Signal that the symbol is a warning symbol. If the symbol
994 is a warning symbol, then the value field (I know this is
995 tacky) will point to the asymbol which when referenced will
996 cause the warning. */
b39096a4 997#define BSF_WARNING 0x2000000
332b6327
SC
998
999 /* Signal that the symbol is indirect. The value of the symbol
1000 is a pointer to an undefined asymbol which contains the
1001 name to use instead. */
b39096a4 1002#define BSF_INDIRECT 0x4000000
332b6327 1003
b39096a4 1004 flagword flags;
332b6327 1005
9a7c5449
SC
1006 /* A pointer to the section to which this symbol is
1007 relative. This will always be non NULL, there are special
1008 sections for undefined and absolute symbols */
b39096a4 1009 struct sec *section;
332b6327
SC
1010
1011 /* Back end special data. This is being phased out in favour
1012 of making this a union. */
b39096a4 1013 PTR udata;
332b6327 1014
b39096a4 1015} asymbol;
b39096a4
SC
1016#define get_symtab_upper_bound(abfd) \
1017 BFD_SEND (abfd, _get_symtab_upper_bound, (abfd))
b39096a4
SC
1018#define bfd_canonicalize_symtab(abfd, location) \
1019 BFD_SEND (abfd, _bfd_canonicalize_symtab,\
1020 (abfd, location))
6d56c69a
SC
1021boolean EXFUN(bfd_set_symtab , (bfd *, asymbol **, unsigned int ));
1022void EXFUN(bfd_print_symbol_vandf, (PTR file, asymbol *symbol));
b39096a4
SC
1023#define bfd_make_empty_symbol(abfd) \
1024 BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
d5ceae78
KR
1025#define bfd_make_debug_symbol(abfd,ptr,size) \
1026 BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
6d56c69a 1027int EXFUN(bfd_decode_symclass, (asymbol *symbol));
b39096a4
SC
1028struct _bfd
1029{
332b6327
SC
1030 /* The filename the application opened the BFD with. */
1031 CONST char *filename;
1032
1033 /* A pointer to the target jump table. */
1034 struct bfd_target *xvec;
1035
1036 /* To avoid dragging too many header files into every file that
0aa70210 1037 includes `<<bfd.h>>', IOSTREAM has been declared as a "char
332b6327
SC
1038 *", and MTIME as a "long". Their correct types, to which they
1039 are cast when used, are "FILE *" and "time_t". The iostream
1040 is the result of an fopen on the filename. */
1041 char *iostream;
1042
1043 /* Is the file being cached */
1044
1045 boolean cacheable;
1046
1047 /* Marks whether there was a default target specified when the
1048 BFD was opened. This is used to select what matching algorithm
1049 to use to chose the back end. */
1050
1051 boolean target_defaulted;
1052
1053 /* The caching routines use these to maintain a
1054 least-recently-used list of BFDs */
1055
1056 struct _bfd *lru_prev, *lru_next;
1057
1058 /* When a file is closed by the caching routines, BFD retains
1059 state information on the file here:
1060 */
1061
1062 file_ptr where;
1063
1064 /* and here:*/
1065
1066 boolean opened_once;
1067
1068 /* Set if we have a locally maintained mtime value, rather than
1069 getting it from the file each time: */
1070
1071 boolean mtime_set;
1072
1073 /* File modified time, if mtime_set is true: */
1074
1075 long mtime;
1076
1077 /* Reserved for an unimplemented file locking extension.*/
1078
1079 int ifd;
1080
1081 /* The format which belongs to the BFD.*/
1082
1083 bfd_format format;
1084
1085 /* The direction the BFD was opened with*/
1086
1087 enum bfd_direction {no_direction = 0,
1088 read_direction = 1,
1089 write_direction = 2,
1090 both_direction = 3} direction;
1091
1092 /* Format_specific flags*/
1093
1094 flagword flags;
1095
1096 /* Currently my_archive is tested before adding origin to
1097 anything. I believe that this can become always an add of
1098 origin, with origin set to 0 for non archive files. */
1099
1100 file_ptr origin;
1101
1102 /* Remember when output has begun, to stop strange things
1103 happening. */
1104 boolean output_has_begun;
1105
1106 /* Pointer to linked list of sections*/
1107 struct sec *sections;
1108
1109 /* The number of sections */
1110 unsigned int section_count;
1111
1112 /* Stuff only useful for object files:
1113 The start address. */
1114 bfd_vma start_address;
1115
1116 /* Used for input and output*/
1117 unsigned int symcount;
1118
1119 /* Symbol table for output BFD*/
1120 struct symbol_cache_entry **outsymbols;
1121
1122 /* Pointer to structure which contains architecture information*/
1123 struct bfd_arch_info *arch_info;
1124
1125 /* Stuff only useful for archives:*/
1126 PTR arelt_data;
1127 struct _bfd *my_archive;
1128 struct _bfd *next;
1129 struct _bfd *archive_head;
1130 boolean has_armap;
1131
1132 /* Used by the back end to hold private data. */
332b6327 1133
9a7c5449
SC
1134 union
1135 {
1136 struct aout_data_struct *aout_data;
1137 struct artdata *aout_ar_data;
1138 struct _oasys_data *oasys_obj_data;
1139 struct _oasys_ar_data *oasys_ar_data;
1140 struct coff_tdata *coff_obj_data;
1141 struct ieee_data_struct *ieee_data;
1142 struct ieee_ar_data_struct *ieee_ar_data;
1143 struct srec_data_struct *srec_data;
2d690b0a 1144 struct srec_data_struct *tekhex_data;
9a7c5449
SC
1145 struct elf_obj_tdata_struct *elf_obj_data;
1146 struct elf_core_tdata_struct *elf_core_data;
1147 struct bout_data_struct *bout_data;
1148 struct sun_core_struct *sun_core_data;
2b74083c 1149 struct trad_core_struct *trad_core_data;
9a7c5449
SC
1150 PTR any;
1151 } tdata;
1152
332b6327
SC
1153 /* Used by the application to hold private data*/
1154 PTR usrdata;
1155
1156 /* Where all the allocated stuff under this BFD goes */
1157 struct obstack memory;
9a7c5449 1158
d5ceae78 1159 /* Is this really needed in addition to usrdata? */
9a7c5449 1160 asymbol **ld_symbols;
b39096a4 1161};
332b6327
SC
1162
1163unsigned int EXFUN(bfd_get_reloc_upper_bound, (bfd *abfd, asection *sect));
1164unsigned int EXFUN(bfd_canonicalize_reloc
1165 , (bfd *abfd,
1166 asection *sec,
1167 arelent **loc,
1168 asymbol **syms));
1169boolean EXFUN(bfd_set_file_flags, (bfd *abfd, flagword flags));
1170void EXFUN(bfd_set_reloc
1171 , (bfd *abfd, asection *sec, arelent **rel, unsigned int count)
1172
1173 );
6d56c69a
SC
1174boolean EXFUN(bfd_set_start_address, (bfd *, bfd_vma));
1175long EXFUN(bfd_get_mtime, (bfd *));
b39096a4
SC
1176#define bfd_sizeof_headers(abfd, reloc) \
1177 BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc))
1178
332b6327
SC
1179#define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1180 BFD_SEND (abfd, _bfd_find_nearest_line, (abfd, sec, syms, off, file, func, line))
b39096a4 1181
d5ceae78 1182 /* Do these three do anything useful at all, for any back end? */
b39096a4
SC
1183#define bfd_debug_info_start(abfd) \
1184 BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1185
1186#define bfd_debug_info_end(abfd) \
1187 BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1188
1189#define bfd_debug_info_accumulate(abfd, section) \
1190 BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1191
d5ceae78 1192
b39096a4
SC
1193#define bfd_stat_arch_elt(abfd, stat) \
1194 BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
1195
1196#define bfd_coff_swap_aux_in(a,e,t,c,i) \
1197 BFD_SEND (a, _bfd_coff_swap_aux_in, (a,e,t,c,i))
1198
1199#define bfd_coff_swap_sym_in(a,e,i) \
1200 BFD_SEND (a, _bfd_coff_swap_sym_in, (a,e,i))
1201
1202#define bfd_coff_swap_lineno_in(a,e,i) \
1203 BFD_SEND ( a, _bfd_coff_swap_lineno_in, (a,e,i))
1204
1205#define bfd_set_arch_mach(abfd, arch, mach)\
1206 BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
7f3d9f46 1207
0c210c9c
SC
1208#define bfd_coff_swap_reloc_out(abfd, i, o) \
1209 BFD_SEND (abfd, _bfd_coff_swap_reloc_out, (abfd, i, o))
1210
1211#define bfd_coff_swap_lineno_out(abfd, i, o) \
1212 BFD_SEND (abfd, _bfd_coff_swap_lineno_out, (abfd, i, o))
1213
1214#define bfd_coff_swap_aux_out(abfd, i, t,c,o) \
1215 BFD_SEND (abfd, _bfd_coff_swap_aux_out, (abfd, i,t,c, o))
1216
1217#define bfd_coff_swap_sym_out(abfd, i,o) \
1218 BFD_SEND (abfd, _bfd_coff_swap_sym_out, (abfd, i, o))
1219
1220#define bfd_coff_swap_scnhdr_out(abfd, i,o) \
1221 BFD_SEND (abfd, _bfd_coff_swap_scnhdr_out, (abfd, i, o))
1222
1223#define bfd_coff_swap_filehdr_out(abfd, i,o) \
1224 BFD_SEND (abfd, _bfd_coff_swap_filehdr_out, (abfd, i, o))
1225
1226#define bfd_coff_swap_aouthdr_out(abfd, i,o) \
1227 BFD_SEND (abfd, _bfd_coff_swap_aouthdr_out, (abfd, i, o))
1228
2d690b0a
SC
1229#define bfd_get_relocated_section_contents(abfd, seclet, data) \
1230 BFD_SEND (abfd, _bfd_get_relocated_section_contents, (abfd, seclet, data))
1231
daa91756
SC
1232#define bfd_relax_section(abfd, section, symbols) \
1233 BFD_SEND (abfd, _bfd_relax_section, (abfd, section, symbols))
9a7c5449 1234symindex EXFUN(bfd_get_next_mapent, (bfd *, symindex previous, carsym ** sym));
6d56c69a 1235boolean EXFUN(bfd_set_archive_head, (bfd *output, bfd *new_head));
9a7c5449 1236bfd *EXFUN(bfd_get_elt_at_index, (bfd * archive, int index));
6d56c69a
SC
1237bfd* EXFUN(bfd_openr_next_archived_file, (bfd *archive, bfd *previous));
1238CONST char *EXFUN(bfd_core_file_failing_command, (bfd *));
1239int EXFUN(bfd_core_file_failing_signal, (bfd *));
1240boolean EXFUN(core_file_matches_executable_p
332b6327 1241 , (bfd *core_bfd, bfd *exec_bfd));
7a276b09
SC
1242#define SDEF(ret, name, arglist) \
1243 PROTO(ret,(*name),arglist)
1244#define SDEF_FMT(ret, name, arglist) \
1245 PROTO(ret,(*name[bfd_type_end]),arglist)
7a276b09
SC
1246#define BFD_SEND(bfd, message, arglist) \
1247 ((*((bfd)->xvec->message)) arglist)
7a276b09
SC
1248#define BFD_SEND_FMT(bfd, message, arglist) \
1249 (((bfd)->xvec->message[(int)((bfd)->format)]) arglist)
7a276b09
SC
1250typedef struct bfd_target
1251{
7a276b09 1252 char *name;
81f8fee9
JG
1253 enum target_flavour {
1254 bfd_target_unknown_flavour,
1255 bfd_target_aout_flavour,
1256 bfd_target_coff_flavour,
1257 bfd_target_elf_flavour,
1258 bfd_target_ieee_flavour,
1259 bfd_target_oasys_flavour,
c3089ec9 1260 bfd_target_tekhex_flavour,
81f8fee9 1261 bfd_target_srec_flavour} flavour;
7a276b09 1262 boolean byteorder_big_p;
7a276b09 1263 boolean header_byteorder_big_p;
7a276b09 1264 flagword object_flags;
7a276b09 1265 flagword section_flags;
7a276b09 1266 char ar_pad_char;
7a276b09 1267 unsigned short ar_max_namelen;
7a276b09 1268 unsigned int align_power_min;
fcc654cb
SC
1269 SDEF (bfd_vma, bfd_getx64, (bfd_byte *));
1270 SDEF (void, bfd_putx64, (bfd_vma, bfd_byte *));
1271 SDEF (bfd_vma, bfd_getx32, (bfd_byte *));
1272 SDEF (void, bfd_putx32, (bfd_vma, bfd_byte *));
1273 SDEF (bfd_vma, bfd_getx16, (bfd_byte *));
1274 SDEF (void, bfd_putx16, (bfd_vma, bfd_byte *));
fcc654cb
SC
1275 SDEF (bfd_vma, bfd_h_getx64, (bfd_byte *));
1276 SDEF (void, bfd_h_putx64, (bfd_vma, bfd_byte *));
1277 SDEF (bfd_vma, bfd_h_getx32, (bfd_byte *));
1278 SDEF (void, bfd_h_putx32, (bfd_vma, bfd_byte *));
1279 SDEF (bfd_vma, bfd_h_getx16, (bfd_byte *));
1280 SDEF (void, bfd_h_putx16, (bfd_vma, bfd_byte *));
7a276b09 1281 SDEF_FMT (struct bfd_target *, _bfd_check_format, (bfd *));
7a276b09 1282 SDEF_FMT (boolean, _bfd_set_format, (bfd *));
7a276b09 1283 SDEF_FMT (boolean, _bfd_write_contents, (bfd *));
7a276b09
SC
1284 SDEF (char *, _core_file_failing_command, (bfd *));
1285 SDEF (int, _core_file_failing_signal, (bfd *));
1286 SDEF (boolean, _core_file_matches_executable_p, (bfd *, bfd *));
7a276b09
SC
1287 SDEF (boolean, _bfd_slurp_armap, (bfd *));
1288 SDEF (boolean, _bfd_slurp_extended_name_table, (bfd *));
1289 SDEF (void, _bfd_truncate_arname, (bfd *, CONST char *, char *));
1290 SDEF (boolean, write_armap, (bfd *arch,
1291 unsigned int elength,
1292 struct orl *map,
a0788ae3 1293 unsigned int orl_count,
7a276b09 1294 int stridx));
7a276b09
SC
1295 SDEF (boolean, _close_and_cleanup, (bfd *));
1296 SDEF (boolean, _bfd_set_section_contents, (bfd *, sec_ptr, PTR,
1297 file_ptr, bfd_size_type));
1298 SDEF (boolean, _bfd_get_section_contents, (bfd *, sec_ptr, PTR,
1299 file_ptr, bfd_size_type));
1300 SDEF (boolean, _new_section_hook, (bfd *, sec_ptr));
6d56c69a 1301 SDEF (unsigned int, _get_symtab_upper_bound, (bfd *));
7a276b09
SC
1302 SDEF (unsigned int, _bfd_canonicalize_symtab,
1303 (bfd *, struct symbol_cache_entry **));
1304 SDEF (unsigned int, _get_reloc_upper_bound, (bfd *, sec_ptr));
1305 SDEF (unsigned int, _bfd_canonicalize_reloc, (bfd *, sec_ptr, arelent **,
1306 struct symbol_cache_entry**));
1307 SDEF (struct symbol_cache_entry *, _bfd_make_empty_symbol, (bfd *));
1308 SDEF (void, _bfd_print_symbol, (bfd *, PTR, struct symbol_cache_entry *,
81f8fee9 1309 bfd_print_symbol_type));
7a276b09
SC
1310#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e))
1311 SDEF (alent *, _get_lineno, (bfd *, struct symbol_cache_entry *));
1312
1313 SDEF (boolean, _bfd_set_arch_mach, (bfd *, enum bfd_architecture,
1314 unsigned long));
1315
1316 SDEF (bfd *, openr_next_archived_file, (bfd *arch, bfd *prev));
1317 SDEF (boolean, _bfd_find_nearest_line,
1318 (bfd *abfd, struct sec *section,
1319 struct symbol_cache_entry **symbols,bfd_vma offset,
1320 CONST char **file, CONST char **func, unsigned int *line));
1321 SDEF (int, _bfd_stat_arch_elt, (bfd *, struct stat *));
1322
1323 SDEF (int, _bfd_sizeof_headers, (bfd *, boolean));
1324
1325 SDEF (void, _bfd_debug_info_start, (bfd *));
1326 SDEF (void, _bfd_debug_info_end, (bfd *));
1327 SDEF (void, _bfd_debug_info_accumulate, (bfd *, struct sec *));
2d690b0a 1328 SDEF (bfd_byte *, _bfd_get_relocated_section_contents, (bfd*,struct bfd_seclet_struct *, bfd_byte *data));
31bc9fde 1329 SDEF (boolean,_bfd_relax_section,(bfd *, struct sec *, struct symbol_cache_entry **));
7a276b09
SC
1330 SDEF(void, _bfd_coff_swap_aux_in,(
1331 bfd *abfd ,
1332 PTR ext,
1333 int type,
1334 int class ,
1335 PTR in));
1336
1337 SDEF(void, _bfd_coff_swap_sym_in,(
1338 bfd *abfd ,
1339 PTR ext,
1340 PTR in));
1341
1342 SDEF(void, _bfd_coff_swap_lineno_in, (
1343 bfd *abfd,
1344 PTR ext,
1345 PTR in));
1346
0c210c9c
SC
1347 SDEF(unsigned int, _bfd_coff_swap_aux_out,(
1348 bfd *abfd,
1349 PTR in,
1350 int type,
1351 int class,
1352 PTR ext));
1353
1354 SDEF(unsigned int, _bfd_coff_swap_sym_out,(
1355 bfd *abfd,
1356 PTR in,
1357 PTR ext));
1358
1359 SDEF(unsigned int, _bfd_coff_swap_lineno_out,(
1360 bfd *abfd,
1361 PTR in,
1362 PTR ext));
1363
1364 SDEF(unsigned int, _bfd_coff_swap_reloc_out,(
1365 bfd *abfd,
1366 PTR src,
1367 PTR dst));
1368
1369 SDEF(unsigned int, _bfd_coff_swap_filehdr_out,(
1370 bfd *abfd,
1371 PTR in,
1372 PTR out));
1373
1374 SDEF(unsigned int, _bfd_coff_swap_aouthdr_out,(
1375 bfd *abfd,
1376 PTR in,
1377 PTR out));
1378
1379 SDEF(unsigned int, _bfd_coff_swap_scnhdr_out,(
1380 bfd *abfd,
1381 PTR in,
1382 PTR out));
1383
d5ceae78
KR
1384 /* See documentation on reloc types. */
1385 SDEF (CONST struct reloc_howto_struct *,
1386 reloc_type_lookup,
1387 (bfd *abfd, bfd_reloc_code_type code));
1388
1389 /* Complete and utter crock, currently used for the assembler
1390 when creating COFF files. */
1391 SDEF (asymbol *, _bfd_make_debug_symbol, (
1392 bfd *abfd,
1393 void *ptr,
1394 unsigned long size));
7a276b09 1395} bfd_target;
6d56c69a 1396bfd_target *EXFUN(bfd_find_target, (CONST char *, bfd *));
f48e5efe 1397CONST char **EXFUN(bfd_target_list, (void));
6d56c69a
SC
1398boolean EXFUN(bfd_check_format, (bfd *abfd, bfd_format format));
1399boolean EXFUN(bfd_set_format, (bfd *, bfd_format));
1400CONST char *EXFUN(bfd_format_string, (bfd_format));
1484208f 1401#endif
This page took 0.114843 seconds and 4 git commands to generate.