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