Commit | Line | Data |
---|---|---|
252b5132 | 1 | /* Generic target-file-type support for the BFD library. |
5b93d8bb | 2 | Copyright 1990, 91, 92, 93, 94, 95, 96, 97, 98, 99, 2000 |
252b5132 RH |
3 | Free Software Foundation, Inc. |
4 | Written by Cygnus Support. | |
5 | ||
6 | This file is part of BFD, the Binary File Descriptor library. | |
7 | ||
8 | This program is free software; you can redistribute it and/or modify | |
9 | it under the terms of the GNU General Public License as published by | |
10 | the Free Software Foundation; either version 2 of the License, or | |
11 | (at your option) any later version. | |
12 | ||
13 | This program is distributed in the hope that it will be useful, | |
14 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | GNU General Public License for more details. | |
17 | ||
18 | You should have received a copy of the GNU General Public License | |
19 | along with this program; if not, write to the Free Software | |
20 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ | |
21 | ||
22 | #include "bfd.h" | |
23 | #include "sysdep.h" | |
24 | #include "libbfd.h" | |
25 | #include "fnmatch.h" | |
26 | ||
27 | /* | |
28 | SECTION | |
29 | Targets | |
30 | ||
31 | DESCRIPTION | |
32 | Each port of BFD to a different machine requries the creation | |
33 | of a target back end. All the back end provides to the root | |
34 | part of BFD is a structure containing pointers to functions | |
35 | which perform certain low level operations on files. BFD | |
36 | translates the applications's requests through a pointer into | |
37 | calls to the back end routines. | |
38 | ||
39 | When a file is opened with <<bfd_openr>>, its format and | |
40 | target are unknown. BFD uses various mechanisms to determine | |
41 | how to interpret the file. The operations performed are: | |
42 | ||
43 | o Create a BFD by calling the internal routine | |
44 | <<_bfd_new_bfd>>, then call <<bfd_find_target>> with the | |
45 | target string supplied to <<bfd_openr>> and the new BFD pointer. | |
46 | ||
47 | o If a null target string was provided to <<bfd_find_target>>, | |
48 | look up the environment variable <<GNUTARGET>> and use | |
49 | that as the target string. | |
50 | ||
51 | o If the target string is still <<NULL>>, or the target string is | |
52 | <<default>>, then use the first item in the target vector | |
53 | as the target type, and set <<target_defaulted>> in the BFD to | |
54 | cause <<bfd_check_format>> to loop through all the targets. | |
55 | @xref{bfd_target}. @xref{Formats}. | |
56 | ||
57 | o Otherwise, inspect the elements in the target vector | |
58 | one by one, until a match on target name is found. When found, | |
59 | use it. | |
60 | ||
61 | o Otherwise return the error <<bfd_error_invalid_target>> to | |
62 | <<bfd_openr>>. | |
63 | ||
64 | o <<bfd_openr>> attempts to open the file using | |
65 | <<bfd_open_file>>, and returns the BFD. | |
66 | ||
67 | Once the BFD has been opened and the target selected, the file | |
68 | format may be determined. This is done by calling | |
69 | <<bfd_check_format>> on the BFD with a suggested format. | |
70 | If <<target_defaulted>> has been set, each possible target | |
71 | type is tried to see if it recognizes the specified format. | |
72 | <<bfd_check_format>> returns <<true>> when the caller guesses right. | |
73 | @menu | |
74 | @* bfd_target:: | |
75 | @end menu | |
76 | */ | |
77 | ||
78 | ||
79 | /* | |
80 | ||
81 | INODE | |
82 | bfd_target, , Targets, Targets | |
83 | DOCDD | |
84 | SUBSECTION | |
85 | bfd_target | |
86 | ||
87 | DESCRIPTION | |
88 | This structure contains everything that BFD knows about a | |
89 | target. It includes things like its byte order, name, and which | |
90 | routines to call to do various operations. | |
91 | ||
92 | Every BFD points to a target structure with its <<xvec>> | |
93 | member. | |
94 | ||
95 | The macros below are used to dispatch to functions through the | |
96 | <<bfd_target>> vector. They are used in a number of macros further | |
97 | down in @file{bfd.h}, and are also used when calling various | |
98 | routines by hand inside the BFD implementation. The @var{arglist} | |
99 | argument must be parenthesized; it contains all the arguments | |
100 | to the called function. | |
101 | ||
102 | They make the documentation (more) unpleasant to read, so if | |
103 | someone wants to fix this and not break the above, please do. | |
104 | ||
105 | .#define BFD_SEND(bfd, message, arglist) \ | |
106 | . ((*((bfd)->xvec->message)) arglist) | |
107 | . | |
108 | .#ifdef DEBUG_BFD_SEND | |
109 | .#undef BFD_SEND | |
110 | .#define BFD_SEND(bfd, message, arglist) \ | |
111 | . (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \ | |
112 | . ((*((bfd)->xvec->message)) arglist) : \ | |
113 | . (bfd_assert (__FILE__,__LINE__), NULL)) | |
114 | .#endif | |
115 | ||
116 | For operations which index on the BFD format: | |
117 | ||
118 | .#define BFD_SEND_FMT(bfd, message, arglist) \ | |
119 | . (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) | |
120 | . | |
121 | .#ifdef DEBUG_BFD_SEND | |
122 | .#undef BFD_SEND_FMT | |
123 | .#define BFD_SEND_FMT(bfd, message, arglist) \ | |
124 | . (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \ | |
125 | . (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) : \ | |
126 | . (bfd_assert (__FILE__,__LINE__), NULL)) | |
127 | .#endif | |
128 | ||
129 | This is the structure which defines the type of BFD this is. The | |
130 | <<xvec>> member of the struct <<bfd>> itself points here. Each | |
131 | module that implements access to a different target under BFD, | |
132 | defines one of these. | |
133 | ||
134 | ||
135 | FIXME, these names should be rationalised with the names of | |
136 | the entry points which call them. Too bad we can't have one | |
137 | macro to define them both! | |
138 | ||
139 | .enum bfd_flavour { | |
140 | . bfd_target_unknown_flavour, | |
141 | . bfd_target_aout_flavour, | |
142 | . bfd_target_coff_flavour, | |
143 | . bfd_target_ecoff_flavour, | |
9bd09e22 | 144 | . bfd_target_xcoff_flavour, |
252b5132 RH |
145 | . bfd_target_elf_flavour, |
146 | . bfd_target_ieee_flavour, | |
147 | . bfd_target_nlm_flavour, | |
148 | . bfd_target_oasys_flavour, | |
149 | . bfd_target_tekhex_flavour, | |
150 | . bfd_target_srec_flavour, | |
151 | . bfd_target_ihex_flavour, | |
152 | . bfd_target_som_flavour, | |
153 | . bfd_target_os9k_flavour, | |
154 | . bfd_target_versados_flavour, | |
155 | . bfd_target_msdos_flavour, | |
156 | . bfd_target_ovax_flavour, | |
157 | . bfd_target_evax_flavour | |
158 | .}; | |
159 | . | |
160 | .enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN }; | |
161 | . | |
162 | .{* Forward declaration. *} | |
163 | .typedef struct bfd_link_info _bfd_link_info; | |
164 | . | |
165 | .typedef struct bfd_target | |
166 | .{ | |
167 | ||
168 | Identifies the kind of target, e.g., SunOS4, Ultrix, etc. | |
169 | ||
170 | . char *name; | |
171 | ||
172 | The "flavour" of a back end is a general indication about the contents | |
173 | of a file. | |
174 | ||
175 | . enum bfd_flavour flavour; | |
176 | ||
177 | The order of bytes within the data area of a file. | |
178 | ||
179 | . enum bfd_endian byteorder; | |
180 | ||
181 | The order of bytes within the header parts of a file. | |
182 | ||
183 | . enum bfd_endian header_byteorder; | |
184 | ||
185 | A mask of all the flags which an executable may have set - | |
186 | from the set <<BFD_NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>. | |
187 | ||
188 | . flagword object_flags; | |
189 | ||
190 | A mask of all the flags which a section may have set - from | |
191 | the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>. | |
192 | ||
193 | . flagword section_flags; | |
194 | ||
195 | The character normally found at the front of a symbol | |
196 | (if any), perhaps `_'. | |
197 | ||
198 | . char symbol_leading_char; | |
199 | ||
200 | The pad character for file names within an archive header. | |
201 | ||
202 | . char ar_pad_char; | |
203 | ||
204 | The maximum number of characters in an archive header. | |
205 | ||
206 | . unsigned short ar_max_namelen; | |
207 | ||
208 | Entries for byte swapping for data. These are different from the other | |
209 | entry points, since they don't take a BFD asthe first argument. | |
210 | Certain other handlers could do the same. | |
211 | ||
212 | . bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *)); | |
213 | . bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *)); | |
214 | . void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *)); | |
215 | . bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *)); | |
216 | . bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *)); | |
217 | . void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *)); | |
218 | . bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *)); | |
219 | . bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *)); | |
220 | . void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *)); | |
221 | ||
222 | Byte swapping for the headers | |
223 | ||
224 | . bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *)); | |
225 | . bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *)); | |
226 | . void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *)); | |
227 | . bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *)); | |
228 | . bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *)); | |
229 | . void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *)); | |
230 | . bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *)); | |
231 | . bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *)); | |
232 | . void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *)); | |
233 | ||
234 | Format dependent routines: these are vectors of entry points | |
235 | within the target vector structure, one for each format to check. | |
236 | ||
237 | Check the format of a file being read. Return a <<bfd_target *>> or zero. | |
238 | ||
239 | . const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *)); | |
240 | ||
241 | Set the format of a file being written. | |
242 | ||
243 | . boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *)); | |
244 | ||
245 | Write cached information into a file being written, at <<bfd_close>>. | |
246 | ||
247 | . boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *)); | |
248 | ||
f994cccc ILT |
249 | The general target vector. These vectors are initialized using the |
250 | BFD_JUMP_TABLE macros. | |
252b5132 RH |
251 | |
252 | . | |
253 | . {* Generic entry points. *} | |
254 | .#define BFD_JUMP_TABLE_GENERIC(NAME)\ | |
255 | .CAT(NAME,_close_and_cleanup),\ | |
256 | .CAT(NAME,_bfd_free_cached_info),\ | |
257 | .CAT(NAME,_new_section_hook),\ | |
258 | .CAT(NAME,_get_section_contents),\ | |
259 | .CAT(NAME,_get_section_contents_in_window) | |
260 | . | |
261 | . {* Called when the BFD is being closed to do any necessary cleanup. *} | |
262 | . boolean (*_close_and_cleanup) PARAMS ((bfd *)); | |
263 | . {* Ask the BFD to free all cached information. *} | |
264 | . boolean (*_bfd_free_cached_info) PARAMS ((bfd *)); | |
265 | . {* Called when a new section is created. *} | |
266 | . boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr)); | |
267 | . {* Read the contents of a section. *} | |
268 | . boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
269 | . file_ptr, bfd_size_type)); | |
270 | . boolean (*_bfd_get_section_contents_in_window) | |
271 | . PARAMS ((bfd *, sec_ptr, bfd_window *, | |
272 | . file_ptr, bfd_size_type)); | |
273 | . | |
274 | . {* Entry points to copy private data. *} | |
275 | .#define BFD_JUMP_TABLE_COPY(NAME)\ | |
276 | .CAT(NAME,_bfd_copy_private_bfd_data),\ | |
277 | .CAT(NAME,_bfd_merge_private_bfd_data),\ | |
278 | .CAT(NAME,_bfd_copy_private_section_data),\ | |
279 | .CAT(NAME,_bfd_copy_private_symbol_data),\ | |
280 | .CAT(NAME,_bfd_set_private_flags),\ | |
281 | .CAT(NAME,_bfd_print_private_bfd_data)\ | |
282 | . {* Called to copy BFD general private data from one object file | |
283 | . to another. *} | |
284 | . boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *)); | |
285 | . {* Called to merge BFD general private data from one object file | |
286 | . to a common output file when linking. *} | |
287 | . boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *)); | |
288 | . {* Called to copy BFD private section data from one object file | |
289 | . to another. *} | |
290 | . boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr, | |
291 | . bfd *, sec_ptr)); | |
292 | . {* Called to copy BFD private symbol data from one symbol | |
293 | . to another. *} | |
294 | . boolean (*_bfd_copy_private_symbol_data) PARAMS ((bfd *, asymbol *, | |
295 | . bfd *, asymbol *)); | |
296 | . {* Called to set private backend flags *} | |
297 | . boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword)); | |
298 | . | |
299 | . {* Called to print private BFD data *} | |
300 | . boolean (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR)); | |
301 | . | |
302 | . {* Core file entry points. *} | |
303 | .#define BFD_JUMP_TABLE_CORE(NAME)\ | |
304 | .CAT(NAME,_core_file_failing_command),\ | |
305 | .CAT(NAME,_core_file_failing_signal),\ | |
306 | .CAT(NAME,_core_file_matches_executable_p) | |
307 | . char * (*_core_file_failing_command) PARAMS ((bfd *)); | |
308 | . int (*_core_file_failing_signal) PARAMS ((bfd *)); | |
309 | . boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *)); | |
310 | . | |
311 | . {* Archive entry points. *} | |
312 | .#define BFD_JUMP_TABLE_ARCHIVE(NAME)\ | |
313 | .CAT(NAME,_slurp_armap),\ | |
314 | .CAT(NAME,_slurp_extended_name_table),\ | |
315 | .CAT(NAME,_construct_extended_name_table),\ | |
316 | .CAT(NAME,_truncate_arname),\ | |
317 | .CAT(NAME,_write_armap),\ | |
318 | .CAT(NAME,_read_ar_hdr),\ | |
319 | .CAT(NAME,_openr_next_archived_file),\ | |
320 | .CAT(NAME,_get_elt_at_index),\ | |
321 | .CAT(NAME,_generic_stat_arch_elt),\ | |
77fb9c28 | 322 | .CAT(NAME,_update_armap_timestamp) |
252b5132 RH |
323 | . boolean (*_bfd_slurp_armap) PARAMS ((bfd *)); |
324 | . boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *)); | |
325 | . boolean (*_bfd_construct_extended_name_table) | |
326 | . PARAMS ((bfd *, char **, bfd_size_type *, const char **)); | |
327 | . void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *)); | |
328 | . boolean (*write_armap) PARAMS ((bfd *arch, | |
329 | . unsigned int elength, | |
330 | . struct orl *map, | |
331 | . unsigned int orl_count, | |
332 | . int stridx)); | |
77fb9c28 | 333 | . PTR (*_bfd_read_ar_hdr_fn) PARAMS ((bfd *)); |
252b5132 RH |
334 | . bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev)); |
335 | .#define bfd_get_elt_at_index(b,i) BFD_SEND(b, _bfd_get_elt_at_index, (b,i)) | |
336 | . bfd * (*_bfd_get_elt_at_index) PARAMS ((bfd *, symindex)); | |
337 | . int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *)); | |
338 | . boolean (*_bfd_update_armap_timestamp) PARAMS ((bfd *)); | |
339 | . | |
340 | . {* Entry points used for symbols. *} | |
341 | .#define BFD_JUMP_TABLE_SYMBOLS(NAME)\ | |
342 | .CAT(NAME,_get_symtab_upper_bound),\ | |
343 | .CAT(NAME,_get_symtab),\ | |
344 | .CAT(NAME,_make_empty_symbol),\ | |
345 | .CAT(NAME,_print_symbol),\ | |
346 | .CAT(NAME,_get_symbol_info),\ | |
347 | .CAT(NAME,_bfd_is_local_label_name),\ | |
348 | .CAT(NAME,_get_lineno),\ | |
349 | .CAT(NAME,_find_nearest_line),\ | |
350 | .CAT(NAME,_bfd_make_debug_symbol),\ | |
351 | .CAT(NAME,_read_minisymbols),\ | |
352 | .CAT(NAME,_minisymbol_to_symbol) | |
353 | . long (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *)); | |
354 | . long (*_bfd_canonicalize_symtab) PARAMS ((bfd *, | |
355 | . struct symbol_cache_entry **)); | |
356 | . struct symbol_cache_entry * | |
357 | . (*_bfd_make_empty_symbol) PARAMS ((bfd *)); | |
358 | . void (*_bfd_print_symbol) PARAMS ((bfd *, PTR, | |
359 | . struct symbol_cache_entry *, | |
360 | . bfd_print_symbol_type)); | |
361 | .#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e)) | |
362 | . void (*_bfd_get_symbol_info) PARAMS ((bfd *, | |
363 | . struct symbol_cache_entry *, | |
364 | . symbol_info *)); | |
365 | .#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e)) | |
366 | . boolean (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *)); | |
367 | . | |
368 | . alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *)); | |
369 | . boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd, | |
370 | . struct sec *section, struct symbol_cache_entry **symbols, | |
371 | . bfd_vma offset, CONST char **file, CONST char **func, | |
372 | . unsigned int *line)); | |
373 | . {* Back-door to allow format-aware applications to create debug symbols | |
374 | . while using BFD for everything else. Currently used by the assembler | |
375 | . when creating COFF files. *} | |
376 | . asymbol * (*_bfd_make_debug_symbol) PARAMS (( | |
377 | . bfd *abfd, | |
378 | . void *ptr, | |
379 | . unsigned long size)); | |
380 | .#define bfd_read_minisymbols(b, d, m, s) \ | |
381 | . BFD_SEND (b, _read_minisymbols, (b, d, m, s)) | |
382 | . long (*_read_minisymbols) PARAMS ((bfd *, boolean, PTR *, | |
383 | . unsigned int *)); | |
384 | .#define bfd_minisymbol_to_symbol(b, d, m, f) \ | |
385 | . BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f)) | |
386 | . asymbol *(*_minisymbol_to_symbol) PARAMS ((bfd *, boolean, const PTR, | |
387 | . asymbol *)); | |
388 | . | |
389 | . {* Routines for relocs. *} | |
390 | .#define BFD_JUMP_TABLE_RELOCS(NAME)\ | |
391 | .CAT(NAME,_get_reloc_upper_bound),\ | |
392 | .CAT(NAME,_canonicalize_reloc),\ | |
393 | .CAT(NAME,_bfd_reloc_type_lookup) | |
394 | . long (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr)); | |
395 | . long (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **, | |
396 | . struct symbol_cache_entry **)); | |
397 | . {* See documentation on reloc types. *} | |
398 | . reloc_howto_type * | |
399 | . (*reloc_type_lookup) PARAMS ((bfd *abfd, | |
400 | . bfd_reloc_code_real_type code)); | |
401 | . | |
402 | . {* Routines used when writing an object file. *} | |
403 | .#define BFD_JUMP_TABLE_WRITE(NAME)\ | |
404 | .CAT(NAME,_set_arch_mach),\ | |
405 | .CAT(NAME,_set_section_contents) | |
406 | . boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture, | |
407 | . unsigned long)); | |
408 | . boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
409 | . file_ptr, bfd_size_type)); | |
410 | . | |
411 | . {* Routines used by the linker. *} | |
412 | .#define BFD_JUMP_TABLE_LINK(NAME)\ | |
413 | .CAT(NAME,_sizeof_headers),\ | |
414 | .CAT(NAME,_bfd_get_relocated_section_contents),\ | |
415 | .CAT(NAME,_bfd_relax_section),\ | |
416 | .CAT(NAME,_bfd_link_hash_table_create),\ | |
417 | .CAT(NAME,_bfd_link_add_symbols),\ | |
418 | .CAT(NAME,_bfd_final_link),\ | |
419 | .CAT(NAME,_bfd_link_split_section),\ | |
420 | .CAT(NAME,_bfd_gc_sections) | |
421 | . int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean)); | |
422 | . bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *, | |
423 | . struct bfd_link_info *, struct bfd_link_order *, | |
424 | . bfd_byte *data, boolean relocateable, | |
425 | . struct symbol_cache_entry **)); | |
426 | . | |
427 | . boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *, | |
428 | . struct bfd_link_info *, boolean *again)); | |
429 | . | |
430 | . {* Create a hash table for the linker. Different backends store | |
431 | . different information in this table. *} | |
432 | . struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *)); | |
433 | . | |
434 | . {* Add symbols from this object file into the hash table. *} | |
435 | . boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *)); | |
436 | . | |
437 | . {* Do a link based on the link_order structures attached to each | |
438 | . section of the BFD. *} | |
439 | . boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *)); | |
440 | . | |
441 | . {* Should this section be split up into smaller pieces during linking. *} | |
442 | . boolean (*_bfd_link_split_section) PARAMS ((bfd *, struct sec *)); | |
443 | . | |
444 | . {* Remove sections that are not referenced from the output. *} | |
445 | . boolean (*_bfd_gc_sections) PARAMS ((bfd *, struct bfd_link_info *)); | |
446 | . | |
447 | . {* Routines to handle dynamic symbols and relocs. *} | |
448 | .#define BFD_JUMP_TABLE_DYNAMIC(NAME)\ | |
449 | .CAT(NAME,_get_dynamic_symtab_upper_bound),\ | |
450 | .CAT(NAME,_canonicalize_dynamic_symtab),\ | |
451 | .CAT(NAME,_get_dynamic_reloc_upper_bound),\ | |
452 | .CAT(NAME,_canonicalize_dynamic_reloc) | |
453 | . {* Get the amount of memory required to hold the dynamic symbols. *} | |
454 | . long (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *)); | |
455 | . {* Read in the dynamic symbols. *} | |
456 | . long (*_bfd_canonicalize_dynamic_symtab) | |
457 | . PARAMS ((bfd *, struct symbol_cache_entry **)); | |
458 | . {* Get the amount of memory required to hold the dynamic relocs. *} | |
459 | . long (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *)); | |
460 | . {* Read in the dynamic relocs. *} | |
461 | . long (*_bfd_canonicalize_dynamic_reloc) | |
462 | . PARAMS ((bfd *, arelent **, struct symbol_cache_entry **)); | |
463 | . | |
464 | ||
c3c89269 NC |
465 | A pointer to an alternative bfd_target in case the current one is not |
466 | satisfactory. This can happen when the target cpu supports both big | |
467 | and little endian code, and target chosen by the linker has the wrong | |
468 | endianness. The function open_output() in ld/ldlang.c uses this field | |
469 | to find an alternative output format that is suitable. | |
470 | ||
471 | . {* Opposite endian version of this target. *} | |
472 | . const struct bfd_target * alternative_target; | |
473 | . | |
474 | ||
252b5132 RH |
475 | Data for use by back-end routines, which isn't generic enough to belong |
476 | in this structure. | |
477 | ||
478 | . PTR backend_data; | |
c3c89269 | 479 | . |
252b5132 RH |
480 | .} bfd_target; |
481 | ||
482 | */ | |
483 | ||
484 | /* All known xvecs (even those that don't compile on all systems). | |
485 | Alphabetized for easy reference. | |
486 | They are listed a second time below, since | |
487 | we can't intermix extern's and initializers. */ | |
488 | extern const bfd_target a29kcoff_big_vec; | |
489 | extern const bfd_target a_out_adobe_vec; | |
490 | extern const bfd_target aout_arm_big_vec; | |
491 | extern const bfd_target aout_arm_little_vec; | |
492 | extern const bfd_target aout_mips_big_vec; | |
493 | extern const bfd_target aout_mips_little_vec; | |
494 | extern const bfd_target aout0_big_vec; | |
495 | extern const bfd_target apollocoff_vec; | |
496 | extern const bfd_target armcoff_little_vec; | |
497 | extern const bfd_target armcoff_big_vec; | |
021e3cc0 | 498 | extern const bfd_target armnetbsd_vec; |
252b5132 RH |
499 | extern const bfd_target armpe_little_vec; |
500 | extern const bfd_target armpe_big_vec; | |
501 | extern const bfd_target armpei_little_vec; | |
502 | extern const bfd_target armpei_big_vec; | |
503 | extern const bfd_target arm_epoc_pe_little_vec; | |
504 | extern const bfd_target arm_epoc_pe_big_vec; | |
505 | extern const bfd_target arm_epoc_pei_little_vec; | |
506 | extern const bfd_target arm_epoc_pei_big_vec; | |
507 | extern const bfd_target b_out_vec_big_host; | |
508 | extern const bfd_target b_out_vec_little_host; | |
fac41780 JW |
509 | extern const bfd_target bfd_efi_app_ia32_vec; |
510 | extern const bfd_target bfd_efi_app_ia64_vec; | |
252b5132 | 511 | extern const bfd_target bfd_elf64_alpha_vec; |
9ffc64f4 | 512 | extern const bfd_target bfd_elf64_hppa_vec; |
800eeca4 JW |
513 | extern const bfd_target bfd_elf64_ia64_little_vec; |
514 | extern const bfd_target bfd_elf64_ia64_big_vec; | |
adde6300 | 515 | extern const bfd_target bfd_elf32_avr_vec; |
252b5132 RH |
516 | extern const bfd_target bfd_elf32_bigarc_vec; |
517 | extern const bfd_target bfd_elf32_bigarm_vec; | |
518 | extern const bfd_target bfd_elf32_bigarm_oabi_vec; | |
519 | extern const bfd_target bfd_elf32_littlearc_vec; | |
520 | extern const bfd_target bfd_elf32_littlearm_vec; | |
521 | extern const bfd_target bfd_elf32_littlearm_oabi_vec; | |
522 | extern const bfd_target bfd_elf32_big_generic_vec; | |
523 | extern const bfd_target bfd_elf32_bigmips_vec; | |
524 | extern const bfd_target bfd_elf64_bigmips_vec; | |
06c15ad7 | 525 | extern const bfd_target bfd_elf32_cris_vec; |
4da81684 | 526 | extern const bfd_target bfd_elf32_us_cris_vec; |
252b5132 RH |
527 | extern const bfd_target bfd_elf32_d10v_vec; |
528 | extern const bfd_target bfd_elf32_d30v_vec; | |
529 | extern const bfd_target bfd_elf32_hppa_vec; | |
5b93d8bb | 530 | extern const bfd_target bfd_elf32_i370_vec; |
252b5132 RH |
531 | extern const bfd_target bfd_elf32_i386_vec; |
532 | extern const bfd_target bfd_elf32_i860_vec; | |
9d751335 | 533 | extern const bfd_target bfd_elf32_i860_little_vec; |
b2ef150d | 534 | extern const bfd_target bfd_elf32_i960_vec; |
252b5132 RH |
535 | extern const bfd_target bfd_elf32_little_generic_vec; |
536 | extern const bfd_target bfd_elf32_littlemips_vec; | |
537 | extern const bfd_target bfd_elf64_littlemips_vec; | |
538 | extern const bfd_target bfd_elf32_m32r_vec; | |
60bcf0fa NC |
539 | extern const bfd_target bfd_elf32_m68hc11_vec; |
540 | extern const bfd_target bfd_elf32_m68hc12_vec; | |
252b5132 RH |
541 | extern const bfd_target bfd_elf32_m68k_vec; |
542 | extern const bfd_target bfd_elf32_m88k_vec; | |
543 | extern const bfd_target bfd_elf32_mn10200_vec; | |
544 | extern const bfd_target bfd_elf32_mn10300_vec; | |
0bcb993b ILT |
545 | extern const bfd_target bfd_elf32_pj_vec; |
546 | extern const bfd_target bfd_elf32_pjl_vec; | |
252b5132 RH |
547 | extern const bfd_target bfd_elf32_powerpc_vec; |
548 | extern const bfd_target bfd_elf32_powerpcle_vec; | |
549 | extern const bfd_target bfd_elf32_sh_vec; | |
550 | extern const bfd_target bfd_elf32_shl_vec; | |
b129bfef AO |
551 | extern const bfd_target bfd_elf32_shlin_vec; |
552 | extern const bfd_target bfd_elf32_shblin_vec; | |
252b5132 | 553 | extern const bfd_target bfd_elf32_sparc_vec; |
dd745cfa UC |
554 | extern const bfd_target bfd_elf32_tradbigmips_vec; |
555 | extern const bfd_target bfd_elf32_tradlittlemips_vec; | |
252b5132 RH |
556 | extern const bfd_target bfd_elf32_v850_vec; |
557 | extern const bfd_target bfd_elf32_fr30_vec; | |
558 | extern const bfd_target bfd_elf32_mcore_big_vec; | |
559 | extern const bfd_target bfd_elf32_mcore_little_vec; | |
560 | extern const bfd_target bfd_elf64_big_generic_vec; | |
561 | extern const bfd_target bfd_elf64_little_generic_vec; | |
562 | extern const bfd_target bfd_elf64_sparc_vec; | |
06c15ad7 | 563 | extern const bfd_target cris_aout_vec; |
252b5132 RH |
564 | extern const bfd_target demo_64_vec; |
565 | extern const bfd_target ecoff_big_vec; | |
566 | extern const bfd_target ecoff_little_vec; | |
567 | extern const bfd_target ecoff_biglittle_vec; | |
568 | extern const bfd_target ecoffalpha_little_vec; | |
569 | extern const bfd_target h8300coff_vec; | |
570 | extern const bfd_target h8500coff_vec; | |
571 | extern const bfd_target host_aout_vec; | |
572 | extern const bfd_target hp300bsd_vec; | |
573 | extern const bfd_target hp300hpux_vec; | |
574 | extern const bfd_target som_vec; | |
575 | extern const bfd_target i386aout_vec; | |
576 | extern const bfd_target i386bsd_vec; | |
577 | extern const bfd_target i386dynix_vec; | |
578 | extern const bfd_target i386freebsd_vec; | |
579 | extern const bfd_target i386os9k_vec; | |
580 | extern const bfd_target i386coff_vec; | |
581 | extern const bfd_target bfd_powerpc_pe_vec; | |
582 | extern const bfd_target bfd_powerpcle_pe_vec; | |
583 | extern const bfd_target bfd_powerpc_pei_vec; | |
584 | extern const bfd_target bfd_powerpcle_pei_vec; | |
585 | extern const bfd_target i386pe_vec; | |
586 | extern const bfd_target i386pei_vec; | |
587 | extern const bfd_target go32coff_vec; | |
588 | extern const bfd_target go32stubbedcoff_vec; | |
589 | extern const bfd_target i386linux_vec; | |
590 | extern const bfd_target i386lynx_aout_vec; | |
591 | extern const bfd_target i386lynx_coff_vec; | |
592 | extern const bfd_target i386mach3_vec; | |
593 | extern const bfd_target i386msdos_vec; | |
594 | extern const bfd_target i386netbsd_vec; | |
595 | extern const bfd_target i860coff_vec; | |
596 | extern const bfd_target icoff_big_vec; | |
597 | extern const bfd_target icoff_little_vec; | |
598 | extern const bfd_target ieee_vec; | |
599 | extern const bfd_target m68kaux_coff_vec; | |
600 | extern const bfd_target m68kcoff_vec; | |
601 | extern const bfd_target m68kcoffun_vec; | |
602 | extern const bfd_target m68klinux_vec; | |
603 | extern const bfd_target m68klynx_aout_vec; | |
604 | extern const bfd_target m68klynx_coff_vec; | |
605 | extern const bfd_target m68knetbsd_vec; | |
606 | extern const bfd_target m68ksysvcoff_vec; | |
607 | extern const bfd_target m68k4knetbsd_vec; | |
608 | extern const bfd_target m88kbcs_vec; | |
609 | extern const bfd_target m88kmach3_vec; | |
17505c5c NC |
610 | extern const bfd_target mipslpe_vec; |
611 | extern const bfd_target mipslpei_vec; | |
252b5132 RH |
612 | extern const bfd_target mcore_pe_big_vec; |
613 | extern const bfd_target mcore_pe_little_vec; | |
614 | extern const bfd_target mcore_pei_big_vec; | |
615 | extern const bfd_target mcore_pei_little_vec; | |
616 | extern const bfd_target newsos3_vec; | |
617 | extern const bfd_target nlm32_i386_vec; | |
618 | extern const bfd_target nlm32_sparc_vec; | |
619 | extern const bfd_target nlm32_alpha_vec; | |
620 | extern const bfd_target nlm32_powerpc_vec; | |
621 | extern const bfd_target pc532netbsd_vec; | |
622 | extern const bfd_target oasys_vec; | |
623 | extern const bfd_target pc532machaout_vec; | |
624 | extern const bfd_target ppcboot_vec; | |
625 | extern const bfd_target riscix_vec; | |
626 | extern const bfd_target pmac_xcoff_vec; | |
627 | extern const bfd_target rs6000coff_vec; | |
7f6d05e8 | 628 | extern const bfd_target rs6000coff64_vec; |
252b5132 RH |
629 | extern const bfd_target shcoff_vec; |
630 | extern const bfd_target shlcoff_vec; | |
631 | extern const bfd_target shcoff_small_vec; | |
632 | extern const bfd_target shlcoff_small_vec; | |
17505c5c NC |
633 | extern const bfd_target shlpe_vec; |
634 | extern const bfd_target shlpei_vec; | |
252b5132 RH |
635 | extern const bfd_target sparcle_aout_vec; |
636 | extern const bfd_target sparclinux_vec; | |
637 | extern const bfd_target sparclynx_aout_vec; | |
638 | extern const bfd_target sparclynx_coff_vec; | |
639 | extern const bfd_target sparcnetbsd_vec; | |
640 | extern const bfd_target sparccoff_vec; | |
641 | extern const bfd_target sunos_big_vec; | |
642 | extern const bfd_target tekhex_vec; | |
643 | extern const bfd_target tic30_aout_vec; | |
644 | extern const bfd_target tic30_coff_vec; | |
81635ce4 TW |
645 | extern const bfd_target tic54x_coff0_vec; |
646 | extern const bfd_target tic54x_coff0_beh_vec; | |
647 | extern const bfd_target tic54x_coff1_vec; | |
648 | extern const bfd_target tic54x_coff1_beh_vec; | |
649 | extern const bfd_target tic54x_coff2_vec; | |
650 | extern const bfd_target tic54x_coff2_beh_vec; | |
252b5132 RH |
651 | extern const bfd_target tic80coff_vec; |
652 | extern const bfd_target vaxnetbsd_vec; | |
653 | extern const bfd_target versados_vec; | |
654 | extern const bfd_target vms_alpha_vec; | |
655 | extern const bfd_target vms_vax_vec; | |
656 | extern const bfd_target we32kcoff_vec; | |
657 | extern const bfd_target w65_vec; | |
658 | extern const bfd_target z8kcoff_vec; | |
659 | ||
660 | /* srec is always included. */ | |
661 | extern const bfd_target srec_vec; | |
662 | extern const bfd_target symbolsrec_vec; | |
663 | ||
664 | /* binary is always included. */ | |
665 | extern const bfd_target binary_vec; | |
666 | ||
667 | /* ihex is always included. */ | |
668 | extern const bfd_target ihex_vec; | |
669 | ||
670 | /* All of the xvecs for core files. */ | |
671 | extern const bfd_target aix386_core_vec; | |
f4bda984 RH |
672 | extern const bfd_target cisco_core_big_vec; |
673 | extern const bfd_target cisco_core_little_vec; | |
252b5132 RH |
674 | extern const bfd_target hpux_core_vec; |
675 | extern const bfd_target hppabsd_core_vec; | |
676 | extern const bfd_target irix_core_vec; | |
677 | extern const bfd_target netbsd_core_vec; | |
678 | extern const bfd_target osf_core_vec; | |
679 | extern const bfd_target sco5_core_vec; | |
680 | extern const bfd_target trad_core_vec; | |
681 | extern const bfd_target ptrace_core_vec; | |
682 | ||
683 | const bfd_target * const bfd_target_vector[] = { | |
684 | ||
685 | #ifdef SELECT_VECS | |
686 | ||
687 | SELECT_VECS, | |
688 | ||
689 | #else /* not SELECT_VECS */ | |
690 | ||
691 | #ifdef DEFAULT_VECTOR | |
692 | &DEFAULT_VECTOR, | |
693 | #endif | |
694 | /* This list is alphabetized to make it easy to compare | |
695 | with other vector lists -- the decls above and | |
696 | the case statement in configure.in. | |
697 | Vectors that don't compile on all systems, or aren't finished, | |
698 | should have an entry here with #if 0 around it, to show that | |
699 | it wasn't omitted by mistake. */ | |
700 | &a29kcoff_big_vec, | |
701 | &a_out_adobe_vec, | |
702 | #if 0 /* No one seems to use this. */ | |
703 | &aout_mips_big_vec, | |
704 | #endif | |
705 | &aout_mips_little_vec, | |
706 | &b_out_vec_big_host, | |
707 | &b_out_vec_little_host, | |
708 | ||
fac41780 JW |
709 | &bfd_efi_app_ia32_vec, |
710 | #ifdef BFD64 | |
711 | &bfd_efi_app_ia64_vec, | |
712 | #endif | |
713 | ||
252b5132 RH |
714 | /* This, and other vectors, may not be used in any *.mt configuration. |
715 | But that does not mean they are unnecessary. If configured with | |
716 | --enable-targets=all, objdump or gdb should be able to examine | |
717 | the file even if we don't recognize the machine type. */ | |
718 | &bfd_elf32_big_generic_vec, | |
719 | #ifdef BFD64 | |
720 | &bfd_elf64_alpha_vec, | |
9ffc64f4 | 721 | &bfd_elf64_hppa_vec, |
800eeca4 JW |
722 | &bfd_elf64_ia64_little_vec, |
723 | &bfd_elf64_ia64_big_vec, | |
252b5132 | 724 | #endif |
adde6300 | 725 | &bfd_elf32_avr_vec, |
252b5132 RH |
726 | &bfd_elf32_bigarc_vec, |
727 | &bfd_elf32_bigarm_vec, | |
728 | &bfd_elf32_bigarm_oabi_vec, | |
729 | &bfd_elf32_bigmips_vec, | |
730 | #ifdef BFD64 | |
731 | &bfd_elf64_bigmips_vec, | |
732 | #endif | |
06c15ad7 | 733 | &bfd_elf32_cris_vec, |
4da81684 | 734 | &bfd_elf32_us_cris_vec, |
252b5132 RH |
735 | &bfd_elf32_d10v_vec, |
736 | &bfd_elf32_d30v_vec, | |
737 | &bfd_elf32_hppa_vec, | |
5b93d8bb | 738 | &bfd_elf32_i370_vec, |
252b5132 RH |
739 | &bfd_elf32_i386_vec, |
740 | &bfd_elf32_i860_vec, | |
9d751335 | 741 | &bfd_elf32_i860_little_vec, |
b2ef150d | 742 | &bfd_elf32_i960_vec, |
252b5132 RH |
743 | &bfd_elf32_little_generic_vec, |
744 | &bfd_elf32_littlearc_vec, | |
745 | &bfd_elf32_littlearm_vec, | |
746 | &bfd_elf32_littlearm_oabi_vec, | |
747 | &bfd_elf32_littlemips_vec, | |
748 | #ifdef BFD64 | |
749 | &bfd_elf64_littlemips_vec, | |
750 | #endif | |
751 | &bfd_elf32_m32r_vec, | |
752 | &bfd_elf32_mn10200_vec, | |
753 | &bfd_elf32_mn10300_vec, | |
60bcf0fa NC |
754 | &bfd_elf32_m68hc11_vec, |
755 | &bfd_elf32_m68hc12_vec, | |
252b5132 RH |
756 | &bfd_elf32_m68k_vec, |
757 | &bfd_elf32_m88k_vec, | |
758 | &bfd_elf32_sparc_vec, | |
0bcb993b ILT |
759 | &bfd_elf32_pj_vec, |
760 | &bfd_elf32_pjl_vec, | |
252b5132 RH |
761 | &bfd_elf32_powerpc_vec, |
762 | &bfd_elf32_powerpcle_vec, | |
763 | &bfd_elf32_v850_vec, | |
764 | &bfd_elf32_fr30_vec, | |
765 | &bfd_elf32_mcore_big_vec, | |
766 | &bfd_elf32_mcore_little_vec, | |
dd745cfa UC |
767 | &bfd_elf32_tradbigmips_vec, |
768 | &bfd_elf32_tradlittlemips_vec, | |
252b5132 RH |
769 | #ifdef BFD64 /* No one seems to use this. */ |
770 | &bfd_elf64_big_generic_vec, | |
771 | &bfd_elf64_little_generic_vec, | |
772 | #endif | |
773 | #if 0 | |
774 | &bfd_elf64_sparc_vec, | |
775 | #endif | |
f4bda984 | 776 | /* We don't include cisco_core_*_vec. Although it has a magic number, |
252b5132 RH |
777 | the magic number isn't at the beginning of the file, and thus |
778 | might spuriously match other kinds of files. */ | |
06c15ad7 HPN |
779 | |
780 | &cris_aout_vec, | |
252b5132 RH |
781 | #ifdef BFD64 |
782 | &demo_64_vec, /* Only compiled if host has long-long support */ | |
783 | #endif | |
784 | &ecoff_big_vec, | |
785 | &ecoff_little_vec, | |
786 | &ecoff_biglittle_vec, | |
787 | #ifdef BFD64 | |
788 | &ecoffalpha_little_vec, | |
789 | #endif | |
790 | &h8300coff_vec, | |
791 | &h8500coff_vec, | |
792 | #if 0 | |
793 | /* Since a.out files lack decent magic numbers, no way to recognize | |
794 | which kind of a.out file it is. */ | |
795 | &host_aout_vec, | |
796 | #endif | |
797 | #if 0 /* Clashes with sunos_big_vec magic no. */ | |
798 | &hp300bsd_vec, | |
799 | #endif | |
800 | &hp300hpux_vec, | |
801 | #if defined (HOST_HPPAHPUX) || defined (HOST_HPPABSD) || defined (HOST_HPPAOSF) | |
802 | &som_vec, | |
803 | #endif | |
804 | &i386aout_vec, | |
805 | &i386bsd_vec, | |
806 | &i386coff_vec, | |
807 | &i386freebsd_vec, | |
808 | &i860coff_vec, | |
809 | &bfd_powerpc_pe_vec, | |
810 | &bfd_powerpcle_pe_vec, | |
811 | &bfd_powerpc_pei_vec, | |
812 | &bfd_powerpcle_pei_vec, | |
813 | &go32coff_vec, | |
814 | &go32stubbedcoff_vec, | |
815 | #if 0 | |
816 | /* Since a.out files lack decent magic numbers, no way to recognize | |
817 | which kind of a.out file it is. */ | |
818 | &i386linux_vec, | |
819 | #endif | |
820 | &i386lynx_aout_vec, | |
821 | &i386lynx_coff_vec, | |
822 | #if 0 | |
823 | /* No distinguishing features for Mach 3 executables. */ | |
824 | &i386mach3_vec, | |
825 | #endif | |
826 | &i386msdos_vec, | |
827 | &i386netbsd_vec, | |
828 | &i386os9k_vec, | |
829 | &i386pe_vec, | |
830 | &i386pei_vec, | |
831 | &armcoff_little_vec, | |
832 | &armcoff_big_vec, | |
021e3cc0 | 833 | &armnetbsd_vec, |
252b5132 RH |
834 | &armpe_little_vec, |
835 | &armpe_big_vec, | |
836 | &armpei_little_vec, | |
837 | &armpei_big_vec, | |
838 | &arm_epoc_pe_little_vec, | |
839 | &arm_epoc_pe_big_vec, | |
840 | &arm_epoc_pei_little_vec, | |
841 | &arm_epoc_pei_big_vec, | |
842 | &icoff_big_vec, | |
843 | &icoff_little_vec, | |
844 | &ieee_vec, | |
845 | &m68kcoff_vec, | |
846 | &m68kcoffun_vec, | |
847 | #if 0 | |
848 | /* Since a.out files lack decent magic numbers, no way to recognize | |
849 | which kind of a.out file it is. */ | |
850 | &m68klinux_vec, | |
851 | #endif | |
852 | &m68klynx_aout_vec, | |
853 | &m68klynx_coff_vec, | |
854 | &m68knetbsd_vec, | |
855 | &m68ksysvcoff_vec, | |
856 | &m88kbcs_vec, | |
857 | &m88kmach3_vec, | |
858 | &mcore_pe_big_vec, | |
859 | &mcore_pe_little_vec, | |
860 | &mcore_pei_big_vec, | |
861 | &mcore_pei_little_vec, | |
862 | &newsos3_vec, | |
863 | &nlm32_i386_vec, | |
864 | &nlm32_sparc_vec, | |
865 | #ifdef BFD64 | |
866 | &nlm32_alpha_vec, | |
867 | #endif | |
868 | &pc532netbsd_vec, | |
869 | #if 0 | |
870 | /* We have no oasys tools anymore, so we can't test any of this | |
871 | anymore. If you want to test the stuff yourself, go ahead... | |
872 | steve@cygnus.com | |
873 | Worse, since there is no magic number for archives, there | |
874 | can be annoying target mis-matches. */ | |
875 | &oasys_vec, | |
876 | #endif | |
877 | &pc532machaout_vec, | |
878 | #if 0 | |
879 | /* We have no way of distinguishing these from other a.out variants */ | |
880 | &aout_arm_big_vec, | |
881 | &aout_arm_little_vec, | |
882 | &riscix_vec, | |
883 | #endif | |
884 | #if 0 | |
885 | /* This has the same magic number as RS/6000. */ | |
886 | &pmac_xcoff_vec, | |
887 | #endif | |
888 | &rs6000coff_vec, | |
9ee25201 | 889 | #ifdef BFD64 |
7f6d05e8 | 890 | &rs6000coff64_vec, |
9ee25201 | 891 | #endif |
252b5132 RH |
892 | &ppcboot_vec, |
893 | &shcoff_vec, | |
894 | &shlcoff_vec, | |
895 | &shcoff_small_vec, | |
896 | &shlcoff_small_vec, | |
897 | &sparcle_aout_vec, | |
898 | &sparclinux_vec, | |
899 | &sparclynx_aout_vec, | |
900 | &sparclynx_coff_vec, | |
901 | &sparcnetbsd_vec, | |
902 | &sunos_big_vec, | |
903 | &aout0_big_vec, | |
904 | &tic30_aout_vec, | |
905 | &tic30_coff_vec, | |
81635ce4 TW |
906 | &tic54x_coff0_vec, |
907 | &tic54x_coff0_beh_vec, | |
908 | &tic54x_coff1_vec, | |
909 | &tic54x_coff1_beh_vec, | |
910 | &tic54x_coff2_vec, | |
911 | &tic54x_coff2_beh_vec, | |
252b5132 RH |
912 | &tic80coff_vec, |
913 | &vaxnetbsd_vec, | |
914 | &versados_vec, | |
915 | #ifdef BFD64 | |
916 | &vms_alpha_vec, | |
917 | #endif | |
918 | &vms_vax_vec, | |
919 | &we32kcoff_vec, | |
920 | &z8kcoff_vec, | |
921 | ||
922 | #endif /* not SELECT_VECS */ | |
923 | ||
924 | /* Always support S-records, for convenience. */ | |
925 | &srec_vec, | |
926 | &symbolsrec_vec, | |
927 | /* And tekhex */ | |
928 | &tekhex_vec, | |
929 | /* Likewise for binary output. */ | |
930 | &binary_vec, | |
931 | /* Likewise for ihex. */ | |
932 | &ihex_vec, | |
933 | ||
934 | /* Add any required traditional-core-file-handler. */ | |
935 | ||
936 | #ifdef AIX386_CORE | |
937 | &aix386_core_vec, | |
938 | #endif | |
939 | #ifdef HPUX_CORE | |
940 | &hpux_core_vec, | |
941 | #endif | |
942 | #ifdef HPPABSD_CORE | |
943 | &hppabsd_core_vec, | |
944 | #endif | |
945 | #ifdef IRIX_CORE | |
946 | &irix_core_vec, | |
947 | #endif | |
948 | #ifdef NETBSD_CORE | |
949 | &netbsd_core_vec, | |
950 | #endif | |
951 | #ifdef OSF_CORE | |
952 | &osf_core_vec, | |
953 | #endif | |
954 | #ifdef SCO5_CORE | |
955 | &sco5_core_vec, | |
956 | #endif | |
957 | #ifdef TRAD_CORE | |
958 | &trad_core_vec, | |
959 | #endif | |
960 | ||
961 | #ifdef PTRACE_CORE | |
962 | &ptrace_core_vec, | |
963 | #endif | |
964 | ||
965 | NULL /* end of list marker */ | |
966 | }; | |
967 | ||
968 | /* bfd_default_vector[0] contains either the address of the default vector, | |
969 | if there is one, or zero if there isn't. */ | |
970 | ||
971 | const bfd_target *bfd_default_vector[] = { | |
972 | #ifdef DEFAULT_VECTOR | |
973 | &DEFAULT_VECTOR, | |
974 | #endif | |
975 | NULL | |
976 | }; | |
977 | ||
978 | /* When there is an ambiguous match, bfd_check_format_matches puts the | |
979 | names of the matching targets in an array. This variable is the maximum | |
980 | number of entries that the array could possibly need. */ | |
981 | const size_t _bfd_target_vector_entries = sizeof(bfd_target_vector)/sizeof(*bfd_target_vector); | |
982 | \f | |
983 | /* This array maps configuration triplets onto BFD vectors. */ | |
984 | ||
985 | struct targmatch | |
986 | { | |
987 | /* The configuration triplet. */ | |
988 | const char *triplet; | |
989 | /* The BFD vector. If this is NULL, then the vector is found by | |
990 | searching forward for the next structure with a non NULL vector | |
991 | field. */ | |
992 | const bfd_target *vector; | |
993 | }; | |
994 | ||
995 | /* targmatch.h is built by Makefile out of config.bfd. */ | |
996 | static const struct targmatch bfd_target_match[] = { | |
997 | #include "targmatch.h" | |
998 | { NULL, NULL } | |
999 | }; | |
1000 | ||
1001 | static const bfd_target *find_target PARAMS ((const char *)); | |
1002 | ||
1003 | /* Find a target vector, given a name or configuration triplet. */ | |
1004 | ||
1005 | static const bfd_target * | |
1006 | find_target (name) | |
1007 | const char *name; | |
1008 | { | |
1009 | const bfd_target * const *target; | |
1010 | const struct targmatch *match; | |
1011 | ||
1012 | for (target = &bfd_target_vector[0]; *target != NULL; target++) | |
1013 | if (strcmp (name, (*target)->name) == 0) | |
1014 | return *target; | |
1015 | ||
1016 | /* If we couldn't match on the exact name, try matching on the | |
1017 | configuration triplet. FIXME: We should run the triplet through | |
1018 | config.sub first, but that is hard. */ | |
1019 | for (match = &bfd_target_match[0]; match->triplet != NULL; match++) | |
1020 | { | |
1021 | if (fnmatch (match->triplet, name, 0) == 0) | |
1022 | { | |
1023 | while (match->vector == NULL) | |
1024 | ++match; | |
1025 | return match->vector; | |
1026 | break; | |
1027 | } | |
1028 | } | |
1029 | ||
1030 | bfd_set_error (bfd_error_invalid_target); | |
1031 | return NULL; | |
1032 | } | |
1033 | ||
1034 | /* | |
1035 | FUNCTION | |
1036 | bfd_set_default_target | |
1037 | ||
1038 | SYNOPSIS | |
1039 | boolean bfd_set_default_target (const char *name); | |
1040 | ||
1041 | DESCRIPTION | |
1042 | Set the default target vector to use when recognizing a BFD. | |
1043 | This takes the name of the target, which may be a BFD target | |
1044 | name or a configuration triplet. | |
1045 | */ | |
1046 | ||
1047 | boolean | |
1048 | bfd_set_default_target (name) | |
1049 | const char *name; | |
1050 | { | |
1051 | const bfd_target *target; | |
1052 | ||
1053 | if (bfd_default_vector[0] != NULL | |
1054 | && strcmp (name, bfd_default_vector[0]->name) == 0) | |
1055 | return true; | |
1056 | ||
1057 | target = find_target (name); | |
1058 | if (target == NULL) | |
1059 | return false; | |
1060 | ||
1061 | bfd_default_vector[0] = target; | |
1062 | return true; | |
1063 | } | |
1064 | ||
1065 | /* | |
1066 | FUNCTION | |
1067 | bfd_find_target | |
1068 | ||
1069 | SYNOPSIS | |
1070 | const bfd_target *bfd_find_target(CONST char *target_name, bfd *abfd); | |
1071 | ||
1072 | DESCRIPTION | |
1073 | Return a pointer to the transfer vector for the object target | |
1074 | named @var{target_name}. If @var{target_name} is <<NULL>>, choose the | |
1075 | one in the environment variable <<GNUTARGET>>; if that is null or not | |
1076 | defined, then choose the first entry in the target list. | |
1077 | Passing in the string "default" or setting the environment | |
1078 | variable to "default" will cause the first entry in the target | |
1079 | list to be returned, and "target_defaulted" will be set in the | |
1080 | BFD. This causes <<bfd_check_format>> to loop over all the | |
1081 | targets to find the one that matches the file being read. | |
1082 | */ | |
1083 | ||
1084 | const bfd_target * | |
1085 | bfd_find_target (target_name, abfd) | |
1086 | const char *target_name; | |
1087 | bfd *abfd; | |
1088 | { | |
1089 | const char *targname; | |
1090 | const bfd_target *target; | |
1091 | ||
1092 | if (target_name != NULL) | |
1093 | targname = target_name; | |
1094 | else | |
1095 | targname = getenv ("GNUTARGET"); | |
1096 | ||
1097 | /* This is safe; the vector cannot be null */ | |
1098 | if (targname == NULL || strcmp (targname, "default") == 0) | |
1099 | { | |
1100 | abfd->target_defaulted = true; | |
1101 | if (bfd_default_vector[0] != NULL) | |
1102 | abfd->xvec = bfd_default_vector[0]; | |
1103 | else | |
1104 | abfd->xvec = bfd_target_vector[0]; | |
1105 | return abfd->xvec; | |
1106 | } | |
1107 | ||
1108 | abfd->target_defaulted = false; | |
1109 | ||
1110 | target = find_target (targname); | |
1111 | if (target == NULL) | |
1112 | return NULL; | |
1113 | ||
1114 | abfd->xvec = target; | |
1115 | return target; | |
1116 | } | |
1117 | ||
1118 | /* | |
1119 | FUNCTION | |
1120 | bfd_target_list | |
1121 | ||
1122 | SYNOPSIS | |
1123 | const char **bfd_target_list(void); | |
1124 | ||
1125 | DESCRIPTION | |
1126 | Return a freshly malloced NULL-terminated | |
1127 | vector of the names of all the valid BFD targets. Do not | |
1128 | modify the names. | |
1129 | ||
1130 | */ | |
1131 | ||
1132 | const char ** | |
1133 | bfd_target_list () | |
1134 | { | |
1135 | int vec_length= 0; | |
1136 | #if defined (HOST_HPPAHPUX) && ! defined (__STDC__) | |
1137 | /* The native compiler on the HP9000/700 has a bug which causes it | |
1138 | to loop endlessly when compiling this file. This avoids it. */ | |
1139 | volatile | |
1140 | #endif | |
1141 | const bfd_target * const *target; | |
1142 | CONST char **name_list, **name_ptr; | |
1143 | ||
1144 | for (target = &bfd_target_vector[0]; *target != NULL; target++) | |
1145 | vec_length++; | |
1146 | ||
1147 | name_ptr = name_list = (CONST char **) | |
1148 | bfd_zmalloc ((vec_length + 1) * sizeof (char **)); | |
1149 | ||
1150 | if (name_list == NULL) | |
1151 | return NULL; | |
1152 | ||
1153 | for (target = &bfd_target_vector[0]; *target != NULL; target++) | |
1154 | *(name_ptr++) = (*target)->name; | |
1155 | ||
1156 | return name_list; | |
1157 | } | |
c3c89269 NC |
1158 | |
1159 | /* | |
1160 | FUNCTION | |
1161 | bfd_seach_for_target | |
1162 | ||
1163 | SYNOPSIS | |
1164 | const bfd_target * bfd_search_for_target (int (* search_func)(const bfd_target *, void *), void *); | |
1165 | ||
1166 | DESCRIPTION | |
1167 | Return a pointer to the first transfer vector in the list of | |
1168 | transfer vectors maintained by BFD that produces a non-zero | |
1169 | result when passed to the function @var{search_func}. The | |
1170 | parameter @var{data} is passed, unexamined, to the search | |
1171 | function. | |
1172 | */ | |
1173 | ||
1174 | const bfd_target * | |
1175 | bfd_search_for_target (search_func, data) | |
1176 | int (* search_func) PARAMS ((const bfd_target * target, void * data)); | |
1177 | void * data; | |
1178 | { | |
1179 | const bfd_target * const * target; | |
1180 | ||
1181 | for (target = bfd_target_vector; * target != NULL; target ++) | |
1182 | if (search_func (* target, data)) | |
1183 | return * target; | |
1184 | ||
1185 | return NULL; | |
1186 | } |