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