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