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)); |
6f715d66 | 272 | |
c188b0be | 273 | Symbols and relocations. |
6f715d66 | 274 | |
60ac749c ILT |
275 | . unsigned int (*_get_symtab_upper_bound) PARAMS ((bfd *)); |
276 | . unsigned int (*_bfd_canonicalize_symtab) PARAMS ((bfd *, | |
277 | . struct symbol_cache_entry **)); | |
278 | . unsigned int (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr)); | |
279 | . unsigned int (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **, | |
280 | . struct symbol_cache_entry **)); | |
281 | . struct symbol_cache_entry * | |
282 | . (*_bfd_make_empty_symbol) PARAMS ((bfd *)); | |
283 | . void (*_bfd_print_symbol) PARAMS ((bfd *, PTR, | |
284 | . struct symbol_cache_entry *, | |
0cda46cf SC |
285 | . bfd_print_symbol_type)); |
286 | .#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e)) | |
93b4f018 DM |
287 | . void (*_bfd_get_symbol_info) PARAMS ((bfd *, |
288 | . struct symbol_cache_entry *, | |
289 | . symbol_info *)); | |
290 | .#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e)) | |
0d740984 | 291 | |
60ac749c | 292 | . alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *)); |
0cda46cf | 293 | . |
60ac749c ILT |
294 | . boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture, |
295 | . unsigned long)); | |
0cda46cf | 296 | . |
60ac749c ILT |
297 | . bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev)); |
298 | . | |
299 | . boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd, | |
300 | . struct sec *section, struct symbol_cache_entry **symbols, | |
301 | . bfd_vma offset, CONST char **file, CONST char **func, | |
302 | . unsigned int *line)); | |
303 | . | |
304 | . int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *)); | |
0cda46cf | 305 | . |
60ac749c | 306 | . int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean)); |
0cda46cf | 307 | . |
60ac749c ILT |
308 | . void (*_bfd_debug_info_start) PARAMS ((bfd *)); |
309 | . void (*_bfd_debug_info_end) PARAMS ((bfd *)); | |
310 | . void (*_bfd_debug_info_accumulate) PARAMS ((bfd *, struct sec *)); | |
0cda46cf | 311 | . |
60ac749c | 312 | . bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *, |
4c3721d5 ILT |
313 | . struct bfd_link_info *, struct bfd_link_order *, |
314 | . bfd_byte *data, boolean relocateable, | |
315 | . struct symbol_cache_entry **)); | |
0cda46cf | 316 | . |
60ac749c | 317 | . boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *, |
4c3721d5 | 318 | . struct bfd_link_info *, struct symbol_cache_entry **)); |
2ebd0976 | 319 | . |
ce07dd7c | 320 | . {* See documentation on reloc types. *} |
60ac749c ILT |
321 | . CONST struct reloc_howto_struct * |
322 | . (*reloc_type_lookup) PARAMS ((bfd *abfd, | |
323 | . bfd_reloc_code_real_type code)); | |
ce07dd7c | 324 | . |
60ac749c ILT |
325 | . {* Back-door to allow format-aware applications to create debug symbols |
326 | . while using BFD for everything else. Currently used by the assembler | |
ce07dd7c | 327 | . when creating COFF files. *} |
60ac749c | 328 | . asymbol * (*_bfd_make_debug_symbol) PARAMS (( |
ce07dd7c KR |
329 | . bfd *abfd, |
330 | . void *ptr, | |
331 | . unsigned long size)); | |
4c3721d5 ILT |
332 | . |
333 | . {* Create a hash table for the linker. Different backends store | |
334 | . different information in this table. *} | |
335 | . struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *)); | |
336 | . | |
337 | . {* Add symbols from this object file into the hash table. *} | |
338 | . boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *)); | |
339 | . | |
340 | . {* Do a link based on the link_order structures attached to each | |
341 | . section of the BFD. *} | |
342 | . boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *)); | |
343 | . | |
ce07dd7c | 344 | |
14e3c2e4 JK |
345 | Data for use by back-end routines, which isn't generic enough to belong |
346 | in this structure. | |
ce07dd7c KR |
347 | |
348 | . PTR backend_data; | |
0cda46cf | 349 | .} bfd_target; |
6f715d66 SC |
350 | |
351 | */ | |
f8adc62d | 352 | |
cf39664e DM |
353 | /* All known xvecs (even those that don't compile on all systems). |
354 | Alphabetized for easy reference. | |
355 | They are listed a second time below, since | |
616ebcfd | 356 | we can't intermix extern's and initializers. */ |
cf39664e | 357 | extern bfd_target a29kcoff_big_vec; |
218ce930 | 358 | extern bfd_target a_out_adobe_vec; |
cf39664e DM |
359 | extern bfd_target aout_mips_big_vec; |
360 | extern bfd_target aout_mips_little_vec; | |
3bca0336 | 361 | extern bfd_target apollocoff_vec; |
4a81b561 | 362 | extern bfd_target b_out_vec_big_host; |
cf39664e DM |
363 | extern bfd_target b_out_vec_little_host; |
364 | extern bfd_target bfd_elf32_big_generic_vec; | |
365 | extern bfd_target bfd_elf32_bigmips_vec; | |
366 | extern bfd_target bfd_elf32_hppa_vec; | |
9942e684 | 367 | extern bfd_target bfd_elf32_i386_vec; |
9942e684 | 368 | extern bfd_target bfd_elf32_i860_vec; |
ebd24135 | 369 | extern bfd_target bfd_elf32_little_generic_vec; |
cf39664e DM |
370 | extern bfd_target bfd_elf32_littlemips_vec; |
371 | extern bfd_target bfd_elf32_m68k_vec; | |
372 | extern bfd_target bfd_elf32_m88k_vec; | |
fdfe2d14 | 373 | extern bfd_target bfd_elf32_powerpc_vec; |
cf39664e | 374 | extern bfd_target bfd_elf32_sparc_vec; |
ebd24135 ILT |
375 | extern bfd_target bfd_elf64_big_generic_vec; |
376 | extern bfd_target bfd_elf64_little_generic_vec; | |
cf39664e DM |
377 | /* start-sanitize-v9 */ |
378 | extern bfd_target bfd_elf64_sparc_vec; | |
379 | /* end-sanitize-v9 */ | |
380 | extern bfd_target demo_64_vec; | |
381 | extern bfd_target ecoff_big_vec; | |
382 | extern bfd_target ecoff_little_vec; | |
383 | extern bfd_target ecoffalpha_little_vec; | |
384 | extern bfd_target h8300coff_vec; | |
385 | extern bfd_target h8500coff_vec; | |
386 | extern bfd_target host_aout_vec; | |
387 | extern bfd_target hp300bsd_vec; | |
388 | extern bfd_target hp300hpux_vec; | |
3bca0336 | 389 | extern bfd_target som_vec; |
cf39664e DM |
390 | extern bfd_target i386aout_vec; |
391 | extern bfd_target i386bsd_vec; | |
2f88343d | 392 | extern bfd_target i386os9k_vec; |
3bca0336 | 393 | extern bfd_target netbsd386_vec; |
cf39664e DM |
394 | extern bfd_target i386coff_vec; |
395 | extern bfd_target i386linux_vec; | |
3bca0336 KR |
396 | extern bfd_target i386lynx_aout_vec; |
397 | extern bfd_target i386lynx_coff_vec; | |
2487f88f | 398 | extern bfd_target i386mach3_vec; |
cf39664e DM |
399 | extern bfd_target icoff_big_vec; |
400 | extern bfd_target icoff_little_vec; | |
401 | extern bfd_target ieee_vec; | |
402 | extern bfd_target m68kcoff_vec; | |
403 | extern bfd_target m68kcoffun_vec; | |
3bca0336 KR |
404 | extern bfd_target m68klynx_aout_vec; |
405 | extern bfd_target m68klynx_coff_vec; | |
cf39664e DM |
406 | extern bfd_target m88kbcs_vec; |
407 | extern bfd_target newsos3_vec; | |
cf39664e | 408 | extern bfd_target nlm32_i386_vec; |
c96451db | 409 | extern bfd_target nlm32_sparc_vec; |
4c3721d5 | 410 | extern bfd_target nlm32_alpha_vec; |
fdfe2d14 SS |
411 | /*start-sanitize-powerpc-netware*/ |
412 | extern bfd_target nlm32_powerpc_vec; | |
413 | /*end-sanitize-powerpc-netware*/ | |
aacf30e3 | 414 | extern bfd_target oasys_vec; |
cbdc7909 | 415 | extern bfd_target rs6000coff_vec; |
93b4f018 | 416 | extern bfd_target shcoff_vec; |
c188b0be DM |
417 | extern bfd_target sparclynx_aout_vec; |
418 | extern bfd_target sparclynx_coff_vec; | |
5984f609 | 419 | extern bfd_target sparccoff_vec; |
cf39664e DM |
420 | extern bfd_target sunos_big_vec; |
421 | extern bfd_target tekhex_vec; | |
422 | extern bfd_target we32kcoff_vec; | |
423 | extern bfd_target z8kcoff_vec; | |
424 | ||
425 | /* srec is always included. */ | |
426 | extern bfd_target srec_vec; | |
427 | extern bfd_target symbolsrec_vec; | |
428 | ||
429 | /* All of the xvecs for core files. */ | |
430 | extern bfd_target aix386_core_vec; | |
431 | extern bfd_target hpux_core_vec; | |
c96451db | 432 | extern bfd_target hppabsd_core_vec; |
dabfe2f6 | 433 | extern bfd_target irix_core_vec; |
3bca0336 | 434 | extern bfd_target osf_core_vec; |
cf39664e DM |
435 | extern bfd_target sco_core_vec; |
436 | extern bfd_target trad_core_vec; | |
dabfe2f6 | 437 | extern bfd_target ptrace_core_vec; |
f8adc62d | 438 | |
d1ad85a6 | 439 | bfd_target *bfd_target_vector[] = { |
4e6f9223 | 440 | |
2ebd0976 | 441 | #ifdef SELECT_VECS |
14e3c2e4 JK |
442 | |
443 | SELECT_VECS, | |
444 | ||
445 | #else /* not SELECT_VECS */ | |
f39b81f5 | 446 | |
cf39664e DM |
447 | #ifdef DEFAULT_VECTOR |
448 | &DEFAULT_VECTOR, | |
449 | #endif | |
450 | /* This list is alphabetized to make it easy to compare | |
451 | with other vector lists -- the decls above and | |
452 | the case statement in configure.in. | |
453 | Vectors that don't compile on all systems, or aren't finished, | |
454 | should have an entry here with #if 0 around it, to show that | |
455 | it wasn't omitted by mistake. */ | |
456 | &a29kcoff_big_vec, | |
457 | &a_out_adobe_vec, | |
458 | #if 0 /* No one seems to use this. */ | |
2ebd0976 | 459 | &aout_mips_big_vec, |
cf39664e DM |
460 | #endif |
461 | &aout_mips_little_vec, | |
462 | &b_out_vec_big_host, | |
463 | &b_out_vec_little_host, | |
56a2f341 JK |
464 | |
465 | /* This, and other vectors, may not be used in any *.mt configuration. | |
466 | But that does not mean they are unnecessary. If configured | |
467 | --with-targets=all, objdump or gdb should be able to examine | |
468 | the file even if we don't recognize the machine type. */ | |
cf39664e | 469 | &bfd_elf32_big_generic_vec, |
7218bb04 | 470 | &bfd_elf32_bigmips_vec, |
cf39664e | 471 | &bfd_elf32_hppa_vec, |
cf39664e DM |
472 | &bfd_elf32_i386_vec, |
473 | &bfd_elf32_i860_vec, | |
cf39664e | 474 | &bfd_elf32_little_generic_vec, |
7218bb04 | 475 | &bfd_elf32_littlemips_vec, |
cf39664e DM |
476 | &bfd_elf32_m68k_vec, |
477 | &bfd_elf32_m88k_vec, | |
478 | &bfd_elf32_sparc_vec, | |
479 | #ifdef BFD64 /* No one seems to use this. */ | |
480 | &bfd_elf64_big_generic_vec, | |
481 | &bfd_elf64_little_generic_vec, | |
482 | #endif | |
483 | /* start-sanitize-v9 */ | |
484 | #if 0 | |
485 | &bfd_elf64_sparc_vec, | |
486 | #endif | |
487 | /* end-sanitize-v9 */ | |
2c4f2c72 | 488 | #ifdef BFD64 |
f39b81f5 | 489 | &demo_64_vec, /* Only compiled if host has long-long support */ |
cf39664e DM |
490 | #endif |
491 | &ecoff_big_vec, | |
492 | &ecoff_little_vec, | |
493 | #if 0 | |
494 | &ecoffalpha_little_vec, | |
f39b81f5 SC |
495 | #endif |
496 | &h8300coff_vec, | |
cf39664e | 497 | &h8500coff_vec, |
5f9a2245 | 498 | #if 0 |
56a2f341 JK |
499 | /* Since a.out files lack decent magic numbers, no way to recognize |
500 | which kind of a.out file it is. */ | |
cf39664e | 501 | &host_aout_vec, |
5f9a2245 | 502 | #endif |
c8e1d00b | 503 | #if 0 /* Clashes with sunos_big_vec magic no. */ |
cf39664e | 504 | &hp300bsd_vec, |
c8e1d00b | 505 | #endif |
cf39664e | 506 | &hp300hpux_vec, |
d1ad85a6 | 507 | #if defined (HOST_HPPAHPUX) || defined (HOST_HPPABSD) || defined (HOST_HPPAOSF) |
3bca0336 | 508 | &som_vec, |
cf39664e DM |
509 | #endif |
510 | &i386aout_vec, | |
511 | &i386bsd_vec, | |
3bca0336 | 512 | &netbsd386_vec, |
cf39664e DM |
513 | &i386coff_vec, |
514 | #if 0 | |
56a2f341 JK |
515 | /* Since a.out files lack decent magic numbers, no way to recognize |
516 | which kind of a.out file it is. */ | |
cf39664e DM |
517 | &i386linux_vec, |
518 | #endif | |
3bca0336 KR |
519 | &i386lynx_aout_vec, |
520 | &i386lynx_coff_vec, | |
2f88343d | 521 | &i386os9k_vec, |
f39b81f5 | 522 | &icoff_big_vec, |
cf39664e DM |
523 | &icoff_little_vec, |
524 | &ieee_vec, | |
525 | &m68kcoff_vec, | |
526 | &m68kcoffun_vec, | |
3bca0336 KR |
527 | &m68klynx_aout_vec, |
528 | &m68klynx_coff_vec, | |
cf39664e DM |
529 | &m88kbcs_vec, |
530 | &newsos3_vec, | |
493a2593 | 531 | &nlm32_i386_vec, |
c96451db | 532 | &nlm32_sparc_vec, |
ebd24135 | 533 | #ifdef BFD64 |
3b31740c | 534 | &nlm32_alpha_vec, |
cf39664e DM |
535 | #endif |
536 | #if 0 | |
537 | /* We have no oasys tools anymore, so we can't test any of this | |
538 | anymore. If you want to test the stuff yourself, go ahead... | |
539 | steve@cygnus.com | |
540 | Worse, since there is no magic number for archives, there | |
541 | can be annoying target mis-matches. */ | |
542 | &oasys_vec, | |
ebd24135 | 543 | #endif |
f39b81f5 | 544 | &rs6000coff_vec, |
cf39664e | 545 | &shcoff_vec, |
c188b0be DM |
546 | &sparclynx_aout_vec, |
547 | &sparclynx_coff_vec, | |
cf39664e DM |
548 | &sunos_big_vec, |
549 | #if 0 | |
550 | &tekhex_vec, | |
e3c01e92 | 551 | #endif |
6697a1a9 | 552 | &we32kcoff_vec, |
cf39664e | 553 | &z8kcoff_vec, |
f39b81f5 | 554 | |
5f9a2245 DM |
555 | #endif /* not SELECT_VECS */ |
556 | ||
180acef5 DM |
557 | /* Always support S-records, for convenience. */ |
558 | &srec_vec, | |
559 | &symbolsrec_vec, | |
560 | ||
5f9a2245 DM |
561 | /* Add any required traditional-core-file-handler. */ |
562 | ||
60ac749c | 563 | #ifdef AIX386_CORE |
2c4f2c72 | 564 | &aix386_core_vec, |
f39b81f5 | 565 | #endif |
a643e626 ILT |
566 | #ifdef HPUX_CORE |
567 | &hpux_core_vec, | |
568 | #endif | |
c96451db SEF |
569 | #ifdef HPPABSD_CORE |
570 | &hppabsd_core_vec, | |
571 | #endif | |
dabfe2f6 ILT |
572 | #ifdef IRIX_CORE |
573 | &irix_core_vec, | |
574 | #endif | |
3bca0336 KR |
575 | #ifdef OSF_CORE |
576 | &osf_core_vec, | |
577 | #endif | |
cf39664e DM |
578 | #ifdef TRAD_CORE |
579 | &trad_core_vec, | |
580 | #endif | |
2ebd0976 | 581 | |
dabfe2f6 ILT |
582 | #ifdef PTRACE_CORE |
583 | &ptrace_core_vec, | |
584 | #endif | |
585 | ||
5f9a2245 | 586 | NULL /* end of list marker */ |
7d774e01 | 587 | }; |
c0e5039e | 588 | |
d1ad85a6 | 589 | /* bfd_default_vector[0] contains either the address of the default vector, |
c0e5039e JG |
590 | if there is one, or zero if there isn't. */ |
591 | ||
d1ad85a6 | 592 | bfd_target *bfd_default_vector[] = { |
c0e5039e | 593 | #ifdef DEFAULT_VECTOR |
616ebcfd | 594 | &DEFAULT_VECTOR, |
378dac8c | 595 | #endif |
5f9a2245 | 596 | NULL |
c0e5039e | 597 | }; |
6f715d66 | 598 | |
d1ad85a6 DM |
599 | /* When there is an ambiguous match, bfd_check_format_matches puts the |
600 | names of the matching targets in an array. This variable is the maximum | |
601 | number of entries that the array could possibly need. */ | |
602 | CONST size_t _bfd_target_vector_entries = sizeof(bfd_target_vector)/sizeof(*bfd_target_vector); | |
6f715d66 | 603 | |
0cda46cf SC |
604 | /* |
605 | FUNCTION | |
606 | bfd_find_target | |
607 | ||
c188b0be DM |
608 | SYNOPSIS |
609 | bfd_target *bfd_find_target(CONST char *target_name, bfd *abfd); | |
610 | ||
0cda46cf | 611 | DESCRIPTION |
c188b0be | 612 | Return a pointer to the transfer vector for the object target |
c96451db SEF |
613 | named @var{target_name}. If @var{target_name} is <<NULL>>, choose the |
614 | one in the environment variable <<GNUTARGET>>; if that is null or not | |
c188b0be | 615 | defined, then choose the first entry in the target list. |
0cda46cf SC |
616 | Passing in the string "default" or setting the environment |
617 | variable to "default" will cause the first entry in the target | |
618 | list to be returned, and "target_defaulted" will be set in the | |
619 | BFD. This causes <<bfd_check_format>> to loop over all the | |
620 | targets to find the one that matches the file being read. | |
0cda46cf | 621 | */ |
6f715d66 SC |
622 | |
623 | bfd_target * | |
57a1867e DM |
624 | bfd_find_target (target_name, abfd) |
625 | CONST char *target_name; | |
626 | bfd *abfd; | |
6f715d66 SC |
627 | { |
628 | bfd_target **target; | |
629 | extern char *getenv (); | |
f8adc62d JG |
630 | CONST char *targname = (target_name ? target_name : |
631 | (CONST char *) getenv ("GNUTARGET")); | |
6f715d66 SC |
632 | |
633 | /* This is safe; the vector cannot be null */ | |
634 | if (targname == NULL || !strcmp (targname, "default")) { | |
635 | abfd->target_defaulted = true; | |
d1ad85a6 | 636 | return abfd->xvec = bfd_target_vector[0]; |
6f715d66 SC |
637 | } |
638 | ||
639 | abfd->target_defaulted = false; | |
640 | ||
d1ad85a6 | 641 | for (target = &bfd_target_vector[0]; *target != NULL; target++) { |
6f715d66 SC |
642 | if (!strcmp (targname, (*target)->name)) |
643 | return abfd->xvec = *target; | |
644 | } | |
645 | ||
d1ad85a6 | 646 | bfd_set_error (bfd_error_invalid_target); |
6f715d66 SC |
647 | return NULL; |
648 | } | |
649 | ||
650 | ||
0cda46cf SC |
651 | /* |
652 | FUNCTION | |
653 | bfd_target_list | |
654 | ||
0cda46cf | 655 | SYNOPSIS |
69e0d34d | 656 | CONST char **bfd_target_list(void); |
0cda46cf | 657 | |
c188b0be DM |
658 | DESCRIPTION |
659 | Return a freshly malloced NULL-terminated | |
660 | vector of the names of all the valid BFD targets. Do not | |
661 | modify the names. | |
662 | ||
0cda46cf | 663 | */ |
6f715d66 SC |
664 | |
665 | CONST char ** | |
57a1867e | 666 | bfd_target_list () |
6f715d66 SC |
667 | { |
668 | int vec_length= 0; | |
990e7c22 JG |
669 | #ifdef NATIVE_HPPAHPUX_COMPILER |
670 | /* The native compiler on the HP9000/700 has a bug which causes it | |
671 | to loop endlessly when compiling this file. This avoids it. */ | |
672 | volatile | |
673 | #endif | |
674 | bfd_target **target; | |
4e6f9223 | 675 | CONST char **name_list, **name_ptr; |
6f715d66 | 676 | |
d1ad85a6 | 677 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
678 | vec_length++; |
679 | ||
d1ad85a6 DM |
680 | name_ptr = name_list = (CONST char **) |
681 | bfd_zmalloc ((vec_length + 1) * sizeof (char **)); | |
6f715d66 SC |
682 | |
683 | if (name_list == NULL) { | |
d1ad85a6 | 684 | bfd_set_error (bfd_error_no_memory); |
6f715d66 SC |
685 | return NULL; |
686 | } | |
687 | ||
d1ad85a6 | 688 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
689 | *(name_ptr++) = (*target)->name; |
690 | ||
691 | return name_list; | |
692 | } |