You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
687 lines
29 KiB
HTML
687 lines
29 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<!-- This file documents the BFD library.
|
|
|
|
Copyright (C) 1991-2019 Free Software Foundation, Inc.
|
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the GNU Free Documentation License, Version 1.3 or
|
|
any later version published by the Free Software Foundation; with the
|
|
Invariant Sections being "GNU General Public License" and "Funding
|
|
Free Software", the Front-Cover texts being (a) (see below), and with
|
|
the Back-Cover Texts being (b) (see below). A copy of the license is
|
|
included in the section entitled "GNU Free Documentation License".
|
|
|
|
(a) The FSF's Front-Cover Text is:
|
|
|
|
A GNU Manual
|
|
|
|
(b) The FSF's Back-Cover Text is:
|
|
|
|
You have freedom to copy and modify this GNU Manual, like GNU
|
|
software. Copies published by the Free Software Foundation raise
|
|
funds for GNU development. -->
|
|
<!-- Created by GNU Texinfo 6.4, http://www.gnu.org/software/texinfo/ -->
|
|
<head>
|
|
<title>bfd_target (Untitled Document)</title>
|
|
|
|
<meta name="description" content="bfd_target (Untitled Document)">
|
|
<meta name="keywords" content="bfd_target (Untitled Document)">
|
|
<meta name="resource-type" content="document">
|
|
<meta name="distribution" content="global">
|
|
<meta name="Generator" content="makeinfo">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<link href="index.html#Top" rel="start" title="Top">
|
|
<link href="BFD-Index.html#BFD-Index" rel="index" title="BFD Index">
|
|
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
|
|
<link href="Targets.html#Targets" rel="up" title="Targets">
|
|
<link href="Architectures.html#Architectures" rel="next" title="Architectures">
|
|
<link href="Targets.html#Targets" rel="prev" title="Targets">
|
|
<style type="text/css">
|
|
<!--
|
|
a.summary-letter {text-decoration: none}
|
|
blockquote.indentedblock {margin-right: 0em}
|
|
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
|
|
blockquote.smallquotation {font-size: smaller}
|
|
div.display {margin-left: 3.2em}
|
|
div.example {margin-left: 3.2em}
|
|
div.lisp {margin-left: 3.2em}
|
|
div.smalldisplay {margin-left: 3.2em}
|
|
div.smallexample {margin-left: 3.2em}
|
|
div.smalllisp {margin-left: 3.2em}
|
|
kbd {font-style: oblique}
|
|
pre.display {font-family: inherit}
|
|
pre.format {font-family: inherit}
|
|
pre.menu-comment {font-family: serif}
|
|
pre.menu-preformatted {font-family: serif}
|
|
pre.smalldisplay {font-family: inherit; font-size: smaller}
|
|
pre.smallexample {font-size: smaller}
|
|
pre.smallformat {font-family: inherit; font-size: smaller}
|
|
pre.smalllisp {font-size: smaller}
|
|
span.nolinebreak {white-space: nowrap}
|
|
span.roman {font-family: initial; font-weight: normal}
|
|
span.sansserif {font-family: sans-serif; font-weight: normal}
|
|
ul.no-bullet {list-style: none}
|
|
-->
|
|
</style>
|
|
|
|
|
|
</head>
|
|
|
|
<body lang="en">
|
|
<a name="bfd_005ftarget"></a>
|
|
<div class="header">
|
|
<p>
|
|
Previous: <a href="Targets.html#Targets" accesskey="p" rel="prev">Targets</a>, Up: <a href="Targets.html#Targets" accesskey="u" rel="up">Targets</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="BFD-Index.html#BFD-Index" title="Index" rel="index">Index</a>]</p>
|
|
</div>
|
|
<hr>
|
|
|
|
<a name="bfd_005ftarget-1"></a>
|
|
<h4 class="subsection">2.12.1 bfd_target</h4>
|
|
|
|
|
|
<p><strong>Description</strong><br>
|
|
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.
|
|
</p>
|
|
<p>Every BFD points to a target structure with its <code>xvec</code>
|
|
member.
|
|
</p>
|
|
<p>The macros below are used to dispatch to functions through the
|
|
<code>bfd_target</code> vector. They are used in a number of macros further
|
|
down in <samp>bfd.h</samp>, and are also used when calling various
|
|
routines by hand inside the BFD implementation. The <var>arglist</var>
|
|
argument must be parenthesized; it contains all the arguments
|
|
to the called function.
|
|
</p>
|
|
<p>They make the documentation (more) unpleasant to read, so if
|
|
someone wants to fix this and not break the above, please do.
|
|
</p><div class="example">
|
|
<pre class="example">#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
|
|
</pre></div>
|
|
<p>For operations which index on the BFD format:
|
|
</p><div class="example">
|
|
<pre class="example">#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
|
|
|
|
</pre></div>
|
|
<p>This is the structure which defines the type of BFD this is. The
|
|
<code>xvec</code> member of the struct <code>bfd</code> itself points here. Each
|
|
module that implements access to a different target under BFD,
|
|
defines one of these.
|
|
</p>
|
|
<p>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!
|
|
</p><div class="example">
|
|
<pre class="example">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_os9k_flavour,
|
|
bfd_target_versados_flavour,
|
|
bfd_target_msdos_flavour,
|
|
bfd_target_ovax_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 declaration. */
|
|
typedef struct bfd_link_info _bfd_link_info;
|
|
|
|
/* Forward declaration. */
|
|
typedef struct flag_info flag_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 <code>BFD_NO_FLAGS</code>, <code>HAS_RELOC</code>, ...<code>D_PAGED</code>. */
|
|
flagword object_flags;
|
|
|
|
/* A mask of all the flags which a section may have set - from
|
|
the set <code>SEC_NO_FLAGS</code>, <code>SEC_ALLOC</code>, ...<code>SET_NEVER_LOAD</code>. */
|
|
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;
|
|
|
|
/* 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. */
|
|
bfd_uint64_t (*bfd_getx64) (const void *);
|
|
bfd_int64_t (*bfd_getx_signed_64) (const void *);
|
|
void (*bfd_putx64) (bfd_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. */
|
|
bfd_uint64_t (*bfd_h_getx64) (const void *);
|
|
bfd_int64_t (*bfd_h_getx_signed_64) (const void *);
|
|
void (*bfd_h_putx64) (bfd_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 <code>bfd_target *</code> or zero. */
|
|
const struct bfd_target *
|
|
(*_bfd_check_format[bfd_type_end]) (bfd *);
|
|
|
|
/* Set the format of a file being written. */
|
|
bfd_boolean (*_bfd_set_format[bfd_type_end]) (bfd *);
|
|
|
|
/* Write cached information into a file being written, at <code>bfd_close</code>. */
|
|
bfd_boolean (*_bfd_write_contents[bfd_type_end]) (bfd *);
|
|
|
|
</pre></div>
|
|
<p>The general target vector. These vectors are initialized using the
|
|
BFD_JUMP_TABLE macros.
|
|
</p><div class="example">
|
|
<pre class="example">
|
|
|
|
/* 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. */
|
|
bfd_boolean (*_close_and_cleanup) (bfd *);
|
|
/* Ask the BFD to free all cached information. */
|
|
bfd_boolean (*_bfd_free_cached_info) (bfd *);
|
|
/* Called when a new section is created. */
|
|
bfd_boolean (*_new_section_hook) (bfd *, sec_ptr);
|
|
/* Read the contents of a section. */
|
|
bfd_boolean (*_bfd_get_section_contents) (bfd *, sec_ptr, void *, file_ptr,
|
|
bfd_size_type);
|
|
bfd_boolean (*_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. */
|
|
bfd_boolean (*_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. */
|
|
bfd_boolean (*_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))
|
|
bfd_boolean (*_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. */
|
|
bfd_boolean (*_bfd_copy_private_section_data) (bfd *, sec_ptr, bfd *,
|
|
sec_ptr);
|
|
/* Called to copy BFD private symbol data from one symbol
|
|
to another. */
|
|
bfd_boolean (*_bfd_copy_private_symbol_data) (bfd *, asymbol *, bfd *,
|
|
asymbol *);
|
|
/* Called to copy BFD private header data from one object file
|
|
to another. */
|
|
bfd_boolean (*_bfd_copy_private_header_data) (bfd *, bfd *);
|
|
/* Called to set private backend flags. */
|
|
bfd_boolean (*_bfd_set_private_flags) (bfd *, flagword);
|
|
|
|
/* Called to print private BFD data. */
|
|
bfd_boolean (*_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 *);
|
|
bfd_boolean (*_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
|
|
|
|
bfd_boolean (*_bfd_slurp_armap) (bfd *);
|
|
bfd_boolean (*_bfd_slurp_extended_name_table) (bfd *);
|
|
bfd_boolean (*_bfd_construct_extended_name_table) (bfd *, char **,
|
|
bfd_size_type *,
|
|
const char **);
|
|
void (*_bfd_truncate_arname) (bfd *, const char *, char *);
|
|
bfd_boolean (*write_armap) (bfd *, unsigned int, struct orl *,
|
|
unsigned int, int);
|
|
void * (*_bfd_read_ar_hdr_fn) (bfd *);
|
|
bfd_boolean (*_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 *);
|
|
bfd_boolean (*_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_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 *,
|
|
bfd_boolean *);
|
|
#define bfd_get_symbol_version_string(b,s,h) \
|
|
BFD_SEND (b, _bfd_get_symbol_version_string, (b,s,h))
|
|
bfd_boolean (*_bfd_is_local_label_name) (bfd *, const char *);
|
|
bfd_boolean (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
|
|
alent * (*_get_lineno) (bfd *, struct bfd_symbol *);
|
|
bfd_boolean (*_bfd_find_nearest_line) (bfd *, struct bfd_symbol **,
|
|
struct bfd_section *, bfd_vma,
|
|
const char **, const char **,
|
|
unsigned int *, unsigned int *);
|
|
bfd_boolean (*_bfd_find_line) (bfd *, struct bfd_symbol **,
|
|
struct bfd_symbol *, const char **,
|
|
unsigned int *);
|
|
bfd_boolean (*_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 *, void *, unsigned long size);
|
|
#define bfd_read_minisymbols(b, d, m, s) \
|
|
BFD_SEND (b, _read_minisymbols, (b, d, m, s))
|
|
long (*_read_minisymbols) (bfd *, bfd_boolean, 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 *, bfd_boolean, 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
|
|
|
|
bfd_boolean (*_bfd_set_arch_mach) (bfd *, enum bfd_architecture,
|
|
unsigned long);
|
|
bfd_boolean (*_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_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 *, bfd_boolean,
|
|
struct bfd_symbol **);
|
|
|
|
bfd_boolean (*_bfd_relax_section) (bfd *, struct bfd_section *,
|
|
struct bfd_link_info *, bfd_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) (bfd *);
|
|
|
|
/* Add symbols from this object file into the hash table. */
|
|
bfd_boolean (*_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. */
|
|
bfd_boolean (*_bfd_final_link) (bfd *, struct bfd_link_info *);
|
|
|
|
/* Should this section be split up into smaller pieces during linking. */
|
|
bfd_boolean (*_bfd_link_split_section) (bfd *, struct bfd_section *);
|
|
|
|
/* Check the relocations in the bfd for validity. */
|
|
bfd_boolean (* _bfd_link_check_relocs)(bfd *, struct bfd_link_info *);
|
|
|
|
/* Remove sections that are not referenced from the output. */
|
|
bfd_boolean (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
|
|
|
|
/* Sets the bitmask of allowed and disallowed section flags. */
|
|
bfd_boolean (*_bfd_lookup_section_flags) (struct bfd_link_info *,
|
|
struct flag_info *, asection *);
|
|
|
|
/* Attempt to merge SEC_MERGE sections. */
|
|
bfd_boolean (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
|
|
|
|
/* Is this section a member of a group? */
|
|
bfd_boolean (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
|
|
|
|
/* Discard members of a group. */
|
|
bfd_boolean (*_bfd_discard_group) (bfd *, struct bfd_section *);
|
|
|
|
/* Check if SEC has been already linked during a reloceatable or
|
|
final link. */
|
|
bfd_boolean (*_section_already_linked) (bfd *, asection *,
|
|
struct bfd_link_info *);
|
|
|
|
/* Define a common symbol. */
|
|
bfd_boolean (*_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 **);
|
|
|
|
</pre></div>
|
|
<p>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.
|
|
</p><div class="example">
|
|
<pre class="example"> /* 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;
|
|
|
|
</pre></div>
|
|
|
|
<a name="index-bfd_005fset_005fdefault_005ftarget"></a>
|
|
<a name="bfd_005fset_005fdefault_005ftarget"></a>
|
|
<h4 class="subsubsection">2.12.1.1 <code>bfd_set_default_target</code></h4>
|
|
<p><strong>Synopsis</strong>
|
|
</p><div class="example">
|
|
<pre class="example">bfd_boolean bfd_set_default_target (const char *name);
|
|
</pre></div>
|
|
<p><strong>Description</strong><br>
|
|
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.
|
|
</p>
|
|
<a name="index-bfd_005ffind_005ftarget"></a>
|
|
<a name="bfd_005ffind_005ftarget"></a>
|
|
<h4 class="subsubsection">2.12.1.2 <code>bfd_find_target</code></h4>
|
|
<p><strong>Synopsis</strong>
|
|
</p><div class="example">
|
|
<pre class="example">const bfd_target *bfd_find_target (const char *target_name, bfd *abfd);
|
|
</pre></div>
|
|
<p><strong>Description</strong><br>
|
|
Return a pointer to the transfer vector for the object target
|
|
named <var>target_name</var>. If <var>target_name</var> is <code>NULL</code>,
|
|
choose the one in the environment variable <code>GNUTARGET</code>; 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</var> isn’t <code>NULL</code>. This causes
|
|
<code>bfd_check_format</code> to loop over all the targets to find the
|
|
one that matches the file being read.
|
|
</p>
|
|
<a name="index-bfd_005fget_005ftarget_005finfo"></a>
|
|
<a name="bfd_005fget_005ftarget_005finfo"></a>
|
|
<h4 class="subsubsection">2.12.1.3 <code>bfd_get_target_info</code></h4>
|
|
<p><strong>Synopsis</strong>
|
|
</p><div class="example">
|
|
<pre class="example">const bfd_target *bfd_get_target_info (const char *target_name,
|
|
bfd *abfd,
|
|
bfd_boolean *is_bigendian,
|
|
int *underscoring,
|
|
const char **def_target_arch);
|
|
</pre></div>
|
|
<p><strong>Description</strong><br>
|
|
Return a pointer to the transfer vector for the object target
|
|
named <var>target_name</var>. If <var>target_name</var> is <code>NULL</code>,
|
|
choose the one in the environment variable <code>GNUTARGET</code>; 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</var> isn’t <code>NULL</code>. This causes
|
|
<code>bfd_check_format</code> to loop over all the targets to find the
|
|
one that matches the file being read.
|
|
If <var>is_bigendian</var> is not <code>NULL</code>, then set this value to target’s
|
|
endian mode. True for big-endian, FALSE for little-endian or for
|
|
invalid target.
|
|
If <var>underscoring</var> is not <code>NULL</code>, 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</var> is not <code>NULL</code>, then set it to the architecture
|
|
string specified by the target_name.
|
|
</p>
|
|
<a name="index-bfd_005ftarget_005flist"></a>
|
|
<a name="bfd_005ftarget_005flist"></a>
|
|
<h4 class="subsubsection">2.12.1.4 <code>bfd_target_list</code></h4>
|
|
<p><strong>Synopsis</strong>
|
|
</p><div class="example">
|
|
<pre class="example">const char ** bfd_target_list (void);
|
|
</pre></div>
|
|
<p><strong>Description</strong><br>
|
|
Return a freshly malloced NULL-terminated
|
|
vector of the names of all the valid BFD targets. Do not
|
|
modify the names.
|
|
</p>
|
|
<a name="index-bfd_005fiterate_005fover_005ftargets"></a>
|
|
<a name="bfd_005fiterate_005fover_005ftargets"></a>
|
|
<h4 class="subsubsection">2.12.1.5 <code>bfd_iterate_over_targets</code></h4>
|
|
<p><strong>Synopsis</strong>
|
|
</p><div class="example">
|
|
<pre class="example">const bfd_target *bfd_iterate_over_targets
|
|
(int (*func) (const bfd_target *, void *),
|
|
void *data);
|
|
</pre></div>
|
|
<p><strong>Description</strong><br>
|
|
Call <var>func</var> for each target in the list of BFD target
|
|
vectors, passing <var>data</var> to <var>func</var>. Stop iterating if
|
|
<var>func</var> returns a non-zero result, and return that target
|
|
vector. Return NULL if <var>func</var> always returns zero.
|
|
</p>
|
|
<a name="index-bfd_005fflavour_005fname"></a>
|
|
<a name="bfd_005fflavour_005fname"></a>
|
|
<h4 class="subsubsection">2.12.1.6 <code>bfd_flavour_name</code></h4>
|
|
<p><strong>Synopsis</strong>
|
|
</p><div class="example">
|
|
<pre class="example">const char *bfd_flavour_name (enum bfd_flavour flavour);
|
|
</pre></div>
|
|
<p><strong>Description</strong><br>
|
|
Return the string form of <var>flavour</var>.
|
|
</p>
|
|
|
|
<hr>
|
|
<div class="header">
|
|
<p>
|
|
Previous: <a href="Targets.html#Targets" accesskey="p" rel="prev">Targets</a>, Up: <a href="Targets.html#Targets" accesskey="u" rel="up">Targets</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="BFD-Index.html#BFD-Index" title="Index" rel="index">Index</a>]</p>
|
|
</div>
|
|
|
|
|
|
|
|
</body>
|
|
</html>
|