mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-27 19:23:33 +08:00
2074 lines
69 KiB
C
2074 lines
69 KiB
C
/* Main header file for the bfd library -- portable access to object files.
|
||
Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
|
||
Contributed by Cygnus Support.
|
||
|
||
** NOTE: bfd.h and bfd-in2.h are GENERATED files. Don't change them;
|
||
** instead, change bfd-in.h or the other BFD source files processed to
|
||
** generate these files.
|
||
|
||
This file is part of BFD, the Binary File Descriptor library.
|
||
|
||
This program is free software; you can redistribute it and/or modify
|
||
it under the terms of the GNU General Public License as published by
|
||
the Free Software Foundation; either version 2 of the License, or
|
||
(at your option) any later version.
|
||
|
||
This program is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
GNU General Public License for more details.
|
||
|
||
You should have received a copy of the GNU General Public License
|
||
along with this program; if not, write to the Free Software
|
||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
|
||
|
||
/* bfd.h -- The only header file required by users of the bfd library
|
||
|
||
The bfd.h file is generated from bfd-in.h and various .c files; if you
|
||
change it, your changes will probably be lost.
|
||
|
||
All the prototypes and definitions following the comment "THE FOLLOWING
|
||
IS EXTRACTED FROM THE SOURCE" are extracted from the source files for
|
||
BFD. If you change it, someone oneday will extract it from the source
|
||
again, and your changes will be lost. To save yourself from this bind,
|
||
change the definitions in the source in the bfd directory. Type "make
|
||
docs" and then "make headers" in that directory, and magically this file
|
||
will change to reflect your changes.
|
||
|
||
If you don't have the tools to perform the extraction, then you are
|
||
safe from someone on your system trampling over your header files.
|
||
You should still maintain the equivalence between the source and this
|
||
file though; every change you make to the .c file should be reflected
|
||
here. */
|
||
|
||
#ifndef __BFD_H_SEEN__
|
||
#define __BFD_H_SEEN__
|
||
|
||
#include "ansidecl.h"
|
||
#include "obstack.h"
|
||
|
||
#define BFD_VERSION "2.2"
|
||
|
||
#define BFD_ARCH_SIZE @WORDSIZE@
|
||
|
||
#if BFD_ARCH_SIZE >= 64
|
||
#define BFD64
|
||
#endif
|
||
|
||
#ifndef INLINE
|
||
#if __GNUC__ >= 2
|
||
#define INLINE __inline__
|
||
#else
|
||
#define INLINE
|
||
#endif
|
||
#endif
|
||
|
||
/* 64-bit type definition (if any) from bfd's sysdep.h goes here */
|
||
|
||
|
||
/* forward declaration */
|
||
typedef struct _bfd bfd;
|
||
|
||
/* To squelch erroneous compiler warnings ("illegal pointer
|
||
combination") from the SVR3 compiler, we would like to typedef
|
||
boolean to int (it doesn't like functions which return boolean.
|
||
Making sure they are never implicitly declared to return int
|
||
doesn't seem to help). But this file is not configured based on
|
||
the host. */
|
||
/* General rules: functions which are boolean return true on success
|
||
and false on failure (unless they're a predicate). -- bfd.doc */
|
||
/* I'm sure this is going to break something and someone is going to
|
||
force me to change it. */
|
||
/* typedef enum boolean {false, true} boolean; */
|
||
/* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h> -fnf */
|
||
/* It gets worse if the host also defines a true/false enum... -sts */
|
||
#ifndef TRUE_FALSE_ALREADY_DEFINED
|
||
typedef enum bfd_boolean {false, true} boolean;
|
||
#define BFD_TRUE_FALSE
|
||
#else
|
||
typedef enum bfd_boolean {bfd_false, bfd_true} boolean;
|
||
#endif
|
||
|
||
/* A pointer to a position in a file. */
|
||
/* FIXME: This should be using off_t from <sys/types.h>.
|
||
For now, try to avoid breaking stuff by not including <sys/types.h> here.
|
||
This will break on systems with 64-bit file offsets (e.g. 4.4BSD).
|
||
Probably the best long-term answer is to avoid using file_ptr AND off_t
|
||
in this header file, and to handle this in the BFD implementation
|
||
rather than in its interface. */
|
||
/* typedef off_t file_ptr; */
|
||
typedef long int file_ptr;
|
||
|
||
/* Support for different sizes of target format ints and addresses. If the
|
||
host implements 64-bit values, it defines HOST_64_BIT to be the appropriate
|
||
type. Otherwise, this code will fall back on gcc's "long long" type if gcc
|
||
is being used. HOST_64_BIT must be defined in such a way as to be a valid
|
||
type name by itself or with "unsigned" prefixed. It should be a signed
|
||
type by itself.
|
||
|
||
If neither is the case, then compilation will fail if 64-bit targets are
|
||
requested. If you don't request any 64-bit targets, you should be safe. */
|
||
|
||
#ifdef BFD64
|
||
|
||
#if defined (__GNUC__) && !defined (HOST_64_BIT)
|
||
#define HOST_64_BIT long long
|
||
typedef HOST_64_BIT int64_type;
|
||
typedef unsigned HOST_64_BIT uint64_type;
|
||
#endif
|
||
|
||
#if !defined (uint64_type) && defined (__GNUC__)
|
||
#define uint64_type unsigned long long
|
||
#define int64_type long long
|
||
#endif
|
||
#ifndef uint64_typeLOW
|
||
#define uint64_typeLOW(x) ((unsigned long)(((x) & 0xffffffff)))
|
||
#define uint64_typeHIGH(x) ((unsigned long)(((x) >> 32) & 0xffffffff))
|
||
#endif
|
||
|
||
typedef unsigned HOST_64_BIT bfd_vma;
|
||
typedef HOST_64_BIT bfd_signed_vma;
|
||
typedef unsigned HOST_64_BIT bfd_size_type;
|
||
typedef unsigned HOST_64_BIT symvalue;
|
||
#ifndef fprintf_vma
|
||
#define fprintf_vma(s,x) \
|
||
fprintf(s,"%08lx%08lx", uint64_typeHIGH(x), uint64_typeLOW(x))
|
||
#define sprintf_vma(s,x) \
|
||
sprintf(s,"%08lx%08lx", uint64_typeHIGH(x), uint64_typeLOW(x))
|
||
#endif
|
||
#else /* not BFD64 */
|
||
|
||
/* Represent a target address. Also used as a generic unsigned type
|
||
which is guaranteed to be big enough to hold any arithmetic types
|
||
we need to deal with. */
|
||
typedef unsigned long bfd_vma;
|
||
|
||
/* A generic signed type which is guaranteed to be big enough to hold any
|
||
arithmetic types we need to deal with. Can be assumed to be compatible
|
||
with bfd_vma in the same way that signed and unsigned ints are compatible
|
||
(as parameters, in assignment, etc). */
|
||
typedef long bfd_signed_vma;
|
||
|
||
typedef unsigned long symvalue;
|
||
typedef unsigned long bfd_size_type;
|
||
|
||
/* Print a bfd_vma x on stream s. */
|
||
#define fprintf_vma(s,x) fprintf(s, "%08lx", x)
|
||
#define sprintf_vma(s,x) sprintf(s, "%08lx", x)
|
||
#endif /* not BFD64 */
|
||
#define printf_vma(x) fprintf_vma(stdout,x)
|
||
|
||
typedef unsigned int flagword; /* 32 bits of flags */
|
||
|
||
/** File formats */
|
||
|
||
typedef enum bfd_format {
|
||
bfd_unknown = 0, /* file format is unknown */
|
||
bfd_object, /* linker/assember/compiler output */
|
||
bfd_archive, /* object archive file */
|
||
bfd_core, /* core dump */
|
||
bfd_type_end} /* marks the end; don't use it! */
|
||
bfd_format;
|
||
|
||
/* Values that may appear in the flags field of a BFD. These also
|
||
appear in the object_flags field of the bfd_target structure, where
|
||
they indicate the set of flags used by that backend (not all flags
|
||
are meaningful for all object file formats) (FIXME: at the moment,
|
||
the object_flags values have mostly just been copied from backend
|
||
to another, and are not necessarily correct). */
|
||
|
||
/* No flags. */
|
||
#define NO_FLAGS 0x00
|
||
|
||
/* BFD contains relocation entries. */
|
||
#define HAS_RELOC 0x01
|
||
|
||
/* BFD is directly executable. */
|
||
#define EXEC_P 0x02
|
||
|
||
/* BFD has line number information (basically used for F_LNNO in a
|
||
COFF header). */
|
||
#define HAS_LINENO 0x04
|
||
|
||
/* BFD has debugging information. */
|
||
#define HAS_DEBUG 0x08
|
||
|
||
/* BFD has symbols. */
|
||
#define HAS_SYMS 0x10
|
||
|
||
/* BFD has local symbols (basically used for F_LSYMS in a COFF
|
||
header). */
|
||
#define HAS_LOCALS 0x20
|
||
|
||
/* BFD is a dynamic object. */
|
||
#define DYNAMIC 0x40
|
||
|
||
/* Text section is write protected (if D_PAGED is not set, this is
|
||
like an a.out NMAGIC file) (the linker sets this by default, but
|
||
clears it for -r or -N). */
|
||
#define WP_TEXT 0x80
|
||
|
||
/* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
|
||
linker sets this by default, but clears it for -r or -n or -N). */
|
||
#define D_PAGED 0x100
|
||
|
||
/* BFD is relaxable (this means that bfd_relax_section may be able to
|
||
do something). */
|
||
#define BFD_IS_RELAXABLE 0x200
|
||
|
||
/* symbols and relocation */
|
||
|
||
typedef unsigned long symindex;
|
||
|
||
#define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
|
||
|
||
typedef enum bfd_symclass {
|
||
bfd_symclass_unknown = 0,
|
||
bfd_symclass_fcommon, /* fortran common symbols */
|
||
bfd_symclass_global, /* global symbol, what a surprise */
|
||
bfd_symclass_debugger, /* some debugger symbol */
|
||
bfd_symclass_undefined /* none known */
|
||
} symclass;
|
||
|
||
|
||
/* general purpose part of a symbol;
|
||
target specific parts will be found in libcoff.h, liba.out.h etc */
|
||
|
||
|
||
#define bfd_get_section(x) ((x)->section)
|
||
#define bfd_get_output_section(x) ((x)->section->output_section)
|
||
#define bfd_set_section(x,y) ((x)->section) = (y)
|
||
#define bfd_asymbol_base(x) ((x)->section->vma)
|
||
#define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value)
|
||
#define bfd_asymbol_name(x) ((x)->name)
|
||
/*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/
|
||
#define bfd_asymbol_bfd(x) ((x)->the_bfd)
|
||
#define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour)
|
||
|
||
/* This is a type pun with struct ranlib on purpose! */
|
||
typedef struct carsym {
|
||
char *name;
|
||
file_ptr file_offset; /* look here to find the file */
|
||
} carsym; /* to make these you call a carsymogen */
|
||
|
||
|
||
/* Used in generating armaps. Perhaps just a forward definition would do? */
|
||
struct orl { /* output ranlib */
|
||
char **name; /* symbol name */
|
||
file_ptr pos; /* bfd* or file position */
|
||
int namidx; /* index into string table */
|
||
};
|
||
|
||
|
||
|
||
/* Linenumber stuff */
|
||
typedef struct lineno_cache_entry {
|
||
unsigned int line_number; /* Linenumber from start of function*/
|
||
union {
|
||
struct symbol_cache_entry *sym; /* Function name */
|
||
unsigned long offset; /* Offset into section */
|
||
} u;
|
||
} alent;
|
||
|
||
/* object and core file sections */
|
||
|
||
|
||
#define align_power(addr, align) \
|
||
( ((addr) + ((1<<(align))-1)) & (-1 << (align)))
|
||
|
||
typedef struct sec *sec_ptr;
|
||
|
||
#define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
|
||
#define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
|
||
#define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
|
||
#define bfd_section_name(bfd, ptr) ((ptr)->name)
|
||
#define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr))
|
||
#define bfd_section_vma(bfd, ptr) ((ptr)->vma)
|
||
#define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
|
||
#define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
|
||
#define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
|
||
|
||
#define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0)
|
||
|
||
#define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma= (val)), ((ptr)->user_set_vma = true), true)
|
||
#define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true)
|
||
#define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true)
|
||
|
||
typedef struct stat stat_type;
|
||
|
||
/* Error handling */
|
||
|
||
typedef enum bfd_error
|
||
{
|
||
no_error = 0,
|
||
system_call_error,
|
||
invalid_target,
|
||
wrong_format,
|
||
invalid_operation,
|
||
no_memory,
|
||
no_symbols,
|
||
no_relocation_info,
|
||
no_more_archived_files,
|
||
malformed_archive,
|
||
symbol_not_found,
|
||
file_not_recognized,
|
||
file_ambiguously_recognized,
|
||
no_contents,
|
||
bfd_error_nonrepresentable_section,
|
||
no_debug_section,
|
||
bad_value,
|
||
file_truncated,
|
||
invalid_error_code
|
||
} bfd_ec;
|
||
|
||
extern bfd_ec bfd_error;
|
||
|
||
CONST char *bfd_errmsg PARAMS ((bfd_ec error_tag));
|
||
void bfd_perror PARAMS ((CONST char *message));
|
||
|
||
|
||
typedef enum bfd_print_symbol
|
||
{
|
||
bfd_print_symbol_name,
|
||
bfd_print_symbol_more,
|
||
bfd_print_symbol_all
|
||
} bfd_print_symbol_type;
|
||
|
||
|
||
/* Information about a symbol that nm needs. */
|
||
|
||
typedef struct _symbol_info
|
||
{
|
||
symvalue value;
|
||
char type; /* */
|
||
CONST char *name; /* Symbol name. */
|
||
char stab_other; /* Unused. */
|
||
short stab_desc; /* Info for N_TYPE. */
|
||
CONST char *stab_name;
|
||
} symbol_info;
|
||
|
||
/* Hash table routines. There is no way to free up a hash table. */
|
||
|
||
/* An element in the hash table. Most uses will actually use a larger
|
||
structure, and an instance of this will be the first field. */
|
||
|
||
struct bfd_hash_entry
|
||
{
|
||
/* Next entry for this hash code. */
|
||
struct bfd_hash_entry *next;
|
||
/* String being hashed. */
|
||
const char *string;
|
||
/* Hash code. This is the full hash code, not the index into the
|
||
table. */
|
||
unsigned long hash;
|
||
};
|
||
|
||
/* A hash table. */
|
||
|
||
struct bfd_hash_table
|
||
{
|
||
/* The hash array. */
|
||
struct bfd_hash_entry **table;
|
||
/* The number of slots in the hash table. */
|
||
unsigned int size;
|
||
/* A function used to create new elements in the hash table. The
|
||
first entry is itself a pointer to an element. When this
|
||
function is first invoked, this pointer will be NULL. However,
|
||
having the pointer permits a hierarchy of method functions to be
|
||
built each of which calls the function in the superclass. Thus
|
||
each function should be written to allocate a new block of memory
|
||
only if the argument is NULL. */
|
||
struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *,
|
||
struct bfd_hash_table *,
|
||
const char *));
|
||
/* An obstack for this hash table. */
|
||
struct obstack memory;
|
||
};
|
||
|
||
/* Initialize a hash table. */
|
||
extern boolean bfd_hash_table_init
|
||
PARAMS ((struct bfd_hash_table *,
|
||
struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
|
||
struct bfd_hash_table *,
|
||
const char *)));
|
||
|
||
/* Initialize a hash table specifying a size. */
|
||
extern boolean bfd_hash_table_init_n
|
||
PARAMS ((struct bfd_hash_table *,
|
||
struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
|
||
struct bfd_hash_table *,
|
||
const char *),
|
||
unsigned int size));
|
||
|
||
/* Free up a hash table. */
|
||
extern void bfd_hash_table_free PARAMS ((struct bfd_hash_table *));
|
||
|
||
/* Look up a string in a hash table. If CREATE is true, a new entry
|
||
will be created for this string if one does not already exist. The
|
||
COPY argument must be true if this routine should copy the string
|
||
into newly allocated memory when adding an entry. */
|
||
extern struct bfd_hash_entry *bfd_hash_lookup
|
||
PARAMS ((struct bfd_hash_table *, const char *, boolean create,
|
||
boolean copy));
|
||
|
||
/* Base method for creating a hash table entry. */
|
||
extern struct bfd_hash_entry *bfd_hash_newfunc
|
||
PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *,
|
||
const char *));
|
||
|
||
/* Grab some space for a hash table entry. */
|
||
extern PTR bfd_hash_allocate PARAMS ((struct bfd_hash_table *,
|
||
unsigned int));
|
||
|
||
/* Traverse a hash table in a random order, calling a function on each
|
||
element. If the function returns false, the traversal stops. The
|
||
INFO argument is passed to the function. */
|
||
extern void bfd_hash_traverse PARAMS ((struct bfd_hash_table *,
|
||
boolean (*) (struct bfd_hash_entry *,
|
||
PTR),
|
||
PTR info));
|
||
|
||
/* The code that implements targets can initialize a jump table with this
|
||
macro. It must name all its routines the same way (a prefix plus
|
||
the standard routine suffix), or it must #define the routines that
|
||
are not so named, before calling JUMP_TABLE in the initializer. */
|
||
|
||
/* Semi-portable string concatenation in cpp.
|
||
The CAT4 hack is to avoid a problem with some strict ANSI C preprocessors.
|
||
The problem is, "32_" is not a valid preprocessing token, and we don't
|
||
want extra underscores (e.g., "nlm_32_"). The XCAT2 macro will cause the
|
||
inner CAT macros to be evaluated first, producing still-valid pp-tokens.
|
||
Then the final concatenation can be done. (Sigh.) */
|
||
#ifndef CAT
|
||
#ifdef SABER
|
||
#define CAT(a,b) a##b
|
||
#define CAT3(a,b,c) a##b##c
|
||
#define CAT4(a,b,c,d) a##b##c##d
|
||
#else
|
||
#if defined(__STDC__) || defined(ALMOST_STDC)
|
||
#define CAT(a,b) a##b
|
||
#define CAT3(a,b,c) a##b##c
|
||
#define XCAT2(a,b) CAT(a,b)
|
||
#define CAT4(a,b,c,d) XCAT2(CAT(a,b),CAT(c,d))
|
||
#else
|
||
#define CAT(a,b) a/**/b
|
||
#define CAT3(a,b,c) a/**/b/**/c
|
||
#define CAT4(a,b,c,d) a/**/b/**/c/**/d
|
||
#endif
|
||
#endif
|
||
#endif
|
||
|
||
#define JUMP_TABLE(NAME)\
|
||
CAT(NAME,_core_file_failing_command),\
|
||
CAT(NAME,_core_file_failing_signal),\
|
||
CAT(NAME,_core_file_matches_executable_p),\
|
||
CAT(NAME,_slurp_armap),\
|
||
CAT(NAME,_slurp_extended_name_table),\
|
||
CAT(NAME,_truncate_arname),\
|
||
CAT(NAME,_write_armap),\
|
||
CAT(NAME,_close_and_cleanup),\
|
||
CAT(NAME,_set_section_contents),\
|
||
CAT(NAME,_get_section_contents),\
|
||
CAT(NAME,_new_section_hook),\
|
||
CAT(NAME,_get_symtab_upper_bound),\
|
||
CAT(NAME,_get_symtab),\
|
||
CAT(NAME,_get_reloc_upper_bound),\
|
||
CAT(NAME,_canonicalize_reloc),\
|
||
CAT(NAME,_make_empty_symbol),\
|
||
CAT(NAME,_print_symbol),\
|
||
CAT(NAME,_get_symbol_info),\
|
||
CAT(NAME,_get_lineno),\
|
||
CAT(NAME,_set_arch_mach),\
|
||
CAT(NAME,_openr_next_archived_file),\
|
||
CAT(NAME,_find_nearest_line),\
|
||
CAT(NAME,_generic_stat_arch_elt),\
|
||
CAT(NAME,_sizeof_headers),\
|
||
CAT(NAME,_bfd_debug_info_start),\
|
||
CAT(NAME,_bfd_debug_info_end),\
|
||
CAT(NAME,_bfd_debug_info_accumulate),\
|
||
CAT(NAME,_bfd_get_relocated_section_contents),\
|
||
CAT(NAME,_bfd_relax_section),\
|
||
CAT(NAME,_bfd_reloc_type_lookup),\
|
||
CAT(NAME,_bfd_make_debug_symbol),\
|
||
CAT(NAME,_bfd_link_hash_table_create),\
|
||
CAT(NAME,_bfd_link_add_symbols),\
|
||
CAT(NAME,_bfd_final_link)
|
||
|
||
#define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table
|
||
|
||
|
||
/* User program access to BFD facilities */
|
||
|
||
/* Cast from const char * to char * so that caller can assign to
|
||
a char * without a warning. */
|
||
#define bfd_get_filename(abfd) ((char *) (abfd)->filename)
|
||
#define bfd_get_cacheable(abfd) ((abfd)->cacheable)
|
||
#define bfd_get_format(abfd) ((abfd)->format)
|
||
#define bfd_get_target(abfd) ((abfd)->xvec->name)
|
||
#define bfd_get_flavour(abfd) ((abfd)->xvec->flavour)
|
||
#define bfd_get_file_flags(abfd) ((abfd)->flags)
|
||
#define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
|
||
#define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
|
||
#define bfd_my_archive(abfd) ((abfd)->my_archive)
|
||
#define bfd_has_map(abfd) ((abfd)->has_armap)
|
||
|
||
#define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
|
||
#define bfd_usrdata(abfd) ((abfd)->usrdata)
|
||
|
||
#define bfd_get_start_address(abfd) ((abfd)->start_address)
|
||
#define bfd_get_symcount(abfd) ((abfd)->symcount)
|
||
#define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
|
||
#define bfd_count_sections(abfd) ((abfd)->section_count)
|
||
|
||
#define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char)
|
||
|
||
#define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = (bool)), true)
|
||
|
||
/* Byte swapping routines. */
|
||
|
||
bfd_vma bfd_getb64 PARAMS ((const unsigned char *));
|
||
bfd_vma bfd_getl64 PARAMS ((const unsigned char *));
|
||
bfd_signed_vma bfd_getb_signed_64 PARAMS ((const unsigned char *));
|
||
bfd_signed_vma bfd_getl_signed_64 PARAMS ((const unsigned char *));
|
||
bfd_vma bfd_getb32 PARAMS ((const unsigned char *));
|
||
bfd_vma bfd_getl32 PARAMS ((const unsigned char *));
|
||
bfd_signed_vma bfd_getb_signed_32 PARAMS ((const unsigned char *));
|
||
bfd_signed_vma bfd_getl_signed_32 PARAMS ((const unsigned char *));
|
||
bfd_vma bfd_getb16 PARAMS ((const unsigned char *));
|
||
bfd_vma bfd_getl16 PARAMS ((const unsigned char *));
|
||
bfd_signed_vma bfd_getb_signed_16 PARAMS ((const unsigned char *));
|
||
bfd_signed_vma bfd_getl_signed_16 PARAMS ((const unsigned char *));
|
||
void bfd_putb64 PARAMS ((bfd_vma, unsigned char *));
|
||
void bfd_putl64 PARAMS ((bfd_vma, unsigned char *));
|
||
void bfd_putb32 PARAMS ((bfd_vma, unsigned char *));
|
||
void bfd_putl32 PARAMS ((bfd_vma, unsigned char *));
|
||
void bfd_putb16 PARAMS ((bfd_vma, unsigned char *));
|
||
void bfd_putl16 PARAMS ((bfd_vma, unsigned char *));
|
||
|
||
/* ECOFF linking routines. */
|
||
#if defined(__STDC__) || defined(ALMOST_STDC)
|
||
struct ecoff_debug_info;
|
||
struct ecoff_debug_swap;
|
||
struct ecoff_extr;
|
||
struct symbol_cache_entry;
|
||
struct bfd_link_info;
|
||
#endif
|
||
extern PTR bfd_ecoff_debug_init
|
||
PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
|
||
const struct ecoff_debug_swap *output_swap,
|
||
struct bfd_link_info *));
|
||
extern void bfd_ecoff_debug_free
|
||
PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
|
||
const struct ecoff_debug_swap *output_swap,
|
||
struct bfd_link_info *));
|
||
extern boolean bfd_ecoff_debug_accumulate
|
||
PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
|
||
const struct ecoff_debug_swap *output_swap,
|
||
bfd *input_bfd, struct ecoff_debug_info *input_debug,
|
||
const struct ecoff_debug_swap *input_swap,
|
||
struct bfd_link_info *));
|
||
extern boolean bfd_ecoff_debug_accumulate_other
|
||
PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
|
||
const struct ecoff_debug_swap *output_swap, bfd *input_bfd,
|
||
struct bfd_link_info *));
|
||
extern boolean bfd_ecoff_debug_externals
|
||
PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
|
||
const struct ecoff_debug_swap *swap,
|
||
boolean relocateable,
|
||
boolean (*get_extr) (struct symbol_cache_entry *,
|
||
struct ecoff_extr *),
|
||
void (*set_index) (struct symbol_cache_entry *,
|
||
bfd_size_type)));
|
||
extern boolean bfd_ecoff_debug_one_external
|
||
PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
|
||
const struct ecoff_debug_swap *swap,
|
||
const char *name, struct ecoff_extr *esym));
|
||
extern bfd_size_type bfd_ecoff_debug_size
|
||
PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
|
||
const struct ecoff_debug_swap *swap));
|
||
extern boolean bfd_ecoff_write_debug
|
||
PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
|
||
const struct ecoff_debug_swap *swap, file_ptr where));
|
||
extern boolean bfd_ecoff_write_accumulated_debug
|
||
PARAMS ((PTR handle, bfd *abfd, struct ecoff_debug_info *debug,
|
||
const struct ecoff_debug_swap *swap,
|
||
struct bfd_link_info *info, file_ptr where));
|
||
|
||
/* And more from the source. */
|
||
void
|
||
bfd_init PARAMS ((void));
|
||
|
||
bfd *
|
||
bfd_openr PARAMS ((CONST char *filename, CONST char *target));
|
||
|
||
bfd *
|
||
bfd_fdopenr PARAMS ((CONST char *filename, CONST char *target, int fd));
|
||
|
||
bfd *
|
||
bfd_openw PARAMS ((CONST char *filename, CONST char *target));
|
||
|
||
boolean
|
||
bfd_close PARAMS ((bfd *abfd));
|
||
|
||
boolean
|
||
bfd_close_all_done PARAMS ((bfd *));
|
||
|
||
bfd_size_type
|
||
bfd_alloc_size PARAMS ((bfd *abfd));
|
||
|
||
bfd *
|
||
bfd_create PARAMS ((CONST char *filename, bfd *templ));
|
||
|
||
|
||
/* Byte swapping macros for user section data. */
|
||
|
||
#define bfd_put_8(abfd, val, ptr) \
|
||
(*((unsigned char *)(ptr)) = (unsigned char)(val))
|
||
#define bfd_put_signed_8 \
|
||
bfd_put_8
|
||
#define bfd_get_8(abfd, ptr) \
|
||
(*(unsigned char *)(ptr))
|
||
#define bfd_get_signed_8(abfd, ptr) \
|
||
((*(unsigned char *)(ptr) ^ 0x80) - 0x80)
|
||
|
||
#define bfd_put_16(abfd, val, ptr) \
|
||
BFD_SEND(abfd, bfd_putx16, ((val),(ptr)))
|
||
#define bfd_put_signed_16 \
|
||
bfd_put_16
|
||
#define bfd_get_16(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_getx16, (ptr))
|
||
#define bfd_get_signed_16(abfd, ptr) \
|
||
BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
|
||
|
||
#define bfd_put_32(abfd, val, ptr) \
|
||
BFD_SEND(abfd, bfd_putx32, ((val),(ptr)))
|
||
#define bfd_put_signed_32 \
|
||
bfd_put_32
|
||
#define bfd_get_32(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_getx32, (ptr))
|
||
#define bfd_get_signed_32(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_getx_signed_32, (ptr))
|
||
|
||
#define bfd_put_64(abfd, val, ptr) \
|
||
BFD_SEND(abfd, bfd_putx64, ((val), (ptr)))
|
||
#define bfd_put_signed_64 \
|
||
bfd_put_64
|
||
#define bfd_get_64(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_getx64, (ptr))
|
||
#define bfd_get_signed_64(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_getx_signed_64, (ptr))
|
||
|
||
|
||
/* Byte swapping macros for file header data. */
|
||
|
||
#define bfd_h_put_8(abfd, val, ptr) \
|
||
bfd_put_8 (abfd, val, ptr)
|
||
#define bfd_h_put_signed_8(abfd, val, ptr) \
|
||
bfd_put_8 (abfd, val, ptr)
|
||
#define bfd_h_get_8(abfd, ptr) \
|
||
bfd_get_8 (abfd, ptr)
|
||
#define bfd_h_get_signed_8(abfd, ptr) \
|
||
bfd_get_signed_8 (abfd, ptr)
|
||
|
||
#define bfd_h_put_16(abfd, val, ptr) \
|
||
BFD_SEND(abfd, bfd_h_putx16,(val,ptr))
|
||
#define bfd_h_put_signed_16 \
|
||
bfd_h_put_16
|
||
#define bfd_h_get_16(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_h_getx16,(ptr))
|
||
#define bfd_h_get_signed_16(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_h_getx_signed_16, (ptr))
|
||
|
||
#define bfd_h_put_32(abfd, val, ptr) \
|
||
BFD_SEND(abfd, bfd_h_putx32,(val,ptr))
|
||
#define bfd_h_put_signed_32 \
|
||
bfd_h_put_32
|
||
#define bfd_h_get_32(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_h_getx32,(ptr))
|
||
#define bfd_h_get_signed_32(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_h_getx_signed_32, (ptr))
|
||
|
||
#define bfd_h_put_64(abfd, val, ptr) \
|
||
BFD_SEND(abfd, bfd_h_putx64,(val, ptr))
|
||
#define bfd_h_put_signed_64 \
|
||
bfd_h_put_64
|
||
#define bfd_h_get_64(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_h_getx64,(ptr))
|
||
#define bfd_h_get_signed_64(abfd, ptr) \
|
||
BFD_SEND(abfd, bfd_h_getx_signed_64, (ptr))
|
||
|
||
typedef struct sec
|
||
{
|
||
/* The name of the section; the name isn't a copy, the pointer is
|
||
the same as that passed to bfd_make_section. */
|
||
|
||
CONST char *name;
|
||
|
||
/* Which section is it; 0..nth. */
|
||
|
||
int index;
|
||
|
||
/* The next section in the list belonging to the BFD, or NULL. */
|
||
|
||
struct sec *next;
|
||
|
||
/* The field flags contains attributes of the section. Some
|
||
flags are read in from the object file, and some are
|
||
synthesized from other information. */
|
||
|
||
flagword flags;
|
||
|
||
#define SEC_NO_FLAGS 0x000
|
||
|
||
/* Tells the OS to allocate space for this section when loading.
|
||
This is clear for a section containing debug information
|
||
only. */
|
||
#define SEC_ALLOC 0x001
|
||
|
||
/* Tells the OS to load the section from the file when loading.
|
||
This is clear for a .bss section. */
|
||
#define SEC_LOAD 0x002
|
||
|
||
/* The section contains data still to be relocated, so there is
|
||
some relocation information too. */
|
||
#define SEC_RELOC 0x004
|
||
|
||
#if 0 /* Obsolete ? */
|
||
#define SEC_BALIGN 0x008
|
||
#endif
|
||
|
||
/* A signal to the OS that the section contains read only
|
||
data. */
|
||
#define SEC_READONLY 0x010
|
||
|
||
/* The section contains code only. */
|
||
#define SEC_CODE 0x020
|
||
|
||
/* The section contains data only. */
|
||
#define SEC_DATA 0x040
|
||
|
||
/* The section will reside in ROM. */
|
||
#define SEC_ROM 0x080
|
||
|
||
/* The section contains constructor information. This section
|
||
type is used by the linker to create lists of constructors and
|
||
destructors used by <<g++>>. When a back end sees a symbol
|
||
which should be used in a constructor list, it creates a new
|
||
section for the type of name (e.g., <<__CTOR_LIST__>>), attaches
|
||
the symbol to it, and builds a relocation. To build the lists
|
||
of constructors, all the linker has to do is catenate all the
|
||
sections called <<__CTOR_LIST__>> and relocate the data
|
||
contained within - exactly the operations it would peform on
|
||
standard data. */
|
||
#define SEC_CONSTRUCTOR 0x100
|
||
|
||
/* The section is a constuctor, and should be placed at the
|
||
end of the text, data, or bss section(?). */
|
||
#define SEC_CONSTRUCTOR_TEXT 0x1100
|
||
#define SEC_CONSTRUCTOR_DATA 0x2100
|
||
#define SEC_CONSTRUCTOR_BSS 0x3100
|
||
|
||
/* The section has contents - a data section could be
|
||
<<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>; a debug section could be
|
||
<<SEC_HAS_CONTENTS>> */
|
||
#define SEC_HAS_CONTENTS 0x200
|
||
|
||
/* An instruction to the linker to not output the section
|
||
even if it has information which would normally be written. */
|
||
#define SEC_NEVER_LOAD 0x400
|
||
|
||
/* The section is a shared library section. The linker must leave
|
||
these completely alone, as the vma and size are used when
|
||
the executable is loaded. */
|
||
#define SEC_SHARED_LIBRARY 0x800
|
||
|
||
/* The section is a common section (symbols may be defined
|
||
multiple times, the value of a symbol is the amount of
|
||
space it requires, and the largest symbol value is the one
|
||
used). Most targets have exactly one of these (which we
|
||
translate to bfd_com_section), but ECOFF has two. */
|
||
#define SEC_IS_COMMON 0x8000
|
||
|
||
/* The section contains only debugging information. For
|
||
example, this is set for ELF .debug and .stab sections.
|
||
strip tests this flag to see if a section can be
|
||
discarded. */
|
||
#define SEC_DEBUGGING 0x10000
|
||
|
||
/* End of section flags. */
|
||
|
||
/* The virtual memory address of the section - where it will be
|
||
at run time. The symbols are relocated against this. The
|
||
user_set_vma flag is maintained by bfd; if it's not set, the
|
||
backend can assign addresses (for example, in <<a.out>>, where
|
||
the default address for <<.data>> is dependent on the specific
|
||
target and various flags). */
|
||
|
||
bfd_vma vma;
|
||
boolean user_set_vma;
|
||
|
||
/* The load address of the section - where it would be in a
|
||
rom image; really only used for writing section header
|
||
information. */
|
||
|
||
bfd_vma lma;
|
||
|
||
/* The size of the section in bytes, as it will be output.
|
||
contains a value even if the section has no contents (e.g., the
|
||
size of <<.bss>>). This will be filled in after relocation */
|
||
|
||
bfd_size_type _cooked_size;
|
||
|
||
/* The original size on disk of the section, in bytes. Normally this
|
||
value is the same as the size, but if some relaxing has
|
||
been done, then this value will be bigger. */
|
||
|
||
bfd_size_type _raw_size;
|
||
|
||
/* If this section is going to be output, then this value is the
|
||
offset into the output section of the first byte in the input
|
||
section. E.g., if this was going to start at the 100th byte in
|
||
the output section, this value would be 100. */
|
||
|
||
bfd_vma output_offset;
|
||
|
||
/* The output section through which to map on output. */
|
||
|
||
struct sec *output_section;
|
||
|
||
/* The alignment requirement of the section, as an exponent of 2 -
|
||
e.g., 3 aligns to 2^3 (or 8). */
|
||
|
||
unsigned int alignment_power;
|
||
|
||
/* If an input section, a pointer to a vector of relocation
|
||
records for the data in this section. */
|
||
|
||
struct reloc_cache_entry *relocation;
|
||
|
||
/* If an output section, a pointer to a vector of pointers to
|
||
relocation records for the data in this section. */
|
||
|
||
struct reloc_cache_entry **orelocation;
|
||
|
||
/* The number of relocation records in one of the above */
|
||
|
||
unsigned reloc_count;
|
||
|
||
/* Information below is back end specific - and not always used
|
||
or updated. */
|
||
|
||
/* File position of section data */
|
||
|
||
file_ptr filepos;
|
||
|
||
/* File position of relocation info */
|
||
|
||
file_ptr rel_filepos;
|
||
|
||
/* File position of line data */
|
||
|
||
file_ptr line_filepos;
|
||
|
||
/* Pointer to data for applications */
|
||
|
||
PTR userdata;
|
||
|
||
struct lang_output_section *otheruserdata;
|
||
|
||
/* Attached line number information */
|
||
|
||
alent *lineno;
|
||
|
||
/* Number of line number records */
|
||
|
||
unsigned int lineno_count;
|
||
|
||
/* When a section is being output, this value changes as more
|
||
linenumbers are written out */
|
||
|
||
file_ptr moving_line_filepos;
|
||
|
||
/* What the section number is in the target world */
|
||
|
||
int target_index;
|
||
|
||
PTR used_by_bfd;
|
||
|
||
/* If this is a constructor section then here is a list of the
|
||
relocations created to relocate items within it. */
|
||
|
||
struct relent_chain *constructor_chain;
|
||
|
||
/* The BFD which owns the section. */
|
||
|
||
bfd *owner;
|
||
|
||
boolean reloc_done;
|
||
/* A symbol which points at this section only */
|
||
struct symbol_cache_entry *symbol;
|
||
struct symbol_cache_entry **symbol_ptr_ptr;
|
||
|
||
struct bfd_link_order *link_order_head;
|
||
struct bfd_link_order *link_order_tail;
|
||
} asection ;
|
||
|
||
|
||
/* These sections are global, and are managed by BFD. The application
|
||
and target back end are not permitted to change the values in
|
||
these sections. */
|
||
#define BFD_ABS_SECTION_NAME "*ABS*"
|
||
#define BFD_UND_SECTION_NAME "*UND*"
|
||
#define BFD_COM_SECTION_NAME "*COM*"
|
||
#define BFD_IND_SECTION_NAME "*IND*"
|
||
|
||
/* the absolute section */
|
||
extern asection bfd_abs_section;
|
||
/* Pointer to the undefined section */
|
||
extern asection bfd_und_section;
|
||
/* Pointer to the common section */
|
||
extern asection bfd_com_section;
|
||
/* Pointer to the indirect section */
|
||
extern asection bfd_ind_section;
|
||
|
||
extern struct symbol_cache_entry *bfd_abs_symbol;
|
||
extern struct symbol_cache_entry *bfd_com_symbol;
|
||
extern struct symbol_cache_entry *bfd_und_symbol;
|
||
extern struct symbol_cache_entry *bfd_ind_symbol;
|
||
#define bfd_get_section_size_before_reloc(section) \
|
||
(section->reloc_done ? (abort(),1): (section)->_raw_size)
|
||
#define bfd_get_section_size_after_reloc(section) \
|
||
((section->reloc_done) ? (section)->_cooked_size: (abort(),1))
|
||
asection *
|
||
bfd_get_section_by_name PARAMS ((bfd *abfd, CONST char *name));
|
||
|
||
asection *
|
||
bfd_make_section_old_way PARAMS ((bfd *abfd, CONST char *name));
|
||
|
||
asection *
|
||
bfd_make_section_anyway PARAMS ((bfd *abfd, CONST char *name));
|
||
|
||
asection *
|
||
bfd_make_section PARAMS ((bfd *, CONST char *name));
|
||
|
||
boolean
|
||
bfd_set_section_flags PARAMS ((bfd *abfd, asection *sec, flagword flags));
|
||
|
||
void
|
||
bfd_map_over_sections PARAMS ((bfd *abfd,
|
||
void (*func)(bfd *abfd,
|
||
asection *sect,
|
||
PTR obj),
|
||
PTR obj));
|
||
|
||
boolean
|
||
bfd_set_section_size PARAMS ((bfd *abfd, asection *sec, bfd_size_type val));
|
||
|
||
boolean
|
||
bfd_set_section_contents
|
||
PARAMS ((bfd *abfd,
|
||
asection *section,
|
||
PTR data,
|
||
file_ptr offset,
|
||
bfd_size_type count));
|
||
|
||
boolean
|
||
bfd_get_section_contents
|
||
PARAMS ((bfd *abfd, asection *section, PTR location,
|
||
file_ptr offset, bfd_size_type count));
|
||
|
||
enum bfd_architecture
|
||
{
|
||
bfd_arch_unknown, /* File arch not known */
|
||
bfd_arch_obscure, /* Arch known, not one of these */
|
||
bfd_arch_m68k, /* Motorola 68xxx */
|
||
bfd_arch_vax, /* DEC Vax */
|
||
bfd_arch_i960, /* Intel 960 */
|
||
/* The order of the following is important.
|
||
lower number indicates a machine type that
|
||
only accepts a subset of the instructions
|
||
available to machines with higher numbers.
|
||
The exception is the "ca", which is
|
||
incompatible with all other machines except
|
||
"core". */
|
||
|
||
#define bfd_mach_i960_core 1
|
||
#define bfd_mach_i960_ka_sa 2
|
||
#define bfd_mach_i960_kb_sb 3
|
||
#define bfd_mach_i960_mc 4
|
||
#define bfd_mach_i960_xa 5
|
||
#define bfd_mach_i960_ca 6
|
||
|
||
bfd_arch_a29k, /* AMD 29000 */
|
||
bfd_arch_sparc, /* SPARC */
|
||
bfd_arch_mips, /* MIPS Rxxxx */
|
||
bfd_arch_i386, /* Intel 386 */
|
||
bfd_arch_we32k, /* AT&T WE32xxx */
|
||
bfd_arch_tahoe, /* CCI/Harris Tahoe */
|
||
bfd_arch_i860, /* Intel 860 */
|
||
bfd_arch_romp, /* IBM ROMP PC/RT */
|
||
bfd_arch_alliant, /* Alliant */
|
||
bfd_arch_convex, /* Convex */
|
||
bfd_arch_m88k, /* Motorola 88xxx */
|
||
bfd_arch_pyramid, /* Pyramid Technology */
|
||
bfd_arch_h8300, /* Hitachi H8/300 */
|
||
#define bfd_mach_h8300 1
|
||
#define bfd_mach_h8300h 2
|
||
bfd_arch_rs6000, /* IBM RS/6000 */
|
||
bfd_arch_hppa, /* HP PA RISC */
|
||
bfd_arch_z8k, /* Zilog Z8000 */
|
||
#define bfd_mach_z8001 1
|
||
#define bfd_mach_z8002 2
|
||
bfd_arch_h8500, /* Hitachi H8/500 */
|
||
bfd_arch_sh, /* Hitachi SH */
|
||
bfd_arch_alpha, /* Dec Alpha */
|
||
bfd_arch_last
|
||
};
|
||
|
||
typedef struct bfd_arch_info
|
||
{
|
||
int bits_per_word;
|
||
int bits_per_address;
|
||
int bits_per_byte;
|
||
enum bfd_architecture arch;
|
||
long mach;
|
||
char *arch_name;
|
||
CONST char *printable_name;
|
||
unsigned int section_align_power;
|
||
/* true if this is the default machine for the architecture */
|
||
boolean the_default;
|
||
CONST struct bfd_arch_info * (*compatible)
|
||
PARAMS ((CONST struct bfd_arch_info *a,
|
||
CONST struct bfd_arch_info *b));
|
||
|
||
boolean (*scan) PARAMS ((CONST struct bfd_arch_info *, CONST char *));
|
||
/* How to disassemble an instruction, producing a printable
|
||
representation on a specified stdio stream. This isn't
|
||
defined for most processors at present, because of the size
|
||
of the additional tables it would drag in, and because gdb
|
||
wants to use a different interface. */
|
||
unsigned int (*disassemble) PARAMS ((bfd_vma addr, CONST char *data,
|
||
PTR stream));
|
||
|
||
struct bfd_arch_info *next;
|
||
} bfd_arch_info_type;
|
||
CONST char *
|
||
bfd_printable_name PARAMS ((bfd *abfd));
|
||
|
||
bfd_arch_info_type *
|
||
bfd_scan_arch PARAMS ((CONST char *string));
|
||
|
||
CONST bfd_arch_info_type *
|
||
bfd_arch_get_compatible PARAMS ((
|
||
CONST bfd *abfd,
|
||
CONST bfd *bbfd));
|
||
|
||
void
|
||
bfd_set_arch_info PARAMS ((bfd *abfd, bfd_arch_info_type *arg));
|
||
|
||
enum bfd_architecture
|
||
bfd_get_arch PARAMS ((bfd *abfd));
|
||
|
||
unsigned long
|
||
bfd_get_mach PARAMS ((bfd *abfd));
|
||
|
||
unsigned int
|
||
bfd_arch_bits_per_byte PARAMS ((bfd *abfd));
|
||
|
||
unsigned int
|
||
bfd_arch_bits_per_address PARAMS ((bfd *abfd));
|
||
|
||
bfd_arch_info_type *
|
||
bfd_get_arch_info PARAMS ((bfd *abfd));
|
||
|
||
bfd_arch_info_type *
|
||
bfd_lookup_arch
|
||
PARAMS ((enum bfd_architecture
|
||
arch,
|
||
long machine));
|
||
|
||
CONST char *
|
||
bfd_printable_arch_mach
|
||
PARAMS ((enum bfd_architecture arch, unsigned long machine));
|
||
|
||
typedef enum bfd_reloc_status
|
||
{
|
||
/* No errors detected */
|
||
bfd_reloc_ok,
|
||
|
||
/* The relocation was performed, but there was an overflow. */
|
||
bfd_reloc_overflow,
|
||
|
||
/* The address to relocate was not within the section supplied. */
|
||
bfd_reloc_outofrange,
|
||
|
||
/* Used by special functions */
|
||
bfd_reloc_continue,
|
||
|
||
/* Unsupported relocation size requested. */
|
||
bfd_reloc_notsupported,
|
||
|
||
/* Unused */
|
||
bfd_reloc_other,
|
||
|
||
/* The symbol to relocate against was undefined. */
|
||
bfd_reloc_undefined,
|
||
|
||
/* The relocation was performed, but may not be ok - presently
|
||
generated only when linking i960 coff files with i960 b.out
|
||
symbols. If this type is returned, the error_message argument
|
||
to bfd_perform_relocation will be set. */
|
||
bfd_reloc_dangerous
|
||
}
|
||
bfd_reloc_status_type;
|
||
|
||
|
||
typedef struct reloc_cache_entry
|
||
{
|
||
/* A pointer into the canonical table of pointers */
|
||
struct symbol_cache_entry **sym_ptr_ptr;
|
||
|
||
/* offset in section */
|
||
bfd_size_type address;
|
||
|
||
/* addend for relocation value */
|
||
bfd_vma addend;
|
||
|
||
/* Pointer to how to perform the required relocation */
|
||
const struct reloc_howto_struct *howto;
|
||
|
||
} arelent;
|
||
enum complain_overflow
|
||
{
|
||
/* Do not complain on overflow. */
|
||
complain_overflow_dont,
|
||
|
||
/* Complain if the bitfield overflows, whether it is considered
|
||
as signed or unsigned. */
|
||
complain_overflow_bitfield,
|
||
|
||
/* Complain if the value overflows when considered as signed
|
||
number. */
|
||
complain_overflow_signed,
|
||
|
||
/* Complain if the value overflows when considered as an
|
||
unsigned number. */
|
||
complain_overflow_unsigned
|
||
};
|
||
|
||
typedef struct reloc_howto_struct
|
||
{
|
||
/* The type field has mainly a documetary use - the back end can
|
||
do what it wants with it, though normally the back end's
|
||
external idea of what a reloc number is stored
|
||
in this field. For example, a PC relative word relocation
|
||
in a coff environment has the type 023 - because that's
|
||
what the outside world calls a R_PCRWORD reloc. */
|
||
unsigned int type;
|
||
|
||
/* The value the final relocation is shifted right by. This drops
|
||
unwanted data from the relocation. */
|
||
unsigned int rightshift;
|
||
|
||
/* The size of the item to be relocated. This is *not* a
|
||
power-of-two measure. To get the number of bytes operated
|
||
on by a type of relocation, use bfd_get_reloc_size. */
|
||
int size;
|
||
|
||
/* The number of bits in the item to be relocated. This is used
|
||
when doing overflow checking. */
|
||
unsigned int bitsize;
|
||
|
||
/* Notes that the relocation is relative to the location in the
|
||
data section of the addend. The relocation function will
|
||
subtract from the relocation value the address of the location
|
||
being relocated. */
|
||
boolean pc_relative;
|
||
|
||
/* The bit position of the reloc value in the destination.
|
||
The relocated value is left shifted by this amount. */
|
||
unsigned int bitpos;
|
||
|
||
/* What type of overflow error should be checked for when
|
||
relocating. */
|
||
enum complain_overflow complain_on_overflow;
|
||
|
||
/* If this field is non null, then the supplied function is
|
||
called rather than the normal function. This allows really
|
||
strange relocation methods to be accomodated (e.g., i960 callj
|
||
instructions). */
|
||
bfd_reloc_status_type (*special_function)
|
||
PARAMS ((bfd *abfd,
|
||
arelent *reloc_entry,
|
||
struct symbol_cache_entry *symbol,
|
||
PTR data,
|
||
asection *input_section,
|
||
bfd *output_bfd,
|
||
char **error_message));
|
||
|
||
/* The textual name of the relocation type. */
|
||
char *name;
|
||
|
||
/* When performing a partial link, some formats must modify the
|
||
relocations rather than the data - this flag signals this.*/
|
||
boolean partial_inplace;
|
||
|
||
/* The src_mask selects which parts of the read in data
|
||
are to be used in the relocation sum. E.g., if this was an 8 bit
|
||
bit of data which we read and relocated, this would be
|
||
0x000000ff. When we have relocs which have an addend, such as
|
||
sun4 extended relocs, the value in the offset part of a
|
||
relocating field is garbage so we never use it. In this case
|
||
the mask would be 0x00000000. */
|
||
bfd_vma src_mask;
|
||
|
||
/* The dst_mask selects which parts of the instruction are replaced
|
||
into the instruction. In most cases src_mask == dst_mask,
|
||
except in the above special case, where dst_mask would be
|
||
0x000000ff, and src_mask would be 0x00000000. */
|
||
bfd_vma dst_mask;
|
||
|
||
/* When some formats create PC relative instructions, they leave
|
||
the value of the pc of the place being relocated in the offset
|
||
slot of the instruction, so that a PC relative relocation can
|
||
be made just by adding in an ordinary offset (e.g., sun3 a.out).
|
||
Some formats leave the displacement part of an instruction
|
||
empty (e.g., m88k bcs); this flag signals the fact.*/
|
||
boolean pcrel_offset;
|
||
|
||
} reloc_howto_type;
|
||
#define HOWTO(C, R,S,B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
|
||
{(unsigned)C,R,S,B, P, BI, O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC}
|
||
#define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,complain_overflow_dont,FUNCTION, NAME,false,0,0,IN)
|
||
|
||
#define HOWTO_PREPARE(relocation, symbol) \
|
||
{ \
|
||
if (symbol != (asymbol *)NULL) { \
|
||
if (bfd_is_com_section (symbol->section)) { \
|
||
relocation = 0; \
|
||
} \
|
||
else { \
|
||
relocation = symbol->value; \
|
||
} \
|
||
} \
|
||
}
|
||
int
|
||
bfd_get_reloc_size PARAMS ((const reloc_howto_type *));
|
||
|
||
typedef unsigned char bfd_byte;
|
||
|
||
typedef struct relent_chain {
|
||
arelent relent;
|
||
struct relent_chain *next;
|
||
} arelent_chain;
|
||
bfd_reloc_status_type
|
||
|
||
bfd_perform_relocation
|
||
PARAMS ((bfd *abfd,
|
||
arelent *reloc_entry,
|
||
PTR data,
|
||
asection *input_section,
|
||
bfd *output_bfd,
|
||
char **error_message));
|
||
|
||
typedef enum bfd_reloc_code_real
|
||
{
|
||
/* Basic absolute relocations */
|
||
BFD_RELOC_64,
|
||
BFD_RELOC_32,
|
||
BFD_RELOC_16,
|
||
BFD_RELOC_14,
|
||
BFD_RELOC_8,
|
||
|
||
/* PC-relative relocations */
|
||
BFD_RELOC_64_PCREL,
|
||
BFD_RELOC_32_PCREL,
|
||
BFD_RELOC_24_PCREL, /* used by i960 */
|
||
BFD_RELOC_16_PCREL,
|
||
BFD_RELOC_8_PCREL,
|
||
|
||
/* Linkage-table relative */
|
||
BFD_RELOC_32_BASEREL,
|
||
BFD_RELOC_16_BASEREL,
|
||
BFD_RELOC_8_BASEREL,
|
||
|
||
/* The type of reloc used to build a contructor table - at the moment
|
||
probably a 32 bit wide abs address, but the cpu can choose. */
|
||
BFD_RELOC_CTOR,
|
||
|
||
/* 8 bits wide, but used to form an address like 0xffnn */
|
||
BFD_RELOC_8_FFnn,
|
||
|
||
/* 32-bit pc-relative, shifted right 2 bits (i.e., 30-bit
|
||
word displacement, e.g. for SPARC) */
|
||
BFD_RELOC_32_PCREL_S2,
|
||
/* signed 16-bit pc-relative, shifted right 2 bits (e.g. for MIPS) */
|
||
BFD_RELOC_16_PCREL_S2,
|
||
/* this is used on the Alpha */
|
||
BFD_RELOC_23_PCREL_S2,
|
||
|
||
/* High 22 bits of 32-bit value, placed into lower 22 bits of
|
||
target word; simple reloc. */
|
||
BFD_RELOC_HI22,
|
||
/* Low 10 bits. */
|
||
BFD_RELOC_LO10,
|
||
|
||
/* For systems that allocate a Global Pointer register, these are
|
||
displacements off that register. These relocation types are
|
||
handled specially, because the value the register will have is
|
||
decided relatively late. */
|
||
BFD_RELOC_GPREL16,
|
||
BFD_RELOC_GPREL32,
|
||
|
||
/* Reloc types used for i960/b.out. */
|
||
BFD_RELOC_I960_CALLJ,
|
||
|
||
/* now for the sparc/elf codes */
|
||
BFD_RELOC_NONE, /* actually used */
|
||
BFD_RELOC_SPARC_WDISP22,
|
||
BFD_RELOC_SPARC22,
|
||
BFD_RELOC_SPARC13,
|
||
BFD_RELOC_SPARC_GOT10,
|
||
BFD_RELOC_SPARC_GOT13,
|
||
BFD_RELOC_SPARC_GOT22,
|
||
BFD_RELOC_SPARC_PC10,
|
||
BFD_RELOC_SPARC_PC22,
|
||
BFD_RELOC_SPARC_WPLT30,
|
||
BFD_RELOC_SPARC_COPY,
|
||
BFD_RELOC_SPARC_GLOB_DAT,
|
||
BFD_RELOC_SPARC_JMP_SLOT,
|
||
BFD_RELOC_SPARC_RELATIVE,
|
||
BFD_RELOC_SPARC_UA32,
|
||
|
||
/* these are a.out specific? */
|
||
BFD_RELOC_SPARC_BASE13,
|
||
BFD_RELOC_SPARC_BASE22,
|
||
|
||
/* start-sanitize-v9 */
|
||
BFD_RELOC_SPARC_10,
|
||
BFD_RELOC_SPARC_11,
|
||
#define BFD_RELOC_SPARC_64 BFD_RELOC_64
|
||
BFD_RELOC_SPARC_OLO10,
|
||
BFD_RELOC_SPARC_HH22,
|
||
BFD_RELOC_SPARC_HM10,
|
||
BFD_RELOC_SPARC_LM22,
|
||
BFD_RELOC_SPARC_PC_HH22,
|
||
BFD_RELOC_SPARC_PC_HM10,
|
||
BFD_RELOC_SPARC_PC_LM22,
|
||
BFD_RELOC_SPARC_WDISP16,
|
||
BFD_RELOC_SPARC_WDISP19,
|
||
BFD_RELOC_SPARC_GLOB_JMP,
|
||
BFD_RELOC_SPARC_LO7,
|
||
/* end-sanitize-v9 */
|
||
|
||
/* Alpha ECOFF relocations. Some of these treat the symbol or "addend"
|
||
in some special way. */
|
||
/* For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
|
||
writing; when reading, it will be the absolute section symbol. The
|
||
addend is the displacement in bytes of the "lda" instruction from
|
||
the "ldah" instruction (which is at the address of this reloc). */
|
||
BFD_RELOC_ALPHA_GPDISP_HI16,
|
||
/* For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
|
||
with GPDISP_HI16 relocs. The addend is ignored when writing the
|
||
relocations out, and is filled in with the file's GP value on
|
||
reading, for convenience. */
|
||
BFD_RELOC_ALPHA_GPDISP_LO16,
|
||
|
||
/* The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
|
||
the assembler turns it into a LDQ instruction to load the address of
|
||
the symbol, and then fills in a register in the real instruction.
|
||
|
||
The LITERAL reloc, at the LDQ instruction, refers to the .lita
|
||
section symbol. The addend is ignored when writing, but is filled
|
||
in with the file's GP value on reading, for convenience, as with the
|
||
GPDISP_LO16 reloc.
|
||
|
||
The LITUSE reloc, on the instruction using the loaded address, gives
|
||
information to the linker that it might be able to use to optimize
|
||
away some literal section references. The symbol is ignored (read
|
||
as the absolute section symbol), and the "addend" indicates the type
|
||
of instruction using the register:
|
||
1 - "memory" fmt insn
|
||
2 - byte-manipulation (byte offset reg)
|
||
3 - jsr (target of branch)
|
||
|
||
The GNU linker currently doesn't do any of this optimizing. */
|
||
BFD_RELOC_ALPHA_LITERAL,
|
||
BFD_RELOC_ALPHA_LITUSE,
|
||
|
||
/* The HINT relocation indicates a value that should be filled into the
|
||
"hint" field of a jmp/jsr/ret instruction, for possible branch-
|
||
prediction logic which may be provided on some processors. */
|
||
BFD_RELOC_ALPHA_HINT,
|
||
|
||
/* Bits 27..2 of the relocation address shifted right 2 bits;
|
||
simple reloc otherwise. */
|
||
BFD_RELOC_MIPS_JMP,
|
||
|
||
/* High 16 bits of 32-bit value; simple reloc. */
|
||
BFD_RELOC_HI16,
|
||
/* High 16 bits of 32-bit value but the low 16 bits will be sign
|
||
extended and added to form the final result. If the low 16
|
||
bits form a negative number, we need to add one to the high value
|
||
to compensate for the borrow when the low bits are added. */
|
||
BFD_RELOC_HI16_S,
|
||
/* Low 16 bits. */
|
||
BFD_RELOC_LO16,
|
||
|
||
/* relocation relative to the global pointer. */
|
||
#define BFD_RELOC_MIPS_GPREL BFD_RELOC_GPREL16
|
||
|
||
/* Relocation against a MIPS literal section. */
|
||
BFD_RELOC_MIPS_LITERAL,
|
||
|
||
/* MIPS ELF relocations. */
|
||
BFD_RELOC_MIPS_GOT16,
|
||
BFD_RELOC_MIPS_CALL16,
|
||
#define BFD_RELOC_MIPS_GPREL32 BFD_RELOC_GPREL32
|
||
|
||
/* These are, so far, specific to HPPA processors. I'm not sure that some
|
||
don't duplicate other reloc types, such as BFD_RELOC_32 and _32_PCREL.
|
||
Also, many more were in the list I got that don't fit in well in the
|
||
model BFD uses, so I've omitted them for now. If we do make this reloc
|
||
type get used for code that really does implement the funky reloc types,
|
||
they'll have to be added to this list. */
|
||
BFD_RELOC_HPPA_32,
|
||
BFD_RELOC_HPPA_11,
|
||
BFD_RELOC_HPPA_14,
|
||
BFD_RELOC_HPPA_17,
|
||
|
||
BFD_RELOC_HPPA_L21,
|
||
BFD_RELOC_HPPA_R11,
|
||
BFD_RELOC_HPPA_R14,
|
||
BFD_RELOC_HPPA_R17,
|
||
BFD_RELOC_HPPA_LS21,
|
||
BFD_RELOC_HPPA_RS11,
|
||
BFD_RELOC_HPPA_RS14,
|
||
BFD_RELOC_HPPA_RS17,
|
||
BFD_RELOC_HPPA_LD21,
|
||
BFD_RELOC_HPPA_RD11,
|
||
BFD_RELOC_HPPA_RD14,
|
||
BFD_RELOC_HPPA_RD17,
|
||
BFD_RELOC_HPPA_LR21,
|
||
BFD_RELOC_HPPA_RR14,
|
||
BFD_RELOC_HPPA_RR17,
|
||
|
||
BFD_RELOC_HPPA_GOTOFF_11,
|
||
BFD_RELOC_HPPA_GOTOFF_14,
|
||
BFD_RELOC_HPPA_GOTOFF_L21,
|
||
BFD_RELOC_HPPA_GOTOFF_R11,
|
||
BFD_RELOC_HPPA_GOTOFF_R14,
|
||
BFD_RELOC_HPPA_GOTOFF_LS21,
|
||
BFD_RELOC_HPPA_GOTOFF_RS11,
|
||
BFD_RELOC_HPPA_GOTOFF_RS14,
|
||
BFD_RELOC_HPPA_GOTOFF_LD21,
|
||
BFD_RELOC_HPPA_GOTOFF_RD11,
|
||
BFD_RELOC_HPPA_GOTOFF_RD14,
|
||
BFD_RELOC_HPPA_GOTOFF_LR21,
|
||
BFD_RELOC_HPPA_GOTOFF_RR14,
|
||
|
||
BFD_RELOC_HPPA_DLT_32,
|
||
BFD_RELOC_HPPA_DLT_11,
|
||
BFD_RELOC_HPPA_DLT_14,
|
||
BFD_RELOC_HPPA_DLT_L21,
|
||
BFD_RELOC_HPPA_DLT_R11,
|
||
BFD_RELOC_HPPA_DLT_R14,
|
||
|
||
BFD_RELOC_HPPA_ABS_CALL_11,
|
||
BFD_RELOC_HPPA_ABS_CALL_14,
|
||
BFD_RELOC_HPPA_ABS_CALL_17,
|
||
BFD_RELOC_HPPA_ABS_CALL_L21,
|
||
BFD_RELOC_HPPA_ABS_CALL_R11,
|
||
BFD_RELOC_HPPA_ABS_CALL_R14,
|
||
BFD_RELOC_HPPA_ABS_CALL_R17,
|
||
BFD_RELOC_HPPA_ABS_CALL_LS21,
|
||
BFD_RELOC_HPPA_ABS_CALL_RS11,
|
||
BFD_RELOC_HPPA_ABS_CALL_RS14,
|
||
BFD_RELOC_HPPA_ABS_CALL_RS17,
|
||
BFD_RELOC_HPPA_ABS_CALL_LD21,
|
||
BFD_RELOC_HPPA_ABS_CALL_RD11,
|
||
BFD_RELOC_HPPA_ABS_CALL_RD14,
|
||
BFD_RELOC_HPPA_ABS_CALL_RD17,
|
||
BFD_RELOC_HPPA_ABS_CALL_LR21,
|
||
BFD_RELOC_HPPA_ABS_CALL_RR14,
|
||
BFD_RELOC_HPPA_ABS_CALL_RR17,
|
||
|
||
BFD_RELOC_HPPA_PCREL_CALL_11,
|
||
BFD_RELOC_HPPA_PCREL_CALL_12,
|
||
BFD_RELOC_HPPA_PCREL_CALL_14,
|
||
BFD_RELOC_HPPA_PCREL_CALL_17,
|
||
BFD_RELOC_HPPA_PCREL_CALL_L21,
|
||
BFD_RELOC_HPPA_PCREL_CALL_R11,
|
||
BFD_RELOC_HPPA_PCREL_CALL_R14,
|
||
BFD_RELOC_HPPA_PCREL_CALL_R17,
|
||
BFD_RELOC_HPPA_PCREL_CALL_LS21,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RS11,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RS14,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RS17,
|
||
BFD_RELOC_HPPA_PCREL_CALL_LD21,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RD11,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RD14,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RD17,
|
||
BFD_RELOC_HPPA_PCREL_CALL_LR21,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RR14,
|
||
BFD_RELOC_HPPA_PCREL_CALL_RR17,
|
||
|
||
BFD_RELOC_HPPA_PLABEL_32,
|
||
BFD_RELOC_HPPA_PLABEL_11,
|
||
BFD_RELOC_HPPA_PLABEL_14,
|
||
BFD_RELOC_HPPA_PLABEL_L21,
|
||
BFD_RELOC_HPPA_PLABEL_R11,
|
||
BFD_RELOC_HPPA_PLABEL_R14,
|
||
|
||
BFD_RELOC_HPPA_UNWIND_ENTRY,
|
||
BFD_RELOC_HPPA_UNWIND_ENTRIES,
|
||
|
||
/* i386/elf relocations */
|
||
BFD_RELOC_386_GOT32,
|
||
BFD_RELOC_386_PLT32,
|
||
BFD_RELOC_386_COPY,
|
||
BFD_RELOC_386_GLOB_DAT,
|
||
BFD_RELOC_386_JUMP_SLOT,
|
||
BFD_RELOC_386_RELATIVE,
|
||
BFD_RELOC_386_GOTOFF,
|
||
BFD_RELOC_386_GOTPC,
|
||
|
||
/* this must be the highest numeric value */
|
||
BFD_RELOC_UNUSED
|
||
} bfd_reloc_code_real_type;
|
||
const struct reloc_howto_struct *
|
||
|
||
bfd_reloc_type_lookup PARAMS ((bfd *abfd, bfd_reloc_code_real_type code));
|
||
|
||
|
||
typedef struct symbol_cache_entry
|
||
{
|
||
/* A pointer to the BFD which owns the symbol. This information
|
||
is necessary so that a back end can work out what additional
|
||
information (invisible to the application writer) is carried
|
||
with the symbol.
|
||
|
||
This field is *almost* redundant, since you can use section->owner
|
||
instead, except that some symbols point to the global sections
|
||
bfd_{abs,com,und}_section. This could be fixed by making
|
||
these globals be per-bfd (or per-target-flavor). FIXME. */
|
||
|
||
struct _bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field. */
|
||
|
||
/* The text of the symbol. The name is left alone, and not copied; the
|
||
application may not alter it. */
|
||
CONST char *name;
|
||
|
||
/* The value of the symbol. This really should be a union of a
|
||
numeric value with a pointer, since some flags indicate that
|
||
a pointer to another symbol is stored here. */
|
||
symvalue value;
|
||
|
||
/* Attributes of a symbol: */
|
||
|
||
#define BSF_NO_FLAGS 0x00
|
||
|
||
/* The symbol has local scope; <<static>> in <<C>>. The value
|
||
is the offset into the section of the data. */
|
||
#define BSF_LOCAL 0x01
|
||
|
||
/* The symbol has global scope; initialized data in <<C>>. The
|
||
value is the offset into the section of the data. */
|
||
#define BSF_GLOBAL 0x02
|
||
|
||
/* The symbol has global scope and is exported. The value is
|
||
the offset into the section of the data. */
|
||
#define BSF_EXPORT BSF_GLOBAL /* no real difference */
|
||
|
||
/* A normal C symbol would be one of:
|
||
<<BSF_LOCAL>>, <<BSF_FORT_COMM>>, <<BSF_UNDEFINED>> or
|
||
<<BSF_GLOBAL>> */
|
||
|
||
/* The symbol is a debugging record. The value has an arbitary
|
||
meaning. */
|
||
#define BSF_DEBUGGING 0x08
|
||
|
||
/* The symbol denotes a function entry point. Used in ELF,
|
||
perhaps others someday. */
|
||
#define BSF_FUNCTION 0x10
|
||
|
||
/* Used by the linker. */
|
||
#define BSF_KEEP 0x20
|
||
#define BSF_KEEP_G 0x40
|
||
|
||
/* A weak global symbol, overridable without warnings by
|
||
a regular global symbol of the same name. */
|
||
#define BSF_WEAK 0x80
|
||
|
||
/* This symbol was created to point to a section, e.g. ELF's
|
||
STT_SECTION symbols. */
|
||
#define BSF_SECTION_SYM 0x100
|
||
|
||
/* The symbol used to be a common symbol, but now it is
|
||
allocated. */
|
||
#define BSF_OLD_COMMON 0x200
|
||
|
||
/* The default value for common data. */
|
||
#define BFD_FORT_COMM_DEFAULT_VALUE 0
|
||
|
||
/* In some files the type of a symbol sometimes alters its
|
||
location in an output file - ie in coff a <<ISFCN>> symbol
|
||
which is also <<C_EXT>> symbol appears where it was
|
||
declared and not at the end of a section. This bit is set
|
||
by the target BFD part to convey this information. */
|
||
|
||
#define BSF_NOT_AT_END 0x400
|
||
|
||
/* Signal that the symbol is the label of constructor section. */
|
||
#define BSF_CONSTRUCTOR 0x800
|
||
|
||
/* Signal that the symbol is a warning symbol. If the symbol
|
||
is a warning symbol, then the value field (I know this is
|
||
tacky) will point to the asymbol which when referenced will
|
||
cause the warning. */
|
||
#define BSF_WARNING 0x1000
|
||
|
||
/* Signal that the symbol is indirect. The value of the symbol
|
||
is a pointer to an undefined asymbol which contains the
|
||
name to use instead. */
|
||
#define BSF_INDIRECT 0x2000
|
||
|
||
/* BSF_FILE marks symbols that contain a file name. This is used
|
||
for ELF STT_FILE symbols. */
|
||
#define BSF_FILE 0x4000
|
||
|
||
flagword flags;
|
||
|
||
/* A pointer to the section to which this symbol is
|
||
relative. This will always be non NULL, there are special
|
||
sections for undefined and absolute symbols */
|
||
struct sec *section;
|
||
|
||
/* Back end special data. This is being phased out in favour
|
||
of making this a union. */
|
||
PTR udata;
|
||
|
||
} asymbol;
|
||
#define get_symtab_upper_bound(abfd) \
|
||
BFD_SEND (abfd, _get_symtab_upper_bound, (abfd))
|
||
#define bfd_canonicalize_symtab(abfd, location) \
|
||
BFD_SEND (abfd, _bfd_canonicalize_symtab,\
|
||
(abfd, location))
|
||
boolean
|
||
bfd_set_symtab PARAMS ((bfd *abfd, asymbol **location, unsigned int count));
|
||
|
||
void
|
||
bfd_print_symbol_vandf PARAMS ((PTR file, asymbol *symbol));
|
||
|
||
#define bfd_make_empty_symbol(abfd) \
|
||
BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
|
||
#define bfd_make_debug_symbol(abfd,ptr,size) \
|
||
BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
|
||
int
|
||
bfd_decode_symclass PARAMS ((asymbol *symbol));
|
||
|
||
void
|
||
bfd_symbol_info PARAMS ((asymbol *symbol, symbol_info *ret));
|
||
|
||
struct _bfd
|
||
{
|
||
/* The filename the application opened the BFD with. */
|
||
CONST char *filename;
|
||
|
||
/* A pointer to the target jump table. */
|
||
struct bfd_target *xvec;
|
||
|
||
/* To avoid dragging too many header files into every file that
|
||
includes `<<bfd.h>>', IOSTREAM has been declared as a "char
|
||
*", and MTIME as a "long". Their correct types, to which they
|
||
are cast when used, are "FILE *" and "time_t". The iostream
|
||
is the result of an fopen on the filename. */
|
||
char *iostream;
|
||
|
||
/* Is the file descriptor being cached? That is, can it be closed as
|
||
needed, and re-opened when accessed later? */
|
||
|
||
boolean cacheable;
|
||
|
||
/* Marks whether there was a default target specified when the
|
||
BFD was opened. This is used to select which matching algorithm
|
||
to use to choose the back end. */
|
||
|
||
boolean target_defaulted;
|
||
|
||
/* The caching routines use these to maintain a
|
||
least-recently-used list of BFDs */
|
||
|
||
struct _bfd *lru_prev, *lru_next;
|
||
|
||
/* When a file is closed by the caching routines, BFD retains
|
||
state information on the file here: */
|
||
|
||
file_ptr where;
|
||
|
||
/* and here: (``once'' means at least once) */
|
||
|
||
boolean opened_once;
|
||
|
||
/* Set if we have a locally maintained mtime value, rather than
|
||
getting it from the file each time: */
|
||
|
||
boolean mtime_set;
|
||
|
||
/* File modified time, if mtime_set is true: */
|
||
|
||
long mtime;
|
||
|
||
/* Reserved for an unimplemented file locking extension.*/
|
||
|
||
int ifd;
|
||
|
||
/* The format which belongs to the BFD. (object, core, etc.) */
|
||
|
||
bfd_format format;
|
||
|
||
/* The direction the BFD was opened with*/
|
||
|
||
enum bfd_direction {no_direction = 0,
|
||
read_direction = 1,
|
||
write_direction = 2,
|
||
both_direction = 3} direction;
|
||
|
||
/* Format_specific flags*/
|
||
|
||
flagword flags;
|
||
|
||
/* Currently my_archive is tested before adding origin to
|
||
anything. I believe that this can become always an add of
|
||
origin, with origin set to 0 for non archive files. */
|
||
|
||
file_ptr origin;
|
||
|
||
/* Remember when output has begun, to stop strange things
|
||
from happening. */
|
||
boolean output_has_begun;
|
||
|
||
/* Pointer to linked list of sections*/
|
||
struct sec *sections;
|
||
|
||
/* The number of sections */
|
||
unsigned int section_count;
|
||
|
||
/* Stuff only useful for object files:
|
||
The start address. */
|
||
bfd_vma start_address;
|
||
|
||
/* Used for input and output*/
|
||
unsigned int symcount;
|
||
|
||
/* Symbol table for output BFD (with symcount entries) */
|
||
struct symbol_cache_entry **outsymbols;
|
||
|
||
/* Pointer to structure which contains architecture information*/
|
||
struct bfd_arch_info *arch_info;
|
||
|
||
/* Stuff only useful for archives:*/
|
||
PTR arelt_data;
|
||
struct _bfd *my_archive; /* The containing archive BFD. */
|
||
struct _bfd *next; /* The next BFD in the archive. */
|
||
struct _bfd *archive_head; /* The first BFD in the archive. */
|
||
boolean has_armap;
|
||
|
||
/* A chain of BFD structures involved in a link. */
|
||
struct _bfd *link_next;
|
||
|
||
/* A field used by _bfd_generic_link_add_archive_symbols. This will
|
||
be used only for archive elements. */
|
||
int archive_pass;
|
||
|
||
/* Used by the back end to hold private data. */
|
||
|
||
union
|
||
{
|
||
struct aout_data_struct *aout_data;
|
||
struct artdata *aout_ar_data;
|
||
struct _oasys_data *oasys_obj_data;
|
||
struct _oasys_ar_data *oasys_ar_data;
|
||
struct coff_tdata *coff_obj_data;
|
||
struct ecoff_tdata *ecoff_obj_data;
|
||
struct ieee_data_struct *ieee_data;
|
||
struct ieee_ar_data_struct *ieee_ar_data;
|
||
struct srec_data_struct *srec_data;
|
||
struct tekhex_data_struct *tekhex_data;
|
||
struct elf_obj_tdata *elf_obj_data;
|
||
struct nlm_obj_tdata *nlm_obj_data;
|
||
struct bout_data_struct *bout_data;
|
||
struct sun_core_struct *sun_core_data;
|
||
struct trad_core_struct *trad_core_data;
|
||
struct som_data_struct *som_data;
|
||
struct hpux_core_struct *hpux_core_data;
|
||
struct hppabsd_core_struct *hppabsd_core_data;
|
||
struct sgi_core_struct *sgi_core_data;
|
||
struct lynx_core_struct *lynx_core_data;
|
||
struct osf_core_struct *osf_core_data;
|
||
PTR any;
|
||
} tdata;
|
||
|
||
/* Used by the application to hold private data*/
|
||
PTR usrdata;
|
||
|
||
/* Where all the allocated stuff under this BFD goes */
|
||
struct obstack memory;
|
||
};
|
||
|
||
unsigned int
|
||
bfd_get_reloc_upper_bound PARAMS ((bfd *abfd, asection *sect));
|
||
|
||
unsigned int
|
||
bfd_canonicalize_reloc
|
||
PARAMS ((bfd *abfd,
|
||
asection *sec,
|
||
arelent **loc,
|
||
asymbol **syms));
|
||
|
||
void
|
||
bfd_set_reloc
|
||
PARAMS ((bfd *abfd, asection *sec, arelent **rel, unsigned int count)
|
||
|
||
);
|
||
|
||
boolean
|
||
bfd_set_file_flags PARAMS ((bfd *abfd, flagword flags));
|
||
|
||
boolean
|
||
bfd_set_start_address PARAMS ((bfd *abfd, bfd_vma vma));
|
||
|
||
long
|
||
bfd_get_mtime PARAMS ((bfd *abfd));
|
||
|
||
long
|
||
bfd_get_size PARAMS ((bfd *abfd));
|
||
|
||
int
|
||
bfd_get_gp_size PARAMS ((bfd *abfd));
|
||
|
||
void
|
||
bfd_set_gp_size PARAMS ((bfd *abfd, int i));
|
||
|
||
bfd_vma
|
||
bfd_scan_vma PARAMS ((CONST char *string, CONST char **end, int base));
|
||
|
||
#define bfd_sizeof_headers(abfd, reloc) \
|
||
BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc))
|
||
|
||
#define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
|
||
BFD_SEND (abfd, _bfd_find_nearest_line, (abfd, sec, syms, off, file, func, line))
|
||
|
||
/* Do these three do anything useful at all, for any back end? */
|
||
#define bfd_debug_info_start(abfd) \
|
||
BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
|
||
|
||
#define bfd_debug_info_end(abfd) \
|
||
BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
|
||
|
||
#define bfd_debug_info_accumulate(abfd, section) \
|
||
BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
|
||
|
||
|
||
#define bfd_stat_arch_elt(abfd, stat) \
|
||
BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
|
||
|
||
#define bfd_set_arch_mach(abfd, arch, mach)\
|
||
BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
|
||
|
||
#define bfd_get_relocated_section_contents(abfd, link_info, link_order, data, relocateable, symbols) \
|
||
BFD_SEND (abfd, _bfd_get_relocated_section_contents, \
|
||
(abfd, link_info, link_order, data, relocateable, symbols))
|
||
|
||
#define bfd_relax_section(abfd, section, link_info, symbols) \
|
||
BFD_SEND (abfd, _bfd_relax_section, \
|
||
(abfd, section, link_info, symbols))
|
||
|
||
#define bfd_link_hash_table_create(abfd) \
|
||
BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
|
||
|
||
#define bfd_link_add_symbols(abfd, info) \
|
||
BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
|
||
|
||
#define bfd_final_link(abfd, info) \
|
||
BFD_SEND (abfd, _bfd_final_link, (abfd, info))
|
||
|
||
symindex
|
||
bfd_get_next_mapent PARAMS ((bfd *abfd, symindex previous, carsym **sym));
|
||
|
||
boolean
|
||
bfd_set_archive_head PARAMS ((bfd *output, bfd *new_head));
|
||
|
||
bfd *
|
||
bfd_get_elt_at_index PARAMS ((bfd *archive, int index));
|
||
|
||
bfd *
|
||
bfd_openr_next_archived_file PARAMS ((bfd *archive, bfd *previous));
|
||
|
||
CONST char *
|
||
bfd_core_file_failing_command PARAMS ((bfd *abfd));
|
||
|
||
int
|
||
bfd_core_file_failing_signal PARAMS ((bfd *abfd));
|
||
|
||
boolean
|
||
core_file_matches_executable_p
|
||
PARAMS ((bfd *core_bfd, bfd *exec_bfd));
|
||
|
||
#define BFD_SEND(bfd, message, arglist) \
|
||
((*((bfd)->xvec->message)) arglist)
|
||
#define BFD_SEND_FMT(bfd, message, arglist) \
|
||
(((bfd)->xvec->message[(int)((bfd)->format)]) arglist)
|
||
enum bfd_flavour {
|
||
bfd_target_unknown_flavour,
|
||
bfd_target_aout_flavour,
|
||
bfd_target_coff_flavour,
|
||
bfd_target_ecoff_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_som_flavour};
|
||
|
||
/* Forward declaration. */
|
||
typedef struct bfd_link_info _bfd_link_info;
|
||
|
||
typedef struct bfd_target
|
||
{
|
||
char *name;
|
||
enum bfd_flavour flavour;
|
||
boolean byteorder_big_p;
|
||
boolean header_byteorder_big_p;
|
||
flagword object_flags;
|
||
flagword section_flags;
|
||
char symbol_leading_char;
|
||
char ar_pad_char;
|
||
unsigned short ar_max_namelen;
|
||
unsigned int align_power_min;
|
||
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 *));
|
||
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 *));
|
||
struct bfd_target * (*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *));
|
||
boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
|
||
boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *));
|
||
char * (*_core_file_failing_command) PARAMS ((bfd *));
|
||
int (*_core_file_failing_signal) PARAMS ((bfd *));
|
||
boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *));
|
||
boolean (*_bfd_slurp_armap) PARAMS ((bfd *));
|
||
boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *));
|
||
void (*_bfd_truncate_arname) PARAMS ((bfd *, CONST char *, char *));
|
||
boolean (*write_armap) PARAMS ((bfd *arch,
|
||
unsigned int elength,
|
||
struct orl *map,
|
||
unsigned int orl_count,
|
||
int stridx));
|
||
boolean (*_close_and_cleanup) PARAMS ((bfd *));
|
||
boolean (*_bfd_set_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
|
||
file_ptr, bfd_size_type));
|
||
boolean (*_bfd_get_section_contents) PARAMS ((bfd *, sec_ptr, PTR,
|
||
file_ptr, bfd_size_type));
|
||
boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr));
|
||
unsigned int (*_get_symtab_upper_bound) PARAMS ((bfd *));
|
||
unsigned int (*_bfd_canonicalize_symtab) PARAMS ((bfd *,
|
||
struct symbol_cache_entry **));
|
||
unsigned int (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr));
|
||
unsigned int (*_bfd_canonicalize_reloc) PARAMS ((bfd *, sec_ptr, arelent **,
|
||
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))
|
||
alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *));
|
||
|
||
boolean (*_bfd_set_arch_mach) PARAMS ((bfd *, enum bfd_architecture,
|
||
unsigned long));
|
||
|
||
bfd * (*openr_next_archived_file) PARAMS ((bfd *arch, bfd *prev));
|
||
|
||
boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd,
|
||
struct sec *section, struct symbol_cache_entry **symbols,
|
||
bfd_vma offset, CONST char **file, CONST char **func,
|
||
unsigned int *line));
|
||
|
||
int (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *));
|
||
|
||
int (*_bfd_sizeof_headers) PARAMS ((bfd *, boolean));
|
||
|
||
void (*_bfd_debug_info_start) PARAMS ((bfd *));
|
||
void (*_bfd_debug_info_end) PARAMS ((bfd *));
|
||
void (*_bfd_debug_info_accumulate) PARAMS ((bfd *, struct sec *));
|
||
|
||
bfd_byte * (*_bfd_get_relocated_section_contents) PARAMS ((bfd *,
|
||
struct bfd_link_info *, struct bfd_link_order *,
|
||
bfd_byte *data, boolean relocateable,
|
||
struct symbol_cache_entry **));
|
||
|
||
boolean (*_bfd_relax_section) PARAMS ((bfd *, struct sec *,
|
||
struct bfd_link_info *, struct symbol_cache_entry **));
|
||
|
||
/* See documentation on reloc types. */
|
||
CONST struct reloc_howto_struct *
|
||
(*reloc_type_lookup) PARAMS ((bfd *abfd,
|
||
bfd_reloc_code_real_type code));
|
||
|
||
/* 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 *abfd,
|
||
void *ptr,
|
||
unsigned long size));
|
||
|
||
/* 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 *));
|
||
|
||
/* Add symbols from this object file into the hash table. */
|
||
boolean (*_bfd_link_add_symbols) PARAMS ((bfd *, 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 *));
|
||
|
||
PTR backend_data;
|
||
} bfd_target;
|
||
bfd_target *
|
||
bfd_find_target PARAMS ((CONST char *target_name, bfd *abfd));
|
||
|
||
CONST char **
|
||
bfd_target_list PARAMS ((void));
|
||
|
||
boolean
|
||
bfd_check_format PARAMS ((bfd *abfd, bfd_format format));
|
||
|
||
boolean
|
||
bfd_set_format PARAMS ((bfd *abfd, bfd_format format));
|
||
|
||
CONST char *
|
||
bfd_format_string PARAMS ((bfd_format format));
|
||
|
||
#endif
|