e914ed5219
* aoutx.h: String hash functions moved to hash.c. Retain simplified versions of add_to_stringtab and emit_stringtab. Change all callers to use new function and structure names. * libbfd-in.h (_bfd_stringtab_init, _bfd_stringtab_free): Declare. (_bfd_stringtab_size, _bfd_stringtab_add): Declare. (_bfd_stringtab_emit): Declare. * libbfd.h: Rebuilt.
418 lines
16 KiB
C
418 lines
16 KiB
C
/* libbfd.h -- Declarations used by bfd library *implementation*.
|
||
(This include file is not for users of the library.)
|
||
Copyright 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
|
||
Written by Cygnus Support.
|
||
|
||
** NOTE: libbfd.h is a GENERATED file. Don't change it; instead,
|
||
** change libbfd-in.h or the other BFD source files processed to
|
||
** generate this file.
|
||
|
||
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. */
|
||
|
||
/* Align an address upward to a boundary, expressed as a number of bytes.
|
||
E.g. align to an 8-byte boundary with argument of 8. */
|
||
#define BFD_ALIGN(this, boundary) \
|
||
((( (this) + ((boundary) -1)) & (~((boundary)-1))))
|
||
|
||
/* If you want to read and write large blocks, you might want to do it
|
||
in quanta of this amount */
|
||
#define DEFAULT_BUFFERSIZE 8192
|
||
|
||
/* Set a tdata field. Can't use the other macros for this, since they
|
||
do casts, and casting to the left of assignment isn't portable. */
|
||
#define set_tdata(bfd, v) ((bfd)->tdata.any = (PTR) (v))
|
||
|
||
/* tdata for an archive. For an input archive, cache
|
||
needs to be free()'d. For an output archive, symdefs do. */
|
||
|
||
struct artdata {
|
||
file_ptr first_file_filepos;
|
||
/* Speed up searching the armap */
|
||
struct ar_cache *cache;
|
||
bfd *archive_head; /* Only interesting in output routines */
|
||
carsym *symdefs; /* the symdef entries */
|
||
symindex symdef_count; /* how many there are */
|
||
char *extended_names; /* clever intel extension */
|
||
/* when more compilers are standard C, this can be a time_t */
|
||
long armap_timestamp; /* Timestamp value written into armap.
|
||
This is used for BSD archives to check
|
||
that the timestamp is recent enough
|
||
for the BSD linker to not complain,
|
||
just before we finish writing an
|
||
archive. */
|
||
file_ptr armap_datepos; /* Position within archive to seek to
|
||
rewrite the date field. */
|
||
PTR tdata; /* Backend specific information. */
|
||
};
|
||
|
||
#define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data)
|
||
|
||
/* Goes in bfd's arelt_data slot */
|
||
struct areltdata {
|
||
char * arch_header; /* it's actually a string */
|
||
unsigned int parsed_size; /* octets of filesize not including ar_hdr */
|
||
char *filename; /* null-terminated */
|
||
};
|
||
|
||
#define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size)
|
||
|
||
char *bfd_zmalloc PARAMS ((bfd_size_type size));
|
||
|
||
/* These routines allocate and free things on the BFD's obstack. Note
|
||
that realloc can never occur in place. */
|
||
|
||
PTR bfd_alloc PARAMS ((bfd *abfd, size_t size));
|
||
PTR bfd_zalloc PARAMS ((bfd *abfd, size_t size));
|
||
PTR bfd_realloc PARAMS ((bfd *abfd, PTR orig, size_t size));
|
||
void bfd_alloc_grow PARAMS ((bfd *abfd, PTR thing, size_t size));
|
||
PTR bfd_alloc_finish PARAMS ((bfd *abfd));
|
||
PTR bfd_alloc_by_size_t PARAMS ((bfd *abfd, size_t wanted));
|
||
|
||
#define bfd_release(x,y) (void) obstack_free(&(x->memory),y)
|
||
|
||
bfd * _bfd_create_empty_archive_element_shell PARAMS ((bfd *obfd));
|
||
bfd * _bfd_look_for_bfd_in_cache PARAMS ((bfd *arch_bfd, file_ptr index));
|
||
boolean _bfd_add_bfd_to_archive_cache PARAMS ((bfd *, file_ptr, bfd *));
|
||
boolean _bfd_generic_mkarchive PARAMS ((bfd *abfd));
|
||
struct areltdata *_bfd_snarf_ar_hdr PARAMS ((bfd *abfd));
|
||
const bfd_target *bfd_generic_archive_p PARAMS ((bfd *abfd));
|
||
boolean bfd_slurp_armap PARAMS ((bfd *abfd));
|
||
boolean bfd_slurp_bsd_armap_f2 PARAMS ((bfd *abfd));
|
||
#define bfd_slurp_bsd_armap bfd_slurp_armap
|
||
#define bfd_slurp_coff_armap bfd_slurp_armap
|
||
boolean _bfd_slurp_extended_name_table PARAMS ((bfd *abfd));
|
||
boolean _bfd_write_archive_contents PARAMS ((bfd *abfd));
|
||
bfd *_bfd_get_elt_at_filepos PARAMS ((bfd *archive, file_ptr filepos));
|
||
bfd * _bfd_new_bfd PARAMS ((void));
|
||
|
||
#define DEFAULT_STRING_SPACE_SIZE 0x2000
|
||
boolean bfd_add_to_string_table PARAMS ((char **table, char *new_string,
|
||
unsigned int *table_length,
|
||
char **free_ptr));
|
||
|
||
boolean bfd_false PARAMS ((bfd *ignore));
|
||
boolean bfd_true PARAMS ((bfd *ignore));
|
||
PTR bfd_nullvoidptr PARAMS ((bfd *ignore));
|
||
int bfd_0 PARAMS ((bfd *ignore));
|
||
unsigned int bfd_0u PARAMS ((bfd *ignore));
|
||
long bfd_0l PARAMS ((bfd *ignore));
|
||
long _bfd_n1 PARAMS ((bfd *ignore));
|
||
void bfd_void PARAMS ((bfd *ignore));
|
||
|
||
bfd *_bfd_new_bfd_contained_in PARAMS ((bfd *));
|
||
const bfd_target *_bfd_dummy_target PARAMS ((bfd *abfd));
|
||
|
||
void bfd_dont_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
|
||
char *hdr));
|
||
void bfd_bsd_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
|
||
char *hdr));
|
||
void bfd_gnu_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
|
||
char *hdr));
|
||
|
||
boolean bsd_write_armap PARAMS ((bfd *arch, unsigned int elength,
|
||
struct orl *map, unsigned int orl_count, int stridx));
|
||
|
||
boolean coff_write_armap PARAMS ((bfd *arch, unsigned int elength,
|
||
struct orl *map, unsigned int orl_count, int stridx));
|
||
|
||
bfd * bfd_generic_openr_next_archived_file PARAMS ((bfd *archive,
|
||
bfd *last_file));
|
||
|
||
int bfd_generic_stat_arch_elt PARAMS ((bfd *, struct stat *));
|
||
|
||
|
||
/* Generic routines to use for BFD_JUMP_TABLE_GENERIC. Use
|
||
BFD_JUMP_TABLE_GENERIC (_bfd_generic). */
|
||
|
||
#define _bfd_generic_close_and_cleanup bfd_true
|
||
#define _bfd_generic_bfd_free_cached_info bfd_true
|
||
#define _bfd_generic_new_section_hook \
|
||
((boolean (*) PARAMS ((bfd *, asection *))) bfd_true)
|
||
extern boolean _bfd_generic_get_section_contents
|
||
PARAMS ((bfd *, asection *, PTR location, file_ptr offset,
|
||
bfd_size_type count));
|
||
|
||
/* Generic routines to use for BFD_JUMP_TABLE_COPY. Use
|
||
BFD_JUMP_TABLE_COPY (_bfd_generic). */
|
||
|
||
#define _bfd_generic_bfd_copy_private_bfd_data \
|
||
((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
|
||
#define _bfd_generic_bfd_copy_private_section_data \
|
||
((boolean (*) PARAMS ((bfd *, asection *, bfd *, asection *))) bfd_true)
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file
|
||
support. Use BFD_JUMP_TABLE_CORE (_bfd_nocore). */
|
||
|
||
extern char *_bfd_nocore_core_file_failing_command PARAMS ((bfd *));
|
||
extern int _bfd_nocore_core_file_failing_signal PARAMS ((bfd *));
|
||
extern boolean _bfd_nocore_core_file_matches_executable_p
|
||
PARAMS ((bfd *, bfd *));
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive
|
||
file support. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive). */
|
||
|
||
#define _bfd_noarchive_slurp_armap bfd_false
|
||
#define _bfd_noarchive_slurp_extended_name_table bfd_false
|
||
#define _bfd_noarchive_truncate_arname \
|
||
((void (*) PARAMS ((bfd *, const char *, char *))) bfd_void)
|
||
#define _bfd_noarchive_write_armap \
|
||
((boolean (*) \
|
||
PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int))) \
|
||
bfd_false)
|
||
#define _bfd_noarchive_openr_next_archived_file \
|
||
((bfd *(*) PARAMS ((bfd *, bfd *))) bfd_nullvoidptr)
|
||
#define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style
|
||
archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd). */
|
||
|
||
#define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap
|
||
#define _bfd_archive_bsd_slurp_extended_name_table \
|
||
_bfd_slurp_extended_name_table
|
||
#define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname
|
||
#define _bfd_archive_bsd_write_armap bsd_write_armap
|
||
#define _bfd_archive_bsd_openr_next_archived_file \
|
||
bfd_generic_openr_next_archived_file
|
||
#define _bfd_archive_bsd_generic_stat_arch_elt \
|
||
bfd_generic_stat_arch_elt
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style
|
||
archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff). */
|
||
|
||
#define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap
|
||
#define _bfd_archive_coff_slurp_extended_name_table \
|
||
_bfd_slurp_extended_name_table
|
||
#define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname
|
||
#define _bfd_archive_coff_write_armap coff_write_armap
|
||
#define _bfd_archive_coff_openr_next_archived_file \
|
||
bfd_generic_openr_next_archived_file
|
||
#define _bfd_archive_coff_generic_stat_arch_elt \
|
||
bfd_generic_stat_arch_elt
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol
|
||
support. Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols). */
|
||
|
||
#define _bfd_nosymbols_get_symtab_upper_bound _bfd_n1
|
||
#define _bfd_nosymbols_get_symtab \
|
||
((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
|
||
#define _bfd_nosymbols_make_empty_symbol \
|
||
((asymbol *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
|
||
#define _bfd_nosymbols_print_symbol \
|
||
((void (*) PARAMS ((bfd *, PTR, asymbol *, bfd_print_symbol_type))) bfd_void)
|
||
#define _bfd_nosymbols_get_symbol_info \
|
||
((void (*) PARAMS ((bfd *, asymbol *, symbol_info *))) bfd_void)
|
||
#define _bfd_nosymbols_bfd_is_local_label \
|
||
((boolean (*) PARAMS ((bfd *, asymbol *))) bfd_false)
|
||
#define _bfd_nosymbols_get_lineno \
|
||
((alent *(*) PARAMS ((bfd *, asymbol *))) bfd_nullvoidptr)
|
||
#define _bfd_nosymbols_find_nearest_line \
|
||
((boolean (*) \
|
||
PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **, \
|
||
const char **, unsigned int *))) \
|
||
bfd_false)
|
||
#define _bfd_nosymbols_bfd_make_debug_symbol \
|
||
((asymbol *(*) PARAMS ((bfd *, PTR, unsigned long))) bfd_nullvoidptr)
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc
|
||
support. Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs). */
|
||
|
||
#define _bfd_norelocs_get_reloc_upper_bound \
|
||
((long (*) PARAMS ((bfd *, asection *))) _bfd_n1)
|
||
#define _bfd_norelocs_canonicalize_reloc \
|
||
((long (*) PARAMS ((bfd *, asection *, arelent **, asymbol **))) _bfd_n1)
|
||
#define _bfd_norelocs_bfd_reloc_type_lookup \
|
||
((const reloc_howto_type *(*) PARAMS ((bfd *, bfd_reloc_code_real_type))) \
|
||
bfd_nullvoidptr)
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not
|
||
be written. Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite). */
|
||
|
||
#define _bfd_nowrite_set_arch_mach \
|
||
((boolean (*) PARAMS ((bfd *, enum bfd_architecture, unsigned long))) \
|
||
bfd_false)
|
||
#define _bfd_nowrite_set_section_contents \
|
||
((boolean (*) PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type))) \
|
||
bfd_false)
|
||
|
||
/* Generic routines to use for BFD_JUMP_TABLE_WRITE. Use
|
||
BFD_JUMP_TABLE_WRITE (_bfd_generic). */
|
||
|
||
#define _bfd_generic_set_arch_mach bfd_default_set_arch_mach
|
||
extern boolean _bfd_generic_set_section_contents
|
||
PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type));
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not
|
||
support linking. Use BFD_JUMP_TABLE_LINK (_bfd_nolink). */
|
||
|
||
#define _bfd_nolink_sizeof_headers ((int (*) PARAMS ((bfd *, boolean))) bfd_0)
|
||
#define _bfd_nolink_bfd_get_relocated_section_contents \
|
||
((bfd_byte *(*) \
|
||
PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *, \
|
||
bfd_byte *, boolean, asymbol **))) \
|
||
bfd_nullvoidptr)
|
||
#define _bfd_nolink_bfd_relax_section \
|
||
((boolean (*) \
|
||
PARAMS ((bfd *, asection *, struct bfd_link_info *, boolean *))) \
|
||
bfd_false)
|
||
#define _bfd_nolink_bfd_link_hash_table_create \
|
||
((struct bfd_link_hash_table *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
|
||
#define _bfd_nolink_bfd_link_add_symbols \
|
||
((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
|
||
#define _bfd_nolink_bfd_final_link \
|
||
((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
|
||
|
||
/* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not
|
||
have dynamic symbols or relocs. Use BFD_JUMP_TABLE_DYNAMIC
|
||
(_bfd_nodynamic). */
|
||
|
||
#define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_n1
|
||
#define _bfd_nodynamic_canonicalize_dynamic_symtab \
|
||
((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
|
||
#define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_n1
|
||
#define _bfd_nodynamic_canonicalize_dynamic_reloc \
|
||
((long (*) PARAMS ((bfd *, arelent **, asymbol **))) _bfd_n1)
|
||
|
||
/* Generic routine to determine of the given symbol is a local
|
||
label. */
|
||
extern boolean bfd_generic_is_local_label PARAMS ((bfd *, asymbol *));
|
||
|
||
/* A routine to create entries for a bfd_link_hash_table. */
|
||
extern struct bfd_hash_entry *_bfd_link_hash_newfunc
|
||
PARAMS ((struct bfd_hash_entry *entry,
|
||
struct bfd_hash_table *table,
|
||
const char *string));
|
||
|
||
/* Initialize a bfd_link_hash_table. */
|
||
extern boolean _bfd_link_hash_table_init
|
||
PARAMS ((struct bfd_link_hash_table *, bfd *,
|
||
struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
|
||
struct bfd_hash_table *,
|
||
const char *)));
|
||
|
||
/* Generic link hash table creation routine. */
|
||
extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create
|
||
PARAMS ((bfd *));
|
||
|
||
/* Generic add symbol routine. */
|
||
extern boolean _bfd_generic_link_add_symbols
|
||
PARAMS ((bfd *, struct bfd_link_info *));
|
||
|
||
/* Generic add symbol routine. This version is used by targets for
|
||
which the linker must collect constructors and destructors by name,
|
||
as the collect2 program does. */
|
||
extern boolean _bfd_generic_link_add_symbols_collect
|
||
PARAMS ((bfd *, struct bfd_link_info *));
|
||
|
||
/* Generic archive add symbol routine. */
|
||
extern boolean _bfd_generic_link_add_archive_symbols
|
||
PARAMS ((bfd *, struct bfd_link_info *,
|
||
boolean (*checkfn) (bfd *, struct bfd_link_info *, boolean *)));
|
||
|
||
/* Forward declaration to avoid prototype errors. */
|
||
typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
|
||
|
||
/* Generic routine to add a single symbol. */
|
||
extern boolean _bfd_generic_link_add_one_symbol
|
||
PARAMS ((struct bfd_link_info *, bfd *, const char *name, flagword,
|
||
asection *, bfd_vma, const char *, boolean copy,
|
||
boolean constructor, struct bfd_link_hash_entry **));
|
||
|
||
/* Generic link routine. */
|
||
extern boolean _bfd_generic_final_link
|
||
PARAMS ((bfd *, struct bfd_link_info *));
|
||
|
||
/* Generic reloc_link_order processing routine. */
|
||
extern boolean _bfd_generic_reloc_link_order
|
||
PARAMS ((bfd *, struct bfd_link_info *, asection *,
|
||
struct bfd_link_order *));
|
||
|
||
/* Default link order processing routine. */
|
||
extern boolean _bfd_default_link_order
|
||
PARAMS ((bfd *, struct bfd_link_info *, asection *,
|
||
struct bfd_link_order *));
|
||
|
||
/* Count the number of reloc entries in a link order list. */
|
||
extern unsigned int _bfd_count_link_order_relocs
|
||
PARAMS ((struct bfd_link_order *));
|
||
|
||
/* Final link relocation routine. */
|
||
extern bfd_reloc_status_type _bfd_final_link_relocate
|
||
PARAMS ((const reloc_howto_type *, bfd *, asection *, bfd_byte *,
|
||
bfd_vma address, bfd_vma value, bfd_vma addend));
|
||
|
||
/* Relocate a particular location by a howto and a value. */
|
||
extern bfd_reloc_status_type _bfd_relocate_contents
|
||
PARAMS ((const reloc_howto_type *, bfd *, bfd_vma, bfd_byte *));
|
||
|
||
/* Create a string table. */
|
||
extern struct bfd_strtab_hash *_bfd_stringtab_init PARAMS ((void));
|
||
|
||
/* Free a string table. */
|
||
extern void _bfd_stringtab_free PARAMS ((struct bfd_strtab_hash *));
|
||
|
||
/* Get the size of a string table. */
|
||
extern bfd_size_type _bfd_stringtab_size PARAMS ((struct bfd_strtab_hash *));
|
||
|
||
/* Add a string to a string table. */
|
||
extern bfd_size_type _bfd_stringtab_add
|
||
PARAMS ((struct bfd_strtab_hash *, const char *, boolean hash,
|
||
boolean copy));
|
||
|
||
/* Write out a string table. */
|
||
extern boolean _bfd_stringtab_emit PARAMS ((bfd *, struct bfd_strtab_hash *));
|
||
|
||
/* Macros to tell if bfds are read or write enabled.
|
||
|
||
Note that bfds open for read may be scribbled into if the fd passed
|
||
to bfd_fdopenr is actually open both for read and write
|
||
simultaneously. However an output bfd will never be open for
|
||
read. Therefore sometimes you want to check bfd_read_p or
|
||
!bfd_read_p, and only sometimes bfd_write_p.
|
||
*/
|
||
|
||
#define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
|
||
#define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
|
||
|
||
void bfd_assert PARAMS ((char*,int));
|
||
|
||
#define BFD_ASSERT(x) \
|
||
{ if (!(x)) bfd_assert(__FILE__,__LINE__); }
|
||
|
||
#define BFD_FAIL() \
|
||
{ bfd_assert(__FILE__,__LINE__); }
|
||
|
||
FILE * bfd_cache_lookup_worker PARAMS ((bfd *));
|
||
|
||
extern bfd *bfd_last_cache;
|
||
|
||
/* Now Steve, what's the story here? */
|
||
#ifdef lint
|
||
#define itos(x) "l"
|
||
#define stoi(x) 1
|
||
#else
|
||
#define itos(x) ((char*)(x))
|
||
#define stoi(x) ((int)(x))
|
||
#endif
|
||
|
||
/* List of supported target vectors, and the default vector (if
|
||
bfd_default_vector[0] is NULL, there is no default). */
|
||
extern const bfd_target * const bfd_target_vector[];
|
||
extern const bfd_target * const bfd_default_vector[];
|
||
|
||
/* And more follows */
|
||
|