Commit | Line | Data |
---|---|---|
4e6f9223 | 1 | /* Generic target-file-type support for the BFD library. |
303b4cc6 RH |
2 | Copyright 1990, 91, 92, 93, 94, 95, 96, 97, 1998 |
3 | Free Software Foundation, Inc. | |
4e6f9223 | 4 | Written by Cygnus Support. |
4a81b561 | 5 | |
4e6f9223 | 6 | This file is part of BFD, the Binary File Descriptor library. |
4a81b561 | 7 | |
4e6f9223 | 8 | This program is free software; you can redistribute it and/or modify |
4a81b561 | 9 | it under the terms of the GNU General Public License as published by |
4e6f9223 SC |
10 | the Free Software Foundation; either version 2 of the License, or |
11 | (at your option) any later version. | |
4a81b561 | 12 | |
4e6f9223 | 13 | This program is distributed in the hope that it will be useful, |
4a81b561 DHW |
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 | |
4e6f9223 | 19 | along with this program; if not, write to the Free Software |
d6fc77df | 20 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ |
4a81b561 | 21 | |
4a81b561 | 22 | #include "bfd.h" |
bbc8d484 | 23 | #include "sysdep.h" |
4a81b561 | 24 | #include "libbfd.h" |
fd8d7c31 | 25 | #include "fnmatch.h" |
4a81b561 | 26 | |
0cda46cf SC |
27 | /* |
28 | SECTION | |
29 | Targets | |
30 | ||
e98e6ec1 | 31 | DESCRIPTION |
0cda46cf SC |
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 | ||
c188b0be | 43 | o Create a BFD by calling the internal routine |
d1ad85a6 | 44 | <<_bfd_new_bfd>>, then call <<bfd_find_target>> with the |
0cda46cf SC |
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>>, | |
c188b0be | 48 | look up the environment variable <<GNUTARGET>> and use |
0cda46cf SC |
49 | that as the target string. |
50 | ||
c96451db | 51 | o If the target string is still <<NULL>>, or the target string is |
c188b0be DM |
52 | <<default>>, then use the first item in the target vector |
53 | as the target type, and set <<target_defaulted>> in the BFD to | |
218ce930 JG |
54 | cause <<bfd_check_format>> to loop through all the targets. |
55 | @xref{bfd_target}. @xref{Formats}. | |
0cda46cf | 56 | |
c188b0be | 57 | o Otherwise, inspect the elements in the target vector |
0cda46cf | 58 | one by one, until a match on target name is found. When found, |
c188b0be | 59 | use it. |
0cda46cf | 60 | |
d1ad85a6 | 61 | o Otherwise return the error <<bfd_error_invalid_target>> to |
0cda46cf SC |
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 | |
218ce930 JG |
69 | <<bfd_check_format>> on the BFD with a suggested format. |
70 | If <<target_defaulted>> has been set, each possible target | |
c188b0be DM |
71 | type is tried to see if it recognizes the specified format. |
72 | <<bfd_check_format>> returns <<true>> when the caller guesses right. | |
92c78ee6 | 73 | @menu |
e98e6ec1 | 74 | @* bfd_target:: |
92c78ee6 | 75 | @end menu |
6f715d66 SC |
76 | */ |
77 | ||
78 | ||
0cda46cf SC |
79 | /* |
80 | ||
e98e6ec1 SC |
81 | INODE |
82 | bfd_target, , Targets, Targets | |
6697a1a9 | 83 | DOCDD |
0cda46cf SC |
84 | SUBSECTION |
85 | bfd_target | |
86 | ||
e98e6ec1 | 87 | DESCRIPTION |
0cda46cf | 88 | This structure contains everything that BFD knows about a |
c188b0be DM |
89 | target. It includes things like its byte order, name, and which |
90 | routines to call to do various operations. | |
6f715d66 | 91 | |
0cda46cf SC |
92 | Every BFD points to a target structure with its <<xvec>> |
93 | member. | |
6f715d66 | 94 | |
c188b0be DM |
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 | |
0cda46cf | 97 | down in @file{bfd.h}, and are also used when calling various |
c188b0be | 98 | routines by hand inside the BFD implementation. The @var{arglist} |
0cda46cf SC |
99 | argument must be parenthesized; it contains all the arguments |
100 | to the called function. | |
6f715d66 | 101 | |
ce07dd7c KR |
102 | They make the documentation (more) unpleasant to read, so if |
103 | someone wants to fix this and not break the above, please do. | |
6f715d66 | 104 | |
0cda46cf SC |
105 | .#define BFD_SEND(bfd, message, arglist) \ |
106 | . ((*((bfd)->xvec->message)) arglist) | |
fdfe2d14 SS |
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 | |
6f715d66 | 115 | |
c188b0be | 116 | For operations which index on the BFD format: |
6f715d66 | 117 | |
0cda46cf SC |
118 | .#define BFD_SEND_FMT(bfd, message, arglist) \ |
119 | . (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) | |
fdfe2d14 SS |
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 | |
6f715d66 | 128 | |
c188b0be | 129 | This is the structure which defines the type of BFD this is. The |
0cda46cf SC |
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. | |
6f715d66 | 133 | |
6f715d66 | 134 | |
0cda46cf SC |
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 | ||
c188b0be DM |
139 | .enum bfd_flavour { |
140 | . bfd_target_unknown_flavour, | |
141 | . bfd_target_aout_flavour, | |
142 | . bfd_target_coff_flavour, | |
143 | . bfd_target_ecoff_flavour, | |
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, | |
ffd15489 | 150 | . bfd_target_ihex_flavour, |
2f88343d | 151 | . bfd_target_som_flavour, |
91766660 | 152 | . bfd_target_os9k_flavour, |
d07445c3 | 153 | . bfd_target_versados_flavour, |
50bd50d4 MH |
154 | . bfd_target_msdos_flavour, |
155 | . bfd_target_evax_flavour | |
91766660 | 156 | .}; |
4c3721d5 | 157 | . |
767f22d5 FF |
158 | .enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN }; |
159 | . | |
4c3721d5 ILT |
160 | .{* Forward declaration. *} |
161 | .typedef struct bfd_link_info _bfd_link_info; | |
162 | . | |
0cda46cf SC |
163 | .typedef struct bfd_target |
164 | .{ | |
6f715d66 | 165 | |
c188b0be | 166 | Identifies the kind of target, e.g., SunOS4, Ultrix, etc. |
6f715d66 | 167 | |
0cda46cf | 168 | . char *name; |
6f715d66 SC |
169 | |
170 | The "flavour" of a back end is a general indication about the contents | |
171 | of a file. | |
172 | ||
c188b0be | 173 | . enum bfd_flavour flavour; |
6f715d66 SC |
174 | |
175 | The order of bytes within the data area of a file. | |
176 | ||
767f22d5 | 177 | . enum bfd_endian byteorder; |
6f715d66 SC |
178 | |
179 | The order of bytes within the header parts of a file. | |
180 | ||
767f22d5 | 181 | . enum bfd_endian header_byteorder; |
6f715d66 | 182 | |
c188b0be | 183 | A mask of all the flags which an executable may have set - |
efc2b064 | 184 | from the set <<BFD_NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>. |
6f715d66 | 185 | |
0cda46cf | 186 | . flagword object_flags; |
6f715d66 | 187 | |
c188b0be | 188 | A mask of all the flags which a section may have set - from |
0cda46cf | 189 | the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>. |
6f715d66 | 190 | |
0cda46cf | 191 | . flagword section_flags; |
6f715d66 | 192 | |
990e7c22 | 193 | The character normally found at the front of a symbol |
c188b0be | 194 | (if any), perhaps `_'. |
990e7c22 JG |
195 | |
196 | . char symbol_leading_char; | |
197 | ||
c188b0be | 198 | The pad character for file names within an archive header. |
6f715d66 | 199 | |
0cda46cf | 200 | . char ar_pad_char; |
6f715d66 SC |
201 | |
202 | The maximum number of characters in an archive header. | |
203 | ||
60ac749c | 204 | . unsigned short ar_max_namelen; |
6f715d66 | 205 | |
c188b0be DM |
206 | Entries for byte swapping for data. These are different from the other |
207 | entry points, since they don't take a BFD asthe first argument. | |
208 | Certain other handlers could do the same. | |
6f715d66 | 209 | |
3b31740c DM |
210 | . bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *)); |
211 | . bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *)); | |
60ac749c | 212 | . void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
213 | . bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *)); |
214 | . bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *)); | |
60ac749c | 215 | . void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
216 | . bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *)); |
217 | . bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *)); | |
60ac749c | 218 | . void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *)); |
6f715d66 SC |
219 | |
220 | Byte swapping for the headers | |
221 | ||
3b31740c DM |
222 | . bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *)); |
223 | . bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *)); | |
60ac749c | 224 | . void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
225 | . bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *)); |
226 | . bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *)); | |
60ac749c | 227 | . void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
228 | . bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *)); |
229 | . bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *)); | |
60ac749c | 230 | . void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *)); |
6f715d66 | 231 | |
60ac749c ILT |
232 | Format dependent routines: these are vectors of entry points |
233 | within the target vector structure, one for each format to check. | |
6f715d66 | 234 | |
c188b0be | 235 | Check the format of a file being read. Return a <<bfd_target *>> or zero. |
6f715d66 | 236 | |
a3f7a777 | 237 | . const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 SC |
238 | |
239 | Set the format of a file being written. | |
240 | ||
60ac749c | 241 | . boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 | 242 | |
c188b0be | 243 | Write cached information into a file being written, at <<bfd_close>>. |
6f715d66 | 244 | |
60ac749c | 245 | . boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 | 246 | |
6812b607 | 247 | The general target vector. |
6f715d66 | 248 | |
6812b607 ILT |
249 | . |
250 | . {* Generic entry points. *} | |
251 | .#define BFD_JUMP_TABLE_GENERIC(NAME)\ | |
252 | .CAT(NAME,_close_and_cleanup),\ | |
253 | .CAT(NAME,_bfd_free_cached_info),\ | |
254 | .CAT(NAME,_new_section_hook),\ | |
4fe6d901 KR |
255 | .CAT(NAME,_get_section_contents),\ |
256 | .CAT(NAME,_get_section_contents_in_window) | |
257 | . | |
6812b607 ILT |
258 | . {* Called when the BFD is being closed to do any necessary cleanup. *} |
259 | . boolean (*_close_and_cleanup) PARAMS ((bfd *)); | |
260 | . {* Ask the BFD to free all cached information. *} | |
261 | . boolean (*_bfd_free_cached_info) PARAMS ((bfd *)); | |
262 | . {* Called when a new section is created. *} | |
263 | . boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr)); | |
264 | . {* Read the contents of a section. *} | |
265 | . boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
266 | . file_ptr, bfd_size_type)); | |
4fe6d901 KR |
267 | . boolean (*_bfd_get_section_contents_in_window) |
268 | . PARAMS ((bfd *, sec_ptr, bfd_window *, | |
269 | . file_ptr, bfd_size_type)); | |
6812b607 ILT |
270 | . |
271 | . {* Entry points to copy private data. *} | |
272 | .#define BFD_JUMP_TABLE_COPY(NAME)\ | |
273 | .CAT(NAME,_bfd_copy_private_bfd_data),\ | |
c7b44b04 MM |
274 | .CAT(NAME,_bfd_merge_private_bfd_data),\ |
275 | .CAT(NAME,_bfd_copy_private_section_data),\ | |
89665c85 | 276 | .CAT(NAME,_bfd_copy_private_symbol_data),\ |
b7577823 ILT |
277 | .CAT(NAME,_bfd_set_private_flags),\ |
278 | .CAT(NAME,_bfd_print_private_bfd_data)\ | |
6812b607 ILT |
279 | . {* Called to copy BFD general private data from one object file |
280 | . to another. *} | |
281 | . boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *)); | |
c7b44b04 MM |
282 | . {* Called to merge BFD general private data from one object file |
283 | . to a common output file when linking. *} | |
284 | . boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *)); | |
6812b607 ILT |
285 | . {* Called to copy BFD private section data from one object file |
286 | . to another. *} | |
287 | . boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr, | |
288 | . bfd *, sec_ptr)); | |
89665c85 SC |
289 | . {* Called to copy BFD private symbol data from one symbol |
290 | . to another. *} | |
291 | . boolean (*_bfd_copy_private_symbol_data) PARAMS ((bfd *, asymbol *, | |
292 | . bfd *, asymbol *)); | |
c7b44b04 MM |
293 | . {* Called to set private backend flags *} |
294 | . boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword)); | |
6812b607 | 295 | . |
b7577823 | 296 | . {* Called to print private BFD data *} |
e9f30616 | 297 | . boolean (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR)); |
b7577823 | 298 | . |
6812b607 ILT |
299 | . {* Core file entry points. *} |
300 | .#define BFD_JUMP_TABLE_CORE(NAME)\ | |
301 | .CAT(NAME,_core_file_failing_command),\ | |
302 | .CAT(NAME,_core_file_failing_signal),\ | |
303 | .CAT(NAME,_core_file_matches_executable_p) | |
60ac749c ILT |
304 | . char * (*_core_file_failing_command) PARAMS ((bfd *)); |
305 | . int (*_core_file_failing_signal) PARAMS ((bfd *)); | |
306 | . boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *)); | |
6812b607 ILT |
307 | . |
308 | . {* Archive entry points. *} | |
309 | .#define BFD_JUMP_TABLE_ARCHIVE(NAME)\ | |
310 | .CAT(NAME,_slurp_armap),\ | |
311 | .CAT(NAME,_slurp_extended_name_table),\ | |
cd9782e8 | 312 | .CAT(NAME,_construct_extended_name_table),\ |
6812b607 ILT |
313 | .CAT(NAME,_truncate_arname),\ |
314 | .CAT(NAME,_write_armap),\ | |
c53fac12 | 315 | .CAT(NAME,_read_ar_hdr),\ |
6812b607 | 316 | .CAT(NAME,_openr_next_archived_file),\ |
64d5f5d0 | 317 | .CAT(NAME,_get_elt_at_index),\ |
a3f7a777 C |
318 | .CAT(NAME,_generic_stat_arch_elt),\ |
319 | .CAT(NAME,_update_armap_timestamp) | |
60ac749c ILT |
320 | . boolean (*_bfd_slurp_armap) PARAMS ((bfd *)); |
321 | . boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *)); | |
cd9782e8 ILT |
322 | . boolean (*_bfd_construct_extended_name_table) |
323 | . PARAMS ((bfd *, char **, bfd_size_type *, const char **)); | |
60ac749c ILT |
324 | . void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *)); |
325 | . boolean (*write_armap) PARAMS ((bfd *arch, | |
0cda46cf SC |
326 | . unsigned int elength, |
327 | . struct orl *map, | |
328 | . unsigned int orl_count, | |
329 | . int stridx)); | |
4fe6d901 | 330 | . PTR (*_bfd_read_ar_hdr_fn) PARAMS ((bfd *)); |
a3f7a777 | 331 | . bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev)); |
64d5f5d0 ILT |
332 | .#define bfd_get_elt_at_index(b,i) BFD_SEND(b, _bfd_get_elt_at_index, (b,i)) |
333 | . bfd * (*_bfd_get_elt_at_index) PARAMS ((bfd *, symindex)); | |
a3f7a777 C |
334 | . int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *)); |
335 | . boolean (*_bfd_update_armap_timestamp) PARAMS ((bfd *)); | |
336 | . | |
6812b607 ILT |
337 | . {* Entry points used for symbols. *} |
338 | .#define BFD_JUMP_TABLE_SYMBOLS(NAME)\ | |
339 | .CAT(NAME,_get_symtab_upper_bound),\ | |
340 | .CAT(NAME,_get_symtab),\ | |
341 | .CAT(NAME,_make_empty_symbol),\ | |
342 | .CAT(NAME,_print_symbol),\ | |
343 | .CAT(NAME,_get_symbol_info),\ | |
35a3e78e | 344 | .CAT(NAME,_bfd_is_local_label_name),\ |
6812b607 ILT |
345 | .CAT(NAME,_get_lineno),\ |
346 | .CAT(NAME,_find_nearest_line),\ | |
d6fc77df DE |
347 | .CAT(NAME,_bfd_make_debug_symbol),\ |
348 | .CAT(NAME,_read_minisymbols),\ | |
349 | .CAT(NAME,_minisymbol_to_symbol) | |
326e32d7 ILT |
350 | . long (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *)); |
351 | . long (*_bfd_canonicalize_symtab) PARAMS ((bfd *, | |
352 | . struct symbol_cache_entry **)); | |
60ac749c ILT |
353 | . struct symbol_cache_entry * |
354 | . (*_bfd_make_empty_symbol) PARAMS ((bfd *)); | |
355 | . void (*_bfd_print_symbol) PARAMS ((bfd *, PTR, | |
356 | . struct symbol_cache_entry *, | |
0cda46cf SC |
357 | . bfd_print_symbol_type)); |
358 | .#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e)) | |
93b4f018 DM |
359 | . void (*_bfd_get_symbol_info) PARAMS ((bfd *, |
360 | . struct symbol_cache_entry *, | |
361 | . symbol_info *)); | |
362 | .#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e)) | |
35a3e78e | 363 | . boolean (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *)); |
0cda46cf | 364 | . |
6812b607 | 365 | . alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *)); |
60ac749c ILT |
366 | . boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd, |
367 | . struct sec *section, struct symbol_cache_entry **symbols, | |
368 | . bfd_vma offset, CONST char **file, CONST char **func, | |
369 | . unsigned int *line)); | |
6812b607 ILT |
370 | . {* Back-door to allow format-aware applications to create debug symbols |
371 | . while using BFD for everything else. Currently used by the assembler | |
372 | . when creating COFF files. *} | |
d6fc77df | 373 | . asymbol * (*_bfd_make_debug_symbol) PARAMS (( |
6812b607 ILT |
374 | . bfd *abfd, |
375 | . void *ptr, | |
376 | . unsigned long size)); | |
d6fc77df DE |
377 | .#define bfd_read_minisymbols(b, d, m, s) \ |
378 | . BFD_SEND (b, _read_minisymbols, (b, d, m, s)) | |
379 | . long (*_read_minisymbols) PARAMS ((bfd *, boolean, PTR *, | |
380 | . unsigned int *)); | |
381 | .#define bfd_minisymbol_to_symbol(b, d, m, f) \ | |
382 | . BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f)) | |
383 | . asymbol *(*_minisymbol_to_symbol) PARAMS ((bfd *, boolean, const PTR, | |
384 | . asymbol *)); | |
0cda46cf | 385 | . |
6812b607 ILT |
386 | . {* Routines for relocs. *} |
387 | .#define BFD_JUMP_TABLE_RELOCS(NAME)\ | |
388 | .CAT(NAME,_get_reloc_upper_bound),\ | |
389 | .CAT(NAME,_canonicalize_reloc),\ | |
390 | .CAT(NAME,_bfd_reloc_type_lookup) | |
391 | . long (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr)); | |
392 | . long (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **, | |
393 | . struct symbol_cache_entry **)); | |
394 | . {* See documentation on reloc types. *} | |
91766660 | 395 | . reloc_howto_type * |
6812b607 ILT |
396 | . (*reloc_type_lookup) PARAMS ((bfd *abfd, |
397 | . bfd_reloc_code_real_type code)); | |
0cda46cf | 398 | . |
6812b607 ILT |
399 | . {* Routines used when writing an object file. *} |
400 | .#define BFD_JUMP_TABLE_WRITE(NAME)\ | |
401 | .CAT(NAME,_set_arch_mach),\ | |
402 | .CAT(NAME,_set_section_contents) | |
403 | . boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture, | |
404 | . unsigned long)); | |
405 | . boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
406 | . file_ptr, bfd_size_type)); | |
0cda46cf | 407 | . |
6812b607 ILT |
408 | . {* Routines used by the linker. *} |
409 | .#define BFD_JUMP_TABLE_LINK(NAME)\ | |
410 | .CAT(NAME,_sizeof_headers),\ | |
411 | .CAT(NAME,_bfd_get_relocated_section_contents),\ | |
412 | .CAT(NAME,_bfd_relax_section),\ | |
413 | .CAT(NAME,_bfd_link_hash_table_create),\ | |
414 | .CAT(NAME,_bfd_link_add_symbols),\ | |
89665c85 | 415 | .CAT(NAME,_bfd_final_link),\ |
303b4cc6 RH |
416 | .CAT(NAME,_bfd_link_split_section),\ |
417 | .CAT(NAME,_bfd_gc_sections) | |
6812b607 | 418 | . int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean)); |
60ac749c | 419 | . bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *, |
4c3721d5 ILT |
420 | . struct bfd_link_info *, struct bfd_link_order *, |
421 | . bfd_byte *data, boolean relocateable, | |
422 | . struct symbol_cache_entry **)); | |
0cda46cf | 423 | . |
60ac749c | 424 | . boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *, |
bdf1b511 | 425 | . struct bfd_link_info *, boolean *again)); |
2ebd0976 | 426 | . |
ad46bd1d ILT |
427 | . {* Create a hash table for the linker. Different backends store |
428 | . different information in this table. *} | |
429 | . struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *)); | |
4c3721d5 | 430 | . |
ad46bd1d ILT |
431 | . {* Add symbols from this object file into the hash table. *} |
432 | . boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *)); | |
4c3721d5 | 433 | . |
ad46bd1d ILT |
434 | . {* Do a link based on the link_order structures attached to each |
435 | . section of the BFD. *} | |
436 | . boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *)); | |
437 | . | |
89665c85 SC |
438 | . {* Should this section be split up into smaller pieces during linking. *} |
439 | . boolean (*_bfd_link_split_section) PARAMS ((bfd *, struct sec *)); | |
440 | . | |
303b4cc6 RH |
441 | . {* Remove sections that are not referenced from the output. *} |
442 | . boolean (*_bfd_gc_sections) PARAMS ((bfd *, struct bfd_link_info *)); | |
443 | . | |
444 | . {* Routines to handle dynamic symbols and relocs. *} | |
ad46bd1d ILT |
445 | .#define BFD_JUMP_TABLE_DYNAMIC(NAME)\ |
446 | .CAT(NAME,_get_dynamic_symtab_upper_bound),\ | |
447 | .CAT(NAME,_canonicalize_dynamic_symtab),\ | |
448 | .CAT(NAME,_get_dynamic_reloc_upper_bound),\ | |
449 | .CAT(NAME,_canonicalize_dynamic_reloc) | |
450 | . {* Get the amount of memory required to hold the dynamic symbols. *} | |
451 | . long (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *)); | |
452 | . {* Read in the dynamic symbols. *} | |
453 | . long (*_bfd_canonicalize_dynamic_symtab) | |
454 | . PARAMS ((bfd *, struct symbol_cache_entry **)); | |
455 | . {* Get the amount of memory required to hold the dynamic relocs. *} | |
456 | . long (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *)); | |
457 | . {* Read in the dynamic relocs. *} | |
458 | . long (*_bfd_canonicalize_dynamic_reloc) | |
459 | . PARAMS ((bfd *, arelent **, struct symbol_cache_entry **)); | |
4c3721d5 | 460 | . |
ce07dd7c | 461 | |
14e3c2e4 JK |
462 | Data for use by back-end routines, which isn't generic enough to belong |
463 | in this structure. | |
ce07dd7c KR |
464 | |
465 | . PTR backend_data; | |
0cda46cf | 466 | .} bfd_target; |
6f715d66 SC |
467 | |
468 | */ | |
f8adc62d | 469 | |
cf39664e DM |
470 | /* All known xvecs (even those that don't compile on all systems). |
471 | Alphabetized for easy reference. | |
472 | They are listed a second time below, since | |
616ebcfd | 473 | we can't intermix extern's and initializers. */ |
a3f7a777 C |
474 | extern const bfd_target a29kcoff_big_vec; |
475 | extern const bfd_target a_out_adobe_vec; | |
89665c85 SC |
476 | extern const bfd_target aout_arm_big_vec; |
477 | extern const bfd_target aout_arm_little_vec; | |
a3f7a777 C |
478 | extern const bfd_target aout_mips_big_vec; |
479 | extern const bfd_target aout_mips_little_vec; | |
480 | extern const bfd_target aout0_big_vec; | |
481 | extern const bfd_target apollocoff_vec; | |
a11e10fe DE |
482 | extern const bfd_target armcoff_little_vec; |
483 | extern const bfd_target armcoff_big_vec; | |
d6fc77df DE |
484 | extern const bfd_target armpe_little_vec; |
485 | extern const bfd_target armpe_big_vec; | |
486 | extern const bfd_target armpei_little_vec; | |
487 | extern const bfd_target armpei_big_vec; | |
a3f7a777 C |
488 | extern const bfd_target b_out_vec_big_host; |
489 | extern const bfd_target b_out_vec_little_host; | |
50bd50d4 | 490 | extern const bfd_target bfd_elf64_alpha_vec; |
91766660 DE |
491 | extern const bfd_target bfd_elf32_bigarc_vec; |
492 | extern const bfd_target bfd_elf32_littlearc_vec; | |
a3f7a777 C |
493 | extern const bfd_target bfd_elf32_big_generic_vec; |
494 | extern const bfd_target bfd_elf32_bigmips_vec; | |
50bd50d4 | 495 | extern const bfd_target bfd_elf64_bigmips_vec; |
50bd50d4 | 496 | extern const bfd_target bfd_elf32_d10v_vec; |
fd8d7c31 MH |
497 | /* start-sanitize-d30v */ |
498 | extern const bfd_target bfd_elf32_d30v_vec; | |
499 | /* end-sanitize-d30v */ | |
a3f7a777 C |
500 | extern const bfd_target bfd_elf32_hppa_vec; |
501 | extern const bfd_target bfd_elf32_i386_vec; | |
502 | extern const bfd_target bfd_elf32_i860_vec; | |
503 | extern const bfd_target bfd_elf32_little_generic_vec; | |
504 | extern const bfd_target bfd_elf32_littlemips_vec; | |
50bd50d4 | 505 | extern const bfd_target bfd_elf64_littlemips_vec; |
efc2b064 | 506 | extern const bfd_target bfd_elf32_m32r_vec; |
a3f7a777 C |
507 | extern const bfd_target bfd_elf32_m68k_vec; |
508 | extern const bfd_target bfd_elf32_m88k_vec; | |
ae1b99e4 JL |
509 | extern const bfd_target bfd_elf32_mn10200_vec; |
510 | extern const bfd_target bfd_elf32_mn10300_vec; | |
a3f7a777 | 511 | extern const bfd_target bfd_elf32_powerpc_vec; |
c7b44b04 | 512 | extern const bfd_target bfd_elf32_powerpcle_vec; |
efc2b064 JL |
513 | extern const bfd_target bfd_elf32_sh_vec; |
514 | extern const bfd_target bfd_elf32_shl_vec; | |
a3f7a777 | 515 | extern const bfd_target bfd_elf32_sparc_vec; |
efc2b064 | 516 | extern const bfd_target bfd_elf32_v850_vec; |
a3f7a777 C |
517 | extern const bfd_target bfd_elf64_big_generic_vec; |
518 | extern const bfd_target bfd_elf64_little_generic_vec; | |
519 | extern const bfd_target bfd_elf64_sparc_vec; | |
520 | extern const bfd_target demo_64_vec; | |
521 | extern const bfd_target ecoff_big_vec; | |
522 | extern const bfd_target ecoff_little_vec; | |
55ef0d90 | 523 | extern const bfd_target ecoff_biglittle_vec; |
a3f7a777 | 524 | extern const bfd_target ecoffalpha_little_vec; |
50bd50d4 | 525 | extern const bfd_target evax_alpha_vec; |
a3f7a777 C |
526 | extern const bfd_target h8300coff_vec; |
527 | extern const bfd_target h8500coff_vec; | |
528 | extern const bfd_target host_aout_vec; | |
529 | extern const bfd_target hp300bsd_vec; | |
530 | extern const bfd_target hp300hpux_vec; | |
531 | extern const bfd_target som_vec; | |
532 | extern const bfd_target i386aout_vec; | |
533 | extern const bfd_target i386bsd_vec; | |
534 | extern const bfd_target i386dynix_vec; | |
767f22d5 | 535 | extern const bfd_target i386freebsd_vec; |
a3f7a777 C |
536 | extern const bfd_target i386os9k_vec; |
537 | extern const bfd_target i386coff_vec; | |
e0c10737 KK |
538 | extern const bfd_target bfd_powerpc_pe_vec; |
539 | extern const bfd_target bfd_powerpcle_pe_vec; | |
540 | extern const bfd_target bfd_powerpc_pei_vec; | |
541 | extern const bfd_target bfd_powerpcle_pei_vec; | |
89665c85 SC |
542 | extern const bfd_target i386pe_vec; |
543 | extern const bfd_target i386pei_vec; | |
a3f7a777 | 544 | extern const bfd_target go32coff_vec; |
20b2c808 | 545 | extern const bfd_target go32stubbedcoff_vec; |
a3f7a777 C |
546 | extern const bfd_target i386linux_vec; |
547 | extern const bfd_target i386lynx_aout_vec; | |
548 | extern const bfd_target i386lynx_coff_vec; | |
549 | extern const bfd_target i386mach3_vec; | |
91766660 | 550 | extern const bfd_target i386msdos_vec; |
a3f7a777 | 551 | extern const bfd_target i386netbsd_vec; |
e9f30616 | 552 | extern const bfd_target i860coff_vec; |
a3f7a777 C |
553 | extern const bfd_target icoff_big_vec; |
554 | extern const bfd_target icoff_little_vec; | |
555 | extern const bfd_target ieee_vec; | |
50bd50d4 | 556 | extern const bfd_target m68kaux_coff_vec; |
a3f7a777 C |
557 | extern const bfd_target m68kcoff_vec; |
558 | extern const bfd_target m68kcoffun_vec; | |
50bd50d4 | 559 | extern const bfd_target m68klinux_vec; |
a3f7a777 C |
560 | extern const bfd_target m68klynx_aout_vec; |
561 | extern const bfd_target m68klynx_coff_vec; | |
7a1d4567 | 562 | extern const bfd_target m68knetbsd_vec; |
ac388f2a | 563 | extern const bfd_target m68ksysvcoff_vec; |
a9713b91 | 564 | extern const bfd_target m68k4knetbsd_vec; |
a3f7a777 C |
565 | extern const bfd_target m88kbcs_vec; |
566 | extern const bfd_target m88kmach3_vec; | |
567 | extern const bfd_target newsos3_vec; | |
568 | extern const bfd_target nlm32_i386_vec; | |
569 | extern const bfd_target nlm32_sparc_vec; | |
570 | extern const bfd_target nlm32_alpha_vec; | |
571 | extern const bfd_target nlm32_powerpc_vec; | |
c768bd3f | 572 | extern const bfd_target pc532netbsd_vec; |
a3f7a777 C |
573 | extern const bfd_target oasys_vec; |
574 | extern const bfd_target pc532machaout_vec; | |
50bd50d4 | 575 | extern const bfd_target ppcboot_vec; |
a3f7a777 | 576 | extern const bfd_target riscix_vec; |
c53fac12 | 577 | extern const bfd_target pmac_xcoff_vec; |
a3f7a777 C |
578 | extern const bfd_target rs6000coff_vec; |
579 | extern const bfd_target shcoff_vec; | |
7a1d4567 | 580 | extern const bfd_target shlcoff_vec; |
20b2c808 DE |
581 | extern const bfd_target shcoff_small_vec; |
582 | extern const bfd_target shlcoff_small_vec; | |
efc2b064 | 583 | extern const bfd_target sparcle_aout_vec; |
20b2c808 | 584 | extern const bfd_target sparclinux_vec; |
a3f7a777 C |
585 | extern const bfd_target sparclynx_aout_vec; |
586 | extern const bfd_target sparclynx_coff_vec; | |
587 | extern const bfd_target sparcnetbsd_vec; | |
588 | extern const bfd_target sparccoff_vec; | |
589 | extern const bfd_target sunos_big_vec; | |
590 | extern const bfd_target tekhex_vec; | |
e8f2efef ILT |
591 | extern const bfd_target tic30_aout_vec; |
592 | extern const bfd_target tic30_coff_vec; | |
fd8d7c31 MH |
593 | /* start-sanitize-tic80 */ |
594 | extern const bfd_target tic80coff_vec; | |
595 | /* end-sanitize-tic80 */ | |
303b4cc6 | 596 | extern const bfd_target vaxnetbsd_vec; |
89665c85 | 597 | extern const bfd_target versados_vec; |
a3f7a777 | 598 | extern const bfd_target we32kcoff_vec; |
d468a149 | 599 | extern const bfd_target w65_vec; |
a3f7a777 | 600 | extern const bfd_target z8kcoff_vec; |
cf39664e DM |
601 | |
602 | /* srec is always included. */ | |
a3f7a777 C |
603 | extern const bfd_target srec_vec; |
604 | extern const bfd_target symbolsrec_vec; | |
cf39664e | 605 | |
c768bd3f ILT |
606 | /* binary is always included. */ |
607 | extern const bfd_target binary_vec; | |
608 | ||
ffd15489 ILT |
609 | /* ihex is always included. */ |
610 | extern const bfd_target ihex_vec; | |
611 | ||
cf39664e | 612 | /* All of the xvecs for core files. */ |
a3f7a777 C |
613 | extern const bfd_target aix386_core_vec; |
614 | extern const bfd_target cisco_core_vec; | |
615 | extern const bfd_target hpux_core_vec; | |
616 | extern const bfd_target hppabsd_core_vec; | |
617 | extern const bfd_target irix_core_vec; | |
20b2c808 | 618 | extern const bfd_target netbsd_core_vec; |
a3f7a777 C |
619 | extern const bfd_target osf_core_vec; |
620 | extern const bfd_target sco_core_vec; | |
621 | extern const bfd_target trad_core_vec; | |
622 | extern const bfd_target ptrace_core_vec; | |
623 | ||
624 | const bfd_target * const bfd_target_vector[] = { | |
4e6f9223 | 625 | |
2ebd0976 | 626 | #ifdef SELECT_VECS |
14e3c2e4 JK |
627 | |
628 | SELECT_VECS, | |
629 | ||
630 | #else /* not SELECT_VECS */ | |
f39b81f5 | 631 | |
cf39664e DM |
632 | #ifdef DEFAULT_VECTOR |
633 | &DEFAULT_VECTOR, | |
634 | #endif | |
635 | /* This list is alphabetized to make it easy to compare | |
636 | with other vector lists -- the decls above and | |
637 | the case statement in configure.in. | |
638 | Vectors that don't compile on all systems, or aren't finished, | |
639 | should have an entry here with #if 0 around it, to show that | |
640 | it wasn't omitted by mistake. */ | |
641 | &a29kcoff_big_vec, | |
642 | &a_out_adobe_vec, | |
643 | #if 0 /* No one seems to use this. */ | |
2ebd0976 | 644 | &aout_mips_big_vec, |
cf39664e DM |
645 | #endif |
646 | &aout_mips_little_vec, | |
647 | &b_out_vec_big_host, | |
648 | &b_out_vec_little_host, | |
56a2f341 JK |
649 | |
650 | /* This, and other vectors, may not be used in any *.mt configuration. | |
a3f7a777 C |
651 | But that does not mean they are unnecessary. If configured with |
652 | --enable-targets=all, objdump or gdb should be able to examine | |
56a2f341 | 653 | the file even if we don't recognize the machine type. */ |
91766660 | 654 | &bfd_elf32_big_generic_vec, |
50bd50d4 MH |
655 | #ifdef BFD64 |
656 | &bfd_elf64_alpha_vec, | |
657 | #endif | |
91766660 | 658 | &bfd_elf32_bigarc_vec, |
7218bb04 | 659 | &bfd_elf32_bigmips_vec, |
50bd50d4 MH |
660 | #ifdef BFD64 |
661 | &bfd_elf64_bigmips_vec, | |
662 | #endif | |
50bd50d4 | 663 | &bfd_elf32_d10v_vec, |
fd8d7c31 MH |
664 | /* start-sanitize-d30v */ |
665 | &bfd_elf32_d30v_vec, | |
666 | /* end-sanitize-d30v */ | |
cf39664e | 667 | &bfd_elf32_hppa_vec, |
cf39664e DM |
668 | &bfd_elf32_i386_vec, |
669 | &bfd_elf32_i860_vec, | |
cf39664e | 670 | &bfd_elf32_little_generic_vec, |
91766660 | 671 | &bfd_elf32_littlearc_vec, |
7218bb04 | 672 | &bfd_elf32_littlemips_vec, |
50bd50d4 MH |
673 | #ifdef BFD64 |
674 | &bfd_elf64_littlemips_vec, | |
675 | #endif | |
efc2b064 | 676 | &bfd_elf32_m32r_vec, |
ae1b99e4 JL |
677 | &bfd_elf32_mn10200_vec, |
678 | &bfd_elf32_mn10300_vec, | |
cf39664e DM |
679 | &bfd_elf32_m68k_vec, |
680 | &bfd_elf32_m88k_vec, | |
681 | &bfd_elf32_sparc_vec, | |
7ce8b9d1 | 682 | &bfd_elf32_powerpc_vec, |
303b4cc6 | 683 | &bfd_elf32_powerpcle_vec, |
efc2b064 | 684 | &bfd_elf32_v850_vec, |
cf39664e DM |
685 | #ifdef BFD64 /* No one seems to use this. */ |
686 | &bfd_elf64_big_generic_vec, | |
687 | &bfd_elf64_little_generic_vec, | |
688 | #endif | |
cf39664e DM |
689 | #if 0 |
690 | &bfd_elf64_sparc_vec, | |
691 | #endif | |
bdf1b511 PS |
692 | /* We don't include cisco_core_vec. Although it has a magic number, |
693 | the magic number isn't at the beginning of the file, and thus | |
694 | might spuriously match other kinds of files. */ | |
2c4f2c72 | 695 | #ifdef BFD64 |
f39b81f5 | 696 | &demo_64_vec, /* Only compiled if host has long-long support */ |
cf39664e DM |
697 | #endif |
698 | &ecoff_big_vec, | |
699 | &ecoff_little_vec, | |
55ef0d90 | 700 | &ecoff_biglittle_vec, |
50bd50d4 | 701 | #ifdef BFD64 |
cf39664e | 702 | &ecoffalpha_little_vec, |
50bd50d4 | 703 | &evax_alpha_vec, |
f39b81f5 SC |
704 | #endif |
705 | &h8300coff_vec, | |
cf39664e | 706 | &h8500coff_vec, |
5f9a2245 | 707 | #if 0 |
56a2f341 JK |
708 | /* Since a.out files lack decent magic numbers, no way to recognize |
709 | which kind of a.out file it is. */ | |
cf39664e | 710 | &host_aout_vec, |
5f9a2245 | 711 | #endif |
c8e1d00b | 712 | #if 0 /* Clashes with sunos_big_vec magic no. */ |
cf39664e | 713 | &hp300bsd_vec, |
c8e1d00b | 714 | #endif |
cf39664e | 715 | &hp300hpux_vec, |
d1ad85a6 | 716 | #if defined (HOST_HPPAHPUX) || defined (HOST_HPPABSD) || defined (HOST_HPPAOSF) |
3bca0336 | 717 | &som_vec, |
cf39664e DM |
718 | #endif |
719 | &i386aout_vec, | |
720 | &i386bsd_vec, | |
721 | &i386coff_vec, | |
767f22d5 | 722 | &i386freebsd_vec, |
e9f30616 | 723 | &i860coff_vec, |
e0c10737 KK |
724 | &bfd_powerpc_pe_vec, |
725 | &bfd_powerpcle_pe_vec, | |
726 | &bfd_powerpc_pei_vec, | |
727 | &bfd_powerpcle_pei_vec, | |
4f9617ca | 728 | &go32coff_vec, |
20b2c808 | 729 | &go32stubbedcoff_vec, |
cf39664e | 730 | #if 0 |
56a2f341 JK |
731 | /* Since a.out files lack decent magic numbers, no way to recognize |
732 | which kind of a.out file it is. */ | |
cf39664e DM |
733 | &i386linux_vec, |
734 | #endif | |
3bca0336 KR |
735 | &i386lynx_aout_vec, |
736 | &i386lynx_coff_vec, | |
a3f7a777 C |
737 | #if 0 |
738 | /* No distinguishing features for Mach 3 executables. */ | |
739 | &i386mach3_vec, | |
740 | #endif | |
91766660 | 741 | &i386msdos_vec, |
a3f7a777 | 742 | &i386netbsd_vec, |
2f88343d | 743 | &i386os9k_vec, |
89665c85 SC |
744 | &i386pe_vec, |
745 | &i386pei_vec, | |
a11e10fe DE |
746 | &armcoff_little_vec, |
747 | &armcoff_big_vec, | |
b7577823 ILT |
748 | &armpe_little_vec, |
749 | &armpe_big_vec, | |
750 | &armpei_little_vec, | |
751 | &armpei_big_vec, | |
f39b81f5 | 752 | &icoff_big_vec, |
cf39664e DM |
753 | &icoff_little_vec, |
754 | &ieee_vec, | |
755 | &m68kcoff_vec, | |
756 | &m68kcoffun_vec, | |
50bd50d4 MH |
757 | #if 0 |
758 | /* Since a.out files lack decent magic numbers, no way to recognize | |
759 | which kind of a.out file it is. */ | |
760 | &m68klinux_vec, | |
761 | #endif | |
3bca0336 KR |
762 | &m68klynx_aout_vec, |
763 | &m68klynx_coff_vec, | |
7a1d4567 | 764 | &m68knetbsd_vec, |
ac388f2a | 765 | &m68ksysvcoff_vec, |
cf39664e | 766 | &m88kbcs_vec, |
a3f7a777 | 767 | &m88kmach3_vec, |
cf39664e | 768 | &newsos3_vec, |
493a2593 | 769 | &nlm32_i386_vec, |
c96451db | 770 | &nlm32_sparc_vec, |
ebd24135 | 771 | #ifdef BFD64 |
3b31740c | 772 | &nlm32_alpha_vec, |
cf39664e | 773 | #endif |
c768bd3f | 774 | &pc532netbsd_vec, |
cf39664e DM |
775 | #if 0 |
776 | /* We have no oasys tools anymore, so we can't test any of this | |
777 | anymore. If you want to test the stuff yourself, go ahead... | |
778 | steve@cygnus.com | |
779 | Worse, since there is no magic number for archives, there | |
780 | can be annoying target mis-matches. */ | |
781 | &oasys_vec, | |
a3f7a777 C |
782 | #endif |
783 | &pc532machaout_vec, | |
784 | #if 0 | |
89665c85 SC |
785 | /* We have no way of distinguishing these from other a.out variants */ |
786 | &aout_arm_big_vec, | |
787 | &aout_arm_little_vec, | |
a3f7a777 | 788 | &riscix_vec, |
c53fac12 ILT |
789 | #endif |
790 | #if 0 | |
791 | /* This has the same magic number as RS/6000. */ | |
792 | &pmac_xcoff_vec, | |
ebd24135 | 793 | #endif |
f39b81f5 | 794 | &rs6000coff_vec, |
50bd50d4 | 795 | &ppcboot_vec, |
cf39664e | 796 | &shcoff_vec, |
7a1d4567 | 797 | &shlcoff_vec, |
20b2c808 DE |
798 | &shcoff_small_vec, |
799 | &shlcoff_small_vec, | |
efc2b064 | 800 | &sparcle_aout_vec, |
20b2c808 | 801 | &sparclinux_vec, |
c188b0be DM |
802 | &sparclynx_aout_vec, |
803 | &sparclynx_coff_vec, | |
a3f7a777 | 804 | &sparcnetbsd_vec, |
cf39664e | 805 | &sunos_big_vec, |
7ce8b9d1 | 806 | &aout0_big_vec, |
cf39664e | 807 | &tekhex_vec, |
e8f2efef ILT |
808 | &tic30_aout_vec, |
809 | &tic30_coff_vec, | |
fd8d7c31 MH |
810 | /* start-sanitize-tic80 */ |
811 | &tic80coff_vec, | |
812 | /* end-sanitize-tic80 */ | |
303b4cc6 | 813 | &vaxnetbsd_vec, |
89665c85 | 814 | &versados_vec, |
303b4cc6 | 815 | &we32kcoff_vec, |
cf39664e | 816 | &z8kcoff_vec, |
f39b81f5 | 817 | |
5f9a2245 DM |
818 | #endif /* not SELECT_VECS */ |
819 | ||
180acef5 DM |
820 | /* Always support S-records, for convenience. */ |
821 | &srec_vec, | |
822 | &symbolsrec_vec, | |
89665c85 SC |
823 | /* And tekhex */ |
824 | &tekhex_vec, | |
c768bd3f ILT |
825 | /* Likewise for binary output. */ |
826 | &binary_vec, | |
ffd15489 ILT |
827 | /* Likewise for ihex. */ |
828 | &ihex_vec, | |
c768bd3f | 829 | |
5f9a2245 DM |
830 | /* Add any required traditional-core-file-handler. */ |
831 | ||
60ac749c | 832 | #ifdef AIX386_CORE |
2c4f2c72 | 833 | &aix386_core_vec, |
f39b81f5 | 834 | #endif |
a643e626 ILT |
835 | #ifdef HPUX_CORE |
836 | &hpux_core_vec, | |
837 | #endif | |
c96451db SEF |
838 | #ifdef HPPABSD_CORE |
839 | &hppabsd_core_vec, | |
840 | #endif | |
dabfe2f6 ILT |
841 | #ifdef IRIX_CORE |
842 | &irix_core_vec, | |
843 | #endif | |
303b4cc6 RH |
844 | #ifdef NETBSD_CORE |
845 | &netbsd_core_vec, | |
846 | #endif | |
3bca0336 KR |
847 | #ifdef OSF_CORE |
848 | &osf_core_vec, | |
849 | #endif | |
cf39664e DM |
850 | #ifdef TRAD_CORE |
851 | &trad_core_vec, | |
852 | #endif | |
2ebd0976 | 853 | |
dabfe2f6 ILT |
854 | #ifdef PTRACE_CORE |
855 | &ptrace_core_vec, | |
856 | #endif | |
857 | ||
5f9a2245 | 858 | NULL /* end of list marker */ |
7d774e01 | 859 | }; |
c0e5039e | 860 | |
d1ad85a6 | 861 | /* bfd_default_vector[0] contains either the address of the default vector, |
c0e5039e JG |
862 | if there is one, or zero if there isn't. */ |
863 | ||
ac388f2a | 864 | const bfd_target *bfd_default_vector[] = { |
c0e5039e | 865 | #ifdef DEFAULT_VECTOR |
616ebcfd | 866 | &DEFAULT_VECTOR, |
378dac8c | 867 | #endif |
5f9a2245 | 868 | NULL |
c0e5039e | 869 | }; |
6f715d66 | 870 | |
d1ad85a6 DM |
871 | /* When there is an ambiguous match, bfd_check_format_matches puts the |
872 | names of the matching targets in an array. This variable is the maximum | |
873 | number of entries that the array could possibly need. */ | |
a3f7a777 | 874 | const size_t _bfd_target_vector_entries = sizeof(bfd_target_vector)/sizeof(*bfd_target_vector); |
ac388f2a | 875 | \f |
fd8d7c31 MH |
876 | /* This array maps configuration triplets onto BFD vectors. */ |
877 | ||
878 | struct targmatch | |
879 | { | |
880 | /* The configuration triplet. */ | |
881 | const char *triplet; | |
882 | /* The BFD vector. If this is NULL, then the vector is found by | |
883 | searching forward for the next structure with a non NULL vector | |
20b2c808 | 884 | field. */ |
fd8d7c31 MH |
885 | const bfd_target *vector; |
886 | }; | |
887 | ||
fd8d7c31 MH |
888 | /* targmatch.h is built by Makefile out of config.bfd. */ |
889 | static const struct targmatch bfd_target_match[] = { | |
890 | #include "targmatch.h" | |
891 | { NULL, NULL } | |
892 | }; | |
893 | ||
ac388f2a ILT |
894 | static const bfd_target *find_target PARAMS ((const char *)); |
895 | ||
896 | /* Find a target vector, given a name or configuration triplet. */ | |
897 | ||
898 | static const bfd_target * | |
899 | find_target (name) | |
900 | const char *name; | |
901 | { | |
902 | const bfd_target * const *target; | |
903 | const struct targmatch *match; | |
904 | ||
905 | for (target = &bfd_target_vector[0]; *target != NULL; target++) | |
906 | if (strcmp (name, (*target)->name) == 0) | |
907 | return *target; | |
908 | ||
909 | /* If we couldn't match on the exact name, try matching on the | |
910 | configuration triplet. FIXME: We should run the triplet through | |
911 | config.sub first, but that is hard. */ | |
912 | for (match = &bfd_target_match[0]; match->triplet != NULL; match++) | |
913 | { | |
914 | if (fnmatch (match->triplet, name, 0) == 0) | |
915 | { | |
916 | while (match->vector == NULL) | |
917 | ++match; | |
20b2c808 | 918 | return match->vector; |
ac388f2a ILT |
919 | break; |
920 | } | |
921 | } | |
922 | ||
923 | bfd_set_error (bfd_error_invalid_target); | |
924 | return NULL; | |
925 | } | |
926 | ||
927 | /* | |
928 | FUNCTION | |
929 | bfd_set_default_target | |
930 | ||
931 | SYNOPSIS | |
932 | boolean bfd_set_default_target (const char *name); | |
933 | ||
934 | DESCRIPTION | |
935 | Set the default target vector to use when recognizing a BFD. | |
936 | This takes the name of the target, which may be a BFD target | |
937 | name or a configuration triplet. | |
938 | */ | |
939 | ||
940 | boolean | |
941 | bfd_set_default_target (name) | |
942 | const char *name; | |
943 | { | |
ac388f2a ILT |
944 | const bfd_target *target; |
945 | ||
20b2c808 DE |
946 | if (bfd_default_vector[0] != NULL |
947 | && strcmp (name, bfd_default_vector[0]->name) == 0) | |
948 | return true; | |
ac388f2a ILT |
949 | |
950 | target = find_target (name); | |
951 | if (target == NULL) | |
952 | return false; | |
953 | ||
954 | bfd_default_vector[0] = target; | |
955 | return true; | |
956 | } | |
957 | ||
0cda46cf SC |
958 | /* |
959 | FUNCTION | |
960 | bfd_find_target | |
961 | ||
c188b0be | 962 | SYNOPSIS |
a3f7a777 | 963 | const bfd_target *bfd_find_target(CONST char *target_name, bfd *abfd); |
c188b0be | 964 | |
0cda46cf | 965 | DESCRIPTION |
c188b0be | 966 | Return a pointer to the transfer vector for the object target |
c96451db SEF |
967 | named @var{target_name}. If @var{target_name} is <<NULL>>, choose the |
968 | one in the environment variable <<GNUTARGET>>; if that is null or not | |
c188b0be | 969 | defined, then choose the first entry in the target list. |
0cda46cf SC |
970 | Passing in the string "default" or setting the environment |
971 | variable to "default" will cause the first entry in the target | |
972 | list to be returned, and "target_defaulted" will be set in the | |
973 | BFD. This causes <<bfd_check_format>> to loop over all the | |
974 | targets to find the one that matches the file being read. | |
0cda46cf | 975 | */ |
6f715d66 | 976 | |
a3f7a777 | 977 | const bfd_target * |
57a1867e | 978 | bfd_find_target (target_name, abfd) |
fd8d7c31 | 979 | const char *target_name; |
57a1867e | 980 | bfd *abfd; |
6f715d66 | 981 | { |
fd8d7c31 | 982 | const char *targname; |
ac388f2a | 983 | const bfd_target *target; |
fd8d7c31 MH |
984 | |
985 | if (target_name != NULL) | |
986 | targname = target_name; | |
987 | else | |
988 | targname = getenv ("GNUTARGET"); | |
6f715d66 SC |
989 | |
990 | /* This is safe; the vector cannot be null */ | |
fd8d7c31 MH |
991 | if (targname == NULL || strcmp (targname, "default") == 0) |
992 | { | |
993 | abfd->target_defaulted = true; | |
ac388f2a ILT |
994 | if (bfd_default_vector[0] != NULL) |
995 | abfd->xvec = bfd_default_vector[0]; | |
996 | else | |
997 | abfd->xvec = bfd_target_vector[0]; | |
998 | return abfd->xvec; | |
fd8d7c31 | 999 | } |
6f715d66 SC |
1000 | |
1001 | abfd->target_defaulted = false; | |
1002 | ||
ac388f2a ILT |
1003 | target = find_target (targname); |
1004 | if (target == NULL) | |
1005 | return NULL; | |
fd8d7c31 | 1006 | |
ac388f2a ILT |
1007 | abfd->xvec = target; |
1008 | return target; | |
6f715d66 SC |
1009 | } |
1010 | ||
0cda46cf SC |
1011 | /* |
1012 | FUNCTION | |
1013 | bfd_target_list | |
1014 | ||
0cda46cf | 1015 | SYNOPSIS |
a3f7a777 | 1016 | const char **bfd_target_list(void); |
0cda46cf | 1017 | |
c188b0be DM |
1018 | DESCRIPTION |
1019 | Return a freshly malloced NULL-terminated | |
1020 | vector of the names of all the valid BFD targets. Do not | |
1021 | modify the names. | |
1022 | ||
0cda46cf | 1023 | */ |
6f715d66 | 1024 | |
a3f7a777 | 1025 | const char ** |
57a1867e | 1026 | bfd_target_list () |
6f715d66 SC |
1027 | { |
1028 | int vec_length= 0; | |
b7577823 | 1029 | #if defined (HOST_HPPAHPUX) && ! defined (__STDC__) |
990e7c22 JG |
1030 | /* The native compiler on the HP9000/700 has a bug which causes it |
1031 | to loop endlessly when compiling this file. This avoids it. */ | |
1032 | volatile | |
1033 | #endif | |
a3f7a777 | 1034 | const bfd_target * const *target; |
4e6f9223 | 1035 | CONST char **name_list, **name_ptr; |
6f715d66 | 1036 | |
d1ad85a6 | 1037 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
1038 | vec_length++; |
1039 | ||
d1ad85a6 DM |
1040 | name_ptr = name_list = (CONST char **) |
1041 | bfd_zmalloc ((vec_length + 1) * sizeof (char **)); | |
6f715d66 | 1042 | |
a9713b91 | 1043 | if (name_list == NULL) |
6f715d66 | 1044 | return NULL; |
6f715d66 | 1045 | |
d1ad85a6 | 1046 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
1047 | *(name_ptr++) = (*target)->name; |
1048 | ||
1049 | return name_list; | |
1050 | } |