@section Targets
|
@section Targets
|
|
|
|
|
@strong{Description}@*
|
@strong{Description}@*
|
Each port of BFD to a different machine requries the creation
|
Each port of BFD to a different machine requries the creation
|
of a target back end. All the back end provides to the root
|
of a target back end. All the back end provides to the root
|
part of BFD is a structure containing pointers to functions
|
part of BFD is a structure containing pointers to functions
|
which perform certain low level operations on files. BFD
|
which perform certain low level operations on files. BFD
|
translates the applications's requests through a pointer into
|
translates the applications's requests through a pointer into
|
calls to the back end routines.
|
calls to the back end routines.
|
|
|
When a file is opened with @code{bfd_openr}, its format and
|
When a file is opened with @code{bfd_openr}, its format and
|
target are unknown. BFD uses various mechanisms to determine
|
target are unknown. BFD uses various mechanisms to determine
|
how to interpret the file. The operations performed are:
|
how to interpret the file. The operations performed are:
|
|
|
@itemize @bullet
|
@itemize @bullet
|
|
|
@item
|
@item
|
Create a BFD by calling the internal routine
|
Create a BFD by calling the internal routine
|
@code{_bfd_new_bfd}, then call @code{bfd_find_target} with the
|
@code{_bfd_new_bfd}, then call @code{bfd_find_target} with the
|
target string supplied to @code{bfd_openr} and the new BFD pointer.
|
target string supplied to @code{bfd_openr} and the new BFD pointer.
|
|
|
@item
|
@item
|
If a null target string was provided to @code{bfd_find_target},
|
If a null target string was provided to @code{bfd_find_target},
|
look up the environment variable @code{GNUTARGET} and use
|
look up the environment variable @code{GNUTARGET} and use
|
that as the target string.
|
that as the target string.
|
|
|
@item
|
@item
|
If the target string is still @code{NULL}, or the target string is
|
If the target string is still @code{NULL}, or the target string is
|
@code{default}, then use the first item in the target vector
|
@code{default}, then use the first item in the target vector
|
as the target type, and set @code{target_defaulted} in the BFD to
|
as the target type, and set @code{target_defaulted} in the BFD to
|
cause @code{bfd_check_format} to loop through all the targets.
|
cause @code{bfd_check_format} to loop through all the targets.
|
@xref{bfd_target}. @xref{Formats}.
|
@xref{bfd_target}. @xref{Formats}.
|
|
|
@item
|
@item
|
Otherwise, inspect the elements in the target vector
|
Otherwise, inspect the elements in the target vector
|
one by one, until a match on target name is found. When found,
|
one by one, until a match on target name is found. When found,
|
use it.
|
use it.
|
|
|
@item
|
@item
|
Otherwise return the error @code{bfd_error_invalid_target} to
|
Otherwise return the error @code{bfd_error_invalid_target} to
|
@code{bfd_openr}.
|
@code{bfd_openr}.
|
|
|
@item
|
@item
|
@code{bfd_openr} attempts to open the file using
|
@code{bfd_openr} attempts to open the file using
|
@code{bfd_open_file}, and returns the BFD.
|
@code{bfd_open_file}, and returns the BFD.
|
@end itemize
|
@end itemize
|
Once the BFD has been opened and the target selected, the file
|
Once the BFD has been opened and the target selected, the file
|
format may be determined. This is done by calling
|
format may be determined. This is done by calling
|
@code{bfd_check_format} on the BFD with a suggested format.
|
@code{bfd_check_format} on the BFD with a suggested format.
|
If @code{target_defaulted} has been set, each possible target
|
If @code{target_defaulted} has been set, each possible target
|
type is tried to see if it recognizes the specified format.
|
type is tried to see if it recognizes the specified format.
|
@code{bfd_check_format} returns @code{true} when the caller guesses right.
|
@code{bfd_check_format} returns @code{true} when the caller guesses right.
|
@menu
|
@menu
|
* bfd_target::
|
* bfd_target::
|
@end menu
|
@end menu
|
|
|
@node bfd_target, , Targets, Targets
|
@node bfd_target, , Targets, Targets
|
|
|
@subsection bfd_target
|
@subsection bfd_target
|
|
|
|
|
@strong{Description}@*
|
@strong{Description}@*
|
This structure contains everything that BFD knows about a
|
This structure contains everything that BFD knows about a
|
target. It includes things like its byte order, name, and which
|
target. It includes things like its byte order, name, and which
|
routines to call to do various operations.
|
routines to call to do various operations.
|
|
|
Every BFD points to a target structure with its @code{xvec}
|
Every BFD points to a target structure with its @code{xvec}
|
member.
|
member.
|
|
|
The macros below are used to dispatch to functions through the
|
The macros below are used to dispatch to functions through the
|
@code{bfd_target} vector. They are used in a number of macros further
|
@code{bfd_target} vector. They are used in a number of macros further
|
down in @file{bfd.h}, and are also used when calling various
|
down in @file{bfd.h}, and are also used when calling various
|
routines by hand inside the BFD implementation. The @var{arglist}
|
routines by hand inside the BFD implementation. The @var{arglist}
|
argument must be parenthesized; it contains all the arguments
|
argument must be parenthesized; it contains all the arguments
|
to the called function.
|
to the called function.
|
|
|
They make the documentation (more) unpleasant to read, so if
|
They make the documentation (more) unpleasant to read, so if
|
someone wants to fix this and not break the above, please do.
|
someone wants to fix this and not break the above, please do.
|
@example
|
@example
|
#define BFD_SEND(bfd, message, arglist) \
|
#define BFD_SEND(bfd, message, arglist) \
|
((*((bfd)->xvec->message)) arglist)
|
((*((bfd)->xvec->message)) arglist)
|
|
|
#ifdef DEBUG_BFD_SEND
|
#ifdef DEBUG_BFD_SEND
|
#undef BFD_SEND
|
#undef BFD_SEND
|
#define BFD_SEND(bfd, message, arglist) \
|
#define BFD_SEND(bfd, message, arglist) \
|
(((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
|
(((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
|
((*((bfd)->xvec->message)) arglist) : \
|
((*((bfd)->xvec->message)) arglist) : \
|
(bfd_assert (__FILE__,__LINE__), NULL))
|
(bfd_assert (__FILE__,__LINE__), NULL))
|
#endif
|
#endif
|
@end example
|
@end example
|
For operations which index on the BFD format:
|
For operations which index on the BFD format:
|
@example
|
@example
|
#define BFD_SEND_FMT(bfd, message, arglist) \
|
#define BFD_SEND_FMT(bfd, message, arglist) \
|
(((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
|
(((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
|
|
|
#ifdef DEBUG_BFD_SEND
|
#ifdef DEBUG_BFD_SEND
|
#undef BFD_SEND_FMT
|
#undef BFD_SEND_FMT
|
#define BFD_SEND_FMT(bfd, message, arglist) \
|
#define BFD_SEND_FMT(bfd, message, arglist) \
|
(((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
|
(((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
|
(((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
|
(((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
|
(bfd_assert (__FILE__,__LINE__), NULL))
|
(bfd_assert (__FILE__,__LINE__), NULL))
|
#endif
|
#endif
|
|
|
@end example
|
@end example
|
This is the structure which defines the type of BFD this is. The
|
This is the structure which defines the type of BFD this is. The
|
@code{xvec} member of the struct @code{bfd} itself points here. Each
|
@code{xvec} member of the struct @code{bfd} itself points here. Each
|
module that implements access to a different target under BFD,
|
module that implements access to a different target under BFD,
|
defines one of these.
|
defines one of these.
|
|
|
FIXME, these names should be rationalised with the names of
|
FIXME, these names should be rationalised with the names of
|
the entry points which call them. Too bad we can't have one
|
the entry points which call them. Too bad we can't have one
|
macro to define them both!
|
macro to define them both!
|
@example
|
@example
|
enum bfd_flavour
|
enum bfd_flavour
|
@{
|
@{
|
bfd_target_unknown_flavour,
|
bfd_target_unknown_flavour,
|
bfd_target_aout_flavour,
|
bfd_target_aout_flavour,
|
bfd_target_coff_flavour,
|
bfd_target_coff_flavour,
|
bfd_target_ecoff_flavour,
|
bfd_target_ecoff_flavour,
|
bfd_target_xcoff_flavour,
|
bfd_target_xcoff_flavour,
|
bfd_target_elf_flavour,
|
bfd_target_elf_flavour,
|
bfd_target_ieee_flavour,
|
bfd_target_ieee_flavour,
|
bfd_target_nlm_flavour,
|
bfd_target_nlm_flavour,
|
bfd_target_oasys_flavour,
|
bfd_target_oasys_flavour,
|
bfd_target_tekhex_flavour,
|
bfd_target_tekhex_flavour,
|
bfd_target_srec_flavour,
|
bfd_target_srec_flavour,
|
bfd_target_ihex_flavour,
|
bfd_target_ihex_flavour,
|
bfd_target_som_flavour,
|
bfd_target_som_flavour,
|
bfd_target_os9k_flavour,
|
bfd_target_os9k_flavour,
|
bfd_target_versados_flavour,
|
bfd_target_versados_flavour,
|
bfd_target_msdos_flavour,
|
bfd_target_msdos_flavour,
|
bfd_target_ovax_flavour,
|
bfd_target_ovax_flavour,
|
bfd_target_evax_flavour,
|
bfd_target_evax_flavour,
|
bfd_target_mmo_flavour
|
bfd_target_mmo_flavour
|
@};
|
@};
|
|
|
enum bfd_endian @{ BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN @};
|
enum bfd_endian @{ BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN @};
|
|
|
/* Forward declaration. */
|
/* Forward declaration. */
|
typedef struct bfd_link_info _bfd_link_info;
|
typedef struct bfd_link_info _bfd_link_info;
|
|
|
typedef struct bfd_target
|
typedef struct bfd_target
|
@{
|
@{
|
/* Identifies the kind of target, e.g., SunOS4, Ultrix, etc. */
|
/* Identifies the kind of target, e.g., SunOS4, Ultrix, etc. */
|
char *name;
|
char *name;
|
|
|
/* The "flavour" of a back end is a general indication about
|
/* The "flavour" of a back end is a general indication about
|
the contents of a file. */
|
the contents of a file. */
|
enum bfd_flavour flavour;
|
enum bfd_flavour flavour;
|
|
|
/* The order of bytes within the data area of a file. */
|
/* The order of bytes within the data area of a file. */
|
enum bfd_endian byteorder;
|
enum bfd_endian byteorder;
|
|
|
/* The order of bytes within the header parts of a file. */
|
/* The order of bytes within the header parts of a file. */
|
enum bfd_endian header_byteorder;
|
enum bfd_endian header_byteorder;
|
|
|
/* A mask of all the flags which an executable may have set -
|
/* A mask of all the flags which an executable may have set -
|
from the set @code{BFD_NO_FLAGS}, @code{HAS_RELOC}, ...@code{D_PAGED}. */
|
from the set @code{BFD_NO_FLAGS}, @code{HAS_RELOC}, ...@code{D_PAGED}. */
|
flagword object_flags;
|
flagword object_flags;
|
|
|
/* A mask of all the flags which a section may have set - from
|
/* 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}. */
|
the set @code{SEC_NO_FLAGS}, @code{SEC_ALLOC}, ...@code{SET_NEVER_LOAD}. */
|
flagword section_flags;
|
flagword section_flags;
|
|
|
/* The character normally found at the front of a symbol.
|
/* The character normally found at the front of a symbol.
|
(if any), perhaps `_'. */
|
(if any), perhaps `_'. */
|
char symbol_leading_char;
|
char symbol_leading_char;
|
|
|
/* The pad character for file names within an archive header. */
|
/* The pad character for file names within an archive header. */
|
char ar_pad_char;
|
char ar_pad_char;
|
|
|
/* The maximum number of characters in an archive header. */
|
/* The maximum number of characters in an archive header. */
|
unsigned short ar_max_namelen;
|
unsigned short ar_max_namelen;
|
|
|
/* Entries for byte swapping for data. These are different from the
|
/* Entries for byte swapping for data. These are different from the
|
other entry points, since they don't take a BFD asthe first argument.
|
other entry points, since they don't take a BFD asthe first argument.
|
Certain other handlers could do the same. */
|
Certain other handlers could do the same. */
|
bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *));
|
bfd_vma (*bfd_getx64) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *));
|
void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *));
|
void (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *));
|
bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *));
|
bfd_vma (*bfd_getx32) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *));
|
void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *));
|
void (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *));
|
bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *));
|
bfd_vma (*bfd_getx16) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *));
|
void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *));
|
void (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *));
|
|
|
/* Byte swapping for the headers. */
|
/* Byte swapping for the headers. */
|
bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *));
|
bfd_vma (*bfd_h_getx64) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_h_getx_signed_64) 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 *));
|
void (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *));
|
bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *));
|
bfd_vma (*bfd_h_getx32) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_h_getx_signed_32) 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 *));
|
void (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *));
|
bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *));
|
bfd_vma (*bfd_h_getx16) PARAMS ((const bfd_byte *));
|
bfd_signed_vma (*bfd_h_getx_signed_16) 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 *));
|
void (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *));
|
|
|
/* Format dependent routines: these are vectors of entry points
|
/* Format dependent routines: these are vectors of entry points
|
within the target vector structure, one for each format to check. */
|
within the target vector structure, one for each format to check. */
|
|
|
/* Check the format of a file being read. Return a @code{bfd_target *} or zero. */
|
/* Check the format of a file being read. Return a @code{bfd_target *} or zero. */
|
const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *));
|
const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *));
|
|
|
/* Set the format of a file being written. */
|
/* Set the format of a file being written. */
|
boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
|
boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
|
|
|
/* Write cached information into a file being written, at @code{bfd_close}. */
|
/* Write cached information into a file being written, at @code{bfd_close}. */
|
boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *));
|
boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *));
|
|
|
@end example
|
@end example
|
The general target vector. These vectors are initialized using the
|
The general target vector. These vectors are initialized using the
|
BFD_JUMP_TABLE macros.
|
BFD_JUMP_TABLE macros.
|
@example
|
@example
|
|
|
/* Generic entry points. */
|
/* Generic entry points. */
|
@end example
|
@end example
|
Do not "beautify" the CONCAT* macro args. Traditional C will not
|
Do not "beautify" the CONCAT* macro args. Traditional C will not
|
remove whitespace added here, and thus will fail to concatenate
|
remove whitespace added here, and thus will fail to concatenate
|
the tokens.
|
the tokens.
|
@example
|
@example
|
#define BFD_JUMP_TABLE_GENERIC(NAME) \
|
#define BFD_JUMP_TABLE_GENERIC(NAME) \
|
CONCAT2 (NAME,_close_and_cleanup), \
|
CONCAT2 (NAME,_close_and_cleanup), \
|
CONCAT2 (NAME,_bfd_free_cached_info), \
|
CONCAT2 (NAME,_bfd_free_cached_info), \
|
CONCAT2 (NAME,_new_section_hook), \
|
CONCAT2 (NAME,_new_section_hook), \
|
CONCAT2 (NAME,_get_section_contents), \
|
CONCAT2 (NAME,_get_section_contents), \
|
CONCAT2 (NAME,_get_section_contents_in_window)
|
CONCAT2 (NAME,_get_section_contents_in_window)
|
|
|
/* Called when the BFD is being closed to do any necessary cleanup. */
|
/* Called when the BFD is being closed to do any necessary cleanup. */
|
boolean (*_close_and_cleanup) PARAMS ((bfd *));
|
boolean (*_close_and_cleanup) PARAMS ((bfd *));
|
/* Ask the BFD to free all cached information. */
|
/* Ask the BFD to free all cached information. */
|
boolean (*_bfd_free_cached_info) PARAMS ((bfd *));
|
boolean (*_bfd_free_cached_info) PARAMS ((bfd *));
|
/* Called when a new section is created. */
|
/* Called when a new section is created. */
|
boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr));
|
boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr));
|
/* Read the contents of a section. */
|
/* Read the contents of a section. */
|
boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
|
boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
|
file_ptr, bfd_size_type));
|
file_ptr, bfd_size_type));
|
boolean (*_bfd_get_section_contents_in_window)
|
boolean (*_bfd_get_section_contents_in_window)
|
PARAMS ((bfd *, sec_ptr, bfd_window *, file_ptr, bfd_size_type));
|
PARAMS ((bfd *, sec_ptr, bfd_window *, file_ptr, bfd_size_type));
|
|
|
/* Entry points to copy private data. */
|
/* Entry points to copy private data. */
|
#define BFD_JUMP_TABLE_COPY(NAME) \
|
#define BFD_JUMP_TABLE_COPY(NAME) \
|
CONCAT2 (NAME,_bfd_copy_private_bfd_data), \
|
CONCAT2 (NAME,_bfd_copy_private_bfd_data), \
|
CONCAT2 (NAME,_bfd_merge_private_bfd_data), \
|
CONCAT2 (NAME,_bfd_merge_private_bfd_data), \
|
CONCAT2 (NAME,_bfd_copy_private_section_data), \
|
CONCAT2 (NAME,_bfd_copy_private_section_data), \
|
CONCAT2 (NAME,_bfd_copy_private_symbol_data), \
|
CONCAT2 (NAME,_bfd_copy_private_symbol_data), \
|
CONCAT2 (NAME,_bfd_set_private_flags), \
|
CONCAT2 (NAME,_bfd_set_private_flags), \
|
CONCAT2 (NAME,_bfd_print_private_bfd_data) \
|
CONCAT2 (NAME,_bfd_print_private_bfd_data) \
|
/* Called to copy BFD general private data from one object file
|
/* Called to copy BFD general private data from one object file
|
to another. */
|
to another. */
|
boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *));
|
boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *));
|
/* Called to merge BFD general private data from one object file
|
/* Called to merge BFD general private data from one object file
|
to a common output file when linking. */
|
to a common output file when linking. */
|
boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *));
|
boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *));
|
/* Called to copy BFD private section data from one object file
|
/* Called to copy BFD private section data from one object file
|
to another. */
|
to another. */
|
boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr,
|
boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr,
|
bfd *, sec_ptr));
|
bfd *, sec_ptr));
|
/* Called to copy BFD private symbol data from one symbol
|
/* Called to copy BFD private symbol data from one symbol
|
to another. */
|
to another. */
|
boolean (*_bfd_copy_private_symbol_data) PARAMS ((bfd *, asymbol *,
|
boolean (*_bfd_copy_private_symbol_data) PARAMS ((bfd *, asymbol *,
|
bfd *, asymbol *));
|
bfd *, asymbol *));
|
/* Called to set private backend flags. */
|
/* Called to set private backend flags. */
|
boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword));
|
boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword));
|
|
|
/* Called to print private BFD data. */
|
/* Called to print private BFD data. */
|
boolean (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR));
|
boolean (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR));
|
|
|
/* Core file entry points. */
|
/* Core file entry points. */
|
#define BFD_JUMP_TABLE_CORE(NAME) \
|
#define BFD_JUMP_TABLE_CORE(NAME) \
|
CONCAT2 (NAME,_core_file_failing_command), \
|
CONCAT2 (NAME,_core_file_failing_command), \
|
CONCAT2 (NAME,_core_file_failing_signal), \
|
CONCAT2 (NAME,_core_file_failing_signal), \
|
CONCAT2 (NAME,_core_file_matches_executable_p)
|
CONCAT2 (NAME,_core_file_matches_executable_p)
|
char * (*_core_file_failing_command) PARAMS ((bfd *));
|
char * (*_core_file_failing_command) PARAMS ((bfd *));
|
int (*_core_file_failing_signal) PARAMS ((bfd *));
|
int (*_core_file_failing_signal) PARAMS ((bfd *));
|
boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *));
|
boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *));
|
|
|
/* Archive entry points. */
|
/* Archive entry points. */
|
#define BFD_JUMP_TABLE_ARCHIVE(NAME) \
|
#define BFD_JUMP_TABLE_ARCHIVE(NAME) \
|
CONCAT2 (NAME,_slurp_armap), \
|
CONCAT2 (NAME,_slurp_armap), \
|
CONCAT2 (NAME,_slurp_extended_name_table), \
|
CONCAT2 (NAME,_slurp_extended_name_table), \
|
CONCAT2 (NAME,_construct_extended_name_table), \
|
CONCAT2 (NAME,_construct_extended_name_table), \
|
CONCAT2 (NAME,_truncate_arname), \
|
CONCAT2 (NAME,_truncate_arname), \
|
CONCAT2 (NAME,_write_armap), \
|
CONCAT2 (NAME,_write_armap), \
|
CONCAT2 (NAME,_read_ar_hdr), \
|
CONCAT2 (NAME,_read_ar_hdr), \
|
CONCAT2 (NAME,_openr_next_archived_file), \
|
CONCAT2 (NAME,_openr_next_archived_file), \
|
CONCAT2 (NAME,_get_elt_at_index), \
|
CONCAT2 (NAME,_get_elt_at_index), \
|
CONCAT2 (NAME,_generic_stat_arch_elt), \
|
CONCAT2 (NAME,_generic_stat_arch_elt), \
|
CONCAT2 (NAME,_update_armap_timestamp)
|
CONCAT2 (NAME,_update_armap_timestamp)
|
boolean (*_bfd_slurp_armap) PARAMS ((bfd *));
|
boolean (*_bfd_slurp_armap) PARAMS ((bfd *));
|
boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *));
|
boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *));
|
boolean (*_bfd_construct_extended_name_table)
|
boolean (*_bfd_construct_extended_name_table)
|
PARAMS ((bfd *, char **, bfd_size_type *, const char **));
|
PARAMS ((bfd *, char **, bfd_size_type *, const char **));
|
void (*_bfd_truncate_arname) PARAMS ((bfd *, const char *, char *));
|
void (*_bfd_truncate_arname) PARAMS ((bfd *, const char *, char *));
|
boolean (*write_armap)
|
boolean (*write_armap)
|
PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int));
|
PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int));
|
PTR (*_bfd_read_ar_hdr_fn) PARAMS ((bfd *));
|
PTR (*_bfd_read_ar_hdr_fn) PARAMS ((bfd *));
|
bfd * (*openr_next_archived_file) PARAMS ((bfd *, 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))
|
#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));
|
bfd * (*_bfd_get_elt_at_index) PARAMS ((bfd *, symindex));
|
int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *));
|
int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *));
|
boolean (*_bfd_update_armap_timestamp) PARAMS ((bfd *));
|
boolean (*_bfd_update_armap_timestamp) PARAMS ((bfd *));
|
|
|
/* Entry points used for symbols. */
|
/* Entry points used for symbols. */
|
#define BFD_JUMP_TABLE_SYMBOLS(NAME) \
|
#define BFD_JUMP_TABLE_SYMBOLS(NAME) \
|
CONCAT2 (NAME,_get_symtab_upper_bound), \
|
CONCAT2 (NAME,_get_symtab_upper_bound), \
|
CONCAT2 (NAME,_get_symtab), \
|
CONCAT2 (NAME,_get_symtab), \
|
CONCAT2 (NAME,_make_empty_symbol), \
|
CONCAT2 (NAME,_make_empty_symbol), \
|
CONCAT2 (NAME,_print_symbol), \
|
CONCAT2 (NAME,_print_symbol), \
|
CONCAT2 (NAME,_get_symbol_info), \
|
CONCAT2 (NAME,_get_symbol_info), \
|
CONCAT2 (NAME,_bfd_is_local_label_name), \
|
CONCAT2 (NAME,_bfd_is_local_label_name), \
|
CONCAT2 (NAME,_get_lineno), \
|
CONCAT2 (NAME,_get_lineno), \
|
CONCAT2 (NAME,_find_nearest_line), \
|
CONCAT2 (NAME,_find_nearest_line), \
|
CONCAT2 (NAME,_bfd_make_debug_symbol), \
|
CONCAT2 (NAME,_bfd_make_debug_symbol), \
|
CONCAT2 (NAME,_read_minisymbols), \
|
CONCAT2 (NAME,_read_minisymbols), \
|
CONCAT2 (NAME,_minisymbol_to_symbol)
|
CONCAT2 (NAME,_minisymbol_to_symbol)
|
long (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *));
|
long (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *));
|
long (*_bfd_canonicalize_symtab) PARAMS ((bfd *,
|
long (*_bfd_canonicalize_symtab) PARAMS ((bfd *,
|
struct symbol_cache_entry **));
|
struct symbol_cache_entry **));
|
struct symbol_cache_entry *
|
struct symbol_cache_entry *
|
(*_bfd_make_empty_symbol) PARAMS ((bfd *));
|
(*_bfd_make_empty_symbol) PARAMS ((bfd *));
|
void (*_bfd_print_symbol) PARAMS ((bfd *, PTR,
|
void (*_bfd_print_symbol) PARAMS ((bfd *, PTR,
|
struct symbol_cache_entry *,
|
struct symbol_cache_entry *,
|
bfd_print_symbol_type));
|
bfd_print_symbol_type));
|
#define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e))
|
#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 *,
|
void (*_bfd_get_symbol_info) PARAMS ((bfd *,
|
struct symbol_cache_entry *,
|
struct symbol_cache_entry *,
|
symbol_info *));
|
symbol_info *));
|
#define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e))
|
#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 *));
|
boolean (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *));
|
|
|
alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *));
|
alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *));
|
boolean (*_bfd_find_nearest_line)
|
boolean (*_bfd_find_nearest_line)
|
PARAMS ((bfd *, struct sec *, struct symbol_cache_entry **, bfd_vma,
|
PARAMS ((bfd *, struct sec *, struct symbol_cache_entry **, bfd_vma,
|
const char **, const char **, unsigned int *));
|
const char **, const char **, unsigned int *));
|
/* Back-door to allow format-aware applications to create debug symbols
|
/* Back-door to allow format-aware applications to create debug symbols
|
while using BFD for everything else. Currently used by the assembler
|
while using BFD for everything else. Currently used by the assembler
|
when creating COFF files. */
|
when creating COFF files. */
|
asymbol *(*_bfd_make_debug_symbol) PARAMS ((bfd *, void *,
|
asymbol *(*_bfd_make_debug_symbol) PARAMS ((bfd *, void *,
|
unsigned long size));
|
unsigned long size));
|
#define bfd_read_minisymbols(b, d, m, s) \
|
#define bfd_read_minisymbols(b, d, m, s) \
|
BFD_SEND (b, _read_minisymbols, (b, d, m, s))
|
BFD_SEND (b, _read_minisymbols, (b, d, m, s))
|
long (*_read_minisymbols) PARAMS ((bfd *, boolean, PTR *,
|
long (*_read_minisymbols) PARAMS ((bfd *, boolean, PTR *,
|
unsigned int *));
|
unsigned int *));
|
#define bfd_minisymbol_to_symbol(b, d, m, f) \
|
#define bfd_minisymbol_to_symbol(b, d, m, f) \
|
BFD_SEND (b, _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 *(*_minisymbol_to_symbol) PARAMS ((bfd *, boolean, const PTR,
|
asymbol *));
|
asymbol *));
|
|
|
/* Routines for relocs. */
|
/* Routines for relocs. */
|
#define BFD_JUMP_TABLE_RELOCS(NAME) \
|
#define BFD_JUMP_TABLE_RELOCS(NAME) \
|
CONCAT2 (NAME,_get_reloc_upper_bound), \
|
CONCAT2 (NAME,_get_reloc_upper_bound), \
|
CONCAT2 (NAME,_canonicalize_reloc), \
|
CONCAT2 (NAME,_canonicalize_reloc), \
|
CONCAT2 (NAME,_bfd_reloc_type_lookup)
|
CONCAT2 (NAME,_bfd_reloc_type_lookup)
|
long (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr));
|
long (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr));
|
long (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **,
|
long (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **,
|
struct symbol_cache_entry **));
|
struct symbol_cache_entry **));
|
/* See documentation on reloc types. */
|
/* See documentation on reloc types. */
|
reloc_howto_type *
|
reloc_howto_type *
|
(*reloc_type_lookup) PARAMS ((bfd *, bfd_reloc_code_real_type));
|
(*reloc_type_lookup) PARAMS ((bfd *, bfd_reloc_code_real_type));
|
|
|
/* Routines used when writing an object file. */
|
/* Routines used when writing an object file. */
|
#define BFD_JUMP_TABLE_WRITE(NAME) \
|
#define BFD_JUMP_TABLE_WRITE(NAME) \
|
CONCAT2 (NAME,_set_arch_mach), \
|
CONCAT2 (NAME,_set_arch_mach), \
|
CONCAT2 (NAME,_set_section_contents)
|
CONCAT2 (NAME,_set_section_contents)
|
boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture,
|
boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture,
|
unsigned long));
|
unsigned long));
|
boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
|
boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
|
file_ptr, bfd_size_type));
|
file_ptr, bfd_size_type));
|
|
|
/* Routines used by the linker. */
|
/* Routines used by the linker. */
|
#define BFD_JUMP_TABLE_LINK(NAME) \
|
#define BFD_JUMP_TABLE_LINK(NAME) \
|
CONCAT2 (NAME,_sizeof_headers), \
|
CONCAT2 (NAME,_sizeof_headers), \
|
CONCAT2 (NAME,_bfd_get_relocated_section_contents), \
|
CONCAT2 (NAME,_bfd_get_relocated_section_contents), \
|
CONCAT2 (NAME,_bfd_relax_section), \
|
CONCAT2 (NAME,_bfd_relax_section), \
|
CONCAT2 (NAME,_bfd_link_hash_table_create), \
|
CONCAT2 (NAME,_bfd_link_hash_table_create), \
|
CONCAT2 (NAME,_bfd_link_hash_table_free), \
|
CONCAT2 (NAME,_bfd_link_hash_table_free), \
|
CONCAT2 (NAME,_bfd_link_add_symbols), \
|
CONCAT2 (NAME,_bfd_link_add_symbols), \
|
CONCAT2 (NAME,_bfd_link_just_syms), \
|
CONCAT2 (NAME,_bfd_link_just_syms), \
|
CONCAT2 (NAME,_bfd_final_link), \
|
CONCAT2 (NAME,_bfd_final_link), \
|
CONCAT2 (NAME,_bfd_link_split_section), \
|
CONCAT2 (NAME,_bfd_link_split_section), \
|
CONCAT2 (NAME,_bfd_gc_sections), \
|
CONCAT2 (NAME,_bfd_gc_sections), \
|
CONCAT2 (NAME,_bfd_merge_sections), \
|
CONCAT2 (NAME,_bfd_merge_sections), \
|
CONCAT2 (NAME,_bfd_discard_group)
|
CONCAT2 (NAME,_bfd_discard_group)
|
int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean));
|
int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean));
|
bfd_byte *(*_bfd_get_relocated_section_contents)
|
bfd_byte *(*_bfd_get_relocated_section_contents)
|
PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *,
|
PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *,
|
bfd_byte *, boolean, struct symbol_cache_entry **));
|
bfd_byte *, boolean, struct symbol_cache_entry **));
|
|
|
boolean (*_bfd_relax_section)
|
boolean (*_bfd_relax_section)
|
PARAMS ((bfd *, struct sec *, struct bfd_link_info *, boolean *));
|
PARAMS ((bfd *, struct sec *, struct bfd_link_info *, boolean *));
|
|
|
/* Create a hash table for the linker. Different backends store
|
/* Create a hash table for the linker. Different backends store
|
different information in this table. */
|
different information in this table. */
|
struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *));
|
struct bfd_link_hash_table *(*_bfd_link_hash_table_create) PARAMS ((bfd *));
|
|
|
/* Release the memory associated with the linker hash table. */
|
/* Release the memory associated with the linker hash table. */
|
void (*_bfd_link_hash_table_free) PARAMS ((struct bfd_link_hash_table *));
|
void (*_bfd_link_hash_table_free) PARAMS ((struct bfd_link_hash_table *));
|
|
|
/* Add symbols from this object file into the hash table. */
|
/* Add symbols from this object file into the hash table. */
|
boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *));
|
boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, struct bfd_link_info *));
|
|
|
/* Indicate that we are only retrieving symbol values from this section. */
|
/* Indicate that we are only retrieving symbol values from this section. */
|
void (*_bfd_link_just_syms) PARAMS ((asection *, struct bfd_link_info *));
|
void (*_bfd_link_just_syms) PARAMS ((asection *, struct bfd_link_info *));
|
|
|
/* Do a link based on the link_order structures attached to each
|
/* Do a link based on the link_order structures attached to each
|
section of the BFD. */
|
section of the BFD. */
|
boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *));
|
boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *));
|
|
|
/* Should this section be split up into smaller pieces during linking. */
|
/* Should this section be split up into smaller pieces during linking. */
|
boolean (*_bfd_link_split_section) PARAMS ((bfd *, struct sec *));
|
boolean (*_bfd_link_split_section) PARAMS ((bfd *, struct sec *));
|
|
|
/* Remove sections that are not referenced from the output. */
|
/* Remove sections that are not referenced from the output. */
|
boolean (*_bfd_gc_sections) PARAMS ((bfd *, struct bfd_link_info *));
|
boolean (*_bfd_gc_sections) PARAMS ((bfd *, struct bfd_link_info *));
|
|
|
/* Attempt to merge SEC_MERGE sections. */
|
/* Attempt to merge SEC_MERGE sections. */
|
boolean (*_bfd_merge_sections) PARAMS ((bfd *, struct bfd_link_info *));
|
boolean (*_bfd_merge_sections) PARAMS ((bfd *, struct bfd_link_info *));
|
|
|
/* Discard members of a group. */
|
/* Discard members of a group. */
|
boolean (*_bfd_discard_group) PARAMS ((bfd *, struct sec *));
|
boolean (*_bfd_discard_group) PARAMS ((bfd *, struct sec *));
|
|
|
/* Routines to handle dynamic symbols and relocs. */
|
/* Routines to handle dynamic symbols and relocs. */
|
#define BFD_JUMP_TABLE_DYNAMIC(NAME) \
|
#define BFD_JUMP_TABLE_DYNAMIC(NAME) \
|
CONCAT2 (NAME,_get_dynamic_symtab_upper_bound), \
|
CONCAT2 (NAME,_get_dynamic_symtab_upper_bound), \
|
CONCAT2 (NAME,_canonicalize_dynamic_symtab), \
|
CONCAT2 (NAME,_canonicalize_dynamic_symtab), \
|
CONCAT2 (NAME,_get_dynamic_reloc_upper_bound), \
|
CONCAT2 (NAME,_get_dynamic_reloc_upper_bound), \
|
CONCAT2 (NAME,_canonicalize_dynamic_reloc)
|
CONCAT2 (NAME,_canonicalize_dynamic_reloc)
|
/* Get the amount of memory required to hold the dynamic symbols. */
|
/* Get the amount of memory required to hold the dynamic symbols. */
|
long (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *));
|
long (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *));
|
/* Read in the dynamic symbols. */
|
/* Read in the dynamic symbols. */
|
long (*_bfd_canonicalize_dynamic_symtab)
|
long (*_bfd_canonicalize_dynamic_symtab)
|
PARAMS ((bfd *, struct symbol_cache_entry **));
|
PARAMS ((bfd *, struct symbol_cache_entry **));
|
/* Get the amount of memory required to hold the dynamic relocs. */
|
/* Get the amount of memory required to hold the dynamic relocs. */
|
long (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *));
|
long (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *));
|
/* Read in the dynamic relocs. */
|
/* Read in the dynamic relocs. */
|
long (*_bfd_canonicalize_dynamic_reloc)
|
long (*_bfd_canonicalize_dynamic_reloc)
|
PARAMS ((bfd *, arelent **, struct symbol_cache_entry **));
|
PARAMS ((bfd *, arelent **, struct symbol_cache_entry **));
|
|
|
@end example
|
@end example
|
A pointer to an alternative bfd_target in case the current one is not
|
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
|
satisfactory. This can happen when the target cpu supports both big
|
and little endian code, and target chosen by the linker has the wrong
|
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
|
endianness. The function open_output() in ld/ldlang.c uses this field
|
to find an alternative output format that is suitable.
|
to find an alternative output format that is suitable.
|
@example
|
@example
|
/* Opposite endian version of this target. */
|
/* Opposite endian version of this target. */
|
const struct bfd_target * alternative_target;
|
const struct bfd_target * alternative_target;
|
|
|
/* Data for use by back-end routines, which isn't
|
/* Data for use by back-end routines, which isn't
|
generic enough to belong in this structure. */
|
generic enough to belong in this structure. */
|
PTR backend_data;
|
PTR backend_data;
|
|
|
@} bfd_target;
|
@} bfd_target;
|
|
|
@end example
|
@end example
|
|
|
@findex bfd_set_default_target
|
@findex bfd_set_default_target
|
@subsubsection @code{bfd_set_default_target}
|
@subsubsection @code{bfd_set_default_target}
|
@strong{Synopsis}
|
@strong{Synopsis}
|
@example
|
@example
|
boolean bfd_set_default_target (const char *name);
|
boolean bfd_set_default_target (const char *name);
|
@end example
|
@end example
|
@strong{Description}@*
|
@strong{Description}@*
|
Set the default target vector to use when recognizing a BFD.
|
Set the default target vector to use when recognizing a BFD.
|
This takes the name of the target, which may be a BFD target
|
This takes the name of the target, which may be a BFD target
|
name or a configuration triplet.
|
name or a configuration triplet.
|
|
|
@findex bfd_find_target
|
@findex bfd_find_target
|
@subsubsection @code{bfd_find_target}
|
@subsubsection @code{bfd_find_target}
|
@strong{Synopsis}
|
@strong{Synopsis}
|
@example
|
@example
|
const bfd_target *bfd_find_target(const char *target_name, bfd *abfd);
|
const bfd_target *bfd_find_target(const char *target_name, bfd *abfd);
|
@end example
|
@end example
|
@strong{Description}@*
|
@strong{Description}@*
|
Return a pointer to the transfer vector for the object target
|
Return a pointer to the transfer vector for the object target
|
named @var{target_name}. If @var{target_name} is @code{NULL}, choose the
|
named @var{target_name}. If @var{target_name} is @code{NULL}, choose the
|
one in the environment variable @code{GNUTARGET}; if that is null or not
|
one in the environment variable @code{GNUTARGET}; if that is null or not
|
defined, then choose the first entry in the target list.
|
defined, then choose the first entry in the target list.
|
Passing in the string "default" or setting the environment
|
Passing in the string "default" or setting the environment
|
variable to "default" will cause the first entry in the target
|
variable to "default" will cause the first entry in the target
|
list to be returned, and "target_defaulted" will be set in the
|
list to be returned, and "target_defaulted" will be set in the
|
BFD. This causes @code{bfd_check_format} to loop over all the
|
BFD. This causes @code{bfd_check_format} to loop over all the
|
targets to find the one that matches the file being read.
|
targets to find the one that matches the file being read.
|
|
|
@findex bfd_target_list
|
@findex bfd_target_list
|
@subsubsection @code{bfd_target_list}
|
@subsubsection @code{bfd_target_list}
|
@strong{Synopsis}
|
@strong{Synopsis}
|
@example
|
@example
|
const char **bfd_target_list(void);
|
const char **bfd_target_list(void);
|
@end example
|
@end example
|
@strong{Description}@*
|
@strong{Description}@*
|
Return a freshly malloced NULL-terminated
|
Return a freshly malloced NULL-terminated
|
vector of the names of all the valid BFD targets. Do not
|
vector of the names of all the valid BFD targets. Do not
|
modify the names.
|
modify the names.
|
|
|
@findex bfd_seach_for_target
|
@findex bfd_seach_for_target
|
@subsubsection @code{bfd_seach_for_target}
|
@subsubsection @code{bfd_seach_for_target}
|
@strong{Synopsis}
|
@strong{Synopsis}
|
@example
|
@example
|
const bfd_target * bfd_search_for_target (int (* search_func) (const bfd_target *, void *), void *);
|
const bfd_target * bfd_search_for_target (int (* search_func) (const bfd_target *, void *), void *);
|
@end example
|
@end example
|
@strong{Description}@*
|
@strong{Description}@*
|
Return a pointer to the first transfer vector in the list of
|
Return a pointer to the first transfer vector in the list of
|
transfer vectors maintained by BFD that produces a non-zero
|
transfer vectors maintained by BFD that produces a non-zero
|
result when passed to the function @var{search_func}. The
|
result when passed to the function @var{search_func}. The
|
parameter @var{data} is passed, unexamined, to the search
|
parameter @var{data} is passed, unexamined, to the search
|
function.
|
function.
|
|
|
|
|
