1 /* libbfd.h -- Declarations used by bfd library *implementation*. 2 (This include file is not for users of the library.) 3 4 Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 5 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc. 6 7 Written by Cygnus Support. 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 /* Align an address upward to a boundary, expressed as a number of bytes. 26 E.g. align to an 8-byte boundary with argument of 8. Take care never 27 to wrap around if the address is within boundary-1 of the end of the 28 address space. */ 29 #define BFD_ALIGN(this, boundary) \ 30 ((((bfd_vma) (this) + (boundary) - 1) >= (bfd_vma) (this)) \ 31 ? (((bfd_vma) (this) + ((boundary) - 1)) & ~ (bfd_vma) ((boundary)-1)) \ 32 : ~ (bfd_vma) 0) 33 34 /* If you want to read and write large blocks, you might want to do it 35 in quanta of this amount */ 36 #define DEFAULT_BUFFERSIZE 8192 37 38 /* Set a tdata field. Can't use the other macros for this, since they 39 do casts, and casting to the left of assignment isn't portable. */ 40 #define set_tdata(bfd, v) ((bfd)->tdata.any = (v)) 41 42 /* If BFD_IN_MEMORY is set for a BFD, then the iostream fields points 43 to an instance of this structure. */ 44 45 struct bfd_in_memory 46 { 47 /* Size of buffer. */ 48 bfd_size_type size; 49 /* Buffer holding contents of BFD. */ 50 bfd_byte *buffer; 51 }; 52 53 /* tdata for an archive. For an input archive, cache 54 needs to be free()'d. For an output archive, symdefs do. */ 55 56 struct artdata { 57 file_ptr first_file_filepos; 58 /* Speed up searching the armap */ 59 struct ar_cache *cache; 60 bfd *archive_head; /* Only interesting in output routines */ 61 carsym *symdefs; /* the symdef entries */ 62 symindex symdef_count; /* how many there are */ 63 char *extended_names; /* clever intel extension */ 64 /* when more compilers are standard C, this can be a time_t */ 65 long armap_timestamp; /* Timestamp value written into armap. 66 This is used for BSD archives to check 67 that the timestamp is recent enough 68 for the BSD linker to not complain, 69 just before we finish writing an 70 archive. */ 71 file_ptr armap_datepos; /* Position within archive to seek to 72 rewrite the date field. */ 73 void *tdata; /* Backend specific information. */ 74 }; 75 76 #define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data) 77 78 /* Goes in bfd's arelt_data slot */ 79 struct areltdata { 80 char * arch_header; /* it's actually a string */ 81 unsigned int parsed_size; /* octets of filesize not including ar_hdr */ 82 char *filename; /* null-terminated */ 83 }; 84 85 #define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size) 86 87 extern void *bfd_malloc 88 (bfd_size_type); 89 extern void *bfd_realloc 90 (void *, bfd_size_type); 91 extern void *bfd_zmalloc 92 (bfd_size_type); 93 94 extern bfd_error_handler_type _bfd_error_handler; 95 96 /* These routines allocate and free things on the BFD's objalloc. */ 97 98 extern void *bfd_alloc 99 (bfd *, bfd_size_type); 100 extern void *bfd_zalloc 101 (bfd *, bfd_size_type); 102 extern void bfd_release 103 (bfd *, void *); 104 105 bfd * _bfd_create_empty_archive_element_shell 106 (bfd *obfd); 107 bfd * _bfd_look_for_bfd_in_cache 108 (bfd *, file_ptr); 109 bfd_boolean _bfd_add_bfd_to_archive_cache 110 (bfd *, file_ptr, bfd *); 111 bfd_boolean _bfd_generic_mkarchive 112 (bfd *abfd); 113 const bfd_target *bfd_generic_archive_p 114 (bfd *abfd); 115 bfd_boolean bfd_slurp_armap 116 (bfd *abfd); 117 bfd_boolean bfd_slurp_bsd_armap_f2 118 (bfd *abfd); 119 #define bfd_slurp_bsd_armap bfd_slurp_armap 120 #define bfd_slurp_coff_armap bfd_slurp_armap 121 bfd_boolean _bfd_slurp_extended_name_table 122 (bfd *abfd); 123 extern bfd_boolean _bfd_construct_extended_name_table 124 (bfd *, bfd_boolean, char **, bfd_size_type *); 125 bfd_boolean _bfd_write_archive_contents 126 (bfd *abfd); 127 bfd_boolean _bfd_compute_and_write_armap 128 (bfd *, unsigned int elength); 129 bfd *_bfd_get_elt_at_filepos 130 (bfd *archive, file_ptr filepos); 131 extern bfd *_bfd_generic_get_elt_at_index 132 (bfd *, symindex); 133 bfd * _bfd_new_bfd 134 (void); 135 void _bfd_delete_bfd 136 (bfd *); 137 138 bfd_boolean bfd_false 139 (bfd *ignore); 140 bfd_boolean bfd_true 141 (bfd *ignore); 142 void *bfd_nullvoidptr 143 (bfd *ignore); 144 int bfd_0 145 (bfd *ignore); 146 unsigned int bfd_0u 147 (bfd *ignore); 148 long bfd_0l 149 (bfd *ignore); 150 long _bfd_n1 151 (bfd *ignore); 152 void bfd_void 153 (bfd *ignore); 154 155 bfd *_bfd_new_bfd_contained_in 156 (bfd *); 157 const bfd_target *_bfd_dummy_target 158 (bfd *abfd); 159 160 void bfd_dont_truncate_arname 161 (bfd *abfd, const char *filename, char *hdr); 162 void bfd_bsd_truncate_arname 163 (bfd *abfd, const char *filename, char *hdr); 164 void bfd_gnu_truncate_arname 165 (bfd *abfd, const char *filename, char *hdr); 166 167 bfd_boolean bsd_write_armap 168 (bfd *arch, unsigned int elength, struct orl *map, unsigned int orl_count, 169 int stridx); 170 171 bfd_boolean coff_write_armap 172 (bfd *arch, unsigned int elength, struct orl *map, unsigned int orl_count, 173 int stridx); 174 175 extern void *_bfd_generic_read_ar_hdr 176 (bfd *); 177 178 extern void *_bfd_generic_read_ar_hdr_mag 179 (bfd *, const char *); 180 181 bfd * bfd_generic_openr_next_archived_file 182 (bfd *archive, bfd *last_file); 183 184 int bfd_generic_stat_arch_elt 185 (bfd *, struct stat *); 186 187 #define _bfd_read_ar_hdr(abfd) \ 188 BFD_SEND (abfd, _bfd_read_ar_hdr_fn, (abfd)) 189 190 /* Generic routines to use for BFD_JUMP_TABLE_GENERIC. Use 191 BFD_JUMP_TABLE_GENERIC (_bfd_generic). */ 192 193 #define _bfd_generic_close_and_cleanup bfd_true 194 #define _bfd_generic_bfd_free_cached_info bfd_true 195 #define _bfd_generic_new_section_hook \ 196 ((bfd_boolean (*) (bfd *, asection *)) bfd_true) 197 extern bfd_boolean _bfd_generic_get_section_contents 198 (bfd *, asection *, void *, file_ptr, bfd_size_type); 199 extern bfd_boolean _bfd_generic_get_section_contents_in_window 200 (bfd *, asection *, bfd_window *, file_ptr, bfd_size_type); 201 202 /* Generic routines to use for BFD_JUMP_TABLE_COPY. Use 203 BFD_JUMP_TABLE_COPY (_bfd_generic). */ 204 205 #define _bfd_generic_bfd_copy_private_bfd_data \ 206 ((bfd_boolean (*) (bfd *, bfd *)) bfd_true) 207 #define _bfd_generic_bfd_merge_private_bfd_data \ 208 ((bfd_boolean (*) (bfd *, bfd *)) bfd_true) 209 #define _bfd_generic_bfd_set_private_flags \ 210 ((bfd_boolean (*) (bfd *, flagword)) bfd_true) 211 #define _bfd_generic_bfd_copy_private_section_data \ 212 ((bfd_boolean (*) (bfd *, asection *, bfd *, asection *)) bfd_true) 213 #define _bfd_generic_bfd_copy_private_symbol_data \ 214 ((bfd_boolean (*) (bfd *, asymbol *, bfd *, asymbol *)) bfd_true) 215 #define _bfd_generic_bfd_print_private_bfd_data \ 216 ((bfd_boolean (*) (bfd *, void *)) bfd_true) 217 218 /* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file 219 support. Use BFD_JUMP_TABLE_CORE (_bfd_nocore). */ 220 221 extern char *_bfd_nocore_core_file_failing_command 222 (bfd *); 223 extern int _bfd_nocore_core_file_failing_signal 224 (bfd *); 225 extern bfd_boolean _bfd_nocore_core_file_matches_executable_p 226 (bfd *, bfd *); 227 228 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive 229 file support. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive). */ 230 231 #define _bfd_noarchive_slurp_armap bfd_false 232 #define _bfd_noarchive_slurp_extended_name_table bfd_false 233 #define _bfd_noarchive_construct_extended_name_table \ 234 ((bfd_boolean (*) (bfd *, char **, bfd_size_type *, const char **)) \ 235 bfd_false) 236 #define _bfd_noarchive_truncate_arname \ 237 ((void (*) (bfd *, const char *, char *)) bfd_void) 238 #define _bfd_noarchive_write_armap \ 239 ((bfd_boolean (*) (bfd *, unsigned int, struct orl *, unsigned int, int)) \ 240 bfd_false) 241 #define _bfd_noarchive_read_ar_hdr bfd_nullvoidptr 242 #define _bfd_noarchive_openr_next_archived_file \ 243 ((bfd *(*) (bfd *, bfd *)) bfd_nullvoidptr) 244 #define _bfd_noarchive_get_elt_at_index \ 245 ((bfd *(*) (bfd *, symindex)) bfd_nullvoidptr) 246 #define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt 247 #define _bfd_noarchive_update_armap_timestamp bfd_false 248 249 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style 250 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd). */ 251 252 #define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap 253 #define _bfd_archive_bsd_slurp_extended_name_table \ 254 _bfd_slurp_extended_name_table 255 extern bfd_boolean _bfd_archive_bsd_construct_extended_name_table 256 (bfd *, char **, bfd_size_type *, const char **); 257 #define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname 258 #define _bfd_archive_bsd_write_armap bsd_write_armap 259 #define _bfd_archive_bsd_read_ar_hdr _bfd_generic_read_ar_hdr 260 #define _bfd_archive_bsd_openr_next_archived_file \ 261 bfd_generic_openr_next_archived_file 262 #define _bfd_archive_bsd_get_elt_at_index _bfd_generic_get_elt_at_index 263 #define _bfd_archive_bsd_generic_stat_arch_elt \ 264 bfd_generic_stat_arch_elt 265 extern bfd_boolean _bfd_archive_bsd_update_armap_timestamp 266 (bfd *); 267 268 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style 269 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff). */ 270 271 #define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap 272 #define _bfd_archive_coff_slurp_extended_name_table \ 273 _bfd_slurp_extended_name_table 274 extern bfd_boolean _bfd_archive_coff_construct_extended_name_table 275 (bfd *, char **, bfd_size_type *, const char **); 276 #define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname 277 #define _bfd_archive_coff_write_armap coff_write_armap 278 #define _bfd_archive_coff_read_ar_hdr _bfd_generic_read_ar_hdr 279 #define _bfd_archive_coff_openr_next_archived_file \ 280 bfd_generic_openr_next_archived_file 281 #define _bfd_archive_coff_get_elt_at_index _bfd_generic_get_elt_at_index 282 #define _bfd_archive_coff_generic_stat_arch_elt \ 283 bfd_generic_stat_arch_elt 284 #define _bfd_archive_coff_update_armap_timestamp bfd_true 285 286 /* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol 287 support. Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols). */ 288 289 #define _bfd_nosymbols_get_symtab_upper_bound _bfd_n1 290 #define _bfd_nosymbols_canonicalize_symtab \ 291 ((long (*) (bfd *, asymbol **)) _bfd_n1) 292 #define _bfd_nosymbols_make_empty_symbol _bfd_generic_make_empty_symbol 293 #define _bfd_nosymbols_print_symbol \ 294 ((void (*) (bfd *, void *, asymbol *, bfd_print_symbol_type)) bfd_void) 295 #define _bfd_nosymbols_get_symbol_info \ 296 ((void (*) (bfd *, asymbol *, symbol_info *)) bfd_void) 297 #define _bfd_nosymbols_bfd_is_local_label_name \ 298 ((bfd_boolean (*) (bfd *, const char *)) bfd_false) 299 #define _bfd_nosymbols_get_lineno \ 300 ((alent *(*) (bfd *, asymbol *)) bfd_nullvoidptr) 301 #define _bfd_nosymbols_find_nearest_line \ 302 ((bfd_boolean (*) (bfd *, asection *, asymbol **, bfd_vma, const char **, \ 303 const char **, unsigned int *)) \ 304 bfd_false) 305 #define _bfd_nosymbols_bfd_make_debug_symbol \ 306 ((asymbol *(*) (bfd *, void *, unsigned long)) bfd_nullvoidptr) 307 #define _bfd_nosymbols_read_minisymbols \ 308 ((long (*) (bfd *, bfd_boolean, void **, unsigned int *)) _bfd_n1) 309 #define _bfd_nosymbols_minisymbol_to_symbol \ 310 ((asymbol *(*) (bfd *, bfd_boolean, const void *, asymbol *)) \ 311 bfd_nullvoidptr) 312 313 /* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc 314 support. Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs). */ 315 316 #define _bfd_norelocs_get_reloc_upper_bound \ 317 ((long (*) (bfd *, asection *)) _bfd_n1) 318 #define _bfd_norelocs_canonicalize_reloc \ 319 ((long (*) (bfd *, asection *, arelent **, asymbol **)) _bfd_n1) 320 #define _bfd_norelocs_bfd_reloc_type_lookup \ 321 ((reloc_howto_type *(*) (bfd *, bfd_reloc_code_real_type)) bfd_nullvoidptr) 322 323 /* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not 324 be written. Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite). */ 325 326 #define _bfd_nowrite_set_arch_mach \ 327 ((bfd_boolean (*) (bfd *, enum bfd_architecture, unsigned long)) \ 328 bfd_false) 329 #define _bfd_nowrite_set_section_contents \ 330 ((bfd_boolean (*) (bfd *, asection *, const void *, file_ptr, bfd_size_type)) \ 331 bfd_false) 332 333 /* Generic routines to use for BFD_JUMP_TABLE_WRITE. Use 334 BFD_JUMP_TABLE_WRITE (_bfd_generic). */ 335 336 #define _bfd_generic_set_arch_mach bfd_default_set_arch_mach 337 extern bfd_boolean _bfd_generic_set_section_contents 338 (bfd *, asection *, const void *, file_ptr, bfd_size_type); 339 340 /* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not 341 support linking. Use BFD_JUMP_TABLE_LINK (_bfd_nolink). */ 342 343 #define _bfd_nolink_sizeof_headers ((int (*) (bfd *, bfd_boolean)) bfd_0) 344 #define _bfd_nolink_bfd_get_relocated_section_contents \ 345 ((bfd_byte *(*) (bfd *, struct bfd_link_info *, struct bfd_link_order *, \ 346 bfd_byte *, bfd_boolean, asymbol **)) \ 347 bfd_nullvoidptr) 348 #define _bfd_nolink_bfd_relax_section \ 349 ((bfd_boolean (*) \ 350 (bfd *, asection *, struct bfd_link_info *, bfd_boolean *)) \ 351 bfd_false) 352 #define _bfd_nolink_bfd_gc_sections \ 353 ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) \ 354 bfd_false) 355 #define _bfd_nolink_bfd_merge_sections \ 356 ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) \ 357 bfd_false) 358 #define _bfd_nolink_bfd_discard_group \ 359 ((bfd_boolean (*) (bfd *, struct bfd_section *)) \ 360 bfd_false) 361 #define _bfd_nolink_bfd_link_hash_table_create \ 362 ((struct bfd_link_hash_table *(*) (bfd *)) bfd_nullvoidptr) 363 #define _bfd_nolink_bfd_link_hash_table_free \ 364 ((void (*) (struct bfd_link_hash_table *)) bfd_void) 365 #define _bfd_nolink_bfd_link_add_symbols \ 366 ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) bfd_false) 367 #define _bfd_nolink_bfd_link_just_syms \ 368 ((void (*) (asection *, struct bfd_link_info *)) bfd_void) 369 #define _bfd_nolink_bfd_final_link \ 370 ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) bfd_false) 371 #define _bfd_nolink_bfd_link_split_section \ 372 ((bfd_boolean (*) (bfd *, struct bfd_section *)) bfd_false) 373 374 /* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not 375 have dynamic symbols or relocs. Use BFD_JUMP_TABLE_DYNAMIC 376 (_bfd_nodynamic). */ 377 378 #define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_n1 379 #define _bfd_nodynamic_canonicalize_dynamic_symtab \ 380 ((long (*) (bfd *, asymbol **)) _bfd_n1) 381 #define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_n1 382 #define _bfd_nodynamic_canonicalize_dynamic_reloc \ 383 ((long (*) (bfd *, arelent **, asymbol **)) _bfd_n1) 384 385 /* Generic routine to determine of the given symbol is a local 386 label. */ 387 extern bfd_boolean bfd_generic_is_local_label_name 388 (bfd *, const char *); 389 390 /* Generic minisymbol routines. */ 391 extern long _bfd_generic_read_minisymbols 392 (bfd *, bfd_boolean, void **, unsigned int *); 393 extern asymbol *_bfd_generic_minisymbol_to_symbol 394 (bfd *, bfd_boolean, const void *, asymbol *); 395 396 /* Find the nearest line using .stab/.stabstr sections. */ 397 extern bfd_boolean _bfd_stab_section_find_nearest_line 398 (bfd *, asymbol **, asection *, bfd_vma, bfd_boolean *, 399 const char **, const char **, unsigned int *, void **); 400 401 /* Find the neaderst line using DWARF 1 debugging information. */ 402 extern bfd_boolean _bfd_dwarf1_find_nearest_line 403 (bfd *, asection *, asymbol **, bfd_vma, const char **, 404 const char **, unsigned int *); 405 406 /* Find the nearest line using DWARF 2 debugging information. */ 407 extern bfd_boolean _bfd_dwarf2_find_nearest_line 408 (bfd *, asection *, asymbol **, bfd_vma, const char **, const char **, 409 unsigned int *, unsigned int, void **); 410 411 /* Create a new section entry. */ 412 extern struct bfd_hash_entry *bfd_section_hash_newfunc 413 (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); 414 415 /* A routine to create entries for a bfd_link_hash_table. */ 416 extern struct bfd_hash_entry *_bfd_link_hash_newfunc 417 (struct bfd_hash_entry *entry, struct bfd_hash_table *table, 418 const char *string); 419 420 /* Initialize a bfd_link_hash_table. */ 421 extern bfd_boolean _bfd_link_hash_table_init 422 (struct bfd_link_hash_table *, bfd *, 423 struct bfd_hash_entry *(*) (struct bfd_hash_entry *, 424 struct bfd_hash_table *, 425 const char *)); 426 427 /* Generic link hash table creation routine. */ 428 extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create 429 (bfd *); 430 431 /* Generic link hash table destruction routine. */ 432 extern void _bfd_generic_link_hash_table_free 433 (struct bfd_link_hash_table *); 434 435 /* Generic add symbol routine. */ 436 extern bfd_boolean _bfd_generic_link_add_symbols 437 (bfd *, struct bfd_link_info *); 438 439 /* Generic add symbol routine. This version is used by targets for 440 which the linker must collect constructors and destructors by name, 441 as the collect2 program does. */ 442 extern bfd_boolean _bfd_generic_link_add_symbols_collect 443 (bfd *, struct bfd_link_info *); 444 445 /* Generic archive add symbol routine. */ 446 extern bfd_boolean _bfd_generic_link_add_archive_symbols 447 (bfd *, struct bfd_link_info *, 448 bfd_boolean (*) (bfd *, struct bfd_link_info *, bfd_boolean *)); 449 450 /* Forward declaration to avoid prototype errors. */ 451 typedef struct bfd_link_hash_entry _bfd_link_hash_entry; 452 453 /* Generic routine to add a single symbol. */ 454 extern bfd_boolean _bfd_generic_link_add_one_symbol 455 (struct bfd_link_info *, bfd *, const char *name, flagword, 456 asection *, bfd_vma, const char *, bfd_boolean copy, 457 bfd_boolean constructor, struct bfd_link_hash_entry **); 458 459 /* Generic routine to mark section as supplying symbols only. */ 460 extern void _bfd_generic_link_just_syms 461 (asection *, struct bfd_link_info *); 462 463 /* Generic link routine. */ 464 extern bfd_boolean _bfd_generic_final_link 465 (bfd *, struct bfd_link_info *); 466 467 extern bfd_boolean _bfd_generic_link_split_section 468 (bfd *, struct bfd_section *); 469 470 /* Generic reloc_link_order processing routine. */ 471 extern bfd_boolean _bfd_generic_reloc_link_order 472 (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *); 473 474 /* Default link order processing routine. */ 475 extern bfd_boolean _bfd_default_link_order 476 (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *); 477 478 /* Count the number of reloc entries in a link order list. */ 479 extern unsigned int _bfd_count_link_order_relocs 480 (struct bfd_link_order *); 481 482 /* Final link relocation routine. */ 483 extern bfd_reloc_status_type _bfd_final_link_relocate 484 (reloc_howto_type *, bfd *, asection *, bfd_byte *, 485 bfd_vma, bfd_vma, bfd_vma); 486 487 /* Relocate a particular location by a howto and a value. */ 488 extern bfd_reloc_status_type _bfd_relocate_contents 489 (reloc_howto_type *, bfd *, bfd_vma, bfd_byte *); 490 491 /* Link stabs in sections in the first pass. */ 492 493 extern bfd_boolean _bfd_link_section_stabs 494 (bfd *, void **, asection *, asection *, void **, bfd_size_type *); 495 496 /* Eliminate stabs for discarded functions and symbols. */ 497 extern bfd_boolean _bfd_discard_section_stabs 498 (bfd *, asection *, void *, bfd_boolean (*) (bfd_vma, void *), void *); 499 500 /* Write out the .stab section when linking stabs in sections. */ 501 502 extern bfd_boolean _bfd_write_section_stabs 503 (bfd *, void **, asection *, void **, bfd_byte *); 504 505 /* Write out the .stabstr string table when linking stabs in sections. */ 506 507 extern bfd_boolean _bfd_write_stab_strings 508 (bfd *, void **); 509 510 /* Find an offset within a .stab section when linking stabs in 511 sections. */ 512 513 extern bfd_vma _bfd_stab_section_offset 514 (bfd *, void **, asection *, void **, bfd_vma); 515 516 /* Attempt to merge a SEC_MERGE section. */ 517 518 extern bfd_boolean _bfd_merge_section 519 (bfd *, void **, asection *, void **); 520 521 /* Attempt to merge SEC_MERGE sections. */ 522 523 extern bfd_boolean _bfd_merge_sections 524 (bfd *, void *, void (*) (bfd *, asection *)); 525 526 /* Write out a merged section. */ 527 528 extern bfd_boolean _bfd_write_merged_section 529 (bfd *, asection *, void *); 530 531 /* Find an offset within a modified SEC_MERGE section. */ 532 533 extern bfd_vma _bfd_merged_section_offset 534 (bfd *, asection **, void *, bfd_vma, bfd_vma); 535 536 /* Create a string table. */ 537 extern struct bfd_strtab_hash *_bfd_stringtab_init 538 (void); 539 540 /* Create an XCOFF .debug section style string table. */ 541 extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init 542 (void); 543 544 /* Free a string table. */ 545 extern void _bfd_stringtab_free 546 (struct bfd_strtab_hash *); 547 548 /* Get the size of a string table. */ 549 extern bfd_size_type _bfd_stringtab_size 550 (struct bfd_strtab_hash *); 551 552 /* Add a string to a string table. */ 553 extern bfd_size_type _bfd_stringtab_add 554 (struct bfd_strtab_hash *, const char *, bfd_boolean hash, bfd_boolean copy); 555 556 /* Write out a string table. */ 557 extern bfd_boolean _bfd_stringtab_emit 558 (bfd *, struct bfd_strtab_hash *); 559 560 /* Check that endianness of input and output file match. */ 561 extern bfd_boolean _bfd_generic_verify_endian_match 562 (bfd *, bfd *); 563 564 /* Macros to tell if bfds are read or write enabled. 565 566 Note that bfds open for read may be scribbled into if the fd passed 567 to bfd_fdopenr is actually open both for read and write 568 simultaneously. However an output bfd will never be open for 569 read. Therefore sometimes you want to check bfd_read_p or 570 !bfd_read_p, and only sometimes bfd_write_p. 571 */ 572 573 #define bfd_read_p(abfd) \ 574 ((abfd)->direction == read_direction || (abfd)->direction == both_direction) 575 #define bfd_write_p(abfd) \ 576 ((abfd)->direction == write_direction || (abfd)->direction == both_direction) 577 578 void bfd_assert 579 (const char*,int); 580 581 #define BFD_ASSERT(x) \ 582 { if (!(x)) bfd_assert(__FILE__,__LINE__); } 583 584 #define BFD_FAIL() \ 585 { bfd_assert(__FILE__,__LINE__); } 586 587 extern void _bfd_abort 588 (const char *, int, const char *) ATTRIBUTE_NORETURN; 589 590 /* if gcc >= 2.6, we can give a function name, too */ 591 #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6) 592 #define __PRETTY_FUNCTION__ ((char *) NULL) 593 #endif 594 595 #undef abort 596 #define abort() _bfd_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__) 597 598 /* Manipulate a system FILE but using BFD's "file_ptr", rather than 599 the system "off_t" or "off64_t", as the offset. */ 600 extern file_ptr real_ftell (FILE *file); 601 extern int real_fseek (FILE *file, file_ptr offset, int whence); 602 603 FILE * bfd_cache_lookup_worker 604 (bfd *); 605 606 extern bfd *bfd_last_cache; 607 608 /* List of supported target vectors, and the default vector (if 609 bfd_default_vector[0] is NULL, there is no default). */ 610 extern const bfd_target * const *bfd_target_vector; 611 extern const bfd_target *bfd_default_vector[]; 612 613 /* List of associated target vectors. */ 614 extern const bfd_target * const *bfd_associated_vector; 615 616 /* Functions shared by the ECOFF and MIPS ELF backends, which have no 617 other common header files. */ 618 619 #if defined(__STDC__) || defined(ALMOST_STDC) 620 struct ecoff_find_line; 621 #endif 622 623 extern bfd_boolean _bfd_ecoff_locate_line 624 (bfd *, asection *, bfd_vma, struct ecoff_debug_info * const, 625 const struct ecoff_debug_swap * const, struct ecoff_find_line *, 626 const char **, const char **, unsigned int *); 627 extern bfd_boolean _bfd_ecoff_get_accumulated_pdr 628 (void *, bfd_byte *); 629 extern bfd_boolean _bfd_ecoff_get_accumulated_sym 630 (void *, bfd_byte *); 631 extern bfd_boolean _bfd_ecoff_get_accumulated_ss 632 (void *, bfd_byte *); 633 634 extern bfd_vma _bfd_get_gp_value 635 (bfd *); 636 extern void _bfd_set_gp_value 637 (bfd *, bfd_vma); 638 639 /* Function shared by the COFF and ELF SH backends, which have no 640 other common header files. */ 641 642 #ifndef _bfd_sh_align_load_span 643 extern bfd_boolean _bfd_sh_align_load_span 644 (bfd *, asection *, bfd_byte *, 645 bfd_boolean (*) (bfd *, asection *, void *, bfd_byte *, bfd_vma), 646 void *, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, bfd_boolean *); 647 #endif 648