Commit | Line | Data |
---|---|---|
4e6f9223 | 1 | /* Generic target-file-type support for the BFD library. |
fdfe2d14 | 2 | Copyright 1990, 91, 92, 93, 1994 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 SC |
18 | along with this program; if not, write to the Free Software |
19 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ | |
4a81b561 | 20 | |
4a81b561 | 21 | #include "bfd.h" |
bbc8d484 | 22 | #include "sysdep.h" |
4a81b561 DHW |
23 | #include "libbfd.h" |
24 | ||
0cda46cf SC |
25 | /* |
26 | SECTION | |
27 | Targets | |
28 | ||
e98e6ec1 | 29 | DESCRIPTION |
0cda46cf SC |
30 | Each port of BFD to a different machine requries the creation |
31 | of a target back end. All the back end provides to the root | |
32 | part of BFD is a structure containing pointers to functions | |
33 | which perform certain low level operations on files. BFD | |
34 | translates the applications's requests through a pointer into | |
35 | calls to the back end routines. | |
36 | ||
37 | When a file is opened with <<bfd_openr>>, its format and | |
38 | target are unknown. BFD uses various mechanisms to determine | |
39 | how to interpret the file. The operations performed are: | |
40 | ||
c188b0be | 41 | o Create a BFD by calling the internal routine |
d1ad85a6 | 42 | <<_bfd_new_bfd>>, then call <<bfd_find_target>> with the |
0cda46cf SC |
43 | target string supplied to <<bfd_openr>> and the new BFD pointer. |
44 | ||
45 | o If a null target string was provided to <<bfd_find_target>>, | |
c188b0be | 46 | look up the environment variable <<GNUTARGET>> and use |
0cda46cf SC |
47 | that as the target string. |
48 | ||
c96451db | 49 | o If the target string is still <<NULL>>, or the target string is |
c188b0be DM |
50 | <<default>>, then use the first item in the target vector |
51 | as the target type, and set <<target_defaulted>> in the BFD to | |
218ce930 JG |
52 | cause <<bfd_check_format>> to loop through all the targets. |
53 | @xref{bfd_target}. @xref{Formats}. | |
0cda46cf | 54 | |
c188b0be | 55 | o Otherwise, inspect the elements in the target vector |
0cda46cf | 56 | one by one, until a match on target name is found. When found, |
c188b0be | 57 | use it. |
0cda46cf | 58 | |
d1ad85a6 | 59 | o Otherwise return the error <<bfd_error_invalid_target>> to |
0cda46cf SC |
60 | <<bfd_openr>>. |
61 | ||
62 | o <<bfd_openr>> attempts to open the file using | |
63 | <<bfd_open_file>>, and returns the BFD. | |
64 | ||
65 | Once the BFD has been opened and the target selected, the file | |
66 | format may be determined. This is done by calling | |
218ce930 JG |
67 | <<bfd_check_format>> on the BFD with a suggested format. |
68 | If <<target_defaulted>> has been set, each possible target | |
c188b0be DM |
69 | type is tried to see if it recognizes the specified format. |
70 | <<bfd_check_format>> returns <<true>> when the caller guesses right. | |
92c78ee6 | 71 | @menu |
e98e6ec1 | 72 | @* bfd_target:: |
92c78ee6 | 73 | @end menu |
6f715d66 SC |
74 | */ |
75 | ||
76 | ||
0cda46cf SC |
77 | /* |
78 | ||
e98e6ec1 SC |
79 | INODE |
80 | bfd_target, , Targets, Targets | |
6697a1a9 | 81 | DOCDD |
0cda46cf SC |
82 | SUBSECTION |
83 | bfd_target | |
84 | ||
e98e6ec1 | 85 | DESCRIPTION |
0cda46cf | 86 | This structure contains everything that BFD knows about a |
c188b0be DM |
87 | target. It includes things like its byte order, name, and which |
88 | routines to call to do various operations. | |
6f715d66 | 89 | |
0cda46cf SC |
90 | Every BFD points to a target structure with its <<xvec>> |
91 | member. | |
6f715d66 | 92 | |
c188b0be DM |
93 | The macros below are used to dispatch to functions through the |
94 | <<bfd_target>> vector. They are used in a number of macros further | |
0cda46cf | 95 | down in @file{bfd.h}, and are also used when calling various |
c188b0be | 96 | routines by hand inside the BFD implementation. The @var{arglist} |
0cda46cf SC |
97 | argument must be parenthesized; it contains all the arguments |
98 | to the called function. | |
6f715d66 | 99 | |
ce07dd7c KR |
100 | They make the documentation (more) unpleasant to read, so if |
101 | someone wants to fix this and not break the above, please do. | |
6f715d66 | 102 | |
0cda46cf SC |
103 | .#define BFD_SEND(bfd, message, arglist) \ |
104 | . ((*((bfd)->xvec->message)) arglist) | |
fdfe2d14 SS |
105 | . |
106 | .#ifdef DEBUG_BFD_SEND | |
107 | .#undef BFD_SEND | |
108 | .#define BFD_SEND(bfd, message, arglist) \ | |
109 | . (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \ | |
110 | . ((*((bfd)->xvec->message)) arglist) : \ | |
111 | . (bfd_assert (__FILE__,__LINE__), NULL)) | |
112 | .#endif | |
6f715d66 | 113 | |
c188b0be | 114 | For operations which index on the BFD format: |
6f715d66 | 115 | |
0cda46cf SC |
116 | .#define BFD_SEND_FMT(bfd, message, arglist) \ |
117 | . (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) | |
fdfe2d14 SS |
118 | . |
119 | .#ifdef DEBUG_BFD_SEND | |
120 | .#undef BFD_SEND_FMT | |
121 | .#define BFD_SEND_FMT(bfd, message, arglist) \ | |
122 | . (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \ | |
123 | . (((bfd)->xvec->message[(int)((bfd)->format)]) arglist) : \ | |
124 | . (bfd_assert (__FILE__,__LINE__), NULL)) | |
125 | .#endif | |
6f715d66 | 126 | |
c188b0be | 127 | This is the structure which defines the type of BFD this is. The |
0cda46cf SC |
128 | <<xvec>> member of the struct <<bfd>> itself points here. Each |
129 | module that implements access to a different target under BFD, | |
130 | defines one of these. | |
6f715d66 | 131 | |
6f715d66 | 132 | |
0cda46cf SC |
133 | FIXME, these names should be rationalised with the names of |
134 | the entry points which call them. Too bad we can't have one | |
135 | macro to define them both! | |
136 | ||
c188b0be DM |
137 | .enum bfd_flavour { |
138 | . bfd_target_unknown_flavour, | |
139 | . bfd_target_aout_flavour, | |
140 | . bfd_target_coff_flavour, | |
141 | . bfd_target_ecoff_flavour, | |
142 | . bfd_target_elf_flavour, | |
143 | . bfd_target_ieee_flavour, | |
144 | . bfd_target_nlm_flavour, | |
145 | . bfd_target_oasys_flavour, | |
146 | . bfd_target_tekhex_flavour, | |
147 | . bfd_target_srec_flavour, | |
2f88343d KH |
148 | . bfd_target_som_flavour, |
149 | . bfd_target_os9k_flavour}; | |
4c3721d5 ILT |
150 | . |
151 | .{* Forward declaration. *} | |
152 | .typedef struct bfd_link_info _bfd_link_info; | |
153 | . | |
0cda46cf SC |
154 | .typedef struct bfd_target |
155 | .{ | |
6f715d66 | 156 | |
c188b0be | 157 | Identifies the kind of target, e.g., SunOS4, Ultrix, etc. |
6f715d66 | 158 | |
0cda46cf | 159 | . char *name; |
6f715d66 SC |
160 | |
161 | The "flavour" of a back end is a general indication about the contents | |
162 | of a file. | |
163 | ||
c188b0be | 164 | . enum bfd_flavour flavour; |
6f715d66 SC |
165 | |
166 | The order of bytes within the data area of a file. | |
167 | ||
0cda46cf | 168 | . boolean byteorder_big_p; |
6f715d66 SC |
169 | |
170 | The order of bytes within the header parts of a file. | |
171 | ||
0cda46cf | 172 | . boolean header_byteorder_big_p; |
6f715d66 | 173 | |
c188b0be | 174 | A mask of all the flags which an executable may have set - |
0cda46cf | 175 | from the set <<NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>. |
6f715d66 | 176 | |
0cda46cf | 177 | . flagword object_flags; |
6f715d66 | 178 | |
c188b0be | 179 | A mask of all the flags which a section may have set - from |
0cda46cf | 180 | the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>. |
6f715d66 | 181 | |
0cda46cf | 182 | . flagword section_flags; |
6f715d66 | 183 | |
990e7c22 | 184 | The character normally found at the front of a symbol |
c188b0be | 185 | (if any), perhaps `_'. |
990e7c22 JG |
186 | |
187 | . char symbol_leading_char; | |
188 | ||
c188b0be | 189 | The pad character for file names within an archive header. |
6f715d66 | 190 | |
0cda46cf | 191 | . char ar_pad_char; |
6f715d66 SC |
192 | |
193 | The maximum number of characters in an archive header. | |
194 | ||
60ac749c | 195 | . unsigned short ar_max_namelen; |
6f715d66 SC |
196 | |
197 | The minimum alignment restriction for any section. | |
198 | ||
0cda46cf | 199 | . unsigned int align_power_min; |
6f715d66 | 200 | |
c188b0be DM |
201 | Entries for byte swapping for data. These are different from the other |
202 | entry points, since they don't take a BFD asthe first argument. | |
203 | Certain other handlers could do the same. | |
6f715d66 | 204 | |
3b31740c DM |
205 | . bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *)); |
206 | . bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *)); | |
60ac749c | 207 | . void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
208 | . bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *)); |
209 | . bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *)); | |
60ac749c | 210 | . void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
211 | . bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *)); |
212 | . bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *)); | |
60ac749c | 213 | . void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *)); |
6f715d66 SC |
214 | |
215 | Byte swapping for the headers | |
216 | ||
3b31740c DM |
217 | . bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *)); |
218 | . bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *)); | |
60ac749c | 219 | . void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
220 | . bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *)); |
221 | . bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *)); | |
60ac749c | 222 | . void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *)); |
3b31740c DM |
223 | . bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *)); |
224 | . bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *)); | |
60ac749c | 225 | . void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *)); |
6f715d66 | 226 | |
60ac749c ILT |
227 | Format dependent routines: these are vectors of entry points |
228 | within the target vector structure, one for each format to check. | |
6f715d66 | 229 | |
c188b0be | 230 | Check the format of a file being read. Return a <<bfd_target *>> or zero. |
6f715d66 | 231 | |
a3f7a777 | 232 | . const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 SC |
233 | |
234 | Set the format of a file being written. | |
235 | ||
60ac749c | 236 | . boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 | 237 | |
c188b0be | 238 | Write cached information into a file being written, at <<bfd_close>>. |
6f715d66 | 239 | |
60ac749c | 240 | . boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *)); |
6f715d66 | 241 | |
6812b607 | 242 | The general target vector. |
6f715d66 | 243 | |
6812b607 ILT |
244 | . |
245 | . {* Generic entry points. *} | |
246 | .#define BFD_JUMP_TABLE_GENERIC(NAME)\ | |
247 | .CAT(NAME,_close_and_cleanup),\ | |
248 | .CAT(NAME,_bfd_free_cached_info),\ | |
249 | .CAT(NAME,_new_section_hook),\ | |
250 | .CAT(NAME,_get_section_contents) | |
251 | . {* Called when the BFD is being closed to do any necessary cleanup. *} | |
252 | . boolean (*_close_and_cleanup) PARAMS ((bfd *)); | |
253 | . {* Ask the BFD to free all cached information. *} | |
254 | . boolean (*_bfd_free_cached_info) PARAMS ((bfd *)); | |
255 | . {* Called when a new section is created. *} | |
256 | . boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr)); | |
257 | . {* Read the contents of a section. *} | |
258 | . boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
259 | . file_ptr, bfd_size_type)); | |
260 | . | |
261 | . {* Entry points to copy private data. *} | |
262 | .#define BFD_JUMP_TABLE_COPY(NAME)\ | |
263 | .CAT(NAME,_bfd_copy_private_bfd_data),\ | |
264 | .CAT(NAME,_bfd_copy_private_section_data) | |
265 | . {* Called to copy BFD general private data from one object file | |
266 | . to another. *} | |
267 | . boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *)); | |
268 | . {* Called to copy BFD private section data from one object file | |
269 | . to another. *} | |
270 | . boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr, | |
271 | . bfd *, sec_ptr)); | |
272 | . | |
273 | . {* Core file entry points. *} | |
274 | .#define BFD_JUMP_TABLE_CORE(NAME)\ | |
275 | .CAT(NAME,_core_file_failing_command),\ | |
276 | .CAT(NAME,_core_file_failing_signal),\ | |
277 | .CAT(NAME,_core_file_matches_executable_p) | |
60ac749c ILT |
278 | . char * (*_core_file_failing_command) PARAMS ((bfd *)); |
279 | . int (*_core_file_failing_signal) PARAMS ((bfd *)); | |
280 | . boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *)); | |
6812b607 ILT |
281 | . |
282 | . {* Archive entry points. *} | |
283 | .#define BFD_JUMP_TABLE_ARCHIVE(NAME)\ | |
284 | .CAT(NAME,_slurp_armap),\ | |
285 | .CAT(NAME,_slurp_extended_name_table),\ | |
cd9782e8 | 286 | .CAT(NAME,_construct_extended_name_table),\ |
6812b607 ILT |
287 | .CAT(NAME,_truncate_arname),\ |
288 | .CAT(NAME,_write_armap),\ | |
289 | .CAT(NAME,_openr_next_archived_file),\ | |
a3f7a777 C |
290 | .CAT(NAME,_generic_stat_arch_elt),\ |
291 | .CAT(NAME,_update_armap_timestamp) | |
60ac749c ILT |
292 | . boolean (*_bfd_slurp_armap) PARAMS ((bfd *)); |
293 | . boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *)); | |
cd9782e8 ILT |
294 | . boolean (*_bfd_construct_extended_name_table) |
295 | . PARAMS ((bfd *, char **, bfd_size_type *, const char **)); | |
60ac749c ILT |
296 | . void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *)); |
297 | . boolean (*write_armap) PARAMS ((bfd *arch, | |
0cda46cf SC |
298 | . unsigned int elength, |
299 | . struct orl *map, | |
300 | . unsigned int orl_count, | |
301 | . int stridx)); | |
a3f7a777 C |
302 | . bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev)); |
303 | . int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *)); | |
304 | . boolean (*_bfd_update_armap_timestamp) PARAMS ((bfd *)); | |
305 | . | |
6812b607 ILT |
306 | . {* Entry points used for symbols. *} |
307 | .#define BFD_JUMP_TABLE_SYMBOLS(NAME)\ | |
308 | .CAT(NAME,_get_symtab_upper_bound),\ | |
309 | .CAT(NAME,_get_symtab),\ | |
310 | .CAT(NAME,_make_empty_symbol),\ | |
311 | .CAT(NAME,_print_symbol),\ | |
312 | .CAT(NAME,_get_symbol_info),\ | |
313 | .CAT(NAME,_bfd_is_local_label),\ | |
314 | .CAT(NAME,_get_lineno),\ | |
315 | .CAT(NAME,_find_nearest_line),\ | |
316 | .CAT(NAME,_bfd_make_debug_symbol) | |
326e32d7 ILT |
317 | . long (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *)); |
318 | . long (*_bfd_canonicalize_symtab) PARAMS ((bfd *, | |
319 | . struct symbol_cache_entry **)); | |
60ac749c ILT |
320 | . struct symbol_cache_entry * |
321 | . (*_bfd_make_empty_symbol) PARAMS ((bfd *)); | |
322 | . void (*_bfd_print_symbol) PARAMS ((bfd *, PTR, | |
323 | . struct symbol_cache_entry *, | |
0cda46cf SC |
324 | . bfd_print_symbol_type)); |
325 | .#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e)) | |
93b4f018 DM |
326 | . void (*_bfd_get_symbol_info) PARAMS ((bfd *, |
327 | . struct symbol_cache_entry *, | |
328 | . symbol_info *)); | |
329 | .#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e)) | |
bdf1b511 | 330 | . boolean (*_bfd_is_local_label) PARAMS ((bfd *, asymbol *)); |
0cda46cf | 331 | . |
6812b607 | 332 | . alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *)); |
60ac749c ILT |
333 | . boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd, |
334 | . struct sec *section, struct symbol_cache_entry **symbols, | |
335 | . bfd_vma offset, CONST char **file, CONST char **func, | |
336 | . unsigned int *line)); | |
6812b607 ILT |
337 | . {* Back-door to allow format-aware applications to create debug symbols |
338 | . while using BFD for everything else. Currently used by the assembler | |
339 | . when creating COFF files. *} | |
340 | . asymbol * (*_bfd_make_debug_symbol) PARAMS (( | |
341 | . bfd *abfd, | |
342 | . void *ptr, | |
343 | . unsigned long size)); | |
0cda46cf | 344 | . |
6812b607 ILT |
345 | . {* Routines for relocs. *} |
346 | .#define BFD_JUMP_TABLE_RELOCS(NAME)\ | |
347 | .CAT(NAME,_get_reloc_upper_bound),\ | |
348 | .CAT(NAME,_canonicalize_reloc),\ | |
349 | .CAT(NAME,_bfd_reloc_type_lookup) | |
350 | . long (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr)); | |
351 | . long (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **, | |
352 | . struct symbol_cache_entry **)); | |
353 | . {* See documentation on reloc types. *} | |
354 | . CONST struct reloc_howto_struct * | |
355 | . (*reloc_type_lookup) PARAMS ((bfd *abfd, | |
356 | . bfd_reloc_code_real_type code)); | |
0cda46cf | 357 | . |
6812b607 ILT |
358 | . {* Routines used when writing an object file. *} |
359 | .#define BFD_JUMP_TABLE_WRITE(NAME)\ | |
360 | .CAT(NAME,_set_arch_mach),\ | |
361 | .CAT(NAME,_set_section_contents) | |
362 | . boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture, | |
363 | . unsigned long)); | |
364 | . boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR, | |
365 | . file_ptr, bfd_size_type)); | |
0cda46cf | 366 | . |
6812b607 ILT |
367 | . {* Routines used by the linker. *} |
368 | .#define BFD_JUMP_TABLE_LINK(NAME)\ | |
369 | .CAT(NAME,_sizeof_headers),\ | |
370 | .CAT(NAME,_bfd_get_relocated_section_contents),\ | |
371 | .CAT(NAME,_bfd_relax_section),\ | |
372 | .CAT(NAME,_bfd_link_hash_table_create),\ | |
373 | .CAT(NAME,_bfd_link_add_symbols),\ | |
374 | .CAT(NAME,_bfd_final_link) | |
375 | . int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean)); | |
60ac749c | 376 | . bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *, |
4c3721d5 ILT |
377 | . struct bfd_link_info *, struct bfd_link_order *, |
378 | . bfd_byte *data, boolean relocateable, | |
379 | . struct symbol_cache_entry **)); | |
0cda46cf | 380 | . |
60ac749c | 381 | . boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *, |
bdf1b511 | 382 | . struct bfd_link_info *, boolean *again)); |
2ebd0976 | 383 | . |
ad46bd1d ILT |
384 | . {* Create a hash table for the linker. Different backends store |
385 | . different information in this table. *} | |
386 | . struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *)); | |
4c3721d5 | 387 | . |
ad46bd1d ILT |
388 | . {* Add symbols from this object file into the hash table. *} |
389 | . boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *)); | |
4c3721d5 | 390 | . |
ad46bd1d ILT |
391 | . {* Do a link based on the link_order structures attached to each |
392 | . section of the BFD. *} | |
393 | . boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *)); | |
394 | . | |
395 | . {* Routines to handle dynamic symbols and relocs. *} | |
396 | .#define BFD_JUMP_TABLE_DYNAMIC(NAME)\ | |
397 | .CAT(NAME,_get_dynamic_symtab_upper_bound),\ | |
398 | .CAT(NAME,_canonicalize_dynamic_symtab),\ | |
399 | .CAT(NAME,_get_dynamic_reloc_upper_bound),\ | |
400 | .CAT(NAME,_canonicalize_dynamic_reloc) | |
401 | . {* Get the amount of memory required to hold the dynamic symbols. *} | |
402 | . long (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *)); | |
403 | . {* Read in the dynamic symbols. *} | |
404 | . long (*_bfd_canonicalize_dynamic_symtab) | |
405 | . PARAMS ((bfd *, struct symbol_cache_entry **)); | |
406 | . {* Get the amount of memory required to hold the dynamic relocs. *} | |
407 | . long (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *)); | |
408 | . {* Read in the dynamic relocs. *} | |
409 | . long (*_bfd_canonicalize_dynamic_reloc) | |
410 | . PARAMS ((bfd *, arelent **, struct symbol_cache_entry **)); | |
4c3721d5 | 411 | . |
ce07dd7c | 412 | |
14e3c2e4 JK |
413 | Data for use by back-end routines, which isn't generic enough to belong |
414 | in this structure. | |
ce07dd7c KR |
415 | |
416 | . PTR backend_data; | |
0cda46cf | 417 | .} bfd_target; |
6f715d66 SC |
418 | |
419 | */ | |
f8adc62d | 420 | |
cf39664e DM |
421 | /* All known xvecs (even those that don't compile on all systems). |
422 | Alphabetized for easy reference. | |
423 | They are listed a second time below, since | |
616ebcfd | 424 | we can't intermix extern's and initializers. */ |
a3f7a777 C |
425 | extern const bfd_target a29kcoff_big_vec; |
426 | extern const bfd_target a_out_adobe_vec; | |
427 | extern const bfd_target aout_mips_big_vec; | |
428 | extern const bfd_target aout_mips_little_vec; | |
429 | extern const bfd_target aout0_big_vec; | |
430 | extern const bfd_target apollocoff_vec; | |
431 | extern const bfd_target b_out_vec_big_host; | |
432 | extern const bfd_target b_out_vec_little_host; | |
d468a149 SC |
433 | /* start-sanitize-arc */ |
434 | extern const bfd_target bfd_elf32_arc_vec; | |
435 | /* end-sanitize-arc */ | |
a3f7a777 C |
436 | extern const bfd_target bfd_elf32_big_generic_vec; |
437 | extern const bfd_target bfd_elf32_bigmips_vec; | |
438 | extern const bfd_target bfd_elf32_hppa_vec; | |
439 | extern const bfd_target bfd_elf32_i386_vec; | |
440 | extern const bfd_target bfd_elf32_i860_vec; | |
441 | extern const bfd_target bfd_elf32_little_generic_vec; | |
442 | extern const bfd_target bfd_elf32_littlemips_vec; | |
443 | extern const bfd_target bfd_elf32_m68k_vec; | |
444 | extern const bfd_target bfd_elf32_m88k_vec; | |
445 | extern const bfd_target bfd_elf32_powerpc_vec; | |
446 | extern const bfd_target bfd_elf32_sparc_vec; | |
447 | extern const bfd_target bfd_elf64_big_generic_vec; | |
448 | extern const bfd_target bfd_elf64_little_generic_vec; | |
449 | extern const bfd_target bfd_elf64_sparc_vec; | |
450 | extern const bfd_target demo_64_vec; | |
451 | extern const bfd_target ecoff_big_vec; | |
452 | extern const bfd_target ecoff_little_vec; | |
453 | extern const bfd_target ecoffalpha_little_vec; | |
454 | extern const bfd_target h8300coff_vec; | |
455 | extern const bfd_target h8500coff_vec; | |
456 | extern const bfd_target host_aout_vec; | |
457 | extern const bfd_target hp300bsd_vec; | |
458 | extern const bfd_target hp300hpux_vec; | |
459 | extern const bfd_target som_vec; | |
460 | extern const bfd_target i386aout_vec; | |
461 | extern const bfd_target i386bsd_vec; | |
462 | extern const bfd_target i386dynix_vec; | |
463 | extern const bfd_target i386os9k_vec; | |
464 | extern const bfd_target i386coff_vec; | |
465 | extern const bfd_target go32coff_vec; | |
466 | extern const bfd_target i386linux_vec; | |
467 | extern const bfd_target i386lynx_aout_vec; | |
468 | extern const bfd_target i386lynx_coff_vec; | |
469 | extern const bfd_target i386mach3_vec; | |
470 | extern const bfd_target i386netbsd_vec; | |
471 | extern const bfd_target icoff_big_vec; | |
472 | extern const bfd_target icoff_little_vec; | |
473 | extern const bfd_target ieee_vec; | |
474 | extern const bfd_target m68kcoff_vec; | |
475 | extern const bfd_target m68kcoffun_vec; | |
476 | extern const bfd_target m68klynx_aout_vec; | |
477 | extern const bfd_target m68klynx_coff_vec; | |
7a1d4567 | 478 | extern const bfd_target m68knetbsd_vec; |
a3f7a777 C |
479 | extern const bfd_target m88kbcs_vec; |
480 | extern const bfd_target m88kmach3_vec; | |
481 | extern const bfd_target newsos3_vec; | |
482 | extern const bfd_target nlm32_i386_vec; | |
483 | extern const bfd_target nlm32_sparc_vec; | |
484 | extern const bfd_target nlm32_alpha_vec; | |
485 | extern const bfd_target nlm32_powerpc_vec; | |
c768bd3f | 486 | extern const bfd_target pc532netbsd_vec; |
a3f7a777 C |
487 | extern const bfd_target oasys_vec; |
488 | extern const bfd_target pc532machaout_vec; | |
489 | extern const bfd_target riscix_vec; | |
490 | extern const bfd_target rs6000coff_vec; | |
491 | extern const bfd_target shcoff_vec; | |
03c4ce2f MT |
492 | /* start-sanitize-rce */ |
493 | extern bfd_target rce_aout_vec; | |
494 | /* end-sanitize-rce */ | |
7a1d4567 | 495 | extern const bfd_target shlcoff_vec; |
a3f7a777 C |
496 | extern const bfd_target sparclynx_aout_vec; |
497 | extern const bfd_target sparclynx_coff_vec; | |
498 | extern const bfd_target sparcnetbsd_vec; | |
499 | extern const bfd_target sparccoff_vec; | |
500 | extern const bfd_target sunos_big_vec; | |
501 | extern const bfd_target tekhex_vec; | |
502 | extern const bfd_target we32kcoff_vec; | |
d468a149 | 503 | extern const bfd_target w65_vec; |
a3f7a777 | 504 | extern const bfd_target z8kcoff_vec; |
cf39664e DM |
505 | |
506 | /* srec is always included. */ | |
a3f7a777 C |
507 | extern const bfd_target srec_vec; |
508 | extern const bfd_target symbolsrec_vec; | |
cf39664e | 509 | |
c768bd3f ILT |
510 | /* binary is always included. */ |
511 | extern const bfd_target binary_vec; | |
512 | ||
cf39664e | 513 | /* All of the xvecs for core files. */ |
a3f7a777 C |
514 | extern const bfd_target aix386_core_vec; |
515 | extern const bfd_target cisco_core_vec; | |
516 | extern const bfd_target hpux_core_vec; | |
517 | extern const bfd_target hppabsd_core_vec; | |
518 | extern const bfd_target irix_core_vec; | |
519 | extern const bfd_target osf_core_vec; | |
520 | extern const bfd_target sco_core_vec; | |
521 | extern const bfd_target trad_core_vec; | |
522 | extern const bfd_target ptrace_core_vec; | |
523 | ||
524 | const bfd_target * const bfd_target_vector[] = { | |
4e6f9223 | 525 | |
2ebd0976 | 526 | #ifdef SELECT_VECS |
14e3c2e4 JK |
527 | |
528 | SELECT_VECS, | |
529 | ||
530 | #else /* not SELECT_VECS */ | |
f39b81f5 | 531 | |
cf39664e DM |
532 | #ifdef DEFAULT_VECTOR |
533 | &DEFAULT_VECTOR, | |
534 | #endif | |
535 | /* This list is alphabetized to make it easy to compare | |
536 | with other vector lists -- the decls above and | |
537 | the case statement in configure.in. | |
538 | Vectors that don't compile on all systems, or aren't finished, | |
539 | should have an entry here with #if 0 around it, to show that | |
540 | it wasn't omitted by mistake. */ | |
541 | &a29kcoff_big_vec, | |
542 | &a_out_adobe_vec, | |
543 | #if 0 /* No one seems to use this. */ | |
2ebd0976 | 544 | &aout_mips_big_vec, |
cf39664e DM |
545 | #endif |
546 | &aout_mips_little_vec, | |
547 | &b_out_vec_big_host, | |
548 | &b_out_vec_little_host, | |
56a2f341 JK |
549 | |
550 | /* This, and other vectors, may not be used in any *.mt configuration. | |
a3f7a777 C |
551 | But that does not mean they are unnecessary. If configured with |
552 | --enable-targets=all, objdump or gdb should be able to examine | |
56a2f341 | 553 | the file even if we don't recognize the machine type. */ |
d468a149 SC |
554 | /* start-sanitize-arc */ |
555 | &bfd_elf32_arc_vec, | |
556 | /* end-sanitize-arc */ | |
cf39664e | 557 | &bfd_elf32_big_generic_vec, |
7218bb04 | 558 | &bfd_elf32_bigmips_vec, |
cf39664e | 559 | &bfd_elf32_hppa_vec, |
cf39664e DM |
560 | &bfd_elf32_i386_vec, |
561 | &bfd_elf32_i860_vec, | |
cf39664e | 562 | &bfd_elf32_little_generic_vec, |
7218bb04 | 563 | &bfd_elf32_littlemips_vec, |
cf39664e DM |
564 | &bfd_elf32_m68k_vec, |
565 | &bfd_elf32_m88k_vec, | |
566 | &bfd_elf32_sparc_vec, | |
7ce8b9d1 | 567 | &bfd_elf32_powerpc_vec, |
cf39664e DM |
568 | #ifdef BFD64 /* No one seems to use this. */ |
569 | &bfd_elf64_big_generic_vec, | |
570 | &bfd_elf64_little_generic_vec, | |
571 | #endif | |
cf39664e DM |
572 | #if 0 |
573 | &bfd_elf64_sparc_vec, | |
574 | #endif | |
bdf1b511 PS |
575 | /* We don't include cisco_core_vec. Although it has a magic number, |
576 | the magic number isn't at the beginning of the file, and thus | |
577 | might spuriously match other kinds of files. */ | |
2c4f2c72 | 578 | #ifdef BFD64 |
f39b81f5 | 579 | &demo_64_vec, /* Only compiled if host has long-long support */ |
cf39664e DM |
580 | #endif |
581 | &ecoff_big_vec, | |
582 | &ecoff_little_vec, | |
583 | #if 0 | |
584 | &ecoffalpha_little_vec, | |
f39b81f5 SC |
585 | #endif |
586 | &h8300coff_vec, | |
cf39664e | 587 | &h8500coff_vec, |
5f9a2245 | 588 | #if 0 |
56a2f341 JK |
589 | /* Since a.out files lack decent magic numbers, no way to recognize |
590 | which kind of a.out file it is. */ | |
cf39664e | 591 | &host_aout_vec, |
5f9a2245 | 592 | #endif |
c8e1d00b | 593 | #if 0 /* Clashes with sunos_big_vec magic no. */ |
cf39664e | 594 | &hp300bsd_vec, |
c8e1d00b | 595 | #endif |
cf39664e | 596 | &hp300hpux_vec, |
d1ad85a6 | 597 | #if defined (HOST_HPPAHPUX) || defined (HOST_HPPABSD) || defined (HOST_HPPAOSF) |
3bca0336 | 598 | &som_vec, |
cf39664e DM |
599 | #endif |
600 | &i386aout_vec, | |
601 | &i386bsd_vec, | |
602 | &i386coff_vec, | |
4f9617ca | 603 | &go32coff_vec, |
cf39664e | 604 | #if 0 |
56a2f341 JK |
605 | /* Since a.out files lack decent magic numbers, no way to recognize |
606 | which kind of a.out file it is. */ | |
cf39664e DM |
607 | &i386linux_vec, |
608 | #endif | |
3bca0336 KR |
609 | &i386lynx_aout_vec, |
610 | &i386lynx_coff_vec, | |
a3f7a777 C |
611 | #if 0 |
612 | /* No distinguishing features for Mach 3 executables. */ | |
613 | &i386mach3_vec, | |
614 | #endif | |
615 | &i386netbsd_vec, | |
2f88343d | 616 | &i386os9k_vec, |
f39b81f5 | 617 | &icoff_big_vec, |
cf39664e DM |
618 | &icoff_little_vec, |
619 | &ieee_vec, | |
620 | &m68kcoff_vec, | |
621 | &m68kcoffun_vec, | |
3bca0336 KR |
622 | &m68klynx_aout_vec, |
623 | &m68klynx_coff_vec, | |
7a1d4567 | 624 | &m68knetbsd_vec, |
cf39664e | 625 | &m88kbcs_vec, |
a3f7a777 | 626 | &m88kmach3_vec, |
cf39664e | 627 | &newsos3_vec, |
493a2593 | 628 | &nlm32_i386_vec, |
c96451db | 629 | &nlm32_sparc_vec, |
ebd24135 | 630 | #ifdef BFD64 |
3b31740c | 631 | &nlm32_alpha_vec, |
cf39664e | 632 | #endif |
c768bd3f | 633 | &pc532netbsd_vec, |
cf39664e DM |
634 | #if 0 |
635 | /* We have no oasys tools anymore, so we can't test any of this | |
636 | anymore. If you want to test the stuff yourself, go ahead... | |
637 | steve@cygnus.com | |
638 | Worse, since there is no magic number for archives, there | |
639 | can be annoying target mis-matches. */ | |
640 | &oasys_vec, | |
a3f7a777 C |
641 | #endif |
642 | &pc532machaout_vec, | |
643 | #if 0 | |
644 | /* We have no way of distinguishing this from other a.out variants */ | |
645 | &riscix_vec, | |
ebd24135 | 646 | #endif |
f39b81f5 | 647 | &rs6000coff_vec, |
cf39664e | 648 | &shcoff_vec, |
7a1d4567 | 649 | &shlcoff_vec, |
03c4ce2f MT |
650 | /* start-sanitize-rce */ |
651 | &rce_aout_vec, | |
652 | /* end-sanitize-rce */ | |
c188b0be DM |
653 | &sparclynx_aout_vec, |
654 | &sparclynx_coff_vec, | |
a3f7a777 | 655 | &sparcnetbsd_vec, |
cf39664e | 656 | &sunos_big_vec, |
7ce8b9d1 | 657 | &aout0_big_vec, |
cf39664e | 658 | &tekhex_vec, |
6697a1a9 | 659 | &we32kcoff_vec, |
cf39664e | 660 | &z8kcoff_vec, |
f39b81f5 | 661 | |
5f9a2245 DM |
662 | #endif /* not SELECT_VECS */ |
663 | ||
180acef5 DM |
664 | /* Always support S-records, for convenience. */ |
665 | &srec_vec, | |
666 | &symbolsrec_vec, | |
667 | ||
c768bd3f ILT |
668 | /* Likewise for binary output. */ |
669 | &binary_vec, | |
670 | ||
5f9a2245 DM |
671 | /* Add any required traditional-core-file-handler. */ |
672 | ||
60ac749c | 673 | #ifdef AIX386_CORE |
2c4f2c72 | 674 | &aix386_core_vec, |
f39b81f5 | 675 | #endif |
a643e626 ILT |
676 | #ifdef HPUX_CORE |
677 | &hpux_core_vec, | |
678 | #endif | |
c96451db SEF |
679 | #ifdef HPPABSD_CORE |
680 | &hppabsd_core_vec, | |
681 | #endif | |
dabfe2f6 ILT |
682 | #ifdef IRIX_CORE |
683 | &irix_core_vec, | |
684 | #endif | |
3bca0336 KR |
685 | #ifdef OSF_CORE |
686 | &osf_core_vec, | |
687 | #endif | |
cf39664e DM |
688 | #ifdef TRAD_CORE |
689 | &trad_core_vec, | |
690 | #endif | |
2ebd0976 | 691 | |
dabfe2f6 ILT |
692 | #ifdef PTRACE_CORE |
693 | &ptrace_core_vec, | |
694 | #endif | |
695 | ||
5f9a2245 | 696 | NULL /* end of list marker */ |
7d774e01 | 697 | }; |
c0e5039e | 698 | |
d1ad85a6 | 699 | /* bfd_default_vector[0] contains either the address of the default vector, |
c0e5039e JG |
700 | if there is one, or zero if there isn't. */ |
701 | ||
a3f7a777 | 702 | const bfd_target * const bfd_default_vector[] = { |
c0e5039e | 703 | #ifdef DEFAULT_VECTOR |
616ebcfd | 704 | &DEFAULT_VECTOR, |
378dac8c | 705 | #endif |
5f9a2245 | 706 | NULL |
c0e5039e | 707 | }; |
6f715d66 | 708 | |
d1ad85a6 DM |
709 | /* When there is an ambiguous match, bfd_check_format_matches puts the |
710 | names of the matching targets in an array. This variable is the maximum | |
711 | number of entries that the array could possibly need. */ | |
a3f7a777 | 712 | const size_t _bfd_target_vector_entries = sizeof(bfd_target_vector)/sizeof(*bfd_target_vector); |
6f715d66 | 713 | |
0cda46cf SC |
714 | /* |
715 | FUNCTION | |
716 | bfd_find_target | |
717 | ||
c188b0be | 718 | SYNOPSIS |
a3f7a777 | 719 | const bfd_target *bfd_find_target(CONST char *target_name, bfd *abfd); |
c188b0be | 720 | |
0cda46cf | 721 | DESCRIPTION |
c188b0be | 722 | Return a pointer to the transfer vector for the object target |
c96451db SEF |
723 | named @var{target_name}. If @var{target_name} is <<NULL>>, choose the |
724 | one in the environment variable <<GNUTARGET>>; if that is null or not | |
c188b0be | 725 | defined, then choose the first entry in the target list. |
0cda46cf SC |
726 | Passing in the string "default" or setting the environment |
727 | variable to "default" will cause the first entry in the target | |
728 | list to be returned, and "target_defaulted" will be set in the | |
729 | BFD. This causes <<bfd_check_format>> to loop over all the | |
730 | targets to find the one that matches the file being read. | |
0cda46cf | 731 | */ |
6f715d66 | 732 | |
a3f7a777 | 733 | const bfd_target * |
57a1867e DM |
734 | bfd_find_target (target_name, abfd) |
735 | CONST char *target_name; | |
736 | bfd *abfd; | |
6f715d66 | 737 | { |
a3f7a777 | 738 | const bfd_target * const *target; |
6f715d66 | 739 | extern char *getenv (); |
f8adc62d JG |
740 | CONST char *targname = (target_name ? target_name : |
741 | (CONST char *) getenv ("GNUTARGET")); | |
6f715d66 SC |
742 | |
743 | /* This is safe; the vector cannot be null */ | |
744 | if (targname == NULL || !strcmp (targname, "default")) { | |
745 | abfd->target_defaulted = true; | |
d1ad85a6 | 746 | return abfd->xvec = bfd_target_vector[0]; |
6f715d66 SC |
747 | } |
748 | ||
749 | abfd->target_defaulted = false; | |
750 | ||
d1ad85a6 | 751 | for (target = &bfd_target_vector[0]; *target != NULL; target++) { |
6f715d66 SC |
752 | if (!strcmp (targname, (*target)->name)) |
753 | return abfd->xvec = *target; | |
754 | } | |
755 | ||
d1ad85a6 | 756 | bfd_set_error (bfd_error_invalid_target); |
6f715d66 SC |
757 | return NULL; |
758 | } | |
759 | ||
760 | ||
0cda46cf SC |
761 | /* |
762 | FUNCTION | |
763 | bfd_target_list | |
764 | ||
0cda46cf | 765 | SYNOPSIS |
a3f7a777 | 766 | const char **bfd_target_list(void); |
0cda46cf | 767 | |
c188b0be DM |
768 | DESCRIPTION |
769 | Return a freshly malloced NULL-terminated | |
770 | vector of the names of all the valid BFD targets. Do not | |
771 | modify the names. | |
772 | ||
0cda46cf | 773 | */ |
6f715d66 | 774 | |
a3f7a777 | 775 | const char ** |
57a1867e | 776 | bfd_target_list () |
6f715d66 SC |
777 | { |
778 | int vec_length= 0; | |
990e7c22 JG |
779 | #ifdef NATIVE_HPPAHPUX_COMPILER |
780 | /* The native compiler on the HP9000/700 has a bug which causes it | |
781 | to loop endlessly when compiling this file. This avoids it. */ | |
782 | volatile | |
783 | #endif | |
a3f7a777 | 784 | const bfd_target * const *target; |
4e6f9223 | 785 | CONST char **name_list, **name_ptr; |
6f715d66 | 786 | |
d1ad85a6 | 787 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
788 | vec_length++; |
789 | ||
d1ad85a6 DM |
790 | name_ptr = name_list = (CONST char **) |
791 | bfd_zmalloc ((vec_length + 1) * sizeof (char **)); | |
6f715d66 SC |
792 | |
793 | if (name_list == NULL) { | |
d1ad85a6 | 794 | bfd_set_error (bfd_error_no_memory); |
6f715d66 SC |
795 | return NULL; |
796 | } | |
797 | ||
d1ad85a6 | 798 | for (target = &bfd_target_vector[0]; *target != NULL; target++) |
6f715d66 SC |
799 | *(name_ptr++) = (*target)->name; |
800 | ||
801 | return name_list; | |
802 | } |