Comment typo fix.
[deliverable/binutils-gdb.git] / bfd / bfd-in2.h
1 /* Main header file for the bfd library -- portable access to object files.
2 Copyright 1990, 91, 92, 93, 94, 95, 96, 1997 Free Software Foundation, Inc.
3 Contributed by Cygnus Support.
4
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
9 This file is part of BFD, the Binary File Descriptor library.
10
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 2 of the License, or
14 (at your option) any later version.
15
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, write to the Free Software
23 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
24
25 /* bfd.h -- The only header file required by users of the bfd library
26
27 The bfd.h file is generated from bfd-in.h and various .c files; if you
28 change it, your changes will probably be lost.
29
30 All the prototypes and definitions following the comment "THE FOLLOWING
31 IS EXTRACTED FROM THE SOURCE" are extracted from the source files for
32 BFD. If you change it, someone oneday will extract it from the source
33 again, and your changes will be lost. To save yourself from this bind,
34 change the definitions in the source in the bfd directory. Type "make
35 docs" and then "make headers" in that directory, and magically this file
36 will change to reflect your changes.
37
38 If you don't have the tools to perform the extraction, then you are
39 safe from someone on your system trampling over your header files.
40 You should still maintain the equivalence between the source and this
41 file though; every change you make to the .c file should be reflected
42 here. */
43
44 #ifndef __BFD_H_SEEN__
45 #define __BFD_H_SEEN__
46
47 #ifdef __cplusplus
48 extern "C" {
49 #endif
50
51 #include "ansidecl.h"
52
53 /* These two lines get substitutions done by commands in Makefile.in. */
54 #define BFD_VERSION "@VERSION@"
55 #define BFD_ARCH_SIZE @wordsize@
56 #define BFD_HOST_64BIT_LONG @BFD_HOST_64BIT_LONG@
57 #if @BFD_HOST_64_BIT_DEFINED@
58 #define BFD_HOST_64_BIT @BFD_HOST_64_BIT@
59 #define BFD_HOST_U_64_BIT @BFD_HOST_U_64_BIT@
60 #endif
61
62 #if BFD_ARCH_SIZE >= 64
63 #define BFD64
64 #endif
65
66 #ifndef INLINE
67 #if __GNUC__ >= 2
68 #define INLINE __inline__
69 #else
70 #define INLINE
71 #endif
72 #endif
73
74 /* forward declaration */
75 typedef struct _bfd bfd;
76
77 /* To squelch erroneous compiler warnings ("illegal pointer
78 combination") from the SVR3 compiler, we would like to typedef
79 boolean to int (it doesn't like functions which return boolean.
80 Making sure they are never implicitly declared to return int
81 doesn't seem to help). But this file is not configured based on
82 the host. */
83 /* General rules: functions which are boolean return true on success
84 and false on failure (unless they're a predicate). -- bfd.doc */
85 /* I'm sure this is going to break something and someone is going to
86 force me to change it. */
87 /* typedef enum boolean {false, true} boolean; */
88 /* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h> -fnf */
89 /* It gets worse if the host also defines a true/false enum... -sts */
90 /* And even worse if your compiler has built-in boolean types... -law */
91 #if defined (__GNUG__) && (__GNUC_MINOR__ > 5)
92 #define TRUE_FALSE_ALREADY_DEFINED
93 #endif
94 #ifdef MPW
95 /* Pre-emptive strike - get the file with the enum. */
96 #include <Types.h>
97 #define TRUE_FALSE_ALREADY_DEFINED
98 #endif /* MPW */
99 #ifndef TRUE_FALSE_ALREADY_DEFINED
100 typedef enum bfd_boolean {false, true} boolean;
101 #define BFD_TRUE_FALSE
102 #else
103 /* Use enum names that will appear nowhere else. */
104 typedef enum bfd_boolean {bfd_fffalse, bfd_tttrue} boolean;
105 #endif
106
107 /* A pointer to a position in a file. */
108 /* FIXME: This should be using off_t from <sys/types.h>.
109 For now, try to avoid breaking stuff by not including <sys/types.h> here.
110 This will break on systems with 64-bit file offsets (e.g. 4.4BSD).
111 Probably the best long-term answer is to avoid using file_ptr AND off_t
112 in this header file, and to handle this in the BFD implementation
113 rather than in its interface. */
114 /* typedef off_t file_ptr; */
115 typedef long int file_ptr;
116
117 /* Support for different sizes of target format ints and addresses.
118 If the type `long' is at least 64 bits, BFD_HOST_64BIT_LONG will be
119 set to 1 above. Otherwise, if gcc is being used, this code will
120 use gcc's "long long" type. Otherwise, BFD_HOST_64_BIT must be
121 defined above. */
122
123 #ifdef BFD64
124
125 #ifndef BFD_HOST_64_BIT
126 #if BFD_HOST_64BIT_LONG
127 #define BFD_HOST_64_BIT long
128 #define BFD_HOST_U_64_BIT unsigned long
129 #else
130 #ifdef __GNUC__
131 #define BFD_HOST_64_BIT long long
132 #define BFD_HOST_U_64_BIT unsigned long long
133 #else /* ! defined (__GNUC__) */
134 #error No 64 bit integer type available
135 #endif /* ! defined (__GNUC__) */
136 #endif /* ! BFD_HOST_64BIT_LONG */
137 #endif /* ! defined (BFD_HOST_64_BIT) */
138
139 typedef BFD_HOST_U_64_BIT bfd_vma;
140 typedef BFD_HOST_64_BIT bfd_signed_vma;
141 typedef BFD_HOST_U_64_BIT bfd_size_type;
142 typedef BFD_HOST_U_64_BIT symvalue;
143
144 #ifndef fprintf_vma
145 #if BFD_HOST_64BIT_LONG
146 #define sprintf_vma(s,x) sprintf (s, "%016lx", x)
147 #define fprintf_vma(f,x) fprintf (f, "%016lx", x)
148 #else
149 #define _bfd_int64_low(x) ((unsigned long) (((x) & 0xffffffff)))
150 #define _bfd_int64_high(x) ((unsigned long) (((x) >> 32) & 0xffffffff))
151 #define fprintf_vma(s,x) \
152 fprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
153 #define sprintf_vma(s,x) \
154 sprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
155 #endif
156 #endif
157
158 #else /* not BFD64 */
159
160 /* Represent a target address. Also used as a generic unsigned type
161 which is guaranteed to be big enough to hold any arithmetic types
162 we need to deal with. */
163 typedef unsigned long bfd_vma;
164
165 /* A generic signed type which is guaranteed to be big enough to hold any
166 arithmetic types we need to deal with. Can be assumed to be compatible
167 with bfd_vma in the same way that signed and unsigned ints are compatible
168 (as parameters, in assignment, etc). */
169 typedef long bfd_signed_vma;
170
171 typedef unsigned long symvalue;
172 typedef unsigned long bfd_size_type;
173
174 /* Print a bfd_vma x on stream s. */
175 #define fprintf_vma(s,x) fprintf(s, "%08lx", x)
176 #define sprintf_vma(s,x) sprintf(s, "%08lx", x)
177 #endif /* not BFD64 */
178 #define printf_vma(x) fprintf_vma(stdout,x)
179
180 typedef unsigned int flagword; /* 32 bits of flags */
181 typedef unsigned char bfd_byte;
182 \f
183 /** File formats */
184
185 typedef enum bfd_format {
186 bfd_unknown = 0, /* file format is unknown */
187 bfd_object, /* linker/assember/compiler output */
188 bfd_archive, /* object archive file */
189 bfd_core, /* core dump */
190 bfd_type_end} /* marks the end; don't use it! */
191 bfd_format;
192
193 /* Values that may appear in the flags field of a BFD. These also
194 appear in the object_flags field of the bfd_target structure, where
195 they indicate the set of flags used by that backend (not all flags
196 are meaningful for all object file formats) (FIXME: at the moment,
197 the object_flags values have mostly just been copied from backend
198 to another, and are not necessarily correct). */
199
200 /* No flags. */
201 #define BFD_NO_FLAGS 0x00
202
203 /* BFD contains relocation entries. */
204 #define HAS_RELOC 0x01
205
206 /* BFD is directly executable. */
207 #define EXEC_P 0x02
208
209 /* BFD has line number information (basically used for F_LNNO in a
210 COFF header). */
211 #define HAS_LINENO 0x04
212
213 /* BFD has debugging information. */
214 #define HAS_DEBUG 0x08
215
216 /* BFD has symbols. */
217 #define HAS_SYMS 0x10
218
219 /* BFD has local symbols (basically used for F_LSYMS in a COFF
220 header). */
221 #define HAS_LOCALS 0x20
222
223 /* BFD is a dynamic object. */
224 #define DYNAMIC 0x40
225
226 /* Text section is write protected (if D_PAGED is not set, this is
227 like an a.out NMAGIC file) (the linker sets this by default, but
228 clears it for -r or -N). */
229 #define WP_TEXT 0x80
230
231 /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
232 linker sets this by default, but clears it for -r or -n or -N). */
233 #define D_PAGED 0x100
234
235 /* BFD is relaxable (this means that bfd_relax_section may be able to
236 do something) (sometimes bfd_relax_section can do something even if
237 this is not set). */
238 #define BFD_IS_RELAXABLE 0x200
239
240 /* This may be set before writing out a BFD to request using a
241 traditional format. For example, this is used to request that when
242 writing out an a.out object the symbols not be hashed to eliminate
243 duplicates. */
244 #define BFD_TRADITIONAL_FORMAT 0x400
245
246 /* This flag indicates that the BFD contents are actually cached in
247 memory. If this is set, iostream points to a bfd_in_memory struct. */
248 #define BFD_IN_MEMORY 0x800
249 \f
250 /* symbols and relocation */
251
252 /* A count of carsyms (canonical archive symbols). */
253 typedef unsigned long symindex;
254
255 /* How to perform a relocation. */
256 typedef const struct reloc_howto_struct reloc_howto_type;
257
258 #define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
259
260 /* General purpose part of a symbol X;
261 target specific parts are in libcoff.h, libaout.h, etc. */
262
263 #define bfd_get_section(x) ((x)->section)
264 #define bfd_get_output_section(x) ((x)->section->output_section)
265 #define bfd_set_section(x,y) ((x)->section) = (y)
266 #define bfd_asymbol_base(x) ((x)->section->vma)
267 #define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value)
268 #define bfd_asymbol_name(x) ((x)->name)
269 /*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/
270 #define bfd_asymbol_bfd(x) ((x)->the_bfd)
271 #define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour)
272
273 /* A canonical archive symbol. */
274 /* This is a type pun with struct ranlib on purpose! */
275 typedef struct carsym {
276 char *name;
277 file_ptr file_offset; /* look here to find the file */
278 } carsym; /* to make these you call a carsymogen */
279
280
281 /* Used in generating armaps (archive tables of contents).
282 Perhaps just a forward definition would do? */
283 struct orl { /* output ranlib */
284 char **name; /* symbol name */
285 file_ptr pos; /* bfd* or file position */
286 int namidx; /* index into string table */
287 };
288 \f
289
290 /* Linenumber stuff */
291 typedef struct lineno_cache_entry {
292 unsigned int line_number; /* Linenumber from start of function*/
293 union {
294 struct symbol_cache_entry *sym; /* Function name */
295 unsigned long offset; /* Offset into section */
296 } u;
297 } alent;
298 \f
299 /* object and core file sections */
300
301 #define align_power(addr, align) \
302 ( ((addr) + ((1<<(align))-1)) & (-1 << (align)))
303
304 typedef struct sec *sec_ptr;
305
306 #define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
307 #define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
308 #define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
309 #define bfd_section_name(bfd, ptr) ((ptr)->name)
310 #define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr))
311 #define bfd_section_vma(bfd, ptr) ((ptr)->vma)
312 #define bfd_section_lma(bfd, ptr) ((ptr)->lma)
313 #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
314 #define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
315 #define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
316
317 #define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0)
318
319 #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma= (val)), ((ptr)->user_set_vma = (boolean)true), true)
320 #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true)
321 #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true)
322
323 typedef struct stat stat_type;
324 \f
325 typedef enum bfd_print_symbol
326 {
327 bfd_print_symbol_name,
328 bfd_print_symbol_more,
329 bfd_print_symbol_all
330 } bfd_print_symbol_type;
331
332 /* Information about a symbol that nm needs. */
333
334 typedef struct _symbol_info
335 {
336 symvalue value;
337 char type;
338 CONST char *name; /* Symbol name. */
339 unsigned char stab_type; /* Stab type. */
340 char stab_other; /* Stab other. */
341 short stab_desc; /* Stab desc. */
342 CONST char *stab_name; /* String for stab type. */
343 } symbol_info;
344
345 /* Get the name of a stabs type code. */
346
347 extern const char *bfd_get_stab_name PARAMS ((int));
348 \f
349 /* Hash table routines. There is no way to free up a hash table. */
350
351 /* An element in the hash table. Most uses will actually use a larger
352 structure, and an instance of this will be the first field. */
353
354 struct bfd_hash_entry
355 {
356 /* Next entry for this hash code. */
357 struct bfd_hash_entry *next;
358 /* String being hashed. */
359 const char *string;
360 /* Hash code. This is the full hash code, not the index into the
361 table. */
362 unsigned long hash;
363 };
364
365 /* A hash table. */
366
367 struct bfd_hash_table
368 {
369 /* The hash array. */
370 struct bfd_hash_entry **table;
371 /* The number of slots in the hash table. */
372 unsigned int size;
373 /* A function used to create new elements in the hash table. The
374 first entry is itself a pointer to an element. When this
375 function is first invoked, this pointer will be NULL. However,
376 having the pointer permits a hierarchy of method functions to be
377 built each of which calls the function in the superclass. Thus
378 each function should be written to allocate a new block of memory
379 only if the argument is NULL. */
380 struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *,
381 struct bfd_hash_table *,
382 const char *));
383 /* An objalloc for this hash table. This is a struct objalloc *,
384 but we use PTR to avoid requiring the inclusion of objalloc.h. */
385 PTR memory;
386 };
387
388 /* Initialize a hash table. */
389 extern boolean bfd_hash_table_init
390 PARAMS ((struct bfd_hash_table *,
391 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
392 struct bfd_hash_table *,
393 const char *)));
394
395 /* Initialize a hash table specifying a size. */
396 extern boolean bfd_hash_table_init_n
397 PARAMS ((struct bfd_hash_table *,
398 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
399 struct bfd_hash_table *,
400 const char *),
401 unsigned int size));
402
403 /* Free up a hash table. */
404 extern void bfd_hash_table_free PARAMS ((struct bfd_hash_table *));
405
406 /* Look up a string in a hash table. If CREATE is true, a new entry
407 will be created for this string if one does not already exist. The
408 COPY argument must be true if this routine should copy the string
409 into newly allocated memory when adding an entry. */
410 extern struct bfd_hash_entry *bfd_hash_lookup
411 PARAMS ((struct bfd_hash_table *, const char *, boolean create,
412 boolean copy));
413
414 /* Replace an entry in a hash table. */
415 extern void bfd_hash_replace
416 PARAMS ((struct bfd_hash_table *, struct bfd_hash_entry *old,
417 struct bfd_hash_entry *nw));
418
419 /* Base method for creating a hash table entry. */
420 extern struct bfd_hash_entry *bfd_hash_newfunc
421 PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *,
422 const char *));
423
424 /* Grab some space for a hash table entry. */
425 extern PTR bfd_hash_allocate PARAMS ((struct bfd_hash_table *,
426 unsigned int));
427
428 /* Traverse a hash table in a random order, calling a function on each
429 element. If the function returns false, the traversal stops. The
430 INFO argument is passed to the function. */
431 extern void bfd_hash_traverse PARAMS ((struct bfd_hash_table *,
432 boolean (*) (struct bfd_hash_entry *,
433 PTR),
434 PTR info));
435 \f
436 /* Semi-portable string concatenation in cpp.
437 The CAT4 hack is to avoid a problem with some strict ANSI C preprocessors.
438 The problem is, "32_" is not a valid preprocessing token, and we don't
439 want extra underscores (e.g., "nlm_32_"). The XCAT2 macro will cause the
440 inner CAT macros to be evaluated first, producing still-valid pp-tokens.
441 Then the final concatenation can be done. (Sigh.) */
442 #ifndef CAT
443 #ifdef SABER
444 #define CAT(a,b) a##b
445 #define CAT3(a,b,c) a##b##c
446 #define CAT4(a,b,c,d) a##b##c##d
447 #else
448 #if defined(__STDC__) || defined(ALMOST_STDC)
449 #define CAT(a,b) a##b
450 #define CAT3(a,b,c) a##b##c
451 #define XCAT2(a,b) CAT(a,b)
452 #define CAT4(a,b,c,d) XCAT2(CAT(a,b),CAT(c,d))
453 #else
454 #define CAT(a,b) a/**/b
455 #define CAT3(a,b,c) a/**/b/**/c
456 #define CAT4(a,b,c,d) a/**/b/**/c/**/d
457 #endif
458 #endif
459 #endif
460
461 #define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table
462 \f
463 /* User program access to BFD facilities */
464
465 /* Direct I/O routines, for programs which know more about the object
466 file than BFD does. Use higher level routines if possible. */
467
468 extern bfd_size_type bfd_read
469 PARAMS ((PTR, bfd_size_type size, bfd_size_type nitems, bfd *abfd));
470 extern bfd_size_type bfd_write
471 PARAMS ((const PTR, bfd_size_type size, bfd_size_type nitems, bfd *abfd));
472 extern int bfd_seek PARAMS ((bfd *abfd, file_ptr fp, int direction));
473 extern long bfd_tell PARAMS ((bfd *abfd));
474 extern int bfd_flush PARAMS ((bfd *abfd));
475 extern int bfd_stat PARAMS ((bfd *abfd, struct stat *));
476
477
478 /* Cast from const char * to char * so that caller can assign to
479 a char * without a warning. */
480 #define bfd_get_filename(abfd) ((char *) (abfd)->filename)
481 #define bfd_get_cacheable(abfd) ((abfd)->cacheable)
482 #define bfd_get_format(abfd) ((abfd)->format)
483 #define bfd_get_target(abfd) ((abfd)->xvec->name)
484 #define bfd_get_flavour(abfd) ((abfd)->xvec->flavour)
485 #define bfd_big_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_BIG)
486 #define bfd_little_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_LITTLE)
487 #define bfd_header_big_endian(abfd) \
488 ((abfd)->xvec->header_byteorder == BFD_ENDIAN_BIG)
489 #define bfd_header_little_endian(abfd) \
490 ((abfd)->xvec->header_byteorder == BFD_ENDIAN_LITTLE)
491 #define bfd_get_file_flags(abfd) ((abfd)->flags)
492 #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
493 #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
494 #define bfd_my_archive(abfd) ((abfd)->my_archive)
495 #define bfd_has_map(abfd) ((abfd)->has_armap)
496
497 #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
498 #define bfd_usrdata(abfd) ((abfd)->usrdata)
499
500 #define bfd_get_start_address(abfd) ((abfd)->start_address)
501 #define bfd_get_symcount(abfd) ((abfd)->symcount)
502 #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
503 #define bfd_count_sections(abfd) ((abfd)->section_count)
504
505 #define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char)
506
507 #define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = (boolean)(bool)), true)
508
509 extern boolean bfd_record_phdr
510 PARAMS ((bfd *, unsigned long, boolean, flagword, boolean, bfd_vma,
511 boolean, boolean, unsigned int, struct sec **));
512
513 /* Byte swapping routines. */
514
515 bfd_vma bfd_getb64 PARAMS ((const unsigned char *));
516 bfd_vma bfd_getl64 PARAMS ((const unsigned char *));
517 bfd_signed_vma bfd_getb_signed_64 PARAMS ((const unsigned char *));
518 bfd_signed_vma bfd_getl_signed_64 PARAMS ((const unsigned char *));
519 bfd_vma bfd_getb32 PARAMS ((const unsigned char *));
520 bfd_vma bfd_getl32 PARAMS ((const unsigned char *));
521 bfd_signed_vma bfd_getb_signed_32 PARAMS ((const unsigned char *));
522 bfd_signed_vma bfd_getl_signed_32 PARAMS ((const unsigned char *));
523 bfd_vma bfd_getb16 PARAMS ((const unsigned char *));
524 bfd_vma bfd_getl16 PARAMS ((const unsigned char *));
525 bfd_signed_vma bfd_getb_signed_16 PARAMS ((const unsigned char *));
526 bfd_signed_vma bfd_getl_signed_16 PARAMS ((const unsigned char *));
527 void bfd_putb64 PARAMS ((bfd_vma, unsigned char *));
528 void bfd_putl64 PARAMS ((bfd_vma, unsigned char *));
529 void bfd_putb32 PARAMS ((bfd_vma, unsigned char *));
530 void bfd_putl32 PARAMS ((bfd_vma, unsigned char *));
531 void bfd_putb16 PARAMS ((bfd_vma, unsigned char *));
532 void bfd_putl16 PARAMS ((bfd_vma, unsigned char *));
533 \f
534 /* Externally visible ECOFF routines. */
535
536 #if defined(__STDC__) || defined(ALMOST_STDC)
537 struct ecoff_debug_info;
538 struct ecoff_debug_swap;
539 struct ecoff_extr;
540 struct symbol_cache_entry;
541 struct bfd_link_info;
542 struct bfd_link_hash_entry;
543 struct bfd_elf_version_tree;
544 #endif
545 extern bfd_vma bfd_ecoff_get_gp_value PARAMS ((bfd * abfd));
546 extern boolean bfd_ecoff_set_gp_value PARAMS ((bfd *abfd, bfd_vma gp_value));
547 extern boolean bfd_ecoff_set_regmasks
548 PARAMS ((bfd *abfd, unsigned long gprmask, unsigned long fprmask,
549 unsigned long *cprmask));
550 extern PTR bfd_ecoff_debug_init
551 PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
552 const struct ecoff_debug_swap *output_swap,
553 struct bfd_link_info *));
554 extern void bfd_ecoff_debug_free
555 PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
556 const struct ecoff_debug_swap *output_swap,
557 struct bfd_link_info *));
558 extern boolean bfd_ecoff_debug_accumulate
559 PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
560 const struct ecoff_debug_swap *output_swap,
561 bfd *input_bfd, struct ecoff_debug_info *input_debug,
562 const struct ecoff_debug_swap *input_swap,
563 struct bfd_link_info *));
564 extern boolean bfd_ecoff_debug_accumulate_other
565 PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
566 const struct ecoff_debug_swap *output_swap, bfd *input_bfd,
567 struct bfd_link_info *));
568 extern boolean bfd_ecoff_debug_externals
569 PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
570 const struct ecoff_debug_swap *swap,
571 boolean relocateable,
572 boolean (*get_extr) (struct symbol_cache_entry *,
573 struct ecoff_extr *),
574 void (*set_index) (struct symbol_cache_entry *,
575 bfd_size_type)));
576 extern boolean bfd_ecoff_debug_one_external
577 PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
578 const struct ecoff_debug_swap *swap,
579 const char *name, struct ecoff_extr *esym));
580 extern bfd_size_type bfd_ecoff_debug_size
581 PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
582 const struct ecoff_debug_swap *swap));
583 extern boolean bfd_ecoff_write_debug
584 PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
585 const struct ecoff_debug_swap *swap, file_ptr where));
586 extern boolean bfd_ecoff_write_accumulated_debug
587 PARAMS ((PTR handle, bfd *abfd, struct ecoff_debug_info *debug,
588 const struct ecoff_debug_swap *swap,
589 struct bfd_link_info *info, file_ptr where));
590 extern boolean bfd_mips_ecoff_create_embedded_relocs
591 PARAMS ((bfd *, struct bfd_link_info *, struct sec *, struct sec *,
592 char **));
593
594 /* Externally visible ELF routines. */
595
596 struct bfd_link_needed_list
597 {
598 struct bfd_link_needed_list *next;
599 bfd *by;
600 const char *name;
601 };
602
603 extern boolean bfd_elf32_record_link_assignment
604 PARAMS ((bfd *, struct bfd_link_info *, const char *, boolean));
605 extern boolean bfd_elf64_record_link_assignment
606 PARAMS ((bfd *, struct bfd_link_info *, const char *, boolean));
607 extern struct bfd_link_needed_list *bfd_elf_get_needed_list
608 PARAMS ((bfd *, struct bfd_link_info *));
609 extern boolean bfd_elf32_size_dynamic_sections
610 PARAMS ((bfd *, const char *, const char *, boolean, const char *,
611 const char * const *, struct bfd_link_info *, struct sec **,
612 struct bfd_elf_version_tree *));
613 extern boolean bfd_elf64_size_dynamic_sections
614 PARAMS ((bfd *, const char *, const char *, boolean, const char *,
615 const char * const *, struct bfd_link_info *, struct sec **,
616 struct bfd_elf_version_tree *));
617 extern void bfd_elf_set_dt_needed_name PARAMS ((bfd *, const char *));
618 extern const char *bfd_elf_get_dt_soname PARAMS ((bfd *));
619
620 /* SunOS shared library support routines for the linker. */
621
622 extern struct bfd_link_needed_list *bfd_sunos_get_needed_list
623 PARAMS ((bfd *, struct bfd_link_info *));
624 extern boolean bfd_sunos_record_link_assignment
625 PARAMS ((bfd *, struct bfd_link_info *, const char *));
626 extern boolean bfd_sunos_size_dynamic_sections
627 PARAMS ((bfd *, struct bfd_link_info *, struct sec **, struct sec **,
628 struct sec **));
629
630 /* Linux shared library support routines for the linker. */
631
632 extern boolean bfd_i386linux_size_dynamic_sections
633 PARAMS ((bfd *, struct bfd_link_info *));
634 extern boolean bfd_m68klinux_size_dynamic_sections
635 PARAMS ((bfd *, struct bfd_link_info *));
636 extern boolean bfd_sparclinux_size_dynamic_sections
637 PARAMS ((bfd *, struct bfd_link_info *));
638
639 /* mmap hacks */
640
641 struct _bfd_window_internal;
642 typedef struct _bfd_window_internal bfd_window_internal;
643
644 typedef struct _bfd_window {
645 /* What the user asked for. */
646 PTR data;
647 bfd_size_type size;
648 /* The actual window used by BFD. Small user-requested read-only
649 regions sharing a page may share a single window into the object
650 file. Read-write versions shouldn't until I've fixed things to
651 keep track of which portions have been claimed by the
652 application; don't want to give the same region back when the
653 application wants two writable copies! */
654 struct _bfd_window_internal *i;
655 } bfd_window;
656
657 extern void bfd_init_window PARAMS ((bfd_window *));
658 extern void bfd_free_window PARAMS ((bfd_window *));
659 extern boolean bfd_get_file_window
660 PARAMS ((bfd *, file_ptr, bfd_size_type, bfd_window *, boolean));
661
662 /* XCOFF support routines for the linker. */
663
664 extern boolean bfd_xcoff_link_record_set
665 PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
666 bfd_size_type));
667 extern boolean bfd_xcoff_import_symbol
668 PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
669 bfd_vma, const char *, const char *, const char *));
670 extern boolean bfd_xcoff_export_symbol
671 PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
672 boolean));
673 extern boolean bfd_xcoff_link_count_reloc
674 PARAMS ((bfd *, struct bfd_link_info *, const char *));
675 extern boolean bfd_xcoff_record_link_assignment
676 PARAMS ((bfd *, struct bfd_link_info *, const char *));
677 extern boolean bfd_xcoff_size_dynamic_sections
678 PARAMS ((bfd *, struct bfd_link_info *, const char *, const char *,
679 unsigned long, unsigned long, unsigned long, boolean,
680 int, boolean, boolean, struct sec **));
681
682 /* Externally visible COFF routines. */
683
684 #if defined(__STDC__) || defined(ALMOST_STDC)
685 struct internal_syment;
686 union internal_auxent;
687 #endif
688
689 extern boolean bfd_coff_get_syment
690 PARAMS ((bfd *, struct symbol_cache_entry *, struct internal_syment *));
691 extern boolean bfd_coff_get_auxent
692 PARAMS ((bfd *, struct symbol_cache_entry *, int, union internal_auxent *));
693
694 /* And more from the source. */
695 void
696 bfd_init PARAMS ((void));
697
698 bfd *
699 bfd_openr PARAMS ((CONST char *filename, CONST char *target));
700
701 bfd *
702 bfd_fdopenr PARAMS ((CONST char *filename, CONST char *target, int fd));
703
704 bfd *
705 bfd_openstreamr PARAMS ((const char *, const char *, PTR));
706
707 bfd *
708 bfd_openw PARAMS ((CONST char *filename, CONST char *target));
709
710 boolean
711 bfd_close PARAMS ((bfd *abfd));
712
713 boolean
714 bfd_close_all_done PARAMS ((bfd *));
715
716 bfd *
717 bfd_create PARAMS ((CONST char *filename, bfd *templ));
718
719
720 /* Byte swapping macros for user section data. */
721
722 #define bfd_put_8(abfd, val, ptr) \
723 (*((unsigned char *)(ptr)) = (unsigned char)(val))
724 #define bfd_put_signed_8 \
725 bfd_put_8
726 #define bfd_get_8(abfd, ptr) \
727 (*(unsigned char *)(ptr))
728 #define bfd_get_signed_8(abfd, ptr) \
729 ((*(unsigned char *)(ptr) ^ 0x80) - 0x80)
730
731 #define bfd_put_16(abfd, val, ptr) \
732 BFD_SEND(abfd, bfd_putx16, ((val),(ptr)))
733 #define bfd_put_signed_16 \
734 bfd_put_16
735 #define bfd_get_16(abfd, ptr) \
736 BFD_SEND(abfd, bfd_getx16, (ptr))
737 #define bfd_get_signed_16(abfd, ptr) \
738 BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
739
740 #define bfd_put_32(abfd, val, ptr) \
741 BFD_SEND(abfd, bfd_putx32, ((val),(ptr)))
742 #define bfd_put_signed_32 \
743 bfd_put_32
744 #define bfd_get_32(abfd, ptr) \
745 BFD_SEND(abfd, bfd_getx32, (ptr))
746 #define bfd_get_signed_32(abfd, ptr) \
747 BFD_SEND(abfd, bfd_getx_signed_32, (ptr))
748
749 #define bfd_put_64(abfd, val, ptr) \
750 BFD_SEND(abfd, bfd_putx64, ((val), (ptr)))
751 #define bfd_put_signed_64 \
752 bfd_put_64
753 #define bfd_get_64(abfd, ptr) \
754 BFD_SEND(abfd, bfd_getx64, (ptr))
755 #define bfd_get_signed_64(abfd, ptr) \
756 BFD_SEND(abfd, bfd_getx_signed_64, (ptr))
757
758
759 /* Byte swapping macros for file header data. */
760
761 #define bfd_h_put_8(abfd, val, ptr) \
762 bfd_put_8 (abfd, val, ptr)
763 #define bfd_h_put_signed_8(abfd, val, ptr) \
764 bfd_put_8 (abfd, val, ptr)
765 #define bfd_h_get_8(abfd, ptr) \
766 bfd_get_8 (abfd, ptr)
767 #define bfd_h_get_signed_8(abfd, ptr) \
768 bfd_get_signed_8 (abfd, ptr)
769
770 #define bfd_h_put_16(abfd, val, ptr) \
771 BFD_SEND(abfd, bfd_h_putx16,(val,ptr))
772 #define bfd_h_put_signed_16 \
773 bfd_h_put_16
774 #define bfd_h_get_16(abfd, ptr) \
775 BFD_SEND(abfd, bfd_h_getx16,(ptr))
776 #define bfd_h_get_signed_16(abfd, ptr) \
777 BFD_SEND(abfd, bfd_h_getx_signed_16, (ptr))
778
779 #define bfd_h_put_32(abfd, val, ptr) \
780 BFD_SEND(abfd, bfd_h_putx32,(val,ptr))
781 #define bfd_h_put_signed_32 \
782 bfd_h_put_32
783 #define bfd_h_get_32(abfd, ptr) \
784 BFD_SEND(abfd, bfd_h_getx32,(ptr))
785 #define bfd_h_get_signed_32(abfd, ptr) \
786 BFD_SEND(abfd, bfd_h_getx_signed_32, (ptr))
787
788 #define bfd_h_put_64(abfd, val, ptr) \
789 BFD_SEND(abfd, bfd_h_putx64,(val, ptr))
790 #define bfd_h_put_signed_64 \
791 bfd_h_put_64
792 #define bfd_h_get_64(abfd, ptr) \
793 BFD_SEND(abfd, bfd_h_getx64,(ptr))
794 #define bfd_h_get_signed_64(abfd, ptr) \
795 BFD_SEND(abfd, bfd_h_getx_signed_64, (ptr))
796
797 typedef struct sec
798 {
799 /* The name of the section; the name isn't a copy, the pointer is
800 the same as that passed to bfd_make_section. */
801
802 CONST char *name;
803
804 /* Which section is it; 0..nth. */
805
806 int index;
807
808 /* The next section in the list belonging to the BFD, or NULL. */
809
810 struct sec *next;
811
812 /* The field flags contains attributes of the section. Some
813 flags are read in from the object file, and some are
814 synthesized from other information. */
815
816 flagword flags;
817
818 #define SEC_NO_FLAGS 0x000
819
820 /* Tells the OS to allocate space for this section when loading.
821 This is clear for a section containing debug information
822 only. */
823 #define SEC_ALLOC 0x001
824
825 /* Tells the OS to load the section from the file when loading.
826 This is clear for a .bss section. */
827 #define SEC_LOAD 0x002
828
829 /* The section contains data still to be relocated, so there is
830 some relocation information too. */
831 #define SEC_RELOC 0x004
832
833 #if 0 /* Obsolete ? */
834 #define SEC_BALIGN 0x008
835 #endif
836
837 /* A signal to the OS that the section contains read only
838 data. */
839 #define SEC_READONLY 0x010
840
841 /* The section contains code only. */
842 #define SEC_CODE 0x020
843
844 /* The section contains data only. */
845 #define SEC_DATA 0x040
846
847 /* The section will reside in ROM. */
848 #define SEC_ROM 0x080
849
850 /* The section contains constructor information. This section
851 type is used by the linker to create lists of constructors and
852 destructors used by <<g++>>. When a back end sees a symbol
853 which should be used in a constructor list, it creates a new
854 section for the type of name (e.g., <<__CTOR_LIST__>>), attaches
855 the symbol to it, and builds a relocation. To build the lists
856 of constructors, all the linker has to do is catenate all the
857 sections called <<__CTOR_LIST__>> and relocate the data
858 contained within - exactly the operations it would peform on
859 standard data. */
860 #define SEC_CONSTRUCTOR 0x100
861
862 /* The section is a constuctor, and should be placed at the
863 end of the text, data, or bss section(?). */
864 #define SEC_CONSTRUCTOR_TEXT 0x1100
865 #define SEC_CONSTRUCTOR_DATA 0x2100
866 #define SEC_CONSTRUCTOR_BSS 0x3100
867
868 /* The section has contents - a data section could be
869 <<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>; a debug section could be
870 <<SEC_HAS_CONTENTS>> */
871 #define SEC_HAS_CONTENTS 0x200
872
873 /* An instruction to the linker to not output the section
874 even if it has information which would normally be written. */
875 #define SEC_NEVER_LOAD 0x400
876
877 /* The section is a COFF shared library section. This flag is
878 only for the linker. If this type of section appears in
879 the input file, the linker must copy it to the output file
880 without changing the vma or size. FIXME: Although this
881 was originally intended to be general, it really is COFF
882 specific (and the flag was renamed to indicate this). It
883 might be cleaner to have some more general mechanism to
884 allow the back end to control what the linker does with
885 sections. */
886 #define SEC_COFF_SHARED_LIBRARY 0x800
887
888 /* The section contains common symbols (symbols may be defined
889 multiple times, the value of a symbol is the amount of
890 space it requires, and the largest symbol value is the one
891 used). Most targets have exactly one of these (which we
892 translate to bfd_com_section_ptr), but ECOFF has two. */
893 #define SEC_IS_COMMON 0x8000
894
895 /* The section contains only debugging information. For
896 example, this is set for ELF .debug and .stab sections.
897 strip tests this flag to see if a section can be
898 discarded. */
899 #define SEC_DEBUGGING 0x10000
900
901 /* The contents of this section are held in memory pointed to
902 by the contents field. This is checked by
903 bfd_get_section_contents, and the data is retrieved from
904 memory if appropriate. */
905 #define SEC_IN_MEMORY 0x20000
906
907 /* The contents of this section are to be excluded by the
908 linker for executable and shared objects unless those
909 objects are to be further relocated. */
910 #define SEC_EXCLUDE 0x40000
911
912 /* The contents of this section are to be sorted by the
913 based on the address specified in the associated symbol
914 table. */
915 #define SEC_SORT_ENTRIES 0x80000
916
917 /* When linking, duplicate sections of the same name should be
918 discarded, rather than being combined into a single section as
919 is usually done. This is similar to how common symbols are
920 handled. See SEC_LINK_DUPLICATES below. */
921 #define SEC_LINK_ONCE 0x100000
922
923 /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
924 should handle duplicate sections. */
925 #define SEC_LINK_DUPLICATES 0x600000
926
927 /* This value for SEC_LINK_DUPLICATES means that duplicate
928 sections with the same name should simply be discarded. */
929 #define SEC_LINK_DUPLICATES_DISCARD 0x0
930
931 /* This value for SEC_LINK_DUPLICATES means that the linker
932 should warn if there are any duplicate sections, although
933 it should still only link one copy. */
934 #define SEC_LINK_DUPLICATES_ONE_ONLY 0x200000
935
936 /* This value for SEC_LINK_DUPLICATES means that the linker
937 should warn if any duplicate sections are a different size. */
938 #define SEC_LINK_DUPLICATES_SAME_SIZE 0x400000
939
940 /* This value for SEC_LINK_DUPLICATES means that the linker
941 should warn if any duplicate sections contain different
942 contents. */
943 #define SEC_LINK_DUPLICATES_SAME_CONTENTS 0x600000
944
945 /* This section was created by the linker as part of dynamic
946 relocation or other arcane processing. It is skipped when
947 going through the first-pass output, trusting that someone
948 else up the line will take care of it later. */
949 #define SEC_LINKER_CREATED 0x800000
950
951 /* End of section flags. */
952
953 /* Some internal packed boolean fields. */
954
955 /* See the vma field. */
956 unsigned int user_set_vma : 1;
957
958 /* Whether relocations have been processed. */
959 unsigned int reloc_done : 1;
960
961 /* A mark flag used by some of the linker backends. */
962 unsigned int linker_mark : 1;
963
964 /* End of internal packed boolean fields. */
965
966 /* The virtual memory address of the section - where it will be
967 at run time. The symbols are relocated against this. The
968 user_set_vma flag is maintained by bfd; if it's not set, the
969 backend can assign addresses (for example, in <<a.out>>, where
970 the default address for <<.data>> is dependent on the specific
971 target and various flags). */
972
973 bfd_vma vma;
974
975 /* The load address of the section - where it would be in a
976 rom image; really only used for writing section header
977 information. */
978
979 bfd_vma lma;
980
981 /* The size of the section in bytes, as it will be output.
982 contains a value even if the section has no contents (e.g., the
983 size of <<.bss>>). This will be filled in after relocation */
984
985 bfd_size_type _cooked_size;
986
987 /* The original size on disk of the section, in bytes. Normally this
988 value is the same as the size, but if some relaxing has
989 been done, then this value will be bigger. */
990
991 bfd_size_type _raw_size;
992
993 /* If this section is going to be output, then this value is the
994 offset into the output section of the first byte in the input
995 section. E.g., if this was going to start at the 100th byte in
996 the output section, this value would be 100. */
997
998 bfd_vma output_offset;
999
1000 /* The output section through which to map on output. */
1001
1002 struct sec *output_section;
1003
1004 /* The alignment requirement of the section, as an exponent of 2 -
1005 e.g., 3 aligns to 2^3 (or 8). */
1006
1007 unsigned int alignment_power;
1008
1009 /* If an input section, a pointer to a vector of relocation
1010 records for the data in this section. */
1011
1012 struct reloc_cache_entry *relocation;
1013
1014 /* If an output section, a pointer to a vector of pointers to
1015 relocation records for the data in this section. */
1016
1017 struct reloc_cache_entry **orelocation;
1018
1019 /* The number of relocation records in one of the above */
1020
1021 unsigned reloc_count;
1022
1023 /* Information below is back end specific - and not always used
1024 or updated. */
1025
1026 /* File position of section data */
1027
1028 file_ptr filepos;
1029
1030 /* File position of relocation info */
1031
1032 file_ptr rel_filepos;
1033
1034 /* File position of line data */
1035
1036 file_ptr line_filepos;
1037
1038 /* Pointer to data for applications */
1039
1040 PTR userdata;
1041
1042 /* If the SEC_IN_MEMORY flag is set, this points to the actual
1043 contents. */
1044 unsigned char *contents;
1045
1046 /* Attached line number information */
1047
1048 alent *lineno;
1049
1050 /* Number of line number records */
1051
1052 unsigned int lineno_count;
1053
1054 /* When a section is being output, this value changes as more
1055 linenumbers are written out */
1056
1057 file_ptr moving_line_filepos;
1058
1059 /* What the section number is in the target world */
1060
1061 int target_index;
1062
1063 PTR used_by_bfd;
1064
1065 /* If this is a constructor section then here is a list of the
1066 relocations created to relocate items within it. */
1067
1068 struct relent_chain *constructor_chain;
1069
1070 /* The BFD which owns the section. */
1071
1072 bfd *owner;
1073
1074 /* A symbol which points at this section only */
1075 struct symbol_cache_entry *symbol;
1076 struct symbol_cache_entry **symbol_ptr_ptr;
1077
1078 struct bfd_link_order *link_order_head;
1079 struct bfd_link_order *link_order_tail;
1080 } asection ;
1081
1082 /* These sections are global, and are managed by BFD. The application
1083 and target back end are not permitted to change the values in
1084 these sections. New code should use the section_ptr macros rather
1085 than referring directly to the const sections. The const sections
1086 may eventually vanish. */
1087 #define BFD_ABS_SECTION_NAME "*ABS*"
1088 #define BFD_UND_SECTION_NAME "*UND*"
1089 #define BFD_COM_SECTION_NAME "*COM*"
1090 #define BFD_IND_SECTION_NAME "*IND*"
1091
1092 /* the absolute section */
1093 extern const asection bfd_abs_section;
1094 #define bfd_abs_section_ptr ((asection *) &bfd_abs_section)
1095 #define bfd_is_abs_section(sec) ((sec) == bfd_abs_section_ptr)
1096 /* Pointer to the undefined section */
1097 extern const asection bfd_und_section;
1098 #define bfd_und_section_ptr ((asection *) &bfd_und_section)
1099 #define bfd_is_und_section(sec) ((sec) == bfd_und_section_ptr)
1100 /* Pointer to the common section */
1101 extern const asection bfd_com_section;
1102 #define bfd_com_section_ptr ((asection *) &bfd_com_section)
1103 /* Pointer to the indirect section */
1104 extern const asection bfd_ind_section;
1105 #define bfd_ind_section_ptr ((asection *) &bfd_ind_section)
1106 #define bfd_is_ind_section(sec) ((sec) == bfd_ind_section_ptr)
1107
1108 extern const struct symbol_cache_entry * const bfd_abs_symbol;
1109 extern const struct symbol_cache_entry * const bfd_com_symbol;
1110 extern const struct symbol_cache_entry * const bfd_und_symbol;
1111 extern const struct symbol_cache_entry * const bfd_ind_symbol;
1112 #define bfd_get_section_size_before_reloc(section) \
1113 (section->reloc_done ? (abort(),1): (section)->_raw_size)
1114 #define bfd_get_section_size_after_reloc(section) \
1115 ((section->reloc_done) ? (section)->_cooked_size: (abort(),1))
1116 asection *
1117 bfd_get_section_by_name PARAMS ((bfd *abfd, CONST char *name));
1118
1119 asection *
1120 bfd_make_section_old_way PARAMS ((bfd *abfd, CONST char *name));
1121
1122 asection *
1123 bfd_make_section_anyway PARAMS ((bfd *abfd, CONST char *name));
1124
1125 asection *
1126 bfd_make_section PARAMS ((bfd *, CONST char *name));
1127
1128 boolean
1129 bfd_set_section_flags PARAMS ((bfd *abfd, asection *sec, flagword flags));
1130
1131 void
1132 bfd_map_over_sections PARAMS ((bfd *abfd,
1133 void (*func)(bfd *abfd,
1134 asection *sect,
1135 PTR obj),
1136 PTR obj));
1137
1138 boolean
1139 bfd_set_section_size PARAMS ((bfd *abfd, asection *sec, bfd_size_type val));
1140
1141 boolean
1142 bfd_set_section_contents
1143 PARAMS ((bfd *abfd,
1144 asection *section,
1145 PTR data,
1146 file_ptr offset,
1147 bfd_size_type count));
1148
1149 boolean
1150 bfd_get_section_contents
1151 PARAMS ((bfd *abfd, asection *section, PTR location,
1152 file_ptr offset, bfd_size_type count));
1153
1154 boolean
1155 bfd_copy_private_section_data PARAMS ((bfd *ibfd, asection *isec, bfd *obfd, asection *osec));
1156
1157 #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
1158 BFD_SEND (obfd, _bfd_copy_private_section_data, \
1159 (ibfd, isection, obfd, osection))
1160 enum bfd_architecture
1161 {
1162 bfd_arch_unknown, /* File arch not known */
1163 bfd_arch_obscure, /* Arch known, not one of these */
1164 bfd_arch_m68k, /* Motorola 68xxx */
1165 bfd_arch_vax, /* DEC Vax */
1166 bfd_arch_i960, /* Intel 960 */
1167 /* The order of the following is important.
1168 lower number indicates a machine type that
1169 only accepts a subset of the instructions
1170 available to machines with higher numbers.
1171 The exception is the "ca", which is
1172 incompatible with all other machines except
1173 "core". */
1174
1175 #define bfd_mach_i960_core 1
1176 #define bfd_mach_i960_ka_sa 2
1177 #define bfd_mach_i960_kb_sb 3
1178 #define bfd_mach_i960_mc 4
1179 #define bfd_mach_i960_xa 5
1180 #define bfd_mach_i960_ca 6
1181 #define bfd_mach_i960_jx 7
1182 #define bfd_mach_i960_hx 8
1183
1184 bfd_arch_a29k, /* AMD 29000 */
1185 bfd_arch_sparc, /* SPARC */
1186 #define bfd_mach_sparc 1
1187 /* The difference between v8plus and v9 is that v9 is a true 64 bit env. */
1188 #define bfd_mach_sparc_sparclet 2
1189 #define bfd_mach_sparc_sparclite 3
1190 #define bfd_mach_sparc_v8plus 4
1191 #define bfd_mach_sparc_v8plusa 5 /* with ultrasparc add'ns */
1192 #define bfd_mach_sparc_v9 6
1193 #define bfd_mach_sparc_v9a 7 /* with ultrasparc add'ns */
1194 /* Nonzero if MACH has the v9 instruction set. */
1195 #define bfd_mach_sparc_v9_p(mach) \
1196 ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9a)
1197 bfd_arch_mips, /* MIPS Rxxxx */
1198 bfd_arch_i386, /* Intel 386 */
1199 #define bfd_mach_i386_i386 0
1200 #define bfd_mach_i386_i8086 1
1201 bfd_arch_we32k, /* AT&T WE32xxx */
1202 bfd_arch_tahoe, /* CCI/Harris Tahoe */
1203 bfd_arch_i860, /* Intel 860 */
1204 bfd_arch_romp, /* IBM ROMP PC/RT */
1205 bfd_arch_alliant, /* Alliant */
1206 bfd_arch_convex, /* Convex */
1207 bfd_arch_m88k, /* Motorola 88xxx */
1208 bfd_arch_pyramid, /* Pyramid Technology */
1209 bfd_arch_h8300, /* Hitachi H8/300 */
1210 #define bfd_mach_h8300 1
1211 #define bfd_mach_h8300h 2
1212 #define bfd_mach_h8300s 3
1213 bfd_arch_powerpc, /* PowerPC */
1214 bfd_arch_rs6000, /* IBM RS/6000 */
1215 bfd_arch_hppa, /* HP PA RISC */
1216 bfd_arch_d10v, /* Mitsubishi D10V */
1217 /* start-sanitize-d30v */
1218 bfd_arch_d30v, /* Mitsubishi D30V */
1219 /* end-sanitize-d30v */
1220 bfd_arch_z8k, /* Zilog Z8000 */
1221 #define bfd_mach_z8001 1
1222 #define bfd_mach_z8002 2
1223 bfd_arch_h8500, /* Hitachi H8/500 */
1224 bfd_arch_sh, /* Hitachi SH */
1225 #define bfd_mach_sh 0
1226 #define bfd_mach_sh3 0x30
1227 #define bfd_mach_sh3e 0x3e
1228 /* start-sanitize-sh4 */
1229 #define bfd_mach_sh4 0x40
1230 /* end-sanitize-sh4 */
1231 bfd_arch_alpha, /* Dec Alpha */
1232 bfd_arch_arm, /* Advanced Risc Machines ARM */
1233 #define bfd_mach_arm_2 1
1234 #define bfd_mach_arm_2a 2
1235 #define bfd_mach_arm_3 3
1236 #define bfd_mach_arm_3M 4
1237 #define bfd_mach_arm_4 5
1238 #define bfd_mach_arm_4T 6
1239 bfd_arch_ns32k, /* National Semiconductors ns32000 */
1240 bfd_arch_w65, /* WDC 65816 */
1241 /* start-sanitize-tic80 */
1242 bfd_arch_tic80, /* TI TMS320c80 (MVP) */
1243 /* end-sanitize-tic80 */
1244 /* start-sanitize-v850 */
1245 bfd_arch_v850, /* NEC V850 */
1246 #define bfd_mach_v850 0
1247 /* start-sanitize-v850e */
1248 #define bfd_mach_v850e 'E'
1249 /* end-sanitize-v850e */
1250 /* start-sanitize-v850eq */
1251 #define bfd_mach_v850eq 'Q'
1252 /* end-sanitize-v850eq */
1253 /* end-sanitize-v850 */
1254 bfd_arch_arc, /* Argonaut RISC Core */
1255 #define bfd_mach_arc_base 0
1256 bfd_arch_m32r, /* Mitsubishi M32R/D */
1257 bfd_arch_mn10200, /* Matsushita MN10200 */
1258 bfd_arch_mn10300, /* Matsushita MN10300 */
1259 bfd_arch_last
1260 };
1261
1262 typedef struct bfd_arch_info
1263 {
1264 int bits_per_word;
1265 int bits_per_address;
1266 int bits_per_byte;
1267 enum bfd_architecture arch;
1268 unsigned long mach;
1269 const char *arch_name;
1270 const char *printable_name;
1271 unsigned int section_align_power;
1272 /* true if this is the default machine for the architecture */
1273 boolean the_default;
1274 const struct bfd_arch_info * (*compatible)
1275 PARAMS ((const struct bfd_arch_info *a,
1276 const struct bfd_arch_info *b));
1277
1278 boolean (*scan) PARAMS ((const struct bfd_arch_info *, const char *));
1279
1280 const struct bfd_arch_info *next;
1281 } bfd_arch_info_type;
1282 const char *
1283 bfd_printable_name PARAMS ((bfd *abfd));
1284
1285 const bfd_arch_info_type *
1286 bfd_scan_arch PARAMS ((const char *string));
1287
1288 const bfd_arch_info_type *
1289 bfd_arch_get_compatible PARAMS ((
1290 const bfd *abfd,
1291 const bfd *bbfd));
1292
1293 void
1294 bfd_set_arch_info PARAMS ((bfd *abfd, const bfd_arch_info_type *arg));
1295
1296 enum bfd_architecture
1297 bfd_get_arch PARAMS ((bfd *abfd));
1298
1299 unsigned long
1300 bfd_get_mach PARAMS ((bfd *abfd));
1301
1302 unsigned int
1303 bfd_arch_bits_per_byte PARAMS ((bfd *abfd));
1304
1305 unsigned int
1306 bfd_arch_bits_per_address PARAMS ((bfd *abfd));
1307
1308 const bfd_arch_info_type *
1309 bfd_get_arch_info PARAMS ((bfd *abfd));
1310
1311 const bfd_arch_info_type *
1312 bfd_lookup_arch
1313 PARAMS ((enum bfd_architecture
1314 arch,
1315 unsigned long machine));
1316
1317 const char *
1318 bfd_printable_arch_mach
1319 PARAMS ((enum bfd_architecture arch, unsigned long machine));
1320
1321 typedef enum bfd_reloc_status
1322 {
1323 /* No errors detected */
1324 bfd_reloc_ok,
1325
1326 /* The relocation was performed, but there was an overflow. */
1327 bfd_reloc_overflow,
1328
1329 /* The address to relocate was not within the section supplied. */
1330 bfd_reloc_outofrange,
1331
1332 /* Used by special functions */
1333 bfd_reloc_continue,
1334
1335 /* Unsupported relocation size requested. */
1336 bfd_reloc_notsupported,
1337
1338 /* Unused */
1339 bfd_reloc_other,
1340
1341 /* The symbol to relocate against was undefined. */
1342 bfd_reloc_undefined,
1343
1344 /* The relocation was performed, but may not be ok - presently
1345 generated only when linking i960 coff files with i960 b.out
1346 symbols. If this type is returned, the error_message argument
1347 to bfd_perform_relocation will be set. */
1348 bfd_reloc_dangerous
1349 }
1350 bfd_reloc_status_type;
1351
1352
1353 typedef struct reloc_cache_entry
1354 {
1355 /* A pointer into the canonical table of pointers */
1356 struct symbol_cache_entry **sym_ptr_ptr;
1357
1358 /* offset in section */
1359 bfd_size_type address;
1360
1361 /* addend for relocation value */
1362 bfd_vma addend;
1363
1364 /* Pointer to how to perform the required relocation */
1365 reloc_howto_type *howto;
1366
1367 } arelent;
1368 enum complain_overflow
1369 {
1370 /* Do not complain on overflow. */
1371 complain_overflow_dont,
1372
1373 /* Complain if the bitfield overflows, whether it is considered
1374 as signed or unsigned. */
1375 complain_overflow_bitfield,
1376
1377 /* Complain if the value overflows when considered as signed
1378 number. */
1379 complain_overflow_signed,
1380
1381 /* Complain if the value overflows when considered as an
1382 unsigned number. */
1383 complain_overflow_unsigned
1384 };
1385
1386 struct reloc_howto_struct
1387 {
1388 /* The type field has mainly a documentary use - the back end can
1389 do what it wants with it, though normally the back end's
1390 external idea of what a reloc number is stored
1391 in this field. For example, a PC relative word relocation
1392 in a coff environment has the type 023 - because that's
1393 what the outside world calls a R_PCRWORD reloc. */
1394 unsigned int type;
1395
1396 /* The value the final relocation is shifted right by. This drops
1397 unwanted data from the relocation. */
1398 unsigned int rightshift;
1399
1400 /* The size of the item to be relocated. This is *not* a
1401 power-of-two measure. To get the number of bytes operated
1402 on by a type of relocation, use bfd_get_reloc_size. */
1403 int size;
1404
1405 /* The number of bits in the item to be relocated. This is used
1406 when doing overflow checking. */
1407 unsigned int bitsize;
1408
1409 /* Notes that the relocation is relative to the location in the
1410 data section of the addend. The relocation function will
1411 subtract from the relocation value the address of the location
1412 being relocated. */
1413 boolean pc_relative;
1414
1415 /* The bit position of the reloc value in the destination.
1416 The relocated value is left shifted by this amount. */
1417 unsigned int bitpos;
1418
1419 /* What type of overflow error should be checked for when
1420 relocating. */
1421 enum complain_overflow complain_on_overflow;
1422
1423 /* If this field is non null, then the supplied function is
1424 called rather than the normal function. This allows really
1425 strange relocation methods to be accomodated (e.g., i960 callj
1426 instructions). */
1427 bfd_reloc_status_type (*special_function)
1428 PARAMS ((bfd *abfd,
1429 arelent *reloc_entry,
1430 struct symbol_cache_entry *symbol,
1431 PTR data,
1432 asection *input_section,
1433 bfd *output_bfd,
1434 char **error_message));
1435
1436 /* The textual name of the relocation type. */
1437 char *name;
1438
1439 /* When performing a partial link, some formats must modify the
1440 relocations rather than the data - this flag signals this.*/
1441 boolean partial_inplace;
1442
1443 /* The src_mask selects which parts of the read in data
1444 are to be used in the relocation sum. E.g., if this was an 8 bit
1445 bit of data which we read and relocated, this would be
1446 0x000000ff. When we have relocs which have an addend, such as
1447 sun4 extended relocs, the value in the offset part of a
1448 relocating field is garbage so we never use it. In this case
1449 the mask would be 0x00000000. */
1450 bfd_vma src_mask;
1451
1452 /* The dst_mask selects which parts of the instruction are replaced
1453 into the instruction. In most cases src_mask == dst_mask,
1454 except in the above special case, where dst_mask would be
1455 0x000000ff, and src_mask would be 0x00000000. */
1456 bfd_vma dst_mask;
1457
1458 /* When some formats create PC relative instructions, they leave
1459 the value of the pc of the place being relocated in the offset
1460 slot of the instruction, so that a PC relative relocation can
1461 be made just by adding in an ordinary offset (e.g., sun3 a.out).
1462 Some formats leave the displacement part of an instruction
1463 empty (e.g., m88k bcs); this flag signals the fact.*/
1464 boolean pcrel_offset;
1465
1466 };
1467 #define HOWTO(C, R,S,B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
1468 {(unsigned)C,R,S,B, P, BI, O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC}
1469 #define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,complain_overflow_dont,FUNCTION, NAME,false,0,0,IN)
1470
1471 #define HOWTO_PREPARE(relocation, symbol) \
1472 { \
1473 if (symbol != (asymbol *)NULL) { \
1474 if (bfd_is_com_section (symbol->section)) { \
1475 relocation = 0; \
1476 } \
1477 else { \
1478 relocation = symbol->value; \
1479 } \
1480 } \
1481 }
1482 int
1483 bfd_get_reloc_size PARAMS ((reloc_howto_type *));
1484
1485 typedef struct relent_chain {
1486 arelent relent;
1487 struct relent_chain *next;
1488 } arelent_chain;
1489 bfd_reloc_status_type
1490
1491 bfd_perform_relocation
1492 PARAMS ((bfd *abfd,
1493 arelent *reloc_entry,
1494 PTR data,
1495 asection *input_section,
1496 bfd *output_bfd,
1497 char **error_message));
1498
1499 bfd_reloc_status_type
1500
1501 bfd_install_relocation
1502 PARAMS ((bfd *abfd,
1503 arelent *reloc_entry,
1504 PTR data, bfd_vma data_start,
1505 asection *input_section,
1506 char **error_message));
1507
1508 enum bfd_reloc_code_real {
1509 _dummy_first_bfd_reloc_code_real,
1510
1511
1512 /* Basic absolute relocations of N bits. */
1513 BFD_RELOC_64,
1514 BFD_RELOC_32,
1515 BFD_RELOC_26,
1516 BFD_RELOC_24,
1517 BFD_RELOC_16,
1518 BFD_RELOC_14,
1519 BFD_RELOC_8,
1520
1521 /* PC-relative relocations. Sometimes these are relative to the address
1522 of the relocation itself; sometimes they are relative to the start of
1523 the section containing the relocation. It depends on the specific target.
1524
1525 The 24-bit relocation is used in some Intel 960 configurations. */
1526 BFD_RELOC_64_PCREL,
1527 BFD_RELOC_32_PCREL,
1528 BFD_RELOC_24_PCREL,
1529 BFD_RELOC_16_PCREL,
1530 BFD_RELOC_12_PCREL,
1531 BFD_RELOC_8_PCREL,
1532
1533 /* For ELF. */
1534 BFD_RELOC_32_GOT_PCREL,
1535 BFD_RELOC_16_GOT_PCREL,
1536 BFD_RELOC_8_GOT_PCREL,
1537 BFD_RELOC_32_GOTOFF,
1538 BFD_RELOC_16_GOTOFF,
1539 BFD_RELOC_LO16_GOTOFF,
1540 BFD_RELOC_HI16_GOTOFF,
1541 BFD_RELOC_HI16_S_GOTOFF,
1542 BFD_RELOC_8_GOTOFF,
1543 BFD_RELOC_32_PLT_PCREL,
1544 BFD_RELOC_24_PLT_PCREL,
1545 BFD_RELOC_16_PLT_PCREL,
1546 BFD_RELOC_8_PLT_PCREL,
1547 BFD_RELOC_32_PLTOFF,
1548 BFD_RELOC_16_PLTOFF,
1549 BFD_RELOC_LO16_PLTOFF,
1550 BFD_RELOC_HI16_PLTOFF,
1551 BFD_RELOC_HI16_S_PLTOFF,
1552 BFD_RELOC_8_PLTOFF,
1553
1554 /* Relocations used by 68K ELF. */
1555 BFD_RELOC_68K_GLOB_DAT,
1556 BFD_RELOC_68K_JMP_SLOT,
1557 BFD_RELOC_68K_RELATIVE,
1558
1559 /* Linkage-table relative. */
1560 BFD_RELOC_32_BASEREL,
1561 BFD_RELOC_16_BASEREL,
1562 BFD_RELOC_LO16_BASEREL,
1563 BFD_RELOC_HI16_BASEREL,
1564 BFD_RELOC_HI16_S_BASEREL,
1565 BFD_RELOC_8_BASEREL,
1566 BFD_RELOC_RVA,
1567
1568 /* Absolute 8-bit relocation, but used to form an address like 0xFFnn. */
1569 BFD_RELOC_8_FFnn,
1570
1571 /* These PC-relative relocations are stored as word displacements --
1572 i.e., byte displacements shifted right two bits. The 30-bit word
1573 displacement (<<32_PCREL_S2>> -- 32 bits, shifted 2) is used on the
1574 SPARC. (SPARC tools generally refer to this as <<WDISP30>>.) The
1575 signed 16-bit displacement is used on the MIPS, and the 23-bit
1576 displacement is used on the Alpha. */
1577 BFD_RELOC_32_PCREL_S2,
1578 BFD_RELOC_16_PCREL_S2,
1579 BFD_RELOC_23_PCREL_S2,
1580
1581 /* High 22 bits and low 10 bits of 32-bit value, placed into lower bits of
1582 the target word. These are used on the SPARC. */
1583 BFD_RELOC_HI22,
1584 BFD_RELOC_LO10,
1585
1586 /* For systems that allocate a Global Pointer register, these are
1587 displacements off that register. These relocation types are
1588 handled specially, because the value the register will have is
1589 decided relatively late. */
1590 BFD_RELOC_GPREL16,
1591 BFD_RELOC_GPREL32,
1592
1593 /* Reloc types used for i960/b.out. */
1594 BFD_RELOC_I960_CALLJ,
1595
1596 /* SPARC ELF relocations. There is probably some overlap with other
1597 relocation types already defined. */
1598 BFD_RELOC_NONE,
1599 BFD_RELOC_SPARC_WDISP22,
1600 BFD_RELOC_SPARC22,
1601 BFD_RELOC_SPARC13,
1602 BFD_RELOC_SPARC_GOT10,
1603 BFD_RELOC_SPARC_GOT13,
1604 BFD_RELOC_SPARC_GOT22,
1605 BFD_RELOC_SPARC_PC10,
1606 BFD_RELOC_SPARC_PC22,
1607 BFD_RELOC_SPARC_WPLT30,
1608 BFD_RELOC_SPARC_COPY,
1609 BFD_RELOC_SPARC_GLOB_DAT,
1610 BFD_RELOC_SPARC_JMP_SLOT,
1611 BFD_RELOC_SPARC_RELATIVE,
1612 BFD_RELOC_SPARC_UA32,
1613
1614 /* I think these are specific to SPARC a.out (e.g., Sun 4). */
1615 BFD_RELOC_SPARC_BASE13,
1616 BFD_RELOC_SPARC_BASE22,
1617
1618 /* Some relocations we're using for SPARC V9 -- subject to change. */
1619 #define BFD_RELOC_SPARC_64 BFD_RELOC_64
1620 BFD_RELOC_SPARC_10,
1621 BFD_RELOC_SPARC_11,
1622 BFD_RELOC_SPARC_OLO10,
1623 BFD_RELOC_SPARC_HH22,
1624 BFD_RELOC_SPARC_HM10,
1625 BFD_RELOC_SPARC_LM22,
1626 BFD_RELOC_SPARC_PC_HH22,
1627 BFD_RELOC_SPARC_PC_HM10,
1628 BFD_RELOC_SPARC_PC_LM22,
1629 BFD_RELOC_SPARC_WDISP16,
1630 BFD_RELOC_SPARC_WDISP19,
1631 BFD_RELOC_SPARC_GLOB_JMP,
1632 BFD_RELOC_SPARC_7,
1633 BFD_RELOC_SPARC_6,
1634 BFD_RELOC_SPARC_5,
1635
1636 /* Alpha ECOFF and ELF relocations. Some of these treat the symbol or
1637 "addend" in some special way.
1638 For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
1639 writing; when reading, it will be the absolute section symbol. The
1640 addend is the displacement in bytes of the "lda" instruction from
1641 the "ldah" instruction (which is at the address of this reloc). */
1642 BFD_RELOC_ALPHA_GPDISP_HI16,
1643
1644 /* For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
1645 with GPDISP_HI16 relocs. The addend is ignored when writing the
1646 relocations out, and is filled in with the file's GP value on
1647 reading, for convenience. */
1648 BFD_RELOC_ALPHA_GPDISP_LO16,
1649
1650 /* The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
1651 relocation except that there is no accompanying GPDISP_LO16
1652 relocation. */
1653 BFD_RELOC_ALPHA_GPDISP,
1654
1655 /* The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
1656 the assembler turns it into a LDQ instruction to load the address of
1657 the symbol, and then fills in a register in the real instruction.
1658
1659 The LITERAL reloc, at the LDQ instruction, refers to the .lita
1660 section symbol. The addend is ignored when writing, but is filled
1661 in with the file's GP value on reading, for convenience, as with the
1662 GPDISP_LO16 reloc.
1663
1664 The ELF_LITERAL reloc is somewhere between 16_GOTOFF and GPDISP_LO16.
1665 It should refer to the symbol to be referenced, as with 16_GOTOFF,
1666 but it generates output not based on the position within the .got
1667 section, but relative to the GP value chosen for the file during the
1668 final link stage.
1669
1670 The LITUSE reloc, on the instruction using the loaded address, gives
1671 information to the linker that it might be able to use to optimize
1672 away some literal section references. The symbol is ignored (read
1673 as the absolute section symbol), and the "addend" indicates the type
1674 of instruction using the register:
1675 1 - "memory" fmt insn
1676 2 - byte-manipulation (byte offset reg)
1677 3 - jsr (target of branch)
1678
1679 The GNU linker currently doesn't do any of this optimizing. */
1680 BFD_RELOC_ALPHA_LITERAL,
1681 BFD_RELOC_ALPHA_ELF_LITERAL,
1682 BFD_RELOC_ALPHA_LITUSE,
1683
1684 /* The HINT relocation indicates a value that should be filled into the
1685 "hint" field of a jmp/jsr/ret instruction, for possible branch-
1686 prediction logic which may be provided on some processors. */
1687 BFD_RELOC_ALPHA_HINT,
1688
1689 /* The LINKAGE relocation outputs a linkage pair in the object file,
1690 which is filled by the linker. */
1691 BFD_RELOC_ALPHA_LINKAGE,
1692
1693 /* The CODEADDR relocation outputs a STO_CA in the object file,
1694 which is filled by the linker. */
1695 BFD_RELOC_ALPHA_CODEADDR,
1696
1697 /* Bits 27..2 of the relocation address shifted right 2 bits;
1698 simple reloc otherwise. */
1699 BFD_RELOC_MIPS_JMP,
1700
1701 /* The MIPS16 jump instruction. */
1702 BFD_RELOC_MIPS16_JMP,
1703
1704 /* MIPS16 GP relative reloc. */
1705 BFD_RELOC_MIPS16_GPREL,
1706
1707 /* High 16 bits of 32-bit value; simple reloc. */
1708 BFD_RELOC_HI16,
1709
1710 /* High 16 bits of 32-bit value but the low 16 bits will be sign
1711 extended and added to form the final result. If the low 16
1712 bits form a negative number, we need to add one to the high value
1713 to compensate for the borrow when the low bits are added. */
1714 BFD_RELOC_HI16_S,
1715
1716 /* Low 16 bits. */
1717 BFD_RELOC_LO16,
1718
1719 /* Like BFD_RELOC_HI16_S, but PC relative. */
1720 BFD_RELOC_PCREL_HI16_S,
1721
1722 /* Like BFD_RELOC_LO16, but PC relative. */
1723 BFD_RELOC_PCREL_LO16,
1724
1725 /* Relocation relative to the global pointer. */
1726 #define BFD_RELOC_MIPS_GPREL BFD_RELOC_GPREL16
1727
1728 /* Relocation against a MIPS literal section. */
1729 BFD_RELOC_MIPS_LITERAL,
1730
1731 /* MIPS ELF relocations. */
1732 BFD_RELOC_MIPS_GOT16,
1733 BFD_RELOC_MIPS_CALL16,
1734 #define BFD_RELOC_MIPS_GPREL32 BFD_RELOC_GPREL32
1735 BFD_RELOC_MIPS_GOT_HI16,
1736 BFD_RELOC_MIPS_GOT_LO16,
1737 BFD_RELOC_MIPS_CALL_HI16,
1738 BFD_RELOC_MIPS_CALL_LO16,
1739
1740 /* i386/elf relocations */
1741 BFD_RELOC_386_GOT32,
1742 BFD_RELOC_386_PLT32,
1743 BFD_RELOC_386_COPY,
1744 BFD_RELOC_386_GLOB_DAT,
1745 BFD_RELOC_386_JUMP_SLOT,
1746 BFD_RELOC_386_RELATIVE,
1747 BFD_RELOC_386_GOTOFF,
1748 BFD_RELOC_386_GOTPC,
1749
1750 /* ns32k relocations */
1751 BFD_RELOC_NS32K_IMM_8,
1752 BFD_RELOC_NS32K_IMM_16,
1753 BFD_RELOC_NS32K_IMM_32,
1754 BFD_RELOC_NS32K_IMM_8_PCREL,
1755 BFD_RELOC_NS32K_IMM_16_PCREL,
1756 BFD_RELOC_NS32K_IMM_32_PCREL,
1757 BFD_RELOC_NS32K_DISP_8,
1758 BFD_RELOC_NS32K_DISP_16,
1759 BFD_RELOC_NS32K_DISP_32,
1760 BFD_RELOC_NS32K_DISP_8_PCREL,
1761 BFD_RELOC_NS32K_DISP_16_PCREL,
1762 BFD_RELOC_NS32K_DISP_32_PCREL,
1763
1764 /* Power(rs6000) and PowerPC relocations. */
1765 BFD_RELOC_PPC_B26,
1766 BFD_RELOC_PPC_BA26,
1767 BFD_RELOC_PPC_TOC16,
1768 BFD_RELOC_PPC_B16,
1769 BFD_RELOC_PPC_B16_BRTAKEN,
1770 BFD_RELOC_PPC_B16_BRNTAKEN,
1771 BFD_RELOC_PPC_BA16,
1772 BFD_RELOC_PPC_BA16_BRTAKEN,
1773 BFD_RELOC_PPC_BA16_BRNTAKEN,
1774 BFD_RELOC_PPC_COPY,
1775 BFD_RELOC_PPC_GLOB_DAT,
1776 BFD_RELOC_PPC_JMP_SLOT,
1777 BFD_RELOC_PPC_RELATIVE,
1778 BFD_RELOC_PPC_LOCAL24PC,
1779 BFD_RELOC_PPC_EMB_NADDR32,
1780 BFD_RELOC_PPC_EMB_NADDR16,
1781 BFD_RELOC_PPC_EMB_NADDR16_LO,
1782 BFD_RELOC_PPC_EMB_NADDR16_HI,
1783 BFD_RELOC_PPC_EMB_NADDR16_HA,
1784 BFD_RELOC_PPC_EMB_SDAI16,
1785 BFD_RELOC_PPC_EMB_SDA2I16,
1786 BFD_RELOC_PPC_EMB_SDA2REL,
1787 BFD_RELOC_PPC_EMB_SDA21,
1788 BFD_RELOC_PPC_EMB_MRKREF,
1789 BFD_RELOC_PPC_EMB_RELSEC16,
1790 BFD_RELOC_PPC_EMB_RELST_LO,
1791 BFD_RELOC_PPC_EMB_RELST_HI,
1792 BFD_RELOC_PPC_EMB_RELST_HA,
1793 BFD_RELOC_PPC_EMB_BIT_FLD,
1794 BFD_RELOC_PPC_EMB_RELSDA,
1795
1796 /* The type of reloc used to build a contructor table - at the moment
1797 probably a 32 bit wide absolute relocation, but the target can choose.
1798 It generally does map to one of the other relocation types. */
1799 BFD_RELOC_CTOR,
1800
1801 /* ARM 26 bit pc-relative branch. The lowest two bits must be zero and are
1802 not stored in the instruction. */
1803 BFD_RELOC_ARM_PCREL_BRANCH,
1804
1805 /* These relocs are only used within the ARM assembler. They are not
1806 (at present) written to any object files. */
1807 BFD_RELOC_ARM_IMMEDIATE,
1808 BFD_RELOC_ARM_OFFSET_IMM,
1809 BFD_RELOC_ARM_SHIFT_IMM,
1810 BFD_RELOC_ARM_SWI,
1811 BFD_RELOC_ARM_MULTI,
1812 BFD_RELOC_ARM_CP_OFF_IMM,
1813 BFD_RELOC_ARM_ADR_IMM,
1814 BFD_RELOC_ARM_LDR_IMM,
1815 BFD_RELOC_ARM_LITERAL,
1816 BFD_RELOC_ARM_IN_POOL,
1817 BFD_RELOC_ARM_OFFSET_IMM8,
1818 BFD_RELOC_ARM_HWLITERAL,
1819 BFD_RELOC_ARM_THUMB_ADD,
1820 BFD_RELOC_ARM_THUMB_IMM,
1821 BFD_RELOC_ARM_THUMB_SHIFT,
1822 BFD_RELOC_ARM_THUMB_OFFSET,
1823
1824 /* Hitachi SH relocs. Not all of these appear in object files. */
1825 BFD_RELOC_SH_PCDISP8BY2,
1826 BFD_RELOC_SH_PCDISP12BY2,
1827 BFD_RELOC_SH_IMM4,
1828 BFD_RELOC_SH_IMM4BY2,
1829 BFD_RELOC_SH_IMM4BY4,
1830 BFD_RELOC_SH_IMM8,
1831 BFD_RELOC_SH_IMM8BY2,
1832 BFD_RELOC_SH_IMM8BY4,
1833 BFD_RELOC_SH_PCRELIMM8BY2,
1834 BFD_RELOC_SH_PCRELIMM8BY4,
1835 BFD_RELOC_SH_SWITCH16,
1836 BFD_RELOC_SH_SWITCH32,
1837 BFD_RELOC_SH_USES,
1838 BFD_RELOC_SH_COUNT,
1839 BFD_RELOC_SH_ALIGN,
1840 BFD_RELOC_SH_CODE,
1841 BFD_RELOC_SH_DATA,
1842 BFD_RELOC_SH_LABEL,
1843
1844 /* Thumb 23-, 12- and 9-bit pc-relative branches. The lowest bit must
1845 be zero and is not stored in the instruction. */
1846 BFD_RELOC_THUMB_PCREL_BRANCH9,
1847 BFD_RELOC_THUMB_PCREL_BRANCH12,
1848 BFD_RELOC_THUMB_PCREL_BRANCH23,
1849
1850 /* Argonaut RISC Core (ARC) relocs.
1851 ARC 22 bit pc-relative branch. The lowest two bits must be zero and are
1852 not stored in the instruction. The high 20 bits are installed in bits 26
1853 through 7 of the instruction. */
1854 BFD_RELOC_ARC_B22_PCREL,
1855
1856 /* ARC 26 bit absolute branch. The lowest two bits must be zero and are not
1857 stored in the instruction. The high 24 bits are installed in bits 23
1858 through 0. */
1859 BFD_RELOC_ARC_B26,
1860
1861 /* Mitsubishi D10V relocs.
1862 This is a 10-bit reloc with the right 2 bits
1863 assumed to be 0. */
1864 BFD_RELOC_D10V_10_PCREL_R,
1865
1866 /* Mitsubishi D10V relocs.
1867 This is a 10-bit reloc with the right 2 bits
1868 assumed to be 0. This is the same as the previous reloc
1869 except it is in the left container, i.e.,
1870 shifted left 15 bits. */
1871 BFD_RELOC_D10V_10_PCREL_L,
1872
1873 /* This is an 18-bit reloc with the right 2 bits
1874 assumed to be 0. */
1875 BFD_RELOC_D10V_18,
1876
1877 /* This is an 18-bit reloc with the right 2 bits
1878 assumed to be 0. */
1879 BFD_RELOC_D10V_18_PCREL,
1880
1881 /* start-sanitize-d30v */
1882
1883 /* Mitsubishi D30V relocs.
1884 This is a 6-bit absolute reloc. */
1885 BFD_RELOC_D30V_6,
1886
1887 /* Mitsubishi D30V relocs.
1888 This is a 12-bit absolute reloc with the
1889 right 3 bitsassumed to be 0. */
1890 BFD_RELOC_D30V_15,
1891
1892 /* Mitsubishi D30V relocs.
1893 This is a 12-bit pc-relative reloc with
1894 the right 3 bits assumed to be 0. */
1895 BFD_RELOC_D30V_15_PCREL,
1896
1897 /* This is an 18-bit absolute reloc with
1898 the right 3 bits assumed to be 0. */
1899 BFD_RELOC_D30V_21,
1900
1901 /* This is an 18-bit pc-relative reloc with
1902 the right 3 bits assumed to be 0. */
1903 BFD_RELOC_D30V_21_PCREL,
1904
1905 /* This is a 32-bit absolute reloc. */
1906 BFD_RELOC_D30V_32,
1907
1908 /* This is a 32-bit pc-relative reloc. */
1909 BFD_RELOC_D30V_32_PCREL,
1910 /* end-sanitize-d30v */
1911
1912
1913 /* Mitsubishi M32R relocs.
1914 This is a 24 bit absolute address. */
1915 BFD_RELOC_M32R_24,
1916
1917 /* This is a 10-bit pc-relative reloc with the right 2 bits assumed to be 0. */
1918 BFD_RELOC_M32R_10_PCREL,
1919
1920 /* This is an 18-bit reloc with the right 2 bits assumed to be 0. */
1921 BFD_RELOC_M32R_18_PCREL,
1922
1923 /* This is a 26-bit reloc with the right 2 bits assumed to be 0. */
1924 BFD_RELOC_M32R_26_PCREL,
1925
1926 /* This is a 16-bit reloc containing the high 16 bits of an address
1927 used when the lower 16 bits are treated as unsigned. */
1928 BFD_RELOC_M32R_HI16_ULO,
1929
1930 /* This is a 16-bit reloc containing the high 16 bits of an address
1931 used when the lower 16 bits are treated as signed. */
1932 BFD_RELOC_M32R_HI16_SLO,
1933
1934 /* This is a 16-bit reloc containing the lower 16 bits of an address. */
1935 BFD_RELOC_M32R_LO16,
1936
1937 /* This is a 16-bit reloc containing the small data area offset for use in
1938 add3, load, and store instructions. */
1939 BFD_RELOC_M32R_SDA16,
1940 /* start-sanitize-v850 */
1941
1942 /* This is a 9-bit reloc */
1943 BFD_RELOC_V850_9_PCREL,
1944
1945 /* This is a 16-bit reloc */
1946 BFD_RELOC_V850_16_PCREL,
1947
1948 /* This is a 22-bit reloc */
1949 BFD_RELOC_V850_22_PCREL,
1950
1951 /* This is an offset from the short data area pointer.. */
1952 BFD_RELOC_V850_SDA_OFFSET,
1953
1954 /* This is an offset from the zero data area pointer.. */
1955 BFD_RELOC_V850_ZDA_OFFSET,
1956
1957 /* This is an offset from the tiny data area pointer.. */
1958 BFD_RELOC_V850_TDA_OFFSET,
1959 /* end-sanitize-v850 */
1960
1961
1962 /* This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the
1963 instruction. */
1964 BFD_RELOC_MN10300_32_PCREL,
1965
1966 /* This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the
1967 instruction. */
1968 BFD_RELOC_MN10300_16_PCREL,
1969 BFD_RELOC_UNUSED };
1970 typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
1971 reloc_howto_type *
1972
1973 bfd_reloc_type_lookup PARAMS ((bfd *abfd, bfd_reloc_code_real_type code));
1974
1975 const char *
1976 bfd_get_reloc_code_name PARAMS ((bfd_reloc_code_real_type code));
1977
1978
1979 typedef struct symbol_cache_entry
1980 {
1981 /* A pointer to the BFD which owns the symbol. This information
1982 is necessary so that a back end can work out what additional
1983 information (invisible to the application writer) is carried
1984 with the symbol.
1985
1986 This field is *almost* redundant, since you can use section->owner
1987 instead, except that some symbols point to the global sections
1988 bfd_{abs,com,und}_section. This could be fixed by making
1989 these globals be per-bfd (or per-target-flavor). FIXME. */
1990
1991 struct _bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field. */
1992
1993 /* The text of the symbol. The name is left alone, and not copied; the
1994 application may not alter it. */
1995 CONST char *name;
1996
1997 /* The value of the symbol. This really should be a union of a
1998 numeric value with a pointer, since some flags indicate that
1999 a pointer to another symbol is stored here. */
2000 symvalue value;
2001
2002 /* Attributes of a symbol: */
2003
2004 #define BSF_NO_FLAGS 0x00
2005
2006 /* The symbol has local scope; <<static>> in <<C>>. The value
2007 is the offset into the section of the data. */
2008 #define BSF_LOCAL 0x01
2009
2010 /* The symbol has global scope; initialized data in <<C>>. The
2011 value is the offset into the section of the data. */
2012 #define BSF_GLOBAL 0x02
2013
2014 /* The symbol has global scope and is exported. The value is
2015 the offset into the section of the data. */
2016 #define BSF_EXPORT BSF_GLOBAL /* no real difference */
2017
2018 /* A normal C symbol would be one of:
2019 <<BSF_LOCAL>>, <<BSF_FORT_COMM>>, <<BSF_UNDEFINED>> or
2020 <<BSF_GLOBAL>> */
2021
2022 /* The symbol is a debugging record. The value has an arbitary
2023 meaning. */
2024 #define BSF_DEBUGGING 0x08
2025
2026 /* The symbol denotes a function entry point. Used in ELF,
2027 perhaps others someday. */
2028 #define BSF_FUNCTION 0x10
2029
2030 /* Used by the linker. */
2031 #define BSF_KEEP 0x20
2032 #define BSF_KEEP_G 0x40
2033
2034 /* A weak global symbol, overridable without warnings by
2035 a regular global symbol of the same name. */
2036 #define BSF_WEAK 0x80
2037
2038 /* This symbol was created to point to a section, e.g. ELF's
2039 STT_SECTION symbols. */
2040 #define BSF_SECTION_SYM 0x100
2041
2042 /* The symbol used to be a common symbol, but now it is
2043 allocated. */
2044 #define BSF_OLD_COMMON 0x200
2045
2046 /* The default value for common data. */
2047 #define BFD_FORT_COMM_DEFAULT_VALUE 0
2048
2049 /* In some files the type of a symbol sometimes alters its
2050 location in an output file - ie in coff a <<ISFCN>> symbol
2051 which is also <<C_EXT>> symbol appears where it was
2052 declared and not at the end of a section. This bit is set
2053 by the target BFD part to convey this information. */
2054
2055 #define BSF_NOT_AT_END 0x400
2056
2057 /* Signal that the symbol is the label of constructor section. */
2058 #define BSF_CONSTRUCTOR 0x800
2059
2060 /* Signal that the symbol is a warning symbol. The name is a
2061 warning. The name of the next symbol is the one to warn about;
2062 if a reference is made to a symbol with the same name as the next
2063 symbol, a warning is issued by the linker. */
2064 #define BSF_WARNING 0x1000
2065
2066 /* Signal that the symbol is indirect. This symbol is an indirect
2067 pointer to the symbol with the same name as the next symbol. */
2068 #define BSF_INDIRECT 0x2000
2069
2070 /* BSF_FILE marks symbols that contain a file name. This is used
2071 for ELF STT_FILE symbols. */
2072 #define BSF_FILE 0x4000
2073
2074 /* Symbol is from dynamic linking information. */
2075 #define BSF_DYNAMIC 0x8000
2076
2077 /* The symbol denotes a data object. Used in ELF, and perhaps
2078 others someday. */
2079 #define BSF_OBJECT 0x10000
2080
2081 flagword flags;
2082
2083 /* A pointer to the section to which this symbol is
2084 relative. This will always be non NULL, there are special
2085 sections for undefined and absolute symbols. */
2086 struct sec *section;
2087
2088 /* Back end special data. */
2089 union
2090 {
2091 PTR p;
2092 bfd_vma i;
2093 } udata;
2094
2095 } asymbol;
2096 #define bfd_get_symtab_upper_bound(abfd) \
2097 BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
2098 boolean
2099 bfd_is_local_label PARAMS ((bfd *abfd, asymbol *sym));
2100
2101 boolean
2102 bfd_is_local_label_name PARAMS ((bfd *abfd, const char *name));
2103
2104 #define bfd_is_local_label_name(abfd, name) \
2105 BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
2106 #define bfd_canonicalize_symtab(abfd, location) \
2107 BFD_SEND (abfd, _bfd_canonicalize_symtab,\
2108 (abfd, location))
2109 boolean
2110 bfd_set_symtab PARAMS ((bfd *abfd, asymbol **location, unsigned int count));
2111
2112 void
2113 bfd_print_symbol_vandf PARAMS ((PTR file, asymbol *symbol));
2114
2115 #define bfd_make_empty_symbol(abfd) \
2116 BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
2117 #define bfd_make_debug_symbol(abfd,ptr,size) \
2118 BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
2119 int
2120 bfd_decode_symclass PARAMS ((asymbol *symbol));
2121
2122 void
2123 bfd_symbol_info PARAMS ((asymbol *symbol, symbol_info *ret));
2124
2125 boolean
2126 bfd_copy_private_symbol_data PARAMS ((bfd *ibfd, asymbol *isym, bfd *obfd, asymbol *osym));
2127
2128 #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
2129 BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
2130 (ibfd, isymbol, obfd, osymbol))
2131 struct _bfd
2132 {
2133 /* The filename the application opened the BFD with. */
2134 CONST char *filename;
2135
2136 /* A pointer to the target jump table. */
2137 const struct bfd_target *xvec;
2138
2139 /* To avoid dragging too many header files into every file that
2140 includes `<<bfd.h>>', IOSTREAM has been declared as a "char
2141 *", and MTIME as a "long". Their correct types, to which they
2142 are cast when used, are "FILE *" and "time_t". The iostream
2143 is the result of an fopen on the filename. However, if the
2144 BFD_IN_MEMORY flag is set, then iostream is actually a pointer
2145 to a bfd_in_memory struct. */
2146 PTR iostream;
2147
2148 /* Is the file descriptor being cached? That is, can it be closed as
2149 needed, and re-opened when accessed later? */
2150
2151 boolean cacheable;
2152
2153 /* Marks whether there was a default target specified when the
2154 BFD was opened. This is used to select which matching algorithm
2155 to use to choose the back end. */
2156
2157 boolean target_defaulted;
2158
2159 /* The caching routines use these to maintain a
2160 least-recently-used list of BFDs */
2161
2162 struct _bfd *lru_prev, *lru_next;
2163
2164 /* When a file is closed by the caching routines, BFD retains
2165 state information on the file here: */
2166
2167 file_ptr where;
2168
2169 /* and here: (``once'' means at least once) */
2170
2171 boolean opened_once;
2172
2173 /* Set if we have a locally maintained mtime value, rather than
2174 getting it from the file each time: */
2175
2176 boolean mtime_set;
2177
2178 /* File modified time, if mtime_set is true: */
2179
2180 long mtime;
2181
2182 /* Reserved for an unimplemented file locking extension.*/
2183
2184 int ifd;
2185
2186 /* The format which belongs to the BFD. (object, core, etc.) */
2187
2188 bfd_format format;
2189
2190 /* The direction the BFD was opened with*/
2191
2192 enum bfd_direction {no_direction = 0,
2193 read_direction = 1,
2194 write_direction = 2,
2195 both_direction = 3} direction;
2196
2197 /* Format_specific flags*/
2198
2199 flagword flags;
2200
2201 /* Currently my_archive is tested before adding origin to
2202 anything. I believe that this can become always an add of
2203 origin, with origin set to 0 for non archive files. */
2204
2205 file_ptr origin;
2206
2207 /* Remember when output has begun, to stop strange things
2208 from happening. */
2209 boolean output_has_begun;
2210
2211 /* Pointer to linked list of sections*/
2212 struct sec *sections;
2213
2214 /* The number of sections */
2215 unsigned int section_count;
2216
2217 /* Stuff only useful for object files:
2218 The start address. */
2219 bfd_vma start_address;
2220
2221 /* Used for input and output*/
2222 unsigned int symcount;
2223
2224 /* Symbol table for output BFD (with symcount entries) */
2225 struct symbol_cache_entry **outsymbols;
2226
2227 /* Pointer to structure which contains architecture information*/
2228 const struct bfd_arch_info *arch_info;
2229
2230 /* Stuff only useful for archives:*/
2231 PTR arelt_data;
2232 struct _bfd *my_archive; /* The containing archive BFD. */
2233 struct _bfd *next; /* The next BFD in the archive. */
2234 struct _bfd *archive_head; /* The first BFD in the archive. */
2235 boolean has_armap;
2236
2237 /* A chain of BFD structures involved in a link. */
2238 struct _bfd *link_next;
2239
2240 /* A field used by _bfd_generic_link_add_archive_symbols. This will
2241 be used only for archive elements. */
2242 int archive_pass;
2243
2244 /* Used by the back end to hold private data. */
2245
2246 union
2247 {
2248 struct aout_data_struct *aout_data;
2249 struct artdata *aout_ar_data;
2250 struct _oasys_data *oasys_obj_data;
2251 struct _oasys_ar_data *oasys_ar_data;
2252 struct coff_tdata *coff_obj_data;
2253 struct pe_tdata *pe_obj_data;
2254 struct xcoff_tdata *xcoff_obj_data;
2255 struct ecoff_tdata *ecoff_obj_data;
2256 struct ieee_data_struct *ieee_data;
2257 struct ieee_ar_data_struct *ieee_ar_data;
2258 struct srec_data_struct *srec_data;
2259 struct ihex_data_struct *ihex_data;
2260 struct tekhex_data_struct *tekhex_data;
2261 struct elf_obj_tdata *elf_obj_data;
2262 struct nlm_obj_tdata *nlm_obj_data;
2263 struct bout_data_struct *bout_data;
2264 struct sun_core_struct *sun_core_data;
2265 struct trad_core_struct *trad_core_data;
2266 struct som_data_struct *som_data;
2267 struct hpux_core_struct *hpux_core_data;
2268 struct hppabsd_core_struct *hppabsd_core_data;
2269 struct sgi_core_struct *sgi_core_data;
2270 struct lynx_core_struct *lynx_core_data;
2271 struct osf_core_struct *osf_core_data;
2272 struct cisco_core_struct *cisco_core_data;
2273 struct versados_data_struct *versados_data;
2274 struct netbsd_core_struct *netbsd_core_data;
2275 PTR any;
2276 } tdata;
2277
2278 /* Used by the application to hold private data*/
2279 PTR usrdata;
2280
2281 /* Where all the allocated stuff under this BFD goes. This is a
2282 struct objalloc *, but we use PTR to avoid requiring the inclusion of
2283 objalloc.h. */
2284 PTR memory;
2285 };
2286
2287 typedef enum bfd_error
2288 {
2289 bfd_error_no_error = 0,
2290 bfd_error_system_call,
2291 bfd_error_invalid_target,
2292 bfd_error_wrong_format,
2293 bfd_error_invalid_operation,
2294 bfd_error_no_memory,
2295 bfd_error_no_symbols,
2296 bfd_error_no_armap,
2297 bfd_error_no_more_archived_files,
2298 bfd_error_malformed_archive,
2299 bfd_error_file_not_recognized,
2300 bfd_error_file_ambiguously_recognized,
2301 bfd_error_no_contents,
2302 bfd_error_nonrepresentable_section,
2303 bfd_error_no_debug_section,
2304 bfd_error_bad_value,
2305 bfd_error_file_truncated,
2306 bfd_error_file_too_big,
2307 bfd_error_invalid_error_code
2308 } bfd_error_type;
2309
2310 bfd_error_type
2311 bfd_get_error PARAMS ((void));
2312
2313 void
2314 bfd_set_error PARAMS ((bfd_error_type error_tag));
2315
2316 CONST char *
2317 bfd_errmsg PARAMS ((bfd_error_type error_tag));
2318
2319 void
2320 bfd_perror PARAMS ((CONST char *message));
2321
2322 typedef void (*bfd_error_handler_type) PARAMS ((const char *, ...));
2323
2324 bfd_error_handler_type
2325 bfd_set_error_handler PARAMS ((bfd_error_handler_type));
2326
2327 void
2328 bfd_set_error_program_name PARAMS ((const char *));
2329
2330 long
2331 bfd_get_reloc_upper_bound PARAMS ((bfd *abfd, asection *sect));
2332
2333 long
2334 bfd_canonicalize_reloc
2335 PARAMS ((bfd *abfd,
2336 asection *sec,
2337 arelent **loc,
2338 asymbol **syms));
2339
2340 void
2341 bfd_set_reloc
2342 PARAMS ((bfd *abfd, asection *sec, arelent **rel, unsigned int count)
2343
2344 );
2345
2346 boolean
2347 bfd_set_file_flags PARAMS ((bfd *abfd, flagword flags));
2348
2349 boolean
2350 bfd_set_start_address PARAMS ((bfd *abfd, bfd_vma vma));
2351
2352 long
2353 bfd_get_mtime PARAMS ((bfd *abfd));
2354
2355 long
2356 bfd_get_size PARAMS ((bfd *abfd));
2357
2358 int
2359 bfd_get_gp_size PARAMS ((bfd *abfd));
2360
2361 void
2362 bfd_set_gp_size PARAMS ((bfd *abfd, int i));
2363
2364 bfd_vma
2365 bfd_scan_vma PARAMS ((CONST char *string, CONST char **end, int base));
2366
2367 boolean
2368 bfd_copy_private_bfd_data PARAMS ((bfd *ibfd, bfd *obfd));
2369
2370 #define bfd_copy_private_bfd_data(ibfd, obfd) \
2371 BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
2372 (ibfd, obfd))
2373 boolean
2374 bfd_merge_private_bfd_data PARAMS ((bfd *ibfd, bfd *obfd));
2375
2376 #define bfd_merge_private_bfd_data(ibfd, obfd) \
2377 BFD_SEND (obfd, _bfd_merge_private_bfd_data, \
2378 (ibfd, obfd))
2379 boolean
2380 bfd_set_private_flags PARAMS ((bfd *abfd, flagword flags));
2381
2382 #define bfd_set_private_flags(abfd, flags) \
2383 BFD_SEND (abfd, _bfd_set_private_flags, \
2384 (abfd, flags))
2385 #define bfd_sizeof_headers(abfd, reloc) \
2386 BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc))
2387
2388 #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
2389 BFD_SEND (abfd, _bfd_find_nearest_line, (abfd, sec, syms, off, file, func, line))
2390
2391 /* Do these three do anything useful at all, for any back end? */
2392 #define bfd_debug_info_start(abfd) \
2393 BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
2394
2395 #define bfd_debug_info_end(abfd) \
2396 BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
2397
2398 #define bfd_debug_info_accumulate(abfd, section) \
2399 BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
2400
2401
2402 #define bfd_stat_arch_elt(abfd, stat) \
2403 BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
2404
2405 #define bfd_update_armap_timestamp(abfd) \
2406 BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
2407
2408 #define bfd_set_arch_mach(abfd, arch, mach)\
2409 BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
2410
2411 #define bfd_relax_section(abfd, section, link_info, again) \
2412 BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
2413
2414 #define bfd_link_hash_table_create(abfd) \
2415 BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
2416
2417 #define bfd_link_add_symbols(abfd, info) \
2418 BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
2419
2420 #define bfd_final_link(abfd, info) \
2421 BFD_SEND (abfd, _bfd_final_link, (abfd, info))
2422
2423 #define bfd_free_cached_info(abfd) \
2424 BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
2425
2426 #define bfd_get_dynamic_symtab_upper_bound(abfd) \
2427 BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
2428
2429 #define bfd_print_private_bfd_data(abfd, file)\
2430 BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
2431
2432 #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
2433 BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
2434
2435 #define bfd_get_dynamic_reloc_upper_bound(abfd) \
2436 BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
2437
2438 #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
2439 BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
2440
2441 extern bfd_byte *bfd_get_relocated_section_contents
2442 PARAMS ((bfd *, struct bfd_link_info *,
2443 struct bfd_link_order *, bfd_byte *,
2444 boolean, asymbol **));
2445
2446 symindex
2447 bfd_get_next_mapent PARAMS ((bfd *abfd, symindex previous, carsym **sym));
2448
2449 boolean
2450 bfd_set_archive_head PARAMS ((bfd *output, bfd *new_head));
2451
2452 bfd *
2453 bfd_openr_next_archived_file PARAMS ((bfd *archive, bfd *previous));
2454
2455 CONST char *
2456 bfd_core_file_failing_command PARAMS ((bfd *abfd));
2457
2458 int
2459 bfd_core_file_failing_signal PARAMS ((bfd *abfd));
2460
2461 boolean
2462 core_file_matches_executable_p
2463 PARAMS ((bfd *core_bfd, bfd *exec_bfd));
2464
2465 #define BFD_SEND(bfd, message, arglist) \
2466 ((*((bfd)->xvec->message)) arglist)
2467
2468 #ifdef DEBUG_BFD_SEND
2469 #undef BFD_SEND
2470 #define BFD_SEND(bfd, message, arglist) \
2471 (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
2472 ((*((bfd)->xvec->message)) arglist) : \
2473 (bfd_assert (__FILE__,__LINE__), NULL))
2474 #endif
2475 #define BFD_SEND_FMT(bfd, message, arglist) \
2476 (((bfd)->xvec->message[(int)((bfd)->format)]) arglist)
2477
2478 #ifdef DEBUG_BFD_SEND
2479 #undef BFD_SEND_FMT
2480 #define BFD_SEND_FMT(bfd, message, arglist) \
2481 (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
2482 (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) : \
2483 (bfd_assert (__FILE__,__LINE__), NULL))
2484 #endif
2485 enum bfd_flavour {
2486 bfd_target_unknown_flavour,
2487 bfd_target_aout_flavour,
2488 bfd_target_coff_flavour,
2489 bfd_target_ecoff_flavour,
2490 bfd_target_elf_flavour,
2491 bfd_target_ieee_flavour,
2492 bfd_target_nlm_flavour,
2493 bfd_target_oasys_flavour,
2494 bfd_target_tekhex_flavour,
2495 bfd_target_srec_flavour,
2496 bfd_target_ihex_flavour,
2497 bfd_target_som_flavour,
2498 bfd_target_os9k_flavour,
2499 bfd_target_versados_flavour,
2500 bfd_target_msdos_flavour,
2501 bfd_target_evax_flavour
2502 };
2503
2504 enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
2505
2506 /* Forward declaration. */
2507 typedef struct bfd_link_info _bfd_link_info;
2508
2509 typedef struct bfd_target
2510 {
2511 char *name;
2512 enum bfd_flavour flavour;
2513 enum bfd_endian byteorder;
2514 enum bfd_endian header_byteorder;
2515 flagword object_flags;
2516 flagword section_flags;
2517 char symbol_leading_char;
2518 char ar_pad_char;
2519 unsigned short ar_max_namelen;
2520 bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *));
2521 bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *));
2522 void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *));
2523 bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *));
2524 bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *));
2525 void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *));
2526 bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *));
2527 bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *));
2528 void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *));
2529 bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *));
2530 bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *));
2531 void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *));
2532 bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *));
2533 bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *));
2534 void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *));
2535 bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *));
2536 bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *));
2537 void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *));
2538 const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *));
2539 boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
2540 boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *));
2541
2542 /* Generic entry points. */
2543 #define BFD_JUMP_TABLE_GENERIC(NAME)\
2544 CAT(NAME,_close_and_cleanup),\
2545 CAT(NAME,_bfd_free_cached_info),\
2546 CAT(NAME,_new_section_hook),\
2547 CAT(NAME,_get_section_contents),\
2548 CAT(NAME,_get_section_contents_in_window)
2549
2550 /* Called when the BFD is being closed to do any necessary cleanup. */
2551 boolean (*_close_and_cleanup) PARAMS ((bfd *));
2552 /* Ask the BFD to free all cached information. */
2553 boolean (*_bfd_free_cached_info) PARAMS ((bfd *));
2554 /* Called when a new section is created. */
2555 boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr));
2556 /* Read the contents of a section. */
2557 boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
2558 file_ptr, bfd_size_type));
2559 boolean (*_bfd_get_section_contents_in_window)
2560 PARAMS ((bfd *, sec_ptr, bfd_window *,
2561 file_ptr, bfd_size_type));
2562
2563 /* Entry points to copy private data. */
2564 #define BFD_JUMP_TABLE_COPY(NAME)\
2565 CAT(NAME,_bfd_copy_private_bfd_data),\
2566 CAT(NAME,_bfd_merge_private_bfd_data),\
2567 CAT(NAME,_bfd_copy_private_section_data),\
2568 CAT(NAME,_bfd_copy_private_symbol_data),\
2569 CAT(NAME,_bfd_set_private_flags),\
2570 CAT(NAME,_bfd_print_private_bfd_data)\
2571 /* Called to copy BFD general private data from one object file
2572 to another. */
2573 boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *));
2574 /* Called to merge BFD general private data from one object file
2575 to a common output file when linking. */
2576 boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *));
2577 /* Called to copy BFD private section data from one object file
2578 to another. */
2579 boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr,
2580 bfd *, sec_ptr));
2581 /* Called to copy BFD private symbol data from one symbol
2582 to another. */
2583 boolean (*_bfd_copy_private_symbol_data) PARAMS ((bfd *, asymbol *,
2584 bfd *, asymbol *));
2585 /* Called to set private backend flags */
2586 boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword));
2587
2588 /* Called to print private BFD data */
2589 boolean (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR));
2590
2591 /* Core file entry points. */
2592 #define BFD_JUMP_TABLE_CORE(NAME)\
2593 CAT(NAME,_core_file_failing_command),\
2594 CAT(NAME,_core_file_failing_signal),\
2595 CAT(NAME,_core_file_matches_executable_p)
2596 char * (*_core_file_failing_command) PARAMS ((bfd *));
2597 int (*_core_file_failing_signal) PARAMS ((bfd *));
2598 boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *));
2599
2600 /* Archive entry points. */
2601 #define BFD_JUMP_TABLE_ARCHIVE(NAME)\
2602 CAT(NAME,_slurp_armap),\
2603 CAT(NAME,_slurp_extended_name_table),\
2604 CAT(NAME,_construct_extended_name_table),\
2605 CAT(NAME,_truncate_arname),\
2606 CAT(NAME,_write_armap),\
2607 CAT(NAME,_read_ar_hdr),\
2608 CAT(NAME,_openr_next_archived_file),\
2609 CAT(NAME,_get_elt_at_index),\
2610 CAT(NAME,_generic_stat_arch_elt),\
2611 CAT(NAME,_update_armap_timestamp)
2612 boolean (*_bfd_slurp_armap) PARAMS ((bfd *));
2613 boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *));
2614 boolean (*_bfd_construct_extended_name_table)
2615 PARAMS ((bfd *, char **, bfd_size_type *, const char **));
2616 void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *));
2617 boolean (*write_armap) PARAMS ((bfd *arch,
2618 unsigned int elength,
2619 struct orl *map,
2620 unsigned int orl_count,
2621 int stridx));
2622 PTR (*_bfd_read_ar_hdr_fn) PARAMS ((bfd *));
2623 bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev));
2624 #define bfd_get_elt_at_index(b,i) BFD_SEND(b, _bfd_get_elt_at_index, (b,i))
2625 bfd * (*_bfd_get_elt_at_index) PARAMS ((bfd *, symindex));
2626 int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *));
2627 boolean (*_bfd_update_armap_timestamp) PARAMS ((bfd *));
2628
2629 /* Entry points used for symbols. */
2630 #define BFD_JUMP_TABLE_SYMBOLS(NAME)\
2631 CAT(NAME,_get_symtab_upper_bound),\
2632 CAT(NAME,_get_symtab),\
2633 CAT(NAME,_make_empty_symbol),\
2634 CAT(NAME,_print_symbol),\
2635 CAT(NAME,_get_symbol_info),\
2636 CAT(NAME,_bfd_is_local_label_name),\
2637 CAT(NAME,_get_lineno),\
2638 CAT(NAME,_find_nearest_line),\
2639 CAT(NAME,_bfd_make_debug_symbol),\
2640 CAT(NAME,_read_minisymbols),\
2641 CAT(NAME,_minisymbol_to_symbol)
2642 long (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *));
2643 long (*_bfd_canonicalize_symtab) PARAMS ((bfd *,
2644 struct symbol_cache_entry **));
2645 struct symbol_cache_entry *
2646 (*_bfd_make_empty_symbol) PARAMS ((bfd *));
2647 void (*_bfd_print_symbol) PARAMS ((bfd *, PTR,
2648 struct symbol_cache_entry *,
2649 bfd_print_symbol_type));
2650 #define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e))
2651 void (*_bfd_get_symbol_info) PARAMS ((bfd *,
2652 struct symbol_cache_entry *,
2653 symbol_info *));
2654 #define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e))
2655 boolean (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *));
2656
2657 alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *));
2658 boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd,
2659 struct sec *section, struct symbol_cache_entry **symbols,
2660 bfd_vma offset, CONST char **file, CONST char **func,
2661 unsigned int *line));
2662 /* Back-door to allow format-aware applications to create debug symbols
2663 while using BFD for everything else. Currently used by the assembler
2664 when creating COFF files. */
2665 asymbol * (*_bfd_make_debug_symbol) PARAMS ((
2666 bfd *abfd,
2667 void *ptr,
2668 unsigned long size));
2669 #define bfd_read_minisymbols(b, d, m, s) \
2670 BFD_SEND (b, _read_minisymbols, (b, d, m, s))
2671 long (*_read_minisymbols) PARAMS ((bfd *, boolean, PTR *,
2672 unsigned int *));
2673 #define bfd_minisymbol_to_symbol(b, d, m, f) \
2674 BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
2675 asymbol *(*_minisymbol_to_symbol) PARAMS ((bfd *, boolean, const PTR,
2676 asymbol *));
2677
2678 /* Routines for relocs. */
2679 #define BFD_JUMP_TABLE_RELOCS(NAME)\
2680 CAT(NAME,_get_reloc_upper_bound),\
2681 CAT(NAME,_canonicalize_reloc),\
2682 CAT(NAME,_bfd_reloc_type_lookup)
2683 long (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr));
2684 long (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **,
2685 struct symbol_cache_entry **));
2686 /* See documentation on reloc types. */
2687 reloc_howto_type *
2688 (*reloc_type_lookup) PARAMS ((bfd *abfd,
2689 bfd_reloc_code_real_type code));
2690
2691 /* Routines used when writing an object file. */
2692 #define BFD_JUMP_TABLE_WRITE(NAME)\
2693 CAT(NAME,_set_arch_mach),\
2694 CAT(NAME,_set_section_contents)
2695 boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture,
2696 unsigned long));
2697 boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
2698 file_ptr, bfd_size_type));
2699
2700 /* Routines used by the linker. */
2701 #define BFD_JUMP_TABLE_LINK(NAME)\
2702 CAT(NAME,_sizeof_headers),\
2703 CAT(NAME,_bfd_get_relocated_section_contents),\
2704 CAT(NAME,_bfd_relax_section),\
2705 CAT(NAME,_bfd_link_hash_table_create),\
2706 CAT(NAME,_bfd_link_add_symbols),\
2707 CAT(NAME,_bfd_final_link),\
2708 CAT(NAME,_bfd_link_split_section)
2709 int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean));
2710 bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *,
2711 struct bfd_link_info *, struct bfd_link_order *,
2712 bfd_byte *data, boolean relocateable,
2713 struct symbol_cache_entry **));
2714
2715 boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *,
2716 struct bfd_link_info *, boolean *again));
2717
2718 /* Create a hash table for the linker. Different backends store
2719 different information in this table. */
2720 struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *));
2721
2722 /* Add symbols from this object file into the hash table. */
2723 boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *));
2724
2725 /* Do a link based on the link_order structures attached to each
2726 section of the BFD. */
2727 boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *));
2728
2729 /* Should this section be split up into smaller pieces during linking. */
2730 boolean (*_bfd_link_split_section) PARAMS ((bfd *, struct sec *));
2731
2732 /* Routines to handle dynamic symbols and relocs. */
2733 #define BFD_JUMP_TABLE_DYNAMIC(NAME)\
2734 CAT(NAME,_get_dynamic_symtab_upper_bound),\
2735 CAT(NAME,_canonicalize_dynamic_symtab),\
2736 CAT(NAME,_get_dynamic_reloc_upper_bound),\
2737 CAT(NAME,_canonicalize_dynamic_reloc)
2738 /* Get the amount of memory required to hold the dynamic symbols. */
2739 long (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *));
2740 /* Read in the dynamic symbols. */
2741 long (*_bfd_canonicalize_dynamic_symtab)
2742 PARAMS ((bfd *, struct symbol_cache_entry **));
2743 /* Get the amount of memory required to hold the dynamic relocs. */
2744 long (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *));
2745 /* Read in the dynamic relocs. */
2746 long (*_bfd_canonicalize_dynamic_reloc)
2747 PARAMS ((bfd *, arelent **, struct symbol_cache_entry **));
2748
2749 PTR backend_data;
2750 } bfd_target;
2751 boolean
2752 bfd_set_default_target PARAMS ((const char *name));
2753
2754 const bfd_target *
2755 bfd_find_target PARAMS ((CONST char *target_name, bfd *abfd));
2756
2757 const char **
2758 bfd_target_list PARAMS ((void));
2759
2760 boolean
2761 bfd_check_format PARAMS ((bfd *abfd, bfd_format format));
2762
2763 boolean
2764 bfd_check_format_matches PARAMS ((bfd *abfd, bfd_format format, char ***matching));
2765
2766 boolean
2767 bfd_set_format PARAMS ((bfd *abfd, bfd_format format));
2768
2769 CONST char *
2770 bfd_format_string PARAMS ((bfd_format format));
2771
2772 #ifdef __cplusplus
2773 }
2774 #endif
2775 #endif
This page took 0.08738 seconds and 5 git commands to generate.