Commit | Line | Data |
---|---|---|
fdcb0453 | 1 | /* Main header file for the bfd library -- portable access to object files. |
fdcb0453 KR |
2 | Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc. |
3 | Contributed by Cygnus Support. | |
4 | ||
b66b07a2 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 | ||
fdcb0453 KR |
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 | ||
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. | |
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 | ||
50 | #define BFD_VERSION "2.2" | |
51 | ||
52 | #define BFD_ARCH_SIZE @WORDSIZE@ | |
53 | ||
54 | #if BFD_ARCH_SIZE >= 64 | |
55 | #define BFD64 | |
56 | #endif | |
57 | ||
c3e964b9 FF |
58 | #ifndef INLINE |
59 | #if __GNUC__ >= 2 | |
60 | #define INLINE __inline__ | |
61 | #else | |
62 | #define INLINE | |
63 | #endif | |
64 | #endif | |
65 | ||
87cc59ce KR |
66 | /* 64-bit type definition (if any) from bfd's sysdep.h goes here */ |
67 | ||
fdcb0453 KR |
68 | |
69 | /* forward declaration */ | |
70 | typedef struct _bfd bfd; | |
71 | ||
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. */ | |
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. */ | |
82 | /* typedef enum boolean {false, true} boolean; */ | |
83 | /* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h> -fnf */ | |
84 | typedef enum bfd_boolean {false, true} boolean; | |
85 | ||
86 | /* A pointer to a position in a file. */ | |
87 | /* FIXME: This should be using off_t from <sys/types.h>. | |
88 | For now, try to avoid breaking stuff by not including <sys/types.h> here. | |
89 | This will break on systems with 64-bit file offsets (e.g. 4.4BSD). | |
90 | Probably the best long-term answer is to avoid using file_ptr AND off_t | |
91 | in this header file, and to handle this in the BFD implementation | |
92 | rather than in its interface. */ | |
93 | /* typedef off_t file_ptr; */ | |
94 | typedef long int file_ptr; | |
95 | ||
96 | /* Support for different sizes of target format ints and addresses. If the | |
97 | host implements 64-bit values, it defines HOST_64_BIT to be the appropriate | |
98 | type. Otherwise, this code will fall back on gcc's "long long" type if gcc | |
99 | is being used. HOST_64_BIT must be defined in such a way as to be a valid | |
100 | type name by itself or with "unsigned" prefixed. It should be a signed | |
101 | type by itself. | |
102 | ||
103 | If neither is the case, then compilation will fail if 64-bit targets are | |
104 | requested. If you don't request any 64-bit targets, you should be safe. */ | |
105 | ||
106 | #ifdef BFD64 | |
107 | ||
108 | #if defined (__GNUC__) && !defined (HOST_64_BIT) | |
109 | #define HOST_64_BIT long long | |
110 | typedef HOST_64_BIT int64_type; | |
111 | typedef unsigned HOST_64_BIT uint64_type; | |
112 | #endif | |
113 | ||
fa5ba217 KR |
114 | #if !defined (uint64_type) && defined (__GNUC__) |
115 | #define uint64_type unsigned long long | |
116 | #define int64_type long long | |
117 | #define uint64_typeLOW(x) (unsigned long)(((x) & 0xffffffff)) | |
118 | #define uint64_typeHIGH(x) (unsigned long)(((x) >> 32) & 0xffffffff) | |
119 | #endif | |
120 | ||
fdcb0453 KR |
121 | typedef unsigned HOST_64_BIT bfd_vma; |
122 | typedef HOST_64_BIT bfd_signed_vma; | |
123 | typedef unsigned HOST_64_BIT bfd_size_type; | |
124 | typedef unsigned HOST_64_BIT symvalue; | |
125 | #define fprintf_vma(s,x) \ | |
126 | fprintf(s,"%08x%08x", uint64_typeHIGH(x), uint64_typeLOW(x)) | |
fa5ba217 KR |
127 | #define sprintf_vma(s,x) \ |
128 | sprintf(s,"%08x%08x", uint64_typeHIGH(x), uint64_typeLOW(x)) | |
fdcb0453 KR |
129 | #else /* not BFD64 */ |
130 | ||
131 | /* Represent a target address. Also used as a generic unsigned type | |
132 | which is guaranteed to be big enough to hold any arithmetic types | |
133 | we need to deal with. */ | |
134 | typedef unsigned long bfd_vma; | |
135 | ||
136 | /* A generic signed type which is guaranteed to be big enough to hold any | |
137 | arithmetic types we need to deal with. Can be assumed to be compatible | |
138 | with bfd_vma in the same way that signed and unsigned ints are compatible | |
139 | (as parameters, in assignment, etc). */ | |
140 | typedef long bfd_signed_vma; | |
141 | ||
142 | typedef unsigned long symvalue; | |
143 | typedef unsigned long bfd_size_type; | |
144 | ||
145 | /* Print a bfd_vma x on stream s. */ | |
146 | #define fprintf_vma(s,x) fprintf(s, "%08lx", x) | |
fa5ba217 | 147 | #define sprintf_vma(s,x) sprintf(s, "%08lx", x) |
fdcb0453 KR |
148 | #endif /* not BFD64 */ |
149 | #define printf_vma(x) fprintf_vma(stdout,x) | |
150 | ||
151 | typedef unsigned int flagword; /* 32 bits of flags */ | |
152 | \f | |
153 | /** File formats */ | |
154 | ||
155 | typedef enum bfd_format { | |
156 | bfd_unknown = 0, /* file format is unknown */ | |
157 | bfd_object, /* linker/assember/compiler output */ | |
158 | bfd_archive, /* object archive file */ | |
159 | bfd_core, /* core dump */ | |
160 | bfd_type_end} /* marks the end; don't use it! */ | |
161 | bfd_format; | |
162 | ||
9e461dac JK |
163 | /* Values that may appear in the flags field of a BFD. These also |
164 | appear in the object_flags field of the bfd_target structure, where | |
165 | they indicate the set of flags used by that backend (not all flags | |
166 | are meaningful for all object file formats) (FIXME: at the moment, | |
167 | the object_flags values have mostly just been copied from backend | |
168 | to another, and are not necessarily correct). */ | |
169 | ||
170 | /* No flags. */ | |
fdcb0453 | 171 | #define NO_FLAGS 0x00 |
9e461dac JK |
172 | |
173 | /* BFD contains relocation entries. */ | |
fdcb0453 | 174 | #define HAS_RELOC 0x01 |
9e461dac JK |
175 | |
176 | /* BFD is directly executable. */ | |
fdcb0453 | 177 | #define EXEC_P 0x02 |
9e461dac JK |
178 | |
179 | /* BFD has line number information (basically used for F_LNNO in a | |
180 | COFF header). */ | |
fdcb0453 | 181 | #define HAS_LINENO 0x04 |
9e461dac JK |
182 | |
183 | /* BFD has debugging information. */ | |
fdcb0453 | 184 | #define HAS_DEBUG 0x08 |
9e461dac JK |
185 | |
186 | /* BFD has symbols. */ | |
fdcb0453 | 187 | #define HAS_SYMS 0x10 |
9e461dac JK |
188 | |
189 | /* BFD has local symbols (basically used for F_LSYMS in a COFF | |
190 | header). */ | |
fdcb0453 | 191 | #define HAS_LOCALS 0x20 |
9e461dac JK |
192 | |
193 | /* BFD is a dynamic object. */ | |
fdcb0453 | 194 | #define DYNAMIC 0x40 |
9e461dac JK |
195 | |
196 | /* Text section is write protected (if D_PAGED is not set, this is | |
197 | like an a.out NMAGIC file) (the linker sets this by default, but | |
198 | clears it for -r or -N). */ | |
fdcb0453 | 199 | #define WP_TEXT 0x80 |
9e461dac JK |
200 | |
201 | /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the | |
202 | linker sets this by default, but clears it for -r or -n or -N). */ | |
fdcb0453 | 203 | #define D_PAGED 0x100 |
9e461dac JK |
204 | |
205 | /* BFD is relaxable (this means that bfd_relax_section may be able to | |
206 | do something). */ | |
fdcb0453 KR |
207 | #define BFD_IS_RELAXABLE 0x200 |
208 | \f | |
209 | /* symbols and relocation */ | |
210 | ||
211 | typedef unsigned long symindex; | |
212 | ||
213 | #define BFD_NO_MORE_SYMBOLS ((symindex) ~0) | |
214 | ||
215 | typedef enum bfd_symclass { | |
216 | bfd_symclass_unknown = 0, | |
217 | bfd_symclass_fcommon, /* fortran common symbols */ | |
218 | bfd_symclass_global, /* global symbol, what a surprise */ | |
219 | bfd_symclass_debugger, /* some debugger symbol */ | |
220 | bfd_symclass_undefined /* none known */ | |
221 | } symclass; | |
222 | ||
223 | ||
fdcb0453 KR |
224 | /* general purpose part of a symbol; |
225 | target specific parts will be found in libcoff.h, liba.out.h etc */ | |
226 | ||
227 | ||
228 | #define bfd_get_section(x) ((x)->section) | |
229 | #define bfd_get_output_section(x) ((x)->section->output_section) | |
230 | #define bfd_set_section(x,y) ((x)->section) = (y) | |
231 | #define bfd_asymbol_base(x) ((x)->section->vma) | |
232 | #define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value) | |
233 | #define bfd_asymbol_name(x) ((x)->name) | |
234 | /*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/ | |
235 | #define bfd_asymbol_bfd(x) ((x)->the_bfd) | |
236 | #define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour) | |
237 | ||
238 | /* This is a type pun with struct ranlib on purpose! */ | |
239 | typedef struct carsym { | |
240 | char *name; | |
241 | file_ptr file_offset; /* look here to find the file */ | |
242 | } carsym; /* to make these you call a carsymogen */ | |
243 | ||
244 | ||
245 | /* Used in generating armaps. Perhaps just a forward definition would do? */ | |
246 | struct orl { /* output ranlib */ | |
247 | char **name; /* symbol name */ | |
248 | file_ptr pos; /* bfd* or file position */ | |
249 | int namidx; /* index into string table */ | |
250 | }; | |
251 | ||
252 | \f | |
253 | ||
254 | /* Linenumber stuff */ | |
255 | typedef struct lineno_cache_entry { | |
256 | unsigned int line_number; /* Linenumber from start of function*/ | |
257 | union { | |
258 | struct symbol_cache_entry *sym; /* Function name */ | |
259 | unsigned long offset; /* Offset into section */ | |
260 | } u; | |
261 | } alent; | |
262 | \f | |
263 | /* object and core file sections */ | |
264 | ||
265 | ||
266 | #define align_power(addr, align) \ | |
267 | ( ((addr) + ((1<<(align))-1)) & (-1 << (align))) | |
268 | ||
269 | typedef struct sec *sec_ptr; | |
270 | ||
271 | #define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0) | |
272 | #define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0) | |
273 | #define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0) | |
274 | #define bfd_section_name(bfd, ptr) ((ptr)->name) | |
275 | #define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr)) | |
276 | #define bfd_section_vma(bfd, ptr) ((ptr)->vma) | |
277 | #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power) | |
278 | #define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0) | |
279 | #define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata) | |
280 | ||
281 | #define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0) | |
282 | ||
283 | #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma= (val)), ((ptr)->user_set_vma = true), true) | |
284 | #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true) | |
285 | #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true) | |
286 | ||
287 | typedef struct stat stat_type; | |
288 | \f | |
289 | /** Error handling */ | |
290 | ||
291 | typedef enum bfd_error { | |
292 | no_error = 0, system_call_error, invalid_target, | |
293 | wrong_format, invalid_operation, no_memory, | |
294 | no_symbols, no_relocation_info, | |
295 | no_more_archived_files, malformed_archive, | |
296 | symbol_not_found, file_not_recognized, | |
297 | file_ambiguously_recognized, no_contents, | |
298 | bfd_error_nonrepresentable_section, | |
299 | no_debug_section, bad_value, | |
300 | ||
301 | /* An input file is shorter than expected. */ | |
302 | file_truncated, | |
303 | ||
304 | invalid_error_code} bfd_ec; | |
305 | ||
306 | extern bfd_ec bfd_error; | |
307 | struct reloc_cache_entry; | |
308 | struct bfd_seclet; | |
309 | ||
310 | ||
311 | typedef struct bfd_error_vector { | |
312 | void (* nonrepresentable_section ) PARAMS ((CONST bfd *CONST abfd, | |
313 | CONST char *CONST name)); | |
314 | void (* undefined_symbol) PARAMS ((CONST struct reloc_cache_entry *rel, | |
315 | CONST struct bfd_seclet *sec)); | |
316 | void (* reloc_value_truncated) PARAMS ((CONST struct | |
317 | reloc_cache_entry *rel, | |
318 | struct bfd_seclet *sec)); | |
319 | ||
320 | void (* reloc_dangerous) PARAMS ((CONST struct reloc_cache_entry *rel, | |
321 | CONST struct bfd_seclet *sec)); | |
322 | ||
323 | } bfd_error_vector_type; | |
324 | ||
325 | CONST char *bfd_errmsg PARAMS ((bfd_ec error_tag)); | |
326 | void bfd_perror PARAMS ((CONST char *message)); | |
327 | \f | |
328 | ||
329 | typedef enum bfd_print_symbol | |
330 | { | |
331 | bfd_print_symbol_name, | |
332 | bfd_print_symbol_more, | |
333 | bfd_print_symbol_all | |
334 | } bfd_print_symbol_type; | |
335 | ||
336 | \f | |
337 | /* Information about a symbol that nm needs. */ | |
338 | ||
339 | typedef struct _symbol_info | |
340 | { | |
341 | symvalue value; | |
342 | char type; /* */ | |
343 | CONST char *name; /* Symbol name. */ | |
344 | char stab_other; /* Unused. */ | |
345 | short stab_desc; /* Info for N_TYPE. */ | |
346 | CONST char *stab_name; | |
347 | } symbol_info; | |
348 | \f | |
349 | /* The code that implements targets can initialize a jump table with this | |
350 | macro. It must name all its routines the same way (a prefix plus | |
351 | the standard routine suffix), or it must #define the routines that | |
352 | are not so named, before calling JUMP_TABLE in the initializer. */ | |
353 | ||
c3e964b9 FF |
354 | /* Semi-portable string concatenation in cpp. |
355 | The CAT4 hack is to avoid a problem with some strict ANSI C preprocessors. | |
356 | The problem is, "32_" is not a valid preprocessing token, and we don't | |
357 | want extra underscores (e.g., "nlm_32_"). The XCAT2 macro will cause the | |
358 | inner CAT macros to be evaluated first, producing still-valid pp-tokens. | |
359 | Then the final concatenation can be done. (Sigh.) */ | |
fdcb0453 | 360 | #ifndef CAT |
c3e964b9 FF |
361 | #ifdef SABER |
362 | #define CAT(a,b) a##b | |
363 | #define CAT3(a,b,c) a##b##c | |
364 | #define CAT4(a,b,c,d) a##b##c##d | |
365 | #else | |
fdcb0453 KR |
366 | #ifdef __STDC__ |
367 | #define CAT(a,b) a##b | |
368 | #define CAT3(a,b,c) a##b##c | |
c3e964b9 FF |
369 | #define XCAT2(a,b) CAT(a,b) |
370 | #define CAT4(a,b,c,d) XCAT2(CAT(a,b),CAT(c,d)) | |
fdcb0453 KR |
371 | #else |
372 | #define CAT(a,b) a/**/b | |
373 | #define CAT3(a,b,c) a/**/b/**/c | |
c3e964b9 FF |
374 | #define CAT4(a,b,c,d) a/**/b/**/c/**/d |
375 | #endif | |
fdcb0453 KR |
376 | #endif |
377 | #endif | |
378 | ||
379 | #define JUMP_TABLE(NAME)\ | |
380 | CAT(NAME,_core_file_failing_command),\ | |
381 | CAT(NAME,_core_file_failing_signal),\ | |
382 | CAT(NAME,_core_file_matches_executable_p),\ | |
383 | CAT(NAME,_slurp_armap),\ | |
384 | CAT(NAME,_slurp_extended_name_table),\ | |
385 | CAT(NAME,_truncate_arname),\ | |
386 | CAT(NAME,_write_armap),\ | |
c3e964b9 | 387 | CAT(NAME,_close_and_cleanup),\ |
fdcb0453 KR |
388 | CAT(NAME,_set_section_contents),\ |
389 | CAT(NAME,_get_section_contents),\ | |
390 | CAT(NAME,_new_section_hook),\ | |
391 | CAT(NAME,_get_symtab_upper_bound),\ | |
392 | CAT(NAME,_get_symtab),\ | |
393 | CAT(NAME,_get_reloc_upper_bound),\ | |
394 | CAT(NAME,_canonicalize_reloc),\ | |
395 | CAT(NAME,_make_empty_symbol),\ | |
396 | CAT(NAME,_print_symbol),\ | |
397 | CAT(NAME,_get_symbol_info),\ | |
398 | CAT(NAME,_get_lineno),\ | |
399 | CAT(NAME,_set_arch_mach),\ | |
400 | CAT(NAME,_openr_next_archived_file),\ | |
401 | CAT(NAME,_find_nearest_line),\ | |
402 | CAT(NAME,_generic_stat_arch_elt),\ | |
403 | CAT(NAME,_sizeof_headers),\ | |
404 | CAT(NAME,_bfd_debug_info_start),\ | |
405 | CAT(NAME,_bfd_debug_info_end),\ | |
406 | CAT(NAME,_bfd_debug_info_accumulate),\ | |
407 | CAT(NAME,_bfd_get_relocated_section_contents),\ | |
408 | CAT(NAME,_bfd_relax_section),\ | |
409 | CAT(NAME,_bfd_seclet_link),\ | |
410 | CAT(NAME,_bfd_reloc_type_lookup),\ | |
411 | CAT(NAME,_bfd_make_debug_symbol) | |
412 | ||
413 | #define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table | |
414 | ||
415 | \f | |
416 | /* User program access to BFD facilities */ | |
417 | ||
fdcb0453 KR |
418 | /* Cast from const char * to char * so that caller can assign to |
419 | a char * without a warning. */ | |
420 | #define bfd_get_filename(abfd) ((char *) (abfd)->filename) | |
421 | #define bfd_get_format(abfd) ((abfd)->format) | |
422 | #define bfd_get_target(abfd) ((abfd)->xvec->name) | |
9e461dac | 423 | #define bfd_get_flavour(abfd) ((abfd)->xvec->flavour) |
fdcb0453 KR |
424 | #define bfd_get_file_flags(abfd) ((abfd)->flags) |
425 | #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags) | |
426 | #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags) | |
427 | #define bfd_my_archive(abfd) ((abfd)->my_archive) | |
428 | #define bfd_has_map(abfd) ((abfd)->has_armap) | |
fdcb0453 KR |
429 | |
430 | #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types) | |
431 | #define bfd_usrdata(abfd) ((abfd)->usrdata) | |
432 | ||
433 | #define bfd_get_start_address(abfd) ((abfd)->start_address) | |
434 | #define bfd_get_symcount(abfd) ((abfd)->symcount) | |
435 | #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols) | |
436 | #define bfd_count_sections(abfd) ((abfd)->section_count) | |
fdcb0453 KR |
437 | |
438 | #define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char) | |
439 | ||
2b91cc45 SG |
440 | /* Byte swapping routines. */ |
441 | ||
442 | bfd_vma bfd_getb64 PARAMS ((unsigned char *)); | |
443 | bfd_vma bfd_getl64 PARAMS ((unsigned char *)); | |
444 | bfd_signed_vma bfd_getb_signed_64 PARAMS ((unsigned char *)); | |
445 | bfd_signed_vma bfd_getl_signed_64 PARAMS ((unsigned char *)); | |
446 | bfd_vma bfd_getb32 PARAMS ((unsigned char *)); | |
447 | bfd_vma bfd_getl32 PARAMS ((unsigned char *)); | |
448 | bfd_signed_vma bfd_getb_signed_32 PARAMS ((unsigned char *)); | |
449 | bfd_signed_vma bfd_getl_signed_32 PARAMS ((unsigned char *)); | |
450 | bfd_vma bfd_getb16 PARAMS ((unsigned char *)); | |
451 | bfd_vma bfd_getl16 PARAMS ((unsigned char *)); | |
452 | bfd_signed_vma bfd_getb_signed_16 PARAMS ((unsigned char *)); | |
453 | bfd_signed_vma bfd_getl_signed_16 PARAMS ((unsigned char *)); | |
454 | void bfd_putb64 PARAMS ((bfd_vma, unsigned char *)); | |
455 | void bfd_putl64 PARAMS ((bfd_vma, unsigned char *)); | |
456 | void bfd_putb32 PARAMS ((bfd_vma, unsigned char *)); | |
457 | void bfd_putl32 PARAMS ((bfd_vma, unsigned char *)); | |
458 | void bfd_putb16 PARAMS ((bfd_vma, unsigned char *)); | |
459 | void bfd_putl16 PARAMS ((bfd_vma, unsigned char *)); | |
460 | ||
fdcb0453 KR |
461 | /* And more from the source. */ |
462 | void | |
463 | bfd_init PARAMS ((void)); | |
464 | ||
465 | bfd * | |
466 | bfd_openr PARAMS ((CONST char *filename, CONST char*target)); | |
467 | ||
468 | bfd * | |
469 | bfd_fdopenr PARAMS ((CONST char *filename, CONST char *target, int fd)); | |
470 | ||
471 | bfd * | |
472 | bfd_openw PARAMS ((CONST char *filename, CONST char *target)); | |
473 | ||
474 | boolean | |
475 | bfd_close PARAMS ((bfd *)); | |
476 | ||
477 | boolean | |
478 | bfd_close_all_done PARAMS ((bfd *)); | |
479 | ||
480 | bfd_size_type | |
481 | bfd_alloc_size PARAMS ((bfd *abfd)); | |
482 | ||
483 | bfd * | |
10bd43a8 | 484 | bfd_create PARAMS ((CONST char *filename, bfd *templ)); |
fdcb0453 KR |
485 | |
486 | ||
487 | /* Byte swapping macros for user section data. */ | |
488 | ||
489 | #define bfd_put_8(abfd, val, ptr) \ | |
490 | (*((unsigned char *)(ptr)) = (unsigned char)val) | |
491 | #define bfd_put_signed_8 \ | |
492 | bfd_put_8 | |
493 | #define bfd_get_8(abfd, ptr) \ | |
494 | (*(unsigned char *)(ptr)) | |
495 | #define bfd_get_signed_8(abfd, ptr) \ | |
496 | ((*(unsigned char *)(ptr) ^ 0x80) - 0x80) | |
497 | ||
498 | #define bfd_put_16(abfd, val, ptr) \ | |
499 | BFD_SEND(abfd, bfd_putx16, ((val),(ptr))) | |
500 | #define bfd_put_signed_16 \ | |
501 | bfd_put_16 | |
502 | #define bfd_get_16(abfd, ptr) \ | |
503 | BFD_SEND(abfd, bfd_getx16, (ptr)) | |
504 | #define bfd_get_signed_16(abfd, ptr) \ | |
505 | BFD_SEND (abfd, bfd_getx_signed_16, (ptr)) | |
506 | ||
507 | #define bfd_put_32(abfd, val, ptr) \ | |
508 | BFD_SEND(abfd, bfd_putx32, ((val),(ptr))) | |
509 | #define bfd_put_signed_32 \ | |
510 | bfd_put_32 | |
511 | #define bfd_get_32(abfd, ptr) \ | |
512 | BFD_SEND(abfd, bfd_getx32, (ptr)) | |
513 | #define bfd_get_signed_32(abfd, ptr) \ | |
514 | BFD_SEND(abfd, bfd_getx_signed_32, (ptr)) | |
515 | ||
516 | #define bfd_put_64(abfd, val, ptr) \ | |
517 | BFD_SEND(abfd, bfd_putx64, ((val), (ptr))) | |
518 | #define bfd_put_signed_64 \ | |
519 | bfd_put_64 | |
520 | #define bfd_get_64(abfd, ptr) \ | |
521 | BFD_SEND(abfd, bfd_getx64, (ptr)) | |
522 | #define bfd_get_signed_64(abfd, ptr) \ | |
523 | BFD_SEND(abfd, bfd_getx_signed_64, (ptr)) | |
524 | ||
525 | ||
526 | /* Byte swapping macros for file header data. */ | |
527 | ||
528 | #define bfd_h_put_8(abfd, val, ptr) \ | |
529 | bfd_put_8 (abfd, val, ptr) | |
530 | #define bfd_h_put_signed_8(abfd, val, ptr) \ | |
531 | bfd_put_8 (abfd, val, ptr) | |
532 | #define bfd_h_get_8(abfd, ptr) \ | |
533 | bfd_get_8 (abfd, ptr) | |
534 | #define bfd_h_get_signed_8(abfd, ptr) \ | |
535 | bfd_get_signed_8 (abfd, ptr) | |
536 | ||
537 | #define bfd_h_put_16(abfd, val, ptr) \ | |
538 | BFD_SEND(abfd, bfd_h_putx16,(val,ptr)) | |
539 | #define bfd_h_put_signed_16 \ | |
540 | bfd_h_put_16 | |
541 | #define bfd_h_get_16(abfd, ptr) \ | |
542 | BFD_SEND(abfd, bfd_h_getx16,(ptr)) | |
543 | #define bfd_h_get_signed_16(abfd, ptr) \ | |
544 | BFD_SEND(abfd, bfd_h_getx_signed_16, (ptr)) | |
545 | ||
546 | #define bfd_h_put_32(abfd, val, ptr) \ | |
547 | BFD_SEND(abfd, bfd_h_putx32,(val,ptr)) | |
548 | #define bfd_h_put_signed_32 \ | |
549 | bfd_h_put_32 | |
550 | #define bfd_h_get_32(abfd, ptr) \ | |
551 | BFD_SEND(abfd, bfd_h_getx32,(ptr)) | |
552 | #define bfd_h_get_signed_32(abfd, ptr) \ | |
553 | BFD_SEND(abfd, bfd_h_getx_signed_32, (ptr)) | |
554 | ||
555 | #define bfd_h_put_64(abfd, val, ptr) \ | |
556 | BFD_SEND(abfd, bfd_h_putx64,(val, ptr)) | |
557 | #define bfd_h_put_signed_64 \ | |
558 | bfd_h_put_64 | |
559 | #define bfd_h_get_64(abfd, ptr) \ | |
560 | BFD_SEND(abfd, bfd_h_getx64,(ptr)) | |
561 | #define bfd_h_get_signed_64(abfd, ptr) \ | |
562 | BFD_SEND(abfd, bfd_h_getx_signed_64, (ptr)) | |
563 | ||
564 | typedef struct sec | |
565 | { | |
566 | /* The name of the section, the name isn't a copy, the pointer is | |
567 | the same as that passed to bfd_make_section. */ | |
568 | ||
569 | CONST char *name; | |
570 | ||
fdcb0453 KR |
571 | /* Which section is it 0.nth */ |
572 | ||
573 | int index; | |
574 | ||
575 | /* The next section in the list belonging to the BFD, or NULL. */ | |
576 | ||
577 | struct sec *next; | |
578 | ||
579 | /* The field flags contains attributes of the section. Some of | |
580 | flags are read in from the object file, and some are | |
581 | synthesized from other information. */ | |
582 | ||
583 | flagword flags; | |
584 | ||
585 | #define SEC_NO_FLAGS 0x000 | |
586 | ||
587 | /* Tells the OS to allocate space for this section when loaded. | |
588 | This would clear for a section containing debug information | |
589 | only. */ | |
fdcb0453 | 590 | #define SEC_ALLOC 0x001 |
ef758f3e | 591 | |
fdcb0453 KR |
592 | /* Tells the OS to load the section from the file when loading. |
593 | This would be clear for a .bss section */ | |
fdcb0453 | 594 | #define SEC_LOAD 0x002 |
ef758f3e | 595 | |
fdcb0453 KR |
596 | /* The section contains data still to be relocated, so there will |
597 | be some relocation information too. */ | |
fdcb0453 KR |
598 | #define SEC_RELOC 0x004 |
599 | ||
b2ae9efb | 600 | #if 0 /* Obsolete ? */ |
fdcb0453 | 601 | #define SEC_BALIGN 0x008 |
b2ae9efb | 602 | #endif |
fdcb0453 KR |
603 | |
604 | /* A signal to the OS that the section contains read only | |
605 | data. */ | |
606 | #define SEC_READONLY 0x010 | |
607 | ||
608 | /* The section contains code only. */ | |
fdcb0453 KR |
609 | #define SEC_CODE 0x020 |
610 | ||
611 | /* The section contains data only. */ | |
b2ae9efb | 612 | #define SEC_DATA 0x040 |
fdcb0453 KR |
613 | |
614 | /* The section will reside in ROM. */ | |
fdcb0453 KR |
615 | #define SEC_ROM 0x080 |
616 | ||
617 | /* The section contains constructor information. This section | |
618 | type is used by the linker to create lists of constructors and | |
619 | destructors used by <<g++>>. When a back end sees a symbol | |
620 | which should be used in a constructor list, it creates a new | |
621 | section for the type of name (eg <<__CTOR_LIST__>>), attaches | |
622 | the symbol to it and builds a relocation. To build the lists | |
bc750ff1 | 623 | of constructors, all the linker has to do is catenate all the |
fdcb0453 KR |
624 | sections called <<__CTOR_LIST__>> and relocte the data |
625 | contained within - exactly the operations it would peform on | |
626 | standard data. */ | |
fdcb0453 KR |
627 | #define SEC_CONSTRUCTOR 0x100 |
628 | ||
629 | /* The section is a constuctor, and should be placed at the | |
b2ae9efb | 630 | end of the text, data, or bss section(?). */ |
fdcb0453 | 631 | #define SEC_CONSTRUCTOR_TEXT 0x1100 |
fdcb0453 | 632 | #define SEC_CONSTRUCTOR_DATA 0x2100 |
fdcb0453 KR |
633 | #define SEC_CONSTRUCTOR_BSS 0x3100 |
634 | ||
635 | /* The section has contents - a data section could be | |
636 | <<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>, a debug section could be | |
637 | <<SEC_HAS_CONTENTS>> */ | |
fdcb0453 KR |
638 | #define SEC_HAS_CONTENTS 0x200 |
639 | ||
640 | /* An instruction to the linker not to output sections | |
641 | containing this flag even if they have information which | |
642 | would normally be written. */ | |
fdcb0453 KR |
643 | #define SEC_NEVER_LOAD 0x400 |
644 | ||
645 | /* The section is a shared library section. The linker must leave | |
646 | these completely alone, as the vma and size are used when | |
647 | the executable is loaded. */ | |
fdcb0453 KR |
648 | #define SEC_SHARED_LIBRARY 0x800 |
649 | ||
650 | /* The section is a common section (symbols may be defined | |
651 | multiple times, the value of a symbol is the amount of | |
652 | space it requires, and the largest symbol value is the one | |
b2ae9efb KR |
653 | used). Most targets have exactly one of these (which we |
654 | translate to bfd_com_section), but ECOFF has two. */ | |
fdcb0453 KR |
655 | #define SEC_IS_COMMON 0x8000 |
656 | ||
9b3fa589 JK |
657 | /* The section contains only debugging information. For |
658 | example, this is set for ELF .debug and .stab sections. | |
659 | strip tests this flag to see if a section can be | |
660 | discarded. */ | |
661 | #define SEC_DEBUGGING 0x10000 | |
662 | ||
b2ae9efb KR |
663 | /* End of section flags. */ |
664 | ||
fdcb0453 | 665 | /* The virtual memory address of the section - where it will be |
b2ae9efb KR |
666 | at run time. The symbols are relocated against this. The |
667 | user_set_vma flag is maintained by bfd; if it's not set, the | |
668 | backend can assign addresses (for example, in <<a.out>>, where | |
669 | the default address for <<.data>> is dependent on the specific | |
670 | target and various flags). */ | |
ef758f3e | 671 | |
fdcb0453 | 672 | bfd_vma vma; |
b2ae9efb | 673 | boolean user_set_vma; |
fdcb0453 KR |
674 | |
675 | /* The load address of the section - where it would be in a | |
b2ae9efb KR |
676 | rom image, really only used for writing section header |
677 | information. */ | |
ef758f3e | 678 | |
fdcb0453 KR |
679 | bfd_vma lma; |
680 | ||
fdcb0453 KR |
681 | /* The size of the section in bytes, as it will be output. |
682 | contains a value even if the section has no contents (eg, the | |
683 | size of <<.bss>>). This will be filled in after relocation */ | |
684 | ||
685 | bfd_size_type _cooked_size; | |
686 | ||
687 | /* The size on disk of the section in bytes originally. Normally this | |
688 | value is the same as the size, but if some relaxing has | |
689 | been done, then this value will be bigger. */ | |
690 | ||
691 | bfd_size_type _raw_size; | |
692 | ||
693 | /* If this section is going to be output, then this value is the | |
694 | offset into the output section of the first byte in the input | |
695 | section. Eg, if this was going to start at the 100th byte in | |
696 | the output section, this value would be 100. */ | |
697 | ||
698 | bfd_vma output_offset; | |
699 | ||
700 | /* The output section through which to map on output. */ | |
701 | ||
702 | struct sec *output_section; | |
703 | ||
704 | /* The alignment requirement of the section, as an exponent - eg | |
705 | 3 aligns to 2^3 (or 8) */ | |
706 | ||
707 | unsigned int alignment_power; | |
708 | ||
709 | /* If an input section, a pointer to a vector of relocation | |
710 | records for the data in this section. */ | |
711 | ||
712 | struct reloc_cache_entry *relocation; | |
713 | ||
714 | /* If an output section, a pointer to a vector of pointers to | |
715 | relocation records for the data in this section. */ | |
716 | ||
717 | struct reloc_cache_entry **orelocation; | |
718 | ||
719 | /* The number of relocation records in one of the above */ | |
720 | ||
721 | unsigned reloc_count; | |
722 | ||
723 | /* Information below is back end specific - and not always used | |
ef758f3e | 724 | or updated. */ |
fdcb0453 | 725 | |
ef758f3e | 726 | /* File position of section data */ |
fdcb0453 KR |
727 | |
728 | file_ptr filepos; | |
729 | ||
730 | /* File position of relocation info */ | |
731 | ||
732 | file_ptr rel_filepos; | |
733 | ||
734 | /* File position of line data */ | |
735 | ||
736 | file_ptr line_filepos; | |
737 | ||
738 | /* Pointer to data for applications */ | |
739 | ||
740 | PTR userdata; | |
741 | ||
742 | struct lang_output_section *otheruserdata; | |
743 | ||
744 | /* Attached line number information */ | |
745 | ||
746 | alent *lineno; | |
747 | ||
748 | /* Number of line number records */ | |
749 | ||
750 | unsigned int lineno_count; | |
751 | ||
752 | /* When a section is being output, this value changes as more | |
753 | linenumbers are written out */ | |
754 | ||
755 | file_ptr moving_line_filepos; | |
756 | ||
757 | /* what the section number is in the target world */ | |
758 | ||
759 | int target_index; | |
760 | ||
761 | PTR used_by_bfd; | |
762 | ||
763 | /* If this is a constructor section then here is a list of the | |
764 | relocations created to relocate items within it. */ | |
765 | ||
766 | struct relent_chain *constructor_chain; | |
767 | ||
768 | /* The BFD which owns the section. */ | |
769 | ||
770 | bfd *owner; | |
771 | ||
772 | boolean reloc_done; | |
773 | /* A symbol which points at this section only */ | |
774 | struct symbol_cache_entry *symbol; | |
775 | struct symbol_cache_entry **symbol_ptr_ptr; | |
ef758f3e | 776 | |
fdcb0453 KR |
777 | struct bfd_seclet *seclets_head; |
778 | struct bfd_seclet *seclets_tail; | |
779 | } asection ; | |
780 | ||
781 | ||
b2ae9efb KR |
782 | /* These sections are global, and are managed by BFD. The application |
783 | and target back end are not permitted to change the values in | |
784 | these sections. */ | |
fdcb0453 KR |
785 | #define BFD_ABS_SECTION_NAME "*ABS*" |
786 | #define BFD_UND_SECTION_NAME "*UND*" | |
787 | #define BFD_COM_SECTION_NAME "*COM*" | |
788 | #define BFD_IND_SECTION_NAME "*IND*" | |
789 | ||
790 | /* the absolute section */ | |
ef758f3e | 791 | extern asection bfd_abs_section; |
fdcb0453 | 792 | /* Pointer to the undefined section */ |
ef758f3e | 793 | extern asection bfd_und_section; |
fdcb0453 | 794 | /* Pointer to the common section */ |
ef758f3e | 795 | extern asection bfd_com_section; |
fdcb0453 | 796 | /* Pointer to the indirect section */ |
ef758f3e | 797 | extern asection bfd_ind_section; |
fdcb0453 | 798 | |
ef758f3e KR |
799 | extern struct symbol_cache_entry *bfd_abs_symbol; |
800 | extern struct symbol_cache_entry *bfd_com_symbol; | |
801 | extern struct symbol_cache_entry *bfd_und_symbol; | |
802 | extern struct symbol_cache_entry *bfd_ind_symbol; | |
fdcb0453 KR |
803 | #define bfd_get_section_size_before_reloc(section) \ |
804 | (section->reloc_done ? (abort(),1): (section)->_raw_size) | |
805 | #define bfd_get_section_size_after_reloc(section) \ | |
806 | ((section->reloc_done) ? (section)->_cooked_size: (abort(),1)) | |
807 | asection * | |
808 | bfd_get_section_by_name PARAMS ((bfd *abfd, CONST char *name)); | |
809 | ||
810 | asection * | |
811 | bfd_make_section_old_way PARAMS ((bfd *, CONST char *name)); | |
812 | ||
9b3fa589 JK |
813 | asection * |
814 | bfd_make_section_anyway PARAMS ((bfd *, CONST char *name)); | |
815 | ||
816 | asection * | |
fdcb0453 KR |
817 | bfd_make_section PARAMS ((bfd *, CONST char *name)); |
818 | ||
819 | boolean | |
820 | bfd_set_section_flags PARAMS ((bfd *, asection *, flagword)); | |
821 | ||
822 | void | |
823 | bfd_map_over_sections PARAMS ((bfd *abfd, | |
824 | void (*func)(bfd *abfd, | |
825 | asection *sect, | |
826 | PTR obj), | |
827 | PTR obj)); | |
828 | ||
829 | boolean | |
830 | bfd_set_section_size PARAMS ((bfd *, asection *, bfd_size_type val)); | |
831 | ||
832 | boolean | |
833 | bfd_set_section_contents | |
834 | PARAMS ((bfd *abfd, | |
835 | asection *section, | |
836 | PTR data, | |
837 | file_ptr offset, | |
838 | bfd_size_type count)); | |
839 | ||
840 | boolean | |
841 | bfd_get_section_contents | |
842 | PARAMS ((bfd *abfd, asection *section, PTR location, | |
843 | file_ptr offset, bfd_size_type count)); | |
844 | ||
845 | enum bfd_architecture | |
846 | { | |
847 | bfd_arch_unknown, /* File arch not known */ | |
848 | bfd_arch_obscure, /* Arch known, not one of these */ | |
849 | bfd_arch_m68k, /* Motorola 68xxx */ | |
850 | bfd_arch_vax, /* DEC Vax */ | |
851 | bfd_arch_i960, /* Intel 960 */ | |
852 | /* The order of the following is important. | |
853 | lower number indicates a machine type that | |
854 | only accepts a subset of the instructions | |
855 | available to machines with higher numbers. | |
856 | The exception is the "ca", which is | |
857 | incompatible with all other machines except | |
858 | "core". */ | |
859 | ||
860 | #define bfd_mach_i960_core 1 | |
861 | #define bfd_mach_i960_ka_sa 2 | |
862 | #define bfd_mach_i960_kb_sb 3 | |
863 | #define bfd_mach_i960_mc 4 | |
864 | #define bfd_mach_i960_xa 5 | |
865 | #define bfd_mach_i960_ca 6 | |
866 | ||
867 | bfd_arch_a29k, /* AMD 29000 */ | |
868 | bfd_arch_sparc, /* SPARC */ | |
869 | bfd_arch_mips, /* MIPS Rxxxx */ | |
870 | bfd_arch_i386, /* Intel 386 */ | |
871 | bfd_arch_we32k, /* AT&T WE32xxx */ | |
872 | bfd_arch_tahoe, /* CCI/Harris Tahoe */ | |
873 | bfd_arch_i860, /* Intel 860 */ | |
874 | bfd_arch_romp, /* IBM ROMP PC/RT */ | |
875 | bfd_arch_alliant, /* Alliant */ | |
876 | bfd_arch_convex, /* Convex */ | |
877 | bfd_arch_m88k, /* Motorola 88xxx */ | |
878 | bfd_arch_pyramid, /* Pyramid Technology */ | |
879 | bfd_arch_h8300, /* Hitachi H8/300 */ | |
880 | #define bfd_mach_h8300 1 | |
881 | #define bfd_mach_h8300h 2 | |
882 | bfd_arch_rs6000, /* IBM RS/6000 */ | |
883 | bfd_arch_hppa, /* HP PA RISC */ | |
884 | bfd_arch_z8k, /* Zilog Z8000 */ | |
885 | #define bfd_mach_z8001 1 | |
886 | #define bfd_mach_z8002 2 | |
887 | bfd_arch_h8500, /* Hitachi H8/500 */ | |
888 | bfd_arch_sh, /* Hitachi SH */ | |
889 | bfd_arch_alpha, /* Dec Alpha */ | |
890 | bfd_arch_last | |
891 | }; | |
892 | ||
893 | typedef struct bfd_arch_info | |
894 | { | |
895 | int bits_per_word; | |
896 | int bits_per_address; | |
897 | int bits_per_byte; | |
898 | enum bfd_architecture arch; | |
899 | long mach; | |
900 | char *arch_name; | |
901 | CONST char *printable_name; | |
902 | unsigned int section_align_power; | |
903 | /* true if this is the default machine for the architecture */ | |
904 | boolean the_default; | |
905 | CONST struct bfd_arch_info * (*compatible) | |
906 | PARAMS ((CONST struct bfd_arch_info *a, | |
907 | CONST struct bfd_arch_info *b)); | |
908 | ||
909 | boolean (*scan) PARAMS ((CONST struct bfd_arch_info *, CONST char *)); | |
910 | /* How to disassemble an instruction, producing a printable | |
911 | representation on a specified stdio stream. This isn't | |
912 | defined for most processors at present, because of the size | |
913 | of the additional tables it would drag in, and because gdb | |
914 | wants to use a different interface. */ | |
915 | unsigned int (*disassemble) PARAMS ((bfd_vma addr, CONST char *data, | |
916 | PTR stream)); | |
917 | ||
918 | struct bfd_arch_info *next; | |
919 | } bfd_arch_info_type; | |
920 | CONST char * | |
921 | bfd_printable_name PARAMS ((bfd *abfd)); | |
922 | ||
923 | bfd_arch_info_type * | |
924 | bfd_scan_arch PARAMS ((CONST char *)); | |
925 | ||
926 | CONST bfd_arch_info_type * | |
927 | bfd_arch_get_compatible PARAMS (( | |
928 | CONST bfd *abfd, | |
929 | CONST bfd *bbfd)); | |
930 | ||
931 | void | |
932 | bfd_set_arch_info PARAMS ((bfd *, bfd_arch_info_type *)); | |
933 | ||
934 | enum bfd_architecture | |
935 | bfd_get_arch PARAMS ((bfd *abfd)); | |
936 | ||
937 | unsigned long | |
938 | bfd_get_mach PARAMS ((bfd *abfd)); | |
939 | ||
940 | unsigned int | |
941 | bfd_arch_bits_per_byte PARAMS ((bfd *abfd)); | |
942 | ||
943 | unsigned int | |
944 | bfd_arch_bits_per_address PARAMS ((bfd *abfd)); | |
945 | ||
946 | bfd_arch_info_type * | |
947 | bfd_get_arch_info PARAMS ((bfd *)); | |
948 | ||
949 | bfd_arch_info_type * | |
950 | bfd_lookup_arch | |
951 | PARAMS ((enum bfd_architecture | |
952 | arch, | |
953 | long machine)); | |
954 | ||
955 | CONST char * | |
956 | bfd_printable_arch_mach | |
957 | PARAMS ((enum bfd_architecture arch, unsigned long machine)); | |
958 | ||
959 | typedef enum bfd_reloc_status | |
960 | { | |
961 | /* No errors detected */ | |
962 | bfd_reloc_ok, | |
963 | ||
964 | /* The relocation was performed, but there was an overflow. */ | |
965 | bfd_reloc_overflow, | |
966 | ||
967 | /* The address to relocate was not within the section supplied. */ | |
968 | bfd_reloc_outofrange, | |
969 | ||
970 | /* Used by special functions */ | |
971 | bfd_reloc_continue, | |
972 | ||
973 | /* Unused */ | |
974 | bfd_reloc_notsupported, | |
975 | ||
976 | /* Unsupported relocation size requested. */ | |
977 | bfd_reloc_other, | |
978 | ||
979 | /* The symbol to relocate against was undefined. */ | |
980 | bfd_reloc_undefined, | |
981 | ||
982 | /* The relocation was performed, but may not be ok - presently | |
983 | generated only when linking i960 coff files with i960 b.out | |
984 | symbols. */ | |
985 | bfd_reloc_dangerous | |
986 | } | |
987 | bfd_reloc_status_type; | |
988 | ||
989 | ||
990 | typedef struct reloc_cache_entry | |
991 | { | |
992 | /* A pointer into the canonical table of pointers */ | |
993 | struct symbol_cache_entry **sym_ptr_ptr; | |
994 | ||
995 | /* offset in section */ | |
996 | bfd_size_type address; | |
997 | ||
998 | /* addend for relocation value */ | |
999 | bfd_vma addend; | |
1000 | ||
1001 | /* Pointer to how to perform the required relocation */ | |
1002 | CONST struct reloc_howto_struct *howto; | |
1003 | ||
1004 | } arelent; | |
66a277ab ILT |
1005 | enum complain_overflow |
1006 | { | |
1007 | /* Do not complain on overflow. */ | |
1008 | complain_overflow_dont, | |
1009 | ||
1010 | /* Complain if the bitfield overflows, whether it is considered | |
1011 | as signed or unsigned. */ | |
1012 | complain_overflow_bitfield, | |
1013 | ||
1014 | /* Complain if the value overflows when considered as signed | |
1015 | number. */ | |
1016 | complain_overflow_signed, | |
1017 | ||
1018 | /* Complain if the value overflows when considered as an | |
1019 | unsigned number. */ | |
1020 | complain_overflow_unsigned | |
1021 | }; | |
fdcb0453 KR |
1022 | |
1023 | typedef CONST struct reloc_howto_struct | |
1024 | { | |
1025 | /* The type field has mainly a documetary use - the back end can | |
1026 | to what it wants with it, though the normally the back end's | |
1027 | external idea of what a reloc number would be would be stored | |
1028 | in this field. For example, the a PC relative word relocation | |
1029 | in a coff environment would have the type 023 - because that's | |
1030 | what the outside world calls a R_PCRWORD reloc. */ | |
1031 | unsigned int type; | |
1032 | ||
1033 | /* The value the final relocation is shifted right by. This drops | |
1034 | unwanted data from the relocation. */ | |
1035 | unsigned int rightshift; | |
1036 | ||
9e461dac JK |
1037 | /* The size of the item to be relocated. This is *not* a |
1038 | power-of-two measure. | |
1039 | 0 : one byte | |
1040 | 1 : two bytes | |
1041 | 2 : four bytes | |
1042 | 3 : nothing done (unless special_function is nonzero) | |
1043 | 4 : eight bytes | |
1044 | -2 : two bytes, result should be subtracted from the | |
1045 | data instead of added | |
1046 | There is currently no trivial way to extract a "number of | |
1047 | bytes" from a howto pointer. */ | |
fdcb0453 KR |
1048 | int size; |
1049 | ||
66a277ab ILT |
1050 | /* The number of bits in the item to be relocated. This is used |
1051 | when doing overflow checking. */ | |
fdcb0453 KR |
1052 | unsigned int bitsize; |
1053 | ||
1054 | /* Notes that the relocation is relative to the location in the | |
1055 | data section of the addend. The relocation function will | |
1056 | subtract from the relocation value the address of the location | |
1057 | being relocated. */ | |
1058 | boolean pc_relative; | |
1059 | ||
66a277ab ILT |
1060 | /* The bit position of the reloc value in the destination. |
1061 | The relocated value is left shifted by this amount. */ | |
fdcb0453 KR |
1062 | unsigned int bitpos; |
1063 | ||
66a277ab ILT |
1064 | /* What type of overflow error should be checked for when |
1065 | relocating. */ | |
1066 | enum complain_overflow complain_on_overflow; | |
fdcb0453 KR |
1067 | |
1068 | /* If this field is non null, then the supplied function is | |
1069 | called rather than the normal function. This allows really | |
1070 | strange relocation methods to be accomodated (e.g., i960 callj | |
1071 | instructions). */ | |
1072 | bfd_reloc_status_type (*special_function) | |
1073 | PARAMS ((bfd *abfd, | |
1074 | arelent *reloc_entry, | |
1075 | struct symbol_cache_entry *symbol, | |
1076 | PTR data, | |
1077 | asection *input_section, | |
1078 | bfd *output_bfd)); | |
1079 | ||
1080 | /* The textual name of the relocation type. */ | |
1081 | char *name; | |
1082 | ||
1083 | /* When performing a partial link, some formats must modify the | |
1084 | relocations rather than the data - this flag signals this.*/ | |
1085 | boolean partial_inplace; | |
1086 | ||
1087 | /* The src_mask is used to select what parts of the read in data | |
1088 | are to be used in the relocation sum. E.g., if this was an 8 bit | |
1089 | bit of data which we read and relocated, this would be | |
1090 | 0x000000ff. When we have relocs which have an addend, such as | |
1091 | sun4 extended relocs, the value in the offset part of a | |
1092 | relocating field is garbage so we never use it. In this case | |
1093 | the mask would be 0x00000000. */ | |
1094 | bfd_vma src_mask; | |
1095 | ||
1096 | /* The dst_mask is what parts of the instruction are replaced | |
1097 | into the instruction. In most cases src_mask == dst_mask, | |
1098 | except in the above special case, where dst_mask would be | |
1099 | 0x000000ff, and src_mask would be 0x00000000. */ | |
1100 | bfd_vma dst_mask; | |
1101 | ||
1102 | /* When some formats create PC relative instructions, they leave | |
1103 | the value of the pc of the place being relocated in the offset | |
1104 | slot of the instruction, so that a PC relative relocation can | |
1105 | be made just by adding in an ordinary offset (e.g., sun3 a.out). | |
1106 | Some formats leave the displacement part of an instruction | |
1107 | empty (e.g., m88k bcs), this flag signals the fact.*/ | |
1108 | boolean pcrel_offset; | |
1109 | ||
1110 | } reloc_howto_type; | |
66a277ab ILT |
1111 | #define HOWTO(C, R,S,B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \ |
1112 | {(unsigned)C,R,S,B, P, BI, O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC} | |
1113 | #define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,complain_overflow_dont,FUNCTION, NAME,false,0,0,IN) | |
fdcb0453 KR |
1114 | |
1115 | #define HOWTO_PREPARE(relocation, symbol) \ | |
1116 | { \ | |
1117 | if (symbol != (asymbol *)NULL) { \ | |
1118 | if (bfd_is_com_section (symbol->section)) { \ | |
1119 | relocation = 0; \ | |
1120 | } \ | |
1121 | else { \ | |
1122 | relocation = symbol->value; \ | |
1123 | } \ | |
1124 | } \ | |
1125 | } | |
1126 | typedef unsigned char bfd_byte; | |
1127 | ||
1128 | typedef struct relent_chain { | |
1129 | arelent relent; | |
1130 | struct relent_chain *next; | |
1131 | } arelent_chain; | |
1132 | bfd_reloc_status_type | |
1133 | ||
1134 | bfd_perform_relocation | |
1135 | PARAMS ((bfd * abfd, | |
1136 | arelent *reloc_entry, | |
1137 | PTR data, | |
1138 | asection *input_section, | |
1139 | bfd *output_bfd)); | |
1140 | ||
1141 | typedef enum bfd_reloc_code_real | |
fdcb0453 | 1142 | { |
9e461dac | 1143 | /* Basic absolute relocations */ |
fa5ba217 | 1144 | BFD_RELOC_64, |
fa5ba217 | 1145 | BFD_RELOC_32, |
fdcb0453 | 1146 | BFD_RELOC_16, |
fdcb0453 | 1147 | BFD_RELOC_8, |
9e461dac JK |
1148 | |
1149 | /* PC-relative relocations */ | |
1150 | BFD_RELOC_64_PCREL, | |
1151 | BFD_RELOC_32_PCREL, | |
1152 | BFD_RELOC_24_PCREL, /* used by i960 */ | |
1153 | BFD_RELOC_16_PCREL, | |
fdcb0453 | 1154 | BFD_RELOC_8_PCREL, |
9e461dac JK |
1155 | |
1156 | /* Linkage-table relative */ | |
1157 | BFD_RELOC_32_BASEREL, | |
1158 | BFD_RELOC_16_BASEREL, | |
1159 | BFD_RELOC_8_BASEREL, | |
fdcb0453 | 1160 | |
ef758f3e KR |
1161 | /* The type of reloc used to build a contructor table - at the moment |
1162 | probably a 32 bit wide abs address, but the cpu can choose. */ | |
fdcb0453 KR |
1163 | BFD_RELOC_CTOR, |
1164 | ||
9e461dac JK |
1165 | /* 8 bits wide, but used to form an address like 0xffnn */ |
1166 | BFD_RELOC_8_FFnn, | |
1167 | ||
1168 | /* 32-bit pc-relative, shifted right 2 bits (i.e., 30-bit | |
1169 | word displacement, e.g. for SPARC) */ | |
1170 | BFD_RELOC_32_PCREL_S2, | |
1171 | ||
1172 | /* High 22 bits of 32-bit value, placed into lower 22 bits of | |
1173 | target word; simple reloc. */ | |
fdcb0453 | 1174 | BFD_RELOC_HI22, |
ef758f3e | 1175 | /* Low 10 bits. */ |
fdcb0453 KR |
1176 | BFD_RELOC_LO10, |
1177 | ||
ef758f3e | 1178 | /* Reloc types used for i960/b.out. */ |
fdcb0453 KR |
1179 | BFD_RELOC_I960_CALLJ, |
1180 | ||
fdcb0453 KR |
1181 | /* now for the sparc/elf codes */ |
1182 | BFD_RELOC_NONE, /* actually used */ | |
1183 | BFD_RELOC_SPARC_WDISP22, | |
1184 | BFD_RELOC_SPARC22, | |
1185 | BFD_RELOC_SPARC13, | |
fdcb0453 KR |
1186 | BFD_RELOC_SPARC_GOT10, |
1187 | BFD_RELOC_SPARC_GOT13, | |
1188 | BFD_RELOC_SPARC_GOT22, | |
1189 | BFD_RELOC_SPARC_PC10, | |
1190 | BFD_RELOC_SPARC_PC22, | |
1191 | BFD_RELOC_SPARC_WPLT30, | |
1192 | BFD_RELOC_SPARC_COPY, | |
1193 | BFD_RELOC_SPARC_GLOB_DAT, | |
1194 | BFD_RELOC_SPARC_JMP_SLOT, | |
1195 | BFD_RELOC_SPARC_RELATIVE, | |
1196 | BFD_RELOC_SPARC_UA32, | |
1197 | ||
ef758f3e | 1198 | /* these are a.out specific? */ |
5284a822 | 1199 | BFD_RELOC_SPARC_BASE13, |
fdcb0453 KR |
1200 | BFD_RELOC_SPARC_BASE22, |
1201 | ||
fa5ba217 | 1202 | /* start-sanitize-v9 */ |
fa5ba217 KR |
1203 | BFD_RELOC_SPARC_10, |
1204 | BFD_RELOC_SPARC_11, | |
1205 | #define BFD_RELOC_SPARC_64 BFD_RELOC_64 | |
1206 | BFD_RELOC_SPARC_OLO10, | |
1207 | BFD_RELOC_SPARC_HH22, | |
1208 | BFD_RELOC_SPARC_HM10, | |
1209 | BFD_RELOC_SPARC_LM22, | |
1210 | BFD_RELOC_SPARC_PC_HH22, | |
1211 | BFD_RELOC_SPARC_PC_HM10, | |
1212 | BFD_RELOC_SPARC_PC_LM22, | |
1213 | BFD_RELOC_SPARC_WDISP16, | |
5284a822 | 1214 | BFD_RELOC_SPARC_WDISP19, |
fa5ba217 KR |
1215 | BFD_RELOC_SPARC_GLOB_JMP, |
1216 | BFD_RELOC_SPARC_LO7, | |
1217 | /* end-sanitize-v9 */ | |
5284a822 | 1218 | |
ef758f3e KR |
1219 | /* Bits 27..2 of the relocation address shifted right 2 bits; |
1220 | simple reloc otherwise. */ | |
fdcb0453 KR |
1221 | BFD_RELOC_MIPS_JMP, |
1222 | ||
ef758f3e | 1223 | /* signed 16-bit pc-relative, shifted right 2 bits (e.g. for MIPS) */ |
fdcb0453 KR |
1224 | BFD_RELOC_16_PCREL_S2, |
1225 | ||
ef758f3e | 1226 | /* High 16 bits of 32-bit value; simple reloc. */ |
fdcb0453 | 1227 | BFD_RELOC_HI16, |
ef758f3e KR |
1228 | /* High 16 bits of 32-bit value but the low 16 bits will be sign |
1229 | extended and added to form the final result. If the low 16 | |
1230 | bits form a negative number, we need to add one to the high value | |
1231 | to compensate for the borrow when the low bits are added. */ | |
fdcb0453 | 1232 | BFD_RELOC_HI16_S, |
ef758f3e | 1233 | /* Low 16 bits. */ |
fdcb0453 KR |
1234 | BFD_RELOC_LO16, |
1235 | ||
ef758f3e | 1236 | /* 16 bit relocation relative to the global pointer. */ |
fdcb0453 KR |
1237 | BFD_RELOC_MIPS_GPREL, |
1238 | ||
ef758f3e KR |
1239 | /* These are, so far, specific to HPPA processors. I'm not sure that some |
1240 | don't duplicate other reloc types, such as BFD_RELOC_32 and _32_PCREL. | |
1241 | Also, many more were in the list I got that don't fit in well in the | |
1242 | model BFD uses, so I've omitted them for now. If we do make this reloc | |
1243 | type get used for code that really does implement the funky reloc types, | |
1244 | they'll have to be added to this list. */ | |
fdcb0453 KR |
1245 | BFD_RELOC_HPPA_32, |
1246 | BFD_RELOC_HPPA_11, | |
1247 | BFD_RELOC_HPPA_14, | |
1248 | BFD_RELOC_HPPA_17, | |
ef758f3e | 1249 | |
fdcb0453 KR |
1250 | BFD_RELOC_HPPA_L21, |
1251 | BFD_RELOC_HPPA_R11, | |
1252 | BFD_RELOC_HPPA_R14, | |
1253 | BFD_RELOC_HPPA_R17, | |
1254 | BFD_RELOC_HPPA_LS21, | |
1255 | BFD_RELOC_HPPA_RS11, | |
1256 | BFD_RELOC_HPPA_RS14, | |
1257 | BFD_RELOC_HPPA_RS17, | |
1258 | BFD_RELOC_HPPA_LD21, | |
1259 | BFD_RELOC_HPPA_RD11, | |
1260 | BFD_RELOC_HPPA_RD14, | |
1261 | BFD_RELOC_HPPA_RD17, | |
1262 | BFD_RELOC_HPPA_LR21, | |
1263 | BFD_RELOC_HPPA_RR14, | |
1264 | BFD_RELOC_HPPA_RR17, | |
ef758f3e | 1265 | |
fdcb0453 KR |
1266 | BFD_RELOC_HPPA_GOTOFF_11, |
1267 | BFD_RELOC_HPPA_GOTOFF_14, | |
1268 | BFD_RELOC_HPPA_GOTOFF_L21, | |
1269 | BFD_RELOC_HPPA_GOTOFF_R11, | |
1270 | BFD_RELOC_HPPA_GOTOFF_R14, | |
1271 | BFD_RELOC_HPPA_GOTOFF_LS21, | |
1272 | BFD_RELOC_HPPA_GOTOFF_RS11, | |
1273 | BFD_RELOC_HPPA_GOTOFF_RS14, | |
1274 | BFD_RELOC_HPPA_GOTOFF_LD21, | |
1275 | BFD_RELOC_HPPA_GOTOFF_RD11, | |
1276 | BFD_RELOC_HPPA_GOTOFF_RD14, | |
1277 | BFD_RELOC_HPPA_GOTOFF_LR21, | |
1278 | BFD_RELOC_HPPA_GOTOFF_RR14, | |
ef758f3e | 1279 | |
fdcb0453 KR |
1280 | BFD_RELOC_HPPA_DLT_32, |
1281 | BFD_RELOC_HPPA_DLT_11, | |
1282 | BFD_RELOC_HPPA_DLT_14, | |
1283 | BFD_RELOC_HPPA_DLT_L21, | |
1284 | BFD_RELOC_HPPA_DLT_R11, | |
1285 | BFD_RELOC_HPPA_DLT_R14, | |
ef758f3e | 1286 | |
fdcb0453 KR |
1287 | BFD_RELOC_HPPA_ABS_CALL_11, |
1288 | BFD_RELOC_HPPA_ABS_CALL_14, | |
1289 | BFD_RELOC_HPPA_ABS_CALL_17, | |
1290 | BFD_RELOC_HPPA_ABS_CALL_L21, | |
1291 | BFD_RELOC_HPPA_ABS_CALL_R11, | |
1292 | BFD_RELOC_HPPA_ABS_CALL_R14, | |
1293 | BFD_RELOC_HPPA_ABS_CALL_R17, | |
1294 | BFD_RELOC_HPPA_ABS_CALL_LS21, | |
1295 | BFD_RELOC_HPPA_ABS_CALL_RS11, | |
1296 | BFD_RELOC_HPPA_ABS_CALL_RS14, | |
1297 | BFD_RELOC_HPPA_ABS_CALL_RS17, | |
1298 | BFD_RELOC_HPPA_ABS_CALL_LD21, | |
1299 | BFD_RELOC_HPPA_ABS_CALL_RD11, | |
1300 | BFD_RELOC_HPPA_ABS_CALL_RD14, | |
1301 | BFD_RELOC_HPPA_ABS_CALL_RD17, | |
1302 | BFD_RELOC_HPPA_ABS_CALL_LR21, | |
1303 | BFD_RELOC_HPPA_ABS_CALL_RR14, | |
1304 | BFD_RELOC_HPPA_ABS_CALL_RR17, | |
ef758f3e | 1305 | |
fdcb0453 KR |
1306 | BFD_RELOC_HPPA_PCREL_CALL_11, |
1307 | BFD_RELOC_HPPA_PCREL_CALL_12, | |
1308 | BFD_RELOC_HPPA_PCREL_CALL_14, | |
1309 | BFD_RELOC_HPPA_PCREL_CALL_17, | |
1310 | BFD_RELOC_HPPA_PCREL_CALL_L21, | |
1311 | BFD_RELOC_HPPA_PCREL_CALL_R11, | |
1312 | BFD_RELOC_HPPA_PCREL_CALL_R14, | |
1313 | BFD_RELOC_HPPA_PCREL_CALL_R17, | |
1314 | BFD_RELOC_HPPA_PCREL_CALL_LS21, | |
1315 | BFD_RELOC_HPPA_PCREL_CALL_RS11, | |
1316 | BFD_RELOC_HPPA_PCREL_CALL_RS14, | |
1317 | BFD_RELOC_HPPA_PCREL_CALL_RS17, | |
1318 | BFD_RELOC_HPPA_PCREL_CALL_LD21, | |
1319 | BFD_RELOC_HPPA_PCREL_CALL_RD11, | |
1320 | BFD_RELOC_HPPA_PCREL_CALL_RD14, | |
1321 | BFD_RELOC_HPPA_PCREL_CALL_RD17, | |
1322 | BFD_RELOC_HPPA_PCREL_CALL_LR21, | |
1323 | BFD_RELOC_HPPA_PCREL_CALL_RR14, | |
1324 | BFD_RELOC_HPPA_PCREL_CALL_RR17, | |
ef758f3e | 1325 | |
fdcb0453 KR |
1326 | BFD_RELOC_HPPA_PLABEL_32, |
1327 | BFD_RELOC_HPPA_PLABEL_11, | |
1328 | BFD_RELOC_HPPA_PLABEL_14, | |
1329 | BFD_RELOC_HPPA_PLABEL_L21, | |
1330 | BFD_RELOC_HPPA_PLABEL_R11, | |
1331 | BFD_RELOC_HPPA_PLABEL_R14, | |
ef758f3e | 1332 | |
fdcb0453 KR |
1333 | BFD_RELOC_HPPA_UNWIND_ENTRY, |
1334 | BFD_RELOC_HPPA_UNWIND_ENTRIES, | |
1335 | ||
b66b07a2 KR |
1336 | /* i386/elf relocations */ |
1337 | BFD_RELOC_386_GOT32, | |
1338 | BFD_RELOC_386_PLT32, | |
1339 | BFD_RELOC_386_COPY, | |
1340 | BFD_RELOC_386_GLOB_DAT, | |
1341 | BFD_RELOC_386_JUMP_SLOT, | |
1342 | BFD_RELOC_386_RELATIVE, | |
1343 | BFD_RELOC_386_GOTOFF, | |
1344 | BFD_RELOC_386_GOTPC, | |
1345 | ||
fdcb0453 KR |
1346 | /* this must be the highest numeric value */ |
1347 | BFD_RELOC_UNUSED | |
1348 | } bfd_reloc_code_real_type; | |
1349 | CONST struct reloc_howto_struct * | |
1350 | ||
1351 | bfd_reloc_type_lookup PARAMS ((bfd *abfd, bfd_reloc_code_real_type code)); | |
1352 | ||
ef758f3e | 1353 | |
fdcb0453 KR |
1354 | typedef struct symbol_cache_entry |
1355 | { | |
1356 | /* A pointer to the BFD which owns the symbol. This information | |
1357 | is necessary so that a back end can work out what additional | |
1358 | information (invisible to the application writer) is carried | |
1359 | with the symbol. | |
1360 | ||
1361 | This field is *almost* redundant, since you can use section->owner | |
1362 | instead, except that some symbols point to the global sections | |
1363 | bfd_{abs,com,und}_section. This could be fixed by making | |
1364 | these globals be per-bfd (or per-target-flavor). FIXME. */ | |
1365 | ||
1366 | struct _bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field. */ | |
1367 | ||
1368 | /* The text of the symbol. The name is left alone, and not copied - the | |
1369 | application may not alter it. */ | |
1370 | CONST char *name; | |
1371 | ||
1372 | /* The value of the symbol. This really should be a union of a | |
1373 | numeric value with a pointer, since some flags indicate that | |
1374 | a pointer to another symbol is stored here. */ | |
1375 | symvalue value; | |
1376 | ||
1377 | /* Attributes of a symbol: */ | |
1378 | ||
1379 | #define BSF_NO_FLAGS 0x00 | |
1380 | ||
1381 | /* The symbol has local scope; <<static>> in <<C>>. The value | |
1382 | is the offset into the section of the data. */ | |
1383 | #define BSF_LOCAL 0x01 | |
1384 | ||
1385 | /* The symbol has global scope; initialized data in <<C>>. The | |
1386 | value is the offset into the section of the data. */ | |
1387 | #define BSF_GLOBAL 0x02 | |
1388 | ||
1389 | /* The symbol has global scope, and is exported. The value is | |
1390 | the offset into the section of the data. */ | |
ef758f3e | 1391 | #define BSF_EXPORT BSF_GLOBAL /* no real difference */ |
fdcb0453 KR |
1392 | |
1393 | /* A normal C symbol would be one of: | |
1394 | <<BSF_LOCAL>>, <<BSF_FORT_COMM>>, <<BSF_UNDEFINED>> or | |
ef758f3e | 1395 | <<BSF_GLOBAL>> */ |
fdcb0453 KR |
1396 | |
1397 | /* The symbol is a debugging record. The value has an arbitary | |
1398 | meaning. */ | |
1399 | #define BSF_DEBUGGING 0x08 | |
1400 | ||
1401 | /* The symbol denotes a function entry point. Used in ELF, | |
1402 | perhaps others someday. */ | |
1403 | #define BSF_FUNCTION 0x10 | |
1404 | ||
1405 | /* Used by the linker. */ | |
1406 | #define BSF_KEEP 0x20 | |
1407 | #define BSF_KEEP_G 0x40 | |
1408 | ||
b66b07a2 KR |
1409 | /* A weak global symbol, overridable without warnings by |
1410 | a regular global symbol of the same name. */ | |
fdcb0453 KR |
1411 | #define BSF_WEAK 0x80 |
1412 | ||
1413 | /* This symbol was created to point to a section, e.g. ELF's | |
1414 | STT_SECTION symbols. */ | |
1415 | #define BSF_SECTION_SYM 0x100 | |
1416 | ||
1417 | /* The symbol used to be a common symbol, but now it is | |
1418 | allocated. */ | |
1419 | #define BSF_OLD_COMMON 0x200 | |
1420 | ||
1421 | /* The default value for common data. */ | |
1422 | #define BFD_FORT_COMM_DEFAULT_VALUE 0 | |
1423 | ||
1424 | /* In some files the type of a symbol sometimes alters its | |
1425 | location in an output file - ie in coff a <<ISFCN>> symbol | |
1426 | which is also <<C_EXT>> symbol appears where it was | |
1427 | declared and not at the end of a section. This bit is set | |
1428 | by the target BFD part to convey this information. */ | |
1429 | ||
1430 | #define BSF_NOT_AT_END 0x400 | |
1431 | ||
1432 | /* Signal that the symbol is the label of constructor section. */ | |
1433 | #define BSF_CONSTRUCTOR 0x800 | |
1434 | ||
1435 | /* Signal that the symbol is a warning symbol. If the symbol | |
1436 | is a warning symbol, then the value field (I know this is | |
1437 | tacky) will point to the asymbol which when referenced will | |
1438 | cause the warning. */ | |
1439 | #define BSF_WARNING 0x1000 | |
1440 | ||
1441 | /* Signal that the symbol is indirect. The value of the symbol | |
1442 | is a pointer to an undefined asymbol which contains the | |
1443 | name to use instead. */ | |
1444 | #define BSF_INDIRECT 0x2000 | |
1445 | ||
1446 | /* BSF_FILE marks symbols that contain a file name. This is used | |
1447 | for ELF STT_FILE symbols. */ | |
1448 | #define BSF_FILE 0x4000 | |
1449 | ||
1450 | flagword flags; | |
1451 | ||
1452 | /* A pointer to the section to which this symbol is | |
1453 | relative. This will always be non NULL, there are special | |
1454 | sections for undefined and absolute symbols */ | |
1455 | struct sec *section; | |
1456 | ||
1457 | /* Back end special data. This is being phased out in favour | |
1458 | of making this a union. */ | |
1459 | PTR udata; | |
1460 | ||
1461 | } asymbol; | |
1462 | #define get_symtab_upper_bound(abfd) \ | |
1463 | BFD_SEND (abfd, _get_symtab_upper_bound, (abfd)) | |
1464 | #define bfd_canonicalize_symtab(abfd, location) \ | |
1465 | BFD_SEND (abfd, _bfd_canonicalize_symtab,\ | |
1466 | (abfd, location)) | |
1467 | boolean | |
1468 | bfd_set_symtab PARAMS ((bfd *, asymbol **, unsigned int )); | |
1469 | ||
1470 | void | |
1471 | bfd_print_symbol_vandf PARAMS ((PTR file, asymbol *symbol)); | |
1472 | ||
1473 | #define bfd_make_empty_symbol(abfd) \ | |
1474 | BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd)) | |
1475 | #define bfd_make_debug_symbol(abfd,ptr,size) \ | |
1476 | BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size)) | |
1477 | int | |
1478 | bfd_decode_symclass PARAMS ((asymbol *symbol)); | |
1479 | ||
1480 | void | |
1481 | bfd_symbol_info PARAMS ((asymbol *symbol, symbol_info *ret)); | |
1482 | ||
1483 | struct _bfd | |
1484 | { | |
1485 | /* The filename the application opened the BFD with. */ | |
1486 | CONST char *filename; | |
1487 | ||
1488 | /* A pointer to the target jump table. */ | |
1489 | struct bfd_target *xvec; | |
1490 | ||
1491 | /* To avoid dragging too many header files into every file that | |
1492 | includes `<<bfd.h>>', IOSTREAM has been declared as a "char | |
1493 | *", and MTIME as a "long". Their correct types, to which they | |
1494 | are cast when used, are "FILE *" and "time_t". The iostream | |
1495 | is the result of an fopen on the filename. */ | |
1496 | char *iostream; | |
1497 | ||
1498 | /* Is the file being cached */ | |
1499 | ||
1500 | boolean cacheable; | |
1501 | ||
1502 | /* Marks whether there was a default target specified when the | |
1503 | BFD was opened. This is used to select what matching algorithm | |
1504 | to use to chose the back end. */ | |
1505 | ||
1506 | boolean target_defaulted; | |
1507 | ||
1508 | /* The caching routines use these to maintain a | |
1509 | least-recently-used list of BFDs */ | |
1510 | ||
1511 | struct _bfd *lru_prev, *lru_next; | |
1512 | ||
1513 | /* When a file is closed by the caching routines, BFD retains | |
1514 | state information on the file here: | |
1515 | */ | |
1516 | ||
1517 | file_ptr where; | |
1518 | ||
1519 | /* and here:*/ | |
1520 | ||
1521 | boolean opened_once; | |
1522 | ||
1523 | /* Set if we have a locally maintained mtime value, rather than | |
1524 | getting it from the file each time: */ | |
1525 | ||
1526 | boolean mtime_set; | |
1527 | ||
1528 | /* File modified time, if mtime_set is true: */ | |
1529 | ||
1530 | long mtime; | |
1531 | ||
1532 | /* Reserved for an unimplemented file locking extension.*/ | |
1533 | ||
1534 | int ifd; | |
1535 | ||
1536 | /* The format which belongs to the BFD.*/ | |
1537 | ||
1538 | bfd_format format; | |
1539 | ||
1540 | /* The direction the BFD was opened with*/ | |
1541 | ||
1542 | enum bfd_direction {no_direction = 0, | |
1543 | read_direction = 1, | |
1544 | write_direction = 2, | |
1545 | both_direction = 3} direction; | |
1546 | ||
1547 | /* Format_specific flags*/ | |
1548 | ||
1549 | flagword flags; | |
1550 | ||
1551 | /* Currently my_archive is tested before adding origin to | |
1552 | anything. I believe that this can become always an add of | |
1553 | origin, with origin set to 0 for non archive files. */ | |
1554 | ||
1555 | file_ptr origin; | |
1556 | ||
1557 | /* Remember when output has begun, to stop strange things | |
1558 | happening. */ | |
1559 | boolean output_has_begun; | |
1560 | ||
1561 | /* Pointer to linked list of sections*/ | |
1562 | struct sec *sections; | |
1563 | ||
1564 | /* The number of sections */ | |
1565 | unsigned int section_count; | |
1566 | ||
1567 | /* Stuff only useful for object files: | |
1568 | The start address. */ | |
1569 | bfd_vma start_address; | |
1570 | ||
1571 | /* Used for input and output*/ | |
1572 | unsigned int symcount; | |
1573 | ||
1574 | /* Symbol table for output BFD*/ | |
1575 | struct symbol_cache_entry **outsymbols; | |
1576 | ||
1577 | /* Pointer to structure which contains architecture information*/ | |
1578 | struct bfd_arch_info *arch_info; | |
1579 | ||
1580 | /* Stuff only useful for archives:*/ | |
1581 | PTR arelt_data; | |
1582 | struct _bfd *my_archive; | |
1583 | struct _bfd *next; | |
1584 | struct _bfd *archive_head; | |
1585 | boolean has_armap; | |
1586 | ||
1587 | /* Used by the back end to hold private data. */ | |
1588 | ||
1589 | union | |
1590 | { | |
1591 | struct aout_data_struct *aout_data; | |
1592 | struct artdata *aout_ar_data; | |
1593 | struct _oasys_data *oasys_obj_data; | |
1594 | struct _oasys_ar_data *oasys_ar_data; | |
1595 | struct coff_tdata *coff_obj_data; | |
1596 | struct ecoff_tdata *ecoff_obj_data; | |
1597 | struct ieee_data_struct *ieee_data; | |
1598 | struct ieee_ar_data_struct *ieee_ar_data; | |
1599 | struct srec_data_struct *srec_data; | |
1600 | struct tekhex_data_struct *tekhex_data; | |
1601 | struct elf_obj_tdata *elf_obj_data; | |
c3e964b9 | 1602 | struct nlm_obj_tdata *nlm_obj_data; |
fdcb0453 KR |
1603 | struct bout_data_struct *bout_data; |
1604 | struct sun_core_struct *sun_core_data; | |
1605 | struct trad_core_struct *trad_core_data; | |
9e461dac | 1606 | struct som_data_struct *som_data; |
b66b07a2 | 1607 | struct hpux_core_struct *hpux_core_data; |
fdcb0453 | 1608 | struct sgi_core_struct *sgi_core_data; |
2b91cc45 | 1609 | struct lynx_core_struct *lynx_core_data; |
9b3fa589 | 1610 | struct osf_core_struct *osf_core_data; |
fdcb0453 KR |
1611 | PTR any; |
1612 | } tdata; | |
1613 | ||
1614 | /* Used by the application to hold private data*/ | |
1615 | PTR usrdata; | |
1616 | ||
1617 | /* Where all the allocated stuff under this BFD goes */ | |
1618 | struct obstack memory; | |
1619 | ||
1620 | /* Is this really needed in addition to usrdata? */ | |
1621 | asymbol **ld_symbols; | |
1622 | }; | |
1623 | ||
1624 | unsigned int | |
1625 | bfd_get_reloc_upper_bound PARAMS ((bfd *abfd, asection *sect)); | |
1626 | ||
1627 | unsigned int | |
1628 | bfd_canonicalize_reloc | |
1629 | PARAMS ((bfd *abfd, | |
1630 | asection *sec, | |
1631 | arelent **loc, | |
1632 | asymbol **syms)); | |
1633 | ||
1634 | boolean | |
1635 | bfd_set_file_flags PARAMS ((bfd *abfd, flagword flags)); | |
1636 | ||
1637 | void | |
1638 | bfd_set_reloc | |
1639 | PARAMS ((bfd *abfd, asection *sec, arelent **rel, unsigned int count) | |
1640 | ||
1641 | ); | |
1642 | ||
1643 | boolean | |
1644 | bfd_set_start_address PARAMS ((bfd *, bfd_vma)); | |
1645 | ||
1646 | long | |
1647 | bfd_get_mtime PARAMS ((bfd *)); | |
1648 | ||
1649 | long | |
1650 | bfd_get_size PARAMS ((bfd *)); | |
1651 | ||
1652 | int | |
1653 | bfd_get_gp_size PARAMS ((bfd *)); | |
1654 | ||
1655 | void | |
1656 | bfd_set_gp_size PARAMS ((bfd *, int)); | |
1657 | ||
ef758f3e KR |
1658 | bfd_vma |
1659 | bfd_scan_vma PARAMS ((CONST char *string, CONST char **end, int base)); | |
1660 | ||
fdcb0453 KR |
1661 | #define bfd_sizeof_headers(abfd, reloc) \ |
1662 | BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc)) | |
1663 | ||
1664 | #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \ | |
1665 | BFD_SEND (abfd, _bfd_find_nearest_line, (abfd, sec, syms, off, file, func, line)) | |
1666 | ||
1667 | /* Do these three do anything useful at all, for any back end? */ | |
1668 | #define bfd_debug_info_start(abfd) \ | |
1669 | BFD_SEND (abfd, _bfd_debug_info_start, (abfd)) | |
1670 | ||
1671 | #define bfd_debug_info_end(abfd) \ | |
1672 | BFD_SEND (abfd, _bfd_debug_info_end, (abfd)) | |
1673 | ||
1674 | #define bfd_debug_info_accumulate(abfd, section) \ | |
1675 | BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section)) | |
1676 | ||
1677 | ||
1678 | #define bfd_stat_arch_elt(abfd, stat) \ | |
1679 | BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat)) | |
1680 | ||
1681 | #define bfd_set_arch_mach(abfd, arch, mach)\ | |
1682 | BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach)) | |
1683 | ||
1684 | #define bfd_get_relocated_section_contents(abfd, seclet, data, relocateable) \ | |
1685 | BFD_SEND (abfd, _bfd_get_relocated_section_contents, (abfd, seclet, data, relocateable)) | |
1686 | ||
1687 | #define bfd_relax_section(abfd, section, symbols) \ | |
1688 | BFD_SEND (abfd, _bfd_relax_section, (abfd, section, symbols)) | |
1689 | ||
1690 | #define bfd_seclet_link(abfd, data, relocateable) \ | |
1691 | BFD_SEND (abfd, _bfd_seclet_link, (abfd, data, relocateable)) | |
1692 | symindex | |
1693 | bfd_get_next_mapent PARAMS ((bfd *, symindex previous, carsym ** sym)); | |
1694 | ||
1695 | boolean | |
1696 | bfd_set_archive_head PARAMS ((bfd *output, bfd *new_head)); | |
1697 | ||
1698 | bfd * | |
1699 | bfd_get_elt_at_index PARAMS ((bfd * archive, int index)); | |
1700 | ||
1701 | bfd* | |
1702 | bfd_openr_next_archived_file PARAMS ((bfd *archive, bfd *previous)); | |
1703 | ||
1704 | CONST char * | |
1705 | bfd_core_file_failing_command PARAMS ((bfd *)); | |
1706 | ||
1707 | int | |
1708 | bfd_core_file_failing_signal PARAMS ((bfd *)); | |
1709 | ||
1710 | boolean | |
1711 | core_file_matches_executable_p | |
1712 | PARAMS ((bfd *core_bfd, bfd *exec_bfd)); | |
1713 | ||
1714 | #define BFD_SEND(bfd, message, arglist) \ | |
1715 | ((*((bfd)->xvec->message)) arglist) | |
1716 | #define BFD_SEND_FMT(bfd, message, arglist) \ | |
1717 | (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) | |
9e461dac JK |
1718 | enum bfd_flavour { |
1719 | bfd_target_unknown_flavour, | |
1720 | bfd_target_aout_flavour, | |
1721 | bfd_target_coff_flavour, | |
1722 | bfd_target_ecoff_flavour, | |
1723 | bfd_target_elf_flavour, | |
1724 | bfd_target_ieee_flavour, | |
1725 | bfd_target_nlm_flavour, | |
1726 | bfd_target_oasys_flavour, | |
1727 | bfd_target_tekhex_flavour, | |
1728 | bfd_target_srec_flavour, | |
1729 | bfd_target_som_flavour}; | |
fdcb0453 KR |
1730 | typedef struct bfd_target |
1731 | { | |
1732 | char *name; | |
9e461dac | 1733 | enum bfd_flavour flavour; |
fdcb0453 KR |
1734 | boolean byteorder_big_p; |
1735 | boolean header_byteorder_big_p; | |
1736 | flagword object_flags; | |
1737 | flagword section_flags; | |
1738 | char symbol_leading_char; | |
1739 | char ar_pad_char; | |
1740 | unsigned short ar_max_namelen; | |
1741 | unsigned int align_power_min; | |
1742 | bfd_vma (*bfd_getx64) PARAMS ((bfd_byte *)); | |
1743 | bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((bfd_byte *)); | |
1744 | void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *)); | |
1745 | bfd_vma (*bfd_getx32) PARAMS ((bfd_byte *)); | |
1746 | bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((bfd_byte *)); | |
1747 | void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *)); | |
1748 | bfd_vma (*bfd_getx16) PARAMS ((bfd_byte *)); | |
1749 | bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((bfd_byte *)); | |
1750 | void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *)); | |
1751 | bfd_vma (*bfd_h_getx64) PARAMS ((bfd_byte *)); | |
1752 | bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((bfd_byte *)); | |
1753 | void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *)); | |
1754 | bfd_vma (*bfd_h_getx32) PARAMS ((bfd_byte *)); | |
1755 | bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((bfd_byte *)); | |
1756 | void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *)); | |
1757 | bfd_vma (*bfd_h_getx16) PARAMS ((bfd_byte *)); | |
1758 | bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((bfd_byte *)); | |
1759 | void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *)); | |
1760 | struct bfd_target * (*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *)); | |
1761 | boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *)); | |
1762 | boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *)); | |
1763 | char * (*_core_file_failing_command) PARAMS ((bfd *)); | |
1764 | int (*_core_file_failing_signal) PARAMS ((bfd *)); | |
1765 | boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *)); | |
1766 | boolean (*_bfd_slurp_armap) PARAMS ((bfd *)); | |
1767 | boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *)); | |
1768 | void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *)); | |
1769 | boolean (*write_armap) PARAMS ((bfd *arch, | |
1770 | unsigned int elength, | |
1771 | struct orl *map, | |
1772 | unsigned int orl_count, | |
1773 | int stridx)); | |
1774 | boolean (*_close_and_cleanup) PARAMS ((bfd *)); | |
1775 | boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
1776 | file_ptr, bfd_size_type)); | |
1777 | boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
1778 | file_ptr, bfd_size_type)); | |
1779 | boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr)); | |
1780 | unsigned int (*_get_symtab_upper_bound) PARAMS ((bfd *)); | |
1781 | unsigned int (*_bfd_canonicalize_symtab) PARAMS ((bfd *, | |
1782 | struct symbol_cache_entry **)); | |
1783 | unsigned int (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr)); | |
1784 | unsigned int (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **, | |
1785 | struct symbol_cache_entry **)); | |
1786 | struct symbol_cache_entry * | |
1787 | (*_bfd_make_empty_symbol) PARAMS ((bfd *)); | |
1788 | void (*_bfd_print_symbol) PARAMS ((bfd *, PTR, | |
1789 | struct symbol_cache_entry *, | |
1790 | bfd_print_symbol_type)); | |
1791 | #define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e)) | |
1792 | void (*_bfd_get_symbol_info) PARAMS ((bfd *, | |
1793 | struct symbol_cache_entry *, | |
1794 | symbol_info *)); | |
1795 | #define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e)) | |
1796 | alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *)); | |
1797 | ||
1798 | boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture, | |
1799 | unsigned long)); | |
1800 | ||
1801 | bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev)); | |
1802 | ||
1803 | boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd, | |
1804 | struct sec *section, struct symbol_cache_entry **symbols, | |
1805 | bfd_vma offset, CONST char **file, CONST char **func, | |
1806 | unsigned int *line)); | |
1807 | ||
1808 | int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *)); | |
1809 | ||
1810 | int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean)); | |
1811 | ||
1812 | void (*_bfd_debug_info_start) PARAMS ((bfd *)); | |
1813 | void (*_bfd_debug_info_end) PARAMS ((bfd *)); | |
1814 | void (*_bfd_debug_info_accumulate) PARAMS ((bfd *, struct sec *)); | |
1815 | ||
1816 | bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *, | |
1817 | struct bfd_seclet *, bfd_byte *data, | |
1818 | boolean relocateable)); | |
1819 | ||
1820 | boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *, | |
1821 | struct symbol_cache_entry **)); | |
1822 | ||
1823 | boolean (*_bfd_seclet_link) PARAMS ((bfd *, PTR data, | |
1824 | boolean relocateable)); | |
1825 | /* See documentation on reloc types. */ | |
1826 | CONST struct reloc_howto_struct * | |
1827 | (*reloc_type_lookup) PARAMS ((bfd *abfd, | |
1828 | bfd_reloc_code_real_type code)); | |
1829 | ||
1830 | /* Back-door to allow format-aware applications to create debug symbols | |
1831 | while using BFD for everything else. Currently used by the assembler | |
1832 | when creating COFF files. */ | |
1833 | asymbol * (*_bfd_make_debug_symbol) PARAMS (( | |
1834 | bfd *abfd, | |
1835 | void *ptr, | |
1836 | unsigned long size)); | |
1837 | PTR backend_data; | |
1838 | } bfd_target; | |
1839 | bfd_target * | |
1840 | bfd_find_target PARAMS ((CONST char *, bfd *)); | |
1841 | ||
1842 | CONST char ** | |
1843 | bfd_target_list PARAMS ((void)); | |
1844 | ||
1845 | boolean | |
1846 | bfd_check_format PARAMS ((bfd *abfd, bfd_format format)); | |
1847 | ||
1848 | boolean | |
1849 | bfd_set_format PARAMS ((bfd *, bfd_format)); | |
1850 | ||
1851 | CONST char * | |
1852 | bfd_format_string PARAMS ((bfd_format)); | |
1853 | ||
1854 | #endif |