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