Commit | Line | Data |
---|---|---|
252b5132 | 1 | /* Main header file for the bfd library -- portable access to object files. |
c2852e88 | 2 | |
e57278ef | 3 | Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, |
f67f98b5 AM |
4 | 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, |
5 | 2012 Free Software Foundation, Inc. | |
c2852e88 | 6 | |
252b5132 RH |
7 | Contributed by Cygnus Support. |
8 | ||
8afb0e02 | 9 | This file is part of BFD, the Binary File Descriptor library. |
252b5132 | 10 | |
8afb0e02 NC |
11 | This program is free software; you can redistribute it and/or modify |
12 | it under the terms of the GNU General Public License as published by | |
cd123cb7 | 13 | the Free Software Foundation; either version 3 of the License, or |
8afb0e02 | 14 | (at your option) any later version. |
252b5132 | 15 | |
8afb0e02 NC |
16 | This program is distributed in the hope that it will be useful, |
17 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 | GNU General Public License for more details. | |
252b5132 | 20 | |
8afb0e02 NC |
21 | You should have received a copy of the GNU General Public License |
22 | along with this program; if not, write to the Free Software | |
3e110533 | 23 | Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */ |
252b5132 | 24 | |
252b5132 RH |
25 | #ifndef __BFD_H_SEEN__ |
26 | #define __BFD_H_SEEN__ | |
27 | ||
df7b86aa NC |
28 | #ifndef PACKAGE |
29 | #error config.h must be included before this header | |
30 | #endif | |
31 | ||
252b5132 RH |
32 | #ifdef __cplusplus |
33 | extern "C" { | |
34 | #endif | |
35 | ||
36 | #include "ansidecl.h" | |
e43d48cc | 37 | #include "symcat.h" |
f1163205 NC |
38 | #include <sys/stat.h> |
39 | ||
e43d48cc AM |
40 | #if defined (__STDC__) || defined (ALMOST_STDC) || defined (HAVE_STRINGIZE) |
41 | #ifndef SABER | |
42 | /* This hack is to avoid a problem with some strict ANSI C preprocessors. | |
43 | The problem is, "32_" is not a valid preprocessing token, and we don't | |
44 | want extra underscores (e.g., "nlm_32_"). The XCONCAT2 macro will | |
45 | cause the inner CONCAT2 macros to be evaluated first, producing | |
46 | still-valid pp-tokens. Then the final concatenation can be done. */ | |
47 | #undef CONCAT4 | |
48 | #define CONCAT4(a,b,c,d) XCONCAT2(CONCAT2(a,b),CONCAT2(c,d)) | |
49 | #endif | |
50 | #endif | |
252b5132 | 51 | |
0112cd26 NC |
52 | /* This is a utility macro to handle the situation where the code |
53 | wants to place a constant string into the code, followed by a | |
54 | comma and then the length of the string. Doing this by hand | |
db86b2dc PA |
55 | is error prone, so using this macro is safer. */ |
56 | #define STRING_COMMA_LEN(STR) (STR), (sizeof (STR) - 1) | |
0112cd26 NC |
57 | /* Unfortunately it is not possible to use the STRING_COMMA_LEN macro |
58 | to create the arguments to another macro, since the preprocessor | |
59 | will mis-count the number of arguments to the outer macro (by not | |
60 | evaluating STRING_COMMA_LEN and so missing the comma). This is a | |
61 | problem for example when trying to use STRING_COMMA_LEN to build | |
62 | the arguments to the strncmp() macro. Hence this alternative | |
63 | definition of strncmp is provided here. | |
64 | ||
65 | Note - these macros do NOT work if STR2 is not a constant string. */ | |
66 | #define CONST_STRNEQ(STR1,STR2) (strncmp ((STR1), (STR2), sizeof (STR2) - 1) == 0) | |
ea9986ff NC |
67 | /* strcpy() can have a similar problem, but since we know we are |
68 | copying a constant string, we can use memcpy which will be faster | |
69 | since there is no need to check for a NUL byte inside STR. We | |
70 | can also save time if we do not need to copy the terminating NUL. */ | |
71 | #define LITMEMCPY(DEST,STR2) memcpy ((DEST), (STR2), sizeof (STR2) - 1) | |
72 | #define LITSTRCPY(DEST,STR2) memcpy ((DEST), (STR2), sizeof (STR2)) | |
0112cd26 NC |
73 | |
74 | ||
ce3c775b NC |
75 | #define BFD_SUPPORTS_PLUGINS @supports_plugins@ |
76 | ||
69263e90 AM |
77 | /* The word size used by BFD on the host. This may be 64 with a 32 |
78 | bit target if the host is 64 bit, or if other 64 bit targets have | |
79 | been selected with --enable-targets, or if --enable-64-bit-bfd. */ | |
252b5132 | 80 | #define BFD_ARCH_SIZE @wordsize@ |
69263e90 AM |
81 | |
82 | /* The word size of the default bfd target. */ | |
83 | #define BFD_DEFAULT_TARGET_SIZE @bfd_default_target_size@ | |
84 | ||
252b5132 | 85 | #define BFD_HOST_64BIT_LONG @BFD_HOST_64BIT_LONG@ |
d2df793a | 86 | #define BFD_HOST_64BIT_LONG_LONG @BFD_HOST_64BIT_LONG_LONG@ |
252b5132 RH |
87 | #if @BFD_HOST_64_BIT_DEFINED@ |
88 | #define BFD_HOST_64_BIT @BFD_HOST_64_BIT@ | |
89 | #define BFD_HOST_U_64_BIT @BFD_HOST_U_64_BIT@ | |
8ce8c090 AM |
90 | typedef BFD_HOST_64_BIT bfd_int64_t; |
91 | typedef BFD_HOST_U_64_BIT bfd_uint64_t; | |
252b5132 RH |
92 | #endif |
93 | ||
94 | #if BFD_ARCH_SIZE >= 64 | |
95 | #define BFD64 | |
96 | #endif | |
97 | ||
98 | #ifndef INLINE | |
99 | #if __GNUC__ >= 2 | |
100 | #define INLINE __inline__ | |
101 | #else | |
102 | #define INLINE | |
103 | #endif | |
104 | #endif | |
105 | ||
d2df793a NC |
106 | /* Declaring a type wide enough to hold a host long and a host pointer. */ |
107 | #define BFD_HOSTPTR_T @BFD_HOSTPTR_T@ | |
108 | typedef BFD_HOSTPTR_T bfd_hostptr_t; | |
109 | ||
b5f79c76 | 110 | /* Forward declaration. */ |
c2852e88 | 111 | typedef struct bfd bfd; |
252b5132 | 112 | |
b34976b6 AM |
113 | /* Boolean type used in bfd. Too many systems define their own |
114 | versions of "boolean" for us to safely typedef a "boolean" of | |
cf3d882d | 115 | our own. Using an enum for "bfd_boolean" has its own set of |
b34976b6 AM |
116 | problems, with strange looking casts required to avoid warnings |
117 | on some older compilers. Thus we just use an int. | |
118 | ||
cf3d882d | 119 | General rule: Functions which are bfd_boolean return TRUE on |
b34976b6 AM |
120 | success and FALSE on failure (unless they're a predicate). */ |
121 | ||
122 | typedef int bfd_boolean; | |
123 | #undef FALSE | |
124 | #undef TRUE | |
125 | #define FALSE 0 | |
126 | #define TRUE 1 | |
127 | ||
252b5132 RH |
128 | #ifdef BFD64 |
129 | ||
130 | #ifndef BFD_HOST_64_BIT | |
131 | #error No 64 bit integer type available | |
132 | #endif /* ! defined (BFD_HOST_64_BIT) */ | |
133 | ||
134 | typedef BFD_HOST_U_64_BIT bfd_vma; | |
135 | typedef BFD_HOST_64_BIT bfd_signed_vma; | |
136 | typedef BFD_HOST_U_64_BIT bfd_size_type; | |
137 | typedef BFD_HOST_U_64_BIT symvalue; | |
138 | ||
252b5132 | 139 | #if BFD_HOST_64BIT_LONG |
14a91970 AM |
140 | #define BFD_VMA_FMT "l" |
141 | #elif defined (__MSVCRT__) | |
142 | #define BFD_VMA_FMT "I64" | |
6e3d6dc1 | 143 | #else |
14a91970 | 144 | #define BFD_VMA_FMT "ll" |
252b5132 | 145 | #endif |
14a91970 AM |
146 | |
147 | #ifndef fprintf_vma | |
148 | #define sprintf_vma(s,x) sprintf (s, "%016" BFD_VMA_FMT "x", x) | |
149 | #define fprintf_vma(f,x) fprintf (f, "%016" BFD_VMA_FMT "x", x) | |
252b5132 RH |
150 | #endif |
151 | ||
152 | #else /* not BFD64 */ | |
153 | ||
154 | /* Represent a target address. Also used as a generic unsigned type | |
155 | which is guaranteed to be big enough to hold any arithmetic types | |
156 | we need to deal with. */ | |
157 | typedef unsigned long bfd_vma; | |
158 | ||
159 | /* A generic signed type which is guaranteed to be big enough to hold any | |
160 | arithmetic types we need to deal with. Can be assumed to be compatible | |
161 | with bfd_vma in the same way that signed and unsigned ints are compatible | |
162 | (as parameters, in assignment, etc). */ | |
163 | typedef long bfd_signed_vma; | |
164 | ||
165 | typedef unsigned long symvalue; | |
166 | typedef unsigned long bfd_size_type; | |
167 | ||
168 | /* Print a bfd_vma x on stream s. */ | |
14a91970 AM |
169 | #define BFD_VMA_FMT "l" |
170 | #define fprintf_vma(s,x) fprintf (s, "%08" BFD_VMA_FMT "x", x) | |
171 | #define sprintf_vma(s,x) sprintf (s, "%08" BFD_VMA_FMT "x", x) | |
252b5132 RH |
172 | |
173 | #endif /* not BFD64 */ | |
174 | ||
d0fb9a8d JJ |
175 | #define HALF_BFD_SIZE_TYPE \ |
176 | (((bfd_size_type) 1) << (8 * sizeof (bfd_size_type) / 2)) | |
177 | ||
8ce8c090 AM |
178 | #ifndef BFD_HOST_64_BIT |
179 | /* Fall back on a 32 bit type. The idea is to make these types always | |
180 | available for function return types, but in the case that | |
181 | BFD_HOST_64_BIT is undefined such a function should abort or | |
182 | otherwise signal an error. */ | |
183 | typedef bfd_signed_vma bfd_int64_t; | |
184 | typedef bfd_vma bfd_uint64_t; | |
185 | #endif | |
186 | ||
d7ce59e3 AC |
187 | /* An offset into a file. BFD always uses the largest possible offset |
188 | based on the build time availability of fseek, fseeko, or fseeko64. */ | |
189 | typedef @bfd_file_ptr@ file_ptr; | |
190 | typedef unsigned @bfd_file_ptr@ ufile_ptr; | |
dc810e39 | 191 | |
c58b9523 AM |
192 | extern void bfd_sprintf_vma (bfd *, char *, bfd_vma); |
193 | extern void bfd_fprintf_vma (bfd *, void *, bfd_vma); | |
ae4221d7 | 194 | |
252b5132 | 195 | #define printf_vma(x) fprintf_vma(stdout,x) |
ae4221d7 | 196 | #define bfd_printf_vma(abfd,x) bfd_fprintf_vma (abfd,stdout,x) |
252b5132 RH |
197 | |
198 | typedef unsigned int flagword; /* 32 bits of flags */ | |
199 | typedef unsigned char bfd_byte; | |
200 | \f | |
b5f79c76 | 201 | /* File formats. */ |
252b5132 | 202 | |
b5f79c76 NC |
203 | typedef enum bfd_format |
204 | { | |
205 | bfd_unknown = 0, /* File format is unknown. */ | |
5c4491d3 | 206 | bfd_object, /* Linker/assembler/compiler output. */ |
b5f79c76 NC |
207 | bfd_archive, /* Object archive file. */ |
208 | bfd_core, /* Core dump. */ | |
209 | bfd_type_end /* Marks the end; don't use it! */ | |
210 | } | |
211 | bfd_format; | |
252b5132 | 212 | \f |
b5f79c76 | 213 | /* Symbols and relocation. */ |
252b5132 RH |
214 | |
215 | /* A count of carsyms (canonical archive symbols). */ | |
216 | typedef unsigned long symindex; | |
217 | ||
218 | /* How to perform a relocation. */ | |
219 | typedef const struct reloc_howto_struct reloc_howto_type; | |
220 | ||
221 | #define BFD_NO_MORE_SYMBOLS ((symindex) ~0) | |
222 | ||
223 | /* General purpose part of a symbol X; | |
224 | target specific parts are in libcoff.h, libaout.h, etc. */ | |
225 | ||
226 | #define bfd_get_section(x) ((x)->section) | |
227 | #define bfd_get_output_section(x) ((x)->section->output_section) | |
228 | #define bfd_set_section(x,y) ((x)->section) = (y) | |
229 | #define bfd_asymbol_base(x) ((x)->section->vma) | |
230 | #define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value) | |
231 | #define bfd_asymbol_name(x) ((x)->name) | |
232 | /*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/ | |
233 | #define bfd_asymbol_bfd(x) ((x)->the_bfd) | |
6ba2a415 RS |
234 | #define bfd_asymbol_flavour(x) \ |
235 | (((x)->flags & BSF_SYNTHETIC) != 0 \ | |
236 | ? bfd_target_unknown_flavour \ | |
237 | : bfd_asymbol_bfd (x)->xvec->flavour) | |
252b5132 RH |
238 | |
239 | /* A canonical archive symbol. */ | |
b5f79c76 NC |
240 | /* This is a type pun with struct ranlib on purpose! */ |
241 | typedef struct carsym | |
242 | { | |
252b5132 | 243 | 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 NC |
249 | Perhaps just a forward definition would do? */ |
250 | struct orl /* Output ranlib. */ | |
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 RH |
259 | }; |
260 | \f | |
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. */ |
b5f79c76 | 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. */ |
252b5132 RH |
274 | |
275 | #define align_power(addr, align) \ | |
e5b45b83 | 276 | (((addr) + ((bfd_vma) 1 << (align)) - 1) & ((bfd_vma) -1 << (align))) |
252b5132 | 277 | |
198beae2 | 278 | typedef struct bfd_section *sec_ptr; |
252b5132 | 279 | |
a0f49396 NC |
280 | #define bfd_get_section_name(bfd, ptr) ((void) bfd, (ptr)->name) |
281 | #define bfd_get_section_vma(bfd, ptr) ((void) bfd, (ptr)->vma) | |
282 | #define bfd_get_section_lma(bfd, ptr) ((void) bfd, (ptr)->lma) | |
283 | #define bfd_get_section_alignment(bfd, ptr) ((void) bfd, \ | |
284 | (ptr)->alignment_power) | |
252b5132 | 285 | #define bfd_section_name(bfd, ptr) ((ptr)->name) |
eea6121a AM |
286 | #define bfd_section_size(bfd, ptr) ((ptr)->size) |
287 | #define bfd_get_section_size(ptr) ((ptr)->size) | |
252b5132 RH |
288 | #define bfd_section_vma(bfd, ptr) ((ptr)->vma) |
289 | #define bfd_section_lma(bfd, ptr) ((ptr)->lma) | |
290 | #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power) | |
a0f49396 NC |
291 | #define bfd_get_section_flags(bfd, ptr) ((void) bfd, (ptr)->flags) |
292 | #define bfd_get_section_userdata(bfd, ptr) ((void) bfd, (ptr)->userdata) | |
252b5132 RH |
293 | |
294 | #define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0) | |
295 | ||
b34976b6 AM |
296 | #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma = (val)), ((ptr)->user_set_vma = TRUE), TRUE) |
297 | #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),TRUE) | |
298 | #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),TRUE) | |
07515404 AM |
299 | /* Find the address one past the end of SEC. */ |
300 | #define bfd_get_section_limit(bfd, sec) \ | |
e57278ef AM |
301 | (((bfd)->direction != write_direction && (sec)->rawsize != 0 \ |
302 | ? (sec)->rawsize : (sec)->size) / bfd_octets_per_byte (bfd)) | |
252b5132 | 303 | |
ddfd6795 | 304 | /* Return TRUE if input section SEC has been discarded. */ |
dbaa2011 | 305 | #define discarded_section(sec) \ |
ab96bf03 AM |
306 | (!bfd_is_abs_section (sec) \ |
307 | && bfd_is_abs_section ((sec)->output_section) \ | |
dbaa2011 AM |
308 | && (sec)->sec_info_type != SEC_INFO_TYPE_MERGE \ |
309 | && (sec)->sec_info_type != SEC_INFO_TYPE_JUST_SYMS) | |
252b5132 RH |
310 | \f |
311 | typedef enum bfd_print_symbol | |
60bcf0fa | 312 | { |
252b5132 RH |
313 | bfd_print_symbol_name, |
314 | bfd_print_symbol_more, | |
315 | bfd_print_symbol_all | |
316 | } bfd_print_symbol_type; | |
60bcf0fa | 317 | |
252b5132 RH |
318 | /* Information about a symbol that nm needs. */ |
319 | ||
320 | typedef struct _symbol_info | |
321 | { | |
322 | symvalue value; | |
323 | char type; | |
dc810e39 | 324 | const char *name; /* Symbol name. */ |
252b5132 | 325 | unsigned char stab_type; /* Stab type. */ |
8546af74 | 326 | char stab_other; /* Stab other. */ |
252b5132 | 327 | short stab_desc; /* Stab desc. */ |
dc810e39 | 328 | const char *stab_name; /* String for stab type. */ |
252b5132 RH |
329 | } symbol_info; |
330 | ||
331 | /* Get the name of a stabs type code. */ | |
332 | ||
c58b9523 | 333 | extern const char *bfd_get_stab_name (int); |
252b5132 RH |
334 | \f |
335 | /* Hash table routines. There is no way to free up a hash table. */ | |
336 | ||
337 | /* An element in the hash table. Most uses will actually use a larger | |
338 | structure, and an instance of this will be the first field. */ | |
339 | ||
340 | struct bfd_hash_entry | |
341 | { | |
342 | /* Next entry for this hash code. */ | |
343 | struct bfd_hash_entry *next; | |
344 | /* String being hashed. */ | |
345 | const char *string; | |
346 | /* Hash code. This is the full hash code, not the index into the | |
347 | table. */ | |
348 | unsigned long hash; | |
349 | }; | |
350 | ||
351 | /* A hash table. */ | |
352 | ||
353 | struct bfd_hash_table | |
354 | { | |
355 | /* The hash array. */ | |
356 | struct bfd_hash_entry **table; | |
252b5132 RH |
357 | /* A function used to create new elements in the hash table. The |
358 | first entry is itself a pointer to an element. When this | |
359 | function is first invoked, this pointer will be NULL. However, | |
360 | having the pointer permits a hierarchy of method functions to be | |
361 | built each of which calls the function in the superclass. Thus | |
362 | each function should be written to allocate a new block of memory | |
363 | only if the argument is NULL. */ | |
b34976b6 | 364 | struct bfd_hash_entry *(*newfunc) |
c58b9523 | 365 | (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); |
252b5132 | 366 | /* An objalloc for this hash table. This is a struct objalloc *, |
c58b9523 AM |
367 | but we use void * to avoid requiring the inclusion of objalloc.h. */ |
368 | void *memory; | |
98f0b6ab AM |
369 | /* The number of slots in the hash table. */ |
370 | unsigned int size; | |
371 | /* The number of entries in the hash table. */ | |
372 | unsigned int count; | |
373 | /* The size of elements. */ | |
374 | unsigned int entsize; | |
375 | /* If non-zero, don't grow the hash table. */ | |
376 | unsigned int frozen:1; | |
252b5132 RH |
377 | }; |
378 | ||
379 | /* Initialize a hash table. */ | |
b34976b6 | 380 | extern bfd_boolean bfd_hash_table_init |
c58b9523 AM |
381 | (struct bfd_hash_table *, |
382 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, | |
383 | struct bfd_hash_table *, | |
66eb6687 AM |
384 | const char *), |
385 | unsigned int); | |
252b5132 RH |
386 | |
387 | /* Initialize a hash table specifying a size. */ | |
b34976b6 | 388 | extern bfd_boolean bfd_hash_table_init_n |
c58b9523 AM |
389 | (struct bfd_hash_table *, |
390 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, | |
391 | struct bfd_hash_table *, | |
392 | const char *), | |
66eb6687 | 393 | unsigned int, unsigned int); |
252b5132 RH |
394 | |
395 | /* Free up a hash table. */ | |
b34976b6 | 396 | extern void bfd_hash_table_free |
c58b9523 | 397 | (struct bfd_hash_table *); |
252b5132 | 398 | |
b34976b6 | 399 | /* Look up a string in a hash table. If CREATE is TRUE, a new entry |
252b5132 | 400 | will be created for this string if one does not already exist. The |
b34976b6 | 401 | COPY argument must be TRUE if this routine should copy the string |
252b5132 RH |
402 | into newly allocated memory when adding an entry. */ |
403 | extern struct bfd_hash_entry *bfd_hash_lookup | |
c58b9523 AM |
404 | (struct bfd_hash_table *, const char *, bfd_boolean create, |
405 | bfd_boolean copy); | |
252b5132 | 406 | |
a69898aa AM |
407 | /* Insert an entry in a hash table. */ |
408 | extern struct bfd_hash_entry *bfd_hash_insert | |
409 | (struct bfd_hash_table *, const char *, unsigned long); | |
410 | ||
4e011fb5 AM |
411 | /* Rename an entry in a hash table. */ |
412 | extern void bfd_hash_rename | |
413 | (struct bfd_hash_table *, const char *, struct bfd_hash_entry *); | |
414 | ||
252b5132 RH |
415 | /* Replace an entry in a hash table. */ |
416 | extern void bfd_hash_replace | |
c58b9523 AM |
417 | (struct bfd_hash_table *, struct bfd_hash_entry *old, |
418 | struct bfd_hash_entry *nw); | |
252b5132 RH |
419 | |
420 | /* Base method for creating a hash table entry. */ | |
421 | extern struct bfd_hash_entry *bfd_hash_newfunc | |
c58b9523 | 422 | (struct bfd_hash_entry *, struct bfd_hash_table *, const char *); |
252b5132 RH |
423 | |
424 | /* Grab some space for a hash table entry. */ | |
c58b9523 AM |
425 | extern void *bfd_hash_allocate |
426 | (struct bfd_hash_table *, unsigned int); | |
252b5132 RH |
427 | |
428 | /* Traverse a hash table in a random order, calling a function on each | |
b34976b6 | 429 | element. If the function returns FALSE, the traversal stops. The |
252b5132 | 430 | INFO argument is passed to the function. */ |
b34976b6 | 431 | extern void bfd_hash_traverse |
c58b9523 AM |
432 | (struct bfd_hash_table *, |
433 | bfd_boolean (*) (struct bfd_hash_entry *, void *), | |
434 | void *info); | |
252b5132 | 435 | |
2d643429 NC |
436 | /* Allows the default size of a hash table to be configured. New hash |
437 | tables allocated using bfd_hash_table_init will be created with | |
438 | this size. */ | |
8ad17b3a | 439 | extern unsigned long bfd_hash_set_default_size (unsigned long); |
2d643429 | 440 | |
3722b82f AM |
441 | /* This structure is used to keep track of stabs in sections |
442 | information while linking. */ | |
443 | ||
444 | struct stab_info | |
445 | { | |
446 | /* A hash table used to hold stabs strings. */ | |
447 | struct bfd_strtab_hash *strings; | |
448 | /* The header file hash table. */ | |
449 | struct bfd_hash_table includes; | |
450 | /* The first .stabstr section. */ | |
451 | struct bfd_section *stabstr; | |
452 | }; | |
453 | ||
c58b9523 | 454 | #define COFF_SWAP_TABLE (void *) &bfd_coff_std_swap_table |
e43d48cc | 455 | |
b5f79c76 | 456 | /* User program access to BFD facilities. */ |
252b5132 RH |
457 | |
458 | /* Direct I/O routines, for programs which know more about the object | |
459 | file than BFD does. Use higher level routines if possible. */ | |
460 | ||
c58b9523 AM |
461 | extern bfd_size_type bfd_bread (void *, bfd_size_type, bfd *); |
462 | extern bfd_size_type bfd_bwrite (const void *, bfd_size_type, bfd *); | |
463 | extern int bfd_seek (bfd *, file_ptr, int); | |
7c192733 | 464 | extern file_ptr bfd_tell (bfd *); |
c58b9523 AM |
465 | extern int bfd_flush (bfd *); |
466 | extern int bfd_stat (bfd *, struct stat *); | |
dc810e39 AM |
467 | |
468 | /* Deprecated old routines. */ | |
469 | #if __GNUC__ | |
470 | #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD) \ | |
471 | (warn_deprecated ("bfd_read", __FILE__, __LINE__, __FUNCTION__), \ | |
472 | bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) | |
473 | #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD) \ | |
474 | (warn_deprecated ("bfd_write", __FILE__, __LINE__, __FUNCTION__), \ | |
475 | bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) | |
476 | #else | |
477 | #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD) \ | |
478 | (warn_deprecated ("bfd_read", (const char *) 0, 0, (const char *) 0), \ | |
479 | bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) | |
480 | #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD) \ | |
481 | (warn_deprecated ("bfd_write", (const char *) 0, 0, (const char *) 0),\ | |
482 | bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD))) | |
483 | #endif | |
c58b9523 | 484 | extern void warn_deprecated (const char *, const char *, int, const char *); |
252b5132 | 485 | |
252b5132 RH |
486 | /* Cast from const char * to char * so that caller can assign to |
487 | a char * without a warning. */ | |
488 | #define bfd_get_filename(abfd) ((char *) (abfd)->filename) | |
489 | #define bfd_get_cacheable(abfd) ((abfd)->cacheable) | |
490 | #define bfd_get_format(abfd) ((abfd)->format) | |
491 | #define bfd_get_target(abfd) ((abfd)->xvec->name) | |
492 | #define bfd_get_flavour(abfd) ((abfd)->xvec->flavour) | |
9bd09e22 ND |
493 | #define bfd_family_coff(abfd) \ |
494 | (bfd_get_flavour (abfd) == bfd_target_coff_flavour || \ | |
495 | bfd_get_flavour (abfd) == bfd_target_xcoff_flavour) | |
252b5132 RH |
496 | #define bfd_big_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_BIG) |
497 | #define bfd_little_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_LITTLE) | |
498 | #define bfd_header_big_endian(abfd) \ | |
499 | ((abfd)->xvec->header_byteorder == BFD_ENDIAN_BIG) | |
500 | #define bfd_header_little_endian(abfd) \ | |
501 | ((abfd)->xvec->header_byteorder == BFD_ENDIAN_LITTLE) | |
502 | #define bfd_get_file_flags(abfd) ((abfd)->flags) | |
503 | #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags) | |
504 | #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags) | |
505 | #define bfd_my_archive(abfd) ((abfd)->my_archive) | |
506 | #define bfd_has_map(abfd) ((abfd)->has_armap) | |
a8da6403 | 507 | #define bfd_is_thin_archive(abfd) ((abfd)->is_thin_archive) |
252b5132 RH |
508 | |
509 | #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types) | |
510 | #define bfd_usrdata(abfd) ((abfd)->usrdata) | |
511 | ||
512 | #define bfd_get_start_address(abfd) ((abfd)->start_address) | |
513 | #define bfd_get_symcount(abfd) ((abfd)->symcount) | |
514 | #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols) | |
515 | #define bfd_count_sections(abfd) ((abfd)->section_count) | |
516 | ||
1f70368c DJ |
517 | #define bfd_get_dynamic_symcount(abfd) ((abfd)->dynsymcount) |
518 | ||
252b5132 RH |
519 | #define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char) |
520 | ||
b34976b6 | 521 | #define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = bool), TRUE) |
252b5132 | 522 | |
b34976b6 | 523 | extern bfd_boolean bfd_cache_close |
c58b9523 | 524 | (bfd *abfd); |
d436a9b3 FCE |
525 | /* NB: This declaration should match the autogenerated one in libbfd.h. */ |
526 | ||
02d5a37b JG |
527 | extern bfd_boolean bfd_cache_close_all (void); |
528 | ||
b34976b6 | 529 | extern bfd_boolean bfd_record_phdr |
c58b9523 | 530 | (bfd *, unsigned long, bfd_boolean, flagword, bfd_boolean, bfd_vma, |
198beae2 | 531 | bfd_boolean, bfd_boolean, unsigned int, struct bfd_section **); |
252b5132 RH |
532 | |
533 | /* Byte swapping routines. */ | |
534 | ||
8ce8c090 AM |
535 | bfd_uint64_t bfd_getb64 (const void *); |
536 | bfd_uint64_t bfd_getl64 (const void *); | |
537 | bfd_int64_t bfd_getb_signed_64 (const void *); | |
538 | bfd_int64_t bfd_getl_signed_64 (const void *); | |
edeb6e24 AM |
539 | bfd_vma bfd_getb32 (const void *); |
540 | bfd_vma bfd_getl32 (const void *); | |
541 | bfd_signed_vma bfd_getb_signed_32 (const void *); | |
542 | bfd_signed_vma bfd_getl_signed_32 (const void *); | |
543 | bfd_vma bfd_getb16 (const void *); | |
544 | bfd_vma bfd_getl16 (const void *); | |
545 | bfd_signed_vma bfd_getb_signed_16 (const void *); | |
546 | bfd_signed_vma bfd_getl_signed_16 (const void *); | |
8ce8c090 AM |
547 | void bfd_putb64 (bfd_uint64_t, void *); |
548 | void bfd_putl64 (bfd_uint64_t, void *); | |
edeb6e24 AM |
549 | void bfd_putb32 (bfd_vma, void *); |
550 | void bfd_putl32 (bfd_vma, void *); | |
551 | void bfd_putb16 (bfd_vma, void *); | |
552 | void bfd_putl16 (bfd_vma, void *); | |
8c603c85 NC |
553 | |
554 | /* Byte swapping routines which take size and endiannes as arguments. */ | |
555 | ||
8ce8c090 AM |
556 | bfd_uint64_t bfd_get_bits (const void *, int, bfd_boolean); |
557 | void bfd_put_bits (bfd_uint64_t, void *, int, bfd_boolean); | |
082b7297 | 558 | |
252b5132 RH |
559 | #if defined(__STDC__) || defined(ALMOST_STDC) |
560 | struct ecoff_debug_info; | |
561 | struct ecoff_debug_swap; | |
562 | struct ecoff_extr; | |
fc0a2244 | 563 | struct bfd_symbol; |
252b5132 RH |
564 | struct bfd_link_info; |
565 | struct bfd_link_hash_entry; | |
c77ec726 | 566 | struct bfd_section_already_linked; |
252b5132 RH |
567 | struct bfd_elf_version_tree; |
568 | #endif | |
c77ec726 AM |
569 | |
570 | extern bfd_boolean bfd_section_already_linked_table_init (void); | |
571 | extern void bfd_section_already_linked_table_free (void); | |
572 | extern bfd_boolean _bfd_handle_already_linked | |
573 | (struct bfd_section *, struct bfd_section_already_linked *, | |
574 | struct bfd_link_info *); | |
575 | \f | |
576 | /* Externally visible ECOFF routines. */ | |
577 | ||
b34976b6 | 578 | extern bfd_vma bfd_ecoff_get_gp_value |
c58b9523 | 579 | (bfd * abfd); |
b34976b6 | 580 | extern bfd_boolean bfd_ecoff_set_gp_value |
c58b9523 | 581 | (bfd *abfd, bfd_vma gp_value); |
b34976b6 | 582 | extern bfd_boolean bfd_ecoff_set_regmasks |
c58b9523 AM |
583 | (bfd *abfd, unsigned long gprmask, unsigned long fprmask, |
584 | unsigned long *cprmask); | |
585 | extern void *bfd_ecoff_debug_init | |
586 | (bfd *output_bfd, struct ecoff_debug_info *output_debug, | |
587 | const struct ecoff_debug_swap *output_swap, struct bfd_link_info *); | |
252b5132 | 588 | extern void bfd_ecoff_debug_free |
c58b9523 AM |
589 | (void *handle, bfd *output_bfd, struct ecoff_debug_info *output_debug, |
590 | const struct ecoff_debug_swap *output_swap, struct bfd_link_info *); | |
b34976b6 | 591 | extern bfd_boolean bfd_ecoff_debug_accumulate |
c58b9523 AM |
592 | (void *handle, bfd *output_bfd, struct ecoff_debug_info *output_debug, |
593 | const struct ecoff_debug_swap *output_swap, bfd *input_bfd, | |
594 | struct ecoff_debug_info *input_debug, | |
595 | const struct ecoff_debug_swap *input_swap, struct bfd_link_info *); | |
b34976b6 | 596 | extern bfd_boolean bfd_ecoff_debug_accumulate_other |
c58b9523 AM |
597 | (void *handle, bfd *output_bfd, struct ecoff_debug_info *output_debug, |
598 | const struct ecoff_debug_swap *output_swap, bfd *input_bfd, | |
599 | struct bfd_link_info *); | |
b34976b6 | 600 | extern bfd_boolean bfd_ecoff_debug_externals |
c58b9523 AM |
601 | (bfd *abfd, struct ecoff_debug_info *debug, |
602 | const struct ecoff_debug_swap *swap, bfd_boolean relocatable, | |
fc0a2244 AC |
603 | bfd_boolean (*get_extr) (struct bfd_symbol *, struct ecoff_extr *), |
604 | void (*set_index) (struct bfd_symbol *, bfd_size_type)); | |
b34976b6 | 605 | extern bfd_boolean bfd_ecoff_debug_one_external |
c58b9523 AM |
606 | (bfd *abfd, struct ecoff_debug_info *debug, |
607 | const struct ecoff_debug_swap *swap, const char *name, | |
608 | struct ecoff_extr *esym); | |
252b5132 | 609 | extern bfd_size_type bfd_ecoff_debug_size |
c58b9523 AM |
610 | (bfd *abfd, struct ecoff_debug_info *debug, |
611 | const struct ecoff_debug_swap *swap); | |
b34976b6 | 612 | extern bfd_boolean bfd_ecoff_write_debug |
c58b9523 AM |
613 | (bfd *abfd, struct ecoff_debug_info *debug, |
614 | const struct ecoff_debug_swap *swap, file_ptr where); | |
b34976b6 | 615 | extern bfd_boolean bfd_ecoff_write_accumulated_debug |
c58b9523 AM |
616 | (void *handle, bfd *abfd, struct ecoff_debug_info *debug, |
617 | const struct ecoff_debug_swap *swap, | |
618 | struct bfd_link_info *info, file_ptr where); | |
252b5132 RH |
619 | |
620 | /* Externally visible ELF routines. */ | |
621 | ||
622 | struct bfd_link_needed_list | |
623 | { | |
624 | struct bfd_link_needed_list *next; | |
625 | bfd *by; | |
626 | const char *name; | |
627 | }; | |
628 | ||
4a43e768 AM |
629 | enum dynamic_lib_link_class { |
630 | DYN_NORMAL = 0, | |
631 | DYN_AS_NEEDED = 1, | |
e56f61be L |
632 | DYN_DT_NEEDED = 2, |
633 | DYN_NO_ADD_NEEDED = 4, | |
634 | DYN_NO_NEEDED = 8 | |
4a43e768 AM |
635 | }; |
636 | ||
5061a885 AM |
637 | enum notice_asneeded_action { |
638 | notice_as_needed, | |
639 | notice_not_needed, | |
640 | notice_needed | |
641 | }; | |
642 | ||
45d6a902 | 643 | extern bfd_boolean bfd_elf_record_link_assignment |
fe21a8fc L |
644 | (bfd *, struct bfd_link_info *, const char *, bfd_boolean, |
645 | bfd_boolean); | |
252b5132 | 646 | extern struct bfd_link_needed_list *bfd_elf_get_needed_list |
c58b9523 | 647 | (bfd *, struct bfd_link_info *); |
b34976b6 | 648 | extern bfd_boolean bfd_elf_get_bfd_needed_list |
c58b9523 | 649 | (bfd *, struct bfd_link_needed_list **); |
11c251f4 | 650 | extern bfd_boolean bfd_elf_size_dynamic_sections |
7ee314fa | 651 | (bfd *, const char *, const char *, const char *, const char *, const char *, |
fd91d419 | 652 | const char * const *, struct bfd_link_info *, struct bfd_section **); |
8423293d AM |
653 | extern bfd_boolean bfd_elf_size_dynsym_hash_dynstr |
654 | (bfd *, struct bfd_link_info *); | |
b34976b6 | 655 | extern void bfd_elf_set_dt_needed_name |
c58b9523 | 656 | (bfd *, const char *); |
b34976b6 | 657 | extern const char *bfd_elf_get_dt_soname |
c58b9523 | 658 | (bfd *); |
4a43e768 | 659 | extern void bfd_elf_set_dyn_lib_class |
23fe9577 | 660 | (bfd *, enum dynamic_lib_link_class); |
e56f61be L |
661 | extern int bfd_elf_get_dyn_lib_class |
662 | (bfd *); | |
a963dc6a | 663 | extern struct bfd_link_needed_list *bfd_elf_get_runpath_list |
c58b9523 | 664 | (bfd *, struct bfd_link_info *); |
c152c796 | 665 | extern bfd_boolean bfd_elf_discard_info |
c58b9523 | 666 | (bfd *, struct bfd_link_info *); |
8a696751 AM |
667 | extern unsigned int _bfd_elf_default_action_discarded |
668 | (struct bfd_section *); | |
252b5132 | 669 | |
7f8d5fc9 ILT |
670 | /* Return an upper bound on the number of bytes required to store a |
671 | copy of ABFD's program header table entries. Return -1 if an error | |
672 | occurs; bfd_get_error will return an appropriate code. */ | |
b34976b6 | 673 | extern long bfd_get_elf_phdr_upper_bound |
c58b9523 | 674 | (bfd *abfd); |
7f8d5fc9 ILT |
675 | |
676 | /* Copy ABFD's program header table entries to *PHDRS. The entries | |
677 | will be stored as an array of Elf_Internal_Phdr structures, as | |
678 | defined in include/elf/internal.h. To find out how large the | |
679 | buffer needs to be, call bfd_get_elf_phdr_upper_bound. | |
680 | ||
681 | Return the number of program header table entries read, or -1 if an | |
682 | error occurs; bfd_get_error will return an appropriate code. */ | |
b34976b6 | 683 | extern int bfd_get_elf_phdrs |
c58b9523 | 684 | (bfd *abfd, void *phdrs); |
7f8d5fc9 | 685 | |
8d6337fe RM |
686 | /* Create a new BFD as if by bfd_openr. Rather than opening a file, |
687 | reconstruct an ELF file by reading the segments out of remote memory | |
688 | based on the ELF file header at EHDR_VMA and the ELF program headers it | |
689 | points to. If not null, *LOADBASEP is filled in with the difference | |
690 | between the VMAs from which the segments were read, and the VMAs the | |
691 | file headers (and hence BFD's idea of each section's VMA) put them at. | |
692 | ||
693 | The function TARGET_READ_MEMORY is called to copy LEN bytes from the | |
694 | remote memory at target address VMA into the local buffer at MYADDR; it | |
695 | should return zero on success or an `errno' code on failure. TEMPL must | |
696 | be a BFD for an ELF target with the word size and byte order found in | |
697 | the remote memory. */ | |
698 | extern bfd *bfd_elf_bfd_from_remote_memory | |
c58b9523 | 699 | (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep, |
f075ee0c | 700 | int (*target_read_memory) (bfd_vma vma, bfd_byte *myaddr, int len)); |
8d6337fe | 701 | |
e1918d23 AM |
702 | extern struct bfd_section *_bfd_elf_tls_setup |
703 | (bfd *, struct bfd_link_info *); | |
704 | ||
051d833a AM |
705 | extern struct bfd_section * |
706 | _bfd_nearby_section (bfd *, struct bfd_section *, bfd_vma); | |
707 | ||
1e035701 | 708 | extern void _bfd_fix_excluded_sec_syms |
a3c2b96a | 709 | (bfd *, struct bfd_link_info *); |
f652615e | 710 | |
266abb8f NS |
711 | extern unsigned bfd_m68k_mach_to_features (int); |
712 | ||
713 | extern int bfd_m68k_features_to_mach (unsigned); | |
714 | ||
b34976b6 | 715 | extern bfd_boolean bfd_m68k_elf32_create_embedded_relocs |
a3c2b96a AM |
716 | (bfd *, struct bfd_link_info *, struct bfd_section *, struct bfd_section *, |
717 | char **); | |
0752970e | 718 | |
7fb9f789 NC |
719 | extern void bfd_elf_m68k_set_target_options (struct bfd_link_info *, int); |
720 | ||
0f64bb02 CM |
721 | extern bfd_boolean bfd_bfin_elf32_create_embedded_relocs |
722 | (bfd *, struct bfd_link_info *, struct bfd_section *, struct bfd_section *, | |
723 | char **); | |
724 | ||
99706f30 SR |
725 | extern bfd_boolean bfd_cr16_elf32_create_embedded_relocs |
726 | (bfd *, struct bfd_link_info *, struct bfd_section *, struct bfd_section *, | |
727 | char **); | |
728 | ||
252b5132 RH |
729 | /* SunOS shared library support routines for the linker. */ |
730 | ||
731 | extern struct bfd_link_needed_list *bfd_sunos_get_needed_list | |
c58b9523 | 732 | (bfd *, struct bfd_link_info *); |
b34976b6 | 733 | extern bfd_boolean bfd_sunos_record_link_assignment |
c58b9523 | 734 | (bfd *, struct bfd_link_info *, const char *); |
b34976b6 | 735 | extern bfd_boolean bfd_sunos_size_dynamic_sections |
a3c2b96a AM |
736 | (bfd *, struct bfd_link_info *, struct bfd_section **, |
737 | struct bfd_section **, struct bfd_section **); | |
252b5132 RH |
738 | |
739 | /* Linux shared library support routines for the linker. */ | |
740 | ||
b34976b6 | 741 | extern bfd_boolean bfd_i386linux_size_dynamic_sections |
c58b9523 | 742 | (bfd *, struct bfd_link_info *); |
b34976b6 | 743 | extern bfd_boolean bfd_m68klinux_size_dynamic_sections |
c58b9523 | 744 | (bfd *, struct bfd_link_info *); |
b34976b6 | 745 | extern bfd_boolean bfd_sparclinux_size_dynamic_sections |
c58b9523 | 746 | (bfd *, struct bfd_link_info *); |
252b5132 RH |
747 | |
748 | /* mmap hacks */ | |
749 | ||
750 | struct _bfd_window_internal; | |
751 | typedef struct _bfd_window_internal bfd_window_internal; | |
752 | ||
b5f79c76 NC |
753 | typedef struct _bfd_window |
754 | { | |
252b5132 | 755 | /* What the user asked for. */ |
c58b9523 | 756 | void *data; |
252b5132 RH |
757 | bfd_size_type size; |
758 | /* The actual window used by BFD. Small user-requested read-only | |
759 | regions sharing a page may share a single window into the object | |
760 | file. Read-write versions shouldn't until I've fixed things to | |
761 | keep track of which portions have been claimed by the | |
762 | application; don't want to give the same region back when the | |
763 | application wants two writable copies! */ | |
764 | struct _bfd_window_internal *i; | |
b5f79c76 NC |
765 | } |
766 | bfd_window; | |
252b5132 | 767 | |
b34976b6 | 768 | extern void bfd_init_window |
c58b9523 | 769 | (bfd_window *); |
b34976b6 | 770 | extern void bfd_free_window |
c58b9523 | 771 | (bfd_window *); |
b34976b6 | 772 | extern bfd_boolean bfd_get_file_window |
c58b9523 | 773 | (bfd *, file_ptr, bfd_size_type, bfd_window *, bfd_boolean); |
252b5132 RH |
774 | |
775 | /* XCOFF support routines for the linker. */ | |
776 | ||
24c611d1 RS |
777 | extern bfd_boolean bfd_xcoff_split_import_path |
778 | (bfd *, const char *, const char **, const char **); | |
779 | extern bfd_boolean bfd_xcoff_set_archive_import_path | |
780 | (struct bfd_link_info *, bfd *, const char *); | |
b34976b6 | 781 | extern bfd_boolean bfd_xcoff_link_record_set |
c58b9523 | 782 | (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *, bfd_size_type); |
b34976b6 | 783 | extern bfd_boolean bfd_xcoff_import_symbol |
c58b9523 AM |
784 | (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *, bfd_vma, |
785 | const char *, const char *, const char *, unsigned int); | |
b34976b6 | 786 | extern bfd_boolean bfd_xcoff_export_symbol |
c58b9523 | 787 | (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *); |
b34976b6 | 788 | extern bfd_boolean bfd_xcoff_link_count_reloc |
c58b9523 | 789 | (bfd *, struct bfd_link_info *, const char *); |
b34976b6 | 790 | extern bfd_boolean bfd_xcoff_record_link_assignment |
c58b9523 | 791 | (bfd *, struct bfd_link_info *, const char *); |
b34976b6 | 792 | extern bfd_boolean bfd_xcoff_size_dynamic_sections |
c58b9523 AM |
793 | (bfd *, struct bfd_link_info *, const char *, const char *, |
794 | unsigned long, unsigned long, unsigned long, bfd_boolean, | |
b64232cc | 795 | int, bfd_boolean, unsigned int, struct bfd_section **, bfd_boolean); |
b34976b6 | 796 | extern bfd_boolean bfd_xcoff_link_generate_rtinit |
c58b9523 | 797 | (bfd *, const char *, const char *, bfd_boolean); |
252b5132 | 798 | |
eb1e0e80 | 799 | /* XCOFF support routines for ar. */ |
b34976b6 | 800 | extern bfd_boolean bfd_xcoff_ar_archive_set_magic |
c58b9523 | 801 | (bfd *, char *); |
eb1e0e80 | 802 | |
252b5132 RH |
803 | /* Externally visible COFF routines. */ |
804 | ||
805 | #if defined(__STDC__) || defined(ALMOST_STDC) | |
806 | struct internal_syment; | |
807 | union internal_auxent; | |
808 | #endif | |
809 | ||
b34976b6 | 810 | extern bfd_boolean bfd_coff_get_syment |
fc0a2244 | 811 | (bfd *, struct bfd_symbol *, struct internal_syment *); |
252b5132 | 812 | |
b34976b6 | 813 | extern bfd_boolean bfd_coff_get_auxent |
fc0a2244 | 814 | (bfd *, struct bfd_symbol *, int, union internal_auxent *); |
252b5132 | 815 | |
b34976b6 | 816 | extern bfd_boolean bfd_coff_set_symbol_class |
fc0a2244 | 817 | (bfd *, struct bfd_symbol *, unsigned int); |
252b5132 | 818 | |
b34976b6 | 819 | extern bfd_boolean bfd_m68k_coff_create_embedded_relocs |
198beae2 | 820 | (bfd *, struct bfd_link_info *, struct bfd_section *, struct bfd_section *, char **); |
e702a51c | 821 | |
c7b8f16e JB |
822 | /* ARM VFP11 erratum workaround support. */ |
823 | typedef enum | |
824 | { | |
825 | BFD_ARM_VFP11_FIX_DEFAULT, | |
826 | BFD_ARM_VFP11_FIX_NONE, | |
827 | BFD_ARM_VFP11_FIX_SCALAR, | |
828 | BFD_ARM_VFP11_FIX_VECTOR | |
829 | } bfd_arm_vfp11_fix; | |
830 | ||
831 | extern void bfd_elf32_arm_init_maps | |
832 | (bfd *); | |
833 | ||
834 | extern void bfd_elf32_arm_set_vfp11_fix | |
835 | (bfd *, struct bfd_link_info *); | |
836 | ||
48229727 JB |
837 | extern void bfd_elf32_arm_set_cortex_a8_fix |
838 | (bfd *, struct bfd_link_info *); | |
839 | ||
c7b8f16e JB |
840 | extern bfd_boolean bfd_elf32_arm_vfp11_erratum_scan |
841 | (bfd *, struct bfd_link_info *); | |
842 | ||
843 | extern void bfd_elf32_arm_vfp11_fix_veneer_locations | |
844 | (bfd *, struct bfd_link_info *); | |
845 | ||
252b5132 | 846 | /* ARM Interworking support. Called from linker. */ |
b34976b6 | 847 | extern bfd_boolean bfd_arm_allocate_interworking_sections |
c58b9523 | 848 | (struct bfd_link_info *); |
252b5132 | 849 | |
b34976b6 | 850 | extern bfd_boolean bfd_arm_process_before_allocation |
c58b9523 | 851 | (bfd *, struct bfd_link_info *, int); |
252b5132 | 852 | |
b34976b6 | 853 | extern bfd_boolean bfd_arm_get_bfd_for_interworking |
c58b9523 | 854 | (bfd *, struct bfd_link_info *); |
252b5132 | 855 | |
86033394 | 856 | /* PE ARM Interworking support. Called from linker. */ |
b34976b6 | 857 | extern bfd_boolean bfd_arm_pe_allocate_interworking_sections |
c58b9523 | 858 | (struct bfd_link_info *); |
86033394 | 859 | |
b34976b6 | 860 | extern bfd_boolean bfd_arm_pe_process_before_allocation |
c58b9523 | 861 | (bfd *, struct bfd_link_info *, int); |
86033394 | 862 | |
b34976b6 | 863 | extern bfd_boolean bfd_arm_pe_get_bfd_for_interworking |
c58b9523 | 864 | (bfd *, struct bfd_link_info *); |
86033394 | 865 | |
252b5132 | 866 | /* ELF ARM Interworking support. Called from linker. */ |
b34976b6 | 867 | extern bfd_boolean bfd_elf32_arm_allocate_interworking_sections |
c58b9523 | 868 | (struct bfd_link_info *); |
67e5d3d6 | 869 | |
b34976b6 | 870 | extern bfd_boolean bfd_elf32_arm_process_before_allocation |
d504ffc8 | 871 | (bfd *, struct bfd_link_info *); |
eb043451 PB |
872 | |
873 | void bfd_elf32_arm_set_target_relocs | |
bf21ed78 | 874 | (bfd *, struct bfd_link_info *, int, char *, int, int, bfd_arm_vfp11_fix, |
2de70689 | 875 | int, int, int, int, int); |
67e5d3d6 | 876 | |
b34976b6 | 877 | extern bfd_boolean bfd_elf32_arm_get_bfd_for_interworking |
c58b9523 | 878 | (bfd *, struct bfd_link_info *); |
252b5132 | 879 | |
b34976b6 | 880 | extern bfd_boolean bfd_elf32_arm_add_glue_sections_to_bfd |
c58b9523 | 881 | (bfd *, struct bfd_link_info *); |
8afb0e02 | 882 | |
9d2da7ca | 883 | /* ELF ARM mapping symbol support */ |
b0796911 PB |
884 | #define BFD_ARM_SPECIAL_SYM_TYPE_MAP (1 << 0) |
885 | #define BFD_ARM_SPECIAL_SYM_TYPE_TAG (1 << 1) | |
886 | #define BFD_ARM_SPECIAL_SYM_TYPE_OTHER (1 << 2) | |
887 | #define BFD_ARM_SPECIAL_SYM_TYPE_ANY (~0) | |
888 | extern bfd_boolean bfd_is_arm_special_symbol_name | |
889 | (const char * name, int type); | |
9d2da7ca | 890 | |
d504ffc8 DJ |
891 | extern void bfd_elf32_arm_set_byteswap_code (struct bfd_link_info *, int); |
892 | ||
5a6c6817 NC |
893 | /* ARM Note section processing. */ |
894 | extern bfd_boolean bfd_arm_merge_machines | |
c58b9523 | 895 | (bfd *, bfd *); |
5a6c6817 NC |
896 | |
897 | extern bfd_boolean bfd_arm_update_notes | |
c58b9523 | 898 | (bfd *, const char *); |
5a6c6817 NC |
899 | |
900 | extern unsigned int bfd_arm_get_mach_from_notes | |
c58b9523 | 901 | (bfd *, const char *); |
5a6c6817 | 902 | |
906e58ca NC |
903 | /* ARM stub generation support. Called from the linker. */ |
904 | extern int elf32_arm_setup_section_lists | |
905 | (bfd *, struct bfd_link_info *); | |
906 | extern void elf32_arm_next_input_section | |
907 | (struct bfd_link_info *, struct bfd_section *); | |
908 | extern bfd_boolean elf32_arm_size_stubs | |
909 | (bfd *, bfd *, struct bfd_link_info *, bfd_signed_vma, | |
910 | struct bfd_section * (*) (const char *, struct bfd_section *), void (*) (void)); | |
911 | extern bfd_boolean elf32_arm_build_stubs | |
912 | (struct bfd_link_info *); | |
2468f9c9 PB |
913 | |
914 | /* ARM unwind section editing support. */ | |
915 | extern bfd_boolean elf32_arm_fix_exidx_coverage | |
85fdf906 | 916 | (struct bfd_section **, unsigned int, struct bfd_link_info *, bfd_boolean); |
2468f9c9 | 917 | |
fbd9ad90 PB |
918 | /* C6x unwind section editing support. */ |
919 | extern bfd_boolean elf32_tic6x_fix_exidx_coverage | |
920 | (struct bfd_section **, unsigned int, struct bfd_link_info *, bfd_boolean); | |
921 | ||
2d0f3896 AM |
922 | /* PowerPC @tls opcode transform/validate. */ |
923 | extern unsigned int _bfd_elf_ppc_at_tls_transform | |
924 | (unsigned int, unsigned int); | |
766bc656 AM |
925 | /* PowerPC @tprel opcode transform/validate. */ |
926 | extern unsigned int _bfd_elf_ppc_at_tprel_transform | |
927 | (unsigned int, unsigned int); | |
2d0f3896 | 928 | |
8546af74 | 929 | /* TI COFF load page support. */ |
b9af77f5 | 930 | extern void bfd_ticoff_set_section_load_page |
198beae2 | 931 | (struct bfd_section *, int); |
b9af77f5 TW |
932 | |
933 | extern int bfd_ticoff_get_section_load_page | |
198beae2 | 934 | (struct bfd_section *); |
a05758dd | 935 | |
7a9823f1 RS |
936 | /* H8/300 functions. */ |
937 | extern bfd_vma bfd_h8300_pad_address | |
938 | (bfd *, bfd_vma); | |
939 | ||
3f7deb8a L |
940 | /* IA64 Itanium code generation. Called from linker. */ |
941 | extern void bfd_elf32_ia64_after_parse | |
942 | (int); | |
943 | ||
944 | extern void bfd_elf64_ia64_after_parse | |
945 | (int); | |
946 | ||
082b7297 L |
947 | /* This structure is used for a comdat section, as in PE. A comdat |
948 | section is associated with a particular symbol. When the linker | |
949 | sees a comdat section, it keeps only one of the sections with a | |
950 | given name and associated with a given symbol. */ | |
951 | ||
952 | struct coff_comdat_info | |
953 | { | |
954 | /* The name of the symbol associated with a comdat section. */ | |
955 | const char *name; | |
956 | ||
957 | /* The local symbol table index of the symbol associated with a | |
958 | comdat section. This is only meaningful to the object file format | |
959 | specific code; it is not an index into the list returned by | |
960 | bfd_canonicalize_symtab. */ | |
961 | long symbol; | |
962 | }; | |
963 | ||
964 | extern struct coff_comdat_info *bfd_coff_get_comdat_section | |
965 | (bfd *, struct bfd_section *); | |
966 |