| 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, 2005, 2006, 2007, 2008, 2009, |
| 6 | 2010 |
| 7 | Free Software Foundation, Inc. |
| 8 | |
| 9 | Written by Cygnus Support. |
| 10 | |
| 11 | This file is part of BFD, the Binary File Descriptor library. |
| 12 | |
| 13 | This program is free software; you can redistribute it and/or modify |
| 14 | it under the terms of the GNU General Public License as published by |
| 15 | the Free Software Foundation; either version 3 of the License, or |
| 16 | (at your option) any later version. |
| 17 | |
| 18 | This program is distributed in the hope that it will be useful, |
| 19 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 20 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 21 | GNU General Public License for more details. |
| 22 | |
| 23 | You should have received a copy of the GNU General Public License |
| 24 | along with this program; if not, write to the Free Software |
| 25 | Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, |
| 26 | MA 02110-1301, USA. */ |
| 27 | |
| 28 | #include "hashtab.h" |
| 29 | |
| 30 | /* Align an address upward to a boundary, expressed as a number of bytes. |
| 31 | E.g. align to an 8-byte boundary with argument of 8. Take care never |
| 32 | to wrap around if the address is within boundary-1 of the end of the |
| 33 | address space. */ |
| 34 | #define BFD_ALIGN(this, boundary) \ |
| 35 | ((((bfd_vma) (this) + (boundary) - 1) >= (bfd_vma) (this)) \ |
| 36 | ? (((bfd_vma) (this) + ((boundary) - 1)) & ~ (bfd_vma) ((boundary)-1)) \ |
| 37 | : ~ (bfd_vma) 0) |
| 38 | |
| 39 | /* If you want to read and write large blocks, you might want to do it |
| 40 | in quanta of this amount */ |
| 41 | #define DEFAULT_BUFFERSIZE 8192 |
| 42 | |
| 43 | /* Set a tdata field. Can't use the other macros for this, since they |
| 44 | do casts, and casting to the left of assignment isn't portable. */ |
| 45 | #define set_tdata(bfd, v) ((bfd)->tdata.any = (v)) |
| 46 | |
| 47 | /* If BFD_IN_MEMORY is set for a BFD, then the iostream fields points |
| 48 | to an instance of this structure. */ |
| 49 | |
| 50 | struct bfd_in_memory |
| 51 | { |
| 52 | /* Size of buffer. */ |
| 53 | bfd_size_type size; |
| 54 | /* Buffer holding contents of BFD. */ |
| 55 | bfd_byte *buffer; |
| 56 | }; |
| 57 | |
| 58 | struct section_hash_entry |
| 59 | { |
| 60 | struct bfd_hash_entry root; |
| 61 | asection section; |
| 62 | }; |
| 63 | |
| 64 | /* tdata for an archive. For an input archive, cache |
| 65 | needs to be free()'d. For an output archive, symdefs do. */ |
| 66 | |
| 67 | struct artdata { |
| 68 | file_ptr first_file_filepos; |
| 69 | /* Speed up searching the armap */ |
| 70 | htab_t cache; |
| 71 | bfd *archive_head; /* Only interesting in output routines */ |
| 72 | carsym *symdefs; /* the symdef entries */ |
| 73 | symindex symdef_count; /* how many there are */ |
| 74 | char *extended_names; /* clever intel extension */ |
| 75 | bfd_size_type extended_names_size; /* Size of extended names */ |
| 76 | /* when more compilers are standard C, this can be a time_t */ |
| 77 | long armap_timestamp; /* Timestamp value written into armap. |
| 78 | This is used for BSD archives to check |
| 79 | that the timestamp is recent enough |
| 80 | for the BSD linker to not complain, |
| 81 | just before we finish writing an |
| 82 | archive. */ |
| 83 | file_ptr armap_datepos; /* Position within archive to seek to |
| 84 | rewrite the date field. */ |
| 85 | void *tdata; /* Backend specific information. */ |
| 86 | }; |
| 87 | |
| 88 | #define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data) |
| 89 | |
| 90 | /* Goes in bfd's arelt_data slot */ |
| 91 | struct areltdata { |
| 92 | char * arch_header; /* it's actually a string */ |
| 93 | unsigned int parsed_size; /* octets of filesize not including ar_hdr */ |
| 94 | unsigned int extra_size; /* BSD4.4: extra bytes after the header. */ |
| 95 | char *filename; /* null-terminated */ |
| 96 | file_ptr origin; /* for element of a thin archive */ |
| 97 | }; |
| 98 | |
| 99 | #define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size) |
| 100 | |
| 101 | extern void *bfd_malloc |
| 102 | (bfd_size_type); |
| 103 | extern void *bfd_realloc |
| 104 | (void *, bfd_size_type); |
| 105 | extern void *bfd_realloc_or_free |
| 106 | (void *, bfd_size_type); |
| 107 | extern void *bfd_zmalloc |
| 108 | (bfd_size_type); |
| 109 | extern void *bfd_malloc2 |
| 110 | (bfd_size_type, bfd_size_type); |
| 111 | extern void *bfd_realloc2 |
| 112 | (void *, bfd_size_type, bfd_size_type); |
| 113 | extern void *bfd_zmalloc2 |
| 114 | (bfd_size_type, bfd_size_type); |
| 115 | |
| 116 | extern void _bfd_default_error_handler (const char *s, ...); |
| 117 | extern bfd_error_handler_type _bfd_error_handler; |
| 118 | |
| 119 | /* These routines allocate and free things on the BFD's objalloc. */ |
| 120 | |
| 121 | extern void *bfd_alloc |
| 122 | (bfd *, bfd_size_type); |
| 123 | extern void *bfd_zalloc |
| 124 | (bfd *, bfd_size_type); |
| 125 | extern void *bfd_alloc2 |
| 126 | (bfd *, bfd_size_type, bfd_size_type); |
| 127 | extern void *bfd_zalloc2 |
| 128 | (bfd *, bfd_size_type, bfd_size_type); |
| 129 | extern void bfd_release |
| 130 | (bfd *, void *); |
| 131 | |
| 132 | bfd * _bfd_create_empty_archive_element_shell |
| 133 | (bfd *obfd); |
| 134 | bfd * _bfd_look_for_bfd_in_cache |
| 135 | (bfd *, file_ptr); |
| 136 | bfd_boolean _bfd_add_bfd_to_archive_cache |
| 137 | (bfd *, file_ptr, bfd *); |
| 138 | bfd_boolean _bfd_generic_mkarchive |
| 139 | (bfd *abfd); |
| 140 | char *_bfd_append_relative_path |
| 141 | (bfd *arch, char *elt_name); |
| 142 | const bfd_target *bfd_generic_archive_p |
| 143 | (bfd *abfd); |
| 144 | bfd_boolean bfd_slurp_armap |
| 145 | (bfd *abfd); |
| 146 | bfd_boolean bfd_slurp_bsd_armap_f2 |
| 147 | (bfd *abfd); |
| 148 | #define bfd_slurp_bsd_armap bfd_slurp_armap |
| 149 | #define bfd_slurp_coff_armap bfd_slurp_armap |
| 150 | bfd_boolean _bfd_slurp_extended_name_table |
| 151 | (bfd *abfd); |
| 152 | extern bfd_boolean _bfd_construct_extended_name_table |
| 153 | (bfd *, bfd_boolean, char **, bfd_size_type *); |
| 154 | bfd_boolean _bfd_write_archive_contents |
| 155 | (bfd *abfd); |
| 156 | bfd_boolean _bfd_compute_and_write_armap |
| 157 | (bfd *, unsigned int elength); |
| 158 | bfd *_bfd_get_elt_at_filepos |
| 159 | (bfd *archive, file_ptr filepos); |
| 160 | extern bfd *_bfd_generic_get_elt_at_index |
| 161 | (bfd *, symindex); |
| 162 | bfd * _bfd_new_bfd |
| 163 | (void); |
| 164 | void _bfd_delete_bfd |
| 165 | (bfd *); |
| 166 | bfd_boolean _bfd_free_cached_info |
| 167 | (bfd *); |
| 168 | |
| 169 | bfd_boolean bfd_false |
| 170 | (bfd *ignore); |
| 171 | bfd_boolean bfd_true |
| 172 | (bfd *ignore); |
| 173 | void *bfd_nullvoidptr |
| 174 | (bfd *ignore); |
| 175 | int bfd_0 |
| 176 | (bfd *ignore); |
| 177 | unsigned int bfd_0u |
| 178 | (bfd *ignore); |
| 179 | long bfd_0l |
| 180 | (bfd *ignore); |
| 181 | long _bfd_n1 |
| 182 | (bfd *ignore); |
| 183 | void bfd_void |
| 184 | (bfd *ignore); |
| 185 | |
| 186 | bfd *_bfd_new_bfd_contained_in |
| 187 | (bfd *); |
| 188 | const bfd_target *_bfd_dummy_target |
| 189 | (bfd *abfd); |
| 190 | |
| 191 | void bfd_dont_truncate_arname |
| 192 | (bfd *abfd, const char *filename, char *hdr); |
| 193 | void bfd_bsd_truncate_arname |
| 194 | (bfd *abfd, const char *filename, char *hdr); |
| 195 | void bfd_gnu_truncate_arname |
| 196 | (bfd *abfd, const char *filename, char *hdr); |
| 197 | |
| 198 | bfd_boolean bsd_write_armap |
| 199 | (bfd *arch, unsigned int elength, struct orl *map, unsigned int orl_count, |
| 200 | int stridx); |
| 201 | |
| 202 | bfd_boolean coff_write_armap |
| 203 | (bfd *arch, unsigned int elength, struct orl *map, unsigned int orl_count, |
| 204 | int stridx); |
| 205 | |
| 206 | extern void *_bfd_generic_read_ar_hdr |
| 207 | (bfd *); |
| 208 | extern void _bfd_ar_spacepad |
| 209 | (char *, size_t, const char *, long); |
| 210 | |
| 211 | extern void *_bfd_generic_read_ar_hdr_mag |
| 212 | (bfd *, const char *); |
| 213 | |
| 214 | extern bfd_boolean _bfd_generic_write_ar_hdr |
| 215 | (bfd *, bfd *); |
| 216 | |
| 217 | extern bfd_boolean _bfd_bsd44_write_ar_hdr |
| 218 | (bfd *, bfd *); |
| 219 | |
| 220 | bfd * bfd_generic_openr_next_archived_file |
| 221 | (bfd *archive, bfd *last_file); |
| 222 | |
| 223 | int bfd_generic_stat_arch_elt |
| 224 | (bfd *, struct stat *); |
| 225 | |
| 226 | #define _bfd_read_ar_hdr(abfd) \ |
| 227 | BFD_SEND (abfd, _bfd_read_ar_hdr_fn, (abfd)) |
| 228 | #define _bfd_write_ar_hdr(archive, abfd) \ |
| 229 | BFD_SEND (abfd, _bfd_write_ar_hdr_fn, (archive, abfd)) |
| 230 | \f |
| 231 | /* Generic routines to use for BFD_JUMP_TABLE_GENERIC. Use |
| 232 | BFD_JUMP_TABLE_GENERIC (_bfd_generic). */ |
| 233 | |
| 234 | #define _bfd_generic_close_and_cleanup bfd_true |
| 235 | #define _bfd_generic_bfd_free_cached_info bfd_true |
| 236 | extern bfd_boolean _bfd_generic_new_section_hook |
| 237 | (bfd *, asection *); |
| 238 | extern bfd_boolean _bfd_generic_get_section_contents |
| 239 | (bfd *, asection *, void *, file_ptr, bfd_size_type); |
| 240 | extern bfd_boolean _bfd_generic_get_section_contents_in_window |
| 241 | (bfd *, asection *, bfd_window *, file_ptr, bfd_size_type); |
| 242 | |
| 243 | /* Generic routines to use for BFD_JUMP_TABLE_COPY. Use |
| 244 | BFD_JUMP_TABLE_COPY (_bfd_generic). */ |
| 245 | |
| 246 | #define _bfd_generic_bfd_copy_private_bfd_data \ |
| 247 | ((bfd_boolean (*) (bfd *, bfd *)) bfd_true) |
| 248 | #define _bfd_generic_bfd_merge_private_bfd_data \ |
| 249 | ((bfd_boolean (*) (bfd *, bfd *)) bfd_true) |
| 250 | #define _bfd_generic_bfd_set_private_flags \ |
| 251 | ((bfd_boolean (*) (bfd *, flagword)) bfd_true) |
| 252 | #define _bfd_generic_bfd_copy_private_section_data \ |
| 253 | ((bfd_boolean (*) (bfd *, asection *, bfd *, asection *)) bfd_true) |
| 254 | #define _bfd_generic_bfd_copy_private_symbol_data \ |
| 255 | ((bfd_boolean (*) (bfd *, asymbol *, bfd *, asymbol *)) bfd_true) |
| 256 | #define _bfd_generic_bfd_copy_private_header_data \ |
| 257 | ((bfd_boolean (*) (bfd *, bfd *)) bfd_true) |
| 258 | #define _bfd_generic_bfd_print_private_bfd_data \ |
| 259 | ((bfd_boolean (*) (bfd *, void *)) bfd_true) |
| 260 | |
| 261 | extern bfd_boolean _bfd_generic_init_private_section_data |
| 262 | (bfd *, asection *, bfd *, asection *, struct bfd_link_info *); |
| 263 | |
| 264 | /* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file |
| 265 | support. Use BFD_JUMP_TABLE_CORE (_bfd_nocore). */ |
| 266 | |
| 267 | extern char *_bfd_nocore_core_file_failing_command |
| 268 | (bfd *); |
| 269 | extern int _bfd_nocore_core_file_failing_signal |
| 270 | (bfd *); |
| 271 | extern bfd_boolean _bfd_nocore_core_file_matches_executable_p |
| 272 | (bfd *, bfd *); |
| 273 | extern int _bfd_nocore_core_file_pid |
| 274 | (bfd *); |
| 275 | |
| 276 | /* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive |
| 277 | file support. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive). */ |
| 278 | |
| 279 | #define _bfd_noarchive_slurp_armap bfd_false |
| 280 | #define _bfd_noarchive_slurp_extended_name_table bfd_false |
| 281 | #define _bfd_noarchive_construct_extended_name_table \ |
| 282 | ((bfd_boolean (*) (bfd *, char **, bfd_size_type *, const char **)) \ |
| 283 | bfd_false) |
| 284 | #define _bfd_noarchive_truncate_arname \ |
| 285 | ((void (*) (bfd *, const char *, char *)) bfd_void) |
| 286 | #define _bfd_noarchive_write_armap \ |
| 287 | ((bfd_boolean (*) (bfd *, unsigned int, struct orl *, unsigned int, int)) \ |
| 288 | bfd_false) |
| 289 | #define _bfd_noarchive_read_ar_hdr bfd_nullvoidptr |
| 290 | #define _bfd_noarchive_write_ar_hdr \ |
| 291 | ((bfd_boolean (*) (bfd *, bfd *)) bfd_false) |
| 292 | #define _bfd_noarchive_openr_next_archived_file \ |
| 293 | ((bfd *(*) (bfd *, bfd *)) bfd_nullvoidptr) |
| 294 | #define _bfd_noarchive_get_elt_at_index \ |
| 295 | ((bfd *(*) (bfd *, symindex)) bfd_nullvoidptr) |
| 296 | #define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt |
| 297 | #define _bfd_noarchive_update_armap_timestamp bfd_false |
| 298 | |
| 299 | /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style |
| 300 | archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd). */ |
| 301 | |
| 302 | #define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap |
| 303 | #define _bfd_archive_bsd_slurp_extended_name_table \ |
| 304 | _bfd_slurp_extended_name_table |
| 305 | extern bfd_boolean _bfd_archive_bsd_construct_extended_name_table |
| 306 | (bfd *, char **, bfd_size_type *, const char **); |
| 307 | #define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname |
| 308 | #define _bfd_archive_bsd_write_armap bsd_write_armap |
| 309 | #define _bfd_archive_bsd_read_ar_hdr _bfd_generic_read_ar_hdr |
| 310 | #define _bfd_archive_bsd_write_ar_hdr _bfd_generic_write_ar_hdr |
| 311 | #define _bfd_archive_bsd_openr_next_archived_file \ |
| 312 | bfd_generic_openr_next_archived_file |
| 313 | #define _bfd_archive_bsd_get_elt_at_index _bfd_generic_get_elt_at_index |
| 314 | #define _bfd_archive_bsd_generic_stat_arch_elt \ |
| 315 | bfd_generic_stat_arch_elt |
| 316 | extern bfd_boolean _bfd_archive_bsd_update_armap_timestamp |
| 317 | (bfd *); |
| 318 | |
| 319 | /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style |
| 320 | archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff). */ |
| 321 | |
| 322 | #define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap |
| 323 | #define _bfd_archive_coff_slurp_extended_name_table \ |
| 324 | _bfd_slurp_extended_name_table |
| 325 | extern bfd_boolean _bfd_archive_coff_construct_extended_name_table |
| 326 | (bfd *, char **, bfd_size_type *, const char **); |
| 327 | #define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname |
| 328 | #define _bfd_archive_coff_write_armap coff_write_armap |
| 329 | #define _bfd_archive_coff_read_ar_hdr _bfd_generic_read_ar_hdr |
| 330 | #define _bfd_archive_coff_write_ar_hdr _bfd_generic_write_ar_hdr |
| 331 | #define _bfd_archive_coff_openr_next_archived_file \ |
| 332 | bfd_generic_openr_next_archived_file |
| 333 | #define _bfd_archive_coff_get_elt_at_index _bfd_generic_get_elt_at_index |
| 334 | #define _bfd_archive_coff_generic_stat_arch_elt \ |
| 335 | bfd_generic_stat_arch_elt |
| 336 | #define _bfd_archive_coff_update_armap_timestamp bfd_true |
| 337 | |
| 338 | /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD4.4 style |
| 339 | archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd44). */ |
| 340 | |
| 341 | #define _bfd_archive_bsd44_slurp_armap bfd_slurp_bsd_armap |
| 342 | #define _bfd_archive_bsd44_slurp_extended_name_table \ |
| 343 | _bfd_slurp_extended_name_table |
| 344 | extern bfd_boolean _bfd_archive_bsd44_construct_extended_name_table |
| 345 | (bfd *, char **, bfd_size_type *, const char **); |
| 346 | #define _bfd_archive_bsd44_truncate_arname bfd_bsd_truncate_arname |
| 347 | #define _bfd_archive_bsd44_write_armap bsd_write_armap |
| 348 | #define _bfd_archive_bsd44_read_ar_hdr _bfd_generic_read_ar_hdr |
| 349 | #define _bfd_archive_bsd44_write_ar_hdr _bfd_bsd44_write_ar_hdr |
| 350 | #define _bfd_archive_bsd44_openr_next_archived_file \ |
| 351 | bfd_generic_openr_next_archived_file |
| 352 | #define _bfd_archive_bsd44_get_elt_at_index _bfd_generic_get_elt_at_index |
| 353 | #define _bfd_archive_bsd44_generic_stat_arch_elt \ |
| 354 | bfd_generic_stat_arch_elt |
| 355 | #define _bfd_archive_bsd44_update_armap_timestamp \ |
| 356 | _bfd_archive_bsd_update_armap_timestamp |
| 357 | |
| 358 | /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get VMS style |
| 359 | archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_vms_lib). Some of them |
| 360 | are irrelevant and never called, so defined as NULL. */ |
| 361 | |
| 362 | extern bfd_boolean _bfd_vms_lib_write_archive_contents (bfd *arch); |
| 363 | #define _bfd_vms_lib_slurp_armap NULL |
| 364 | #define _bfd_vms_lib_slurp_extended_name_table NULL |
| 365 | #define _bfd_vms_lib_construct_extended_name_table NULL |
| 366 | #define _bfd_vms_lib_truncate_arname NULL |
| 367 | #define _bfd_vms_lib_write_armap NULL |
| 368 | #define _bfd_vms_lib_read_ar_hdr NULL |
| 369 | #define _bfd_vms_lib_write_ar_hdr NULL |
| 370 | extern bfd *_bfd_vms_lib_openr_next_archived_file (bfd *, bfd *); |
| 371 | extern bfd *_bfd_vms_lib_get_elt_at_index (bfd *, symindex); |
| 372 | extern int _bfd_vms_lib_generic_stat_arch_elt (bfd *, struct stat *); |
| 373 | #define _bfd_vms_lib_update_armap_timestamp bfd_true |
| 374 | |
| 375 | /* Extra routines for VMS style archives. */ |
| 376 | |
| 377 | extern symindex _bfd_vms_lib_find_symbol (bfd *, const char *); |
| 378 | extern bfd *_bfd_vms_lib_get_imagelib_file (bfd *); |
| 379 | extern const bfd_target *_bfd_vms_lib_alpha_archive_p (bfd *abfd); |
| 380 | extern const bfd_target *_bfd_vms_lib_ia64_archive_p (bfd *abfd); |
| 381 | extern bfd_boolean _bfd_vms_lib_alpha_mkarchive (bfd *abfd); |
| 382 | extern bfd_boolean _bfd_vms_lib_ia64_mkarchive (bfd *abfd); |
| 383 | |
| 384 | /* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol |
| 385 | support. Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols). */ |
| 386 | |
| 387 | #define _bfd_nosymbols_get_symtab_upper_bound _bfd_n1 |
| 388 | #define _bfd_nosymbols_canonicalize_symtab \ |
| 389 | ((long (*) (bfd *, asymbol **)) _bfd_n1) |
| 390 | #define _bfd_nosymbols_make_empty_symbol _bfd_generic_make_empty_symbol |
| 391 | #define _bfd_nosymbols_print_symbol \ |
| 392 | ((void (*) (bfd *, void *, asymbol *, bfd_print_symbol_type)) bfd_void) |
| 393 | #define _bfd_nosymbols_get_symbol_info \ |
| 394 | ((void (*) (bfd *, asymbol *, symbol_info *)) bfd_void) |
| 395 | #define _bfd_nosymbols_bfd_is_local_label_name \ |
| 396 | ((bfd_boolean (*) (bfd *, const char *)) bfd_false) |
| 397 | #define _bfd_nosymbols_bfd_is_target_special_symbol \ |
| 398 | ((bfd_boolean (*) (bfd *, asymbol *)) bfd_false) |
| 399 | #define _bfd_nosymbols_get_lineno \ |
| 400 | ((alent *(*) (bfd *, asymbol *)) bfd_nullvoidptr) |
| 401 | #define _bfd_nosymbols_find_nearest_line \ |
| 402 | ((bfd_boolean (*) (bfd *, asection *, asymbol **, bfd_vma, const char **, \ |
| 403 | const char **, unsigned int *)) \ |
| 404 | bfd_false) |
| 405 | #define _bfd_nosymbols_find_inliner_info \ |
| 406 | ((bfd_boolean (*) (bfd *, const char **, const char **, unsigned int *)) \ |
| 407 | bfd_false) |
| 408 | #define _bfd_nosymbols_bfd_make_debug_symbol \ |
| 409 | ((asymbol *(*) (bfd *, void *, unsigned long)) bfd_nullvoidptr) |
| 410 | #define _bfd_nosymbols_read_minisymbols \ |
| 411 | ((long (*) (bfd *, bfd_boolean, void **, unsigned int *)) _bfd_n1) |
| 412 | #define _bfd_nosymbols_minisymbol_to_symbol \ |
| 413 | ((asymbol *(*) (bfd *, bfd_boolean, const void *, asymbol *)) \ |
| 414 | bfd_nullvoidptr) |
| 415 | |
| 416 | /* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc |
| 417 | support. Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs). */ |
| 418 | |
| 419 | extern long _bfd_norelocs_get_reloc_upper_bound (bfd *, asection *); |
| 420 | extern long _bfd_norelocs_canonicalize_reloc (bfd *, asection *, |
| 421 | arelent **, asymbol **); |
| 422 | #define _bfd_norelocs_bfd_reloc_type_lookup \ |
| 423 | ((reloc_howto_type *(*) (bfd *, bfd_reloc_code_real_type)) bfd_nullvoidptr) |
| 424 | #define _bfd_norelocs_bfd_reloc_name_lookup \ |
| 425 | ((reloc_howto_type *(*) (bfd *, const char *)) bfd_nullvoidptr) |
| 426 | |
| 427 | /* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not |
| 428 | be written. Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite). */ |
| 429 | |
| 430 | #define _bfd_nowrite_set_arch_mach \ |
| 431 | ((bfd_boolean (*) (bfd *, enum bfd_architecture, unsigned long)) \ |
| 432 | bfd_false) |
| 433 | #define _bfd_nowrite_set_section_contents \ |
| 434 | ((bfd_boolean (*) (bfd *, asection *, const void *, file_ptr, bfd_size_type)) \ |
| 435 | bfd_false) |
| 436 | |
| 437 | /* Generic routines to use for BFD_JUMP_TABLE_WRITE. Use |
| 438 | BFD_JUMP_TABLE_WRITE (_bfd_generic). */ |
| 439 | |
| 440 | #define _bfd_generic_set_arch_mach bfd_default_set_arch_mach |
| 441 | extern bfd_boolean _bfd_generic_set_section_contents |
| 442 | (bfd *, asection *, const void *, file_ptr, bfd_size_type); |
| 443 | |
| 444 | /* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not |
| 445 | support linking. Use BFD_JUMP_TABLE_LINK (_bfd_nolink). */ |
| 446 | |
| 447 | #define _bfd_nolink_sizeof_headers \ |
| 448 | ((int (*) (bfd *, struct bfd_link_info *)) bfd_0) |
| 449 | #define _bfd_nolink_bfd_get_relocated_section_contents \ |
| 450 | ((bfd_byte *(*) (bfd *, struct bfd_link_info *, struct bfd_link_order *, \ |
| 451 | bfd_byte *, bfd_boolean, asymbol **)) \ |
| 452 | bfd_nullvoidptr) |
| 453 | #define _bfd_nolink_bfd_relax_section \ |
| 454 | ((bfd_boolean (*) \ |
| 455 | (bfd *, asection *, struct bfd_link_info *, bfd_boolean *)) \ |
| 456 | bfd_false) |
| 457 | #define _bfd_nolink_bfd_gc_sections \ |
| 458 | ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) \ |
| 459 | bfd_false) |
| 460 | #define _bfd_nolink_bfd_merge_sections \ |
| 461 | ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) \ |
| 462 | bfd_false) |
| 463 | #define _bfd_nolink_bfd_is_group_section \ |
| 464 | ((bfd_boolean (*) (bfd *, const struct bfd_section *)) \ |
| 465 | bfd_false) |
| 466 | #define _bfd_nolink_bfd_discard_group \ |
| 467 | ((bfd_boolean (*) (bfd *, struct bfd_section *)) \ |
| 468 | bfd_false) |
| 469 | #define _bfd_nolink_bfd_link_hash_table_create \ |
| 470 | ((struct bfd_link_hash_table *(*) (bfd *)) bfd_nullvoidptr) |
| 471 | #define _bfd_nolink_bfd_link_hash_table_free \ |
| 472 | ((void (*) (struct bfd_link_hash_table *)) bfd_void) |
| 473 | #define _bfd_nolink_bfd_link_add_symbols \ |
| 474 | ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) bfd_false) |
| 475 | #define _bfd_nolink_bfd_link_just_syms \ |
| 476 | ((void (*) (asection *, struct bfd_link_info *)) bfd_void) |
| 477 | #define _bfd_nolink_bfd_copy_link_hash_symbol_type \ |
| 478 | ((void (*) (bfd *, struct bfd_link_hash_entry *, \ |
| 479 | struct bfd_link_hash_entry *)) bfd_void) |
| 480 | #define _bfd_nolink_bfd_final_link \ |
| 481 | ((bfd_boolean (*) (bfd *, struct bfd_link_info *)) bfd_false) |
| 482 | #define _bfd_nolink_bfd_link_split_section \ |
| 483 | ((bfd_boolean (*) (bfd *, struct bfd_section *)) bfd_false) |
| 484 | #define _bfd_nolink_section_already_linked \ |
| 485 | ((void (*) (bfd *, struct bfd_section *, struct bfd_link_info *)) bfd_void) |
| 486 | #define _bfd_nolink_bfd_define_common_symbol \ |
| 487 | ((bfd_boolean (*) (bfd *, struct bfd_link_info *, \ |
| 488 | struct bfd_link_hash_entry *)) bfd_false) |
| 489 | |
| 490 | /* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not |
| 491 | have dynamic symbols or relocs. Use BFD_JUMP_TABLE_DYNAMIC |
| 492 | (_bfd_nodynamic). */ |
| 493 | |
| 494 | #define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_n1 |
| 495 | #define _bfd_nodynamic_canonicalize_dynamic_symtab \ |
| 496 | ((long (*) (bfd *, asymbol **)) _bfd_n1) |
| 497 | #define _bfd_nodynamic_get_synthetic_symtab \ |
| 498 | ((long (*) (bfd *, long, asymbol **, long, asymbol **, asymbol **)) _bfd_n1) |
| 499 | #define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_n1 |
| 500 | #define _bfd_nodynamic_canonicalize_dynamic_reloc \ |
| 501 | ((long (*) (bfd *, arelent **, asymbol **)) _bfd_n1) |
| 502 | \f |
| 503 | /* Generic routine to determine of the given symbol is a local |
| 504 | label. */ |
| 505 | extern bfd_boolean bfd_generic_is_local_label_name |
| 506 | (bfd *, const char *); |
| 507 | |
| 508 | /* Generic minisymbol routines. */ |
| 509 | extern long _bfd_generic_read_minisymbols |
| 510 | (bfd *, bfd_boolean, void **, unsigned int *); |
| 511 | extern asymbol *_bfd_generic_minisymbol_to_symbol |
| 512 | (bfd *, bfd_boolean, const void *, asymbol *); |
| 513 | |
| 514 | /* Find the nearest line using .stab/.stabstr sections. */ |
| 515 | extern bfd_boolean _bfd_stab_section_find_nearest_line |
| 516 | (bfd *, asymbol **, asection *, bfd_vma, bfd_boolean *, |
| 517 | const char **, const char **, unsigned int *, void **); |
| 518 | |
| 519 | /* Find the nearest line using DWARF 1 debugging information. */ |
| 520 | extern bfd_boolean _bfd_dwarf1_find_nearest_line |
| 521 | (bfd *, asection *, asymbol **, bfd_vma, const char **, |
| 522 | const char **, unsigned int *); |
| 523 | |
| 524 | /* Find the nearest line using DWARF 2 debugging information. */ |
| 525 | extern bfd_boolean _bfd_dwarf2_find_nearest_line |
| 526 | (bfd *, asection *, asymbol **, bfd_vma, const char **, const char **, |
| 527 | unsigned int *, unsigned int, void **); |
| 528 | |
| 529 | /* Find the line using DWARF 2 debugging information. */ |
| 530 | extern bfd_boolean _bfd_dwarf2_find_line |
| 531 | (bfd *, asymbol **, asymbol *, const char **, |
| 532 | unsigned int *, unsigned int, void **); |
| 533 | |
| 534 | bfd_boolean _bfd_generic_find_line |
| 535 | (bfd *, asymbol **, asymbol *, const char **, unsigned int *); |
| 536 | |
| 537 | /* Find inliner info after calling bfd_find_nearest_line. */ |
| 538 | extern bfd_boolean _bfd_dwarf2_find_inliner_info |
| 539 | (bfd *, const char **, const char **, unsigned int *, void **); |
| 540 | |
| 541 | /* Create a new section entry. */ |
| 542 | extern struct bfd_hash_entry *bfd_section_hash_newfunc |
| 543 | (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); |
| 544 | |
| 545 | /* A routine to create entries for a bfd_link_hash_table. */ |
| 546 | extern struct bfd_hash_entry *_bfd_link_hash_newfunc |
| 547 | (struct bfd_hash_entry *entry, struct bfd_hash_table *table, |
| 548 | const char *string); |
| 549 | |
| 550 | /* Initialize a bfd_link_hash_table. */ |
| 551 | extern bfd_boolean _bfd_link_hash_table_init |
| 552 | (struct bfd_link_hash_table *, bfd *, |
| 553 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, |
| 554 | struct bfd_hash_table *, |
| 555 | const char *), |
| 556 | unsigned int); |
| 557 | |
| 558 | /* Generic link hash table creation routine. */ |
| 559 | extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create |
| 560 | (bfd *); |
| 561 | |
| 562 | /* Generic link hash table destruction routine. */ |
| 563 | extern void _bfd_generic_link_hash_table_free |
| 564 | (struct bfd_link_hash_table *); |
| 565 | |
| 566 | /* Generic add symbol routine. */ |
| 567 | extern bfd_boolean _bfd_generic_link_add_symbols |
| 568 | (bfd *, struct bfd_link_info *); |
| 569 | |
| 570 | /* Generic add symbol routine. This version is used by targets for |
| 571 | which the linker must collect constructors and destructors by name, |
| 572 | as the collect2 program does. */ |
| 573 | extern bfd_boolean _bfd_generic_link_add_symbols_collect |
| 574 | (bfd *, struct bfd_link_info *); |
| 575 | |
| 576 | /* Generic archive add symbol routine. */ |
| 577 | extern bfd_boolean _bfd_generic_link_add_archive_symbols |
| 578 | (bfd *, struct bfd_link_info *, |
| 579 | bfd_boolean (*) (bfd *, struct bfd_link_info *, bfd_boolean *)); |
| 580 | |
| 581 | /* Forward declaration to avoid prototype errors. */ |
| 582 | typedef struct bfd_link_hash_entry _bfd_link_hash_entry; |
| 583 | |
| 584 | /* Generic routine to add a single symbol. */ |
| 585 | extern bfd_boolean _bfd_generic_link_add_one_symbol |
| 586 | (struct bfd_link_info *, bfd *, const char *name, flagword, |
| 587 | asection *, bfd_vma, const char *, bfd_boolean copy, |
| 588 | bfd_boolean constructor, struct bfd_link_hash_entry **); |
| 589 | |
| 590 | /* Generic routine to mark section as supplying symbols only. */ |
| 591 | extern void _bfd_generic_link_just_syms |
| 592 | (asection *, struct bfd_link_info *); |
| 593 | |
| 594 | /* Generic routine that does nothing. */ |
| 595 | extern void _bfd_generic_copy_link_hash_symbol_type |
| 596 | (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *); |
| 597 | |
| 598 | /* Generic link routine. */ |
| 599 | extern bfd_boolean _bfd_generic_final_link |
| 600 | (bfd *, struct bfd_link_info *); |
| 601 | |
| 602 | extern bfd_boolean _bfd_generic_link_split_section |
| 603 | (bfd *, struct bfd_section *); |
| 604 | |
| 605 | extern void _bfd_generic_section_already_linked |
| 606 | (bfd *, struct bfd_section *, struct bfd_link_info *); |
| 607 | |
| 608 | /* Generic reloc_link_order processing routine. */ |
| 609 | extern bfd_boolean _bfd_generic_reloc_link_order |
| 610 | (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *); |
| 611 | |
| 612 | /* Default link order processing routine. */ |
| 613 | extern bfd_boolean _bfd_default_link_order |
| 614 | (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *); |
| 615 | |
| 616 | /* Count the number of reloc entries in a link order list. */ |
| 617 | extern unsigned int _bfd_count_link_order_relocs |
| 618 | (struct bfd_link_order *); |
| 619 | |
| 620 | /* Final link relocation routine. */ |
| 621 | extern bfd_reloc_status_type _bfd_final_link_relocate |
| 622 | (reloc_howto_type *, bfd *, asection *, bfd_byte *, |
| 623 | bfd_vma, bfd_vma, bfd_vma); |
| 624 | |
| 625 | /* Relocate a particular location by a howto and a value. */ |
| 626 | extern bfd_reloc_status_type _bfd_relocate_contents |
| 627 | (reloc_howto_type *, bfd *, bfd_vma, bfd_byte *); |
| 628 | |
| 629 | /* Clear a given location using a given howto. */ |
| 630 | extern void _bfd_clear_contents (reloc_howto_type *howto, bfd *input_bfd, |
| 631 | bfd_byte *location); |
| 632 | |
| 633 | /* Link stabs in sections in the first pass. */ |
| 634 | |
| 635 | extern bfd_boolean _bfd_link_section_stabs |
| 636 | (bfd *, struct stab_info *, asection *, asection *, void **, |
| 637 | bfd_size_type *); |
| 638 | |
| 639 | /* Eliminate stabs for discarded functions and symbols. */ |
| 640 | extern bfd_boolean _bfd_discard_section_stabs |
| 641 | (bfd *, asection *, void *, bfd_boolean (*) (bfd_vma, void *), void *); |
| 642 | |
| 643 | /* Write out the .stab section when linking stabs in sections. */ |
| 644 | |
| 645 | extern bfd_boolean _bfd_write_section_stabs |
| 646 | (bfd *, struct stab_info *, asection *, void **, bfd_byte *); |
| 647 | |
| 648 | /* Write out the .stabstr string table when linking stabs in sections. */ |
| 649 | |
| 650 | extern bfd_boolean _bfd_write_stab_strings |
| 651 | (bfd *, struct stab_info *); |
| 652 | |
| 653 | /* Find an offset within a .stab section when linking stabs in |
| 654 | sections. */ |
| 655 | |
| 656 | extern bfd_vma _bfd_stab_section_offset |
| 657 | (asection *, void *, bfd_vma); |
| 658 | |
| 659 | /* Register a SEC_MERGE section as a candidate for merging. */ |
| 660 | |
| 661 | extern bfd_boolean _bfd_add_merge_section |
| 662 | (bfd *, void **, asection *, void **); |
| 663 | |
| 664 | /* Attempt to merge SEC_MERGE sections. */ |
| 665 | |
| 666 | extern bfd_boolean _bfd_merge_sections |
| 667 | (bfd *, struct bfd_link_info *, void *, void (*) (bfd *, asection *)); |
| 668 | |
| 669 | /* Write out a merged section. */ |
| 670 | |
| 671 | extern bfd_boolean _bfd_write_merged_section |
| 672 | (bfd *, asection *, void *); |
| 673 | |
| 674 | /* Find an offset within a modified SEC_MERGE section. */ |
| 675 | |
| 676 | extern bfd_vma _bfd_merged_section_offset |
| 677 | (bfd *, asection **, void *, bfd_vma); |
| 678 | |
| 679 | /* Create a string table. */ |
| 680 | extern struct bfd_strtab_hash *_bfd_stringtab_init |
| 681 | (void); |
| 682 | |
| 683 | /* Create an XCOFF .debug section style string table. */ |
| 684 | extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init |
| 685 | (void); |
| 686 | |
| 687 | /* Free a string table. */ |
| 688 | extern void _bfd_stringtab_free |
| 689 | (struct bfd_strtab_hash *); |
| 690 | |
| 691 | /* Get the size of a string table. */ |
| 692 | extern bfd_size_type _bfd_stringtab_size |
| 693 | (struct bfd_strtab_hash *); |
| 694 | |
| 695 | /* Add a string to a string table. */ |
| 696 | extern bfd_size_type _bfd_stringtab_add |
| 697 | (struct bfd_strtab_hash *, const char *, bfd_boolean hash, bfd_boolean copy); |
| 698 | |
| 699 | /* Write out a string table. */ |
| 700 | extern bfd_boolean _bfd_stringtab_emit |
| 701 | (bfd *, struct bfd_strtab_hash *); |
| 702 | |
| 703 | /* Check that endianness of input and output file match. */ |
| 704 | extern bfd_boolean _bfd_generic_verify_endian_match |
| 705 | (bfd *, bfd *); |
| 706 | \f |
| 707 | /* Macros to tell if bfds are read or write enabled. |
| 708 | |
| 709 | Note that bfds open for read may be scribbled into if the fd passed |
| 710 | to bfd_fdopenr is actually open both for read and write |
| 711 | simultaneously. However an output bfd will never be open for |
| 712 | read. Therefore sometimes you want to check bfd_read_p or |
| 713 | !bfd_read_p, and only sometimes bfd_write_p. |
| 714 | */ |
| 715 | |
| 716 | #define bfd_read_p(abfd) \ |
| 717 | ((abfd)->direction == read_direction || (abfd)->direction == both_direction) |
| 718 | #define bfd_write_p(abfd) \ |
| 719 | ((abfd)->direction == write_direction || (abfd)->direction == both_direction) |
| 720 | |
| 721 | void bfd_assert |
| 722 | (const char*,int); |
| 723 | |
| 724 | #define BFD_ASSERT(x) \ |
| 725 | do { if (!(x)) bfd_assert(__FILE__,__LINE__); } while (0) |
| 726 | |
| 727 | #define BFD_FAIL() \ |
| 728 | do { bfd_assert(__FILE__,__LINE__); } while (0) |
| 729 | |
| 730 | extern void _bfd_abort |
| 731 | (const char *, int, const char *) ATTRIBUTE_NORETURN; |
| 732 | |
| 733 | /* if gcc >= 2.6, we can give a function name, too */ |
| 734 | #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6) |
| 735 | #define __PRETTY_FUNCTION__ ((char *) NULL) |
| 736 | #endif |
| 737 | |
| 738 | #undef abort |
| 739 | #define abort() _bfd_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__) |
| 740 | |
| 741 | /* Manipulate a system FILE but using BFD's "file_ptr", rather than |
| 742 | the system "off_t" or "off64_t", as the offset. */ |
| 743 | extern file_ptr real_ftell (FILE *file); |
| 744 | extern int real_fseek (FILE *file, file_ptr offset, int whence); |
| 745 | extern FILE *real_fopen (const char *filename, const char *modes); |
| 746 | |
| 747 | /* List of supported target vectors, and the default vector (if |
| 748 | bfd_default_vector[0] is NULL, there is no default). */ |
| 749 | extern const bfd_target * const *bfd_target_vector; |
| 750 | extern const bfd_target *bfd_default_vector[]; |
| 751 | |
| 752 | /* List of associated target vectors. */ |
| 753 | extern const bfd_target * const *bfd_associated_vector; |
| 754 | |
| 755 | /* Functions shared by the ECOFF and MIPS ELF backends, which have no |
| 756 | other common header files. */ |
| 757 | |
| 758 | #if defined(__STDC__) || defined(ALMOST_STDC) |
| 759 | struct ecoff_find_line; |
| 760 | #endif |
| 761 | |
| 762 | extern bfd_boolean _bfd_ecoff_locate_line |
| 763 | (bfd *, asection *, bfd_vma, struct ecoff_debug_info * const, |
| 764 | const struct ecoff_debug_swap * const, struct ecoff_find_line *, |
| 765 | const char **, const char **, unsigned int *); |
| 766 | extern bfd_boolean _bfd_ecoff_get_accumulated_pdr |
| 767 | (void *, bfd_byte *); |
| 768 | extern bfd_boolean _bfd_ecoff_get_accumulated_sym |
| 769 | (void *, bfd_byte *); |
| 770 | extern bfd_boolean _bfd_ecoff_get_accumulated_ss |
| 771 | (void *, bfd_byte *); |
| 772 | |
| 773 | extern bfd_vma _bfd_get_gp_value |
| 774 | (bfd *); |
| 775 | extern void _bfd_set_gp_value |
| 776 | (bfd *, bfd_vma); |
| 777 | |
| 778 | /* Function shared by the COFF and ELF SH backends, which have no |
| 779 | other common header files. */ |
| 780 | |
| 781 | #ifndef _bfd_sh_align_load_span |
| 782 | extern bfd_boolean _bfd_sh_align_load_span |
| 783 | (bfd *, asection *, bfd_byte *, |
| 784 | bfd_boolean (*) (bfd *, asection *, void *, bfd_byte *, bfd_vma), |
| 785 | void *, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, bfd_boolean *); |
| 786 | #endif |
| 787 | |
| 788 | /* This is the shape of the elements inside the already_linked hash |
| 789 | table. It maps a name onto a list of already_linked elements with |
| 790 | the same name. */ |
| 791 | |
| 792 | struct bfd_section_already_linked_hash_entry |
| 793 | { |
| 794 | struct bfd_hash_entry root; |
| 795 | struct bfd_section_already_linked *entry; |
| 796 | }; |
| 797 | |
| 798 | struct bfd_section_already_linked |
| 799 | { |
| 800 | struct bfd_section_already_linked *next; |
| 801 | asection *sec; |
| 802 | }; |
| 803 | |
| 804 | extern struct bfd_section_already_linked_hash_entry * |
| 805 | bfd_section_already_linked_table_lookup (const char *); |
| 806 | extern bfd_boolean bfd_section_already_linked_table_insert |
| 807 | (struct bfd_section_already_linked_hash_entry *, asection *); |
| 808 | extern void bfd_section_already_linked_table_traverse |
| 809 | (bfd_boolean (*) (struct bfd_section_already_linked_hash_entry *, |
| 810 | void *), void *); |
| 811 | |
| 812 | extern bfd_vma read_unsigned_leb128 (bfd *, bfd_byte *, unsigned int *); |
| 813 | extern bfd_signed_vma read_signed_leb128 (bfd *, bfd_byte *, unsigned int *); |
| 814 | |