update dependencies
[deliverable/binutils-gdb.git] / bfd / targets.c
CommitLineData
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 5This file is part of BFD, the Binary File Descriptor library.
4a81b561 6
4e6f9223 7This program is free software; you can redistribute it and/or modify
4a81b561 8it under the terms of the GNU General Public License as published by
4e6f9223
SC
9the Free Software Foundation; either version 2 of the License, or
10(at your option) any later version.
4a81b561 11
4e6f9223 12This program is distributed in the hope that it will be useful,
4a81b561
DHW
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
4e6f9223
SC
18along with this program; if not, write to the Free Software
19Foundation, 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/*
26SECTION
27 Targets
28
e98e6ec1 29DESCRIPTION
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
79INODE
80 bfd_target, , Targets, Targets
6697a1a9 81DOCDD
0cda46cf
SC
82SUBSECTION
83 bfd_target
84
e98e6ec1 85DESCRIPTION
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 157Identifies the kind of target, e.g., SunOS4, Ultrix, etc.
6f715d66 158
0cda46cf 159. char *name;
6f715d66
SC
160
161The "flavour" of a back end is a general indication about the contents
162of a file.
163
c188b0be 164. enum bfd_flavour flavour;
6f715d66
SC
165
166The order of bytes within the data area of a file.
167
0cda46cf 168. boolean byteorder_big_p;
6f715d66
SC
169
170The order of bytes within the header parts of a file.
171
0cda46cf 172. boolean header_byteorder_big_p;
6f715d66 173
c188b0be 174A mask of all the flags which an executable may have set -
0cda46cf 175from the set <<NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>.
6f715d66 176
0cda46cf 177. flagword object_flags;
6f715d66 178
c188b0be 179A mask of all the flags which a section may have set - from
0cda46cf 180the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>.
6f715d66 181
0cda46cf 182. flagword section_flags;
6f715d66 183
990e7c22 184The character normally found at the front of a symbol
c188b0be 185(if any), perhaps `_'.
990e7c22
JG
186
187. char symbol_leading_char;
188
c188b0be 189The pad character for file names within an archive header.
6f715d66 190
0cda46cf 191. char ar_pad_char;
6f715d66
SC
192
193The maximum number of characters in an archive header.
194
60ac749c 195. unsigned short ar_max_namelen;
6f715d66
SC
196
197The minimum alignment restriction for any section.
198
0cda46cf 199. unsigned int align_power_min;
6f715d66 200
c188b0be
DM
201Entries for byte swapping for data. These are different from the other
202entry points, since they don't take a BFD asthe first argument.
203Certain 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
215Byte 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
227Format dependent routines: these are vectors of entry points
228within the target vector structure, one for each format to check.
6f715d66 229
c188b0be 230Check 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
234Set the format of a file being written.
235
60ac749c 236. boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
6f715d66 237
c188b0be 238Write 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 242The 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
413Data for use by back-end routines, which isn't generic enough to belong
414in 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
425extern const bfd_target a29kcoff_big_vec;
426extern const bfd_target a_out_adobe_vec;
427extern const bfd_target aout_mips_big_vec;
428extern const bfd_target aout_mips_little_vec;
429extern const bfd_target aout0_big_vec;
430extern const bfd_target apollocoff_vec;
431extern const bfd_target b_out_vec_big_host;
432extern const bfd_target b_out_vec_little_host;
d468a149
SC
433/* start-sanitize-arc */
434extern const bfd_target bfd_elf32_arc_vec;
435/* end-sanitize-arc */
a3f7a777
C
436extern const bfd_target bfd_elf32_big_generic_vec;
437extern const bfd_target bfd_elf32_bigmips_vec;
438extern const bfd_target bfd_elf32_hppa_vec;
439extern const bfd_target bfd_elf32_i386_vec;
440extern const bfd_target bfd_elf32_i860_vec;
441extern const bfd_target bfd_elf32_little_generic_vec;
442extern const bfd_target bfd_elf32_littlemips_vec;
443extern const bfd_target bfd_elf32_m68k_vec;
444extern const bfd_target bfd_elf32_m88k_vec;
445extern const bfd_target bfd_elf32_powerpc_vec;
446extern const bfd_target bfd_elf32_sparc_vec;
447extern const bfd_target bfd_elf64_big_generic_vec;
448extern const bfd_target bfd_elf64_little_generic_vec;
449extern const bfd_target bfd_elf64_sparc_vec;
450extern const bfd_target demo_64_vec;
451extern const bfd_target ecoff_big_vec;
452extern const bfd_target ecoff_little_vec;
453extern const bfd_target ecoffalpha_little_vec;
454extern const bfd_target h8300coff_vec;
455extern const bfd_target h8500coff_vec;
456extern const bfd_target host_aout_vec;
457extern const bfd_target hp300bsd_vec;
458extern const bfd_target hp300hpux_vec;
459extern const bfd_target som_vec;
460extern const bfd_target i386aout_vec;
461extern const bfd_target i386bsd_vec;
462extern const bfd_target i386dynix_vec;
463extern const bfd_target i386os9k_vec;
464extern const bfd_target i386coff_vec;
465extern const bfd_target go32coff_vec;
466extern const bfd_target i386linux_vec;
467extern const bfd_target i386lynx_aout_vec;
468extern const bfd_target i386lynx_coff_vec;
469extern const bfd_target i386mach3_vec;
470extern const bfd_target i386netbsd_vec;
471extern const bfd_target icoff_big_vec;
472extern const bfd_target icoff_little_vec;
473extern const bfd_target ieee_vec;
474extern const bfd_target m68kcoff_vec;
475extern const bfd_target m68kcoffun_vec;
476extern const bfd_target m68klynx_aout_vec;
477extern const bfd_target m68klynx_coff_vec;
7a1d4567 478extern const bfd_target m68knetbsd_vec;
a3f7a777
C
479extern const bfd_target m88kbcs_vec;
480extern const bfd_target m88kmach3_vec;
481extern const bfd_target newsos3_vec;
482extern const bfd_target nlm32_i386_vec;
483extern const bfd_target nlm32_sparc_vec;
484extern const bfd_target nlm32_alpha_vec;
485extern const bfd_target nlm32_powerpc_vec;
c768bd3f 486extern const bfd_target pc532netbsd_vec;
a3f7a777
C
487extern const bfd_target oasys_vec;
488extern const bfd_target pc532machaout_vec;
489extern const bfd_target riscix_vec;
490extern const bfd_target rs6000coff_vec;
491extern const bfd_target shcoff_vec;
03c4ce2f
MT
492/* start-sanitize-rce */
493extern bfd_target rce_aout_vec;
494/* end-sanitize-rce */
7a1d4567 495extern const bfd_target shlcoff_vec;
a3f7a777
C
496extern const bfd_target sparclynx_aout_vec;
497extern const bfd_target sparclynx_coff_vec;
498extern const bfd_target sparcnetbsd_vec;
499extern const bfd_target sparccoff_vec;
500extern const bfd_target sunos_big_vec;
501extern const bfd_target tekhex_vec;
502extern const bfd_target we32kcoff_vec;
d468a149 503extern const bfd_target w65_vec;
a3f7a777 504extern const bfd_target z8kcoff_vec;
cf39664e
DM
505
506/* srec is always included. */
a3f7a777
C
507extern const bfd_target srec_vec;
508extern const bfd_target symbolsrec_vec;
cf39664e 509
c768bd3f
ILT
510/* binary is always included. */
511extern const bfd_target binary_vec;
512
cf39664e 513/* All of the xvecs for core files. */
a3f7a777
C
514extern const bfd_target aix386_core_vec;
515extern const bfd_target cisco_core_vec;
516extern const bfd_target hpux_core_vec;
517extern const bfd_target hppabsd_core_vec;
518extern const bfd_target irix_core_vec;
519extern const bfd_target osf_core_vec;
520extern const bfd_target sco_core_vec;
521extern const bfd_target trad_core_vec;
522extern const bfd_target ptrace_core_vec;
523
524const 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 702const 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 712const size_t _bfd_target_vector_entries = sizeof(bfd_target_vector)/sizeof(*bfd_target_vector);
6f715d66 713
0cda46cf
SC
714/*
715FUNCTION
716 bfd_find_target
717
c188b0be 718SYNOPSIS
a3f7a777 719 const bfd_target *bfd_find_target(CONST char *target_name, bfd *abfd);
c188b0be 720
0cda46cf 721DESCRIPTION
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 733const bfd_target *
57a1867e
DM
734bfd_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/*
762FUNCTION
763 bfd_target_list
764
0cda46cf 765SYNOPSIS
a3f7a777 766 const char **bfd_target_list(void);
0cda46cf 767
c188b0be
DM
768DESCRIPTION
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 775const char **
57a1867e 776bfd_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}
This page took 0.191934 seconds and 4 git commands to generate.