* ldmain.c (add_to_set): Add bitsize argument.
[deliverable/binutils-gdb.git] / bfd / bfd-in2.h
CommitLineData
fdcb0453 1/* Main header file for the bfd library -- portable access to object files.
fdcb0453
KR
2 Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
3 Contributed by Cygnus Support.
4
b66b07a2
KR
5** NOTE: bfd.h and bfd-in2.h are GENERATED files. Don't change them;
6** instead, change bfd-in.h or the other BFD source files processed to
7** generate these files.
8
fdcb0453
KR
9This file is part of BFD, the Binary File Descriptor library.
10
11This program is free software; you can redistribute it and/or modify
12it under the terms of the GNU General Public License as published by
13the Free Software Foundation; either version 2 of the License, or
14(at your option) any later version.
15
16This program is distributed in the hope that it will be useful,
17but WITHOUT ANY WARRANTY; without even the implied warranty of
18MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19GNU General Public License for more details.
20
21You should have received a copy of the GNU General Public License
22along with this program; if not, write to the Free Software
23Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
24
25/* bfd.h -- The only header file required by users of the bfd library
26
27The bfd.h file is generated from bfd-in.h and various .c files; if you
28change it, your changes will probably be lost.
29
30All the prototypes and definitions following the comment "THE FOLLOWING
31IS EXTRACTED FROM THE SOURCE" are extracted from the source files for
32BFD. If you change it, someone oneday will extract it from the source
33again, and your changes will be lost. To save yourself from this bind,
34change the definitions in the source in the bfd directory. Type "make
35docs" and then "make headers" in that directory, and magically this file
36will change to reflect your changes.
37
38If you don't have the tools to perform the extraction, then you are
39safe from someone on your system trampling over your header files.
40You should still maintain the equivalence between the source and this
41file though; every change you make to the .c file should be reflected
42here. */
43
44#ifndef __BFD_H_SEEN__
45#define __BFD_H_SEEN__
46
47#include "ansidecl.h"
48#include "obstack.h"
49
50#define BFD_VERSION "2.2"
51
52#define BFD_ARCH_SIZE @WORDSIZE@
53
54#if BFD_ARCH_SIZE >= 64
55#define BFD64
56#endif
57
c3e964b9
FF
58#ifndef INLINE
59#if __GNUC__ >= 2
60#define INLINE __inline__
61#else
62#define INLINE
63#endif
64#endif
65
87cc59ce
KR
66/* 64-bit type definition (if any) from bfd's sysdep.h goes here */
67
fdcb0453
KR
68
69/* forward declaration */
70typedef struct _bfd bfd;
71
72/* To squelch erroneous compiler warnings ("illegal pointer
73 combination") from the SVR3 compiler, we would like to typedef
74 boolean to int (it doesn't like functions which return boolean.
75 Making sure they are never implicitly declared to return int
76 doesn't seem to help). But this file is not configured based on
77 the host. */
78/* General rules: functions which are boolean return true on success
79 and false on failure (unless they're a predicate). -- bfd.doc */
80/* I'm sure this is going to break something and someone is going to
81 force me to change it. */
82/* typedef enum boolean {false, true} boolean; */
83/* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h> -fnf */
84typedef enum bfd_boolean {false, true} boolean;
85
86/* A pointer to a position in a file. */
87/* FIXME: This should be using off_t from <sys/types.h>.
88 For now, try to avoid breaking stuff by not including <sys/types.h> here.
89 This will break on systems with 64-bit file offsets (e.g. 4.4BSD).
90 Probably the best long-term answer is to avoid using file_ptr AND off_t
91 in this header file, and to handle this in the BFD implementation
92 rather than in its interface. */
93/* typedef off_t file_ptr; */
94typedef long int file_ptr;
95
96/* Support for different sizes of target format ints and addresses. If the
97 host implements 64-bit values, it defines HOST_64_BIT to be the appropriate
98 type. Otherwise, this code will fall back on gcc's "long long" type if gcc
99 is being used. HOST_64_BIT must be defined in such a way as to be a valid
100 type name by itself or with "unsigned" prefixed. It should be a signed
101 type by itself.
102
103 If neither is the case, then compilation will fail if 64-bit targets are
104 requested. If you don't request any 64-bit targets, you should be safe. */
105
106#ifdef BFD64
107
108#if defined (__GNUC__) && !defined (HOST_64_BIT)
109#define HOST_64_BIT long long
110typedef HOST_64_BIT int64_type;
111typedef unsigned HOST_64_BIT uint64_type;
112#endif
113
fa5ba217
KR
114#if !defined (uint64_type) && defined (__GNUC__)
115#define uint64_type unsigned long long
116#define int64_type long long
4aed7f24
ILT
117#define uint64_typeLOW(x) ((unsigned long)(((x) & 0xffffffff)))
118#define uint64_typeHIGH(x) ((unsigned long)(((x) >> 32) & 0xffffffff))
fa5ba217
KR
119#endif
120
fdcb0453
KR
121typedef unsigned HOST_64_BIT bfd_vma;
122typedef HOST_64_BIT bfd_signed_vma;
123typedef unsigned HOST_64_BIT bfd_size_type;
124typedef unsigned HOST_64_BIT symvalue;
125#define fprintf_vma(s,x) \
4aed7f24 126 fprintf(s,"%08lx%08lx", uint64_typeHIGH(x), uint64_typeLOW(x))
fa5ba217 127#define sprintf_vma(s,x) \
4aed7f24 128 sprintf(s,"%08lx%08lx", uint64_typeHIGH(x), uint64_typeLOW(x))
fdcb0453
KR
129#else /* not BFD64 */
130
131/* Represent a target address. Also used as a generic unsigned type
132 which is guaranteed to be big enough to hold any arithmetic types
133 we need to deal with. */
134typedef unsigned long bfd_vma;
135
136/* A generic signed type which is guaranteed to be big enough to hold any
137 arithmetic types we need to deal with. Can be assumed to be compatible
138 with bfd_vma in the same way that signed and unsigned ints are compatible
139 (as parameters, in assignment, etc). */
140typedef long bfd_signed_vma;
141
142typedef unsigned long symvalue;
143typedef unsigned long bfd_size_type;
144
145/* Print a bfd_vma x on stream s. */
146#define fprintf_vma(s,x) fprintf(s, "%08lx", x)
fa5ba217 147#define sprintf_vma(s,x) sprintf(s, "%08lx", x)
fdcb0453
KR
148#endif /* not BFD64 */
149#define printf_vma(x) fprintf_vma(stdout,x)
150
151typedef unsigned int flagword; /* 32 bits of flags */
152\f
153/** File formats */
154
155typedef enum bfd_format {
156 bfd_unknown = 0, /* file format is unknown */
157 bfd_object, /* linker/assember/compiler output */
158 bfd_archive, /* object archive file */
159 bfd_core, /* core dump */
160 bfd_type_end} /* marks the end; don't use it! */
161 bfd_format;
162
9e461dac
JK
163/* Values that may appear in the flags field of a BFD. These also
164 appear in the object_flags field of the bfd_target structure, where
165 they indicate the set of flags used by that backend (not all flags
166 are meaningful for all object file formats) (FIXME: at the moment,
167 the object_flags values have mostly just been copied from backend
168 to another, and are not necessarily correct). */
169
170/* No flags. */
fdcb0453 171#define NO_FLAGS 0x00
9e461dac
JK
172
173/* BFD contains relocation entries. */
fdcb0453 174#define HAS_RELOC 0x01
9e461dac
JK
175
176/* BFD is directly executable. */
fdcb0453 177#define EXEC_P 0x02
9e461dac
JK
178
179/* BFD has line number information (basically used for F_LNNO in a
180 COFF header). */
fdcb0453 181#define HAS_LINENO 0x04
9e461dac
JK
182
183/* BFD has debugging information. */
fdcb0453 184#define HAS_DEBUG 0x08
9e461dac
JK
185
186/* BFD has symbols. */
fdcb0453 187#define HAS_SYMS 0x10
9e461dac
JK
188
189/* BFD has local symbols (basically used for F_LSYMS in a COFF
190 header). */
fdcb0453 191#define HAS_LOCALS 0x20
9e461dac
JK
192
193/* BFD is a dynamic object. */
fdcb0453 194#define DYNAMIC 0x40
9e461dac
JK
195
196/* Text section is write protected (if D_PAGED is not set, this is
197 like an a.out NMAGIC file) (the linker sets this by default, but
198 clears it for -r or -N). */
fdcb0453 199#define WP_TEXT 0x80
9e461dac
JK
200
201/* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
202 linker sets this by default, but clears it for -r or -n or -N). */
fdcb0453 203#define D_PAGED 0x100
9e461dac
JK
204
205/* BFD is relaxable (this means that bfd_relax_section may be able to
206 do something). */
fdcb0453
KR
207#define BFD_IS_RELAXABLE 0x200
208\f
209/* symbols and relocation */
210
211typedef unsigned long symindex;
212
213#define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
214
215typedef enum bfd_symclass {
216 bfd_symclass_unknown = 0,
217 bfd_symclass_fcommon, /* fortran common symbols */
218 bfd_symclass_global, /* global symbol, what a surprise */
219 bfd_symclass_debugger, /* some debugger symbol */
220 bfd_symclass_undefined /* none known */
221 } symclass;
222
223
fdcb0453
KR
224/* general purpose part of a symbol;
225 target specific parts will be found in libcoff.h, liba.out.h etc */
226
227
228#define bfd_get_section(x) ((x)->section)
229#define bfd_get_output_section(x) ((x)->section->output_section)
230#define bfd_set_section(x,y) ((x)->section) = (y)
231#define bfd_asymbol_base(x) ((x)->section->vma)
232#define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value)
233#define bfd_asymbol_name(x) ((x)->name)
234/*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/
235#define bfd_asymbol_bfd(x) ((x)->the_bfd)
236#define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour)
237
238/* This is a type pun with struct ranlib on purpose! */
239typedef struct carsym {
240 char *name;
241 file_ptr file_offset; /* look here to find the file */
242} carsym; /* to make these you call a carsymogen */
243
244
245/* Used in generating armaps. Perhaps just a forward definition would do? */
246struct orl { /* output ranlib */
247 char **name; /* symbol name */
248 file_ptr pos; /* bfd* or file position */
249 int namidx; /* index into string table */
250};
251
252\f
253
254/* Linenumber stuff */
255typedef struct lineno_cache_entry {
256 unsigned int line_number; /* Linenumber from start of function*/
257 union {
258 struct symbol_cache_entry *sym; /* Function name */
259 unsigned long offset; /* Offset into section */
260 } u;
261} alent;
262\f
263/* object and core file sections */
264
265
266#define align_power(addr, align) \
267 ( ((addr) + ((1<<(align))-1)) & (-1 << (align)))
268
269typedef struct sec *sec_ptr;
270
271#define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
272#define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
273#define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
274#define bfd_section_name(bfd, ptr) ((ptr)->name)
275#define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr))
276#define bfd_section_vma(bfd, ptr) ((ptr)->vma)
277#define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
278#define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
279#define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
280
281#define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0)
282
283#define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma= (val)), ((ptr)->user_set_vma = true), true)
284#define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true)
285#define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true)
286
287typedef struct stat stat_type;
288\f
4c3721d5 289/* Error handling */
fdcb0453 290
4c3721d5
ILT
291typedef enum bfd_error
292{
293 no_error = 0,
294 system_call_error,
295 invalid_target,
296 wrong_format,
297 invalid_operation,
298 no_memory,
299 no_symbols,
300 no_relocation_info,
301 no_more_archived_files,
302 malformed_archive,
303 symbol_not_found,
304 file_not_recognized,
305 file_ambiguously_recognized,
306 no_contents,
307 bfd_error_nonrepresentable_section,
308 no_debug_section,
309 bad_value,
310 file_truncated,
311 invalid_error_code
312} bfd_ec;
fdcb0453 313
4c3721d5 314extern bfd_ec bfd_error;
fdcb0453
KR
315
316CONST char *bfd_errmsg PARAMS ((bfd_ec error_tag));
317void bfd_perror PARAMS ((CONST char *message));
318\f
319
320typedef enum bfd_print_symbol
321{
322 bfd_print_symbol_name,
323 bfd_print_symbol_more,
324 bfd_print_symbol_all
325} bfd_print_symbol_type;
326
327\f
328/* Information about a symbol that nm needs. */
329
330typedef struct _symbol_info
331{
332 symvalue value;
333 char type; /* */
334 CONST char *name; /* Symbol name. */
335 char stab_other; /* Unused. */
336 short stab_desc; /* Info for N_TYPE. */
337 CONST char *stab_name;
338} symbol_info;
339\f
4c3721d5
ILT
340/* Hash table routines. There is no way to free up a hash table. */
341
342/* An element in the hash table. Most uses will actually use a larger
343 structure, and an instance of this will be the first field. */
344
345struct bfd_hash_entry
346{
347 /* Next entry for this hash code. */
348 struct bfd_hash_entry *next;
349 /* String being hashed. */
350 const char *string;
351 /* Hash code. This is the full hash code, not the index into the
352 table. */
353 unsigned long hash;
354};
355
356/* A hash table. */
357
358struct bfd_hash_table
359{
360 /* The hash array. */
361 struct bfd_hash_entry **table;
362 /* The number of slots in the hash table. */
363 unsigned int size;
364 /* A function used to create new elements in the hash table. The
365 first entry is itself a pointer to an element. When this
366 function is first invoked, this pointer will be NULL. However,
367 having the pointer permits a hierarchy of method functions to be
368 built each of which calls the function in the superclass. Thus
369 each function should be written to allocate a new block of memory
370 only if the argument is NULL. */
371 struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *,
372 struct bfd_hash_table *,
373 const char *));
374 /* An obstack for this hash table. */
375 struct obstack memory;
376};
377
378/* Initialize a hash table. */
379extern boolean bfd_hash_table_init
380 PARAMS ((struct bfd_hash_table *,
381 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
382 struct bfd_hash_table *,
383 const char *)));
384
385/* Initialize a hash table specifying a size. */
386extern boolean bfd_hash_table_init_n
387 PARAMS ((struct bfd_hash_table *,
388 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
389 struct bfd_hash_table *,
390 const char *),
391 unsigned int size));
392
393/* Free up a hash table. */
394extern void bfd_hash_table_free PARAMS ((struct bfd_hash_table *));
395
396/* Look up a string in a hash table. If CREATE is true, a new entry
397 will be created for this string if one does not already exist. The
398 COPY argument must be true if this routine should copy the string
399 into newly allocated memory when adding an entry. */
400extern struct bfd_hash_entry *bfd_hash_lookup
401 PARAMS ((struct bfd_hash_table *, const char *, boolean create,
402 boolean copy));
403
404/* Base method for creating a hash table entry. */
405extern struct bfd_hash_entry *bfd_hash_newfunc
406 PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *,
407 const char *));
408
409/* Grab some space for a hash table entry. */
410extern PTR bfd_hash_allocate PARAMS ((struct bfd_hash_table *, size_t));
411
412/* Traverse a hash table in a random order, calling a function on each
413 element. If the function returns false, the traversal stops. The
414 INFO argument is passed to the function. */
415extern void bfd_hash_traverse PARAMS ((struct bfd_hash_table *,
416 boolean (*) (struct bfd_hash_entry *,
417 PTR),
418 PTR info));
419\f
fdcb0453
KR
420/* The code that implements targets can initialize a jump table with this
421 macro. It must name all its routines the same way (a prefix plus
422 the standard routine suffix), or it must #define the routines that
423 are not so named, before calling JUMP_TABLE in the initializer. */
424
c3e964b9
FF
425/* Semi-portable string concatenation in cpp.
426 The CAT4 hack is to avoid a problem with some strict ANSI C preprocessors.
427 The problem is, "32_" is not a valid preprocessing token, and we don't
428 want extra underscores (e.g., "nlm_32_"). The XCAT2 macro will cause the
429 inner CAT macros to be evaluated first, producing still-valid pp-tokens.
430 Then the final concatenation can be done. (Sigh.) */
fdcb0453 431#ifndef CAT
c3e964b9
FF
432#ifdef SABER
433#define CAT(a,b) a##b
434#define CAT3(a,b,c) a##b##c
435#define CAT4(a,b,c,d) a##b##c##d
436#else
fdcb0453
KR
437#ifdef __STDC__
438#define CAT(a,b) a##b
439#define CAT3(a,b,c) a##b##c
c3e964b9
FF
440#define XCAT2(a,b) CAT(a,b)
441#define CAT4(a,b,c,d) XCAT2(CAT(a,b),CAT(c,d))
fdcb0453
KR
442#else
443#define CAT(a,b) a/**/b
444#define CAT3(a,b,c) a/**/b/**/c
c3e964b9
FF
445#define CAT4(a,b,c,d) a/**/b/**/c/**/d
446#endif
fdcb0453
KR
447#endif
448#endif
449
450#define JUMP_TABLE(NAME)\
451CAT(NAME,_core_file_failing_command),\
452CAT(NAME,_core_file_failing_signal),\
453CAT(NAME,_core_file_matches_executable_p),\
454CAT(NAME,_slurp_armap),\
455CAT(NAME,_slurp_extended_name_table),\
456CAT(NAME,_truncate_arname),\
457CAT(NAME,_write_armap),\
c3e964b9 458CAT(NAME,_close_and_cleanup),\
fdcb0453
KR
459CAT(NAME,_set_section_contents),\
460CAT(NAME,_get_section_contents),\
461CAT(NAME,_new_section_hook),\
462CAT(NAME,_get_symtab_upper_bound),\
463CAT(NAME,_get_symtab),\
464CAT(NAME,_get_reloc_upper_bound),\
465CAT(NAME,_canonicalize_reloc),\
466CAT(NAME,_make_empty_symbol),\
467CAT(NAME,_print_symbol),\
468CAT(NAME,_get_symbol_info),\
469CAT(NAME,_get_lineno),\
470CAT(NAME,_set_arch_mach),\
471CAT(NAME,_openr_next_archived_file),\
472CAT(NAME,_find_nearest_line),\
473CAT(NAME,_generic_stat_arch_elt),\
474CAT(NAME,_sizeof_headers),\
475CAT(NAME,_bfd_debug_info_start),\
476CAT(NAME,_bfd_debug_info_end),\
477CAT(NAME,_bfd_debug_info_accumulate),\
478CAT(NAME,_bfd_get_relocated_section_contents),\
479CAT(NAME,_bfd_relax_section),\
fdcb0453 480CAT(NAME,_bfd_reloc_type_lookup),\
4c3721d5
ILT
481CAT(NAME,_bfd_make_debug_symbol),\
482CAT(NAME,_bfd_link_hash_table_create),\
483CAT(NAME,_bfd_link_add_symbols),\
484CAT(NAME,_bfd_final_link)
fdcb0453
KR
485
486#define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table
487
488\f
489/* User program access to BFD facilities */
490
fdcb0453
KR
491/* Cast from const char * to char * so that caller can assign to
492 a char * without a warning. */
493#define bfd_get_filename(abfd) ((char *) (abfd)->filename)
0a197a96 494#define bfd_get_cacheable(abfd) ((abfd)->cacheable)
fdcb0453
KR
495#define bfd_get_format(abfd) ((abfd)->format)
496#define bfd_get_target(abfd) ((abfd)->xvec->name)
9e461dac 497#define bfd_get_flavour(abfd) ((abfd)->xvec->flavour)
fdcb0453
KR
498#define bfd_get_file_flags(abfd) ((abfd)->flags)
499#define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
500#define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
501#define bfd_my_archive(abfd) ((abfd)->my_archive)
502#define bfd_has_map(abfd) ((abfd)->has_armap)
fdcb0453
KR
503
504#define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
505#define bfd_usrdata(abfd) ((abfd)->usrdata)
506
507#define bfd_get_start_address(abfd) ((abfd)->start_address)
508#define bfd_get_symcount(abfd) ((abfd)->symcount)
509#define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
510#define bfd_count_sections(abfd) ((abfd)->section_count)
fdcb0453
KR
511
512#define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char)
513
0a197a96
JG
514#define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = (bool)), true)
515
2b91cc45
SG
516/* Byte swapping routines. */
517
1a973af1
ILT
518bfd_vma bfd_getb64 PARAMS ((const unsigned char *));
519bfd_vma bfd_getl64 PARAMS ((const unsigned char *));
520bfd_signed_vma bfd_getb_signed_64 PARAMS ((const unsigned char *));
521bfd_signed_vma bfd_getl_signed_64 PARAMS ((const unsigned char *));
522bfd_vma bfd_getb32 PARAMS ((const unsigned char *));
523bfd_vma bfd_getl32 PARAMS ((const unsigned char *));
524bfd_signed_vma bfd_getb_signed_32 PARAMS ((const unsigned char *));
525bfd_signed_vma bfd_getl_signed_32 PARAMS ((const unsigned char *));
526bfd_vma bfd_getb16 PARAMS ((const unsigned char *));
527bfd_vma bfd_getl16 PARAMS ((const unsigned char *));
528bfd_signed_vma bfd_getb_signed_16 PARAMS ((const unsigned char *));
529bfd_signed_vma bfd_getl_signed_16 PARAMS ((const unsigned char *));
2b91cc45
SG
530void bfd_putb64 PARAMS ((bfd_vma, unsigned char *));
531void bfd_putl64 PARAMS ((bfd_vma, unsigned char *));
532void bfd_putb32 PARAMS ((bfd_vma, unsigned char *));
533void bfd_putl32 PARAMS ((bfd_vma, unsigned char *));
534void bfd_putb16 PARAMS ((bfd_vma, unsigned char *));
535void bfd_putl16 PARAMS ((bfd_vma, unsigned char *));
536
8d12f138
ILT
537/* ECOFF linking routines. */
538#ifdef __STDC__
539struct ecoff_debug_info;
540struct ecoff_debug_swap;
541struct ecoff_extr;
542struct symbol_cache_entry;
543#endif
544extern boolean bfd_ecoff_debug_accumulate
545 PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
546 const struct ecoff_debug_swap *output_swap,
547 bfd *input_bfd, struct ecoff_debug_info *input_debug,
548 const struct ecoff_debug_swap *input_swap,
549 boolean relocateable));
550extern boolean bfd_ecoff_debug_link_other
551 PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
552 const struct ecoff_debug_swap *output_swap, bfd *input_bfd));
553extern boolean bfd_ecoff_debug_externals
554 PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
555 const struct ecoff_debug_swap *swap,
556 boolean relocateable,
557 boolean (*get_extr) (struct symbol_cache_entry *,
558 struct ecoff_extr *),
559 void (*set_index) (struct symbol_cache_entry *,
560 bfd_size_type)));
561extern bfd_size_type bfd_ecoff_debug_size
562 PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
563 const struct ecoff_debug_swap *swap));
564extern boolean bfd_ecoff_write_debug
565 PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
566 const struct ecoff_debug_swap *swap, file_ptr where));
567
fdcb0453
KR
568/* And more from the source. */
569void
570bfd_init PARAMS ((void));
571
572bfd *
c188b0be 573bfd_openr PARAMS ((CONST char *filename, CONST char *target));
fdcb0453
KR
574
575bfd *
576bfd_fdopenr PARAMS ((CONST char *filename, CONST char *target, int fd));
577
578bfd *
579bfd_openw PARAMS ((CONST char *filename, CONST char *target));
580
581boolean
c188b0be 582bfd_close PARAMS ((bfd *abfd));
fdcb0453
KR
583
584boolean
585bfd_close_all_done PARAMS ((bfd *));
586
587bfd_size_type
588bfd_alloc_size PARAMS ((bfd *abfd));
589
590bfd *
10bd43a8 591bfd_create PARAMS ((CONST char *filename, bfd *templ));
fdcb0453
KR
592
593
594 /* Byte swapping macros for user section data. */
595
596#define bfd_put_8(abfd, val, ptr) \
e2756048 597 (*((unsigned char *)(ptr)) = (unsigned char)(val))
fdcb0453
KR
598#define bfd_put_signed_8 \
599 bfd_put_8
600#define bfd_get_8(abfd, ptr) \
601 (*(unsigned char *)(ptr))
602#define bfd_get_signed_8(abfd, ptr) \
603 ((*(unsigned char *)(ptr) ^ 0x80) - 0x80)
604
605#define bfd_put_16(abfd, val, ptr) \
606 BFD_SEND(abfd, bfd_putx16, ((val),(ptr)))
607#define bfd_put_signed_16 \
608 bfd_put_16
609#define bfd_get_16(abfd, ptr) \
610 BFD_SEND(abfd, bfd_getx16, (ptr))
611#define bfd_get_signed_16(abfd, ptr) \
612 BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
613
614#define bfd_put_32(abfd, val, ptr) \
615 BFD_SEND(abfd, bfd_putx32, ((val),(ptr)))
616#define bfd_put_signed_32 \
617 bfd_put_32
618#define bfd_get_32(abfd, ptr) \
619 BFD_SEND(abfd, bfd_getx32, (ptr))
620#define bfd_get_signed_32(abfd, ptr) \
621 BFD_SEND(abfd, bfd_getx_signed_32, (ptr))
622
623#define bfd_put_64(abfd, val, ptr) \
624 BFD_SEND(abfd, bfd_putx64, ((val), (ptr)))
625#define bfd_put_signed_64 \
626 bfd_put_64
627#define bfd_get_64(abfd, ptr) \
628 BFD_SEND(abfd, bfd_getx64, (ptr))
629#define bfd_get_signed_64(abfd, ptr) \
630 BFD_SEND(abfd, bfd_getx_signed_64, (ptr))
631
632
633 /* Byte swapping macros for file header data. */
634
635#define bfd_h_put_8(abfd, val, ptr) \
636 bfd_put_8 (abfd, val, ptr)
637#define bfd_h_put_signed_8(abfd, val, ptr) \
638 bfd_put_8 (abfd, val, ptr)
639#define bfd_h_get_8(abfd, ptr) \
640 bfd_get_8 (abfd, ptr)
641#define bfd_h_get_signed_8(abfd, ptr) \
642 bfd_get_signed_8 (abfd, ptr)
643
644#define bfd_h_put_16(abfd, val, ptr) \
645 BFD_SEND(abfd, bfd_h_putx16,(val,ptr))
646#define bfd_h_put_signed_16 \
647 bfd_h_put_16
648#define bfd_h_get_16(abfd, ptr) \
649 BFD_SEND(abfd, bfd_h_getx16,(ptr))
650#define bfd_h_get_signed_16(abfd, ptr) \
651 BFD_SEND(abfd, bfd_h_getx_signed_16, (ptr))
652
653#define bfd_h_put_32(abfd, val, ptr) \
654 BFD_SEND(abfd, bfd_h_putx32,(val,ptr))
655#define bfd_h_put_signed_32 \
656 bfd_h_put_32
657#define bfd_h_get_32(abfd, ptr) \
658 BFD_SEND(abfd, bfd_h_getx32,(ptr))
659#define bfd_h_get_signed_32(abfd, ptr) \
660 BFD_SEND(abfd, bfd_h_getx_signed_32, (ptr))
661
662#define bfd_h_put_64(abfd, val, ptr) \
663 BFD_SEND(abfd, bfd_h_putx64,(val, ptr))
664#define bfd_h_put_signed_64 \
665 bfd_h_put_64
666#define bfd_h_get_64(abfd, ptr) \
667 BFD_SEND(abfd, bfd_h_getx64,(ptr))
668#define bfd_h_get_signed_64(abfd, ptr) \
669 BFD_SEND(abfd, bfd_h_getx_signed_64, (ptr))
670
671typedef struct sec
672{
c188b0be 673 /* The name of the section; the name isn't a copy, the pointer is
fdcb0453
KR
674 the same as that passed to bfd_make_section. */
675
676 CONST char *name;
677
c188b0be 678 /* Which section is it; 0..nth. */
fdcb0453
KR
679
680 int index;
681
682 /* The next section in the list belonging to the BFD, or NULL. */
683
684 struct sec *next;
685
c188b0be 686 /* The field flags contains attributes of the section. Some
fdcb0453
KR
687 flags are read in from the object file, and some are
688 synthesized from other information. */
689
690 flagword flags;
691
692#define SEC_NO_FLAGS 0x000
693
c188b0be
DM
694 /* Tells the OS to allocate space for this section when loading.
695 This is clear for a section containing debug information
fdcb0453 696 only. */
fdcb0453 697#define SEC_ALLOC 0x001
ef758f3e 698
fdcb0453 699 /* Tells the OS to load the section from the file when loading.
c188b0be 700 This is clear for a .bss section. */
fdcb0453 701#define SEC_LOAD 0x002
ef758f3e 702
c188b0be
DM
703 /* The section contains data still to be relocated, so there is
704 some relocation information too. */
fdcb0453
KR
705#define SEC_RELOC 0x004
706
b2ae9efb 707#if 0 /* Obsolete ? */
fdcb0453 708#define SEC_BALIGN 0x008
b2ae9efb 709#endif
fdcb0453
KR
710
711 /* A signal to the OS that the section contains read only
712 data. */
713#define SEC_READONLY 0x010
714
715 /* The section contains code only. */
fdcb0453
KR
716#define SEC_CODE 0x020
717
718 /* The section contains data only. */
b2ae9efb 719#define SEC_DATA 0x040
fdcb0453
KR
720
721 /* The section will reside in ROM. */
fdcb0453
KR
722#define SEC_ROM 0x080
723
724 /* The section contains constructor information. This section
725 type is used by the linker to create lists of constructors and
726 destructors used by <<g++>>. When a back end sees a symbol
727 which should be used in a constructor list, it creates a new
c188b0be
DM
728 section for the type of name (e.g., <<__CTOR_LIST__>>), attaches
729 the symbol to it, and builds a relocation. To build the lists
bc750ff1 730 of constructors, all the linker has to do is catenate all the
c188b0be 731 sections called <<__CTOR_LIST__>> and relocate the data
fdcb0453
KR
732 contained within - exactly the operations it would peform on
733 standard data. */
fdcb0453
KR
734#define SEC_CONSTRUCTOR 0x100
735
736 /* The section is a constuctor, and should be placed at the
b2ae9efb 737 end of the text, data, or bss section(?). */
fdcb0453 738#define SEC_CONSTRUCTOR_TEXT 0x1100
fdcb0453 739#define SEC_CONSTRUCTOR_DATA 0x2100
fdcb0453
KR
740#define SEC_CONSTRUCTOR_BSS 0x3100
741
742 /* The section has contents - a data section could be
c188b0be 743 <<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>; a debug section could be
fdcb0453 744 <<SEC_HAS_CONTENTS>> */
fdcb0453
KR
745#define SEC_HAS_CONTENTS 0x200
746
c188b0be
DM
747 /* An instruction to the linker to not output the section
748 even if it has information which would normally be written. */
fdcb0453
KR
749#define SEC_NEVER_LOAD 0x400
750
751 /* The section is a shared library section. The linker must leave
752 these completely alone, as the vma and size are used when
753 the executable is loaded. */
fdcb0453
KR
754#define SEC_SHARED_LIBRARY 0x800
755
756 /* The section is a common section (symbols may be defined
757 multiple times, the value of a symbol is the amount of
758 space it requires, and the largest symbol value is the one
b2ae9efb
KR
759 used). Most targets have exactly one of these (which we
760 translate to bfd_com_section), but ECOFF has two. */
fdcb0453
KR
761#define SEC_IS_COMMON 0x8000
762
9b3fa589
JK
763 /* The section contains only debugging information. For
764 example, this is set for ELF .debug and .stab sections.
765 strip tests this flag to see if a section can be
766 discarded. */
767#define SEC_DEBUGGING 0x10000
768
b2ae9efb
KR
769 /* End of section flags. */
770
fdcb0453 771 /* The virtual memory address of the section - where it will be
b2ae9efb
KR
772 at run time. The symbols are relocated against this. The
773 user_set_vma flag is maintained by bfd; if it's not set, the
774 backend can assign addresses (for example, in <<a.out>>, where
775 the default address for <<.data>> is dependent on the specific
776 target and various flags). */
ef758f3e 777
fdcb0453 778 bfd_vma vma;
b2ae9efb 779 boolean user_set_vma;
fdcb0453
KR
780
781 /* The load address of the section - where it would be in a
c188b0be 782 rom image; really only used for writing section header
b2ae9efb 783 information. */
ef758f3e 784
fdcb0453
KR
785 bfd_vma lma;
786
fdcb0453 787 /* The size of the section in bytes, as it will be output.
c188b0be 788 contains a value even if the section has no contents (e.g., the
fdcb0453
KR
789 size of <<.bss>>). This will be filled in after relocation */
790
791 bfd_size_type _cooked_size;
792
c188b0be 793 /* The original size on disk of the section, in bytes. Normally this
fdcb0453
KR
794 value is the same as the size, but if some relaxing has
795 been done, then this value will be bigger. */
796
797 bfd_size_type _raw_size;
798
799 /* If this section is going to be output, then this value is the
800 offset into the output section of the first byte in the input
c188b0be 801 section. E.g., if this was going to start at the 100th byte in
fdcb0453
KR
802 the output section, this value would be 100. */
803
804 bfd_vma output_offset;
805
806 /* The output section through which to map on output. */
807
808 struct sec *output_section;
809
c188b0be
DM
810 /* The alignment requirement of the section, as an exponent of 2 -
811 e.g., 3 aligns to 2^3 (or 8). */
fdcb0453
KR
812
813 unsigned int alignment_power;
814
815 /* If an input section, a pointer to a vector of relocation
816 records for the data in this section. */
817
818 struct reloc_cache_entry *relocation;
819
820 /* If an output section, a pointer to a vector of pointers to
821 relocation records for the data in this section. */
822
823 struct reloc_cache_entry **orelocation;
824
825 /* The number of relocation records in one of the above */
826
827 unsigned reloc_count;
828
829 /* Information below is back end specific - and not always used
ef758f3e 830 or updated. */
fdcb0453 831
ef758f3e 832 /* File position of section data */
fdcb0453
KR
833
834 file_ptr filepos;
835
836 /* File position of relocation info */
837
838 file_ptr rel_filepos;
839
840 /* File position of line data */
841
842 file_ptr line_filepos;
843
844 /* Pointer to data for applications */
845
846 PTR userdata;
847
848 struct lang_output_section *otheruserdata;
849
850 /* Attached line number information */
851
852 alent *lineno;
853
854 /* Number of line number records */
855
856 unsigned int lineno_count;
857
858 /* When a section is being output, this value changes as more
859 linenumbers are written out */
860
861 file_ptr moving_line_filepos;
862
c188b0be 863 /* What the section number is in the target world */
fdcb0453
KR
864
865 int target_index;
866
867 PTR used_by_bfd;
868
869 /* If this is a constructor section then here is a list of the
870 relocations created to relocate items within it. */
871
872 struct relent_chain *constructor_chain;
873
874 /* The BFD which owns the section. */
875
876 bfd *owner;
877
878 boolean reloc_done;
879 /* A symbol which points at this section only */
880 struct symbol_cache_entry *symbol;
881 struct symbol_cache_entry **symbol_ptr_ptr;
ef758f3e 882
4c3721d5
ILT
883 struct bfd_link_order *link_order_head;
884 struct bfd_link_order *link_order_tail;
fdcb0453
KR
885} asection ;
886
887
b2ae9efb
KR
888 /* These sections are global, and are managed by BFD. The application
889 and target back end are not permitted to change the values in
890 these sections. */
fdcb0453
KR
891#define BFD_ABS_SECTION_NAME "*ABS*"
892#define BFD_UND_SECTION_NAME "*UND*"
893#define BFD_COM_SECTION_NAME "*COM*"
894#define BFD_IND_SECTION_NAME "*IND*"
895
896 /* the absolute section */
ef758f3e 897extern asection bfd_abs_section;
fdcb0453 898 /* Pointer to the undefined section */
ef758f3e 899extern asection bfd_und_section;
fdcb0453 900 /* Pointer to the common section */
ef758f3e 901extern asection bfd_com_section;
fdcb0453 902 /* Pointer to the indirect section */
ef758f3e 903extern asection bfd_ind_section;
fdcb0453 904
ef758f3e
KR
905extern struct symbol_cache_entry *bfd_abs_symbol;
906extern struct symbol_cache_entry *bfd_com_symbol;
907extern struct symbol_cache_entry *bfd_und_symbol;
908extern struct symbol_cache_entry *bfd_ind_symbol;
fdcb0453
KR
909#define bfd_get_section_size_before_reloc(section) \
910 (section->reloc_done ? (abort(),1): (section)->_raw_size)
911#define bfd_get_section_size_after_reloc(section) \
912 ((section->reloc_done) ? (section)->_cooked_size: (abort(),1))
913asection *
914bfd_get_section_by_name PARAMS ((bfd *abfd, CONST char *name));
915
916asection *
c188b0be 917bfd_make_section_old_way PARAMS ((bfd *abfd, CONST char *name));
fdcb0453 918
9b3fa589 919asection *
c188b0be 920bfd_make_section_anyway PARAMS ((bfd *abfd, CONST char *name));
9b3fa589
JK
921
922asection *
fdcb0453
KR
923bfd_make_section PARAMS ((bfd *, CONST char *name));
924
925boolean
c188b0be 926bfd_set_section_flags PARAMS ((bfd *abfd, asection *sec, flagword flags));
fdcb0453
KR
927
928void
929bfd_map_over_sections PARAMS ((bfd *abfd,
930 void (*func)(bfd *abfd,
931 asection *sect,
932 PTR obj),
933 PTR obj));
934
935boolean
c188b0be 936bfd_set_section_size PARAMS ((bfd *abfd, asection *sec, bfd_size_type val));
fdcb0453
KR
937
938boolean
939bfd_set_section_contents
940 PARAMS ((bfd *abfd,
941 asection *section,
942 PTR data,
943 file_ptr offset,
944 bfd_size_type count));
945
946boolean
947bfd_get_section_contents
948 PARAMS ((bfd *abfd, asection *section, PTR location,
949 file_ptr offset, bfd_size_type count));
950
951enum bfd_architecture
952{
953 bfd_arch_unknown, /* File arch not known */
954 bfd_arch_obscure, /* Arch known, not one of these */
955 bfd_arch_m68k, /* Motorola 68xxx */
956 bfd_arch_vax, /* DEC Vax */
957 bfd_arch_i960, /* Intel 960 */
958 /* The order of the following is important.
959 lower number indicates a machine type that
960 only accepts a subset of the instructions
961 available to machines with higher numbers.
962 The exception is the "ca", which is
963 incompatible with all other machines except
964 "core". */
965
966#define bfd_mach_i960_core 1
967#define bfd_mach_i960_ka_sa 2
968#define bfd_mach_i960_kb_sb 3
969#define bfd_mach_i960_mc 4
970#define bfd_mach_i960_xa 5
971#define bfd_mach_i960_ca 6
972
973 bfd_arch_a29k, /* AMD 29000 */
974 bfd_arch_sparc, /* SPARC */
975 bfd_arch_mips, /* MIPS Rxxxx */
976 bfd_arch_i386, /* Intel 386 */
977 bfd_arch_we32k, /* AT&T WE32xxx */
978 bfd_arch_tahoe, /* CCI/Harris Tahoe */
979 bfd_arch_i860, /* Intel 860 */
980 bfd_arch_romp, /* IBM ROMP PC/RT */
981 bfd_arch_alliant, /* Alliant */
982 bfd_arch_convex, /* Convex */
983 bfd_arch_m88k, /* Motorola 88xxx */
984 bfd_arch_pyramid, /* Pyramid Technology */
985 bfd_arch_h8300, /* Hitachi H8/300 */
986#define bfd_mach_h8300 1
987#define bfd_mach_h8300h 2
988 bfd_arch_rs6000, /* IBM RS/6000 */
989 bfd_arch_hppa, /* HP PA RISC */
990 bfd_arch_z8k, /* Zilog Z8000 */
991#define bfd_mach_z8001 1
992#define bfd_mach_z8002 2
993 bfd_arch_h8500, /* Hitachi H8/500 */
994 bfd_arch_sh, /* Hitachi SH */
995 bfd_arch_alpha, /* Dec Alpha */
996 bfd_arch_last
997 };
998
999typedef struct bfd_arch_info
1000{
1001 int bits_per_word;
1002 int bits_per_address;
1003 int bits_per_byte;
1004 enum bfd_architecture arch;
1005 long mach;
1006 char *arch_name;
1007 CONST char *printable_name;
1008 unsigned int section_align_power;
1009 /* true if this is the default machine for the architecture */
1010 boolean the_default;
1011 CONST struct bfd_arch_info * (*compatible)
1012 PARAMS ((CONST struct bfd_arch_info *a,
1013 CONST struct bfd_arch_info *b));
1014
1015 boolean (*scan) PARAMS ((CONST struct bfd_arch_info *, CONST char *));
1016 /* How to disassemble an instruction, producing a printable
1017 representation on a specified stdio stream. This isn't
1018 defined for most processors at present, because of the size
1019 of the additional tables it would drag in, and because gdb
1020 wants to use a different interface. */
1021 unsigned int (*disassemble) PARAMS ((bfd_vma addr, CONST char *data,
1022 PTR stream));
1023
1024 struct bfd_arch_info *next;
1025} bfd_arch_info_type;
1026CONST char *
1027bfd_printable_name PARAMS ((bfd *abfd));
1028
1029bfd_arch_info_type *
c188b0be 1030bfd_scan_arch PARAMS ((CONST char *string));
fdcb0453
KR
1031
1032CONST bfd_arch_info_type *
1033bfd_arch_get_compatible PARAMS ((
1034 CONST bfd *abfd,
1035 CONST bfd *bbfd));
1036
1037void
c188b0be 1038bfd_set_arch_info PARAMS ((bfd *abfd, bfd_arch_info_type *arg));
fdcb0453
KR
1039
1040enum bfd_architecture
1041bfd_get_arch PARAMS ((bfd *abfd));
1042
1043unsigned long
1044bfd_get_mach PARAMS ((bfd *abfd));
1045
1046unsigned int
1047bfd_arch_bits_per_byte PARAMS ((bfd *abfd));
1048
1049unsigned int
1050bfd_arch_bits_per_address PARAMS ((bfd *abfd));
1051
1052bfd_arch_info_type *
c188b0be 1053bfd_get_arch_info PARAMS ((bfd *abfd));
fdcb0453
KR
1054
1055bfd_arch_info_type *
1056bfd_lookup_arch
1057 PARAMS ((enum bfd_architecture
1058 arch,
1059 long machine));
1060
c188b0be 1061CONST char *
fdcb0453
KR
1062bfd_printable_arch_mach
1063 PARAMS ((enum bfd_architecture arch, unsigned long machine));
1064
1065typedef enum bfd_reloc_status
1066{
1067 /* No errors detected */
1068 bfd_reloc_ok,
1069
1070 /* The relocation was performed, but there was an overflow. */
1071 bfd_reloc_overflow,
1072
1073 /* The address to relocate was not within the section supplied. */
1074 bfd_reloc_outofrange,
1075
1076 /* Used by special functions */
1077 bfd_reloc_continue,
1078
c188b0be 1079 /* Unsupported relocation size requested. */
fdcb0453
KR
1080 bfd_reloc_notsupported,
1081
c188b0be 1082 /* Unused */
fdcb0453
KR
1083 bfd_reloc_other,
1084
1085 /* The symbol to relocate against was undefined. */
1086 bfd_reloc_undefined,
1087
1088 /* The relocation was performed, but may not be ok - presently
1089 generated only when linking i960 coff files with i960 b.out
4c3721d5
ILT
1090 symbols. If this type is returned, the error_message argument
1091 to bfd_perform_relocation will be set. */
fdcb0453
KR
1092 bfd_reloc_dangerous
1093 }
1094 bfd_reloc_status_type;
1095
1096
1097typedef struct reloc_cache_entry
1098{
1099 /* A pointer into the canonical table of pointers */
1100 struct symbol_cache_entry **sym_ptr_ptr;
1101
1102 /* offset in section */
1103 bfd_size_type address;
1104
1105 /* addend for relocation value */
1106 bfd_vma addend;
1107
1108 /* Pointer to how to perform the required relocation */
e2756048 1109 const struct reloc_howto_struct *howto;
fdcb0453
KR
1110
1111} arelent;
66a277ab
ILT
1112enum complain_overflow
1113{
1114 /* Do not complain on overflow. */
1115 complain_overflow_dont,
1116
1117 /* Complain if the bitfield overflows, whether it is considered
1118 as signed or unsigned. */
1119 complain_overflow_bitfield,
1120
1121 /* Complain if the value overflows when considered as signed
1122 number. */
1123 complain_overflow_signed,
1124
1125 /* Complain if the value overflows when considered as an
1126 unsigned number. */
1127 complain_overflow_unsigned
1128};
fdcb0453 1129
c188b0be 1130typedef struct reloc_howto_struct
fdcb0453
KR
1131{
1132 /* The type field has mainly a documetary use - the back end can
c188b0be
DM
1133 do what it wants with it, though normally the back end's
1134 external idea of what a reloc number is stored
1135 in this field. For example, a PC relative word relocation
1136 in a coff environment has the type 023 - because that's
fdcb0453
KR
1137 what the outside world calls a R_PCRWORD reloc. */
1138 unsigned int type;
1139
1140 /* The value the final relocation is shifted right by. This drops
1141 unwanted data from the relocation. */
1142 unsigned int rightshift;
1143
9e461dac 1144 /* The size of the item to be relocated. This is *not* a
4c3721d5
ILT
1145 power-of-two measure. To get the number of bytes operated
1146 on by a type of relocation, use bfd_get_reloc_size. */
fdcb0453
KR
1147 int size;
1148
66a277ab
ILT
1149 /* The number of bits in the item to be relocated. This is used
1150 when doing overflow checking. */
fdcb0453
KR
1151 unsigned int bitsize;
1152
1153 /* Notes that the relocation is relative to the location in the
1154 data section of the addend. The relocation function will
1155 subtract from the relocation value the address of the location
1156 being relocated. */
1157 boolean pc_relative;
1158
66a277ab
ILT
1159 /* The bit position of the reloc value in the destination.
1160 The relocated value is left shifted by this amount. */
fdcb0453
KR
1161 unsigned int bitpos;
1162
66a277ab
ILT
1163 /* What type of overflow error should be checked for when
1164 relocating. */
1165 enum complain_overflow complain_on_overflow;
fdcb0453
KR
1166
1167 /* If this field is non null, then the supplied function is
1168 called rather than the normal function. This allows really
1169 strange relocation methods to be accomodated (e.g., i960 callj
1170 instructions). */
1171 bfd_reloc_status_type (*special_function)
1172 PARAMS ((bfd *abfd,
1173 arelent *reloc_entry,
1174 struct symbol_cache_entry *symbol,
1175 PTR data,
1176 asection *input_section,
4c3721d5
ILT
1177 bfd *output_bfd,
1178 char **error_message));
fdcb0453
KR
1179
1180 /* The textual name of the relocation type. */
1181 char *name;
1182
1183 /* When performing a partial link, some formats must modify the
1184 relocations rather than the data - this flag signals this.*/
1185 boolean partial_inplace;
1186
c188b0be 1187 /* The src_mask selects which parts of the read in data
fdcb0453
KR
1188 are to be used in the relocation sum. E.g., if this was an 8 bit
1189 bit of data which we read and relocated, this would be
1190 0x000000ff. When we have relocs which have an addend, such as
1191 sun4 extended relocs, the value in the offset part of a
1192 relocating field is garbage so we never use it. In this case
1193 the mask would be 0x00000000. */
1194 bfd_vma src_mask;
1195
c188b0be 1196 /* The dst_mask selects which parts of the instruction are replaced
fdcb0453
KR
1197 into the instruction. In most cases src_mask == dst_mask,
1198 except in the above special case, where dst_mask would be
1199 0x000000ff, and src_mask would be 0x00000000. */
1200 bfd_vma dst_mask;
1201
1202 /* When some formats create PC relative instructions, they leave
1203 the value of the pc of the place being relocated in the offset
1204 slot of the instruction, so that a PC relative relocation can
1205 be made just by adding in an ordinary offset (e.g., sun3 a.out).
1206 Some formats leave the displacement part of an instruction
c188b0be 1207 empty (e.g., m88k bcs); this flag signals the fact.*/
fdcb0453
KR
1208 boolean pcrel_offset;
1209
1210} reloc_howto_type;
66a277ab
ILT
1211#define HOWTO(C, R,S,B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
1212 {(unsigned)C,R,S,B, P, BI, O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC}
1213#define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,complain_overflow_dont,FUNCTION, NAME,false,0,0,IN)
fdcb0453
KR
1214
1215#define HOWTO_PREPARE(relocation, symbol) \
1216 { \
1217 if (symbol != (asymbol *)NULL) { \
1218 if (bfd_is_com_section (symbol->section)) { \
1219 relocation = 0; \
1220 } \
1221 else { \
1222 relocation = symbol->value; \
1223 } \
1224 } \
1225}
4c3721d5
ILT
1226int
1227bfd_get_reloc_size PARAMS ((const reloc_howto_type *));
1228
fdcb0453
KR
1229typedef unsigned char bfd_byte;
1230
1231typedef struct relent_chain {
1232 arelent relent;
1233 struct relent_chain *next;
1234} arelent_chain;
1235bfd_reloc_status_type
1236
1237bfd_perform_relocation
c188b0be 1238 PARAMS ((bfd *abfd,
fdcb0453
KR
1239 arelent *reloc_entry,
1240 PTR data,
1241 asection *input_section,
4c3721d5
ILT
1242 bfd *output_bfd,
1243 char **error_message));
fdcb0453
KR
1244
1245typedef enum bfd_reloc_code_real
fdcb0453 1246{
9e461dac 1247 /* Basic absolute relocations */
fa5ba217 1248 BFD_RELOC_64,
fa5ba217 1249 BFD_RELOC_32,
fdcb0453 1250 BFD_RELOC_16,
fdcb0453 1251 BFD_RELOC_8,
9e461dac
JK
1252
1253 /* PC-relative relocations */
1254 BFD_RELOC_64_PCREL,
1255 BFD_RELOC_32_PCREL,
1256 BFD_RELOC_24_PCREL, /* used by i960 */
1257 BFD_RELOC_16_PCREL,
fdcb0453 1258 BFD_RELOC_8_PCREL,
9e461dac
JK
1259
1260 /* Linkage-table relative */
1261 BFD_RELOC_32_BASEREL,
1262 BFD_RELOC_16_BASEREL,
1263 BFD_RELOC_8_BASEREL,
fdcb0453 1264
ef758f3e
KR
1265 /* The type of reloc used to build a contructor table - at the moment
1266 probably a 32 bit wide abs address, but the cpu can choose. */
fdcb0453
KR
1267 BFD_RELOC_CTOR,
1268
9e461dac
JK
1269 /* 8 bits wide, but used to form an address like 0xffnn */
1270 BFD_RELOC_8_FFnn,
1271
1272 /* 32-bit pc-relative, shifted right 2 bits (i.e., 30-bit
1273 word displacement, e.g. for SPARC) */
1274 BFD_RELOC_32_PCREL_S2,
1275
1276 /* High 22 bits of 32-bit value, placed into lower 22 bits of
1277 target word; simple reloc. */
fdcb0453 1278 BFD_RELOC_HI22,
ef758f3e 1279 /* Low 10 bits. */
fdcb0453
KR
1280 BFD_RELOC_LO10,
1281
ef758f3e 1282 /* Reloc types used for i960/b.out. */
fdcb0453
KR
1283 BFD_RELOC_I960_CALLJ,
1284
fdcb0453
KR
1285 /* now for the sparc/elf codes */
1286 BFD_RELOC_NONE, /* actually used */
1287 BFD_RELOC_SPARC_WDISP22,
1288 BFD_RELOC_SPARC22,
1289 BFD_RELOC_SPARC13,
fdcb0453
KR
1290 BFD_RELOC_SPARC_GOT10,
1291 BFD_RELOC_SPARC_GOT13,
1292 BFD_RELOC_SPARC_GOT22,
1293 BFD_RELOC_SPARC_PC10,
1294 BFD_RELOC_SPARC_PC22,
1295 BFD_RELOC_SPARC_WPLT30,
1296 BFD_RELOC_SPARC_COPY,
1297 BFD_RELOC_SPARC_GLOB_DAT,
1298 BFD_RELOC_SPARC_JMP_SLOT,
1299 BFD_RELOC_SPARC_RELATIVE,
1300 BFD_RELOC_SPARC_UA32,
1301
ef758f3e 1302 /* these are a.out specific? */
5284a822 1303 BFD_RELOC_SPARC_BASE13,
fdcb0453
KR
1304 BFD_RELOC_SPARC_BASE22,
1305
fa5ba217 1306 /* start-sanitize-v9 */
fa5ba217
KR
1307 BFD_RELOC_SPARC_10,
1308 BFD_RELOC_SPARC_11,
1309#define BFD_RELOC_SPARC_64 BFD_RELOC_64
1310 BFD_RELOC_SPARC_OLO10,
1311 BFD_RELOC_SPARC_HH22,
1312 BFD_RELOC_SPARC_HM10,
1313 BFD_RELOC_SPARC_LM22,
1314 BFD_RELOC_SPARC_PC_HH22,
1315 BFD_RELOC_SPARC_PC_HM10,
1316 BFD_RELOC_SPARC_PC_LM22,
1317 BFD_RELOC_SPARC_WDISP16,
5284a822 1318 BFD_RELOC_SPARC_WDISP19,
fa5ba217
KR
1319 BFD_RELOC_SPARC_GLOB_JMP,
1320 BFD_RELOC_SPARC_LO7,
1321 /* end-sanitize-v9 */
5284a822 1322
ef758f3e
KR
1323 /* Bits 27..2 of the relocation address shifted right 2 bits;
1324 simple reloc otherwise. */
fdcb0453
KR
1325 BFD_RELOC_MIPS_JMP,
1326
ef758f3e 1327 /* signed 16-bit pc-relative, shifted right 2 bits (e.g. for MIPS) */
fdcb0453
KR
1328 BFD_RELOC_16_PCREL_S2,
1329
ef758f3e 1330 /* High 16 bits of 32-bit value; simple reloc. */
fdcb0453 1331 BFD_RELOC_HI16,
ef758f3e
KR
1332 /* High 16 bits of 32-bit value but the low 16 bits will be sign
1333 extended and added to form the final result. If the low 16
1334 bits form a negative number, we need to add one to the high value
1335 to compensate for the borrow when the low bits are added. */
fdcb0453 1336 BFD_RELOC_HI16_S,
ef758f3e 1337 /* Low 16 bits. */
fdcb0453
KR
1338 BFD_RELOC_LO16,
1339
ef758f3e 1340 /* 16 bit relocation relative to the global pointer. */
fdcb0453
KR
1341 BFD_RELOC_MIPS_GPREL,
1342
0a197a96
JG
1343 /* Relocation against a MIPS literal section. */
1344 BFD_RELOC_MIPS_LITERAL,
1345
1346 /* MIPS ELF relocations. */
1347 BFD_RELOC_MIPS_GOT16,
1348 BFD_RELOC_MIPS_CALL16,
1349 BFD_RELOC_MIPS_GPREL32,
1350
ef758f3e
KR
1351 /* These are, so far, specific to HPPA processors. I'm not sure that some
1352 don't duplicate other reloc types, such as BFD_RELOC_32 and _32_PCREL.
1353 Also, many more were in the list I got that don't fit in well in the
1354 model BFD uses, so I've omitted them for now. If we do make this reloc
1355 type get used for code that really does implement the funky reloc types,
1356 they'll have to be added to this list. */
fdcb0453
KR
1357 BFD_RELOC_HPPA_32,
1358 BFD_RELOC_HPPA_11,
1359 BFD_RELOC_HPPA_14,
1360 BFD_RELOC_HPPA_17,
ef758f3e 1361
fdcb0453
KR
1362 BFD_RELOC_HPPA_L21,
1363 BFD_RELOC_HPPA_R11,
1364 BFD_RELOC_HPPA_R14,
1365 BFD_RELOC_HPPA_R17,
1366 BFD_RELOC_HPPA_LS21,
1367 BFD_RELOC_HPPA_RS11,
1368 BFD_RELOC_HPPA_RS14,
1369 BFD_RELOC_HPPA_RS17,
1370 BFD_RELOC_HPPA_LD21,
1371 BFD_RELOC_HPPA_RD11,
1372 BFD_RELOC_HPPA_RD14,
1373 BFD_RELOC_HPPA_RD17,
1374 BFD_RELOC_HPPA_LR21,
1375 BFD_RELOC_HPPA_RR14,
1376 BFD_RELOC_HPPA_RR17,
ef758f3e 1377
fdcb0453
KR
1378 BFD_RELOC_HPPA_GOTOFF_11,
1379 BFD_RELOC_HPPA_GOTOFF_14,
1380 BFD_RELOC_HPPA_GOTOFF_L21,
1381 BFD_RELOC_HPPA_GOTOFF_R11,
1382 BFD_RELOC_HPPA_GOTOFF_R14,
1383 BFD_RELOC_HPPA_GOTOFF_LS21,
1384 BFD_RELOC_HPPA_GOTOFF_RS11,
1385 BFD_RELOC_HPPA_GOTOFF_RS14,
1386 BFD_RELOC_HPPA_GOTOFF_LD21,
1387 BFD_RELOC_HPPA_GOTOFF_RD11,
1388 BFD_RELOC_HPPA_GOTOFF_RD14,
1389 BFD_RELOC_HPPA_GOTOFF_LR21,
1390 BFD_RELOC_HPPA_GOTOFF_RR14,
ef758f3e 1391
fdcb0453
KR
1392 BFD_RELOC_HPPA_DLT_32,
1393 BFD_RELOC_HPPA_DLT_11,
1394 BFD_RELOC_HPPA_DLT_14,
1395 BFD_RELOC_HPPA_DLT_L21,
1396 BFD_RELOC_HPPA_DLT_R11,
1397 BFD_RELOC_HPPA_DLT_R14,
ef758f3e 1398
fdcb0453
KR
1399 BFD_RELOC_HPPA_ABS_CALL_11,
1400 BFD_RELOC_HPPA_ABS_CALL_14,
1401 BFD_RELOC_HPPA_ABS_CALL_17,
1402 BFD_RELOC_HPPA_ABS_CALL_L21,
1403 BFD_RELOC_HPPA_ABS_CALL_R11,
1404 BFD_RELOC_HPPA_ABS_CALL_R14,
1405 BFD_RELOC_HPPA_ABS_CALL_R17,
1406 BFD_RELOC_HPPA_ABS_CALL_LS21,
1407 BFD_RELOC_HPPA_ABS_CALL_RS11,
1408 BFD_RELOC_HPPA_ABS_CALL_RS14,
1409 BFD_RELOC_HPPA_ABS_CALL_RS17,
1410 BFD_RELOC_HPPA_ABS_CALL_LD21,
1411 BFD_RELOC_HPPA_ABS_CALL_RD11,
1412 BFD_RELOC_HPPA_ABS_CALL_RD14,
1413 BFD_RELOC_HPPA_ABS_CALL_RD17,
1414 BFD_RELOC_HPPA_ABS_CALL_LR21,
1415 BFD_RELOC_HPPA_ABS_CALL_RR14,
1416 BFD_RELOC_HPPA_ABS_CALL_RR17,
ef758f3e 1417
fdcb0453
KR
1418 BFD_RELOC_HPPA_PCREL_CALL_11,
1419 BFD_RELOC_HPPA_PCREL_CALL_12,
1420 BFD_RELOC_HPPA_PCREL_CALL_14,
1421 BFD_RELOC_HPPA_PCREL_CALL_17,
1422 BFD_RELOC_HPPA_PCREL_CALL_L21,
1423 BFD_RELOC_HPPA_PCREL_CALL_R11,
1424 BFD_RELOC_HPPA_PCREL_CALL_R14,
1425 BFD_RELOC_HPPA_PCREL_CALL_R17,
1426 BFD_RELOC_HPPA_PCREL_CALL_LS21,
1427 BFD_RELOC_HPPA_PCREL_CALL_RS11,
1428 BFD_RELOC_HPPA_PCREL_CALL_RS14,
1429 BFD_RELOC_HPPA_PCREL_CALL_RS17,
1430 BFD_RELOC_HPPA_PCREL_CALL_LD21,
1431 BFD_RELOC_HPPA_PCREL_CALL_RD11,
1432 BFD_RELOC_HPPA_PCREL_CALL_RD14,
1433 BFD_RELOC_HPPA_PCREL_CALL_RD17,
1434 BFD_RELOC_HPPA_PCREL_CALL_LR21,
1435 BFD_RELOC_HPPA_PCREL_CALL_RR14,
1436 BFD_RELOC_HPPA_PCREL_CALL_RR17,
ef758f3e 1437
fdcb0453
KR
1438 BFD_RELOC_HPPA_PLABEL_32,
1439 BFD_RELOC_HPPA_PLABEL_11,
1440 BFD_RELOC_HPPA_PLABEL_14,
1441 BFD_RELOC_HPPA_PLABEL_L21,
1442 BFD_RELOC_HPPA_PLABEL_R11,
1443 BFD_RELOC_HPPA_PLABEL_R14,
ef758f3e 1444
fdcb0453
KR
1445 BFD_RELOC_HPPA_UNWIND_ENTRY,
1446 BFD_RELOC_HPPA_UNWIND_ENTRIES,
1447
b66b07a2
KR
1448 /* i386/elf relocations */
1449 BFD_RELOC_386_GOT32,
1450 BFD_RELOC_386_PLT32,
1451 BFD_RELOC_386_COPY,
1452 BFD_RELOC_386_GLOB_DAT,
1453 BFD_RELOC_386_JUMP_SLOT,
1454 BFD_RELOC_386_RELATIVE,
1455 BFD_RELOC_386_GOTOFF,
1456 BFD_RELOC_386_GOTPC,
1457
fdcb0453
KR
1458 /* this must be the highest numeric value */
1459 BFD_RELOC_UNUSED
1460 } bfd_reloc_code_real_type;
e2756048 1461const struct reloc_howto_struct *
fdcb0453
KR
1462
1463bfd_reloc_type_lookup PARAMS ((bfd *abfd, bfd_reloc_code_real_type code));
1464
ef758f3e 1465
fdcb0453
KR
1466typedef struct symbol_cache_entry
1467{
1468 /* A pointer to the BFD which owns the symbol. This information
1469 is necessary so that a back end can work out what additional
1470 information (invisible to the application writer) is carried
1471 with the symbol.
1472
1473 This field is *almost* redundant, since you can use section->owner
1474 instead, except that some symbols point to the global sections
1475 bfd_{abs,com,und}_section. This could be fixed by making
1476 these globals be per-bfd (or per-target-flavor). FIXME. */
1477
1478 struct _bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field. */
1479
c188b0be 1480 /* The text of the symbol. The name is left alone, and not copied; the
fdcb0453
KR
1481 application may not alter it. */
1482 CONST char *name;
1483
1484 /* The value of the symbol. This really should be a union of a
1485 numeric value with a pointer, since some flags indicate that
1486 a pointer to another symbol is stored here. */
1487 symvalue value;
1488
1489 /* Attributes of a symbol: */
1490
1491#define BSF_NO_FLAGS 0x00
1492
1493 /* The symbol has local scope; <<static>> in <<C>>. The value
1494 is the offset into the section of the data. */
1495#define BSF_LOCAL 0x01
1496
1497 /* The symbol has global scope; initialized data in <<C>>. The
1498 value is the offset into the section of the data. */
1499#define BSF_GLOBAL 0x02
1500
c188b0be 1501 /* The symbol has global scope and is exported. The value is
fdcb0453 1502 the offset into the section of the data. */
ef758f3e 1503#define BSF_EXPORT BSF_GLOBAL /* no real difference */
fdcb0453
KR
1504
1505 /* A normal C symbol would be one of:
1506 <<BSF_LOCAL>>, <<BSF_FORT_COMM>>, <<BSF_UNDEFINED>> or
ef758f3e 1507 <<BSF_GLOBAL>> */
fdcb0453
KR
1508
1509 /* The symbol is a debugging record. The value has an arbitary
1510 meaning. */
1511#define BSF_DEBUGGING 0x08
1512
1513 /* The symbol denotes a function entry point. Used in ELF,
1514 perhaps others someday. */
1515#define BSF_FUNCTION 0x10
1516
1517 /* Used by the linker. */
1518#define BSF_KEEP 0x20
1519#define BSF_KEEP_G 0x40
1520
b66b07a2
KR
1521 /* A weak global symbol, overridable without warnings by
1522 a regular global symbol of the same name. */
fdcb0453
KR
1523#define BSF_WEAK 0x80
1524
1525 /* This symbol was created to point to a section, e.g. ELF's
1526 STT_SECTION symbols. */
1527#define BSF_SECTION_SYM 0x100
1528
1529 /* The symbol used to be a common symbol, but now it is
1530 allocated. */
1531#define BSF_OLD_COMMON 0x200
1532
1533 /* The default value for common data. */
1534#define BFD_FORT_COMM_DEFAULT_VALUE 0
1535
1536 /* In some files the type of a symbol sometimes alters its
1537 location in an output file - ie in coff a <<ISFCN>> symbol
1538 which is also <<C_EXT>> symbol appears where it was
1539 declared and not at the end of a section. This bit is set
1540 by the target BFD part to convey this information. */
1541
1542#define BSF_NOT_AT_END 0x400
1543
1544 /* Signal that the symbol is the label of constructor section. */
1545#define BSF_CONSTRUCTOR 0x800
1546
1547 /* Signal that the symbol is a warning symbol. If the symbol
1548 is a warning symbol, then the value field (I know this is
1549 tacky) will point to the asymbol which when referenced will
1550 cause the warning. */
1551#define BSF_WARNING 0x1000
1552
1553 /* Signal that the symbol is indirect. The value of the symbol
1554 is a pointer to an undefined asymbol which contains the
1555 name to use instead. */
1556#define BSF_INDIRECT 0x2000
1557
1558 /* BSF_FILE marks symbols that contain a file name. This is used
1559 for ELF STT_FILE symbols. */
1560#define BSF_FILE 0x4000
1561
1562 flagword flags;
1563
1564 /* A pointer to the section to which this symbol is
1565 relative. This will always be non NULL, there are special
1566 sections for undefined and absolute symbols */
1567 struct sec *section;
1568
1569 /* Back end special data. This is being phased out in favour
1570 of making this a union. */
1571 PTR udata;
1572
1573} asymbol;
1574#define get_symtab_upper_bound(abfd) \
1575 BFD_SEND (abfd, _get_symtab_upper_bound, (abfd))
1576#define bfd_canonicalize_symtab(abfd, location) \
1577 BFD_SEND (abfd, _bfd_canonicalize_symtab,\
1578 (abfd, location))
1579boolean
c188b0be 1580bfd_set_symtab PARAMS ((bfd *abfd, asymbol **location, unsigned int count));
fdcb0453
KR
1581
1582void
1583bfd_print_symbol_vandf PARAMS ((PTR file, asymbol *symbol));
1584
1585#define bfd_make_empty_symbol(abfd) \
1586 BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
1587#define bfd_make_debug_symbol(abfd,ptr,size) \
1588 BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
1589int
1590bfd_decode_symclass PARAMS ((asymbol *symbol));
1591
1592void
1593bfd_symbol_info PARAMS ((asymbol *symbol, symbol_info *ret));
1594
1595struct _bfd
1596{
1597 /* The filename the application opened the BFD with. */
1598 CONST char *filename;
1599
1600 /* A pointer to the target jump table. */
1601 struct bfd_target *xvec;
1602
1603 /* To avoid dragging too many header files into every file that
1604 includes `<<bfd.h>>', IOSTREAM has been declared as a "char
1605 *", and MTIME as a "long". Their correct types, to which they
1606 are cast when used, are "FILE *" and "time_t". The iostream
1607 is the result of an fopen on the filename. */
1608 char *iostream;
1609
0a197a96
JG
1610 /* Is the file descriptor being cached? That is, can it be closed as
1611 needed, and re-opened when accessed later? */
fdcb0453
KR
1612
1613 boolean cacheable;
1614
1615 /* Marks whether there was a default target specified when the
c188b0be
DM
1616 BFD was opened. This is used to select which matching algorithm
1617 to use to choose the back end. */
fdcb0453
KR
1618
1619 boolean target_defaulted;
1620
1621 /* The caching routines use these to maintain a
1622 least-recently-used list of BFDs */
1623
1624 struct _bfd *lru_prev, *lru_next;
1625
1626 /* When a file is closed by the caching routines, BFD retains
c188b0be 1627 state information on the file here: */
fdcb0453
KR
1628
1629 file_ptr where;
1630
c188b0be 1631 /* and here: (``once'' means at least once) */
fdcb0453
KR
1632
1633 boolean opened_once;
1634
1635 /* Set if we have a locally maintained mtime value, rather than
1636 getting it from the file each time: */
1637
1638 boolean mtime_set;
1639
1640 /* File modified time, if mtime_set is true: */
1641
1642 long mtime;
1643
1644 /* Reserved for an unimplemented file locking extension.*/
1645
1646 int ifd;
1647
c188b0be 1648 /* The format which belongs to the BFD. (object, core, etc.) */
fdcb0453
KR
1649
1650 bfd_format format;
1651
1652 /* The direction the BFD was opened with*/
1653
1654 enum bfd_direction {no_direction = 0,
1655 read_direction = 1,
1656 write_direction = 2,
1657 both_direction = 3} direction;
1658
1659 /* Format_specific flags*/
1660
1661 flagword flags;
1662
1663 /* Currently my_archive is tested before adding origin to
1664 anything. I believe that this can become always an add of
1665 origin, with origin set to 0 for non archive files. */
1666
1667 file_ptr origin;
1668
1669 /* Remember when output has begun, to stop strange things
c188b0be 1670 from happening. */
fdcb0453
KR
1671 boolean output_has_begun;
1672
1673 /* Pointer to linked list of sections*/
1674 struct sec *sections;
1675
1676 /* The number of sections */
1677 unsigned int section_count;
1678
1679 /* Stuff only useful for object files:
1680 The start address. */
1681 bfd_vma start_address;
1682
1683 /* Used for input and output*/
1684 unsigned int symcount;
1685
c188b0be 1686 /* Symbol table for output BFD (with symcount entries) */
fdcb0453
KR
1687 struct symbol_cache_entry **outsymbols;
1688
1689 /* Pointer to structure which contains architecture information*/
1690 struct bfd_arch_info *arch_info;
1691
1692 /* Stuff only useful for archives:*/
1693 PTR arelt_data;
c188b0be
DM
1694 struct _bfd *my_archive; /* The containing archive BFD. */
1695 struct _bfd *next; /* The next BFD in the archive. */
1696 struct _bfd *archive_head; /* The first BFD in the archive. */
fdcb0453
KR
1697 boolean has_armap;
1698
4c3721d5
ILT
1699 /* A chain of BFD structures involved in a link. */
1700 struct _bfd *link_next;
1701
1702 /* A field used by _bfd_generic_link_add_archive_symbols. This will
1703 be used only for archive elements. */
1704 int archive_pass;
1705
fdcb0453
KR
1706 /* Used by the back end to hold private data. */
1707
1708 union
1709 {
1710 struct aout_data_struct *aout_data;
1711 struct artdata *aout_ar_data;
1712 struct _oasys_data *oasys_obj_data;
1713 struct _oasys_ar_data *oasys_ar_data;
1714 struct coff_tdata *coff_obj_data;
1715 struct ecoff_tdata *ecoff_obj_data;
1716 struct ieee_data_struct *ieee_data;
1717 struct ieee_ar_data_struct *ieee_ar_data;
1718 struct srec_data_struct *srec_data;
1719 struct tekhex_data_struct *tekhex_data;
1720 struct elf_obj_tdata *elf_obj_data;
c3e964b9 1721 struct nlm_obj_tdata *nlm_obj_data;
fdcb0453
KR
1722 struct bout_data_struct *bout_data;
1723 struct sun_core_struct *sun_core_data;
1724 struct trad_core_struct *trad_core_data;
9e461dac 1725 struct som_data_struct *som_data;
b66b07a2 1726 struct hpux_core_struct *hpux_core_data;
8d12f138 1727 struct hppabsd_core_struct *hppabsd_core_data;
fdcb0453 1728 struct sgi_core_struct *sgi_core_data;
2b91cc45 1729 struct lynx_core_struct *lynx_core_data;
9b3fa589 1730 struct osf_core_struct *osf_core_data;
fdcb0453
KR
1731 PTR any;
1732 } tdata;
1733
1734 /* Used by the application to hold private data*/
1735 PTR usrdata;
1736
1737 /* Where all the allocated stuff under this BFD goes */
1738 struct obstack memory;
fdcb0453
KR
1739};
1740
e2756048
ILT
1741unsigned int
1742bfd_get_reloc_upper_bound PARAMS ((bfd *abfd, asection *sect));
1743
1744unsigned int
1745bfd_canonicalize_reloc
1746 PARAMS ((bfd *abfd,
1747 asection *sec,
1748 arelent **loc,
1749 asymbol **syms));
1750
1751void
1752bfd_set_reloc
1753 PARAMS ((bfd *abfd, asection *sec, arelent **rel, unsigned int count)
1754
1755 );
1756
fdcb0453
KR
1757boolean
1758bfd_set_file_flags PARAMS ((bfd *abfd, flagword flags));
1759
fdcb0453 1760boolean
c188b0be 1761bfd_set_start_address PARAMS ((bfd *abfd, bfd_vma vma));
fdcb0453
KR
1762
1763long
c188b0be 1764bfd_get_mtime PARAMS ((bfd *abfd));
fdcb0453
KR
1765
1766long
c188b0be 1767bfd_get_size PARAMS ((bfd *abfd));
fdcb0453
KR
1768
1769int
c188b0be 1770bfd_get_gp_size PARAMS ((bfd *abfd));
fdcb0453
KR
1771
1772void
c188b0be 1773bfd_set_gp_size PARAMS ((bfd *abfd, int i));
fdcb0453 1774
ef758f3e
KR
1775bfd_vma
1776bfd_scan_vma PARAMS ((CONST char *string, CONST char **end, int base));
1777
fdcb0453
KR
1778#define bfd_sizeof_headers(abfd, reloc) \
1779 BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc))
1780
1781#define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1782 BFD_SEND (abfd, _bfd_find_nearest_line, (abfd, sec, syms, off, file, func, line))
1783
1784 /* Do these three do anything useful at all, for any back end? */
1785#define bfd_debug_info_start(abfd) \
1786 BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1787
1788#define bfd_debug_info_end(abfd) \
1789 BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1790
1791#define bfd_debug_info_accumulate(abfd, section) \
1792 BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1793
1794
1795#define bfd_stat_arch_elt(abfd, stat) \
1796 BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
1797
1798#define bfd_set_arch_mach(abfd, arch, mach)\
1799 BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
1800
4c3721d5
ILT
1801#define bfd_get_relocated_section_contents(abfd, link_info, link_order, data, relocateable, symbols) \
1802 BFD_SEND (abfd, _bfd_get_relocated_section_contents, \
1803 (abfd, link_info, link_order, data, relocateable, symbols))
fdcb0453 1804
4c3721d5
ILT
1805#define bfd_relax_section(abfd, section, link_info, symbols) \
1806 BFD_SEND (abfd, _bfd_relax_section, \
1807 (abfd, section, link_info, symbols))
1808
1809#define bfd_link_hash_table_create(abfd) \
1810 BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
1811
1812#define bfd_link_add_symbols(abfd, info) \
1813 BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
1814
1815#define bfd_final_link(abfd, info) \
1816 BFD_SEND (abfd, _bfd_final_link, (abfd, info))
fdcb0453 1817
fdcb0453 1818symindex
c188b0be 1819bfd_get_next_mapent PARAMS ((bfd *abfd, symindex previous, carsym **sym));
fdcb0453
KR
1820
1821boolean
1822bfd_set_archive_head PARAMS ((bfd *output, bfd *new_head));
1823
1824bfd *
c188b0be 1825bfd_get_elt_at_index PARAMS ((bfd *archive, int index));
fdcb0453 1826
c188b0be 1827bfd *
fdcb0453
KR
1828bfd_openr_next_archived_file PARAMS ((bfd *archive, bfd *previous));
1829
1830CONST char *
c188b0be 1831bfd_core_file_failing_command PARAMS ((bfd *abfd));
fdcb0453
KR
1832
1833int
c188b0be 1834bfd_core_file_failing_signal PARAMS ((bfd *abfd));
fdcb0453
KR
1835
1836boolean
1837core_file_matches_executable_p
1838 PARAMS ((bfd *core_bfd, bfd *exec_bfd));
1839
1840#define BFD_SEND(bfd, message, arglist) \
1841 ((*((bfd)->xvec->message)) arglist)
1842#define BFD_SEND_FMT(bfd, message, arglist) \
1843 (((bfd)->xvec->message[(int)((bfd)->format)]) arglist)
9e461dac
JK
1844enum bfd_flavour {
1845 bfd_target_unknown_flavour,
1846 bfd_target_aout_flavour,
1847 bfd_target_coff_flavour,
1848 bfd_target_ecoff_flavour,
1849 bfd_target_elf_flavour,
1850 bfd_target_ieee_flavour,
1851 bfd_target_nlm_flavour,
1852 bfd_target_oasys_flavour,
1853 bfd_target_tekhex_flavour,
1854 bfd_target_srec_flavour,
1855 bfd_target_som_flavour};
4c3721d5
ILT
1856
1857 /* Forward declaration. */
1858typedef struct bfd_link_info _bfd_link_info;
1859
fdcb0453
KR
1860typedef struct bfd_target
1861{
1862 char *name;
9e461dac 1863 enum bfd_flavour flavour;
fdcb0453
KR
1864 boolean byteorder_big_p;
1865 boolean header_byteorder_big_p;
1866 flagword object_flags;
1867 flagword section_flags;
1868 char symbol_leading_char;
1869 char ar_pad_char;
1870 unsigned short ar_max_namelen;
1871 unsigned int align_power_min;
1a973af1
ILT
1872 bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *));
1873 bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *));
fdcb0453 1874 void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *));
1a973af1
ILT
1875 bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *));
1876 bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *));
fdcb0453 1877 void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *));
1a973af1
ILT
1878 bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *));
1879 bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *));
fdcb0453 1880 void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *));
1a973af1
ILT
1881 bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *));
1882 bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *));
fdcb0453 1883 void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *));
1a973af1
ILT
1884 bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *));
1885 bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *));
fdcb0453 1886 void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *));
1a973af1
ILT
1887 bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *));
1888 bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *));
fdcb0453
KR
1889 void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *));
1890 struct bfd_target * (*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *));
1891 boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
1892 boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *));
1893 char * (*_core_file_failing_command) PARAMS ((bfd *));
1894 int (*_core_file_failing_signal) PARAMS ((bfd *));
1895 boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *));
1896 boolean (*_bfd_slurp_armap) PARAMS ((bfd *));
1897 boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *));
1898 void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *));
1899 boolean (*write_armap) PARAMS ((bfd *arch,
1900 unsigned int elength,
1901 struct orl *map,
1902 unsigned int orl_count,
1903 int stridx));
1904 boolean (*_close_and_cleanup) PARAMS ((bfd *));
1905 boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
1906 file_ptr, bfd_size_type));
1907 boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
1908 file_ptr, bfd_size_type));
1909 boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr));
1910 unsigned int (*_get_symtab_upper_bound) PARAMS ((bfd *));
1911 unsigned int (*_bfd_canonicalize_symtab) PARAMS ((bfd *,
1912 struct symbol_cache_entry **));
1913 unsigned int (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr));
1914 unsigned int (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **,
1915 struct symbol_cache_entry **));
1916 struct symbol_cache_entry *
1917 (*_bfd_make_empty_symbol) PARAMS ((bfd *));
1918 void (*_bfd_print_symbol) PARAMS ((bfd *, PTR,
1919 struct symbol_cache_entry *,
1920 bfd_print_symbol_type));
1921#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e))
1922 void (*_bfd_get_symbol_info) PARAMS ((bfd *,
1923 struct symbol_cache_entry *,
1924 symbol_info *));
1925#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e))
1926 alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *));
1927
1928 boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture,
1929 unsigned long));
1930
1931 bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev));
1932
1933 boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd,
1934 struct sec *section, struct symbol_cache_entry **symbols,
1935 bfd_vma offset, CONST char **file, CONST char **func,
1936 unsigned int *line));
1937
1938 int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *));
1939
1940 int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean));
1941
1942 void (*_bfd_debug_info_start) PARAMS ((bfd *));
1943 void (*_bfd_debug_info_end) PARAMS ((bfd *));
1944 void (*_bfd_debug_info_accumulate) PARAMS ((bfd *, struct sec *));
1945
1946 bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *,
4c3721d5
ILT
1947 struct bfd_link_info *, struct bfd_link_order *,
1948 bfd_byte *data, boolean relocateable,
1949 struct symbol_cache_entry **));
fdcb0453
KR
1950
1951 boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *,
4c3721d5 1952 struct bfd_link_info *, struct symbol_cache_entry **));
fdcb0453 1953
fdcb0453
KR
1954 /* See documentation on reloc types. */
1955 CONST struct reloc_howto_struct *
1956 (*reloc_type_lookup) PARAMS ((bfd *abfd,
1957 bfd_reloc_code_real_type code));
1958
1959 /* Back-door to allow format-aware applications to create debug symbols
1960 while using BFD for everything else. Currently used by the assembler
1961 when creating COFF files. */
1962 asymbol * (*_bfd_make_debug_symbol) PARAMS ((
1963 bfd *abfd,
1964 void *ptr,
1965 unsigned long size));
4c3721d5
ILT
1966
1967 /* Create a hash table for the linker. Different backends store
1968 different information in this table. */
1969 struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *));
1970
1971 /* Add symbols from this object file into the hash table. */
1972 boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *));
1973
1974 /* Do a link based on the link_order structures attached to each
1975 section of the BFD. */
1976 boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *));
1977
fdcb0453
KR
1978 PTR backend_data;
1979} bfd_target;
1980bfd_target *
c188b0be 1981bfd_find_target PARAMS ((CONST char *target_name, bfd *abfd));
fdcb0453
KR
1982
1983CONST char **
1984bfd_target_list PARAMS ((void));
1985
1986boolean
1987bfd_check_format PARAMS ((bfd *abfd, bfd_format format));
1988
1989boolean
c188b0be 1990bfd_set_format PARAMS ((bfd *abfd, bfd_format format));
fdcb0453
KR
1991
1992CONST char *
c188b0be 1993bfd_format_string PARAMS ((bfd_format format));
fdcb0453
KR
1994
1995#endif
This page took 0.129606 seconds and 4 git commands to generate.