1 /* A -*- C -*- header file for the bfd library
2 Copyright 1990, 1991 Free Software Foundation, Inc.
3 Contributed by Cygnus Support.
5 This file is part of BFD, the Binary File Descriptor library.
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.
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.
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., 675 Mass Ave, Cambridge, MA 02139, USA. */
21 /* bfd.h -- The only header file required by users of the bfd library
23 This file is generated from various .c files, if you change it, your
26 All the prototypes and definitions following the comment "THE FOLLOWING
27 IS EXTRACTED FROM THE SOURCE" are extracted from the source files for
28 BFD. If you change it, someone oneday will extract it from the source
29 again, and your changes will be lost. To save yourself from this bind,
30 change the definitions in the source in the bfd directory. Type "make
31 docs" and then "make headers" in that directory, and magically this file
32 will change to reflect your changes.
34 If you don't have the tools to perform the extraction, then you are
35 safe from someone on your system trampling over your header files.
36 You should still maintain the equivalence between the source and this
37 file though; every change you make to the .c file should be reflected
40 #ifndef __BFD_H_SEEN__
41 #define __BFD_H_SEEN__
46 /* Make it easier to declare prototypes (puts conditional here) */
49 # define PROTO(type, name, arglist) type name arglist
51 # define PROTO(type, name, arglist) type name ()
55 #define BFD_VERSION "0.18"
57 /* forward declaration */
58 typedef struct _bfd bfd
;
60 /* General rules: functions which are boolean return true on success
61 and false on failure (unless they're a predicate). -- bfd.doc */
62 /* I'm sure this is going to break something and someone is going to
63 force me to change it. */
64 /* typedef enum boolean {false, true} boolean; */
65 /* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h> -fnf */
66 typedef enum bfd_boolean
{false, true} boolean
;
68 /* Try to avoid breaking stuff */
69 typedef long int file_ptr
;
71 /* Support for different sizes of target format ints and addresses */
74 typedef HOST_64_BIT rawdata_offset
;
75 typedef HOST_64_BIT bfd_vma
;
76 typedef HOST_64_BIT bfd_word
;
77 typedef HOST_64_BIT bfd_offset
;
78 typedef HOST_64_BIT bfd_size_type
;
79 typedef HOST_64_BIT symvalue
;
80 typedef HOST_64_BIT bfd_64_type
;
81 #define fprintf_vma(s,x) \
82 fprintf(s,"%08x%08x", uint64_typeHIGH(x), uint64_typeLOW(x))
84 typedef struct {int a
,b
;} bfd_64_type
;
85 typedef unsigned long rawdata_offset
;
86 typedef unsigned long bfd_vma
;
87 typedef unsigned long bfd_offset
;
88 typedef unsigned long bfd_word
;
89 typedef unsigned long bfd_size
;
90 typedef unsigned long symvalue
;
91 typedef unsigned long bfd_size_type
;
92 #define fprintf_vma(s,x) fprintf(s, "%08lx", x)
94 #define printf_vma(x) fprintf_vma(stdout,x)
96 typedef unsigned int flagword
; /* 32 bits of flags */
100 typedef 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! */
108 /* Object file flag values */
110 #define HAS_RELOC 001
112 #define HAS_LINENO 004
113 #define HAS_DEBUG 010
115 #define HAS_LOCALS 040
121 /* symbols and relocation */
123 typedef unsigned long symindex
;
125 #define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
127 typedef enum bfd_symclass
{
128 bfd_symclass_unknown
= 0,
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 */
136 typedef int symtype
; /* Who knows, yet? */
139 /* general purpose part of a symbol;
140 target specific parts will be found in libcoff.h, liba.out.h etc */
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)
150 /* This is a type pun with struct ranlib on purpose! */
151 typedef struct carsym
{
153 file_ptr file_offset
; /* look here to find the file */
154 } carsym
; /* to make these you call a carsymogen */
157 /* Used in generating armaps. Perhaps just a forward definition would do? */
158 struct orl
{ /* output ranlib */
159 char **name
; /* symbol name */
160 file_ptr pos
; /* bfd* or file position */
161 int namidx
; /* index into string table */
166 /* Linenumber stuff */
167 typedef struct lineno_cache_entry
{
168 unsigned int line_number
; /* Linenumber from start of function*/
170 struct symbol_cache_entry
*sym
; /* Function name */
171 unsigned long offset
; /* Offset into section */
175 /* object and core file sections */
178 #define align_power(addr, align) \
179 ( ((addr) + ((1<<(align))-1)) & (-1 << (align)))
181 typedef struct sec
*sec_ptr
;
183 #define bfd_section_name(bfd, ptr) ((ptr)->name)
184 #define bfd_section_size(bfd, ptr) ((ptr)->size)
185 #define bfd_section_vma(bfd, ptr) ((ptr)->vma)
186 #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
187 #define bfd_get_section_flags(bfd, ptr) ((ptr)->flags)
188 #define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
190 #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (val)), true)
191 #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true)
192 #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true)
194 typedef struct stat stat_type
;
196 /** Error handling */
198 typedef enum bfd_error
{
199 no_error
= 0, system_call_error
, invalid_target
,
200 wrong_format
, invalid_operation
, no_memory
,
201 no_symbols
, no_relocation_info
,
202 no_more_archived_files
, malformed_archive
,
203 symbol_not_found
, file_not_recognized
,
204 file_ambiguously_recognized
, no_contents
,
205 bfd_error_nonrepresentable_section
,
207 invalid_error_code
} bfd_ec
;
209 extern bfd_ec bfd_error
;
211 typedef struct bfd_error_vector
{
212 PROTO(void,(* nonrepresentable_section
),(CONST bfd
*CONST abfd
,
213 CONST
char *CONST name
));
214 } bfd_error_vector_type
;
216 PROTO (char *, bfd_errmsg
, ());
217 PROTO (void, bfd_perror
, (CONST
char *message
));
220 typedef enum bfd_print_symbol
222 bfd_print_symbol_name
,
223 bfd_print_symbol_more
,
224 bfd_print_symbol_all
,
225 bfd_print_symbol_nm
/* Pretty format suitable for nm program. */
226 } bfd_print_symbol_type
;
230 /* The code that implements targets can initialize a jump table with this
231 macro. It must name all its routines the same way (a prefix plus
232 the standard routine suffix), or it must #define the routines that
233 are not so named, before calling JUMP_TABLE in the initializer. */
235 /* Semi-portable string concatenation in cpp */
238 #define CAT(a,b) a##b
240 #define CAT(a,b) a/**/b
244 #define JUMP_TABLE(NAME)\
245 CAT(NAME,_core_file_failing_command),\
246 CAT(NAME,_core_file_failing_signal),\
247 CAT(NAME,_core_file_matches_executable_p),\
248 CAT(NAME,_slurp_armap),\
249 CAT(NAME,_slurp_extended_name_table),\
250 CAT(NAME,_truncate_arname),\
251 CAT(NAME,_write_armap),\
252 CAT(NAME,_close_and_cleanup), \
253 CAT(NAME,_set_section_contents),\
254 CAT(NAME,_get_section_contents),\
255 CAT(NAME,_new_section_hook),\
256 CAT(NAME,_get_symtab_upper_bound),\
257 CAT(NAME,_get_symtab),\
258 CAT(NAME,_get_reloc_upper_bound),\
259 CAT(NAME,_canonicalize_reloc),\
260 CAT(NAME,_make_empty_symbol),\
261 CAT(NAME,_print_symbol),\
262 CAT(NAME,_get_lineno),\
263 CAT(NAME,_set_arch_mach),\
264 CAT(NAME,_openr_next_archived_file),\
265 CAT(NAME,_find_nearest_line),\
266 CAT(NAME,_generic_stat_arch_elt),\
267 CAT(NAME,_sizeof_headers),\
268 CAT(NAME,_bfd_debug_info_start),\
269 CAT(NAME,_bfd_debug_info_end),\
270 CAT(NAME,_bfd_debug_info_accumulate)
272 #define COFF_SWAP_TABLE \
273 coff_swap_aux_in, coff_swap_sym_in, coff_swap_lineno_in, \
274 coff_swap_aux_out, coff_swap_sym_out, \
275 coff_swap_lineno_out, coff_swap_reloc_out, \
276 coff_swap_filehdr_out, coff_swap_aouthdr_out, \
281 /* User program access to BFD facilities */
283 extern CONST
short _bfd_host_big_endian
;
284 #define HOST_BYTE_ORDER_BIG_P (*(char *)&_bfd_host_big_endian)
288 /* Cast from const char * to char * so that caller can assign to
289 a char * without a warning. */
290 #define bfd_get_filename(abfd) ((char *) (abfd)->filename)
291 #define bfd_get_format(abfd) ((abfd)->format)
292 #define bfd_get_target(abfd) ((abfd)->xvec->name)
293 #define bfd_get_file_flags(abfd) ((abfd)->flags)
294 #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
295 #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
296 #define bfd_my_archive(abfd) ((abfd)->my_archive)
297 #define bfd_has_map(abfd) ((abfd)->has_armap)
298 #define bfd_header_twiddle_required(abfd) \
299 ((((abfd)->xvec->header_byteorder_big_p) \
300 != (boolean)HOST_BYTE_ORDER_BIG_P) ? true:false)
302 #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
303 #define bfd_usrdata(abfd) ((abfd)->usrdata)
305 #define bfd_get_start_address(abfd) ((abfd)->start_address)
306 #define bfd_get_symcount(abfd) ((abfd)->symcount)
307 #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
308 #define bfd_count_sections(abfd) ((abfd)->section_count)
309 #define bfd_get_architecture(abfd) ((abfd)->obj_arch)
310 #define bfd_get_machine(abfd) ((abfd)->obj_machine)
320 /* ANd more from the source */
328 void EXFUN(bfd_init
, (void));
329 bfd
*EXFUN(bfd_openr
, (CONST
char *filename
, CONST
char*target
));
330 bfd
*EXFUN(bfd_fdopenr
, (CONST
char *filename
, CONST
char *target
, int fd
));
331 bfd
*EXFUN(bfd_openw
, (CONST
char *filename
, CONST
char *target
));
332 boolean
EXFUN(bfd_close
, (bfd
*));
333 boolean
EXFUN(bfd_close_all_done
, (bfd
*));
334 bfd_size_type
EXFUN(bfd_alloc_size
, (bfd
*abfd
));
335 bfd
*EXFUN(bfd_create
, (CONST
char *filename
, bfd
*template));
336 #define bfd_put_8(abfd, val, ptr) \
337 (*((char *)ptr) = (char)val)
338 #define bfd_get_8(abfd, ptr) \
340 #define bfd_put_16(abfd, val, ptr) \
341 BFD_SEND(abfd, bfd_putx16, (val,ptr))
342 #define bfd_get_16(abfd, ptr) \
343 BFD_SEND(abfd, bfd_getx16, (ptr))
344 #define bfd_put_32(abfd, val, ptr) \
345 BFD_SEND(abfd, bfd_putx32, (val,ptr))
346 #define bfd_get_32(abfd, ptr) \
347 BFD_SEND(abfd, bfd_getx32, (ptr))
348 #define bfd_put_64(abfd, val, ptr) \
349 BFD_SEND(abfd, bfd_putx64, (val, ptr))
350 #define bfd_get_64(abfd, ptr) \
351 BFD_SEND(abfd, bfd_getx64, (ptr))
352 #define bfd_h_put_8(abfd, val, ptr) \
353 (*((char *)ptr) = (char)val)
354 #define bfd_h_get_8(abfd, ptr) \
356 #define bfd_h_put_16(abfd, val, ptr) \
357 BFD_SEND(abfd, bfd_h_putx16,(val,ptr))
358 #define bfd_h_get_16(abfd, ptr) \
359 BFD_SEND(abfd, bfd_h_getx16,(ptr))
360 #define bfd_h_put_32(abfd, val, ptr) \
361 BFD_SEND(abfd, bfd_h_putx32,(val,ptr))
362 #define bfd_h_get_32(abfd, ptr) \
363 BFD_SEND(abfd, bfd_h_getx32,(ptr))
364 #define bfd_h_put_64(abfd, val, ptr) \
365 BFD_SEND(abfd, bfd_h_putx64,(val, ptr))
366 #define bfd_h_get_64(abfd, ptr) \
367 BFD_SEND(abfd, bfd_h_getx64,(ptr))
370 /* The name of the section, the name isn't a copy, the pointer is
371 the same as that passed to bfd_make_section. */
375 /* The next section in the list belonging to the BFD, or NULL. */
379 /* The field flags contains attributes of the section. Some of
380 flags are read in from the object file, and some are
381 synthesized from other information. */
385 #define SEC_NO_FLAGS 0x000
387 /* Tells the OS to allocate space for this section when loaded.
388 This would clear for a section containing debug information
392 #define SEC_ALLOC 0x001
393 /* Tells the OS to load the section from the file when loading.
394 This would be clear for a .bss section */
396 #define SEC_LOAD 0x002
397 /* The section contains data still to be relocated, so there will
398 be some relocation information too. */
400 #define SEC_RELOC 0x004
404 #define SEC_BALIGN 0x008
406 /* A signal to the OS that the section contains read only
408 #define SEC_READONLY 0x010
410 /* The section contains code only. */
412 #define SEC_CODE 0x020
414 /* The section contains data only. */
416 #define SEC_DATA 0x040
418 /* The section will reside in ROM. */
420 #define SEC_ROM 0x080
422 /* The section contains constructor information. This section
423 type is used by the linker to create lists of constructors and
424 destructors used by <<g++>>. When a back end sees a symbol
425 which should be used in a constructor list, it creates a new
426 section for the type of name (eg <<__CTOR_LIST__>>), attaches
427 the symbol to it and builds a relocation. To build the lists
428 of constructors, all the linker has to to is catenate all the
429 sections called <<__CTOR_LIST__>> and relocte the data
430 contained within - exactly the operations it would peform on
433 #define SEC_CONSTRUCTOR 0x100
435 /* The section is a constuctor, and should be placed at the
439 #define SEC_CONSTRUCTOR_TEXT 0x1100
441 #define SEC_CONSTRUCTOR_DATA 0x2100
443 #define SEC_CONSTRUCTOR_BSS 0x3100
446 /* The section has contents - a bss section could be
447 <<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>, a debug section could be
448 <<SEC_HAS_CONTENTS>> */
450 #define SEC_HAS_CONTENTS 0x200
452 /* An instruction to the linker not to output sections
453 containing this flag even if they have information which
454 would normally be written. */
456 #define SEC_NEVER_LOAD 0x400
458 /* The base address of the section in the address space of the
463 /* The size of the section in bytes of the loaded section. This
464 contains a value even if the section has no contents (eg, the
465 size of <<.bss>>). */
469 /* If this section is going to be output, then this value is the
470 offset into the output section of the first byte in the input
471 section. Eg, if this was going to start at the 100th byte in
472 the output section, this value would be 100. */
474 bfd_vma output_offset
;
476 /* The output section through which to map on output. */
478 struct sec
*output_section
;
480 /* The alignment requirement of the section, as an exponent - eg
481 3 aligns to 2^3 (or 8) */
483 unsigned int alignment_power
;
485 /* If an input section, a pointer to a vector of relocation
486 records for the data in this section. */
488 struct reloc_cache_entry
*relocation
;
490 /* If an output section, a pointer to a vector of pointers to
491 relocation records for the data in this section. */
493 struct reloc_cache_entry
**orelocation
;
495 /* The number of relocation records in one of the above */
497 unsigned reloc_count
;
499 /* Which section is it 0.nth */
503 /* Information below is back end specific - and not always used
506 File position of section data */
510 /* File position of relocation info */
512 file_ptr rel_filepos
;
514 /* File position of line data */
516 file_ptr line_filepos
;
518 /* Pointer to data for applications */
522 struct lang_output_section
*otheruserdata
;
524 /* Attached line number information */
528 /* Number of line number records */
530 unsigned int lineno_count
;
532 /* When a section is being output, this value changes as more
533 linenumbers are written out */
535 file_ptr moving_line_filepos
;
537 /* what the section number is in the target world */
539 unsigned int target_index
;
543 /* If this is a constructor section then here is a list of the
544 relocations created to relocate items within it. */
546 struct relent_chain
*constructor_chain
;
548 /* The BFD which owns the section. */
553 asection
*EXFUN(bfd_get_section_by_name
, (bfd
*abfd
, CONST
char *name
));
554 asection
*EXFUN(bfd_make_section_old_way
, (bfd
*, CONST
char *name
));
555 asection
* EXFUN(bfd_make_section
, (bfd
*, CONST
char *name
));
556 boolean
EXFUN(bfd_set_section_flags
, (bfd
*, asection
*, flagword
));
557 void EXFUN(bfd_map_over_sections
, (bfd
*abfd
, void (*func
)(), PTR obj
));
558 boolean
EXFUN(bfd_set_section_size
, (bfd
*, asection
*, bfd_size_type val
));
559 boolean
EXFUN(bfd_set_section_contents
564 bfd_size_type count
));
565 boolean
EXFUN(bfd_get_section_contents
566 , (bfd
*abfd
, asection
*section
, PTR location
,
567 file_ptr offset
, bfd_size_type count
));
568 enum bfd_architecture
570 bfd_arch_unknown
, /* File arch not known */
571 bfd_arch_obscure
, /* Arch known, not one of these */
572 bfd_arch_m68k
, /* Motorola 68xxx */
573 bfd_arch_vax
, /* DEC Vax */
574 bfd_arch_i960
, /* Intel 960 */
575 /* The order of the following is important.
576 lower number indicates a machine type that
577 only accepts a subset of the instructions
578 available to machines with higher numbers.
579 The exception is the "ca", which is
580 incompatible with all other machines except
583 #define bfd_mach_i960_core 1
584 #define bfd_mach_i960_ka_sa 2
585 #define bfd_mach_i960_kb_sb 3
586 #define bfd_mach_i960_mc 4
587 #define bfd_mach_i960_xa 5
588 #define bfd_mach_i960_ca 6
590 bfd_arch_a29k
, /* AMD 29000 */
591 bfd_arch_sparc
, /* SPARC */
592 bfd_arch_mips
, /* MIPS Rxxxx */
593 bfd_arch_i386
, /* Intel 386 */
594 bfd_arch_ns32k
, /* National Semiconductor 32xxx */
595 bfd_arch_tahoe
, /* CCI/Harris Tahoe */
596 bfd_arch_i860
, /* Intel 860 */
597 bfd_arch_romp
, /* IBM ROMP PC/RT */
598 bfd_arch_alliant
, /* Alliant */
599 bfd_arch_convex
, /* Convex */
600 bfd_arch_m88k
, /* Motorola 88xxx */
601 bfd_arch_pyramid
, /* Pyramid Technology */
602 bfd_arch_h8300
, /* Hitachi H8/300 */
603 bfd_arch_rs6000
, /* IBM RS/6000 */
606 typedef int bfd_reloc_code_type
;
608 typedef struct bfd_arch_info
611 int bits_per_address
;
613 enum bfd_architecture arch
;
616 CONST
char *printable_name
;
617 /* true if this is the default machine for the architecture */
618 unsigned int section_align_power
;
620 CONST
struct bfd_arch_info
* EXFUN((*compatible
),
621 (CONST
struct bfd_arch_info
*a
,
622 CONST
struct bfd_arch_info
*b
));
624 boolean
EXFUN((*scan
),(CONST
struct bfd_arch_info
*,CONST
char *));
625 unsigned int EXFUN((*disassemble
),(bfd_vma addr
, CONST
char *data
,
627 CONST
struct reloc_howto_struct
*EXFUN((*reloc_type_lookup
),
628 (CONST
struct bfd_arch_info
*,
629 bfd_reloc_code_type code
));
631 struct bfd_arch_info
*next
;
633 } bfd_arch_info_type
;
634 CONST
char *EXFUN(bfd_printable_name
, (bfd
*abfd
));
635 bfd_arch_info_type
*EXFUN(bfd_scan_arch
, (CONST
char *));
636 CONST bfd_arch_info_type
*EXFUN(bfd_arch_get_compatible
, (
639 void EXFUN(bfd_set_arch_info
, (bfd
*, bfd_arch_info_type
*));
640 enum bfd_architecture
EXFUN(bfd_get_arch
, (bfd
*abfd
));
641 unsigned long EXFUN(bfd_get_mach
, (bfd
*abfd
));
642 unsigned int EXFUN(bfd_arch_bits_per_byte
, (bfd
*abfd
));
643 unsigned int EXFUN(bfd_arch_bits_per_address
, (bfd
*abfd
));
644 bfd_arch_info_type
* EXFUN(bfd_get_arch_info
, (bfd
*));
645 bfd_arch_info_type
*EXFUN(bfd_lookup_arch
646 , (enum bfd_architecture
649 CONST
char * EXFUN(bfd_printable_arch_mach
650 , (enum bfd_architecture arch
, unsigned long machine
));
651 typedef enum bfd_reloc_status
653 /* No errors detected */
656 /* The relocation was performed, but there was an overflow. */
659 /* The address to relocate was not within the section supplied*/
660 bfd_reloc_outofrange
,
662 /* Used by special functions */
666 bfd_reloc_notsupported
,
668 /* Unsupported relocation size requested. */
671 /* The symbol to relocate against was undefined.*/
674 /* The relocation was performed, but may not be ok - presently
675 generated only when linking i960 coff files with i960 b.out
679 bfd_reloc_status_type
;
682 typedef struct reloc_cache_entry
684 /* A pointer into the canonical table of pointers */
685 struct symbol_cache_entry
**sym_ptr_ptr
;
687 /* offset in section */
688 rawdata_offset address
;
690 /* addend for relocation value */
693 /* if sym is null this is the section */
696 /* Pointer to how to perform the required relocation */
697 CONST
struct reloc_howto_struct
*howto
;
700 typedef CONST
struct reloc_howto_struct
702 /* The type field has mainly a documetary use - the back end can
703 to what it wants with it, though the normally the back end's
704 external idea of what a reloc number would be would be stored
705 in this field. For example, the a PC relative word relocation
706 in a coff environment would have the type 023 - because that's
707 what the outside world calls a R_PCRWORD reloc. */
710 /* The value the final relocation is shifted right by. This drops
711 unwanted data from the relocation. */
712 unsigned int rightshift
;
714 /* The size of the item to be relocated - 0, is one byte, 1 is 2
715 bytes, 3 is four bytes. */
719 unsigned int bitsize
;
721 /* Notes that the relocation is relative to the location in the
722 data section of the addend. The relocation function will
723 subtract from the relocation value the address of the location
733 /* Causes the relocation routine to return an error if overflow
734 is detected when relocating. */
735 boolean complain_on_overflow
;
737 /* If this field is non null, then the supplied function is
738 called rather than the normal function. This allows really
739 strange relocation methods to be accomodated (eg, i960 callj
741 bfd_reloc_status_type (*special_function
)();
743 /* The textual name of the relocation type. */
746 /* When performing a partial link, some formats must modify the
747 relocations rather than the data - this flag signals this.*/
748 boolean partial_inplace
;
750 /* The src_mask is used to select what parts of the read in data
751 are to be used in the relocation sum. Eg, if this was an 8 bit
752 bit of data which we read and relocated, this would be
753 0x000000ff. When we have relocs which have an addend, such as
754 sun4 extended relocs, the value in the offset part of a
755 relocating field is garbage so we never use it. In this case
756 the mask would be 0x00000000. */
759 /* The dst_mask is what parts of the instruction are replaced
760 into the instruction. In most cases src_mask == dst_mask,
761 except in the above special case, where dst_mask would be
762 0x000000ff, and src_mask would be 0x00000000. */
765 /* When some formats create PC relative instructions, they leave
766 the value of the pc of the place being relocated in the offset
767 slot of the instruction, so that a PC relative relocation can
768 be made just by adding in an ordinary offset (eg sun3 a.out).
769 Some formats leave the displacement part of an instruction
770 empty (eg m88k bcs), this flag signals the fact.*/
771 boolean pcrel_offset
;
774 #define HOWTO(C, R,S,B, P, BI, ABS, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
775 {(unsigned)C,R,S,B, P, BI, ABS,O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC}
776 #define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,false,false,FUNCTION, NAME,false,0,0,IN)
778 #define HOWTO_PREPARE(relocation, symbol) \
780 if (symbol != (asymbol *)NULL) { \
781 if (symbol->flags & BSF_FORT_COMM) { \
785 relocation = symbol->value; \
788 if (symbol->section != (asection *)NULL) { \
789 relocation += symbol->section->output_section->vma + \
790 symbol->section->output_offset; \
793 typedef unsigned char bfd_byte
;
795 typedef struct relent_chain
{
797 struct relent_chain
*next
;
799 bfd_reloc_status_type
800 EXFUN(bfd_perform_relocation
802 arelent
*reloc_entry
,
804 asection
*input_section
,
806 typedef enum bfd_reloc_code_real
808 /* 16 bits wide, simple reloc */
811 /* 8 bits wide, but used to form an address like 0xffnn */
814 /* 8 bits wide, simple */
817 /* 8 bits wide, pc relative */
820 /* The type of reloc used to build a contructor table - at the
821 moment probably a 32 bit wide abs address, but the cpu can
825 } bfd_reloc_code_real_type
;
826 CONST
struct reloc_howto_struct
*
827 EXFUN(bfd_reloc_type_lookup
828 , (CONST bfd_arch_info_type
*arch
, bfd_reloc_code_type code
));
829 typedef struct symbol_cache_entry
831 /* A pointer to the BFD which owns the symbol. This information
832 is necessary so that a back end can work out what additional
833 (invisible to the application writer) information is carried
836 struct _bfd
*the_bfd
;
838 /* The text of the symbol. The name is left alone, and not copied - the
839 application may not alter it. */
842 /* The value of the symbol.*/
845 /* Attributes of a symbol: */
847 #define BSF_NO_FLAGS 0x00
849 /* The symbol has local scope; <<static>> in <<C>>. The value
850 is the offset into the section of the data. */
851 #define BSF_LOCAL 0x01
853 /* The symbol has global scope; initialized data in <<C>>. The
854 value is the offset into the section of the data. */
855 #define BSF_GLOBAL 0x02
858 #define BSF_IMPORT 0x04
860 /* The symbol has global scope, and is exported. The value is
861 the offset into the section of the data. */
862 #define BSF_EXPORT 0x08
864 /* The symbol is undefined. <<extern>> in <<C>>. The value has
866 #define BSF_UNDEFINED 0x10
868 /* The symbol is common, initialized to zero; default in
869 <<C>>. The value is the size of the object in bytes. */
870 #define BSF_FORT_COMM 0x20
872 /* A normal C symbol would be one of:
873 <<BSF_LOCAL>>, <<BSF_FORT_COMM>>, <<BSF_UNDEFINED>> or
874 <<BSF_EXPORT|BSD_GLOBAL>> */
876 /* The symbol is a debugging record. The value has an arbitary
878 #define BSF_DEBUGGING 0x40
880 /* The symbol has no section attached, any value is the actual
881 value and is not a relative offset to a section. */
882 #define BSF_ABSOLUTE 0x80
884 /* Used by the linker */
885 #define BSF_KEEP 0x10000
886 #define BSF_KEEP_G 0x80000
889 #define BSF_WEAK 0x100000
890 #define BSF_CTOR 0x200000
891 #define BSF_FAKE 0x400000
893 /* The symbol used to be a common symbol, but now it is
895 #define BSF_OLD_COMMON 0x800000
897 /* The default value for common data. */
898 #define BFD_FORT_COMM_DEFAULT_VALUE 0
900 /* In some files the type of a symbol sometimes alters its
901 location in an output file - ie in coff a <<ISFCN>> symbol
902 which is also <<C_EXT>> symbol appears where it was
903 declared and not at the end of a section. This bit is set
904 by the target BFD part to convey this information. */
906 #define BSF_NOT_AT_END 0x40000
908 /* Signal that the symbol is the label of constructor section. */
909 #define BSF_CONSTRUCTOR 0x1000000
911 /* Signal that the symbol is a warning symbol. If the symbol
912 is a warning symbol, then the value field (I know this is
913 tacky) will point to the asymbol which when referenced will
914 cause the warning. */
915 #define BSF_WARNING 0x2000000
917 /* Signal that the symbol is indirect. The value of the symbol
918 is a pointer to an undefined asymbol which contains the
919 name to use instead. */
920 #define BSF_INDIRECT 0x4000000
924 /* A pointer to the section to which this symbol is relative,
925 or 0 if the symbol is absolute or undefined. Note that it
926 is not sufficient to set this location to 0 to mark a
927 symbol as absolute - the flag <<BSF_ABSOLUTE>> must be set
931 /* Back end special data. This is being phased out in favour
932 of making this a union. */
936 #define get_symtab_upper_bound(abfd) \
937 BFD_SEND (abfd, _get_symtab_upper_bound, (abfd))
938 #define bfd_canonicalize_symtab(abfd, location) \
939 BFD_SEND (abfd, _bfd_canonicalize_symtab,\
941 boolean
EXFUN(bfd_set_symtab
, (bfd
*, asymbol
**, unsigned int ));
942 void EXFUN(bfd_print_symbol_vandf
, (PTR file
, asymbol
*symbol
));
943 #define bfd_make_empty_symbol(abfd) \
944 BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
945 int EXFUN(bfd_decode_symclass
, (asymbol
*symbol
));
948 /* The filename the application opened the BFD with. */
949 CONST
char *filename
;
951 /* A pointer to the target jump table. */
952 struct bfd_target
*xvec
;
954 /* To avoid dragging too many header files into every file that
955 includes @file{bfd.h}, IOSTREAM has been declared as a "char
956 *", and MTIME as a "long". Their correct types, to which they
957 are cast when used, are "FILE *" and "time_t". The iostream
958 is the result of an fopen on the filename. */
961 /* Is the file being cached */
965 /* Marks whether there was a default target specified when the
966 BFD was opened. This is used to select what matching algorithm
967 to use to chose the back end. */
969 boolean target_defaulted
;
971 /* The caching routines use these to maintain a
972 least-recently-used list of BFDs */
974 struct _bfd
*lru_prev
, *lru_next
;
976 /* When a file is closed by the caching routines, BFD retains
977 state information on the file here:
986 /* Set if we have a locally maintained mtime value, rather than
987 getting it from the file each time: */
991 /* File modified time, if mtime_set is true: */
995 /* Reserved for an unimplemented file locking extension.*/
999 /* The format which belongs to the BFD.*/
1003 /* The direction the BFD was opened with*/
1005 enum bfd_direction
{no_direction
= 0,
1007 write_direction
= 2,
1008 both_direction
= 3} direction
;
1010 /* Format_specific flags*/
1014 /* Currently my_archive is tested before adding origin to
1015 anything. I believe that this can become always an add of
1016 origin, with origin set to 0 for non archive files. */
1020 /* Remember when output has begun, to stop strange things
1022 boolean output_has_begun
;
1024 /* Pointer to linked list of sections*/
1025 struct sec
*sections
;
1027 /* The number of sections */
1028 unsigned int section_count
;
1030 /* Stuff only useful for object files:
1031 The start address. */
1032 bfd_vma start_address
;
1034 /* Used for input and output*/
1035 unsigned int symcount
;
1037 /* Symbol table for output BFD*/
1038 struct symbol_cache_entry
**outsymbols
;
1040 /* Pointer to structure which contains architecture information*/
1041 struct bfd_arch_info
*arch_info
;
1043 /* Stuff only useful for archives:*/
1045 struct _bfd
*my_archive
;
1047 struct _bfd
*archive_head
;
1050 /* Used by the back end to hold private data. */
1053 /* Used by the application to hold private data*/
1056 /* Where all the allocated stuff under this BFD goes */
1057 struct obstack memory
;
1060 unsigned int EXFUN(bfd_get_reloc_upper_bound
, (bfd
*abfd
, asection
*sect
));
1061 unsigned int EXFUN(bfd_canonicalize_reloc
1066 boolean
EXFUN(bfd_set_file_flags
, (bfd
*abfd
, flagword flags
));
1067 void EXFUN(bfd_set_reloc
1068 , (bfd
*abfd
, asection
*sec
, arelent
**rel
, unsigned int count
)
1071 boolean
EXFUN(bfd_set_start_address
, (bfd
*, bfd_vma
));
1072 long EXFUN(bfd_get_mtime
, (bfd
*));
1073 #define bfd_sizeof_headers(abfd, reloc) \
1074 BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc))
1076 #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1077 BFD_SEND (abfd, _bfd_find_nearest_line, (abfd, sec, syms, off, file, func, line))
1079 #define bfd_debug_info_start(abfd) \
1080 BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1082 #define bfd_debug_info_end(abfd) \
1083 BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1085 #define bfd_debug_info_accumulate(abfd, section) \
1086 BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1088 #define bfd_stat_arch_elt(abfd, stat) \
1089 BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
1091 #define bfd_coff_swap_aux_in(a,e,t,c,i) \
1092 BFD_SEND (a, _bfd_coff_swap_aux_in, (a,e,t,c,i))
1094 #define bfd_coff_swap_sym_in(a,e,i) \
1095 BFD_SEND (a, _bfd_coff_swap_sym_in, (a,e,i))
1097 #define bfd_coff_swap_lineno_in(a,e,i) \
1098 BFD_SEND ( a, _bfd_coff_swap_lineno_in, (a,e,i))
1100 #define bfd_set_arch_mach(abfd, arch, mach)\
1101 BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
1103 #define bfd_coff_swap_reloc_out(abfd, i, o) \
1104 BFD_SEND (abfd, _bfd_coff_swap_reloc_out, (abfd, i, o))
1106 #define bfd_coff_swap_lineno_out(abfd, i, o) \
1107 BFD_SEND (abfd, _bfd_coff_swap_lineno_out, (abfd, i, o))
1109 #define bfd_coff_swap_aux_out(abfd, i, t,c,o) \
1110 BFD_SEND (abfd, _bfd_coff_swap_aux_out, (abfd, i,t,c, o))
1112 #define bfd_coff_swap_sym_out(abfd, i,o) \
1113 BFD_SEND (abfd, _bfd_coff_swap_sym_out, (abfd, i, o))
1115 #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
1116 BFD_SEND (abfd, _bfd_coff_swap_scnhdr_out, (abfd, i, o))
1118 #define bfd_coff_swap_filehdr_out(abfd, i,o) \
1119 BFD_SEND (abfd, _bfd_coff_swap_filehdr_out, (abfd, i, o))
1121 #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
1122 BFD_SEND (abfd, _bfd_coff_swap_aouthdr_out, (abfd, i, o))
1124 symindex
EXFUN(bfd_get_next_mapent
, (bfd
*, symindex
, carsym
**));
1125 boolean
EXFUN(bfd_set_archive_head
, (bfd
*output
, bfd
*new_head
));
1126 bfd
*EXFUN(bfd_get_elt_at_index
, (bfd
*, int));
1127 bfd
* EXFUN(bfd_openr_next_archived_file
, (bfd
*archive
, bfd
*previous
));
1128 CONST
char *EXFUN(bfd_core_file_failing_command
, (bfd
*));
1129 int EXFUN(bfd_core_file_failing_signal
, (bfd
*));
1130 boolean
EXFUN(core_file_matches_executable_p
1131 , (bfd
*core_bfd
, bfd
*exec_bfd
));
1132 #define SDEF(ret, name, arglist) \
1133 PROTO(ret,(*name),arglist)
1134 #define SDEF_FMT(ret, name, arglist) \
1135 PROTO(ret,(*name[bfd_type_end]),arglist)
1136 #define BFD_SEND(bfd, message, arglist) \
1137 ((*((bfd)->xvec->message)) arglist)
1138 #define BFD_SEND_FMT(bfd, message, arglist) \
1139 (((bfd)->xvec->message[(int)((bfd)->format)]) arglist)
1140 typedef struct bfd_target
1143 enum target_flavour
{
1144 bfd_target_unknown_flavour
,
1145 bfd_target_aout_flavour
,
1146 bfd_target_coff_flavour
,
1147 bfd_target_elf_flavour
,
1148 bfd_target_ieee_flavour
,
1149 bfd_target_oasys_flavour
,
1150 bfd_target_srec_flavour
} flavour
;
1151 boolean byteorder_big_p
;
1152 boolean header_byteorder_big_p
;
1153 flagword object_flags
;
1154 flagword section_flags
;
1156 unsigned short ar_max_namelen
;
1157 unsigned int align_power_min
;
1158 SDEF (bfd_vma
, bfd_getx64
, (bfd_byte
*));
1159 SDEF (void, bfd_putx64
, (bfd_vma
, bfd_byte
*));
1160 SDEF (bfd_vma
, bfd_getx32
, (bfd_byte
*));
1161 SDEF (void, bfd_putx32
, (bfd_vma
, bfd_byte
*));
1162 SDEF (bfd_vma
, bfd_getx16
, (bfd_byte
*));
1163 SDEF (void, bfd_putx16
, (bfd_vma
, bfd_byte
*));
1164 SDEF (bfd_vma
, bfd_h_getx64
, (bfd_byte
*));
1165 SDEF (void, bfd_h_putx64
, (bfd_vma
, bfd_byte
*));
1166 SDEF (bfd_vma
, bfd_h_getx32
, (bfd_byte
*));
1167 SDEF (void, bfd_h_putx32
, (bfd_vma
, bfd_byte
*));
1168 SDEF (bfd_vma
, bfd_h_getx16
, (bfd_byte
*));
1169 SDEF (void, bfd_h_putx16
, (bfd_vma
, bfd_byte
*));
1170 SDEF_FMT (struct bfd_target
*, _bfd_check_format
, (bfd
*));
1171 SDEF_FMT (boolean
, _bfd_set_format
, (bfd
*));
1172 SDEF_FMT (boolean
, _bfd_write_contents
, (bfd
*));
1173 SDEF (char *, _core_file_failing_command
, (bfd
*));
1174 SDEF (int, _core_file_failing_signal
, (bfd
*));
1175 SDEF (boolean
, _core_file_matches_executable_p
, (bfd
*, bfd
*));
1176 SDEF (boolean
, _bfd_slurp_armap
, (bfd
*));
1177 SDEF (boolean
, _bfd_slurp_extended_name_table
, (bfd
*));
1178 SDEF (void, _bfd_truncate_arname
, (bfd
*, CONST
char *, char *));
1179 SDEF (boolean
, write_armap
, (bfd
*arch
,
1180 unsigned int elength
,
1182 unsigned int orl_count
,
1184 SDEF (boolean
, _close_and_cleanup
, (bfd
*));
1185 SDEF (boolean
, _bfd_set_section_contents
, (bfd
*, sec_ptr
, PTR
,
1186 file_ptr
, bfd_size_type
));
1187 SDEF (boolean
, _bfd_get_section_contents
, (bfd
*, sec_ptr
, PTR
,
1188 file_ptr
, bfd_size_type
));
1189 SDEF (boolean
, _new_section_hook
, (bfd
*, sec_ptr
));
1190 SDEF (unsigned int, _get_symtab_upper_bound
, (bfd
*));
1191 SDEF (unsigned int, _bfd_canonicalize_symtab
,
1192 (bfd
*, struct symbol_cache_entry
**));
1193 SDEF (unsigned int, _get_reloc_upper_bound
, (bfd
*, sec_ptr
));
1194 SDEF (unsigned int, _bfd_canonicalize_reloc
, (bfd
*, sec_ptr
, arelent
**,
1195 struct symbol_cache_entry
**));
1196 SDEF (struct symbol_cache_entry
*, _bfd_make_empty_symbol
, (bfd
*));
1197 SDEF (void, _bfd_print_symbol
, (bfd
*, PTR
, struct symbol_cache_entry
*,
1198 bfd_print_symbol_type
));
1199 #define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e))
1200 SDEF (alent
*, _get_lineno
, (bfd
*, struct symbol_cache_entry
*));
1202 SDEF (boolean
, _bfd_set_arch_mach
, (bfd
*, enum bfd_architecture
,
1205 SDEF (bfd
*, openr_next_archived_file
, (bfd
*arch
, bfd
*prev
));
1206 SDEF (boolean
, _bfd_find_nearest_line
,
1207 (bfd
*abfd
, struct sec
*section
,
1208 struct symbol_cache_entry
**symbols
,bfd_vma offset
,
1209 CONST
char **file
, CONST
char **func
, unsigned int *line
));
1210 SDEF (int, _bfd_stat_arch_elt
, (bfd
*, struct stat
*));
1212 SDEF (int, _bfd_sizeof_headers
, (bfd
*, boolean
));
1214 SDEF (void, _bfd_debug_info_start
, (bfd
*));
1215 SDEF (void, _bfd_debug_info_end
, (bfd
*));
1216 SDEF (void, _bfd_debug_info_accumulate
, (bfd
*, struct sec
*));
1217 SDEF(void, _bfd_coff_swap_aux_in
,(
1224 SDEF(void, _bfd_coff_swap_sym_in
,(
1229 SDEF(void, _bfd_coff_swap_lineno_in
, (
1234 SDEF(unsigned int, _bfd_coff_swap_aux_out
,(
1241 SDEF(unsigned int, _bfd_coff_swap_sym_out
,(
1246 SDEF(unsigned int, _bfd_coff_swap_lineno_out
,(
1251 SDEF(unsigned int, _bfd_coff_swap_reloc_out
,(
1256 SDEF(unsigned int, _bfd_coff_swap_filehdr_out
,(
1261 SDEF(unsigned int, _bfd_coff_swap_aouthdr_out
,(
1266 SDEF(unsigned int, _bfd_coff_swap_scnhdr_out
,(
1272 bfd_target
*EXFUN(bfd_find_target
, (CONST
char *, bfd
*));
1273 CONST
char **EXFUN(bfd_target_list
, ());
1274 boolean
EXFUN(bfd_check_format
, (bfd
*abfd
, bfd_format format
));
1275 boolean
EXFUN(bfd_set_format
, (bfd
*, bfd_format
));
1276 CONST
char *EXFUN(bfd_format_string
, (bfd_format
));