mirror of
https://review.haiku-os.org/buildtools
synced 2024-11-23 07:18:49 +01:00
1868 lines
55 KiB
C
1868 lines
55 KiB
C
/* Generic target-file-type support for the BFD library.
|
||
Copyright (C) 1990-2023 Free Software Foundation, Inc.
|
||
Written by Cygnus Support.
|
||
|
||
This file is part of BFD, the Binary File Descriptor library.
|
||
|
||
This program is free software; you can redistribute it and/or modify
|
||
it under the terms of the GNU General Public License as published by
|
||
the Free Software Foundation; either version 3 of the License, or
|
||
(at your option) any later version.
|
||
|
||
This program is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
GNU General Public License for more details.
|
||
|
||
You should have received a copy of the GNU General Public License
|
||
along with this program; if not, write to the Free Software
|
||
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
|
||
MA 02110-1301, USA. */
|
||
|
||
#include "sysdep.h"
|
||
#include "libiberty.h"
|
||
#include "bfd.h"
|
||
#include "libbfd.h"
|
||
#include "fnmatch.h"
|
||
|
||
/*
|
||
It's okay to see some:
|
||
#if 0
|
||
directives in this source file, as targets.c uses them to exclude
|
||
certain BFD vectors. This comment is specially formatted to catch
|
||
users who grep for ^#if 0, so please keep it this way!
|
||
*/
|
||
|
||
/*
|
||
SECTION
|
||
Targets
|
||
|
||
DESCRIPTION
|
||
Each port of BFD to a different machine requires the creation
|
||
of a target back end. All the back end provides to the root
|
||
part of BFD is a structure containing pointers to functions
|
||
which perform certain low level operations on files. BFD
|
||
translates the applications's requests through a pointer into
|
||
calls to the back end routines.
|
||
|
||
When a file is opened with <<bfd_openr>>, its format and
|
||
target are unknown. BFD uses various mechanisms to determine
|
||
how to interpret the file. The operations performed are:
|
||
|
||
o Create a BFD by calling the internal routine
|
||
<<_bfd_new_bfd>>, then call <<bfd_find_target>> with the
|
||
target string supplied to <<bfd_openr>> and the new BFD pointer.
|
||
|
||
o If a null target string was provided to <<bfd_find_target>>,
|
||
look up the environment variable <<GNUTARGET>> and use
|
||
that as the target string.
|
||
|
||
o If the target string is still <<NULL>>, or the target string is
|
||
<<default>>, then use the first item in the target vector
|
||
as the target type, and set <<target_defaulted>> in the BFD to
|
||
cause <<bfd_check_format>> to loop through all the targets.
|
||
@xref{bfd_target}. @xref{Formats}.
|
||
|
||
o Otherwise, inspect the elements in the target vector
|
||
one by one, until a match on target name is found. When found,
|
||
use it.
|
||
|
||
o Otherwise return the error <<bfd_error_invalid_target>> to
|
||
<<bfd_openr>>.
|
||
|
||
o <<bfd_openr>> attempts to open the file using
|
||
<<bfd_open_file>>, and returns the BFD.
|
||
|
||
Once the BFD has been opened and the target selected, the file
|
||
format may be determined. This is done by calling
|
||
<<bfd_check_format>> on the BFD with a suggested format.
|
||
If <<target_defaulted>> has been set, each possible target
|
||
type is tried to see if it recognizes the specified format.
|
||
<<bfd_check_format>> returns <<TRUE>> when the caller guesses right.
|
||
@menu
|
||
@* bfd_target::
|
||
@end menu
|
||
*/
|
||
|
||
/*
|
||
|
||
INODE
|
||
bfd_target, , Targets, Targets
|
||
DOCDD
|
||
SUBSECTION
|
||
bfd_target
|
||
|
||
DESCRIPTION
|
||
This structure contains everything that BFD knows about a
|
||
target. It includes things like its byte order, name, and which
|
||
routines to call to do various operations.
|
||
|
||
Every BFD points to a target structure with its <<xvec>>
|
||
member.
|
||
|
||
The macros below are used to dispatch to functions through the
|
||
<<bfd_target>> vector. They are used in a number of macros further
|
||
down in @file{bfd.h}, and are also used when calling various
|
||
routines by hand inside the BFD implementation. The @var{arglist}
|
||
argument must be parenthesized; it contains all the arguments
|
||
to the called function.
|
||
|
||
They make the documentation (more) unpleasant to read, so if
|
||
someone wants to fix this and not break the above, please do.
|
||
|
||
.#define BFD_SEND(bfd, message, arglist) \
|
||
. ((*((bfd)->xvec->message)) arglist)
|
||
.
|
||
.#ifdef DEBUG_BFD_SEND
|
||
.#undef BFD_SEND
|
||
.#define BFD_SEND(bfd, message, arglist) \
|
||
. (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
|
||
. ((*((bfd)->xvec->message)) arglist) : \
|
||
. (bfd_assert (__FILE__,__LINE__), NULL))
|
||
.#endif
|
||
|
||
For operations which index on the BFD format:
|
||
|
||
.#define BFD_SEND_FMT(bfd, message, arglist) \
|
||
. (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
|
||
.
|
||
.#ifdef DEBUG_BFD_SEND
|
||
.#undef BFD_SEND_FMT
|
||
.#define BFD_SEND_FMT(bfd, message, arglist) \
|
||
. (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
|
||
. (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
|
||
. (bfd_assert (__FILE__,__LINE__), NULL))
|
||
.#endif
|
||
.
|
||
.{* Defined to TRUE if unused section symbol should be kept. *}
|
||
.#ifndef TARGET_KEEP_UNUSED_SECTION_SYMBOLS
|
||
.#define TARGET_KEEP_UNUSED_SECTION_SYMBOLS true
|
||
.#endif
|
||
.
|
||
This is the structure which defines the type of BFD this is. The
|
||
<<xvec>> member of the struct <<bfd>> itself points here. Each
|
||
module that implements access to a different target under BFD,
|
||
defines one of these.
|
||
|
||
FIXME, these names should be rationalised with the names of
|
||
the entry points which call them. Too bad we can't have one
|
||
macro to define them both!
|
||
|
||
EXTERNAL
|
||
.enum bfd_flavour
|
||
.{
|
||
. {* N.B. Update bfd_flavour_name if you change this. *}
|
||
. bfd_target_unknown_flavour,
|
||
. bfd_target_aout_flavour,
|
||
. bfd_target_coff_flavour,
|
||
. bfd_target_ecoff_flavour,
|
||
. bfd_target_xcoff_flavour,
|
||
. bfd_target_elf_flavour,
|
||
. bfd_target_tekhex_flavour,
|
||
. bfd_target_srec_flavour,
|
||
. bfd_target_verilog_flavour,
|
||
. bfd_target_ihex_flavour,
|
||
. bfd_target_som_flavour,
|
||
. bfd_target_msdos_flavour,
|
||
. bfd_target_evax_flavour,
|
||
. bfd_target_mmo_flavour,
|
||
. bfd_target_mach_o_flavour,
|
||
. bfd_target_pef_flavour,
|
||
. bfd_target_pef_xlib_flavour,
|
||
. bfd_target_sym_flavour
|
||
.};
|
||
.
|
||
.enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
|
||
.
|
||
.{* Forward declarations. *}
|
||
.struct flag_info;
|
||
.typedef void (*bfd_cleanup) (bfd *);
|
||
.
|
||
|
||
CODE_FRAGMENT
|
||
.typedef struct bfd_target
|
||
.{
|
||
. {* Identifies the kind of target, e.g., SunOS4, Ultrix, etc. *}
|
||
. const char *name;
|
||
.
|
||
. {* The "flavour" of a back end is a general indication about
|
||
. the contents of a file. *}
|
||
. enum bfd_flavour flavour;
|
||
.
|
||
. {* The order of bytes within the data area of a file. *}
|
||
. enum bfd_endian byteorder;
|
||
.
|
||
. {* The order of bytes within the header parts of a file. *}
|
||
. enum bfd_endian header_byteorder;
|
||
.
|
||
. {* A mask of all the flags which an executable may have set -
|
||
. from the set <<BFD_NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>. *}
|
||
. flagword object_flags;
|
||
.
|
||
. {* A mask of all the flags which a section may have set - from
|
||
. the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>. *}
|
||
. flagword section_flags;
|
||
.
|
||
. {* The character normally found at the front of a symbol.
|
||
. (if any), perhaps `_'. *}
|
||
. char symbol_leading_char;
|
||
.
|
||
. {* The pad character for file names within an archive header. *}
|
||
. char ar_pad_char;
|
||
.
|
||
. {* The maximum number of characters in an archive header. *}
|
||
. unsigned char ar_max_namelen;
|
||
.
|
||
. {* How well this target matches, used to select between various
|
||
. possible targets when more than one target matches. *}
|
||
. unsigned char match_priority;
|
||
.
|
||
. {* TRUE if unused section symbols should be kept. *}
|
||
. bool keep_unused_section_symbols;
|
||
.
|
||
. {* Entries for byte swapping for data. These are different from the
|
||
. other entry points, since they don't take a BFD as the first argument.
|
||
. Certain other handlers could do the same. *}
|
||
. uint64_t (*bfd_getx64) (const void *);
|
||
. int64_t (*bfd_getx_signed_64) (const void *);
|
||
. void (*bfd_putx64) (uint64_t, void *);
|
||
. bfd_vma (*bfd_getx32) (const void *);
|
||
. bfd_signed_vma (*bfd_getx_signed_32) (const void *);
|
||
. void (*bfd_putx32) (bfd_vma, void *);
|
||
. bfd_vma (*bfd_getx16) (const void *);
|
||
. bfd_signed_vma (*bfd_getx_signed_16) (const void *);
|
||
. void (*bfd_putx16) (bfd_vma, void *);
|
||
.
|
||
. {* Byte swapping for the headers. *}
|
||
. uint64_t (*bfd_h_getx64) (const void *);
|
||
. int64_t (*bfd_h_getx_signed_64) (const void *);
|
||
. void (*bfd_h_putx64) (uint64_t, void *);
|
||
. bfd_vma (*bfd_h_getx32) (const void *);
|
||
. bfd_signed_vma (*bfd_h_getx_signed_32) (const void *);
|
||
. void (*bfd_h_putx32) (bfd_vma, void *);
|
||
. bfd_vma (*bfd_h_getx16) (const void *);
|
||
. bfd_signed_vma (*bfd_h_getx_signed_16) (const void *);
|
||
. void (*bfd_h_putx16) (bfd_vma, void *);
|
||
.
|
||
. {* Format dependent routines: these are vectors of entry points
|
||
. within the target vector structure, one for each format to check. *}
|
||
.
|
||
. {* Check the format of a file being read. Return a <<bfd_cleanup>> on
|
||
. success or zero on failure. *}
|
||
. bfd_cleanup (*_bfd_check_format[bfd_type_end]) (bfd *);
|
||
.
|
||
. {* Set the format of a file being written. *}
|
||
. bool (*_bfd_set_format[bfd_type_end]) (bfd *);
|
||
.
|
||
. {* Write cached information into a file being written, at <<bfd_close>>. *}
|
||
. bool (*_bfd_write_contents[bfd_type_end]) (bfd *);
|
||
.
|
||
|
||
The general target vector. These vectors are initialized using the
|
||
BFD_JUMP_TABLE macros.
|
||
|
||
. {* Generic entry points. *}
|
||
.#define BFD_JUMP_TABLE_GENERIC(NAME) \
|
||
. NAME##_close_and_cleanup, \
|
||
. NAME##_bfd_free_cached_info, \
|
||
. NAME##_new_section_hook, \
|
||
. NAME##_get_section_contents, \
|
||
. NAME##_get_section_contents_in_window
|
||
.
|
||
. {* Called when the BFD is being closed to do any necessary cleanup. *}
|
||
. bool (*_close_and_cleanup) (bfd *);
|
||
. {* Ask the BFD to free all cached information. *}
|
||
. bool (*_bfd_free_cached_info) (bfd *);
|
||
. {* Called when a new section is created. *}
|
||
. bool (*_new_section_hook) (bfd *, sec_ptr);
|
||
. {* Read the contents of a section. *}
|
||
. bool (*_bfd_get_section_contents) (bfd *, sec_ptr, void *, file_ptr,
|
||
. bfd_size_type);
|
||
. bool (*_bfd_get_section_contents_in_window) (bfd *, sec_ptr, bfd_window *,
|
||
. file_ptr, bfd_size_type);
|
||
.
|
||
. {* Entry points to copy private data. *}
|
||
.#define BFD_JUMP_TABLE_COPY(NAME) \
|
||
. NAME##_bfd_copy_private_bfd_data, \
|
||
. NAME##_bfd_merge_private_bfd_data, \
|
||
. _bfd_generic_init_private_section_data, \
|
||
. NAME##_bfd_copy_private_section_data, \
|
||
. NAME##_bfd_copy_private_symbol_data, \
|
||
. NAME##_bfd_copy_private_header_data, \
|
||
. NAME##_bfd_set_private_flags, \
|
||
. NAME##_bfd_print_private_bfd_data
|
||
.
|
||
. {* Called to copy BFD general private data from one object file
|
||
. to another. *}
|
||
. bool (*_bfd_copy_private_bfd_data) (bfd *, bfd *);
|
||
. {* Called to merge BFD general private data from one object file
|
||
. to a common output file when linking. *}
|
||
. bool (*_bfd_merge_private_bfd_data) (bfd *, struct bfd_link_info *);
|
||
. {* Called to initialize BFD private section data from one object file
|
||
. to another. *}
|
||
.#define bfd_init_private_section_data(ibfd, isec, obfd, osec, link_info) \
|
||
. BFD_SEND (obfd, _bfd_init_private_section_data, \
|
||
. (ibfd, isec, obfd, osec, link_info))
|
||
. bool (*_bfd_init_private_section_data) (bfd *, sec_ptr, bfd *, sec_ptr,
|
||
. struct bfd_link_info *);
|
||
. {* Called to copy BFD private section data from one object file
|
||
. to another. *}
|
||
. bool (*_bfd_copy_private_section_data) (bfd *, sec_ptr, bfd *, sec_ptr);
|
||
. {* Called to copy BFD private symbol data from one symbol
|
||
. to another. *}
|
||
. bool (*_bfd_copy_private_symbol_data) (bfd *, asymbol *,
|
||
. bfd *, asymbol *);
|
||
. {* Called to copy BFD private header data from one object file
|
||
. to another. *}
|
||
. bool (*_bfd_copy_private_header_data) (bfd *, bfd *);
|
||
. {* Called to set private backend flags. *}
|
||
. bool (*_bfd_set_private_flags) (bfd *, flagword);
|
||
.
|
||
. {* Called to print private BFD data. *}
|
||
. bool (*_bfd_print_private_bfd_data) (bfd *, void *);
|
||
.
|
||
. {* Core file entry points. *}
|
||
.#define BFD_JUMP_TABLE_CORE(NAME) \
|
||
. NAME##_core_file_failing_command, \
|
||
. NAME##_core_file_failing_signal, \
|
||
. NAME##_core_file_matches_executable_p, \
|
||
. NAME##_core_file_pid
|
||
.
|
||
. char *(*_core_file_failing_command) (bfd *);
|
||
. int (*_core_file_failing_signal) (bfd *);
|
||
. bool (*_core_file_matches_executable_p) (bfd *, bfd *);
|
||
. int (*_core_file_pid) (bfd *);
|
||
.
|
||
. {* Archive entry points. *}
|
||
.#define BFD_JUMP_TABLE_ARCHIVE(NAME) \
|
||
. NAME##_slurp_armap, \
|
||
. NAME##_slurp_extended_name_table, \
|
||
. NAME##_construct_extended_name_table, \
|
||
. NAME##_truncate_arname, \
|
||
. NAME##_write_armap, \
|
||
. NAME##_read_ar_hdr, \
|
||
. NAME##_write_ar_hdr, \
|
||
. NAME##_openr_next_archived_file, \
|
||
. NAME##_get_elt_at_index, \
|
||
. NAME##_generic_stat_arch_elt, \
|
||
. NAME##_update_armap_timestamp
|
||
.
|
||
. bool (*_bfd_slurp_armap) (bfd *);
|
||
. bool (*_bfd_slurp_extended_name_table) (bfd *);
|
||
. bool (*_bfd_construct_extended_name_table) (bfd *, char **,
|
||
. bfd_size_type *,
|
||
. const char **);
|
||
. void (*_bfd_truncate_arname) (bfd *, const char *, char *);
|
||
. bool (*write_armap) (bfd *, unsigned, struct orl *, unsigned, int);
|
||
. void *(*_bfd_read_ar_hdr_fn) (bfd *);
|
||
. bool (*_bfd_write_ar_hdr_fn) (bfd *, bfd *);
|
||
. bfd *(*openr_next_archived_file) (bfd *, bfd *);
|
||
.#define bfd_get_elt_at_index(b,i) \
|
||
. BFD_SEND (b, _bfd_get_elt_at_index, (b,i))
|
||
. bfd *(*_bfd_get_elt_at_index) (bfd *, symindex);
|
||
. int (*_bfd_stat_arch_elt) (bfd *, struct stat *);
|
||
. bool (*_bfd_update_armap_timestamp) (bfd *);
|
||
.
|
||
. {* Entry points used for symbols. *}
|
||
.#define BFD_JUMP_TABLE_SYMBOLS(NAME) \
|
||
. NAME##_get_symtab_upper_bound, \
|
||
. NAME##_canonicalize_symtab, \
|
||
. NAME##_make_empty_symbol, \
|
||
. NAME##_print_symbol, \
|
||
. NAME##_get_symbol_info, \
|
||
. NAME##_get_symbol_version_string, \
|
||
. NAME##_bfd_is_local_label_name, \
|
||
. NAME##_bfd_is_target_special_symbol, \
|
||
. NAME##_get_lineno, \
|
||
. NAME##_find_nearest_line, \
|
||
. NAME##_find_nearest_line_with_alt, \
|
||
. NAME##_find_line, \
|
||
. NAME##_find_inliner_info, \
|
||
. NAME##_bfd_make_debug_symbol, \
|
||
. NAME##_read_minisymbols, \
|
||
. NAME##_minisymbol_to_symbol
|
||
.
|
||
. long (*_bfd_get_symtab_upper_bound) (bfd *);
|
||
. long (*_bfd_canonicalize_symtab) (bfd *, struct bfd_symbol **);
|
||
. struct bfd_symbol *
|
||
. (*_bfd_make_empty_symbol) (bfd *);
|
||
. void (*_bfd_print_symbol) (bfd *, void *, struct bfd_symbol *,
|
||
. bfd_print_symbol_type);
|
||
.#define bfd_print_symbol(b,p,s,e) \
|
||
. BFD_SEND (b, _bfd_print_symbol, (b,p,s,e))
|
||
. void (*_bfd_get_symbol_info) (bfd *, struct bfd_symbol *, symbol_info *);
|
||
.#define bfd_get_symbol_info(b,p,e) \
|
||
. BFD_SEND (b, _bfd_get_symbol_info, (b,p,e))
|
||
. const char *
|
||
. (*_bfd_get_symbol_version_string) (bfd *, struct bfd_symbol *,
|
||
. bool, bool *);
|
||
.#define bfd_get_symbol_version_string(b,s,p,h) \
|
||
. BFD_SEND (b, _bfd_get_symbol_version_string, (b,s,p,h))
|
||
. bool (*_bfd_is_local_label_name) (bfd *, const char *);
|
||
. bool (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
|
||
. alent *
|
||
. (*_get_lineno) (bfd *, struct bfd_symbol *);
|
||
. bool (*_bfd_find_nearest_line) (bfd *, struct bfd_symbol **,
|
||
. struct bfd_section *, bfd_vma,
|
||
. const char **, const char **,
|
||
. unsigned int *, unsigned int *);
|
||
. bool (*_bfd_find_nearest_line_with_alt) (bfd *, const char *,
|
||
. struct bfd_symbol **,
|
||
. struct bfd_section *, bfd_vma,
|
||
. const char **, const char **,
|
||
. unsigned int *, unsigned int *);
|
||
. bool (*_bfd_find_line) (bfd *, struct bfd_symbol **,
|
||
. struct bfd_symbol *, const char **,
|
||
. unsigned int *);
|
||
. bool (*_bfd_find_inliner_info)
|
||
. (bfd *, const char **, const char **, unsigned int *);
|
||
. {* Back-door to allow format-aware applications to create debug symbols
|
||
. while using BFD for everything else. Currently used by the assembler
|
||
. when creating COFF files. *}
|
||
. asymbol *
|
||
. (*_bfd_make_debug_symbol) (bfd *);
|
||
.#define bfd_read_minisymbols(b, d, m, s) \
|
||
. BFD_SEND (b, _read_minisymbols, (b, d, m, s))
|
||
. long (*_read_minisymbols) (bfd *, bool, void **, unsigned int *);
|
||
.#define bfd_minisymbol_to_symbol(b, d, m, f) \
|
||
. BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
|
||
. asymbol *
|
||
. (*_minisymbol_to_symbol) (bfd *, bool, const void *, asymbol *);
|
||
.
|
||
. {* Routines for relocs. *}
|
||
.#define BFD_JUMP_TABLE_RELOCS(NAME) \
|
||
. NAME##_get_reloc_upper_bound, \
|
||
. NAME##_canonicalize_reloc, \
|
||
. NAME##_set_reloc, \
|
||
. NAME##_bfd_reloc_type_lookup, \
|
||
. NAME##_bfd_reloc_name_lookup
|
||
.
|
||
. long (*_get_reloc_upper_bound) (bfd *, sec_ptr);
|
||
. long (*_bfd_canonicalize_reloc) (bfd *, sec_ptr, arelent **,
|
||
. struct bfd_symbol **);
|
||
. void (*_bfd_set_reloc) (bfd *, sec_ptr, arelent **, unsigned int);
|
||
. {* See documentation on reloc types. *}
|
||
. reloc_howto_type *
|
||
. (*reloc_type_lookup) (bfd *, bfd_reloc_code_real_type);
|
||
. reloc_howto_type *
|
||
. (*reloc_name_lookup) (bfd *, const char *);
|
||
.
|
||
. {* Routines used when writing an object file. *}
|
||
.#define BFD_JUMP_TABLE_WRITE(NAME) \
|
||
. NAME##_set_arch_mach, \
|
||
. NAME##_set_section_contents
|
||
.
|
||
. bool (*_bfd_set_arch_mach) (bfd *, enum bfd_architecture,
|
||
. unsigned long);
|
||
. bool (*_bfd_set_section_contents) (bfd *, sec_ptr, const void *,
|
||
. file_ptr, bfd_size_type);
|
||
.
|
||
. {* Routines used by the linker. *}
|
||
.#define BFD_JUMP_TABLE_LINK(NAME) \
|
||
. NAME##_sizeof_headers, \
|
||
. NAME##_bfd_get_relocated_section_contents, \
|
||
. NAME##_bfd_relax_section, \
|
||
. NAME##_bfd_link_hash_table_create, \
|
||
. NAME##_bfd_link_add_symbols, \
|
||
. NAME##_bfd_link_just_syms, \
|
||
. NAME##_bfd_copy_link_hash_symbol_type, \
|
||
. NAME##_bfd_final_link, \
|
||
. NAME##_bfd_link_split_section, \
|
||
. NAME##_bfd_link_check_relocs, \
|
||
. NAME##_bfd_gc_sections, \
|
||
. NAME##_bfd_lookup_section_flags, \
|
||
. NAME##_bfd_merge_sections, \
|
||
. NAME##_bfd_is_group_section, \
|
||
. NAME##_bfd_group_name, \
|
||
. NAME##_bfd_discard_group, \
|
||
. NAME##_section_already_linked, \
|
||
. NAME##_bfd_define_common_symbol, \
|
||
. NAME##_bfd_link_hide_symbol, \
|
||
. NAME##_bfd_define_start_stop
|
||
.
|
||
. int (*_bfd_sizeof_headers) (bfd *, struct bfd_link_info *);
|
||
. bfd_byte *
|
||
. (*_bfd_get_relocated_section_contents) (bfd *,
|
||
. struct bfd_link_info *,
|
||
. struct bfd_link_order *,
|
||
. bfd_byte *, bool,
|
||
. struct bfd_symbol **);
|
||
.
|
||
. bool (*_bfd_relax_section) (bfd *, struct bfd_section *,
|
||
. struct bfd_link_info *, bool *);
|
||
.
|
||
. {* Create a hash table for the linker. Different backends store
|
||
. different information in this table. *}
|
||
. struct bfd_link_hash_table *
|
||
. (*_bfd_link_hash_table_create) (bfd *);
|
||
.
|
||
. {* Add symbols from this object file into the hash table. *}
|
||
. bool (*_bfd_link_add_symbols) (bfd *, struct bfd_link_info *);
|
||
.
|
||
. {* Indicate that we are only retrieving symbol values from this section. *}
|
||
. void (*_bfd_link_just_syms) (asection *, struct bfd_link_info *);
|
||
.
|
||
. {* Copy the symbol type and other attributes for a linker script
|
||
. assignment of one symbol to another. *}
|
||
.#define bfd_copy_link_hash_symbol_type(b, t, f) \
|
||
. BFD_SEND (b, _bfd_copy_link_hash_symbol_type, (b, t, f))
|
||
. void (*_bfd_copy_link_hash_symbol_type) (bfd *,
|
||
. struct bfd_link_hash_entry *,
|
||
. struct bfd_link_hash_entry *);
|
||
.
|
||
. {* Do a link based on the link_order structures attached to each
|
||
. section of the BFD. *}
|
||
. bool (*_bfd_final_link) (bfd *, struct bfd_link_info *);
|
||
.
|
||
. {* Should this section be split up into smaller pieces during linking. *}
|
||
. bool (*_bfd_link_split_section) (bfd *, struct bfd_section *);
|
||
.
|
||
. {* Check the relocations in the bfd for validity. *}
|
||
. bool (* _bfd_link_check_relocs)(bfd *, struct bfd_link_info *);
|
||
.
|
||
. {* Remove sections that are not referenced from the output. *}
|
||
. bool (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
|
||
.
|
||
. {* Sets the bitmask of allowed and disallowed section flags. *}
|
||
. bool (*_bfd_lookup_section_flags) (struct bfd_link_info *,
|
||
. struct flag_info *, asection *);
|
||
.
|
||
. {* Attempt to merge SEC_MERGE sections. *}
|
||
. bool (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
|
||
.
|
||
. {* Is this section a member of a group? *}
|
||
. bool (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
|
||
.
|
||
. {* The group name, if section is a member of a group. *}
|
||
. const char *(*_bfd_group_name) (bfd *, const struct bfd_section *);
|
||
.
|
||
. {* Discard members of a group. *}
|
||
. bool (*_bfd_discard_group) (bfd *, struct bfd_section *);
|
||
.
|
||
. {* Check if SEC has been already linked during a reloceatable or
|
||
. final link. *}
|
||
. bool (*_section_already_linked) (bfd *, asection *,
|
||
. struct bfd_link_info *);
|
||
.
|
||
. {* Define a common symbol. *}
|
||
. bool (*_bfd_define_common_symbol) (bfd *, struct bfd_link_info *,
|
||
. struct bfd_link_hash_entry *);
|
||
.
|
||
. {* Hide a symbol. *}
|
||
. void (*_bfd_link_hide_symbol) (bfd *, struct bfd_link_info *,
|
||
. struct bfd_link_hash_entry *);
|
||
.
|
||
. {* Define a __start, __stop, .startof. or .sizeof. symbol. *}
|
||
. struct bfd_link_hash_entry *
|
||
. (*_bfd_define_start_stop) (struct bfd_link_info *, const char *,
|
||
. asection *);
|
||
.
|
||
. {* Routines to handle dynamic symbols and relocs. *}
|
||
.#define BFD_JUMP_TABLE_DYNAMIC(NAME) \
|
||
. NAME##_get_dynamic_symtab_upper_bound, \
|
||
. NAME##_canonicalize_dynamic_symtab, \
|
||
. NAME##_get_synthetic_symtab, \
|
||
. NAME##_get_dynamic_reloc_upper_bound, \
|
||
. NAME##_canonicalize_dynamic_reloc
|
||
.
|
||
. {* Get the amount of memory required to hold the dynamic symbols. *}
|
||
. long (*_bfd_get_dynamic_symtab_upper_bound) (bfd *);
|
||
. {* Read in the dynamic symbols. *}
|
||
. long (*_bfd_canonicalize_dynamic_symtab) (bfd *, struct bfd_symbol **);
|
||
. {* Create synthetized symbols. *}
|
||
. long (*_bfd_get_synthetic_symtab) (bfd *, long, struct bfd_symbol **,
|
||
. long, struct bfd_symbol **,
|
||
. struct bfd_symbol **);
|
||
. {* Get the amount of memory required to hold the dynamic relocs. *}
|
||
. long (*_bfd_get_dynamic_reloc_upper_bound) (bfd *);
|
||
. {* Read in the dynamic relocs. *}
|
||
. long (*_bfd_canonicalize_dynamic_reloc) (bfd *, arelent **,
|
||
. struct bfd_symbol **);
|
||
.
|
||
|
||
A pointer to an alternative bfd_target in case the current one is not
|
||
satisfactory. This can happen when the target cpu supports both big
|
||
and little endian code, and target chosen by the linker has the wrong
|
||
endianness. The function open_output() in ld/ldlang.c uses this field
|
||
to find an alternative output format that is suitable.
|
||
|
||
. {* Opposite endian version of this target. *}
|
||
. const struct bfd_target *alternative_target;
|
||
.
|
||
|
||
. {* Data for use by back-end routines, which isn't
|
||
. generic enough to belong in this structure. *}
|
||
. const void *backend_data;
|
||
.
|
||
.} bfd_target;
|
||
.
|
||
.static inline const char *
|
||
.bfd_get_target (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->name;
|
||
.}
|
||
.
|
||
.static inline enum bfd_flavour
|
||
.bfd_get_flavour (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->flavour;
|
||
.}
|
||
.
|
||
.static inline flagword
|
||
.bfd_applicable_file_flags (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->object_flags;
|
||
.}
|
||
.
|
||
.static inline bool
|
||
.bfd_family_coff (const bfd *abfd)
|
||
.{
|
||
. return (bfd_get_flavour (abfd) == bfd_target_coff_flavour
|
||
. || bfd_get_flavour (abfd) == bfd_target_xcoff_flavour);
|
||
.}
|
||
.
|
||
.static inline bool
|
||
.bfd_big_endian (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->byteorder == BFD_ENDIAN_BIG;
|
||
.}
|
||
.static inline bool
|
||
.bfd_little_endian (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->byteorder == BFD_ENDIAN_LITTLE;
|
||
.}
|
||
.
|
||
.static inline bool
|
||
.bfd_header_big_endian (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->header_byteorder == BFD_ENDIAN_BIG;
|
||
.}
|
||
.
|
||
.static inline bool
|
||
.bfd_header_little_endian (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->header_byteorder == BFD_ENDIAN_LITTLE;
|
||
.}
|
||
.
|
||
.static inline flagword
|
||
.bfd_applicable_section_flags (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->section_flags;
|
||
.}
|
||
.
|
||
.static inline char
|
||
.bfd_get_symbol_leading_char (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->symbol_leading_char;
|
||
.}
|
||
.
|
||
.static inline enum bfd_flavour
|
||
.bfd_asymbol_flavour (const asymbol *sy)
|
||
.{
|
||
. if ((sy->flags & BSF_SYNTHETIC) != 0)
|
||
. return bfd_target_unknown_flavour;
|
||
. return sy->the_bfd->xvec->flavour;
|
||
.}
|
||
.
|
||
.static inline bool
|
||
.bfd_keep_unused_section_symbols (const bfd *abfd)
|
||
.{
|
||
. return abfd->xvec->keep_unused_section_symbols;
|
||
.}
|
||
.
|
||
*/
|
||
|
||
/* All known xvecs (even those that don't compile on all systems).
|
||
Alphabetized for easy reference.
|
||
They are listed a second time below, since
|
||
we can't intermix extern's and initializers. */
|
||
extern const bfd_target aarch64_elf32_be_vec;
|
||
extern const bfd_target aarch64_elf32_le_vec;
|
||
extern const bfd_target aarch64_elf64_be_vec;
|
||
extern const bfd_target aarch64_elf64_be_cloudabi_vec;
|
||
extern const bfd_target aarch64_elf64_le_vec;
|
||
extern const bfd_target aarch64_elf64_le_cloudabi_vec;
|
||
extern const bfd_target aarch64_mach_o_vec;
|
||
extern const bfd_target aarch64_pei_le_vec;
|
||
extern const bfd_target aarch64_pe_le_vec;
|
||
extern const bfd_target alpha_ecoff_le_vec;
|
||
extern const bfd_target alpha_elf64_vec;
|
||
extern const bfd_target alpha_elf64_fbsd_vec;
|
||
extern const bfd_target alpha_vms_vec;
|
||
extern const bfd_target alpha_vms_lib_txt_vec;
|
||
extern const bfd_target am33_elf32_linux_vec;
|
||
extern const bfd_target amdgcn_elf64_le_vec;
|
||
extern const bfd_target aout_vec;
|
||
extern const bfd_target arc_elf32_be_vec;
|
||
extern const bfd_target arc_elf32_le_vec;
|
||
extern const bfd_target arm_elf32_be_vec;
|
||
extern const bfd_target arm_elf32_le_vec;
|
||
extern const bfd_target arm_elf32_fdpic_be_vec;
|
||
extern const bfd_target arm_elf32_fdpic_le_vec;
|
||
extern const bfd_target arm_elf32_nacl_be_vec;
|
||
extern const bfd_target arm_elf32_nacl_le_vec;
|
||
extern const bfd_target arm_elf32_vxworks_be_vec;
|
||
extern const bfd_target arm_elf32_vxworks_le_vec;
|
||
extern const bfd_target arm_mach_o_vec;
|
||
extern const bfd_target arm_pe_be_vec;
|
||
extern const bfd_target arm_pe_le_vec;
|
||
extern const bfd_target arm_pe_wince_be_vec;
|
||
extern const bfd_target arm_pe_wince_le_vec;
|
||
extern const bfd_target arm_pei_be_vec;
|
||
extern const bfd_target arm_pei_le_vec;
|
||
extern const bfd_target arm_pei_wince_be_vec;
|
||
extern const bfd_target arm_pei_wince_le_vec;
|
||
extern const bfd_target avr_elf32_vec;
|
||
extern const bfd_target bfin_elf32_vec;
|
||
extern const bfd_target bfin_elf32_fdpic_vec;
|
||
extern const bfd_target cr16_elf32_vec;
|
||
extern const bfd_target cris_aout_vec;
|
||
extern const bfd_target cris_elf32_vec;
|
||
extern const bfd_target cris_elf32_us_vec;
|
||
extern const bfd_target crx_elf32_vec;
|
||
extern const bfd_target csky_elf32_be_vec;
|
||
extern const bfd_target csky_elf32_le_vec;
|
||
extern const bfd_target d10v_elf32_vec;
|
||
extern const bfd_target d30v_elf32_vec;
|
||
extern const bfd_target dlx_elf32_be_vec;
|
||
extern const bfd_target elf32_be_vec;
|
||
extern const bfd_target elf32_le_vec;
|
||
extern const bfd_target elf64_be_vec;
|
||
extern const bfd_target elf64_le_vec;
|
||
extern const bfd_target bpf_elf64_le_vec;
|
||
extern const bfd_target bpf_elf64_be_vec;
|
||
extern const bfd_target epiphany_elf32_vec;
|
||
extern const bfd_target fr30_elf32_vec;
|
||
extern const bfd_target frv_elf32_vec;
|
||
extern const bfd_target frv_elf32_fdpic_vec;
|
||
extern const bfd_target h8300_elf32_vec;
|
||
extern const bfd_target h8300_elf32_linux_vec;
|
||
extern const bfd_target hppa_elf32_vec;
|
||
extern const bfd_target hppa_elf32_linux_vec;
|
||
extern const bfd_target hppa_elf32_nbsd_vec;
|
||
extern const bfd_target hppa_elf64_vec;
|
||
extern const bfd_target hppa_elf64_linux_vec;
|
||
extern const bfd_target hppa_som_vec;
|
||
extern const bfd_target i386_aout_vec;
|
||
extern const bfd_target i386_aout_bsd_vec;
|
||
extern const bfd_target i386_aout_lynx_vec;
|
||
extern const bfd_target i386_coff_vec;
|
||
extern const bfd_target i386_coff_go32_vec;
|
||
extern const bfd_target i386_coff_go32stubbed_vec;
|
||
extern const bfd_target i386_coff_lynx_vec;
|
||
extern const bfd_target i386_elf32_vec;
|
||
extern const bfd_target i386_elf32_fbsd_vec;
|
||
extern const bfd_target i386_elf32_sol2_vec;
|
||
extern const bfd_target i386_elf32_vxworks_vec;
|
||
extern const bfd_target i386_mach_o_vec;
|
||
extern const bfd_target i386_msdos_vec;
|
||
extern const bfd_target i386_pe_vec;
|
||
extern const bfd_target i386_pe_big_vec;
|
||
extern const bfd_target i386_pei_vec;
|
||
extern const bfd_target iamcu_elf32_vec;
|
||
extern const bfd_target ia64_elf32_be_vec;
|
||
extern const bfd_target ia64_elf32_hpux_be_vec;
|
||
extern const bfd_target ia64_elf64_be_vec;
|
||
extern const bfd_target ia64_elf64_le_vec;
|
||
extern const bfd_target ia64_elf64_hpux_be_vec;
|
||
extern const bfd_target ia64_elf64_vms_vec;
|
||
extern const bfd_target ia64_pei_vec;
|
||
extern const bfd_target ip2k_elf32_vec;
|
||
extern const bfd_target iq2000_elf32_vec;
|
||
extern const bfd_target lm32_elf32_vec;
|
||
extern const bfd_target lm32_elf32_fdpic_vec;
|
||
extern const bfd_target loongarch_elf64_vec;
|
||
extern const bfd_target loongarch_elf32_vec;
|
||
extern const bfd_target loongarch64_pei_vec;
|
||
extern const bfd_target m32c_elf32_vec;
|
||
extern const bfd_target m32r_elf32_vec;
|
||
extern const bfd_target m32r_elf32_le_vec;
|
||
extern const bfd_target m32r_elf32_linux_vec;
|
||
extern const bfd_target m32r_elf32_linux_le_vec;
|
||
extern const bfd_target m68hc11_elf32_vec;
|
||
extern const bfd_target m68hc12_elf32_vec;
|
||
extern const bfd_target m68k_elf32_vec;
|
||
extern const bfd_target s12z_elf32_vec;
|
||
extern const bfd_target mach_o_be_vec;
|
||
extern const bfd_target mach_o_le_vec;
|
||
extern const bfd_target mach_o_fat_vec;
|
||
extern const bfd_target mcore_elf32_be_vec;
|
||
extern const bfd_target mcore_elf32_le_vec;
|
||
extern const bfd_target mcore_pe_be_vec;
|
||
extern const bfd_target mcore_pe_le_vec;
|
||
extern const bfd_target mcore_pei_be_vec;
|
||
extern const bfd_target mcore_pei_le_vec;
|
||
extern const bfd_target mep_elf32_vec;
|
||
extern const bfd_target mep_elf32_le_vec;
|
||
extern const bfd_target metag_elf32_vec;
|
||
extern const bfd_target microblaze_elf32_vec;
|
||
extern const bfd_target microblaze_elf32_le_vec;
|
||
extern const bfd_target mips_ecoff_be_vec;
|
||
extern const bfd_target mips_ecoff_le_vec;
|
||
extern const bfd_target mips_ecoff_bele_vec;
|
||
extern const bfd_target mips_elf32_be_vec;
|
||
extern const bfd_target mips_elf32_le_vec;
|
||
extern const bfd_target mips_elf32_n_be_vec;
|
||
extern const bfd_target mips_elf32_n_le_vec;
|
||
extern const bfd_target mips_elf32_ntrad_be_vec;
|
||
extern const bfd_target mips_elf32_ntrad_le_vec;
|
||
extern const bfd_target mips_elf32_ntradfbsd_be_vec;
|
||
extern const bfd_target mips_elf32_ntradfbsd_le_vec;
|
||
extern const bfd_target mips_elf32_trad_be_vec;
|
||
extern const bfd_target mips_elf32_trad_le_vec;
|
||
extern const bfd_target mips_elf32_tradfbsd_be_vec;
|
||
extern const bfd_target mips_elf32_tradfbsd_le_vec;
|
||
extern const bfd_target mips_elf32_vxworks_be_vec;
|
||
extern const bfd_target mips_elf32_vxworks_le_vec;
|
||
extern const bfd_target mips_elf64_be_vec;
|
||
extern const bfd_target mips_elf64_le_vec;
|
||
extern const bfd_target mips_elf64_trad_be_vec;
|
||
extern const bfd_target mips_elf64_trad_le_vec;
|
||
extern const bfd_target mips_elf64_tradfbsd_be_vec;
|
||
extern const bfd_target mips_elf64_tradfbsd_le_vec;
|
||
extern const bfd_target mmix_elf64_vec;
|
||
extern const bfd_target mmix_mmo_vec;
|
||
extern const bfd_target mn10200_elf32_vec;
|
||
extern const bfd_target mn10300_elf32_vec;
|
||
extern const bfd_target moxie_elf32_be_vec;
|
||
extern const bfd_target moxie_elf32_le_vec;
|
||
extern const bfd_target msp430_elf32_vec;
|
||
extern const bfd_target msp430_elf32_ti_vec;
|
||
extern const bfd_target mt_elf32_vec;
|
||
extern const bfd_target nds32_elf32_be_vec;
|
||
extern const bfd_target nds32_elf32_le_vec;
|
||
extern const bfd_target nds32_elf32_linux_be_vec;
|
||
extern const bfd_target nds32_elf32_linux_le_vec;
|
||
extern const bfd_target nfp_elf64_vec;
|
||
extern const bfd_target nios2_elf32_be_vec;
|
||
extern const bfd_target nios2_elf32_le_vec;
|
||
extern const bfd_target ns32k_aout_pc532mach_vec;
|
||
extern const bfd_target ns32k_aout_pc532nbsd_vec;
|
||
extern const bfd_target or1k_elf32_vec;
|
||
extern const bfd_target pdb_vec;
|
||
extern const bfd_target pdp11_aout_vec;
|
||
extern const bfd_target pef_vec;
|
||
extern const bfd_target pef_xlib_vec;
|
||
extern const bfd_target pj_elf32_vec;
|
||
extern const bfd_target pj_elf32_le_vec;
|
||
extern const bfd_target plugin_vec;
|
||
extern const bfd_target powerpc_boot_vec;
|
||
extern const bfd_target powerpc_elf32_vec;
|
||
extern const bfd_target powerpc_elf32_le_vec;
|
||
extern const bfd_target powerpc_elf32_fbsd_vec;
|
||
extern const bfd_target powerpc_elf32_vxworks_vec;
|
||
extern const bfd_target powerpc_elf64_vec;
|
||
extern const bfd_target powerpc_elf64_le_vec;
|
||
extern const bfd_target powerpc_elf64_fbsd_vec;
|
||
extern const bfd_target powerpc_elf64_fbsd_le_vec;
|
||
extern const bfd_target powerpc_xcoff_vec;
|
||
extern const bfd_target pru_elf32_vec;
|
||
extern const bfd_target riscv_elf32_vec;
|
||
extern const bfd_target riscv_elf64_vec;
|
||
extern const bfd_target riscv_elf32_be_vec;
|
||
extern const bfd_target riscv_elf64_be_vec;
|
||
extern const bfd_target rl78_elf32_vec;
|
||
extern const bfd_target rs6000_xcoff64_vec;
|
||
extern const bfd_target rs6000_xcoff64_aix_vec;
|
||
extern const bfd_target rs6000_xcoff_vec;
|
||
extern const bfd_target rx_elf32_be_vec;
|
||
extern const bfd_target rx_elf32_be_ns_vec;
|
||
extern const bfd_target rx_elf32_le_vec;
|
||
extern const bfd_target rx_elf32_linux_le_vec;
|
||
extern const bfd_target s390_elf32_vec;
|
||
extern const bfd_target s390_elf64_vec;
|
||
extern const bfd_target score_elf32_be_vec;
|
||
extern const bfd_target score_elf32_le_vec;
|
||
extern const bfd_target sh_coff_vec;
|
||
extern const bfd_target sh_coff_le_vec;
|
||
extern const bfd_target sh_coff_small_vec;
|
||
extern const bfd_target sh_coff_small_le_vec;
|
||
extern const bfd_target sh_elf32_vec;
|
||
extern const bfd_target sh_elf32_le_vec;
|
||
extern const bfd_target sh_elf32_fdpic_be_vec;
|
||
extern const bfd_target sh_elf32_fdpic_le_vec;
|
||
extern const bfd_target sh_elf32_linux_vec;
|
||
extern const bfd_target sh_elf32_linux_be_vec;
|
||
extern const bfd_target sh_elf32_nbsd_vec;
|
||
extern const bfd_target sh_elf32_nbsd_le_vec;
|
||
extern const bfd_target sh_elf32_vxworks_vec;
|
||
extern const bfd_target sh_elf32_vxworks_le_vec;
|
||
extern const bfd_target sh_pe_le_vec;
|
||
extern const bfd_target sh_pei_le_vec;
|
||
extern const bfd_target sparc_elf32_vec;
|
||
extern const bfd_target sparc_elf32_sol2_vec;
|
||
extern const bfd_target sparc_elf32_vxworks_vec;
|
||
extern const bfd_target sparc_elf64_vec;
|
||
extern const bfd_target sparc_elf64_fbsd_vec;
|
||
extern const bfd_target sparc_elf64_sol2_vec;
|
||
extern const bfd_target spu_elf32_vec;
|
||
extern const bfd_target sym_vec;
|
||
extern const bfd_target tic30_coff_vec;
|
||
extern const bfd_target tic4x_coff0_vec;
|
||
extern const bfd_target tic4x_coff0_beh_vec;
|
||
extern const bfd_target tic4x_coff1_vec;
|
||
extern const bfd_target tic4x_coff1_beh_vec;
|
||
extern const bfd_target tic4x_coff2_vec;
|
||
extern const bfd_target tic4x_coff2_beh_vec;
|
||
extern const bfd_target tic54x_coff0_vec;
|
||
extern const bfd_target tic54x_coff0_beh_vec;
|
||
extern const bfd_target tic54x_coff1_vec;
|
||
extern const bfd_target tic54x_coff1_beh_vec;
|
||
extern const bfd_target tic54x_coff2_vec;
|
||
extern const bfd_target tic54x_coff2_beh_vec;
|
||
extern const bfd_target tic6x_elf32_be_vec;
|
||
extern const bfd_target tic6x_elf32_le_vec;
|
||
extern const bfd_target tic6x_elf32_c6000_be_vec;
|
||
extern const bfd_target tic6x_elf32_c6000_le_vec;
|
||
extern const bfd_target tic6x_elf32_linux_be_vec;
|
||
extern const bfd_target tic6x_elf32_linux_le_vec;
|
||
extern const bfd_target tilegx_elf32_be_vec;
|
||
extern const bfd_target tilegx_elf32_le_vec;
|
||
extern const bfd_target tilegx_elf64_be_vec;
|
||
extern const bfd_target tilegx_elf64_le_vec;
|
||
extern const bfd_target tilepro_elf32_vec;
|
||
extern const bfd_target v800_elf32_vec;
|
||
extern const bfd_target v850_elf32_vec;
|
||
extern const bfd_target ft32_elf32_vec;
|
||
extern const bfd_target vax_aout_1knbsd_vec;
|
||
extern const bfd_target vax_aout_nbsd_vec;
|
||
extern const bfd_target vax_elf32_vec;
|
||
extern const bfd_target visium_elf32_vec;
|
||
extern const bfd_target wasm_vec;
|
||
extern const bfd_target wasm32_elf32_vec;
|
||
extern const bfd_target x86_64_coff_vec;
|
||
extern const bfd_target x86_64_elf32_vec;
|
||
extern const bfd_target x86_64_elf64_vec;
|
||
extern const bfd_target x86_64_elf64_cloudabi_vec;
|
||
extern const bfd_target x86_64_elf64_fbsd_vec;
|
||
extern const bfd_target x86_64_elf64_sol2_vec;
|
||
extern const bfd_target x86_64_mach_o_vec;
|
||
extern const bfd_target x86_64_pe_vec;
|
||
extern const bfd_target x86_64_pe_big_vec;
|
||
extern const bfd_target x86_64_pei_vec;
|
||
extern const bfd_target xgate_elf32_vec;
|
||
extern const bfd_target xstormy16_elf32_vec;
|
||
extern const bfd_target xtensa_elf32_be_vec;
|
||
extern const bfd_target xtensa_elf32_le_vec;
|
||
extern const bfd_target z80_coff_vec;
|
||
extern const bfd_target z80_elf32_vec;
|
||
extern const bfd_target z8k_coff_vec;
|
||
|
||
/* These are always included. */
|
||
extern const bfd_target srec_vec;
|
||
extern const bfd_target symbolsrec_vec;
|
||
extern const bfd_target verilog_vec;
|
||
extern const bfd_target tekhex_vec;
|
||
extern const bfd_target binary_vec;
|
||
extern const bfd_target ihex_vec;
|
||
|
||
/* All of the xvecs for core files. */
|
||
extern const bfd_target core_cisco_be_vec;
|
||
extern const bfd_target core_cisco_le_vec;
|
||
extern const bfd_target core_hppabsd_vec;
|
||
extern const bfd_target core_hpux_vec;
|
||
extern const bfd_target core_irix_vec;
|
||
extern const bfd_target core_netbsd_vec;
|
||
extern const bfd_target core_osf_vec;
|
||
extern const bfd_target core_ptrace_vec;
|
||
extern const bfd_target core_trad_vec;
|
||
|
||
static const bfd_target * const _bfd_target_vector[] =
|
||
{
|
||
#ifdef SELECT_VECS
|
||
|
||
SELECT_VECS,
|
||
|
||
#else /* not SELECT_VECS */
|
||
|
||
#ifdef DEFAULT_VECTOR
|
||
&DEFAULT_VECTOR,
|
||
#endif
|
||
/* This list is alphabetized to make it easy to compare
|
||
with other vector lists -- the decls above and
|
||
the case statement in configure.ac.
|
||
Try to keep it in order when adding new targets, and
|
||
use a name of the form <cpu>_<format>_<other>_<endian>_vec.
|
||
Note that sorting is done as if _<endian>_vec wasn't present.
|
||
Vectors that don't compile on all systems, or aren't finished,
|
||
should have an entry here with #if 0 around it, to show that
|
||
it wasn't omitted by mistake. */
|
||
#ifdef BFD64
|
||
&aarch64_elf32_be_vec,
|
||
&aarch64_elf32_le_vec,
|
||
&aarch64_elf64_be_vec,
|
||
&aarch64_elf64_be_cloudabi_vec,
|
||
&aarch64_elf64_le_vec,
|
||
&aarch64_elf64_le_cloudabi_vec,
|
||
&aarch64_mach_o_vec,
|
||
&aarch64_pe_le_vec,
|
||
&aarch64_pei_le_vec,
|
||
#endif
|
||
|
||
#ifdef BFD64
|
||
&amdgcn_elf64_le_vec,
|
||
#endif
|
||
|
||
#ifdef BFD64
|
||
&alpha_ecoff_le_vec,
|
||
&alpha_elf64_vec,
|
||
&alpha_elf64_fbsd_vec,
|
||
&alpha_vms_vec,
|
||
#endif
|
||
&alpha_vms_lib_txt_vec,
|
||
|
||
&am33_elf32_linux_vec,
|
||
|
||
#if 0
|
||
/* Since a.out files lack decent magic numbers, no way to recognize
|
||
which kind of a.out file it is. */
|
||
&aout_vec,
|
||
#endif
|
||
|
||
&arc_elf32_be_vec,
|
||
&arc_elf32_le_vec,
|
||
|
||
&arm_elf32_be_vec,
|
||
&arm_elf32_le_vec,
|
||
&arm_elf32_fdpic_be_vec,
|
||
&arm_elf32_fdpic_le_vec,
|
||
&arm_elf32_vxworks_be_vec,
|
||
&arm_elf32_vxworks_le_vec,
|
||
&arm_mach_o_vec,
|
||
&arm_pe_be_vec,
|
||
&arm_pe_le_vec,
|
||
&arm_pe_wince_be_vec,
|
||
&arm_pe_wince_le_vec,
|
||
&arm_pei_be_vec,
|
||
&arm_pei_le_vec,
|
||
&arm_pei_wince_be_vec,
|
||
&arm_pei_wince_le_vec,
|
||
|
||
&avr_elf32_vec,
|
||
|
||
&bfin_elf32_vec,
|
||
&bfin_elf32_fdpic_vec,
|
||
|
||
&cr16_elf32_vec,
|
||
|
||
&cris_aout_vec,
|
||
&cris_elf32_vec,
|
||
&cris_elf32_us_vec,
|
||
|
||
&crx_elf32_vec,
|
||
|
||
&csky_elf32_be_vec,
|
||
&csky_elf32_le_vec,
|
||
|
||
&d10v_elf32_vec,
|
||
&d30v_elf32_vec,
|
||
|
||
&dlx_elf32_be_vec,
|
||
|
||
/* This, and other vectors, may not be used in any *.mt configuration.
|
||
But that does not mean they are unnecessary. If configured with
|
||
--enable-targets=all, objdump or gdb should be able to examine
|
||
the file even if we don't recognize the machine type. */
|
||
&elf32_be_vec,
|
||
&elf32_le_vec,
|
||
#ifdef BFD64
|
||
&elf64_be_vec,
|
||
&elf64_le_vec,
|
||
#endif
|
||
|
||
&epiphany_elf32_vec,
|
||
|
||
&fr30_elf32_vec,
|
||
|
||
&frv_elf32_vec,
|
||
&frv_elf32_fdpic_vec,
|
||
|
||
&h8300_elf32_vec,
|
||
&h8300_elf32_linux_vec,
|
||
|
||
&hppa_elf32_vec,
|
||
&hppa_elf32_linux_vec,
|
||
&hppa_elf32_nbsd_vec,
|
||
#ifdef BFD64
|
||
&hppa_elf64_vec,
|
||
&hppa_elf64_linux_vec,
|
||
#endif
|
||
&hppa_som_vec,
|
||
|
||
&i386_aout_vec,
|
||
&i386_aout_bsd_vec,
|
||
&i386_aout_lynx_vec,
|
||
&i386_coff_vec,
|
||
&i386_coff_go32_vec,
|
||
&i386_coff_go32stubbed_vec,
|
||
&i386_coff_lynx_vec,
|
||
&i386_elf32_vec,
|
||
&i386_elf32_fbsd_vec,
|
||
&i386_elf32_sol2_vec,
|
||
&i386_elf32_vxworks_vec,
|
||
&i386_mach_o_vec,
|
||
&i386_msdos_vec,
|
||
&i386_pe_vec,
|
||
&i386_pe_big_vec,
|
||
&i386_pei_vec,
|
||
|
||
&iamcu_elf32_vec,
|
||
|
||
#ifdef BFD64
|
||
&bpf_elf64_be_vec,
|
||
&bpf_elf64_le_vec,
|
||
#endif
|
||
|
||
#ifdef BFD64
|
||
#if 0
|
||
&ia64_elf32_be_vec,
|
||
#endif
|
||
&ia64_elf32_hpux_be_vec,
|
||
&ia64_elf64_be_vec,
|
||
&ia64_elf64_le_vec,
|
||
&ia64_elf64_hpux_be_vec,
|
||
&ia64_elf64_vms_vec,
|
||
&ia64_pei_vec,
|
||
#endif
|
||
|
||
&ip2k_elf32_vec,
|
||
&iq2000_elf32_vec,
|
||
|
||
&lm32_elf32_vec,
|
||
|
||
&m32c_elf32_vec,
|
||
|
||
&m32r_elf32_vec,
|
||
&m32r_elf32_le_vec,
|
||
&m32r_elf32_linux_vec,
|
||
&m32r_elf32_linux_le_vec,
|
||
|
||
&m68hc11_elf32_vec,
|
||
&m68hc12_elf32_vec,
|
||
|
||
&m68k_elf32_vec,
|
||
|
||
&s12z_elf32_vec,
|
||
|
||
&mach_o_be_vec,
|
||
&mach_o_le_vec,
|
||
&mach_o_fat_vec,
|
||
|
||
&mcore_elf32_be_vec,
|
||
&mcore_elf32_le_vec,
|
||
&mcore_pe_be_vec,
|
||
&mcore_pe_le_vec,
|
||
&mcore_pei_be_vec,
|
||
&mcore_pei_le_vec,
|
||
|
||
&mep_elf32_vec,
|
||
|
||
&metag_elf32_vec,
|
||
|
||
µblaze_elf32_vec,
|
||
|
||
&mips_ecoff_be_vec,
|
||
&mips_ecoff_le_vec,
|
||
&mips_ecoff_bele_vec,
|
||
#ifdef BFD64
|
||
&mips_elf32_be_vec,
|
||
&mips_elf32_le_vec,
|
||
&mips_elf32_n_be_vec,
|
||
&mips_elf32_n_le_vec,
|
||
&mips_elf32_ntrad_be_vec,
|
||
&mips_elf32_ntrad_le_vec,
|
||
&mips_elf32_ntradfbsd_be_vec,
|
||
&mips_elf32_ntradfbsd_le_vec,
|
||
&mips_elf32_trad_be_vec,
|
||
&mips_elf32_trad_le_vec,
|
||
&mips_elf32_tradfbsd_be_vec,
|
||
&mips_elf32_tradfbsd_le_vec,
|
||
&mips_elf32_vxworks_be_vec,
|
||
&mips_elf32_vxworks_le_vec,
|
||
&mips_elf64_be_vec,
|
||
&mips_elf64_le_vec,
|
||
&mips_elf64_trad_be_vec,
|
||
&mips_elf64_trad_le_vec,
|
||
&mips_elf64_tradfbsd_be_vec,
|
||
&mips_elf64_tradfbsd_le_vec,
|
||
#endif
|
||
|
||
#ifdef BFD64
|
||
&mmix_elf64_vec,
|
||
&mmix_mmo_vec,
|
||
#endif
|
||
|
||
&mn10200_elf32_vec,
|
||
&mn10300_elf32_vec,
|
||
|
||
&moxie_elf32_be_vec,
|
||
&moxie_elf32_le_vec,
|
||
|
||
&msp430_elf32_vec,
|
||
&msp430_elf32_ti_vec,
|
||
|
||
&mt_elf32_vec,
|
||
|
||
&nds32_elf32_be_vec,
|
||
&nds32_elf32_le_vec,
|
||
&nds32_elf32_linux_be_vec,
|
||
&nds32_elf32_linux_le_vec,
|
||
|
||
#ifdef BFD64
|
||
&nfp_elf64_vec,
|
||
#endif
|
||
|
||
&nios2_elf32_be_vec,
|
||
&nios2_elf32_le_vec,
|
||
|
||
&ns32k_aout_pc532mach_vec,
|
||
&ns32k_aout_pc532nbsd_vec,
|
||
|
||
&or1k_elf32_vec,
|
||
|
||
&pdb_vec,
|
||
|
||
&pdp11_aout_vec,
|
||
|
||
&pef_vec,
|
||
&pef_xlib_vec,
|
||
|
||
&pj_elf32_vec,
|
||
&pj_elf32_le_vec,
|
||
|
||
&powerpc_boot_vec,
|
||
&powerpc_elf32_vec,
|
||
&powerpc_elf32_le_vec,
|
||
&powerpc_elf32_fbsd_vec,
|
||
&powerpc_elf32_vxworks_vec,
|
||
#ifdef BFD64
|
||
&powerpc_elf64_vec,
|
||
&powerpc_elf64_le_vec,
|
||
&powerpc_elf64_fbsd_vec,
|
||
&powerpc_elf64_fbsd_le_vec,
|
||
#endif
|
||
#if 0
|
||
/* This has the same magic number as RS/6000. */
|
||
&powerpc_xcoff_vec,
|
||
#endif
|
||
|
||
&pru_elf32_vec,
|
||
|
||
#ifdef BFD64
|
||
&riscv_elf32_vec,
|
||
&riscv_elf64_vec,
|
||
&riscv_elf32_be_vec,
|
||
&riscv_elf64_be_vec,
|
||
#endif
|
||
&rl78_elf32_vec,
|
||
|
||
#ifdef BFD64
|
||
&rs6000_xcoff64_vec,
|
||
&rs6000_xcoff64_aix_vec,
|
||
#endif
|
||
&rs6000_xcoff_vec,
|
||
|
||
&rx_elf32_be_vec,
|
||
&rx_elf32_be_ns_vec,
|
||
&rx_elf32_le_vec,
|
||
|
||
&s390_elf32_vec,
|
||
#ifdef BFD64
|
||
&s390_elf64_vec,
|
||
#endif
|
||
|
||
#ifdef BFD64
|
||
&score_elf32_be_vec,
|
||
&score_elf32_le_vec,
|
||
#endif
|
||
|
||
&sh_coff_vec,
|
||
&sh_coff_le_vec,
|
||
&sh_coff_small_vec,
|
||
&sh_coff_small_le_vec,
|
||
&sh_elf32_vec,
|
||
&sh_elf32_le_vec,
|
||
&sh_elf32_fdpic_be_vec,
|
||
&sh_elf32_fdpic_le_vec,
|
||
&sh_elf32_linux_vec,
|
||
&sh_elf32_linux_be_vec,
|
||
&sh_elf32_nbsd_vec,
|
||
&sh_elf32_nbsd_le_vec,
|
||
&sh_elf32_vxworks_vec,
|
||
&sh_elf32_vxworks_le_vec,
|
||
&sh_pe_le_vec,
|
||
&sh_pei_le_vec,
|
||
|
||
&sparc_elf32_vec,
|
||
&sparc_elf32_sol2_vec,
|
||
&sparc_elf32_vxworks_vec,
|
||
#ifdef BFD64
|
||
&sparc_elf64_vec,
|
||
&sparc_elf64_fbsd_vec,
|
||
&sparc_elf64_sol2_vec,
|
||
#endif
|
||
|
||
&spu_elf32_vec,
|
||
|
||
&sym_vec,
|
||
|
||
&tic30_coff_vec,
|
||
&tic54x_coff0_beh_vec,
|
||
&tic54x_coff0_vec,
|
||
&tic54x_coff1_beh_vec,
|
||
&tic54x_coff1_vec,
|
||
&tic54x_coff2_beh_vec,
|
||
&tic54x_coff2_vec,
|
||
&tic6x_elf32_be_vec,
|
||
&tic6x_elf32_le_vec,
|
||
|
||
&tilegx_elf32_be_vec,
|
||
&tilegx_elf32_le_vec,
|
||
#ifdef BFD64
|
||
&tilegx_elf64_be_vec,
|
||
&tilegx_elf64_le_vec,
|
||
#endif
|
||
&tilepro_elf32_vec,
|
||
|
||
&ft32_elf32_vec,
|
||
|
||
&v800_elf32_vec,
|
||
&v850_elf32_vec,
|
||
|
||
&vax_aout_1knbsd_vec,
|
||
&vax_aout_nbsd_vec,
|
||
&vax_elf32_vec,
|
||
|
||
&visium_elf32_vec,
|
||
|
||
&wasm_vec,
|
||
&wasm32_elf32_vec,
|
||
|
||
#ifdef BFD64
|
||
&x86_64_coff_vec,
|
||
&x86_64_elf32_vec,
|
||
&x86_64_elf64_vec,
|
||
&x86_64_elf64_cloudabi_vec,
|
||
&x86_64_elf64_fbsd_vec,
|
||
&x86_64_elf64_sol2_vec,
|
||
&x86_64_mach_o_vec,
|
||
&x86_64_pe_vec,
|
||
&x86_64_pe_big_vec,
|
||
&x86_64_pei_vec,
|
||
#endif
|
||
|
||
&xgate_elf32_vec,
|
||
|
||
&xstormy16_elf32_vec,
|
||
|
||
&xtensa_elf32_be_vec,
|
||
&xtensa_elf32_le_vec,
|
||
|
||
&z80_coff_vec,
|
||
&z80_elf32_vec,
|
||
|
||
&z8k_coff_vec,
|
||
|
||
#ifdef BFD64
|
||
&loongarch_elf32_vec,
|
||
&loongarch_elf64_vec,
|
||
&loongarch64_pei_vec,
|
||
#endif
|
||
|
||
#endif /* not SELECT_VECS */
|
||
|
||
/* Always support S-records, for convenience. */
|
||
&srec_vec,
|
||
&symbolsrec_vec,
|
||
/* And verilog. */
|
||
&verilog_vec,
|
||
/* And tekhex */
|
||
&tekhex_vec,
|
||
/* Likewise for binary output. */
|
||
&binary_vec,
|
||
/* Likewise for ihex. */
|
||
&ihex_vec,
|
||
|
||
#if BFD_SUPPORTS_PLUGINS
|
||
&plugin_vec,
|
||
#endif
|
||
|
||
/* Add any required traditional-core-file-handler. */
|
||
|
||
#if 0
|
||
/* We don't include cisco_core_*_vec. Although it has a magic number,
|
||
the magic number isn't at the beginning of the file, and thus
|
||
might spuriously match other kinds of files. */
|
||
&core_cisco_be_vec,
|
||
&core_cisco_le_vec,
|
||
#endif
|
||
#ifdef HPPABSD_CORE
|
||
&core_hppabsd_vec,
|
||
#endif
|
||
#ifdef HPUX_CORE
|
||
&core_hpux_vec,
|
||
#endif
|
||
#ifdef IRIX_CORE
|
||
&core_irix_vec,
|
||
#endif
|
||
#ifdef NETBSD_CORE
|
||
&core_netbsd_vec,
|
||
#endif
|
||
#ifdef OSF_CORE
|
||
&core_osf_vec,
|
||
#endif
|
||
#ifdef PTRACE_CORE
|
||
&core_ptrace_vec,
|
||
#endif
|
||
#ifdef TRAD_CORE
|
||
&core_trad_vec,
|
||
#endif
|
||
|
||
NULL /* end of list marker */
|
||
};
|
||
const bfd_target *const *const bfd_target_vector = _bfd_target_vector;
|
||
|
||
/* bfd_default_vector[0] contains either the address of the default vector,
|
||
if there is one, or zero if there isn't. */
|
||
|
||
const bfd_target *bfd_default_vector[] = {
|
||
#ifdef DEFAULT_VECTOR
|
||
&DEFAULT_VECTOR,
|
||
#endif
|
||
NULL
|
||
};
|
||
|
||
/* bfd_associated_vector[] contains the associated target vectors used
|
||
to reduce the ambiguity in bfd_check_format_matches. */
|
||
|
||
static const bfd_target *const _bfd_associated_vector[] = {
|
||
#ifdef ASSOCIATED_VECS
|
||
ASSOCIATED_VECS,
|
||
#endif
|
||
NULL
|
||
};
|
||
const bfd_target *const *const bfd_associated_vector = _bfd_associated_vector;
|
||
|
||
/* When there is an ambiguous match, bfd_check_format_matches puts the
|
||
names of the matching targets in an array. This variable is the maximum
|
||
number of entries that the array could possibly need. */
|
||
const size_t _bfd_target_vector_entries = ARRAY_SIZE (_bfd_target_vector);
|
||
|
||
/* A place to stash a warning from _bfd_check_format. */
|
||
static struct per_xvec_message *per_xvec_warn[ARRAY_SIZE (_bfd_target_vector)
|
||
+ 1];
|
||
|
||
/* This array maps configuration triplets onto BFD vectors. */
|
||
|
||
struct targmatch
|
||
{
|
||
/* The configuration triplet. */
|
||
const char *triplet;
|
||
/* The BFD vector. If this is NULL, then the vector is found by
|
||
searching forward for the next structure with a non NULL vector
|
||
field. */
|
||
const bfd_target *vector;
|
||
};
|
||
|
||
/* targmatch.h is built by Makefile out of config.bfd. */
|
||
static const struct targmatch bfd_target_match[] = {
|
||
#include "targmatch.h"
|
||
{ NULL, NULL }
|
||
};
|
||
|
||
/*
|
||
INTERNAL
|
||
.{* Cached _bfd_check_format messages are put in this. *}
|
||
.struct per_xvec_message
|
||
.{
|
||
. struct per_xvec_message *next;
|
||
. char message[];
|
||
.};
|
||
.
|
||
INTERNAL_FUNCTION
|
||
_bfd_per_xvec_warn
|
||
|
||
SYNOPSIS
|
||
struct per_xvec_message **_bfd_per_xvec_warn (const bfd_target *, size_t);
|
||
|
||
DESCRIPTION
|
||
Return a location for the given target xvec to use for
|
||
warnings specific to that target. If TARG is NULL, returns
|
||
the array of per_xvec_message pointers, otherwise if ALLOC is
|
||
zero, returns a pointer to a pointer to the list of messages
|
||
for TARG, otherwise (both TARG and ALLOC non-zero), allocates
|
||
a new per_xvec_message with space for a string of ALLOC
|
||
bytes and returns a pointer to a pointer to it. May return a
|
||
pointer to a NULL pointer on allocation failure.
|
||
*/
|
||
|
||
struct per_xvec_message **
|
||
_bfd_per_xvec_warn (const bfd_target *targ, size_t alloc)
|
||
{
|
||
size_t idx;
|
||
|
||
if (!targ)
|
||
return per_xvec_warn;
|
||
for (idx = 0; idx < ARRAY_SIZE (_bfd_target_vector); idx++)
|
||
if (_bfd_target_vector[idx] == targ)
|
||
break;
|
||
struct per_xvec_message **m = per_xvec_warn + idx;
|
||
if (!alloc)
|
||
return m;
|
||
int count = 0;
|
||
while (*m)
|
||
{
|
||
m = &(*m)->next;
|
||
count++;
|
||
}
|
||
/* Anti-fuzzer measure. Don't cache more than 5 messages. */
|
||
if (count < 5)
|
||
{
|
||
*m = bfd_malloc (sizeof (**m) + alloc);
|
||
if (*m != NULL)
|
||
(*m)->next = NULL;
|
||
}
|
||
return m;
|
||
}
|
||
|
||
/* Find a target vector, given a name or configuration triplet. */
|
||
|
||
static const bfd_target *
|
||
find_target (const char *name)
|
||
{
|
||
const bfd_target * const *target;
|
||
const struct targmatch *match;
|
||
|
||
for (target = &bfd_target_vector[0]; *target != NULL; target++)
|
||
if (strcmp (name, (*target)->name) == 0)
|
||
return *target;
|
||
|
||
/* If we couldn't match on the exact name, try matching on the
|
||
configuration triplet. FIXME: We should run the triplet through
|
||
config.sub first, but that is hard. */
|
||
for (match = &bfd_target_match[0]; match->triplet != NULL; match++)
|
||
{
|
||
if (fnmatch (match->triplet, name, 0) == 0)
|
||
{
|
||
while (match->vector == NULL)
|
||
++match;
|
||
return match->vector;
|
||
}
|
||
}
|
||
|
||
bfd_set_error (bfd_error_invalid_target);
|
||
return NULL;
|
||
}
|
||
|
||
/*
|
||
FUNCTION
|
||
bfd_set_default_target
|
||
|
||
SYNOPSIS
|
||
bool bfd_set_default_target (const char *name);
|
||
|
||
DESCRIPTION
|
||
Set the default target vector to use when recognizing a BFD.
|
||
This takes the name of the target, which may be a BFD target
|
||
name or a configuration triplet.
|
||
*/
|
||
|
||
bool
|
||
bfd_set_default_target (const char *name)
|
||
{
|
||
const bfd_target *target;
|
||
|
||
if (bfd_default_vector[0] != NULL
|
||
&& strcmp (name, bfd_default_vector[0]->name) == 0)
|
||
return true;
|
||
|
||
target = find_target (name);
|
||
if (target == NULL)
|
||
return false;
|
||
|
||
bfd_default_vector[0] = target;
|
||
return true;
|
||
}
|
||
|
||
/*
|
||
FUNCTION
|
||
bfd_find_target
|
||
|
||
SYNOPSIS
|
||
const bfd_target *bfd_find_target (const char *target_name, bfd *abfd);
|
||
|
||
DESCRIPTION
|
||
Return a pointer to the transfer vector for the object target
|
||
named @var{target_name}. If @var{target_name} is <<NULL>>,
|
||
choose the one in the environment variable <<GNUTARGET>>; if
|
||
that is null or not defined, then choose the first entry in the
|
||
target list. Passing in the string "default" or setting the
|
||
environment variable to "default" will cause the first entry in
|
||
the target list to be returned, and "target_defaulted" will be
|
||
set in the BFD if @var{abfd} isn't <<NULL>>. This causes
|
||
<<bfd_check_format>> to loop over all the targets to find the
|
||
one that matches the file being read.
|
||
*/
|
||
|
||
const bfd_target *
|
||
bfd_find_target (const char *target_name, bfd *abfd)
|
||
{
|
||
const char *targname;
|
||
const bfd_target *target;
|
||
|
||
if (target_name != NULL)
|
||
targname = target_name;
|
||
else
|
||
targname = getenv ("GNUTARGET");
|
||
|
||
/* This is safe; the vector cannot be null. */
|
||
if (targname == NULL || strcmp (targname, "default") == 0)
|
||
{
|
||
if (bfd_default_vector[0] != NULL)
|
||
target = bfd_default_vector[0];
|
||
else
|
||
target = bfd_target_vector[0];
|
||
if (abfd)
|
||
{
|
||
abfd->xvec = target;
|
||
abfd->target_defaulted = true;
|
||
}
|
||
return target;
|
||
}
|
||
|
||
if (abfd)
|
||
abfd->target_defaulted = false;
|
||
|
||
target = find_target (targname);
|
||
if (target == NULL)
|
||
return NULL;
|
||
|
||
if (abfd)
|
||
abfd->xvec = target;
|
||
return target;
|
||
}
|
||
|
||
/* Helper function for bfd_get_target_info to determine the target's
|
||
architecture. This method handles bfd internal target names as
|
||
tuples and triplets. */
|
||
static bool
|
||
_bfd_find_arch_match (const char *tname, const char **arch,
|
||
const char **def_target_arch)
|
||
{
|
||
if (!arch)
|
||
return false;
|
||
|
||
while (*arch != NULL)
|
||
{
|
||
const char *in_a = strstr (*arch, tname);
|
||
char end_ch = (in_a ? in_a[strlen (tname)] : 0);
|
||
|
||
if (in_a && (in_a == *arch || in_a[-1] == ':')
|
||
&& end_ch == 0)
|
||
{
|
||
*def_target_arch = *arch;
|
||
return true;
|
||
}
|
||
arch++;
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/*
|
||
FUNCTION
|
||
bfd_get_target_info
|
||
SYNOPSIS
|
||
const bfd_target *bfd_get_target_info (const char *target_name,
|
||
bfd *abfd,
|
||
bool *is_bigendian,
|
||
int *underscoring,
|
||
const char **def_target_arch);
|
||
DESCRIPTION
|
||
Return a pointer to the transfer vector for the object target
|
||
named @var{target_name}. If @var{target_name} is <<NULL>>,
|
||
choose the one in the environment variable <<GNUTARGET>>; if
|
||
that is null or not defined, then choose the first entry in the
|
||
target list. Passing in the string "default" or setting the
|
||
environment variable to "default" will cause the first entry in
|
||
the target list to be returned, and "target_defaulted" will be
|
||
set in the BFD if @var{abfd} isn't <<NULL>>. This causes
|
||
<<bfd_check_format>> to loop over all the targets to find the
|
||
one that matches the file being read.
|
||
If @var{is_bigendian} is not <<NULL>>, then set this value to target's
|
||
endian mode. True for big-endian, FALSE for little-endian or for
|
||
invalid target.
|
||
If @var{underscoring} is not <<NULL>>, then set this value to target's
|
||
underscoring mode. Zero for none-underscoring, -1 for invalid target,
|
||
else the value of target vector's symbol underscoring.
|
||
If @var{def_target_arch} is not <<NULL>>, then set it to the architecture
|
||
string specified by the target_name.
|
||
*/
|
||
const bfd_target *
|
||
bfd_get_target_info (const char *target_name, bfd *abfd,
|
||
bool *is_bigendian,
|
||
int *underscoring, const char **def_target_arch)
|
||
{
|
||
const bfd_target *target_vec;
|
||
|
||
if (is_bigendian)
|
||
*is_bigendian = false;
|
||
if (underscoring)
|
||
*underscoring = -1;
|
||
if (def_target_arch)
|
||
*def_target_arch = NULL;
|
||
target_vec = bfd_find_target (target_name, abfd);
|
||
if (! target_vec)
|
||
return NULL;
|
||
if (is_bigendian)
|
||
*is_bigendian = target_vec->byteorder == BFD_ENDIAN_BIG;
|
||
if (underscoring)
|
||
*underscoring = ((int) target_vec->symbol_leading_char) & 0xff;
|
||
|
||
if (def_target_arch)
|
||
{
|
||
const char *tname = target_vec->name;
|
||
const char **arches = bfd_arch_list ();
|
||
|
||
if (arches && tname)
|
||
{
|
||
char *hyp = strchr (tname, '-');
|
||
|
||
if (hyp != NULL)
|
||
{
|
||
tname = ++hyp;
|
||
|
||
/* Make sure we detect architecture names
|
||
for triplets like "pe-arm-wince-little". */
|
||
if (!_bfd_find_arch_match (tname, arches, def_target_arch))
|
||
{
|
||
char new_tname[50];
|
||
|
||
strcpy (new_tname, hyp);
|
||
while ((hyp = strrchr (new_tname, '-')) != NULL)
|
||
{
|
||
*hyp = 0;
|
||
if (_bfd_find_arch_match (new_tname, arches,
|
||
def_target_arch))
|
||
break;
|
||
}
|
||
}
|
||
}
|
||
else
|
||
_bfd_find_arch_match (tname, arches, def_target_arch);
|
||
}
|
||
|
||
free (arches);
|
||
}
|
||
return target_vec;
|
||
}
|
||
|
||
/*
|
||
FUNCTION
|
||
bfd_target_list
|
||
|
||
SYNOPSIS
|
||
const char ** bfd_target_list (void);
|
||
|
||
DESCRIPTION
|
||
Return a freshly malloced NULL-terminated
|
||
vector of the names of all the valid BFD targets. Do not
|
||
modify the names.
|
||
|
||
*/
|
||
|
||
const char **
|
||
bfd_target_list (void)
|
||
{
|
||
int vec_length = 0;
|
||
size_t amt;
|
||
const bfd_target * const *target;
|
||
const char **name_list, **name_ptr;
|
||
|
||
for (target = &bfd_target_vector[0]; *target != NULL; target++)
|
||
vec_length++;
|
||
|
||
amt = (vec_length + 1) * sizeof (char **);
|
||
name_ptr = name_list = (const char **) bfd_malloc (amt);
|
||
|
||
if (name_list == NULL)
|
||
return NULL;
|
||
|
||
for (target = &bfd_target_vector[0]; *target != NULL; target++)
|
||
if (target == &bfd_target_vector[0]
|
||
|| *target != bfd_target_vector[0])
|
||
*name_ptr++ = (*target)->name;
|
||
|
||
*name_ptr = NULL;
|
||
return name_list;
|
||
}
|
||
|
||
/*
|
||
FUNCTION
|
||
bfd_iterate_over_targets
|
||
|
||
SYNOPSIS
|
||
const bfd_target *bfd_iterate_over_targets
|
||
(int (*func) (const bfd_target *, void *),
|
||
void *data);
|
||
|
||
DESCRIPTION
|
||
Call @var{func} for each target in the list of BFD target
|
||
vectors, passing @var{data} to @var{func}. Stop iterating if
|
||
@var{func} returns a non-zero result, and return that target
|
||
vector. Return NULL if @var{func} always returns zero.
|
||
*/
|
||
|
||
const bfd_target *
|
||
bfd_iterate_over_targets (int (*func) (const bfd_target *, void *),
|
||
void *data)
|
||
{
|
||
const bfd_target *const *target;
|
||
|
||
for (target = bfd_target_vector; *target != NULL; ++target)
|
||
if (func (*target, data))
|
||
return *target;
|
||
|
||
return NULL;
|
||
}
|
||
|
||
/*
|
||
FUNCTION
|
||
bfd_flavour_name
|
||
|
||
SYNOPSIS
|
||
const char *bfd_flavour_name (enum bfd_flavour flavour);
|
||
|
||
DESCRIPTION
|
||
Return the string form of @var{flavour}.
|
||
*/
|
||
|
||
const char *
|
||
bfd_flavour_name (enum bfd_flavour flavour)
|
||
{
|
||
switch (flavour)
|
||
{
|
||
case bfd_target_unknown_flavour: return "unknown file format";
|
||
case bfd_target_aout_flavour: return "a.out";
|
||
case bfd_target_coff_flavour: return "COFF";
|
||
case bfd_target_ecoff_flavour: return "ECOFF";
|
||
case bfd_target_xcoff_flavour: return "XCOFF";
|
||
case bfd_target_elf_flavour: return "ELF";
|
||
case bfd_target_tekhex_flavour: return "Tekhex";
|
||
case bfd_target_srec_flavour: return "Srec";
|
||
case bfd_target_verilog_flavour: return "Verilog";
|
||
case bfd_target_ihex_flavour: return "Ihex";
|
||
case bfd_target_som_flavour: return "SOM";
|
||
case bfd_target_msdos_flavour: return "MSDOS";
|
||
case bfd_target_evax_flavour: return "Evax";
|
||
case bfd_target_mmo_flavour: return "mmo";
|
||
case bfd_target_mach_o_flavour: return "MACH_O";
|
||
case bfd_target_pef_flavour: return "PEF";
|
||
case bfd_target_pef_xlib_flavour: return "PEF_XLIB";
|
||
case bfd_target_sym_flavour: return "SYM";
|
||
/* There is no "default" case here so that -Wswitch (part of -Wall)
|
||
catches missing entries. */
|
||
}
|
||
|
||
abort ();
|
||
}
|