]>
Commit | Line | Data |
---|---|---|
00539ee3 | 1 | /* Main header file for the bfd library -- portable access to object files. |
3b1f83ad | 2 | Copyright 1990, 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc. |
63ffe5ef SC |
3 | Contributed by Cygnus Support. |
4 | ||
1fa5371e KR |
5 | ** NOTE: bfd.h and bfd-in2.h are GENERATED files. Don't change them; |
6 | ** instead, change bfd-in.h or the other BFD source files processed to | |
7 | ** generate these files. | |
8 | ||
63ffe5ef SC |
9 | This file is part of BFD, the Binary File Descriptor library. |
10 | ||
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 | |
13 | the Free Software Foundation; either version 2 of the License, or | |
14 | (at your option) any later version. | |
15 | ||
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. | |
20 | ||
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 | |
815179af | 23 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ |
63ffe5ef SC |
24 | |
25 | /* bfd.h -- The only header file required by users of the bfd library | |
26 | ||
00539ee3 JG |
27 | The bfd.h file is generated from bfd-in.h and various .c files; if you |
28 | change it, your changes will probably be lost. | |
63ffe5ef SC |
29 | |
30 | All the prototypes and definitions following the comment "THE FOLLOWING | |
31 | IS EXTRACTED FROM THE SOURCE" are extracted from the source files for | |
32 | BFD. If you change it, someone oneday will extract it from the source | |
33 | again, and your changes will be lost. To save yourself from this bind, | |
34 | change the definitions in the source in the bfd directory. Type "make | |
35 | docs" and then "make headers" in that directory, and magically this file | |
36 | will change to reflect your changes. | |
37 | ||
38 | If you don't have the tools to perform the extraction, then you are | |
39 | safe from someone on your system trampling over your header files. | |
40 | You should still maintain the equivalence between the source and this | |
41 | file though; every change you make to the .c file should be reflected | |
42 | here. */ | |
43 | ||
44 | #ifndef __BFD_H_SEEN__ | |
45 | #define __BFD_H_SEEN__ | |
46 | ||
815179af ILT |
47 | #ifdef __cplusplus |
48 | extern "C" { | |
49 | #endif | |
50 | ||
63ffe5ef SC |
51 | #include "ansidecl.h" |
52 | #include "obstack.h" | |
53 | ||
9deaaaf1 | 54 | /* These two lines get substitutions done by commands in Makefile.in. */ |
b7577823 | 55 | #define BFD_VERSION "@VERSION@" |
034a8a56 | 56 | #define BFD_ARCH_SIZE @WORDSIZE@ |
b7577823 | 57 | #define BFD_HOST_64BIT_LONG @BFD_HOST_64BIT_LONG@ |
034a8a56 KR |
58 | |
59 | #if BFD_ARCH_SIZE >= 64 | |
60 | #define BFD64 | |
61 | #endif | |
62 | ||
1fa5371e KR |
63 | #ifndef INLINE |
64 | #if __GNUC__ >= 2 | |
65 | #define INLINE __inline__ | |
66 | #else | |
67 | #define INLINE | |
68 | #endif | |
69 | #endif | |
70 | ||
63ffe5ef SC |
71 | /* forward declaration */ |
72 | typedef struct _bfd bfd; | |
73 | ||
034a8a56 KR |
74 | /* To squelch erroneous compiler warnings ("illegal pointer |
75 | combination") from the SVR3 compiler, we would like to typedef | |
76 | boolean to int (it doesn't like functions which return boolean. | |
77 | Making sure they are never implicitly declared to return int | |
78 | doesn't seem to help). But this file is not configured based on | |
79 | the host. */ | |
63ffe5ef SC |
80 | /* General rules: functions which are boolean return true on success |
81 | and false on failure (unless they're a predicate). -- bfd.doc */ | |
82 | /* I'm sure this is going to break something and someone is going to | |
83 | force me to change it. */ | |
f004165e JG |
84 | /* typedef enum boolean {false, true} boolean; */ |
85 | /* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h> -fnf */ | |
442da995 | 86 | /* It gets worse if the host also defines a true/false enum... -sts */ |
3b1f83ad JL |
87 | /* And even worse if your compiler has built-in boolean types... -law */ |
88 | #if defined (__GNUG__) && (__GNUC_MINOR__ > 5) | |
89 | #define TRUE_FALSE_ALREADY_DEFINED | |
90 | #endif | |
442da995 | 91 | #ifndef TRUE_FALSE_ALREADY_DEFINED |
f004165e | 92 | typedef enum bfd_boolean {false, true} boolean; |
442da995 SS |
93 | #define BFD_TRUE_FALSE |
94 | #else | |
e0151f38 SS |
95 | /* Use enum names that will appear nowhere else. */ |
96 | typedef enum bfd_boolean {bfd_fffalse, bfd_tttrue} boolean; | |
442da995 | 97 | #endif |
63ffe5ef | 98 | |
00539ee3 JG |
99 | /* A pointer to a position in a file. */ |
100 | /* FIXME: This should be using off_t from <sys/types.h>. | |
101 | For now, try to avoid breaking stuff by not including <sys/types.h> here. | |
102 | This will break on systems with 64-bit file offsets (e.g. 4.4BSD). | |
103 | Probably the best long-term answer is to avoid using file_ptr AND off_t | |
104 | in this header file, and to handle this in the BFD implementation | |
105 | rather than in its interface. */ | |
106 | /* typedef off_t file_ptr; */ | |
107 | typedef long int file_ptr; | |
63ffe5ef | 108 | |
3b1f83ad | 109 | /* Support for different sizes of target format ints and addresses. |
b7577823 ILT |
110 | If the type `long' is at least 64 bits, BFD_HOST_64BIT_LONG will be |
111 | set to 1 above. Otherwise, if gcc is being used, this code will | |
112 | use gcc's "long long" type. Otherwise, the compilation will fail | |
113 | if 64-bit targets are requested. */ | |
034a8a56 | 114 | |
b7577823 | 115 | #ifdef BFD64 |
034a8a56 | 116 | |
b7577823 ILT |
117 | #ifndef BFD_HOST_64_BIT |
118 | #if BFD_HOST_64BIT_LONG | |
119 | #define BFD_HOST_64_BIT long | |
120 | #else | |
121 | #ifdef __GNUC__ | |
9deaaaf1 | 122 | #define BFD_HOST_64_BIT long long |
b7577823 ILT |
123 | #endif /* defined (__GNUC__) */ |
124 | #endif /* ! BFD_HOST_64BIT_LONG */ | |
125 | #endif /* ! defined (BFD_HOST_64_BIT) */ | |
1fa5371e | 126 | |
9deaaaf1 ILT |
127 | typedef unsigned BFD_HOST_64_BIT bfd_vma; |
128 | typedef BFD_HOST_64_BIT bfd_signed_vma; | |
129 | typedef unsigned BFD_HOST_64_BIT bfd_size_type; | |
130 | typedef unsigned BFD_HOST_64_BIT symvalue; | |
b7577823 | 131 | |
d110544c | 132 | #ifndef fprintf_vma |
b7577823 ILT |
133 | #if BFD_HOST_64BIT_LONG |
134 | #define sprintf_vma(s,x) sprintf (s, "%016lx", x) | |
135 | #define fprintf_vma(f,x) fprintf (f, "%016lx", x) | |
136 | #else | |
137 | #define _bfd_int64_low(x) ((unsigned long) (((x) & 0xffffffff))) | |
138 | #define _bfd_int64_high(x) ((unsigned long) (((x) >> 32) & 0xffffffff)) | |
63ffe5ef | 139 | #define fprintf_vma(s,x) \ |
b7577823 | 140 | fprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x)) |
1fa5371e | 141 | #define sprintf_vma(s,x) \ |
b7577823 | 142 | sprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x)) |
d110544c | 143 | #endif |
b7577823 ILT |
144 | #endif |
145 | ||
034a8a56 | 146 | #else /* not BFD64 */ |
14e3c2e4 JK |
147 | |
148 | /* Represent a target address. Also used as a generic unsigned type | |
149 | which is guaranteed to be big enough to hold any arithmetic types | |
150 | we need to deal with. */ | |
63ffe5ef | 151 | typedef unsigned long bfd_vma; |
14e3c2e4 JK |
152 | |
153 | /* A generic signed type which is guaranteed to be big enough to hold any | |
154 | arithmetic types we need to deal with. Can be assumed to be compatible | |
155 | with bfd_vma in the same way that signed and unsigned ints are compatible | |
156 | (as parameters, in assignment, etc). */ | |
157 | typedef long bfd_signed_vma; | |
158 | ||
63ffe5ef SC |
159 | typedef unsigned long symvalue; |
160 | typedef unsigned long bfd_size_type; | |
14e3c2e4 JK |
161 | |
162 | /* Print a bfd_vma x on stream s. */ | |
63ffe5ef | 163 | #define fprintf_vma(s,x) fprintf(s, "%08lx", x) |
1fa5371e | 164 | #define sprintf_vma(s,x) sprintf(s, "%08lx", x) |
034a8a56 | 165 | #endif /* not BFD64 */ |
e98e6ec1 | 166 | #define printf_vma(x) fprintf_vma(stdout,x) |
63ffe5ef SC |
167 | |
168 | typedef unsigned int flagword; /* 32 bits of flags */ | |
3b1f83ad | 169 | typedef unsigned char bfd_byte; |
63ffe5ef SC |
170 | \f |
171 | /** File formats */ | |
172 | ||
173 | typedef enum bfd_format { | |
174 | bfd_unknown = 0, /* file format is unknown */ | |
175 | bfd_object, /* linker/assember/compiler output */ | |
176 | bfd_archive, /* object archive file */ | |
177 | bfd_core, /* core dump */ | |
178 | bfd_type_end} /* marks the end; don't use it! */ | |
179 | bfd_format; | |
180 | ||
8d12f138 ILT |
181 | /* Values that may appear in the flags field of a BFD. These also |
182 | appear in the object_flags field of the bfd_target structure, where | |
183 | they indicate the set of flags used by that backend (not all flags | |
184 | are meaningful for all object file formats) (FIXME: at the moment, | |
185 | the object_flags values have mostly just been copied from backend | |
186 | to another, and are not necessarily correct). */ | |
187 | ||
188 | /* No flags. */ | |
294eaca4 | 189 | #define NO_FLAGS 0x00 |
8d12f138 ILT |
190 | |
191 | /* BFD contains relocation entries. */ | |
294eaca4 | 192 | #define HAS_RELOC 0x01 |
8d12f138 ILT |
193 | |
194 | /* BFD is directly executable. */ | |
294eaca4 | 195 | #define EXEC_P 0x02 |
8d12f138 ILT |
196 | |
197 | /* BFD has line number information (basically used for F_LNNO in a | |
198 | COFF header). */ | |
294eaca4 | 199 | #define HAS_LINENO 0x04 |
8d12f138 ILT |
200 | |
201 | /* BFD has debugging information. */ | |
294eaca4 | 202 | #define HAS_DEBUG 0x08 |
8d12f138 ILT |
203 | |
204 | /* BFD has symbols. */ | |
294eaca4 | 205 | #define HAS_SYMS 0x10 |
8d12f138 ILT |
206 | |
207 | /* BFD has local symbols (basically used for F_LSYMS in a COFF | |
208 | header). */ | |
294eaca4 | 209 | #define HAS_LOCALS 0x20 |
8d12f138 ILT |
210 | |
211 | /* BFD is a dynamic object. */ | |
294eaca4 | 212 | #define DYNAMIC 0x40 |
8d12f138 ILT |
213 | |
214 | /* Text section is write protected (if D_PAGED is not set, this is | |
215 | like an a.out NMAGIC file) (the linker sets this by default, but | |
216 | clears it for -r or -N). */ | |
294eaca4 | 217 | #define WP_TEXT 0x80 |
8d12f138 ILT |
218 | |
219 | /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the | |
220 | linker sets this by default, but clears it for -r or -n or -N). */ | |
294eaca4 | 221 | #define D_PAGED 0x100 |
8d12f138 ILT |
222 | |
223 | /* BFD is relaxable (this means that bfd_relax_section may be able to | |
3b1f83ad JL |
224 | do something) (sometimes bfd_relax_section can do something even if |
225 | this is not set). */ | |
294eaca4 | 226 | #define BFD_IS_RELAXABLE 0x200 |
a7ff9b80 ILT |
227 | |
228 | /* This may be set before writing out a BFD to request using a | |
229 | traditional format. For example, this is used to request that when | |
230 | writing out an a.out object the symbols not be hashed to eliminate | |
231 | duplicates. */ | |
232 | #define BFD_TRADITIONAL_FORMAT 0x400 | |
63ffe5ef SC |
233 | \f |
234 | /* symbols and relocation */ | |
235 | ||
0f8f509c | 236 | /* A count of carsyms (canonical archive symbols). */ |
63ffe5ef SC |
237 | typedef unsigned long symindex; |
238 | ||
3b1f83ad JL |
239 | /* How to perform a relocation. */ |
240 | typedef const struct reloc_howto_struct reloc_howto_type; | |
241 | ||
63ffe5ef SC |
242 | #define BFD_NO_MORE_SYMBOLS ((symindex) ~0) |
243 | ||
0f8f509c DM |
244 | /* General purpose part of a symbol X; |
245 | target specific parts are in libcoff.h, libaout.h, etc. */ | |
63ffe5ef SC |
246 | |
247 | #define bfd_get_section(x) ((x)->section) | |
248 | #define bfd_get_output_section(x) ((x)->section->output_section) | |
249 | #define bfd_set_section(x,y) ((x)->section) = (y) | |
0c2fae09 | 250 | #define bfd_asymbol_base(x) ((x)->section->vma) |
ec30dfba | 251 | #define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value) |
63ffe5ef | 252 | #define bfd_asymbol_name(x) ((x)->name) |
0c2fae09 ILT |
253 | /*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/ |
254 | #define bfd_asymbol_bfd(x) ((x)->the_bfd) | |
255 | #define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour) | |
63ffe5ef | 256 | |
0f8f509c | 257 | /* A canonical archive symbol. */ |
63ffe5ef SC |
258 | /* This is a type pun with struct ranlib on purpose! */ |
259 | typedef struct carsym { | |
260 | char *name; | |
261 | file_ptr file_offset; /* look here to find the file */ | |
262 | } carsym; /* to make these you call a carsymogen */ | |
263 | ||
264 | ||
0f8f509c DM |
265 | /* Used in generating armaps (archive tables of contents). |
266 | Perhaps just a forward definition would do? */ | |
63ffe5ef SC |
267 | struct orl { /* output ranlib */ |
268 | char **name; /* symbol name */ | |
269 | file_ptr pos; /* bfd* or file position */ | |
270 | int namidx; /* index into string table */ | |
271 | }; | |
63ffe5ef SC |
272 | \f |
273 | ||
274 | /* Linenumber stuff */ | |
275 | typedef struct lineno_cache_entry { | |
276 | unsigned int line_number; /* Linenumber from start of function*/ | |
277 | union { | |
0f8f509c | 278 | struct symbol_cache_entry *sym; /* Function name */ |
63ffe5ef SC |
279 | unsigned long offset; /* Offset into section */ |
280 | } u; | |
281 | } alent; | |
282 | \f | |
283 | /* object and core file sections */ | |
284 | ||
63ffe5ef SC |
285 | #define align_power(addr, align) \ |
286 | ( ((addr) + ((1<<(align))-1)) & (-1 << (align))) | |
287 | ||
288 | typedef struct sec *sec_ptr; | |
289 | ||
294eaca4 SC |
290 | #define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0) |
291 | #define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0) | |
292 | #define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0) | |
63ffe5ef | 293 | #define bfd_section_name(bfd, ptr) ((ptr)->name) |
e98e6ec1 | 294 | #define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr)) |
63ffe5ef SC |
295 | #define bfd_section_vma(bfd, ptr) ((ptr)->vma) |
296 | #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power) | |
294eaca4 | 297 | #define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0) |
63ffe5ef SC |
298 | #define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata) |
299 | ||
ec30dfba JG |
300 | #define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0) |
301 | ||
e0151f38 | 302 | #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma= (val)), ((ptr)->user_set_vma = (boolean)true), true) |
6167a840 JL |
303 | #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true) |
304 | #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true) | |
63ffe5ef SC |
305 | |
306 | typedef struct stat stat_type; | |
307 | \f | |
63ffe5ef SC |
308 | typedef enum bfd_print_symbol |
309 | { | |
cbdc7909 JG |
310 | bfd_print_symbol_name, |
311 | bfd_print_symbol_more, | |
034a8a56 | 312 | bfd_print_symbol_all |
cbdc7909 | 313 | } bfd_print_symbol_type; |
63ffe5ef | 314 | |
034a8a56 KR |
315 | /* Information about a symbol that nm needs. */ |
316 | ||
317 | typedef struct _symbol_info | |
318 | { | |
319 | symvalue value; | |
0f8f509c | 320 | char type; |
034a8a56 KR |
321 | CONST char *name; /* Symbol name. */ |
322 | char stab_other; /* Unused. */ | |
323 | short stab_desc; /* Info for N_TYPE. */ | |
324 | CONST char *stab_name; | |
325 | } symbol_info; | |
63ffe5ef | 326 | \f |
4c3721d5 ILT |
327 | /* Hash table routines. There is no way to free up a hash table. */ |
328 | ||
329 | /* An element in the hash table. Most uses will actually use a larger | |
330 | structure, and an instance of this will be the first field. */ | |
331 | ||
332 | struct bfd_hash_entry | |
333 | { | |
334 | /* Next entry for this hash code. */ | |
335 | struct bfd_hash_entry *next; | |
336 | /* String being hashed. */ | |
337 | const char *string; | |
338 | /* Hash code. This is the full hash code, not the index into the | |
339 | table. */ | |
340 | unsigned long hash; | |
341 | }; | |
342 | ||
343 | /* A hash table. */ | |
344 | ||
345 | struct bfd_hash_table | |
346 | { | |
347 | /* The hash array. */ | |
348 | struct bfd_hash_entry **table; | |
349 | /* The number of slots in the hash table. */ | |
350 | unsigned int size; | |
351 | /* A function used to create new elements in the hash table. The | |
352 | first entry is itself a pointer to an element. When this | |
353 | function is first invoked, this pointer will be NULL. However, | |
354 | having the pointer permits a hierarchy of method functions to be | |
355 | built each of which calls the function in the superclass. Thus | |
356 | each function should be written to allocate a new block of memory | |
357 | only if the argument is NULL. */ | |
358 | struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *, | |
359 | struct bfd_hash_table *, | |
360 | const char *)); | |
361 | /* An obstack for this hash table. */ | |
362 | struct obstack memory; | |
363 | }; | |
364 | ||
365 | /* Initialize a hash table. */ | |
366 | extern boolean bfd_hash_table_init | |
367 | PARAMS ((struct bfd_hash_table *, | |
368 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, | |
369 | struct bfd_hash_table *, | |
370 | const char *))); | |
371 | ||
372 | /* Initialize a hash table specifying a size. */ | |
373 | extern boolean bfd_hash_table_init_n | |
374 | PARAMS ((struct bfd_hash_table *, | |
375 | struct bfd_hash_entry *(*) (struct bfd_hash_entry *, | |
376 | struct bfd_hash_table *, | |
377 | const char *), | |
378 | unsigned int size)); | |
379 | ||
380 | /* Free up a hash table. */ | |
381 | extern void bfd_hash_table_free PARAMS ((struct bfd_hash_table *)); | |
382 | ||
383 | /* Look up a string in a hash table. If CREATE is true, a new entry | |
384 | will be created for this string if one does not already exist. The | |
385 | COPY argument must be true if this routine should copy the string | |
386 | into newly allocated memory when adding an entry. */ | |
387 | extern struct bfd_hash_entry *bfd_hash_lookup | |
388 | PARAMS ((struct bfd_hash_table *, const char *, boolean create, | |
389 | boolean copy)); | |
390 | ||
b7577823 ILT |
391 | /* Replace an entry in a hash table. */ |
392 | extern void bfd_hash_replace | |
393 | PARAMS ((struct bfd_hash_table *, struct bfd_hash_entry *old, | |
394 | struct bfd_hash_entry *nw)); | |
395 | ||
4c3721d5 ILT |
396 | /* Base method for creating a hash table entry. */ |
397 | extern struct bfd_hash_entry *bfd_hash_newfunc | |
398 | PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *, | |
399 | const char *)); | |
400 | ||
401 | /* Grab some space for a hash table entry. */ | |
966e0a16 ILT |
402 | extern PTR bfd_hash_allocate PARAMS ((struct bfd_hash_table *, |
403 | unsigned int)); | |
4c3721d5 ILT |
404 | |
405 | /* Traverse a hash table in a random order, calling a function on each | |
406 | element. If the function returns false, the traversal stops. The | |
407 | INFO argument is passed to the function. */ | |
408 | extern void bfd_hash_traverse PARAMS ((struct bfd_hash_table *, | |
409 | boolean (*) (struct bfd_hash_entry *, | |
410 | PTR), | |
411 | PTR info)); | |
412 | \f | |
1fa5371e KR |
413 | /* Semi-portable string concatenation in cpp. |
414 | The CAT4 hack is to avoid a problem with some strict ANSI C preprocessors. | |
415 | The problem is, "32_" is not a valid preprocessing token, and we don't | |
416 | want extra underscores (e.g., "nlm_32_"). The XCAT2 macro will cause the | |
417 | inner CAT macros to be evaluated first, producing still-valid pp-tokens. | |
418 | Then the final concatenation can be done. (Sigh.) */ | |
63ffe5ef | 419 | #ifndef CAT |
1fa5371e KR |
420 | #ifdef SABER |
421 | #define CAT(a,b) a##b | |
422 | #define CAT3(a,b,c) a##b##c | |
423 | #define CAT4(a,b,c,d) a##b##c##d | |
424 | #else | |
442da995 | 425 | #if defined(__STDC__) || defined(ALMOST_STDC) |
63ffe5ef | 426 | #define CAT(a,b) a##b |
034a8a56 | 427 | #define CAT3(a,b,c) a##b##c |
1fa5371e KR |
428 | #define XCAT2(a,b) CAT(a,b) |
429 | #define CAT4(a,b,c,d) XCAT2(CAT(a,b),CAT(c,d)) | |
63ffe5ef SC |
430 | #else |
431 | #define CAT(a,b) a/**/b | |
034a8a56 | 432 | #define CAT3(a,b,c) a/**/b/**/c |
1fa5371e KR |
433 | #define CAT4(a,b,c,d) a/**/b/**/c/**/d |
434 | #endif | |
63ffe5ef SC |
435 | #endif |
436 | #endif | |
437 | ||
0c2fae09 | 438 | #define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table |
63ffe5ef SC |
439 | \f |
440 | /* User program access to BFD facilities */ | |
441 | ||
3b1f83ad JL |
442 | /* Direct I/O routines, for programs which know more about the object |
443 | file than BFD does. Use higher level routines if possible. */ | |
444 | ||
445 | extern bfd_size_type bfd_read | |
446 | PARAMS ((PTR, bfd_size_type size, bfd_size_type nitems, bfd *abfd)); | |
447 | extern bfd_size_type bfd_write | |
448 | PARAMS ((const PTR, bfd_size_type size, bfd_size_type nitems, bfd *abfd)); | |
449 | extern int bfd_seek PARAMS ((bfd *abfd, file_ptr fp, int direction)); | |
450 | extern long bfd_tell PARAMS ((bfd *abfd)); | |
451 | extern int bfd_flush PARAMS ((bfd *abfd)); | |
452 | extern int bfd_stat PARAMS ((bfd *abfd, struct stat *)); | |
453 | ||
b176e1e9 | 454 | |
63ffe5ef SC |
455 | /* Cast from const char * to char * so that caller can assign to |
456 | a char * without a warning. */ | |
457 | #define bfd_get_filename(abfd) ((char *) (abfd)->filename) | |
8d12f138 | 458 | #define bfd_get_cacheable(abfd) ((abfd)->cacheable) |
63ffe5ef SC |
459 | #define bfd_get_format(abfd) ((abfd)->format) |
460 | #define bfd_get_target(abfd) ((abfd)->xvec->name) | |
8d12f138 | 461 | #define bfd_get_flavour(abfd) ((abfd)->xvec->flavour) |
63ffe5ef SC |
462 | #define bfd_get_file_flags(abfd) ((abfd)->flags) |
463 | #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags) | |
464 | #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags) | |
e98e6ec1 | 465 | #define bfd_my_archive(abfd) ((abfd)->my_archive) |
63ffe5ef | 466 | #define bfd_has_map(abfd) ((abfd)->has_armap) |
63ffe5ef SC |
467 | |
468 | #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types) | |
469 | #define bfd_usrdata(abfd) ((abfd)->usrdata) | |
470 | ||
471 | #define bfd_get_start_address(abfd) ((abfd)->start_address) | |
472 | #define bfd_get_symcount(abfd) ((abfd)->symcount) | |
473 | #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols) | |
474 | #define bfd_count_sections(abfd) ((abfd)->section_count) | |
63ffe5ef | 475 | |
294eaca4 | 476 | #define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char) |
63ffe5ef | 477 | |
e0151f38 | 478 | #define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = (boolean)(bool)), true) |
8d12f138 ILT |
479 | |
480 | /* Byte swapping routines. */ | |
481 | ||
1a973af1 ILT |
482 | bfd_vma bfd_getb64 PARAMS ((const unsigned char *)); |
483 | bfd_vma bfd_getl64 PARAMS ((const unsigned char *)); | |
484 | bfd_signed_vma bfd_getb_signed_64 PARAMS ((const unsigned char *)); | |
485 | bfd_signed_vma bfd_getl_signed_64 PARAMS ((const unsigned char *)); | |
486 | bfd_vma bfd_getb32 PARAMS ((const unsigned char *)); | |
487 | bfd_vma bfd_getl32 PARAMS ((const unsigned char *)); | |
488 | bfd_signed_vma bfd_getb_signed_32 PARAMS ((const unsigned char *)); | |
489 | bfd_signed_vma bfd_getl_signed_32 PARAMS ((const unsigned char *)); | |
490 | bfd_vma bfd_getb16 PARAMS ((const unsigned char *)); | |
491 | bfd_vma bfd_getl16 PARAMS ((const unsigned char *)); | |
492 | bfd_signed_vma bfd_getb_signed_16 PARAMS ((const unsigned char *)); | |
493 | bfd_signed_vma bfd_getl_signed_16 PARAMS ((const unsigned char *)); | |
8d12f138 ILT |
494 | void bfd_putb64 PARAMS ((bfd_vma, unsigned char *)); |
495 | void bfd_putl64 PARAMS ((bfd_vma, unsigned char *)); | |
496 | void bfd_putb32 PARAMS ((bfd_vma, unsigned char *)); | |
497 | void bfd_putl32 PARAMS ((bfd_vma, unsigned char *)); | |
498 | void bfd_putb16 PARAMS ((bfd_vma, unsigned char *)); | |
499 | void bfd_putl16 PARAMS ((bfd_vma, unsigned char *)); | |
013dec1a ILT |
500 | \f |
501 | /* Externally visible ECOFF routines. */ | |
8d12f138 | 502 | |
442da995 | 503 | #if defined(__STDC__) || defined(ALMOST_STDC) |
8d12f138 ILT |
504 | struct ecoff_debug_info; |
505 | struct ecoff_debug_swap; | |
506 | struct ecoff_extr; | |
507 | struct symbol_cache_entry; | |
d110544c | 508 | struct bfd_link_info; |
8d12f138 | 509 | #endif |
013dec1a ILT |
510 | extern bfd_vma bfd_ecoff_get_gp_value PARAMS ((bfd * abfd)); |
511 | extern boolean bfd_ecoff_set_gp_value PARAMS ((bfd *abfd, bfd_vma gp_value)); | |
512 | extern boolean bfd_ecoff_set_regmasks | |
513 | PARAMS ((bfd *abfd, unsigned long gprmask, unsigned long fprmask, | |
514 | unsigned long *cprmask)); | |
d110544c | 515 | extern PTR bfd_ecoff_debug_init |
8d12f138 | 516 | PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug, |
d110544c KR |
517 | const struct ecoff_debug_swap *output_swap, |
518 | struct bfd_link_info *)); | |
519 | extern void bfd_ecoff_debug_free | |
520 | PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug, | |
521 | const struct ecoff_debug_swap *output_swap, | |
522 | struct bfd_link_info *)); | |
523 | extern boolean bfd_ecoff_debug_accumulate | |
524 | PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug, | |
8d12f138 ILT |
525 | const struct ecoff_debug_swap *output_swap, |
526 | bfd *input_bfd, struct ecoff_debug_info *input_debug, | |
527 | const struct ecoff_debug_swap *input_swap, | |
d110544c KR |
528 | struct bfd_link_info *)); |
529 | extern boolean bfd_ecoff_debug_accumulate_other | |
530 | PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug, | |
531 | const struct ecoff_debug_swap *output_swap, bfd *input_bfd, | |
532 | struct bfd_link_info *)); | |
8d12f138 ILT |
533 | extern boolean bfd_ecoff_debug_externals |
534 | PARAMS ((bfd *abfd, struct ecoff_debug_info *debug, | |
535 | const struct ecoff_debug_swap *swap, | |
536 | boolean relocateable, | |
537 | boolean (*get_extr) (struct symbol_cache_entry *, | |
538 | struct ecoff_extr *), | |
539 | void (*set_index) (struct symbol_cache_entry *, | |
540 | bfd_size_type))); | |
966e0a16 ILT |
541 | extern boolean bfd_ecoff_debug_one_external |
542 | PARAMS ((bfd *abfd, struct ecoff_debug_info *debug, | |
543 | const struct ecoff_debug_swap *swap, | |
544 | const char *name, struct ecoff_extr *esym)); | |
8d12f138 ILT |
545 | extern bfd_size_type bfd_ecoff_debug_size |
546 | PARAMS ((bfd *abfd, struct ecoff_debug_info *debug, | |
547 | const struct ecoff_debug_swap *swap)); | |
548 | extern boolean bfd_ecoff_write_debug | |
549 | PARAMS ((bfd *abfd, struct ecoff_debug_info *debug, | |
550 | const struct ecoff_debug_swap *swap, file_ptr where)); | |
d110544c KR |
551 | extern boolean bfd_ecoff_write_accumulated_debug |
552 | PARAMS ((PTR handle, bfd *abfd, struct ecoff_debug_info *debug, | |
553 | const struct ecoff_debug_swap *swap, | |
554 | struct bfd_link_info *info, file_ptr where)); | |
3b1f83ad JL |
555 | extern boolean bfd_mips_ecoff_create_embedded_relocs |
556 | PARAMS ((bfd *, struct bfd_link_info *, struct sec *, struct sec *, | |
557 | char **)); | |
63ffe5ef | 558 | |
013dec1a ILT |
559 | /* Externally visible ELF routines. */ |
560 | ||
561 | extern boolean bfd_elf32_record_link_assignment | |
b5279eb6 | 562 | PARAMS ((bfd *, struct bfd_link_info *, const char *, boolean)); |
013dec1a | 563 | extern boolean bfd_elf64_record_link_assignment |
b5279eb6 | 564 | PARAMS ((bfd *, struct bfd_link_info *, const char *, boolean)); |
b176e1e9 ILT |
565 | struct bfd_elf_link_needed_list |
566 | { | |
567 | struct bfd_elf_link_needed_list *next; | |
568 | bfd *by; | |
569 | const char *name; | |
570 | }; | |
571 | extern struct bfd_elf_link_needed_list *bfd_elf_get_needed_list | |
572 | PARAMS ((bfd *, struct bfd_link_info *)); | |
013dec1a | 573 | extern boolean bfd_elf32_size_dynamic_sections |
3b1f83ad JL |
574 | PARAMS ((bfd *, const char *, const char *, boolean, |
575 | struct bfd_link_info *, struct sec **)); | |
013dec1a | 576 | extern boolean bfd_elf64_size_dynamic_sections |
3b1f83ad JL |
577 | PARAMS ((bfd *, const char *, const char *, boolean, |
578 | struct bfd_link_info *, struct sec **)); | |
c1f84521 | 579 | extern void bfd_elf_set_dt_needed_name PARAMS ((bfd *, const char *)); |
013dec1a | 580 | |
a7ff9b80 ILT |
581 | /* SunOS shared library support routines for the linker. */ |
582 | ||
583 | extern boolean bfd_sunos_record_link_assignment | |
584 | PARAMS ((bfd *, struct bfd_link_info *, const char *)); | |
585 | extern boolean bfd_sunos_size_dynamic_sections | |
586 | PARAMS ((bfd *, struct bfd_link_info *, struct sec **, struct sec **, | |
587 | struct sec **)); | |
588 | ||
3b1f83ad JL |
589 | /* Linux shared library support routines for the linker. */ |
590 | ||
591 | extern boolean bfd_linux_size_dynamic_sections | |
592 | PARAMS ((bfd *, struct bfd_link_info *)); | |
593 | ||
294eaca4 | 594 | /* And more from the source. */ |