Commit | Line | Data |
---|---|---|
252b5132 | 1 | /* Main header file for the bfd library -- portable access to object files. |
c2852e88 | 2 | |
250d07de | 3 | Copyright (C) 1990-2021 Free Software Foundation, Inc. |
c2852e88 | 4 | |
252b5132 RH |
5 | Contributed by Cygnus Support. |
6 | ||
8afb0e02 | 7 | This file is part of BFD, the Binary File Descriptor library. |
252b5132 | 8 | |
8afb0e02 NC |
9 | This program is free software; you can redistribute it and/or modify |
10 | it under the terms of the GNU General Public License as published by | |
cd123cb7 | 11 | the Free Software Foundation; either version 3 of the License, or |
8afb0e02 | 12 | (at your option) any later version. |
252b5132 | 13 | |
8afb0e02 NC |
14 | This program is distributed in the hope that it will be useful, |
15 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 | GNU General Public License for more details. | |
252b5132 | 18 | |
8afb0e02 NC |
19 | You should have received a copy of the GNU General Public License |
20 | along with this program; if not, write to the Free Software | |
3e110533 | 21 | Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */ |
252b5132 | 22 | |
252b5132 RH |
23 | #ifndef __BFD_H_SEEN__ |
24 | #define __BFD_H_SEEN__ | |
25 | ||
0bee45d9 NC |
26 | /* PR 14072: Ensure that config.h is included first. */ |
27 | #if !defined PACKAGE && !defined PACKAGE_VERSION | |
df7b86aa NC |
28 | #error config.h must be included before this header |
29 | #endif | |
30 | ||
252b5132 RH |
31 | #ifdef __cplusplus |
32 | extern "C" { | |
33 | #endif | |
34 | ||
35 | #include "ansidecl.h" | |
e43d48cc | 36 | #include "symcat.h" |
2d5d5a8f | 37 | #include "bfd_stdint.h" |
95da9854 | 38 | #include "diagnostics.h" |
52d45da3 | 39 | #include <stdarg.h> |
f1163205 NC |
40 | #include <sys/stat.h> |
41 | ||
e43d48cc AM |
42 | #if defined (__STDC__) || defined (ALMOST_STDC) || defined (HAVE_STRINGIZE) |
43 | #ifndef SABER | |
44 | /* This hack is to avoid a problem with some strict ANSI C preprocessors. | |
45 | The problem is, "32_" is not a valid preprocessing token, and we don't | |
46 | want extra underscores (e.g., "nlm_32_"). The XCONCAT2 macro will | |
47 | cause the inner CONCAT2 macros to be evaluated first, producing | |
48 | still-valid pp-tokens. Then the final concatenation can be done. */ | |
49 | #undef CONCAT4 | |
50 | #define CONCAT4(a,b,c,d) XCONCAT2(CONCAT2(a,b),CONCAT2(c,d)) | |
51 | #endif | |
52 | #endif | |
252b5132 | 53 | |
0112cd26 NC |
54 | /* This is a utility macro to handle the situation where the code |
55 | wants to place a constant string into the code, followed by a | |
56 | comma and then the length of the string. Doing this by hand | |
db86b2dc PA |
57 | is error prone, so using this macro is safer. */ |
58 | #define STRING_COMMA_LEN(STR) (STR), (sizeof (STR) - 1) | |
0112cd26 NC |
59 | /* Unfortunately it is not possible to use the STRING_COMMA_LEN macro |
60 | to create the arguments to another macro, since the preprocessor | |
61 | will mis-count the number of arguments to the outer macro (by not | |
62 | evaluating STRING_COMMA_LEN and so missing the comma). This is a | |
63 | problem for example when trying to use STRING_COMMA_LEN to build | |
64 | the arguments to the strncmp() macro. Hence this alternative | |
65 | definition of strncmp is provided here. | |
68ffbac6 | 66 | |
0112cd26 | 67 | Note - these macros do NOT work if STR2 is not a constant string. */ |
ea9986ff NC |
68 | /* strcpy() can have a similar problem, but since we know we are |
69 | copying a constant string, we can use memcpy which will be faster | |
70 | since there is no need to check for a NUL byte inside STR. We | |
71 | can also save time if we do not need to copy the terminating NUL. */ | |
72 | #define LITMEMCPY(DEST,STR2) memcpy ((DEST), (STR2), sizeof (STR2) - 1) | |
73 | #define LITSTRCPY(DEST,STR2) memcpy ((DEST), (STR2), sizeof (STR2)) | |
0112cd26 NC |
74 | |
75 | ||
ce3c775b NC |
76 | #define BFD_SUPPORTS_PLUGINS @supports_plugins@ |
77 | ||
69263e90 AM |
78 | /* The word size used by BFD on the host. This may be 64 with a 32 |
79 | bit target if the host is 64 bit, or if other 64 bit targets have | |
80 | been selected with --enable-targets, or if --enable-64-bit-bfd. */ | |
252b5132 | 81 | #define BFD_ARCH_SIZE @wordsize@ |
69263e90 AM |
82 | |
83 | /* The word size of the default bfd target. */ | |
84 | #define BFD_DEFAULT_TARGET_SIZE @bfd_default_target_size@ | |
85 | ||
252b5132 | 86 | #define BFD_HOST_64BIT_LONG @BFD_HOST_64BIT_LONG@ |
d2df793a | 87 | #define BFD_HOST_64BIT_LONG_LONG @BFD_HOST_64BIT_LONG_LONG@ |
252b5132 RH |
88 | #if @BFD_HOST_64_BIT_DEFINED@ |
89 | #define BFD_HOST_64_BIT @BFD_HOST_64_BIT@ | |
90 | #define BFD_HOST_U_64_BIT @BFD_HOST_U_64_BIT@ | |
8ce8c090 AM |
91 | typedef BFD_HOST_64_BIT bfd_int64_t; |
92 | typedef BFD_HOST_U_64_BIT bfd_uint64_t; | |
252b5132 RH |
93 | #endif |
94 | ||
2dcf00ce AM |
95 | #ifdef HAVE_INTTYPES_H |
96 | # include <inttypes.h> | |
97 | #else | |
98 | # if BFD_HOST_64BIT_LONG | |
99 | # define BFD_PRI64 "l" | |
100 | # elif defined (__MSVCRT__) | |
101 | # define BFD_PRI64 "I64" | |
102 | # else | |
103 | # define BFD_PRI64 "ll" | |
104 | # endif | |
105 | # undef PRId64 | |
106 | # define PRId64 BFD_PRI64 "d" | |
107 | # undef PRIu64 | |
108 | # define PRIu64 BFD_PRI64 "u" | |
109 | # undef PRIx64 | |
110 | # define PRIx64 BFD_PRI64 "x" | |
111 | #endif | |
112 | ||
252b5132 RH |
113 | #if BFD_ARCH_SIZE >= 64 |
114 | #define BFD64 | |
115 | #endif | |
116 | ||
117 | #ifndef INLINE | |
118 | #if __GNUC__ >= 2 | |
119 | #define INLINE __inline__ | |
120 | #else | |
121 | #define INLINE | |
122 | #endif | |
123 | #endif | |
124 | ||
d2df793a | 125 | /* Declaring a type wide enough to hold a host long and a host pointer. */ |
07d6d2b8 | 126 | #define BFD_HOSTPTR_T @BFD_HOSTPTR_T@ |
d2df793a NC |
127 | typedef BFD_HOSTPTR_T bfd_hostptr_t; |
128 | ||
b5f79c76 | 129 | /* Forward declaration. */ |
c2852e88 | 130 | typedef struct bfd bfd; |
252b5132 | 131 | |
b34976b6 AM |
132 | /* Boolean type used in bfd. Too many systems define their own |
133 | versions of "boolean" for us to safely typedef a "boolean" of | |
cf3d882d | 134 | our own. Using an enum for "bfd_boolean" has its own set of |
b34976b6 AM |
135 | problems, with strange looking casts required to avoid warnings |
136 | on some older compilers. Thus we just use an int. | |
137 | ||
cf3d882d | 138 | General rule: Functions which are bfd_boolean return TRUE on |
b34976b6 AM |
139 | success and FALSE on failure (unless they're a predicate). */ |
140 | ||
141 | typedef int bfd_boolean; | |
142 | #undef FALSE | |
143 | #undef TRUE | |
144 | #define FALSE 0 | |
145 | #define TRUE 1 | |
146 | ||
252b5132 RH |
147 | #ifdef BFD64 |
148 | ||
149 | #ifndef BFD_HOST_64_BIT | |
150 | #error No 64 bit integer type available | |
151 | #endif /* ! defined (BFD_HOST_64_BIT) */ | |
152 | ||
153 | typedef BFD_HOST_U_64_BIT bfd_vma; | |
154 | typedef BFD_HOST_64_BIT bfd_signed_vma; | |
155 | typedef BFD_HOST_U_64_BIT bfd_size_type; | |
156 | typedef BFD_HOST_U_64_BIT symvalue; | |
157 | ||
252b5132 | 158 | #if BFD_HOST_64BIT_LONG |
14a91970 AM |
159 | #define BFD_VMA_FMT "l" |
160 | #elif defined (__MSVCRT__) | |
161 | #define BFD_VMA_FMT "I64" | |
6e3d6dc1 | 162 | #else |
14a91970 | 163 | #define BFD_VMA_FMT "ll" |
252b5132 | 164 | #endif |
14a91970 AM |
165 | |
166 | #ifndef fprintf_vma | |
167 | #define sprintf_vma(s,x) sprintf (s, "%016" BFD_VMA_FMT "x", x) | |
168 | #define fprintf_vma(f,x) fprintf (f, "%016" BFD_VMA_FMT "x", x) | |
252b5132 RH |
169 | #endif |
170 | ||
171 | #else /* not BFD64 */ | |
172 | ||
173 | /* Represent a target address. Also used as a generic unsigned type | |
174 | which is guaranteed to be big enough to hold any arithmetic types | |
175 | we need to deal with. */ | |
176 | typedef unsigned long bfd_vma; | |
177 | ||
178 | /* A generic signed type which is guaranteed to be big enough to hold any | |
179 | arithmetic types we need to deal with. Can be assumed to be compatible | |
180 | with bfd_vma in the same way that signed and unsigned ints are compatible | |
181 | (as parameters, in assignment, etc). */ | |
182 | typedef long bfd_signed_vma; | |
183 | ||
184 | typedef unsigned long symvalue; | |
185 | typedef unsigned long bfd_size_type; | |
186 | ||
187 | /* Print a bfd_vma x on stream s. */ | |
14a91970 AM |
188 | #define BFD_VMA_FMT "l" |
189 | #define fprintf_vma(s,x) fprintf (s, "%08" BFD_VMA_FMT "x", x) | |
190 | #define sprintf_vma(s,x) sprintf (s, "%08" BFD_VMA_FMT "x", x) | |
252b5132 RH |
191 | |
192 | #endif /* not BFD64 */ | |
193 | ||
d0fb9a8d JJ |
194 | #define HALF_BFD_SIZE_TYPE \ |
195 | (((bfd_size_type) 1) << (8 * sizeof (bfd_size_type) / 2)) | |
196 | ||
8ce8c090 AM |
197 | #ifndef BFD_HOST_64_BIT |
198 | /* Fall back on a 32 bit type. The idea is to make these types always | |
199 | available for function return types, but in the case that | |
200 | BFD_HOST_64_BIT is undefined such a function should abort or | |
201 | otherwise signal an error. */ | |
202 | typedef bfd_signed_vma bfd_int64_t; | |
203 | typedef bfd_vma bfd_uint64_t; | |
204 | #endif | |
205 | ||
d7ce59e3 AC |
206 | /* An offset into a file. BFD always uses the largest possible offset |
207 | based on the build time availability of fseek, fseeko, or fseeko64. */ | |
208 | typedef @bfd_file_ptr@ file_ptr; | |
209 | typedef unsigned @bfd_file_ptr@ ufile_ptr; | |
dc810e39 | 210 | |
c58b9523 AM |
211 | extern void bfd_sprintf_vma (bfd *, char *, bfd_vma); |
212 | extern void bfd_fprintf_vma (bfd *, void *, bfd_vma); | |
ae4221d7 | 213 | |
252b5132 | 214 | #define printf_vma(x) fprintf_vma(stdout,x) |
ae4221d7 | 215 | #define bfd_printf_vma(abfd,x) bfd_fprintf_vma (abfd,stdout,x) |
252b5132 RH |
216 | |
217 | typedef unsigned int flagword; /* 32 bits of flags */ | |
218 | typedef unsigned char bfd_byte; | |
219 | \f | |
b5f79c76 | 220 | /* File formats. */ |
252b5132 | 221 | |
b5f79c76 NC |
222 | typedef enum bfd_format |
223 | { | |
224 | bfd_unknown = 0, /* File format is unknown. */ | |
5c4491d3 | 225 | bfd_object, /* Linker/assembler/compiler output. */ |
b5f79c76 NC |
226 | bfd_archive, /* Object archive file. */ |
227 | bfd_core, /* Core dump. */ | |
228 | bfd_type_end /* Marks the end; don't use it! */ | |
229 | } | |
230 | bfd_format; | |
252b5132 | 231 | \f |
b5f79c76 | 232 | /* Symbols and relocation. */ |
252b5132 RH |
233 | |
234 | /* A count of carsyms (canonical archive symbols). */ | |
235 | typedef unsigned long symindex; | |
236 | ||
252b5132 RH |
237 | #define BFD_NO_MORE_SYMBOLS ((symindex) ~0) |
238 | ||
252b5132 | 239 | /* A canonical archive symbol. */ |
b5f79c76 NC |
240 | /* This is a type pun with struct ranlib on purpose! */ |
241 | typedef struct carsym | |
242 | { | |
1d38e9d1 | 243 | const char *name; |
b5f79c76 NC |
244 | file_ptr file_offset; /* Look here to find the file. */ |
245 | } | |
246 | carsym; /* To make these you call a carsymogen. */ | |
252b5132 | 247 | |
252b5132 | 248 | /* Used in generating armaps (archive tables of contents). |
b5f79c76 | 249 | Perhaps just a forward definition would do? */ |
07d6d2b8 | 250 | struct orl /* Output ranlib. */ |
b5f79c76 NC |
251 | { |
252 | char **name; /* Symbol name. */ | |
253 | union | |
254 | { | |
dc810e39 AM |
255 | file_ptr pos; |
256 | bfd *abfd; | |
b5f79c76 NC |
257 | } u; /* bfd* or file position. */ |
258 | int namidx; /* Index into string table. */ | |
252b5132 | 259 | }; |
76e7a751 | 260 | |
b5f79c76 NC |
261 | /* Linenumber stuff. */ |
262 | typedef struct lineno_cache_entry | |
263 | { | |
264 | unsigned int line_number; /* Linenumber from start of function. */ | |
265 | union | |
266 | { | |
fc0a2244 | 267 | struct bfd_symbol *sym; /* Function name. */ |
07d6d2b8 | 268 | bfd_vma offset; /* Offset into section. */ |
252b5132 | 269 | } u; |
b5f79c76 NC |
270 | } |
271 | alent; | |
252b5132 | 272 | \f |
b5f79c76 | 273 | /* Object and core file sections. */ |
76e7a751 | 274 | typedef struct bfd_section *sec_ptr; |
252b5132 RH |
275 | |
276 | #define align_power(addr, align) \ | |
29f628db | 277 | (((addr) + ((bfd_vma) 1 << (align)) - 1) & (-((bfd_vma) 1 << (align)))) |
252b5132 | 278 | |
76e7a751 AM |
279 | /* Align an address upward to a boundary, expressed as a number of bytes. |
280 | E.g. align to an 8-byte boundary with argument of 8. Take care never | |
281 | to wrap around if the address is within boundary-1 of the end of the | |
282 | address space. */ | |
283 | #define BFD_ALIGN(this, boundary) \ | |
284 | ((((bfd_vma) (this) + (boundary) - 1) >= (bfd_vma) (this)) \ | |
285 | ? (((bfd_vma) (this) + ((boundary) - 1)) & ~ (bfd_vma) ((boundary)-1)) \ | |
286 | : ~ (bfd_vma) 0) | |
252b5132 RH |
287 | \f |
288 | typedef enum bfd_print_symbol | |
60bcf0fa | 289 | { |
252b5132 RH |
290 | bfd_print_symbol_name, |
291 | bfd_print_symbol_more, | |
292 | bfd_print_symbol_all | |
293 | } bfd_print_symbol_type; | |
60bcf0fa | 294 | |
252b5132 RH |
295 | /* Information about a symbol that nm needs. */ |
296 | ||
297 | typedef struct _symbol_info | |
298 | { | |
299 | symvalue value; | |
300 | char type; | |
07d6d2b8 AM |
301 | const char *name; /* Symbol name. */ |
302 | unsigned char stab_type; /* Stab type. */ | |
303 | char stab_other; /* Stab other. */ | |
304 | short stab_desc; /* Stab desc. */ | |
305 | const char *stab_name; /* String for stab type. */ | |
252b5132 RH |
306 | } symbol_info; |
307 | ||
308 | /* Get the name of a stabs type code. */ | |
309 | ||
c58b9523 | 310 | extern const char *bfd_get_stab_name (int); |
252b5132 RH |
311 | \f |
312 | /* Hash table routines. There is no way to free up a hash table. */ | |
313 | ||
314 | /* An element in the hash table. Most uses will actually use a larger | |
315 | structure, and an instance of this will be the first field. */ | |
316 | ||
317 | struct bfd_hash_entry | |
318 | { | |
319 | /* Next entry for this hash code. */ | |
320 | struct bfd_hash_entry *next; | |
321 | /* String being hashed. */ | |
322 | const char *string; | |
323 | /* Hash code. This is the full hash code, not the index into the | |
324 | table. */ | |
325 | unsigned long hash; | |
326 | }; | |
327 | ||
328 | /* A hash table. */ | |
329 | ||
330 | struct bfd_hash_table | |
331 | { | |
332 | /* The hash array. */ | |
333 | struct bfd_hash_entry **table; | |
252b5132 RH |
334 | /* A function used to create new elements in the hash table. The |
335 | first entry is itself a pointer to an element. When this | |
336 | function is first invoked, this pointer will be NULL. However, | |
337 | having the pointer permits a hierarchy of method functions to be | |
338 | built each of which calls the function in the superclass. Thus | |
339 | each function should be written to allocate a new block of memory | |
340 | only if the argument is NULL. */ | |
b34976b6 | 341 | struct bfd_hash_entry *(*newfunc) |
c58b9523 | 342 | (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); |
07d6d2b8 | 343 | /* An objalloc for this hash table. This is a struct objalloc *, |
c58b9523 AM |
344 | but we use void * to avoid requiring the inclusion of objalloc.h. */ |
345 | void *memory; | |
98f0b6ab AM |
346 | /* The number of slots in the hash table. */ |
347 | unsigned int size; | |
348 | /* The number of entries in the hash table. */ | |
349 | unsigned int count; | |
350 | /* The size of elements. */ | |
351 | unsigned int entsize; | |
352 | /* If non-zero, don't grow the hash table. */ | |
353 | unsigned int frozen:1; | |
252b5132 RH |
354 | }; |
355 | ||
356 | /* Initialize a hash table. */ | |
b34976b6 | 357 | extern bfd_boolean bfd_hash_table_init |
c58b9523 AM |
358 | (struct bfd_hash_table *, |
359 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, | |
360 | struct bfd_hash_table *, | |
66eb6687 AM |
361 | const char *), |
362 | unsigned int); | |
252b5132 RH |
363 | |
364 | /* Initialize a hash table specifying a size. */ | |
b34976b6 | 365 | extern bfd_boolean bfd_hash_table_init_n |
c58b9523 AM |
366 | (struct bfd_hash_table *, |
367 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, | |
368 | struct bfd_hash_table *, | |
369 | const char *), | |
66eb6687 | 370 | unsigned int, unsigned int); |
252b5132 RH |
371 | |
372 | /* Free up a hash table. */ | |
b34976b6 | 373 | extern void bfd_hash_table_free |
c58b9523 | 374 | (struct bfd_hash_table *); |
252b5132 | 375 | |
b34976b6 | 376 | /* Look up a string in a hash table. If CREATE is TRUE, a new entry |
252b5132 | 377 | will be created for this string if one does not already exist. The |
b34976b6 | 378 | COPY argument must be TRUE if this routine should copy the string |
252b5132 RH |
379 | into newly allocated memory when adding an entry. */ |
380 | extern struct bfd_hash_entry *bfd_hash_lookup | |
c58b9523 AM |
381 | (struct bfd_hash_table *, const char *, bfd_boolean create, |
382 | bfd_boolean copy); | |
252b5132 | 383 | |
a69898aa AM |
384 | /* Insert an entry in a hash table. */ |
385 | extern struct bfd_hash_entry *bfd_hash_insert | |
386 | (struct bfd_hash_table *, const char *, unsigned long); | |
387 | ||
4e011fb5 AM |
388 | /* Rename an entry in a hash table. */ |
389 | extern void bfd_hash_rename | |
390 | (struct bfd_hash_table *, const char *, struct bfd_hash_entry *); | |
391 | ||
252b5132 RH |
392 | /* Replace an entry in a hash table. */ |
393 | extern void bfd_hash_replace | |
c58b9523 AM |
394 | (struct bfd_hash_table *, struct bfd_hash_entry *old, |
395 | struct bfd_hash_entry *nw); | |
252b5132 RH |
396 | |
397 | /* Base method for creating a hash table entry. */ | |
398 | extern struct bfd_hash_entry *bfd_hash_newfunc | |
c58b9523 | 399 | (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); |
252b5132 RH |
400 | |
401 | /* Grab some space for a hash table entry. */ | |
c58b9523 AM |
402 | extern void *bfd_hash_allocate |
403 | (struct bfd_hash_table *, unsigned int); | |
252b5132 RH |
404 | |
405 | /* Traverse a hash table in a random order, calling a function on each | |
b34976b6 | 406 | element. If the function returns FALSE, the traversal stops. The |
252b5132 | 407 | INFO argument is passed to the function. */ |
b34976b6 | 408 | extern void bfd_hash_traverse |
c58b9523 AM |
409 | (struct bfd_hash_table *, |
410 | bfd_boolean (*) (struct bfd_hash_entry *, void *), | |
411 | void *info); | |
252b5132 | 412 | |
2d643429 NC |
413 | /* Allows the default size of a hash table to be configured. New hash |
414 | tables allocated using bfd_hash_table_init will be created with | |
415 | this size. */ | |
8ad17b3a | 416 | extern unsigned long bfd_hash_set_default_size (unsigned long); |
2d643429 | 417 | |
0ce398f1 L |
418 | /* Types of compressed DWARF debug sections. We currently support |
419 | zlib. */ | |
420 | enum compressed_debug_section_type | |
421 | { | |
422 | COMPRESS_DEBUG_NONE = 0, | |
423 | COMPRESS_DEBUG = 1 << 0, | |
ee0c0c50 L |
424 | COMPRESS_DEBUG_GNU_ZLIB = COMPRESS_DEBUG | 1 << 1, |
425 | COMPRESS_DEBUG_GABI_ZLIB = COMPRESS_DEBUG | 1 << 2 | |
0ce398f1 L |
426 | }; |
427 | ||
3722b82f AM |
428 | /* This structure is used to keep track of stabs in sections |
429 | information while linking. */ | |
430 | ||
431 | struct stab_info | |
432 | { | |
433 | /* A hash table used to hold stabs strings. */ | |
434 | struct bfd_strtab_hash *strings; | |
435 | /* The header file hash table. */ | |
436 | struct bfd_hash_table includes; | |
437 | /* The first .stabstr section. */ | |
438 | struct bfd_section *stabstr; | |
439 | }; | |
440 | ||
c58b9523 | 441 | #define COFF_SWAP_TABLE (void *) &bfd_coff_std_swap_table |
e43d48cc | 442 | |
b5f79c76 | 443 | /* User program access to BFD facilities. */ |
252b5132 RH |
444 | |
445 | /* Direct I/O routines, for programs which know more about the object | |
446 | file than BFD does. Use higher level routines if possible. */ | |
447 | ||
c58b9523 AM |
448 | extern bfd_size_type bfd_bread (void *, bfd_size_type, bfd *); |
449 | extern bfd_size_type bfd_bwrite (const void *, bfd_size_type, bfd *); | |
450 | extern int bfd_seek (bfd *, file_ptr, int); | |
7c192733 | 451 | extern file_ptr bfd_tell (bfd *); |
c58b9523 AM |
452 | extern int bfd_flush (bfd *); |
453 | extern int bfd_stat (bfd *, struct stat *); | |
dc810e39 AM |
454 | |
455 | /* Deprecated old routines. */ | |
456 | #if __GNUC__ | |
457 | #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD) \ | |
8c8402cc | 458 | (_bfd_warn_deprecated ("bfd_read", __FILE__, __LINE__, __FUNCTION__), \ |
dc810e39 AM |
459 | bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) |
460 | #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD) \ | |
07d6d2b8 | 461 | (_bfd_warn_deprecated ("bfd_write", __FILE__, __LINE__, __FUNCTION__), \ |
dc810e39 AM |
462 | bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) |
463 | #else | |
464 | #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD) \ | |
8c8402cc | 465 | (_bfd_warn_deprecated ("bfd_read", (const char *) 0, 0, (const char *) 0), \ |
dc810e39 AM |
466 | bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) |
467 | #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD) \ | |
8c8402cc | 468 | (_bfd_warn_deprecated ("bfd_write", (const char *) 0, 0, (const char *) 0),\ |
dc810e39 AM |
469 | bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) |
470 | #endif | |
8c8402cc | 471 | extern void _bfd_warn_deprecated (const char *, const char *, int, const char *); |
252b5132 | 472 | |
b34976b6 | 473 | extern bfd_boolean bfd_cache_close |
c58b9523 | 474 | (bfd *abfd); |
d436a9b3 FCE |
475 | /* NB: This declaration should match the autogenerated one in libbfd.h. */ |
476 | ||
02d5a37b JG |
477 | extern bfd_boolean bfd_cache_close_all (void); |
478 | ||
b34976b6 | 479 | extern bfd_boolean bfd_record_phdr |
c58b9523 | 480 | (bfd *, unsigned long, bfd_boolean, flagword, bfd_boolean, bfd_vma, |
198beae2 | 481 | bfd_boolean, bfd_boolean, unsigned int, struct bfd_section **); |
252b5132 RH |
482 | |
483 | /* Byte swapping routines. */ | |
484 | ||
8ce8c090 AM |
485 | bfd_uint64_t bfd_getb64 (const void *); |
486 | bfd_uint64_t bfd_getl64 (const void *); | |
487 | bfd_int64_t bfd_getb_signed_64 (const void *); | |
488 | bfd_int64_t bfd_getl_signed_64 (const void *); | |
edeb6e24 AM |
489 | bfd_vma bfd_getb32 (const void *); |
490 | bfd_vma bfd_getl32 (const void *); | |
491 | bfd_signed_vma bfd_getb_signed_32 (const void *); | |
492 | bfd_signed_vma bfd_getl_signed_32 (const void *); | |
493 | bfd_vma bfd_getb16 (const void *); | |
494 | bfd_vma bfd_getl16 (const void *); | |
495 | bfd_signed_vma bfd_getb_signed_16 (const void *); | |
496 | bfd_signed_vma bfd_getl_signed_16 (const void *); | |
8ce8c090 AM |
497 | void bfd_putb64 (bfd_uint64_t, void *); |
498 | void bfd_putl64 (bfd_uint64_t, void *); | |
edeb6e24 AM |
499 | void bfd_putb32 (bfd_vma, void *); |
500 | void bfd_putl32 (bfd_vma, void *); | |
7b4ae824 JD |
501 | void bfd_putb24 (bfd_vma, void *); |
502 | void bfd_putl24 (bfd_vma, void *); | |
edeb6e24 AM |
503 | void bfd_putb16 (bfd_vma, void *); |
504 | void bfd_putl16 (bfd_vma, void *); | |
8c603c85 NC |
505 | |
506 | /* Byte swapping routines which take size and endiannes as arguments. */ | |
507 | ||
8ce8c090 AM |
508 | bfd_uint64_t bfd_get_bits (const void *, int, bfd_boolean); |
509 | void bfd_put_bits (bfd_uint64_t, void *, int, bfd_boolean); | |
082b7297 | 510 | |
f652615e | 511 | |
252b5132 RH |
512 | /* mmap hacks */ |
513 | ||
514 | struct _bfd_window_internal; | |
515 | typedef struct _bfd_window_internal bfd_window_internal; | |
516 | ||
b5f79c76 NC |
517 | typedef struct _bfd_window |
518 | { | |
252b5132 | 519 | /* What the user asked for. */ |
c58b9523 | 520 | void *data; |
252b5132 RH |
521 | bfd_size_type size; |
522 | /* The actual window used by BFD. Small user-requested read-only | |
523 | regions sharing a page may share a single window into the object | |
524 | file. Read-write versions shouldn't until I've fixed things to | |
525 | keep track of which portions have been claimed by the | |
526 | application; don't want to give the same region back when the | |
527 | application wants two writable copies! */ | |
528 | struct _bfd_window_internal *i; | |
b5f79c76 NC |
529 | } |
530 | bfd_window; | |
252b5132 | 531 | |
b34976b6 | 532 | extern void bfd_init_window |
c58b9523 | 533 | (bfd_window *); |
b34976b6 | 534 | extern void bfd_free_window |
c58b9523 | 535 | (bfd_window *); |
b34976b6 | 536 | extern bfd_boolean bfd_get_file_window |
c58b9523 | 537 | (bfd *, file_ptr, bfd_size_type, bfd_window *, bfd_boolean); |
640197ac AM |
538 | \f |
539 | /* Externally visible ELF routines. */ | |
540 | ||
541 | /* Create a new BFD as if by bfd_openr. Rather than opening a file, | |
542 | reconstruct an ELF file by reading the segments out of remote | |
543 | memory based on the ELF file header at EHDR_VMA and the ELF program | |
544 | headers it points to. If non-zero, SIZE is the known extent of the | |
545 | object. If not null, *LOADBASEP is filled in with the difference | |
546 | between the VMAs from which the segments were read, and the VMAs | |
547 | the file headers (and hence BFD's idea of each section's VMA) put | |
548 | them at. | |
549 | ||
550 | The function TARGET_READ_MEMORY is called to copy LEN bytes from | |
551 | the remote memory at target address VMA into the local buffer at | |
552 | MYADDR; it should return zero on success or an `errno' code on | |
553 | failure. TEMPL must be a BFD for a target with the word size and | |
554 | byte order found in the remote memory. */ | |
555 | extern bfd *bfd_elf_bfd_from_remote_memory | |
556 | (bfd *templ, bfd_vma ehdr_vma, bfd_size_type size, bfd_vma *loadbasep, | |
557 | int (*target_read_memory) (bfd_vma vma, bfd_byte *myaddr, | |
558 | bfd_size_type len)); | |
559 | ||
560 | /* Forward declarations. */ | |
561 | struct ecoff_debug_info; | |
562 | struct ecoff_debug_swap; | |
563 | struct ecoff_extr; | |
564 | struct bfd_link_info; | |
565 | struct bfd_link_hash_entry; | |
e9338841 AM |
566 | |
567 | /* Return TRUE if the start of STR matches PREFIX, FALSE otherwise. */ | |
568 | ||
569 | static inline bfd_boolean | |
570 | startswith (const char *str, const char *prefix) | |
571 | { | |
572 | return strncmp (str, prefix, strlen (prefix)) == 0; | |
573 | } | |
574 | #define CONST_STRNEQ(STR1,STR2) startswith (STR1, STR2) |