*** empty log message ***
[deliverable/binutils-gdb.git] / bfd / targets.c
index 70c69adc48cd491fb13afd8f82b501fe3511d06c..093490cf6871b1825b07d22eecc63feee79c85d0 100644 (file)
@@ -1,5 +1,7 @@
 /* Generic target-file-type support for the BFD library.
-   Copyright (C) 1990-1991 Free Software Foundation, Inc.
+   Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
+   2000, 2001, 2002
+   Free Software Foundation, Inc.
    Written by Cygnus Support.
 
 This file is part of BFD, the Binary File Descriptor library.
@@ -16,579 +18,1283 @@ 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., 675 Mass Ave, Cambridge, MA 02139, USA.  */
-
-/* $Id$ */
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
 
 #include "bfd.h"
 #include "sysdep.h"
 #include "libbfd.h"
-
-/*doc*
-@section Targets
-Each port of BFD to a different machine requries 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 @code{bfd_openr}, its format and target are
-unknown. BFD uses various mechanisms to determine how to interpret the
-file. The operations performed are:
-@itemize @bullet
-@item
-First a BFD is created by calling the internal routine
-@code{new_bfd}, then @code{bfd_find_target} is called with the target
-string supplied to @code{bfd_openr} and the new BFD pointer. 
-@item
-If a null target string was provided to
-@code{bfd_find_target}, it looks up the environment variable
-@code{GNUTARGET} and uses that as the target string. 
-@item
-If the target string is still NULL, or the target string
-is @code{default}, then the first item in the target vector is used as
-the target type. @xref{bfd_target}.
-@item
-Otherwise, the elements in the target vector are
-inspected one by one, until a match on target name is found. When
-found, that is used.
-@item 
-Otherwise the error @code{invalid_target} is returned to
-@code{bfd_openr}.
-@item 
-@code{bfd_openr} attempts to open the file using
-@code{bfd_open_file}, and returns the BFD.
-@end itemize
-Once the BFD has been opened and the target selected, the file format
-may be determined. This is done by calling @code{bfd_check_format} on
-the BFD with a suggested format. The routine returns @code{true} when
-the application guesses right.
-
+#include "fnmatch.h"
+
+/*
+SECTION
+       Targets
+
+DESCRIPTION
+       Each port of BFD to a different machine requries 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::
+@* 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
+.
+       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!
+
+.enum bfd_flavour
+.{
+.  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_ieee_flavour,
+.  bfd_target_nlm_flavour,
+.  bfd_target_oasys_flavour,
+.  bfd_target_tekhex_flavour,
+.  bfd_target_srec_flavour,
+.  bfd_target_ihex_flavour,
+.  bfd_target_som_flavour,
+.  bfd_target_os9k_flavour,
+.  bfd_target_versados_flavour,
+.  bfd_target_msdos_flavour,
+.  bfd_target_ovax_flavour,
+.  bfd_target_evax_flavour,
+.  bfd_target_mmo_flavour
+.};
+.
+.enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
+.
+.{* Forward declaration.  *}
+.typedef struct bfd_link_info _bfd_link_info;
+.
+.typedef struct bfd_target
+.{
+.  {* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  *}
+.  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 short ar_max_namelen;
+.
+.  {* Entries for byte swapping for data. These are different from the
+.     other entry points, since they don't take a BFD asthe first argument.
+.     Certain other handlers could do the same.  *}
+.  bfd_vma        (*bfd_getx64) PARAMS ((const bfd_byte *));
+.  bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *));
+.  void           (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *));
+.  bfd_vma        (*bfd_getx32) PARAMS ((const bfd_byte *));
+.  bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *));
+.  void           (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *));
+.  bfd_vma        (*bfd_getx16) PARAMS ((const bfd_byte *));
+.  bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *));
+.  void           (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *));
+.
+.  {* Byte swapping for the headers.  *}
+.  bfd_vma        (*bfd_h_getx64) PARAMS ((const bfd_byte *));
+.  bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *));
+.  void           (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *));
+.  bfd_vma        (*bfd_h_getx32) PARAMS ((const bfd_byte *));
+.  bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *));
+.  void           (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *));
+.  bfd_vma        (*bfd_h_getx16) PARAMS ((const bfd_byte *));
+.  bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *));
+.  void           (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *));
+.
+.  {* 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_target *>> or zero.  *}
+.  const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *));
+.
+.  {* Set the format of a file being written.  *}
+.  boolean  (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
+.
+.  {* Write cached information into a file being written, at <<bfd_close>>.  *}
+.  boolean  (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *));
+.
+The general target vector.  These vectors are initialized using the
+BFD_JUMP_TABLE macros.
+.
+.  {* Generic entry points.  *}
+Do not "beautify" the CONCAT* macro args.  Traditional C will not
+remove whitespace added here, and thus will fail to concatenate
+the tokens.
+.#define BFD_JUMP_TABLE_GENERIC(NAME) \
+.CONCAT2 (NAME,_close_and_cleanup), \
+.CONCAT2 (NAME,_bfd_free_cached_info), \
+.CONCAT2 (NAME,_new_section_hook), \
+.CONCAT2 (NAME,_get_section_contents), \
+.CONCAT2 (NAME,_get_section_contents_in_window)
+.
+.  {* Called when the BFD is being closed to do any necessary cleanup.  *}
+.  boolean  (*_close_and_cleanup) PARAMS ((bfd *));
+.  {* Ask the BFD to free all cached information.  *}
+.  boolean  (*_bfd_free_cached_info) PARAMS ((bfd *));
+.  {* Called when a new section is created.  *}
+.  boolean  (*_new_section_hook) PARAMS ((bfd *, sec_ptr));
+.  {* Read the contents of a section.  *}
+.  boolean  (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
+.                                                 file_ptr, bfd_size_type));
+.  boolean  (*_bfd_get_section_contents_in_window)
+.    PARAMS ((bfd *, sec_ptr, bfd_window *, file_ptr, bfd_size_type));
+.
+.  {* Entry points to copy private data.  *}
+.#define BFD_JUMP_TABLE_COPY(NAME) \
+.CONCAT2 (NAME,_bfd_copy_private_bfd_data), \
+.CONCAT2 (NAME,_bfd_merge_private_bfd_data), \
+.CONCAT2 (NAME,_bfd_copy_private_section_data), \
+.CONCAT2 (NAME,_bfd_copy_private_symbol_data), \
+.CONCAT2 (NAME,_bfd_set_private_flags), \
+.CONCAT2 (NAME,_bfd_print_private_bfd_data) \
+.  {* Called to copy BFD general private data from one object file
+.     to another.  *}
+.  boolean  (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *));
+.  {* Called to merge BFD general private data from one object file
+.     to a common output file when linking.  *}
+.  boolean  (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *));
+.  {* Called to copy BFD private section data from one object file
+.     to another.  *}
+.  boolean  (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr,
+.                                                      bfd *, sec_ptr));
+.  {* Called to copy BFD private symbol data from one symbol
+.     to another.  *}
+.  boolean  (*_bfd_copy_private_symbol_data) PARAMS ((bfd *, asymbol *,
+.                                                     bfd *, asymbol *));
+.  {* Called to set private backend flags.  *}
+.  boolean  (*_bfd_set_private_flags) PARAMS ((bfd *, flagword));
+.
+.  {* Called to print private BFD data.  *}
+.  boolean  (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR));
+.
+.  {* Core file entry points.  *}
+.#define BFD_JUMP_TABLE_CORE(NAME) \
+.CONCAT2 (NAME,_core_file_failing_command), \
+.CONCAT2 (NAME,_core_file_failing_signal), \
+.CONCAT2 (NAME,_core_file_matches_executable_p)
+.  char *   (*_core_file_failing_command) PARAMS ((bfd *));
+.  int      (*_core_file_failing_signal) PARAMS ((bfd *));
+.  boolean  (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *));
+.
+.  {* Archive entry points.  *}
+.#define BFD_JUMP_TABLE_ARCHIVE(NAME) \
+.CONCAT2 (NAME,_slurp_armap), \
+.CONCAT2 (NAME,_slurp_extended_name_table), \
+.CONCAT2 (NAME,_construct_extended_name_table), \
+.CONCAT2 (NAME,_truncate_arname), \
+.CONCAT2 (NAME,_write_armap), \
+.CONCAT2 (NAME,_read_ar_hdr), \
+.CONCAT2 (NAME,_openr_next_archived_file), \
+.CONCAT2 (NAME,_get_elt_at_index), \
+.CONCAT2 (NAME,_generic_stat_arch_elt), \
+.CONCAT2 (NAME,_update_armap_timestamp)
+.  boolean  (*_bfd_slurp_armap) PARAMS ((bfd *));
+.  boolean  (*_bfd_slurp_extended_name_table) PARAMS ((bfd *));
+.  boolean  (*_bfd_construct_extended_name_table)
+.    PARAMS ((bfd *, char **, bfd_size_type *, const char **));
+.  void     (*_bfd_truncate_arname) PARAMS ((bfd *, const char *, char *));
+.  boolean  (*write_armap)
+.    PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int));
+.  PTR      (*_bfd_read_ar_hdr_fn) PARAMS ((bfd *));
+.  bfd *    (*openr_next_archived_file) PARAMS ((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) PARAMS ((bfd *, symindex));
+.  int      (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *));
+.  boolean  (*_bfd_update_armap_timestamp) PARAMS ((bfd *));
+.
+.  {* Entry points used for symbols.  *}
+.#define BFD_JUMP_TABLE_SYMBOLS(NAME) \
+.CONCAT2 (NAME,_get_symtab_upper_bound), \
+.CONCAT2 (NAME,_get_symtab), \
+.CONCAT2 (NAME,_make_empty_symbol), \
+.CONCAT2 (NAME,_print_symbol), \
+.CONCAT2 (NAME,_get_symbol_info), \
+.CONCAT2 (NAME,_bfd_is_local_label_name), \
+.CONCAT2 (NAME,_get_lineno), \
+.CONCAT2 (NAME,_find_nearest_line), \
+.CONCAT2 (NAME,_bfd_make_debug_symbol), \
+.CONCAT2 (NAME,_read_minisymbols), \
+.CONCAT2 (NAME,_minisymbol_to_symbol)
+.  long     (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *));
+.  long     (*_bfd_canonicalize_symtab) PARAMS ((bfd *,
+.                                                struct symbol_cache_entry **));
+.  struct symbol_cache_entry *
+.           (*_bfd_make_empty_symbol) PARAMS ((bfd *));
+.  void     (*_bfd_print_symbol) PARAMS ((bfd *, PTR,
+.                                         struct symbol_cache_entry *,
+.                                         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) PARAMS ((bfd *,
+.                                            struct symbol_cache_entry *,
+.                                            symbol_info *));
+.#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e))
+.  boolean  (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *));
+.
+.  alent *  (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *));
+.  boolean  (*_bfd_find_nearest_line)
+.    PARAMS ((bfd *, struct sec *, struct symbol_cache_entry **, bfd_vma,
+.             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) PARAMS ((bfd *, void *,
+.                                              unsigned long size));
+.#define bfd_read_minisymbols(b, d, m, s) \
+.  BFD_SEND (b, _read_minisymbols, (b, d, m, s))
+.  long     (*_read_minisymbols) PARAMS ((bfd *, boolean, PTR *,
+.                                         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) PARAMS ((bfd *, boolean, const PTR,
+.                                             asymbol *));
+.
+.  {* Routines for relocs.  *}
+.#define BFD_JUMP_TABLE_RELOCS(NAME) \
+.CONCAT2 (NAME,_get_reloc_upper_bound), \
+.CONCAT2 (NAME,_canonicalize_reloc), \
+.CONCAT2 (NAME,_bfd_reloc_type_lookup)
+.  long     (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr));
+.  long     (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **,
+.                                               struct symbol_cache_entry **));
+.  {* See documentation on reloc types.  *}
+.  reloc_howto_type *
+.           (*reloc_type_lookup) PARAMS ((bfd *, bfd_reloc_code_real_type));
+.
+.  {* Routines used when writing an object file.  *}
+.#define BFD_JUMP_TABLE_WRITE(NAME) \
+.CONCAT2 (NAME,_set_arch_mach), \
+.CONCAT2 (NAME,_set_section_contents)
+.  boolean  (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture,
+.                                          unsigned long));
+.  boolean  (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
+.                                                 file_ptr, bfd_size_type));
+.
+.  {* Routines used by the linker.  *}
+.#define BFD_JUMP_TABLE_LINK(NAME) \
+.CONCAT2 (NAME,_sizeof_headers), \
+.CONCAT2 (NAME,_bfd_get_relocated_section_contents), \
+.CONCAT2 (NAME,_bfd_relax_section), \
+.CONCAT2 (NAME,_bfd_link_hash_table_create), \
+.CONCAT2 (NAME,_bfd_link_hash_table_free), \
+.CONCAT2 (NAME,_bfd_link_add_symbols), \
+.CONCAT2 (NAME,_bfd_link_just_syms), \
+.CONCAT2 (NAME,_bfd_final_link), \
+.CONCAT2 (NAME,_bfd_link_split_section), \
+.CONCAT2 (NAME,_bfd_gc_sections), \
+.CONCAT2 (NAME,_bfd_merge_sections), \
+.CONCAT2 (NAME,_bfd_discard_group)
+.  int      (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean));
+.  bfd_byte *(*_bfd_get_relocated_section_contents)
+.    PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *,
+.             bfd_byte *, boolean, struct symbol_cache_entry **));
+.
+.  boolean  (*_bfd_relax_section)
+.    PARAMS ((bfd *, struct sec *, struct bfd_link_info *, boolean *));
+.
+.  {* 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) PARAMS ((bfd *));
+.
+.  {* Release the memory associated with the linker hash table.  *}
+.  void (*_bfd_link_hash_table_free) PARAMS ((struct bfd_link_hash_table *));
+.
+.  {* Add symbols from this object file into the hash table.  *}
+.  boolean  (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *));
+.
+.  {* Indicate that we are only retrieving symbol values from this section.  *}
+.  void     (*_bfd_link_just_syms) PARAMS ((asection *, struct bfd_link_info *));
+.
+.  {* Do a link based on the link_order structures attached to each
+.     section of the BFD.  *}
+.  boolean  (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *));
+.
+.  {* Should this section be split up into smaller pieces during linking.  *}
+.  boolean  (*_bfd_link_split_section) PARAMS ((bfd *, struct sec *));
+.
+.  {* Remove sections that are not referenced from the output.  *}
+.  boolean  (*_bfd_gc_sections) PARAMS ((bfd *, struct bfd_link_info *));
+.
+.  {* Attempt to merge SEC_MERGE sections.  *}
+.  boolean  (*_bfd_merge_sections) PARAMS ((bfd *, struct bfd_link_info *));
+.
+.  {* Discard members of a group.  *}
+.  boolean  (*_bfd_discard_group) PARAMS ((bfd *, struct sec *));
+.
+.  {* Routines to handle dynamic symbols and relocs.  *}
+.#define BFD_JUMP_TABLE_DYNAMIC(NAME) \
+.CONCAT2 (NAME,_get_dynamic_symtab_upper_bound), \
+.CONCAT2 (NAME,_canonicalize_dynamic_symtab), \
+.CONCAT2 (NAME,_get_dynamic_reloc_upper_bound), \
+.CONCAT2 (NAME,_canonicalize_dynamic_reloc)
+.  {* Get the amount of memory required to hold the dynamic symbols.  *}
+.  long     (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *));
+.  {* Read in the dynamic symbols.  *}
+.  long     (*_bfd_canonicalize_dynamic_symtab)
+.    PARAMS ((bfd *, struct symbol_cache_entry **));
+.  {* Get the amount of memory required to hold the dynamic relocs.  *}
+.  long     (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *));
+.  {* Read in the dynamic relocs.  *}
+.  long     (*_bfd_canonicalize_dynamic_reloc)
+.    PARAMS ((bfd *, arelent **, struct symbol_cache_entry **));
+.
+
+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.  *}
+.  PTR backend_data;
+.
+.} bfd_target;
+.
+*/
 
-/*proto* bfd_target
-@node bfd_target,  , Targets, Targets
-@subsection bfd_target
-This structure contains everything that BFD knows about a target.
-It includes things like its byte order, name, what routines to call
-to do various operations, etc.   
-
-Every BFD points to a target structure with its "xvec" member. 
-
-
-Shortcut for declaring fields which are prototyped function pointers,
-while avoiding anguish on compilers that don't support protos.
-
-$#define SDEF(ret, name, arglist) \
-$                PROTO(ret,(*name),arglist)
-$#define SDEF_FMT(ret, name, arglist) \
-$                PROTO(ret,(*name[bfd_type_end]),arglist)
-
-These macros 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 "arglist" argument must be parenthesized; it
-contains all the arguments to the called function.
-
-$#define BFD_SEND(bfd, message, arglist) \
-$               ((*((bfd)->xvec->message)) arglist)
-
-For operations which index on the BFD format 
-
-$#define BFD_SEND_FMT(bfd, message, arglist) \
-$            (((bfd)->xvec->message[(int)((bfd)->format)]) arglist)
-
-This is the struct which defines the type of BFD this is.  The
-"xvec" member of the struct @code{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! 
-
-*+++
-
-$typedef struct bfd_target
-${
-
-identifies the kind of target, eg SunOS4, Ultrix, etc 
-
-$  char *name;
-
-The "flavour" of a back end is a general indication about the contents
-of a file.
-
-$  enum target_flavour {
-$    bfd_target_unknown_flavour,
-$    bfd_target_aout_flavour,
-$    bfd_target_coff_flavour,
-$    bfd_target_elf_flavour,
-$    bfd_target_ieee_flavour,
-$    bfd_target_oasys_flavour,
-$    bfd_target_srec_flavour} flavour;
-
-The order of bytes within the data area of a file.
-
-$  boolean byteorder_big_p;
-
-The order of bytes within the header parts of a file.
-
-$  boolean header_byteorder_big_p;
-
-This is a mask of all the flags which an executable may have set -
-from the set @code{NO_FLAGS}, @code{HAS_RELOC}, ...@code{D_PAGED}.
-
-$  flagword object_flags;       
-
-This is a mask of all the flags which a section may have set - from
-the set @code{SEC_NO_FLAGS}, @code{SEC_ALLOC}, ...@code{SET_NEVER_LOAD}.
-
-$  flagword section_flags;
-
-The pad character for filenames within an archive header.
-
-$  char ar_pad_char;            
-
-The maximum number of characters in an archive header.
-
-$ unsigned short ar_max_namelen;
-
-The minimum alignment restriction for any section.
-
-$  unsigned int align_power_min;
-
-Entries for byte swapping for data. These are different to the other
-entry points, since they don't take BFD as first arg.  Certain other handlers
-could do the same.
-
-$  SDEF (bfd_vma,      bfd_getx64, (bfd_byte *));
-$  SDEF (void,         bfd_putx64, (bfd_vma, bfd_byte *));
-$  SDEF (bfd_vma, bfd_getx32, (bfd_byte *));
-$  SDEF (void,         bfd_putx32, (bfd_vma, bfd_byte *));
-$  SDEF (bfd_vma, bfd_getx16, (bfd_byte *));
-$  SDEF (void,         bfd_putx16, (bfd_vma, bfd_byte *));
-
-Byte swapping for the headers
-
-$  SDEF (bfd_vma,   bfd_h_getx64, (bfd_byte *));
-$  SDEF (void,          bfd_h_putx64, (bfd_vma, bfd_byte *));
-$  SDEF (bfd_vma,  bfd_h_getx32, (bfd_byte *));
-$  SDEF (void,          bfd_h_putx32, (bfd_vma, bfd_byte *));
-$  SDEF (bfd_vma,  bfd_h_getx16, (bfd_byte *));
-$  SDEF (void,          bfd_h_putx16, (bfd_vma, bfd_byte *));
-
-Format dependent routines, these turn into vectors of entry points
-within the target vector structure; one for each format to check.
-
-Check the format of a file being read.  Return bfd_target * or zero. 
+/* 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 a29kcoff_big_vec;
+extern const bfd_target a_out_adobe_vec;
+extern const bfd_target aix5coff64_vec;
+extern const bfd_target aout0_big_vec;
+extern const bfd_target aout_arm_big_vec;
+extern const bfd_target aout_arm_little_vec;
+extern const bfd_target aout_mips_big_vec;
+extern const bfd_target aout_mips_little_vec;
+extern const bfd_target apollocoff_vec;
+extern const bfd_target arm_epoc_pe_big_vec;
+extern const bfd_target arm_epoc_pe_little_vec;
+extern const bfd_target arm_epoc_pei_big_vec;
+extern const bfd_target arm_epoc_pei_little_vec;
+extern const bfd_target armcoff_big_vec;
+extern const bfd_target armcoff_little_vec;
+extern const bfd_target armnetbsd_vec;
+extern const bfd_target armpe_big_vec;
+extern const bfd_target armpe_little_vec;
+extern const bfd_target armpei_big_vec;
+extern const bfd_target armpei_little_vec;
+extern const bfd_target b_out_vec_big_host;
+extern const bfd_target b_out_vec_little_host;
+extern const bfd_target bfd_efi_app_ia32_vec;
+extern const bfd_target bfd_efi_app_ia64_vec;
+extern const bfd_target bfd_elf32_avr_vec;
+extern const bfd_target bfd_elf32_big_generic_vec;
+extern const bfd_target bfd_elf32_bigarc_vec;
+extern const bfd_target bfd_elf32_bigarm_oabi_vec;
+extern const bfd_target bfd_elf32_bigarm_vec;
+extern const bfd_target bfd_elf32_bigarmqnx_vec;
+extern const bfd_target bfd_elf32_bigmips_vec;
+extern const bfd_target bfd_elf32_cris_vec;
+extern const bfd_target bfd_elf32_d10v_vec;
+extern const bfd_target bfd_elf32_d30v_vec;
+extern const bfd_target bfd_elf32_dlx_big_vec;
+extern const bfd_target bfd_elf32_fr30_vec;
+extern const bfd_target bfd_elf32_frv_vec;
+extern const bfd_target bfd_elf32_h8300_vec;
+extern const bfd_target bfd_elf32_hppa_linux_vec;
+extern const bfd_target bfd_elf32_hppa_vec;
+extern const bfd_target bfd_elf32_i370_vec;
+extern const bfd_target bfd_elf32_i386_vec;
+extern const bfd_target bfd_elf32_i386qnx_vec;
+extern const bfd_target bfd_elf32_i860_little_vec;
+extern const bfd_target bfd_elf32_i860_vec;
+extern const bfd_target bfd_elf32_i960_vec;
+extern const bfd_target bfd_elf32_ia64_big_vec;
+extern const bfd_target bfd_elf32_ia64_hpux_big_vec;
+extern const bfd_target bfd_elf32_ip2k_vec;
+extern const bfd_target bfd_elf32_little_generic_vec;
+extern const bfd_target bfd_elf32_littlearc_vec;
+extern const bfd_target bfd_elf32_littlearm_oabi_vec;
+extern const bfd_target bfd_elf32_littlearm_vec;
+extern const bfd_target bfd_elf32_littlearmqnx_vec;
+extern const bfd_target bfd_elf32_littlemips_vec;
+extern const bfd_target bfd_elf32_m32r_vec;
+extern const bfd_target bfd_elf32_m68hc11_vec;
+extern const bfd_target bfd_elf32_m68hc12_vec;
+extern const bfd_target bfd_elf32_m68k_vec;
+extern const bfd_target bfd_elf32_m88k_vec;
+extern const bfd_target bfd_elf32_mcore_big_vec;
+extern const bfd_target bfd_elf32_mcore_little_vec;
+extern const bfd_target bfd_elf32_mn10200_vec;
+extern const bfd_target bfd_elf32_mn10300_vec;
+extern const bfd_target bfd_elf32_nbigmips_vec;
+extern const bfd_target bfd_elf32_nlittlemips_vec;
+extern const bfd_target bfd_elf32_ntradbigmips_vec;
+extern const bfd_target bfd_elf32_ntradlittlemips_vec;
+extern const bfd_target bfd_elf32_openrisc_vec;
+extern const bfd_target bfd_elf32_or32_big_vec;
+extern const bfd_target bfd_elf32_pj_vec;
+extern const bfd_target bfd_elf32_pjl_vec;
+extern const bfd_target bfd_elf32_powerpc_vec;
+extern const bfd_target bfd_elf32_powerpcle_vec;
+extern const bfd_target bfd_elf32_powerpcleqnx_vec;
+extern const bfd_target bfd_elf32_powerpcqnx_vec;
+extern const bfd_target bfd_elf32_s390_vec;
+extern const bfd_target bfd_elf32_sh64_vec;
+extern const bfd_target bfd_elf32_sh64l_vec;
+extern const bfd_target bfd_elf32_sh64lnbsd_vec;
+extern const bfd_target bfd_elf32_sh64nbsd_vec;
+extern const bfd_target bfd_elf32_sh_vec;
+extern const bfd_target bfd_elf32_shblin_vec;
+extern const bfd_target bfd_elf32_shl_vec;
+extern const bfd_target bfd_elf32_shlin_vec;
+extern const bfd_target bfd_elf32_shlnbsd_vec;
+extern const bfd_target bfd_elf32_shlqnx_vec;
+extern const bfd_target bfd_elf32_shnbsd_vec;
+extern const bfd_target bfd_elf32_shqnx_vec;
+extern const bfd_target bfd_elf32_sparc_vec;
+extern const bfd_target bfd_elf32_tradbigmips_vec;
+extern const bfd_target bfd_elf32_tradlittlemips_vec;
+extern const bfd_target bfd_elf32_us_cris_vec;
+extern const bfd_target bfd_elf32_v850_vec;
+extern const bfd_target bfd_elf32_vax_vec;
+extern const bfd_target bfd_elf32_xstormy16_vec;
+extern const bfd_target bfd_elf64_alpha_vec;
+extern const bfd_target bfd_elf64_big_generic_vec;
+extern const bfd_target bfd_elf64_bigmips_vec;
+extern const bfd_target bfd_elf64_hppa_linux_vec;
+extern const bfd_target bfd_elf64_hppa_vec;
+extern const bfd_target bfd_elf64_ia64_aix_big_vec;
+extern const bfd_target bfd_elf64_ia64_aix_little_vec;
+extern const bfd_target bfd_elf64_ia64_big_vec;
+extern const bfd_target bfd_elf64_ia64_hpux_big_vec;
+extern const bfd_target bfd_elf64_ia64_little_vec;
+extern const bfd_target bfd_elf64_little_generic_vec;
+extern const bfd_target bfd_elf64_littlemips_vec;
+extern const bfd_target bfd_elf64_mmix_vec;
+extern const bfd_target bfd_elf64_powerpc_vec;
+extern const bfd_target bfd_elf64_powerpcle_vec;
+extern const bfd_target bfd_elf64_s390_vec;
+extern const bfd_target bfd_elf64_sh64_vec;
+extern const bfd_target bfd_elf64_sh64l_vec;
+extern const bfd_target bfd_elf64_sh64lnbsd_vec;
+extern const bfd_target bfd_elf64_sh64nbsd_vec;
+extern const bfd_target bfd_elf64_sparc_vec;
+extern const bfd_target bfd_elf64_tradbigmips_vec;
+extern const bfd_target bfd_elf64_tradlittlemips_vec;
+extern const bfd_target bfd_elf64_x86_64_vec;
+extern const bfd_target bfd_mmo_vec;
+extern const bfd_target bfd_powerpc_pe_vec;
+extern const bfd_target bfd_powerpc_pei_vec;
+extern const bfd_target bfd_powerpcle_pe_vec;
+extern const bfd_target bfd_powerpcle_pei_vec;
+extern const bfd_target cris_aout_vec;
+extern const bfd_target demo_64_vec;
+extern const bfd_target ecoff_big_vec;
+extern const bfd_target ecoff_biglittle_vec;
+extern const bfd_target ecoff_little_vec;
+extern const bfd_target ecoffalpha_little_vec;
+extern const bfd_target go32coff_vec;
+extern const bfd_target go32stubbedcoff_vec;
+extern const bfd_target h8300coff_vec;
+extern const bfd_target h8500coff_vec;
+extern const bfd_target host_aout_vec;
+extern const bfd_target hp300bsd_vec;
+extern const bfd_target hp300hpux_vec;
+extern const bfd_target i386aout_vec;
+extern const bfd_target i386bsd_vec;
+extern const bfd_target i386coff_vec;
+extern const bfd_target i386dynix_vec;
+extern const bfd_target i386freebsd_vec;
+extern const bfd_target i386linux_vec;
+extern const bfd_target i386lynx_aout_vec;
+extern const bfd_target i386lynx_coff_vec;
+extern const bfd_target i386mach3_vec;
+extern const bfd_target i386msdos_vec;
+extern const bfd_target i386netbsd_vec;
+extern const bfd_target i386os9k_vec;
+extern const bfd_target i386pe_vec;
+extern const bfd_target i386pei_vec;
+extern const bfd_target i860coff_vec;
+extern const bfd_target icoff_big_vec;
+extern const bfd_target icoff_little_vec;
+extern const bfd_target ieee_vec;
+extern const bfd_target m68k4knetbsd_vec;
+extern const bfd_target m68kaux_coff_vec;
+extern const bfd_target m68kcoff_vec;
+extern const bfd_target m68kcoffun_vec;
+extern const bfd_target m68klinux_vec;
+extern const bfd_target m68klynx_aout_vec;
+extern const bfd_target m68klynx_coff_vec;
+extern const bfd_target m68knetbsd_vec;
+extern const bfd_target m68ksysvcoff_vec;
+extern const bfd_target m88kbcs_vec;
+extern const bfd_target m88kmach3_vec;
+extern const bfd_target mcore_pe_big_vec;
+extern const bfd_target mcore_pe_little_vec;
+extern const bfd_target mcore_pei_big_vec;
+extern const bfd_target mcore_pei_little_vec;
+extern const bfd_target mipslpe_vec;
+extern const bfd_target mipslpei_vec;
+extern const bfd_target newsos3_vec;
+extern const bfd_target nlm32_alpha_vec;
+extern const bfd_target nlm32_i386_vec;
+extern const bfd_target nlm32_powerpc_vec;
+extern const bfd_target nlm32_sparc_vec;
+extern const bfd_target oasys_vec;
+extern const bfd_target or32coff_big_vec;
+extern const bfd_target pc532machaout_vec;
+extern const bfd_target pc532netbsd_vec;
+extern const bfd_target pdp11_aout_vec;
+extern const bfd_target pmac_xcoff_vec;
+extern const bfd_target ppcboot_vec;
+extern const bfd_target riscix_vec;
+extern const bfd_target rs6000coff64_vec;
+extern const bfd_target rs6000coff_vec;
+extern const bfd_target shcoff_small_vec;
+extern const bfd_target shcoff_vec;
+extern const bfd_target shlcoff_small_vec;
+extern const bfd_target shlcoff_vec;
+extern const bfd_target shlpe_vec;
+extern const bfd_target shlpei_vec;
+extern const bfd_target som_vec;
+extern const bfd_target sparccoff_vec;
+extern const bfd_target sparcle_aout_vec;
+extern const bfd_target sparclinux_vec;
+extern const bfd_target sparclynx_aout_vec;
+extern const bfd_target sparclynx_coff_vec;
+extern const bfd_target sparcnetbsd_vec;
+extern const bfd_target sunos_big_vec;
+extern const bfd_target tic30_aout_vec;
+extern const bfd_target tic30_coff_vec;
+extern const bfd_target tic54x_coff0_beh_vec;
+extern const bfd_target tic54x_coff0_vec;
+extern const bfd_target tic54x_coff1_beh_vec;
+extern const bfd_target tic54x_coff1_vec;
+extern const bfd_target tic54x_coff2_beh_vec;
+extern const bfd_target tic54x_coff2_vec;
+extern const bfd_target tic80coff_vec;
+extern const bfd_target vaxbsd_vec;
+extern const bfd_target vaxnetbsd_vec;
+extern const bfd_target vax1knetbsd_vec;
+extern const bfd_target versados_vec;
+extern const bfd_target vms_alpha_vec;
+extern const bfd_target vms_vax_vec;
+extern const bfd_target w65_vec;
+extern const bfd_target we32kcoff_vec;
+extern const bfd_target z8kcoff_vec;
+
+/* These are always included.  */
+extern const bfd_target srec_vec;
+extern const bfd_target symbolsrec_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 aix386_core_vec;
+extern const bfd_target cisco_core_big_vec;
+extern const bfd_target cisco_core_little_vec;
+extern const bfd_target hppabsd_core_vec;
+extern const bfd_target hpux_core_vec;
+extern const bfd_target irix_core_vec;
+extern const bfd_target netbsd_core_vec;
+extern const bfd_target osf_core_vec;
+extern const bfd_target ptrace_core_vec;
+extern const bfd_target sco5_core_vec;
+extern const bfd_target trad_core_vec;
+
+static const bfd_target * const _bfd_target_vector[] = {
 
-$  SDEF_FMT (struct bfd_target *, _bfd_check_format, (bfd *));
-
-Set the format of a file being written.  
-
-$  SDEF_FMT (boolean,            _bfd_set_format, (bfd *));
-
-Write cached information into a file being written, at bfd_close. 
-
-$  SDEF_FMT (boolean,            _bfd_write_contents, (bfd *));
-
-The following functions are defined in @code{JUMP_TABLE}. The idea is
-that the back end writer of @code{foo} names all the routines
-@code{foo_}@var{entry_point}, @code{JUMP_TABLE} will built the entries
-in this structure in the right order.
-
-Core file entry points
-
-$  SDEF (char *, _core_file_failing_command, (bfd *));
-$  SDEF (int,    _core_file_failing_signal, (bfd *));
-$  SDEF (boolean, _core_file_matches_executable_p, (bfd *, bfd *));
-
-Archive entry points
-
-$ SDEF (boolean, _bfd_slurp_armap, (bfd *));
-$ SDEF (boolean, _bfd_slurp_extended_name_table, (bfd *));
-$ SDEF (void,   _bfd_truncate_arname, (bfd *, CONST char *, char *));
-$ SDEF (boolean, write_armap, (bfd *arch, 
-$                              unsigned int elength,
-$                              struct orl *map,
-$                              unsigned int orl_count, 
-$                              int stridx));
-
-Standard stuff.
-
-$  SDEF (boolean, _close_and_cleanup, (bfd *));
-$  SDEF (boolean, _bfd_set_section_contents, (bfd *, sec_ptr, PTR,
-$                                            file_ptr, bfd_size_type));
-$  SDEF (boolean, _bfd_get_section_contents, (bfd *, sec_ptr, PTR, 
-$                                            file_ptr, bfd_size_type));
-$  SDEF (boolean, _new_section_hook, (bfd *, sec_ptr));
-
-Symbols and reloctions
-
-$ SDEF (unsigned int, _get_symtab_upper_bound, (bfd *));
-$  SDEF (unsigned int, _bfd_canonicalize_symtab,
-$           (bfd *, struct symbol_cache_entry **));
-$  SDEF (unsigned int, _get_reloc_upper_bound, (bfd *, sec_ptr));
-$  SDEF (unsigned int, _bfd_canonicalize_reloc, (bfd *, sec_ptr, arelent **,
-$                                               struct symbol_cache_entry**));
-$  SDEF (struct symbol_cache_entry  *, _bfd_make_empty_symbol, (bfd *));
-$  SDEF (void,     _bfd_print_symbol, (bfd *, PTR, struct symbol_cache_entry  *,
-$                                      bfd_print_symbol_type));
-$#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e))
-$  SDEF (alent *,   _get_lineno, (bfd *, struct symbol_cache_entry  *));
-$
-$  SDEF (boolean,   _bfd_set_arch_mach, (bfd *, enum bfd_architecture,
-$                                       unsigned long));
-$
-$  SDEF (bfd *,  openr_next_archived_file, (bfd *arch, bfd *prev));
-$  SDEF (boolean, _bfd_find_nearest_line,
-$        (bfd *abfd, struct sec  *section,
-$         struct symbol_cache_entry  **symbols,bfd_vma offset,
-$        CONST char **file, CONST char **func, unsigned int *line));
-$  SDEF (int,    _bfd_stat_arch_elt, (bfd *, struct stat *));
-$
-$  SDEF (int,    _bfd_sizeof_headers, (bfd *, boolean));
-$
-$  SDEF (void, _bfd_debug_info_start, (bfd *));
-$  SDEF (void, _bfd_debug_info_end, (bfd *));
-$  SDEF (void, _bfd_debug_info_accumulate, (bfd *, struct sec  *));
-
-Special entry points for gdb to swap in coff symbol table parts
-
-$  SDEF(void, _bfd_coff_swap_aux_in,(
-$       bfd            *abfd ,
-$       PTR             ext,
-$       int             type,
-$       int             class ,
-$       PTR             in));
-$
-$  SDEF(void, _bfd_coff_swap_sym_in,(
-$       bfd            *abfd ,
-$       PTR             ext,
-$       PTR             in));
-$
-$  SDEF(void, _bfd_coff_swap_lineno_in,  (
-$       bfd            *abfd,
-$       PTR            ext,
-$       PTR             in));
-$
-
-Special entry points for gas to swap coff parts
-
-$ SDEF(unsigned int, _bfd_coff_swap_aux_out,(
-$       bfd    *abfd,
-$       PTR    in,
-$       int            type,
-$       int            class,
-$       PTR            ext));
-$
-$ SDEF(unsigned int, _bfd_coff_swap_sym_out,(
-$      bfd      *abfd,
-$      PTR     in,
-$      PTR     ext));
-$
-$ SDEF(unsigned int, _bfd_coff_swap_lineno_out,(
-$              bfd     *abfd,
-$              PTR     in,
-$      PTR     ext));
-$
-$ SDEF(unsigned int, _bfd_coff_swap_reloc_out,(
-$              bfd     *abfd,
-$      PTR     src,
-$      PTR     dst));
-$
-$ SDEF(unsigned int, _bfd_coff_swap_filehdr_out,(
-$              bfd     *abfd,
-$      PTR     in,
-$      PTR     out));
-$
-$ SDEF(unsigned int, _bfd_coff_swap_aouthdr_out,(
-$              bfd     *abfd,
-$      PTR     in,
-$      PTR     out));
-$
-$ SDEF(unsigned int, _bfd_coff_swap_scnhdr_out,(
-$              bfd     *abfd,
-$              PTR     in,
-$      PTR     out));
-$
-$} bfd_target;
-
-*---
+#ifdef SELECT_VECS
 
-*/
+       SELECT_VECS,
 
-/* The default is to define a target_vector containing just the
-   DEFAULT_TARGET.  (This is to save space in the executables.)
-   You can override this by giving an explicit target_vector using
-   the SELECT_VECTOR macro.
-   Or define ALL_TARGETS macro to get all of the available targets. */
-   
-
-#if MINIMIZE && defined(DEFAULT_VECTOR) && !defined(SELECT_VECS)
-#ifdef TRAD_CORE
-#define SELECT_VECS &DEFAULT_VECTOR,&trad_core_vec
-#else
-#define SELECT_VECS &DEFAULT_VECTOR
-#endif
-#endif
-
-extern bfd_target ecoff_little_vec;
-extern bfd_target ecoff_big_vec;
-extern bfd_target sunos_big_vec;
-extern bfd_target demo_64_vec;
-extern bfd_target srec_vec;
-extern bfd_target b_out_vec_little_host;
-extern bfd_target b_out_vec_big_host;
-extern bfd_target icoff_little_vec;
-extern bfd_target icoff_big_vec;
-extern bfd_target elf_little_vec;
-extern bfd_target elf_big_vec;
-extern bfd_target ieee_vec;
-extern bfd_target oasys_vec;
-extern bfd_target m88kbcs_vec;
-extern bfd_target m68kcoff_vec;
-extern bfd_target i386coff_vec;
-extern bfd_target i386aout_vec;
-extern bfd_target a29kcoff_big_vec;
-extern bfd_target trad_core_vec;
-extern bfd_target rs6000coff_vec;
-extern bfd_target h8300coff_vec;
+#else /* not SELECT_VECS */
 
 #ifdef DEFAULT_VECTOR
-extern bfd_target DEFAULT_VECTOR;
+       &DEFAULT_VECTOR,
 #endif
-
-#ifdef SELECT_VECS
-
-bfd_target *target_vector[] = {
-SELECT_VECS,
-0
-
-};
-#else
-
-#ifdef GNU960
-#define ICOFF_LITTLE_VEC        icoff_little_vec
-#define ICOFF_BIG_VEC           icoff_big_vec
-#define B_OUT_VEC_LITTLE_HOST   b_out_vec_little_host
-#define B_OUT_VEC_BIG_HOST      b_out_vec_big_host
-#endif /* GNU960 */
-
-#ifndef RESTRICTED
-#define ECOFF_LITTLE_VEC        ecoff_little_vec
-#define ECOFF_BIG_VEC           ecoff_big_vec
-#define ICOFF_LITTLE_VEC        icoff_little_vec
-#define ICOFF_BIG_VEC           icoff_big_vec
-#define ELF_LITTLE_VEC         elf_little_vec
-#define ELF_BIG_VEC            elf_big_vec
-#define ZB_OUT_VEC_LITTLE_HOST  b_out_vec_little_host
-#define ZB_OUT_VEC_BIG_HOST     b_out_vec_big_host
-#define SUNOS_VEC_BIG_HOST      sunos_big_vec
-#define DEMO_64_VEC             demo_64_vec
-
-/* We have no oasys tools anymore, so we can't test any of this
-   anymore. If you want to test the stuff yourself, go ahead...
-   steve@cygnus.com */
+       /* This list is alphabetized to make it easy to compare
+          with other vector lists -- the decls above and
+          the case statement in configure.in.
+          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.  */
+       &a29kcoff_big_vec,
+       &a_out_adobe_vec,
+#ifdef BFD64
+       &aix5coff64_vec,
+#endif
+       &aout0_big_vec,
 #if 0
-#define OASYS_VEC               oasys_vec
+       /* We have no way of distinguishing these from other a.out variants */
+       &aout_arm_big_vec,
+       &aout_arm_little_vec,
+       /* No one seems to use this.  */
+       &aout_mips_big_vec,
 #endif
-
-#define IEEE_VEC                ieee_vec
-#define M88KBCS_VEC            m88kbcs_vec
-#define SREC_VEC                srec_vec
-#define M68KCOFF_VEC            m68kcoff_vec
-#define I386COFF_VEC            i386coff_vec
-#define        I386AOUT_VEC            i386aout_vec
-#define A29KCOFF_BIG_VEC       a29kcoff_big_vec
-#define RS6000COFF_VEC         rs6000coff_vec
-#define H8300COFF_VEC           h8300coff_vec
+       &aout_mips_little_vec,
+#if 0
+       &apollocoff_vec,
 #endif
-
-bfd_target *target_vector[] = {
-
-#ifdef DEFAULT_VECTOR
-        &DEFAULT_VECTOR,
+       &arm_epoc_pe_big_vec,
+       &arm_epoc_pe_little_vec,
+       &arm_epoc_pei_big_vec,
+       &arm_epoc_pei_little_vec,
+       &armcoff_big_vec,
+       &armcoff_little_vec,
+       &armnetbsd_vec,
+       &armpe_big_vec,
+       &armpe_little_vec,
+       &armpei_big_vec,
+       &armpei_little_vec,
+       &b_out_vec_big_host,
+       &b_out_vec_little_host,
+       &bfd_efi_app_ia32_vec,
+#ifdef BFD64
+       &bfd_efi_app_ia64_vec,
 #endif
-
-#ifdef  I386COFF_VEC
-        &I386COFF_VEC,
+       &bfd_elf32_avr_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.  */
+       &bfd_elf32_big_generic_vec,
+       &bfd_elf32_bigarc_vec,
+       &bfd_elf32_bigarm_oabi_vec,
+       &bfd_elf32_bigarm_vec,
+       &bfd_elf32_bigmips_vec,
+       &bfd_elf32_cris_vec,
+       &bfd_elf32_d10v_vec,
+       &bfd_elf32_d30v_vec,
+       &bfd_elf32_dlx_big_vec,
+       &bfd_elf32_fr30_vec,
+       &bfd_elf32_frv_vec,
+       &bfd_elf32_h8300_vec,
+       &bfd_elf32_hppa_linux_vec,
+       &bfd_elf32_hppa_vec,
+       &bfd_elf32_i370_vec,
+       &bfd_elf32_i386_vec,
+       &bfd_elf32_i386qnx_vec,
+       &bfd_elf32_i860_little_vec,
+       &bfd_elf32_i860_vec,
+       &bfd_elf32_i960_vec,
+#if 0
+       &bfd_elf32_ia64_big_vec,
 #endif
-
-#ifdef I386AOUT_VEC
-       &I386AOUT_VEC,
+       &bfd_elf32_ia64_hpux_big_vec,
+       &bfd_elf32_ip2k_vec,
+       &bfd_elf32_little_generic_vec,
+       &bfd_elf32_littlearc_vec,
+       &bfd_elf32_littlearm_oabi_vec,
+       &bfd_elf32_littlearm_vec,
+       &bfd_elf32_littlemips_vec,
+       &bfd_elf32_m32r_vec,
+       &bfd_elf32_m68hc11_vec,
+       &bfd_elf32_m68hc12_vec,
+       &bfd_elf32_m68k_vec,
+       &bfd_elf32_m88k_vec,
+       &bfd_elf32_mcore_big_vec,
+       &bfd_elf32_mcore_little_vec,
+       &bfd_elf32_mn10200_vec,
+       &bfd_elf32_mn10300_vec,
+#ifdef BFD64
+       &bfd_elf32_nbigmips_vec,
+       &bfd_elf32_nlittlemips_vec,
+       &bfd_elf32_ntradbigmips_vec,
+       &bfd_elf32_ntradlittlemips_vec,
 #endif
-
-#ifdef ECOFF_LITTLE_VEC
-        &ECOFF_LITTLE_VEC,
+       &bfd_elf32_openrisc_vec,
+       &bfd_elf32_or32_big_vec,
+       &bfd_elf32_pj_vec,
+       &bfd_elf32_pjl_vec,
+       &bfd_elf32_powerpc_vec,
+       &bfd_elf32_powerpcle_vec,
+       &bfd_elf32_powerpcleqnx_vec,
+       &bfd_elf32_powerpcqnx_vec,
+       &bfd_elf32_s390_vec,
+        &bfd_elf32_sh_vec,
+        &bfd_elf32_shblin_vec,
+        &bfd_elf32_shl_vec,
+        &bfd_elf32_shlin_vec,
+       &bfd_elf32_shlnbsd_vec,
+       &bfd_elf32_shnbsd_vec,
+#ifdef BFD64
+       &bfd_elf32_sh64_vec,
+       &bfd_elf32_sh64l_vec,
+       &bfd_elf32_sh64lnbsd_vec,
+       &bfd_elf32_sh64nbsd_vec,
 #endif
-
-#ifdef ECOFF_BIG_VEC
-        &ECOFF_BIG_VEC,
+       &bfd_elf32_sparc_vec,
+       &bfd_elf32_tradbigmips_vec,
+       &bfd_elf32_tradlittlemips_vec,
+       &bfd_elf32_us_cris_vec,
+       &bfd_elf32_v850_vec,
+       &bfd_elf32_vax_vec,
+       &bfd_elf32_xstormy16_vec,
+#ifdef BFD64
+       &bfd_elf64_alpha_vec,
+       &bfd_elf64_big_generic_vec,
+       &bfd_elf64_bigmips_vec,
+       &bfd_elf64_hppa_linux_vec,
+       &bfd_elf64_hppa_vec,
+       &bfd_elf64_ia64_aix_big_vec,
+       &bfd_elf64_ia64_aix_little_vec,
+       &bfd_elf64_ia64_big_vec,
+       &bfd_elf64_ia64_hpux_big_vec,
+       &bfd_elf64_ia64_little_vec,
+       &bfd_elf64_little_generic_vec,
+       &bfd_elf64_littlemips_vec,
+       &bfd_elf64_mmix_vec,
+       &bfd_elf64_powerpc_vec,
+       &bfd_elf64_powerpcle_vec,
+       &bfd_elf64_s390_vec,
+       &bfd_elf64_sh64_vec,
+       &bfd_elf64_sh64l_vec,
+       &bfd_elf64_sh64lnbsd_vec,
+       &bfd_elf64_sh64nbsd_vec,
+#if 0
+       &bfd_elf64_sparc_vec,
 #endif
-
-#ifdef IEEE_VEC
-        &IEEE_VEC,
+       &bfd_elf64_tradbigmips_vec,
+       &bfd_elf64_tradlittlemips_vec,
+       &bfd_elf64_x86_64_vec,
+       &bfd_mmo_vec, 
 #endif
-
-#ifdef OASYS_VEC
-        &OASYS_VEC,
+       &bfd_powerpc_pe_vec,
+       &bfd_powerpc_pei_vec,
+       &bfd_powerpcle_pe_vec,
+       &bfd_powerpcle_pei_vec,
+       &cris_aout_vec,
+#ifdef BFD64
+       &demo_64_vec,   /* Only compiled if host has long-long support */
 #endif
-
-#ifdef SUNOS_VEC_BIG_HOST
-        &SUNOS_VEC_BIG_HOST,
+       &ecoff_big_vec,
+       &ecoff_biglittle_vec,
+       &ecoff_little_vec,
+#ifdef BFD64
+       &ecoffalpha_little_vec,
 #endif
-
-#ifdef HOST_64_BIT
-#ifdef DEMO_64_VEC
-        &DEMO_64_VEC,
+       &go32coff_vec,
+       &go32stubbedcoff_vec,
+       &h8300coff_vec,
+       &h8500coff_vec,
+#if 0
+       /* Since a.out files lack decent magic numbers, no way to recognize
+          which kind of a.out file it is.  */
+       &host_aout_vec,
+       /* Clashes with sunos_big_vec magic no.  */
+       &hp300bsd_vec,
+#endif
+       &hp300hpux_vec,
+       &i386aout_vec,
+       &i386bsd_vec,
+       &i386coff_vec,
+#if 0
+       &i386dynix_vec,
 #endif
+       &i386freebsd_vec,
+#if 0
+       /* Since a.out files lack decent magic numbers, no way to recognize
+          which kind of a.out file it is.  */
+       &i386linux_vec,
 #endif
-
-#ifdef H300COFF_VEC
-       &h8300coff_vec,
+       &i386lynx_aout_vec,
+       &i386lynx_coff_vec,
+#if 0
+       /* No distinguishing features for Mach 3 executables.  */
+       &i386mach3_vec,
 #endif
-#ifdef M88KBCS_VEC
-        &M88KBCS_VEC,
+       &i386msdos_vec,
+       &i386netbsd_vec,
+       &i386os9k_vec,
+       &i386pe_vec,
+       &i386pei_vec,
+       &i860coff_vec,
+       &icoff_big_vec,
+       &icoff_little_vec,
+       &ieee_vec,
+#if 0
+       &m68k4knetbsd_vec,
+       &m68kaux_coff_vec,
 #endif
-
-#ifdef SREC_VEC
-        &SREC_VEC,
+       &m68kcoff_vec,
+       &m68kcoffun_vec,
+#if 0
+       /* Since a.out files lack decent magic numbers, no way to recognize
+          which kind of a.out file it is.  */
+       &m68klinux_vec,
 #endif
-        
-#ifdef ICOFF_LITTLE_VEC
-        &ICOFF_LITTLE_VEC,
+       &m68klynx_aout_vec,
+       &m68klynx_coff_vec,
+       &m68knetbsd_vec,
+       &m68ksysvcoff_vec,
+       &m88kbcs_vec,
+       &m88kmach3_vec,
+       &mcore_pe_big_vec,
+       &mcore_pe_little_vec,
+       &mcore_pei_big_vec,
+       &mcore_pei_little_vec,
+       &mipslpe_vec,
+       &mipslpei_vec,
+       &newsos3_vec,
+#ifdef BFD64
+       &nlm32_alpha_vec,
 #endif
-
-#ifdef ICOFF_BIG_VEC
-        &ICOFF_BIG_VEC,
+       &nlm32_i386_vec,
+       &nlm32_powerpc_vec,
+       &nlm32_sparc_vec,
+#if 0
+       /* We have no oasys tools anymore, so we can't test any of this
+          anymore. If you want to test the stuff yourself, go ahead...
+          steve@cygnus.com
+          Worse, since there is no magic number for archives, there
+          can be annoying target mis-matches.  */
+       &oasys_vec,
 #endif
+       /* Entry for the OpenRISC family.  */
+       &or32coff_big_vec,
 
-#ifdef ELF_LITTLE_VEC
-        &ELF_LITTLE_VEC,
+       &pc532machaout_vec,
+       &pc532netbsd_vec,
+       &pdp11_aout_vec,
+#if 0
+       /* This has the same magic number as RS/6000.  */
+       &pmac_xcoff_vec,
 #endif
-
-#ifdef ELF_BIG_VEC
-        &ELF_BIG_VEC,
+       &ppcboot_vec,
+#if 0
+       /* We have no way of distinguishing these from other a.out variants */
+       &riscix_vec,
 #endif
-
-#ifdef B_OUT_VEC_LITTLE_HOST
-        &B_OUT_VEC_LITTLE_HOST,
+#ifdef BFD64
+       &rs6000coff64_vec,
 #endif
-
-#ifdef B_OUT_VEC_BIG_HOST
-        &B_OUT_VEC_BIG_HOST,
+       &rs6000coff_vec,
+       &shcoff_small_vec,
+       &shcoff_vec,
+       &shlcoff_small_vec,
+       &shlcoff_vec,
+       &shlpe_vec,
+       &shlpei_vec,
+#if defined (HOST_HPPAHPUX) || defined (HOST_HPPABSD) || defined (HOST_HPPAOSF)
+       &som_vec,
 #endif
-
-#ifdef  M68KCOFF_VEC
-        &M68KCOFF_VEC,
+       &sparccoff_vec,
+       &sparcle_aout_vec,
+       &sparclinux_vec,
+       &sparclynx_aout_vec,
+       &sparclynx_coff_vec,
+       &sparcnetbsd_vec,
+       &sunos_big_vec,
+       &tic30_aout_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,
+       &tic80coff_vec,
+       &vaxbsd_vec,
+       &vaxnetbsd_vec,
+       &vax1knetbsd_vec,
+       &versados_vec,
+#ifdef BFD64
+       &vms_alpha_vec,
 #endif
-
-#ifdef A29KCOFF_BIG_VEC
-       &A29KCOFF_BIG_VEC,
+       &vms_vax_vec,
+       &w65_vec,
+       &we32kcoff_vec,
+       &z8kcoff_vec,
+#endif /* not SELECT_VECS */
+
+/* Always support S-records, for convenience.  */
+       &srec_vec,
+       &symbolsrec_vec,
+/* And tekhex */
+       &tekhex_vec,
+/* Likewise for binary output.  */
+       &binary_vec,
+/* Likewise for ihex.  */
+       &ihex_vec,
+
+/* Add any required traditional-core-file-handler.  */
+
+#ifdef AIX386_CORE
+       &aix386_core_vec,
 #endif
-
-#ifdef TRAD_CORE
-       &trad_core_vec,
+#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.  */
+       &cisco_core_big_vec,
+       &cisco_core_little_vec,
 #endif
-
-#ifdef  RS6000COFF_VEC
-       &RS6000COFF_VEC,
+#ifdef HPPABSD_CORE
+       &hppabsd_core_vec,
+#endif
+#ifdef HPUX_CORE
+       &hpux_core_vec,
+#endif
+#ifdef IRIX_CORE
+       &irix_core_vec,
+#endif
+#ifdef NETBSD_CORE
+       &netbsd_core_vec,
+#endif
+#ifdef OSF_CORE
+       &osf_core_vec,
+#endif
+#ifdef PTRACE_CORE
+       &ptrace_core_vec,
+#endif
+#ifdef SCO5_CORE
+       &sco5_core_vec,
+#endif
+#ifdef TRAD_CORE
+       &trad_core_vec,
 #endif
 
-        NULL, /* end of list marker */
+       NULL /* end of list marker */
 };
+const bfd_target * const *bfd_target_vector = _bfd_target_vector;
 
-#endif
-
-/* default_vector[0] contains either the address of the default vector,
+/* bfd_default_vector[0] contains either the address of the default vector,
    if there is one, or zero if there isn't.  */
 
-bfd_target *default_vector[] = {
+const bfd_target *bfd_default_vector[] = {
 #ifdef DEFAULT_VECTOR
-        &DEFAULT_VECTOR,
+       &DEFAULT_VECTOR,
 #endif
-        0,
+       NULL
+};
+
+/* 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 = sizeof (_bfd_target_vector)/sizeof (*_bfd_target_vector);
+\f
+/* 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 }
+};
+
+static const bfd_target *find_target PARAMS ((const char *));
+
+/* Find a target vector, given a name or configuration triplet.  */
+
+static const bfd_target *
+find_target (name)
+     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;
+         break;
+       }
+    }
+
+  bfd_set_error (bfd_error_invalid_target);
+  return NULL;
+}
 
+/*
+FUNCTION
+       bfd_set_default_target
 
+SYNOPSIS
+       boolean 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.
+*/
+
+boolean
+bfd_set_default_target (name)
+     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;
+}
 
-/*proto*
-*i bfd_find_target
-Returns a pointer to the transfer vector for the object target
-named target_name.  If target_name is NULL, chooses the one in the
-environment variable GNUTARGET; if that is null or not defined then
-the first entry in the target list is chosen.  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.  This causes
-@code{bfd_check_format} to loop over all the targets to find the one
-that matches the file being read.  
-*; PROTO(bfd_target *, bfd_find_target,(CONST char *, bfd *));
-*-*/
+/*
+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.  This causes <<bfd_check_format>> to loop over all the
+       targets to find the one that matches the file being read.
+*/
 
-bfd_target *
-DEFUN(bfd_find_target,(target_name, abfd),
-      CONST char *target_name AND
-      bfd *abfd)
+const bfd_target *
+bfd_find_target (target_name, abfd)
+     const char *target_name;
+     bfd *abfd;
 {
-  bfd_target **target;
-  extern char *getenv ();
-  CONST char *targname = (target_name ? target_name : 
-                         (CONST char *) getenv ("GNUTARGET"));
+  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")) {
-    abfd->target_defaulted = true;
-    return abfd->xvec = target_vector[0];
-  }
+  if (targname == NULL || strcmp (targname, "default") == 0)
+    {
+      abfd->target_defaulted = true;
+      if (bfd_default_vector[0] != NULL)
+       abfd->xvec = bfd_default_vector[0];
+      else
+       abfd->xvec = bfd_target_vector[0];
+      return abfd->xvec;
+    }
 
   abfd->target_defaulted = false;
 
-  for (target = &target_vector[0]; *target != NULL; target++) {
-    if (!strcmp (targname, (*target)->name))
-      return abfd->xvec = *target;
-  }
+  target = find_target (targname);
+  if (target == NULL)
+    return NULL;
 
-  bfd_error = invalid_target;
-  return NULL;
+  abfd->xvec = target;
+  return target;
 }
 
+/*
+FUNCTION
+       bfd_target_list
 
-/*proto*
-*i bfd_target_list
-This function returns a freshly malloced NULL-terminated vector of the
-names of all the valid BFD targets. Do not modify the names 
-*; PROTO(CONST char **,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 **
-DEFUN_VOID(bfd_target_list)
+*/
+
+const char **
+bfd_target_list ()
 {
   int vec_length= 0;
-  bfd_target **target;
-  CONST  char **name_list, **name_ptr;
+  bfd_size_type amt;
+#if defined (HOST_HPPAHPUX) && ! defined (__STDC__)
+  /* The native compiler on the HP9000/700 has a bug which causes it
+     to loop endlessly when compiling this file.  This avoids it.  */
+  volatile
+#endif
+  const bfd_target * const *target;
+  const  char **name_list, **name_ptr;
 
-  for (target = &target_vector[0]; *target != NULL; target++)
+  for (target = &bfd_target_vector[0]; *target != NULL; target++)
     vec_length++;
 
-  name_ptr = 
-    name_list = (CONST char **) zalloc ((vec_length + 1) * sizeof (char **));
+  amt = (vec_length + 1) * sizeof (char **);
+  name_ptr = name_list = (const char **) bfd_zmalloc (amt);
 
-  if (name_list == NULL) {
-    bfd_error = no_memory;
+  if (name_list == NULL)
     return NULL;
-  }
 
-  for (target = &target_vector[0]; *target != NULL; target++)
+  for (target = &bfd_target_vector[0]; *target != NULL; target++)
     *(name_ptr++) = (*target)->name;
 
   return name_list;
 }
+
+/*
+FUNCTION
+       bfd_seach_for_target
+
+SYNOPSIS
+       const bfd_target * bfd_search_for_target (int (* search_func) (const bfd_target *, void *), void *);
+
+DESCRIPTION
+       Return a pointer to the first transfer vector in the list of
+       transfer vectors maintained by BFD that produces a non-zero
+       result when passed to the function @var{search_func}.  The
+       parameter @var{data} is passed, unexamined, to the search
+       function.
+*/
+
+const bfd_target *
+bfd_search_for_target (search_func, data)
+     int (* search_func) PARAMS ((const bfd_target * target, void * data));
+     void * data;
+{
+  const bfd_target * const * target;
+
+  for (target = bfd_target_vector; * target != NULL; target ++)
+    if (search_func (* target, data))
+      return * target;
+
+  return NULL;
+}
This page took 0.039463 seconds and 4 git commands to generate.