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