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