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