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