Commit | Line | Data |
---|---|---|
4e6f9223 | 1 | /* Generic target-file-type support for the BFD library. |
fdfe2d14 | 2 | Copyright 1990, 91, 92, 93, 1994 Free Software Foundation, Inc. |
4e6f9223 | 3 | Written by Cygnus Support. |
4a81b561 | 4 | |
4e6f9223 | 5 | This file is part of BFD, the Binary File Descriptor library. |
4a81b561 | 6 | |
4e6f9223 | 7 | This program is free software; you can redistribute it and/or modify |
4a81b561 | 8 | it under the terms of the GNU General Public License as published by |
4e6f9223 SC |
9 | the Free Software Foundation; either version 2 of the License, or |
10 | (at your option) any later version. | |
4a81b561 | 11 | |
4e6f9223 | 12 | This program is distributed in the hope that it will be useful, |
4a81b561 DHW |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
4e6f9223 SC |
18 | along with this program; if not, write to the Free Software |
19 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ | |
4a81b561 | 20 | |
4a81b561 | 21 | #include "bfd.h" |
bbc8d484 | 22 | #include "sysdep.h" |
4a81b561 DHW |
23 | #include "libbfd.h" |
24 | ||
0cda46cf SC |
25 | /* |
26 | SECTION | |
27 | Targets | |
28 | ||
e98e6ec1 | 29 | DESCRIPTION |
0cda46cf SC |
30 | Each port of BFD to a different machine requries the creation |
31 | of a target back end. All the back end provides to the root | |
32 | part of BFD is a structure containing pointers to functions | |
33 | which perform certain low level operations on files. BFD | |
34 | translates the applications's requests through a pointer into | |
35 | calls to the back end routines. | |
36 | ||
37 | When a file is opened with <<bfd_openr>>, its format and | |
38 | target are unknown. BFD uses various mechanisms to determine | |
39 | how to interpret the file. The operations performed are: | |
40 | ||
c188b0be | 41 | o Create a BFD by calling the internal routine |
d1ad85a6 | 42 | <<_bfd_new_bfd>>, then call <<bfd_find_target>> with the |
0cda46cf SC |
43 | target string supplied to <<bfd_openr>> and the new BFD pointer. |
44 | ||
45 | o If a null target string was provided to <<bfd_find_target>>, | |
c188b0be | 46 | look up the environment variable <<GNUTARGET>> and use |
0cda46cf SC |
47 | that as the target string. |
48 | ||
c96451db | 49 | o If the target string is still <<NULL>>, or the target string is |
c188b0be DM |
50 | <<default>>, then use the first item in the target vector |
51 | as the target type, and set <<target_defaulted>> in the BFD to | |
218ce930 JG |
52 | cause <<bfd_check_format>> to loop through all the targets. |
53 | @xref{bfd_target}. @xref{Formats}. | |
0cda46cf | 54 | |
c188b0be | 55 | o Otherwise, inspect the elements in the target vector |
0cda46cf | 56 | one by one, until a match on target name is found. When found, |
c188b0be | 57 | use it. |
0cda46cf | 58 | |
d1ad85a6 | 59 | o Otherwise return the error <<bfd_error_invalid_target>> to |
0cda46cf SC |
60 | <<bfd_openr>>. |
61 | ||
62 | o <<bfd_openr>> attempts to open the file using | |
63 | <<bfd_open_file>>, and returns the BFD. | |
64 | ||
65 | Once the BFD has been opened and the target selected, the file | |
66 | format may be determined. This is done by calling | |
218ce930 JG |
67 | <<bfd_check_format>> on the BFD with a suggested format. |
68 | If <<target_defaulted>> has been set, each possible target | |
c188b0be DM |
69 | type is tried to see if it recognizes the specified format. |
70 | <<bfd_check_format>> returns <<true>> when the caller guesses right. | |
92c78ee6 | 71 | @menu |
e98e6ec1 | 72 | @* bfd_target:: |
92c78ee6 | 73 | @end menu |
6f715d66 SC |
74 | */ |
75 | ||
76 | ||
0cda46cf SC |
77 | /* |
78 | ||
e98e6ec1 SC |
79 | INODE |
80 | bfd_target, , Targets, Targets | |
6697a1a9 | 81 | DOCDD |
0cda46cf SC |
82 | SUBSECTION |
83 | bfd_target | |
84 | ||
e98e6ec1 | 85 | DESCRIPTION |
0cda46cf | 86 | This structure contains everything that BFD knows about a |
c188b0be DM |
87 | target. It includes things like its byte order, name, and which |
88 | routines to call to do various operations. | |
6f715d66 | 89 | |
0cda46cf SC |
90 | Every BFD points to a target structure with its <<xvec>> |
91 | member. | |
6f715d66 | 92 | |
c188b0be DM |
93 | The macros below are used to dispatch to functions through the |
94 | <<bfd_target>> vector. They are used in a number of macros further | |
0cda46cf | 95 | down in @file{bfd.h}, and are also used when calling various |
c188b0be | 96 | routines by hand inside the BFD implementation. The @var{arglist} |
0cda46cf SC |
97 | argument must be parenthesized; it contains all the arguments |
98 | to the called function. | |
6f715d66 | 99 | |
ce07dd7c KR |
100 | They make the documentation (more) unpleasant to read, so if |
101 | someone wants to fix this and not break the above, please do. | |
6f715d66 | 102 | |
0cda46cf SC |
103 | .#define BFD_SEND(bfd, message, arglist) \ |
104 | . ((*((bfd)->xvec->message)) arglist) | |
fdfe2d14 SS |
105 | . |
106 | .#ifdef DEBUG_BFD_SEND | |
107 | .#undef BFD_SEND | |
108 | .#define BFD_SEND(bfd, message, arglist) \ | |
109 | . (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \ | |
110 | . ((*((bfd)->xvec->message)) arglist) : \ | |
111 | . (bfd_assert (__FILE__,__LINE__), NULL)) | |
112 | .#endif | |
6f715d66 | 113 | |
c188b0be | 114 | For operations which index on the BFD format: |
6f715d66 | 115 | |
0cda46cf SC |
116 | .#define BFD_SEND_FMT(bfd, message, arglist) \ |
117 | . (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) | |
fdfe2d14 SS |
118 | . |
119 | .#ifdef DEBUG_BFD_SEND | |
120 | .#undef BFD_SEND_FMT | |
121 | .#define BFD_SEND_FMT(bfd, message, arglist) \ | |
122 | . (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \ | |
123 | . (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) : \ | |
124 | . (bfd_assert (__FILE__,__LINE__), NULL)) | |
125 | .#endif | |
6f715d66 | 126 | |
c188b0be | 127 | This is the structure which defines the type of BFD this is. The |
0cda46cf SC |
128 | <<xvec>> member of the struct <<bfd>> itself points here. Each |
129 | module that implements access to a different target under BFD, | |
130 | defines one of these. | |
6f715d66 | 131 | |
6f715d66 | 132 | |
0cda46cf SC |
133 | FIXME, these names should be rationalised with the names of |
134 | the entry points which call them. Too bad we can't have one | |
135 | macro to define them both! | |
136 | ||
c188b0be DM |
137 | .enum bfd_flavour { |
138 | . bfd_target_unknown_flavour, | |
139 | . bfd_target_aout_flavour, | |
140 | . bfd_target_coff_flavour, | |
141 | . bfd_target_ecoff_flavour, | |
142 | . bfd_target_elf_flavour, | |
143 | . bfd_target_ieee_flavour, | |
144 | . bfd_target_nlm_flavour, | |
145 | . bfd_target_oasys_flavour, | |
146 | . bfd_target_tekhex_flavour, | |
147 | . bfd_target_srec_flavour, | |
2f88343d KH |
148 | . bfd_target_som_flavour, |
149 | . bfd_target_os9k_flavour}; | |
4c3721d5 ILT |
150 | . |
151 | .{* Forward declaration. *} | |
152 | .typedef struct bfd_link_info _bfd_link_info; | |
153 | . | |
0cda46cf SC |
154 | .typedef struct bfd_target |
155 | .{ | |
6f715d66 | 156 | |
c188b0be | 157 | Identifies the kind of target, e.g., SunOS4, Ultrix, etc. |
6f715d66 | 158 | |
0cda46cf | 159 | . char *name; |
6f715d66 SC |
160 | |
161 | The "flavour" of a back end is a general indication about the contents | |
162 | of a file. | |
163 | ||
c188b0be | 164 | . enum bfd_flavour flavour; |
6f715d66 SC |
165 | |
166 | The order of bytes within the data area of a file. | |
167 | ||
0cda46cf | 168 | . boolean byteorder_big_p; |
6f715d66 SC |
169 | |
170 | The order of bytes within the header parts of a file. | |
171 | ||
0cda46cf | 172 | . boolean header_byteorder_big_p; |
6f715d66 | 173 | |
c188b0be | 174 | A mask of all the flags which an executable may have set - |
0cda46cf | 175 | from the set <<NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>. |
6f715d66 | 176 | |
0cda46cf | 177 | . flagword object_flags; |
6f715d66 | 178 | |
c188b0be | 179 | A mask of all the flags which a section may have set - from |
0cda46cf | 180 | the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>. |
6f715d66 | 181 | |
0cda46cf | 182 | . flagword section_flags; |
6f715d66 | 183 | |
990e7c22 | 184 | The character normally found at the front of a symbol |
c188b0be | 185 | (if any), perhaps `_'. |
990e7c22 JG |
186 | |
187 | . char symbol_leading_char; | |
188 | ||
c188b0be | 189 | The pad character for file names within an archive header. |
6f715d66 | 190 | |
0cda46cf | 191 | . char ar_pad_char; |
6f715d66 SC |
192 | |
193 | The maximum number of characters in an archive header. | |
194 | ||
60ac749c | 195 | . unsigned short ar_max_namelen; |
6f715d66 SC |
196 | |
197 | The minimum alignment restriction for any section. | |
198 | ||
0cda46cf | 199 | . unsigned int align_power_min; |
6f715d66 | 200 | |
c188b0be DM |
201 | Entries for byte swapping for data. These are different from the other |
202 | entry points, since they don't take a BFD asthe first argument. | |
203 | Certain other handlers could do the same. | |
6f715d66 | 204 | |
3b31740c DM |
205 | . bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *)); |
206 | . bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *)); | |
60ac749c | 207 | . void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
208 | . bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *)); |
209 | . bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *)); | |
60ac749c | 210 | . void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
211 | . bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *)); |
212 | . bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *)); | |
60ac749c | 213 | . void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *)); |
6f715d66 SC |
214 | |
215 | Byte swapping for the headers | |
216 | ||
3b31740c DM |
217 | . bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *)); |
218 | . bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *)); | |
60ac749c | 219 | . void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
220 | . bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *)); |
221 | . bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *)); | |
60ac749c | 222 | . void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
223 | . bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *)); |
224 | . bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *)); | |
60ac749c | 225 | . void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *)); |
6f715d66 | 226 | |
60ac749c ILT |
227 | Format dependent routines: these are vectors of entry points |
228 | within the target vector structure, one for each format to check. | |
6f715d66 | 229 | |
c188b0be | 230 | Check the format of a file being read. Return a <<bfd_target *>> or zero. |
6f715d66 | 231 | |
60ac749c | 232 | . struct bfd_target * (*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 SC |
233 | |
234 | Set the format of a file being written. | |
235 | ||
60ac749c | 236 | . boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 | 237 | |
c188b0be | 238 | Write cached information into a file being written, at <<bfd_close>>. |
6f715d66 | 239 | |
60ac749c | 240 | . boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 | 241 | |
0cda46cf SC |
242 | The following functions are defined in <<JUMP_TABLE>>. The idea is |
243 | that the back end writer of <<foo>> names all the routines | |
c188b0be | 244 | <<foo_>>@var{entry_point}; <<JUMP_TABLE>> will build the entries |
6f715d66 SC |
245 | in this structure in the right order. |
246 | ||
c188b0be | 247 | Core file entry points. |
6f715d66 | 248 | |
60ac749c ILT |
249 | . char * (*_core_file_failing_command) PARAMS ((bfd *)); |
250 | . int (*_core_file_failing_signal) PARAMS ((bfd *)); | |
251 | . boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *)); | |
6f715d66 | 252 | |
c188b0be | 253 | Archive entry points. |
6f715d66 | 254 | |
60ac749c ILT |
255 | . boolean (*_bfd_slurp_armap) PARAMS ((bfd *)); |
256 | . boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *)); | |
257 | . void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *)); | |
258 | . boolean (*write_armap) PARAMS ((bfd *arch, | |
0cda46cf SC |
259 | . unsigned int elength, |
260 | . struct orl *map, | |
261 | . unsigned int orl_count, | |
262 | . int stridx)); | |
6f715d66 SC |
263 | |
264 | Standard stuff. | |
265 | ||
60ac749c ILT |
266 | . boolean (*_close_and_cleanup) PARAMS ((bfd *)); |
267 | . boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
0cda46cf | 268 | . file_ptr, bfd_size_type)); |
60ac749c | 269 | . boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR, |
0cda46cf | 270 | . file_ptr, bfd_size_type)); |
60ac749c | 271 | . boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr)); |
bdf1b511 PS |
272 | . boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr, |
273 | . bfd *, sec_ptr)); | |
274 | . boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *)); | |
6f715d66 | 275 | |
c188b0be | 276 | Symbols and relocations. |
6f715d66 | 277 | |
326e32d7 ILT |
278 | . long (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *)); |
279 | . long (*_bfd_canonicalize_symtab) PARAMS ((bfd *, | |
280 | . struct symbol_cache_entry **)); | |
281 | . long (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr)); | |
282 | . long (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **, | |
283 | . struct symbol_cache_entry **)); | |
60ac749c ILT |
284 | . struct symbol_cache_entry * |
285 | . (*_bfd_make_empty_symbol) PARAMS ((bfd *)); | |
286 | . void (*_bfd_print_symbol) PARAMS ((bfd *, PTR, | |
287 | . struct symbol_cache_entry *, | |
0cda46cf SC |
288 | . bfd_print_symbol_type)); |
289 | .#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e)) | |
93b4f018 DM |
290 | . void (*_bfd_get_symbol_info) PARAMS ((bfd *, |
291 | . struct symbol_cache_entry *, | |
292 | . symbol_info *)); | |
293 | .#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e)) | |
bdf1b511 | 294 | . boolean (*_bfd_is_local_label) PARAMS ((bfd *, asymbol *)); |
0d740984 | 295 | |
60ac749c | 296 | . alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *)); |
0cda46cf | 297 | . |
60ac749c ILT |
298 | . boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture, |
299 | . unsigned long)); | |
0cda46cf | 300 | . |
60ac749c ILT |
301 | . bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev)); |
302 | . | |
303 | . boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd, | |
304 | . struct sec *section, struct symbol_cache_entry **symbols, | |
305 | . bfd_vma offset, CONST char **file, CONST char **func, | |
306 | . unsigned int *line)); | |
307 | . | |
308 | . int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *)); | |
0cda46cf | 309 | . |
60ac749c | 310 | . int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean)); |
0cda46cf | 311 | . |
60ac749c ILT |
312 | . void (*_bfd_debug_info_start) PARAMS ((bfd *)); |
313 | . void (*_bfd_debug_info_end) PARAMS ((bfd *)); | |
314 | . void (*_bfd_debug_info_accumulate) PARAMS ((bfd *, struct sec *)); | |
0cda46cf | 315 | . |
60ac749c | 316 | . bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *, |
4c3721d5 ILT |
317 | . struct bfd_link_info *, struct bfd_link_order *, |
318 | . bfd_byte *data, boolean relocateable, | |
319 | . struct symbol_cache_entry **)); | |
0cda46cf | 320 | . |
60ac749c | 321 | . boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *, |
bdf1b511 | 322 | . struct bfd_link_info *, boolean *again)); |
2ebd0976 | 323 | . |
ce07dd7c | 324 | . {* See documentation on reloc types. *} |
60ac749c ILT |
325 | . CONST struct reloc_howto_struct * |
326 | . (*reloc_type_lookup) PARAMS ((bfd *abfd, | |
327 | . bfd_reloc_code_real_type code)); | |
ce07dd7c | 328 | . |
60ac749c ILT |
329 | . {* Back-door to allow format-aware applications to create debug symbols |
330 | . while using BFD for everything else. Currently used by the assembler | |
ce07dd7c | 331 | . when creating COFF files. *} |
60ac749c | 332 | . asymbol * (*_bfd_make_debug_symbol) PARAMS (( |
ce07dd7c KR |
333 | . bfd *abfd, |
334 | . void *ptr, | |
335 | . unsigned long size)); | |
4c3721d5 ILT |
336 | . |
337 | . {* Create a hash table for the linker. Different backends store | |
338 | . different information in this table. *} | |
339 | . struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *)); | |
340 | . | |
341 | . {* Add symbols from this object file into the hash table. *} | |
342 | . boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *)); | |
343 | . | |
344 | . {* Do a link based on the link_order structures attached to each | |
345 | . section of the BFD. *} | |
346 | . boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *)); | |
347 | . | |
ce07dd7c | 348 | |
14e3c2e4 JK |
349 | Data for use by back-end routines, which isn't generic enough to belong |
350 | in this structure. | |
ce07dd7c KR |
351 | |
352 | . PTR backend_data; | |
0cda46cf | 353 | .} bfd_target; |
6f715d66 SC |
354 | |
355 | */ | |
f8adc62d | 356 | |
cf39664e DM |
357 | /* All known xvecs (even those that don't compile on all systems). |
358 | Alphabetized for easy reference. | |
359 | They are listed a second time below, since | |
616ebcfd | 360 | we can't intermix extern's and initializers. */ |
cf39664e | 361 | extern bfd_target a29kcoff_big_vec; |
218ce930 | 362 | extern bfd_target a_out_adobe_vec; |
cf39664e DM |
363 | extern bfd_target aout_mips_big_vec; |
364 | extern bfd_target aout_mips_little_vec; | |
3bca0336 | 365 | extern bfd_target apollocoff_vec; |
4a81b561 | 366 | extern bfd_target b_out_vec_big_host; |
cf39664e DM |
367 | extern bfd_target b_out_vec_little_host; |
368 | extern bfd_target bfd_elf32_big_generic_vec; | |
369 | extern bfd_target bfd_elf32_bigmips_vec; | |
370 | extern bfd_target bfd_elf32_hppa_vec; | |
9942e684 | 371 | extern bfd_target bfd_elf32_i386_vec; |
9942e684 | 372 | extern bfd_target bfd_elf32_i860_vec; |
ebd24135 | 373 | extern bfd_target bfd_elf32_little_generic_vec; |
cf39664e DM |
374 | extern bfd_target bfd_elf32_littlemips_vec; |
375 | extern bfd_target bfd_elf32_m68k_vec; | |
376 | extern bfd_target bfd_elf32_m88k_vec; | |
fdfe2d14 | 377 | extern bfd_target bfd_elf32_powerpc_vec; |
cf39664e | 378 | extern bfd_target bfd_elf32_sparc_vec; |
ebd24135 ILT |
379 | extern bfd_target bfd_elf64_big_generic_vec; |
380 | extern bfd_target bfd_elf64_little_generic_vec; | |
cf39664e DM |
381 | /* start-sanitize-v9 */ |
382 | extern bfd_target bfd_elf64_sparc_vec; | |
383 | /* end-sanitize-v9 */ | |
384 | extern bfd_target demo_64_vec; | |
385 | extern bfd_target ecoff_big_vec; | |
386 | extern bfd_target ecoff_little_vec; | |
387 | extern bfd_target ecoffalpha_little_vec; | |
388 | extern bfd_target h8300coff_vec; | |
389 | extern bfd_target h8500coff_vec; | |
390 | extern bfd_target host_aout_vec; | |
391 | extern bfd_target hp300bsd_vec; | |
392 | extern bfd_target hp300hpux_vec; | |
3bca0336 | 393 | extern bfd_target som_vec; |
cf39664e DM |
394 | extern bfd_target i386aout_vec; |
395 | extern bfd_target i386bsd_vec; | |
bdf1b511 | 396 | extern bfd_target i386dynix_vec; |
2f88343d | 397 | extern bfd_target i386os9k_vec; |
3bca0336 | 398 | extern bfd_target netbsd386_vec; |
cf39664e DM |
399 | extern bfd_target i386coff_vec; |
400 | extern bfd_target i386linux_vec; | |
3bca0336 KR |
401 | extern bfd_target i386lynx_aout_vec; |
402 | extern bfd_target i386lynx_coff_vec; | |
2487f88f | 403 | extern bfd_target i386mach3_vec; |
cf39664e DM |
404 | extern bfd_target icoff_big_vec; |
405 | extern bfd_target icoff_little_vec; | |
406 | extern bfd_target ieee_vec; | |
407 | extern bfd_target m68kcoff_vec; | |
408 | extern bfd_target m68kcoffun_vec; | |
3bca0336 KR |
409 | extern bfd_target m68klynx_aout_vec; |
410 | extern bfd_target m68klynx_coff_vec; | |
cf39664e DM |
411 | extern bfd_target m88kbcs_vec; |
412 | extern bfd_target newsos3_vec; | |
cf39664e | 413 | extern bfd_target nlm32_i386_vec; |
c96451db | 414 | extern bfd_target nlm32_sparc_vec; |
4c3721d5 | 415 | extern bfd_target nlm32_alpha_vec; |
fdfe2d14 SS |
416 | /*start-sanitize-powerpc-netware*/ |
417 | extern bfd_target nlm32_powerpc_vec; | |
418 | /*end-sanitize-powerpc-netware*/ | |
aacf30e3 | 419 | extern bfd_target oasys_vec; |
cbdc7909 | 420 | extern bfd_target rs6000coff_vec; |
93b4f018 | 421 | extern bfd_target shcoff_vec; |
c188b0be DM |
422 | extern bfd_target sparclynx_aout_vec; |
423 | extern bfd_target sparclynx_coff_vec; | |
5984f609 | 424 | extern bfd_target sparccoff_vec; |
cf39664e DM |
425 | extern bfd_target sunos_big_vec; |
426 | extern bfd_target tekhex_vec; | |
427 | extern bfd_target we32kcoff_vec; | |
428 | extern bfd_target z8kcoff_vec; | |
429 | ||
430 | /* srec is always included. */ | |
431 | extern bfd_target srec_vec; | |
432 | extern bfd_target symbolsrec_vec; | |
433 | ||
434 | /* All of the xvecs for core files. */ | |
435 | extern bfd_target aix386_core_vec; | |
bdf1b511 | 436 | extern bfd_target cisco_core_vec; |
cf39664e | 437 | extern bfd_target hpux_core_vec; |
c96451db | 438 | extern bfd_target hppabsd_core_vec; |
dabfe2f6 | 439 | extern bfd_target irix_core_vec; |
3bca0336 | 440 | extern bfd_target osf_core_vec; |
cf39664e DM |
441 | extern bfd_target sco_core_vec; |
442 | extern bfd_target trad_core_vec; | |
dabfe2f6 | 443 | extern bfd_target ptrace_core_vec; |
f8adc62d | 444 | |
d1ad85a6 | 445 | bfd_target *bfd_target_vector[] = { |
4e6f9223 | 446 | |
2ebd0976 | 447 | #ifdef SELECT_VECS |
14e3c2e4 JK |
448 | |
449 | SELECT_VECS, | |
450 | ||
451 | #else /* not SELECT_VECS */ | |
f39b81f5 | 452 | |
cf39664e DM |
453 | #ifdef DEFAULT_VECTOR |
454 | &DEFAULT_VECTOR, | |
455 | #endif | |
456 | /* This list is alphabetized to make it easy to compare | |
457 | with other vector lists -- the decls above and | |
458 | the case statement in configure.in. | |
459 | Vectors that don't compile on all systems, or aren't finished, | |
460 | should have an entry here with #if 0 around it, to show that | |
461 | it wasn't omitted by mistake. */ | |
462 | &a29kcoff_big_vec, | |
463 | &a_out_adobe_vec, | |
464 | #if 0 /* No one seems to use this. */ | |
2ebd0976 | 465 | &aout_mips_big_vec, |
cf39664e DM |
466 | #endif |
467 | &aout_mips_little_vec, | |
468 | &b_out_vec_big_host, | |
469 | &b_out_vec_little_host, | |
56a2f341 JK |
470 | |
471 | /* This, and other vectors, may not be used in any *.mt configuration. | |
472 | But that does not mean they are unnecessary. If configured | |
473 | --with-targets=all, objdump or gdb should be able to examine | |
474 | the file even if we don't recognize the machine type. */ | |
cf39664e | 475 | &bfd_elf32_big_generic_vec, |
7218bb04 | 476 | &bfd_elf32_bigmips_vec, |
cf39664e | 477 | &bfd_elf32_hppa_vec, |
cf39664e DM |
478 | &bfd_elf32_i386_vec, |
479 | &bfd_elf32_i860_vec, | |
cf39664e | 480 | &bfd_elf32_little_generic_vec, |
7218bb04 | 481 | &bfd_elf32_littlemips_vec, |
cf39664e DM |
482 | &bfd_elf32_m68k_vec, |
483 | &bfd_elf32_m88k_vec, | |
484 | &bfd_elf32_sparc_vec, | |
485 | #ifdef BFD64 /* No one seems to use this. */ | |
486 | &bfd_elf64_big_generic_vec, | |
487 | &bfd_elf64_little_generic_vec, | |
488 | #endif | |
489 | /* start-sanitize-v9 */ | |
490 | #if 0 | |
491 | &bfd_elf64_sparc_vec, | |
492 | #endif | |
493 | /* end-sanitize-v9 */ | |
bdf1b511 PS |
494 | /* We don't include cisco_core_vec. Although it has a magic number, |
495 | the magic number isn't at the beginning of the file, and thus | |
496 | might spuriously match other kinds of files. */ | |
2c4f2c72 | 497 | #ifdef BFD64 |
f39b81f5 | 498 | &demo_64_vec, /* Only compiled if host has long-long support */ |
cf39664e DM |
499 | #endif |
500 | &ecoff_big_vec, | |
501 | &ecoff_little_vec, | |
502 | #if 0 | |
503 | &ecoffalpha_little_vec, | |
f39b81f5 SC |
504 | #endif |
505 | &h8300coff_vec, | |
cf39664e | 506 | &h8500coff_vec, |
5f9a2245 | 507 | #if 0 |
56a2f341 JK |
508 | /* Since a.out files lack decent magic numbers, no way to recognize |
509 | which kind of a.out file it is. */ | |
cf39664e | 510 | &host_aout_vec, |
5f9a2245 | 511 | #endif |
c8e1d00b | 512 | #if 0 /* Clashes with sunos_big_vec magic no. */ |
cf39664e | 513 | &hp300bsd_vec, |
c8e1d00b | 514 | #endif |
cf39664e | 515 | &hp300hpux_vec, |
d1ad85a6 | 516 | #if defined (HOST_HPPAHPUX) || defined (HOST_HPPABSD) || defined (HOST_HPPAOSF) |
3bca0336 | 517 | &som_vec, |
cf39664e DM |
518 | #endif |
519 | &i386aout_vec, | |
520 | &i386bsd_vec, | |
3bca0336 | 521 | &netbsd386_vec, |
cf39664e DM |
522 | &i386coff_vec, |
523 | #if 0 | |
56a2f341 JK |
524 | /* Since a.out files lack decent magic numbers, no way to recognize |
525 | which kind of a.out file it is. */ | |
cf39664e DM |
526 | &i386linux_vec, |
527 | #endif | |
3bca0336 KR |
528 | &i386lynx_aout_vec, |
529 | &i386lynx_coff_vec, | |
2f88343d | 530 | &i386os9k_vec, |
f39b81f5 | 531 | &icoff_big_vec, |
cf39664e DM |
532 | &icoff_little_vec, |
533 | &ieee_vec, | |
534 | &m68kcoff_vec, | |
535 | &m68kcoffun_vec, | |
3bca0336 KR |
536 | &m68klynx_aout_vec, |
537 | &m68klynx_coff_vec, | |
cf39664e DM |
538 | &m88kbcs_vec, |
539 | &newsos3_vec, | |
493a2593 | 540 | &nlm32_i386_vec, |
c96451db | 541 | &nlm32_sparc_vec, |
ebd24135 | 542 | #ifdef BFD64 |
3b31740c | 543 | &nlm32_alpha_vec, |
cf39664e DM |
544 | #endif |
545 | #if 0 | |
546 | /* We have no oasys tools anymore, so we can't test any of this | |
547 | anymore. If you want to test the stuff yourself, go ahead... | |
548 | steve@cygnus.com | |
549 | Worse, since there is no magic number for archives, there | |
550 | can be annoying target mis-matches. */ | |
551 | &oasys_vec, | |
ebd24135 | 552 | #endif |
f39b81f5 | 553 | &rs6000coff_vec, |
cf39664e | 554 | &shcoff_vec, |
c188b0be DM |
555 | &sparclynx_aout_vec, |
556 | &sparclynx_coff_vec, | |
cf39664e DM |
557 | &sunos_big_vec, |
558 | #if 0 | |
559 | &tekhex_vec, | |
e3c01e92 | 560 | #endif |
6697a1a9 | 561 | &we32kcoff_vec, |
cf39664e | 562 | &z8kcoff_vec, |
f39b81f5 | 563 | |
5f9a2245 DM |
564 | #endif /* not SELECT_VECS */ |
565 | ||
180acef5 DM |
566 | /* Always support S-records, for convenience. */ |
567 | &srec_vec, | |
568 | &symbolsrec_vec, | |
569 | ||
5f9a2245 DM |
570 | /* Add any required traditional-core-file-handler. */ |
571 | ||
60ac749c | 572 | #ifdef AIX386_CORE |
2c4f2c72 | 573 | &aix386_core_vec, |
f39b81f5 | 574 | #endif |
a643e626 ILT |
575 | #ifdef HPUX_CORE |
576 | &hpux_core_vec, | |
577 | #endif | |
c96451db SEF |
578 | #ifdef HPPABSD_CORE |
579 | &hppabsd_core_vec, | |
580 | #endif | |
dabfe2f6 ILT |
581 | #ifdef IRIX_CORE |
582 | &irix_core_vec, | |
583 | #endif | |
3bca0336 KR |
584 | #ifdef OSF_CORE |
585 | &osf_core_vec, | |
586 | #endif | |
cf39664e DM |
587 | #ifdef TRAD_CORE |
588 | &trad_core_vec, | |
589 | #endif | |
2ebd0976 | 590 | |
dabfe2f6 ILT |
591 | #ifdef PTRACE_CORE |
592 | &ptrace_core_vec, | |
593 | #endif | |
594 | ||
5f9a2245 | 595 | NULL /* end of list marker */ |
7d774e01 | 596 | }; |
c0e5039e | 597 | |
d1ad85a6 | 598 | /* bfd_default_vector[0] contains either the address of the default vector, |
c0e5039e JG |
599 | if there is one, or zero if there isn't. */ |
600 | ||
d1ad85a6 | 601 | bfd_target *bfd_default_vector[] = { |
c0e5039e | 602 | #ifdef DEFAULT_VECTOR |
616ebcfd | 603 | &DEFAULT_VECTOR, |
378dac8c | 604 | #endif |
5f9a2245 | 605 | NULL |
c0e5039e | 606 | }; |
6f715d66 | 607 | |
d1ad85a6 DM |
608 | /* When there is an ambiguous match, bfd_check_format_matches puts the |
609 | names of the matching targets in an array. This variable is the maximum | |
610 | number of entries that the array could possibly need. */ | |
611 | CONST size_t _bfd_target_vector_entries = sizeof(bfd_target_vector)/sizeof(*bfd_target_vector); | |
6f715d66 | 612 | |
0cda46cf SC |
613 | /* |
614 | FUNCTION | |
615 | bfd_find_target | |
616 | ||
c188b0be DM |
617 | SYNOPSIS |
618 | bfd_target *bfd_find_target(CONST char *target_name, bfd *abfd); | |
619 | ||
0cda46cf | 620 | DESCRIPTION |
c188b0be | 621 | Return a pointer to the transfer vector for the object target |
c96451db SEF |
622 | named @var{target_name}. If @var{target_name} is <<NULL>>, choose the |
623 | one in the environment variable <<GNUTARGET>>; if that is null or not | |
c188b0be | 624 | defined, then choose the first entry in the target list. |
0cda46cf SC |
625 | Passing in the string "default" or setting the environment |
626 | variable to "default" will cause the first entry in the target | |
627 | list to be returned, and "target_defaulted" will be set in the | |
628 | BFD. This causes <<bfd_check_format>> to loop over all the | |
629 | targets to find the one that matches the file being read. | |
0cda46cf | 630 | */ |
6f715d66 SC |
631 | |
632 | bfd_target * | |
57a1867e DM |
633 | bfd_find_target (target_name, abfd) |
634 | CONST char *target_name; | |
635 | bfd *abfd; | |
6f715d66 SC |
636 | { |
637 | bfd_target **target; | |
638 | extern char *getenv (); | |
f8adc62d JG |
639 | CONST char *targname = (target_name ? target_name : |
640 | (CONST char *) getenv ("GNUTARGET")); | |
6f715d66 SC |
641 | |
642 | /* This is safe; the vector cannot be null */ | |
643 | if (targname == NULL || !strcmp (targname, "default")) { | |
644 | abfd->target_defaulted = true; | |
d1ad85a6 | 645 | return abfd->xvec = bfd_target_vector[0]; |
6f715d66 SC |
646 | } |
647 | ||
648 | abfd->target_defaulted = false; | |
649 | ||
d1ad85a6 | 650 | for (target = &bfd_target_vector[0]; *target != NULL; target++) { |
6f715d66 SC |
651 | if (!strcmp (targname, (*target)->name)) |
652 | return abfd->xvec = *target; | |
653 | } | |
654 | ||
d1ad85a6 | 655 | bfd_set_error (bfd_error_invalid_target); |
6f715d66 SC |
656 | return NULL; |
657 | } | |
658 | ||
659 | ||
0cda46cf SC |
660 | /* |
661 | FUNCTION | |
662 | bfd_target_list | |
663 | ||
0cda46cf | 664 | SYNOPSIS |
69e0d34d | 665 | CONST char **bfd_target_list(void); |
0cda46cf | 666 | |
c188b0be DM |
667 | DESCRIPTION |
668 | Return a freshly malloced NULL-terminated | |
669 | vector of the names of all the valid BFD targets. Do not | |
670 | modify the names. | |
671 | ||
0cda46cf | 672 | */ |
6f715d66 SC |
673 | |
674 | CONST char ** | |
57a1867e | 675 | bfd_target_list () |
6f715d66 SC |
676 | { |
677 | int vec_length= 0; | |
990e7c22 JG |
678 | #ifdef NATIVE_HPPAHPUX_COMPILER |
679 | /* The native compiler on the HP9000/700 has a bug which causes it | |
680 | to loop endlessly when compiling this file. This avoids it. */ | |
681 | volatile | |
682 | #endif | |
683 | bfd_target **target; | |
4e6f9223 | 684 | CONST char **name_list, **name_ptr; |
6f715d66 | 685 | |
d1ad85a6 | 686 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
687 | vec_length++; |
688 | ||
d1ad85a6 DM |
689 | name_ptr = name_list = (CONST char **) |
690 | bfd_zmalloc ((vec_length + 1) * sizeof (char **)); | |
6f715d66 SC |
691 | |
692 | if (name_list == NULL) { | |
d1ad85a6 | 693 | bfd_set_error (bfd_error_no_memory); |
6f715d66 SC |
694 | return NULL; |
695 | } | |
696 | ||
d1ad85a6 | 697 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
698 | *(name_ptr++) = (*target)->name; |
699 | ||
700 | return name_list; | |
701 | } |