bfd/libbfd.h

   1 /* libbfd.h -- Declarations used by bfd library *implementation*.
   2    (This include file is not for users of the library.)
   3    Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
   4    Written by Cygnus Support.
   5
   6 This file is part of BFD, the Binary File Descriptor library.
   7
   8 This program is free software; you can redistribute it and/or modify
   9 it under the terms of the GNU General Public License as published by
  10 the Free Software Foundation; either version 2 of the License, or
  11 (at your option) any later version.
  12
  13 This program is distributed in the hope that it will be useful,
  14 but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 GNU General Public License for more details.
  17
  18 You should have received a copy of the GNU General Public License
  19 along with this program; if not, write to the Free Software
  20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  21
  22
  23 /* Align an address upward to a boundary, expressed as a number of bytes.
  24    E.g. align to an 8-byte boundary with argument of 8.  */
  25 #define BFD_ALIGN(this, boundary) \
  26   ((( (this) + ((boundary) -1)) & (~((boundary)-1))))
  27
  28 /* If you want to read and write large blocks, you might want to do it
  29    in quanta of this amount */
  30 #define DEFAULT_BUFFERSIZE 8192
  31
  32 /* Set a tdata field.  Can't use the other macros for this, since they
  33    do casts, and casting to the left of assignment isn't portable.  */
  34 #define set_tdata(bfd, v) ((bfd)->tdata.any = (PTR) (v))
  35
  36 /* tdata for an archive.  For an input archive, cache
  37    needs to be free()'d.  For an output archive, symdefs do.  */
  38
  39 struct artdata {
  40   file_ptr first_file_filepos;
  41   /* Speed up searching the armap */
  42   struct ar_cache *cache;
  43   bfd *archive_head;            /* Only interesting in output routines */
  44   carsym *symdefs;              /* the symdef entries */
  45   symindex symdef_count;             /* how many there are */
  46   char *extended_names;         /* clever intel extension */
  47 };
  48
  49 #define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data)
  50
  51 /* Goes in bfd's arelt_data slot */
  52 struct areltdata {
  53   char * arch_header;                        /* it's actually a string */
  54   unsigned int parsed_size;     /* octets of filesize not including ar_hdr */
  55   char *filename;                            /* null-terminated */
  56 };
  57
  58 #define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size)
  59
  60 char *zalloc PARAMS ((bfd_size_type size));
  61
  62 /* These routines allocate and free things on the BFD's obstack.  Note
  63    that realloc can never occur in place.  */
  64
  65 PTR     bfd_alloc PARAMS ((bfd *abfd, bfd_size_type size));
  66 PTR     bfd_zalloc PARAMS ((bfd *abfd, bfd_size_type size));
  67 PTR     bfd_realloc PARAMS ((bfd *abfd, PTR orig, bfd_size_type new));
  68 void    bfd_alloc_grow PARAMS ((bfd *abfd, PTR thing, bfd_size_type size));
  69 PTR     bfd_alloc_finish PARAMS ((bfd *abfd));
  70 PTR     bfd_alloc_by_size_t PARAMS ((bfd *abfd, size_t wanted));
  71
  72 #define bfd_release(x,y) (void) obstack_free(&(x->memory),y)
  73
  74
  75 bfd_size_type   bfd_read  PARAMS ((PTR ptr, bfd_size_type size,
  76                                    bfd_size_type nitems, bfd *abfd));
  77 bfd_size_type   bfd_write PARAMS ((CONST PTR ptr, bfd_size_type size,
  78                                    bfd_size_type nitems, bfd *abfd));
  79 int             bfd_seek  PARAMS ((bfd* CONST abfd, CONST file_ptr fp,
  80                                    CONST int direction));
  81 long            bfd_tell  PARAMS ((bfd *abfd));
  82
  83 bfd *   _bfd_create_empty_archive_element_shell PARAMS ((bfd *obfd));
  84 bfd *   look_for_bfd_in_cache PARAMS ((bfd *arch_bfd, file_ptr index));
  85 boolean _bfd_generic_mkarchive PARAMS ((bfd *abfd));
  86 struct areltdata *      snarf_ar_hdr PARAMS ((bfd *abfd));
  87 bfd_target *            bfd_generic_archive_p PARAMS ((bfd *abfd));
  88 boolean bfd_slurp_armap PARAMS ((bfd *abfd));
  89 boolean bfd_slurp_bsd_armap_f2 PARAMS ((bfd *abfd));
  90 #define bfd_slurp_bsd_armap bfd_slurp_armap
  91 #define bfd_slurp_coff_armap bfd_slurp_armap
  92 boolean _bfd_slurp_extended_name_table PARAMS ((bfd *abfd));
  93 boolean _bfd_write_archive_contents PARAMS ((bfd *abfd));
  94 bfd *   new_bfd PARAMS (());
  95
  96 #define DEFAULT_STRING_SPACE_SIZE 0x2000
  97 boolean bfd_add_to_string_table PARAMS ((char **table, char *new_string,
  98                                          unsigned int *table_length,
  99                                          char **free_ptr));
 100
 101 /* Byte swapping routines from libbfd.c */
 102
 103 bfd_vma         _do_getb64         PARAMS ((unsigned char *addr));
 104 bfd_vma         _do_getl64         PARAMS ((unsigned char *addr));
 105 bfd_signed_vma  _do_getb_signed_64 PARAMS ((unsigned char *addr));
 106 bfd_signed_vma  _do_getl_signed_64 PARAMS ((unsigned char *addr));
 107 bfd_vma         _do_getb32         PARAMS ((unsigned char *addr));
 108 bfd_vma         _do_getl32         PARAMS ((unsigned char *addr));
 109 bfd_signed_vma  _do_getb_signed_32 PARAMS ((unsigned char *addr));
 110 bfd_signed_vma  _do_getl_signed_32 PARAMS ((unsigned char *addr));
 111 bfd_vma         _do_getb16         PARAMS ((unsigned char *addr));
 112 bfd_vma         _do_getl16         PARAMS ((unsigned char *addr));
 113 bfd_signed_vma  _do_getb_signed_16 PARAMS ((unsigned char *addr));
 114 bfd_signed_vma  _do_getl_signed_16 PARAMS ((unsigned char *addr));
 115 void            _do_putb64         PARAMS ((bfd_vma data, unsigned char *addr));
 116 void            _do_putl64         PARAMS ((bfd_vma data, unsigned char *addr));
 117 void            _do_putb32         PARAMS ((bfd_vma data, unsigned char *addr));
 118 void            _do_putl32         PARAMS ((bfd_vma data, unsigned char *addr));
 119 void            _do_putb16         PARAMS ((bfd_vma data, unsigned char *addr));
 120 void            _do_putl16         PARAMS ((bfd_vma data, unsigned char *addr));
 121
 122 boolean bfd_false PARAMS ((bfd *ignore));
 123 boolean bfd_true PARAMS ((bfd *ignore));
 124 PTR     bfd_nullvoidptr PARAMS ((bfd *ignore));
 125 int     bfd_0 PARAMS ((bfd *ignore));
 126 unsigned int    bfd_0u PARAMS ((bfd *ignore));
 127 void    bfd_void PARAMS ((bfd *ignore));
 128
 129 bfd *   new_bfd_contained_in PARAMS ((bfd *));
 130 boolean  _bfd_dummy_new_section_hook PARAMS ((bfd *ignore, asection *newsect));
 131 char *   _bfd_dummy_core_file_failing_command PARAMS ((bfd *abfd));
 132 int      _bfd_dummy_core_file_failing_signal PARAMS ((bfd *abfd));
 133 boolean  _bfd_dummy_core_file_matches_executable_p PARAMS ((bfd *core_bfd,
 134                                                             bfd *exec_bfd));
 135 bfd_target *    _bfd_dummy_target PARAMS ((bfd *abfd));
 136
 137 void    bfd_dont_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
 138                                         char *hdr));
 139 void    bfd_bsd_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
 140                                         char *hdr));
 141 void    bfd_gnu_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
 142                                         char *hdr));
 143
 144 boolean bsd_write_armap PARAMS ((bfd *arch, unsigned int elength,
 145                                   struct orl *map, unsigned int orl_count, int stridx));
 146
 147 boolean coff_write_armap PARAMS ((bfd *arch, unsigned int elength,
 148                                    struct orl *map, unsigned int orl_count, int stridx));
 149
 150 bfd *   bfd_generic_openr_next_archived_file PARAMS ((bfd *archive,
 151                                                      bfd *last_file));
 152
 153 int     bfd_generic_stat_arch_elt PARAMS ((bfd *, struct stat *));
 154
 155 boolean bfd_generic_get_section_contents PARAMS ((bfd *abfd, sec_ptr section,
 156                                                   PTR location, file_ptr offset,
 157                                                   bfd_size_type count));
 158
 159 boolean bfd_generic_set_section_contents PARAMS ((bfd *abfd, sec_ptr section,
 160                                                   PTR location, file_ptr offset,
 161                                                   bfd_size_type count));
 162
 163 /* Macros to tell if bfds are read or write enabled.
 164
 165    Note that bfds open for read may be scribbled into if the fd passed
 166    to bfd_fdopenr is actually open both for read and write
 167    simultaneously.  However an output bfd will never be open for
 168    read.  Therefore sometimes you want to check bfd_read_p or
 169    !bfd_read_p, and only sometimes bfd_write_p.
 170 */
 171
 172 #define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
 173 #define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
 174
 175 void    bfd_assert PARAMS ((char*,int));
 176
 177 #define BFD_ASSERT(x) \
 178 { if (!(x)) bfd_assert(__FILE__,__LINE__); }
 179
 180 #define BFD_FAIL() \
 181 { bfd_assert(__FILE__,__LINE__); }
 182
 183 FILE *  bfd_cache_lookup_worker PARAMS ((bfd *));
 184
 185 extern bfd *bfd_last_cache;
 186
 187 /* Now Steve, what's the story here? */
 188 #ifdef lint
 189 #define itos(x) "l"
 190 #define stoi(x) 1
 191 #else
 192 #define itos(x) ((char*)(x))
 193 #define stoi(x) ((int)(x))
 194 #endif
 195
 196 /* Generic routine for close_and_cleanup is really just bfd_true.  */
 197 #define bfd_generic_close_and_cleanup   bfd_true
 198
 199 /* And more follows */
 200
 201 void
 202 bfd_check_init PARAMS ((void));
 203
 204 PTR
 205 bfd_xmalloc PARAMS (( bfd_size_type size));
 206
 207 void
 208 bfd_write_bigendian_4byte_int PARAMS ((bfd *abfd,  int i));
 209
 210 unsigned int
 211 bfd_log2 PARAMS ((bfd_vma x));
 212
 213 #define BFD_CACHE_MAX_OPEN 10
 214 extern bfd *bfd_last_cache;
 215
 216 #define bfd_cache_lookup(x) \
 217     ((x)==bfd_last_cache? \
 218       (FILE*)(bfd_last_cache->iostream): \
 219        bfd_cache_lookup_worker(x))
 220 boolean
 221 bfd_cache_close  PARAMS ((bfd *));
 222
 223 FILE*
 224 bfd_open_file PARAMS ((bfd *));
 225
 226 FILE *
 227 bfd_cache_lookup_worker PARAMS ((bfd *));
 228
 229 void
 230 bfd_constructor_entry PARAMS ((bfd *abfd,
 231     asymbol **symbol_ptr_ptr,
 232     CONST char*type));
 233
 234 CONST struct reloc_howto_struct *
 235 bfd_default_reloc_type_lookup
 236  PARAMS ((bfd *abfd AND
 237     bfd_reloc_code_real_type  code));
 238
 239 boolean
 240 bfd_generic_relax_section
 241  PARAMS ((bfd *abfd,
 242     asection *section,
 243     asymbol **symbols));
 244
 245 bfd_byte *
 246
 247 bfd_generic_get_relocated_section_contents  PARAMS ((bfd *abfd,
 248     struct bfd_seclet *seclet,
 249     bfd_byte *data,
 250     boolean relocateable));
 251
 252 boolean
 253 bfd_generic_seclet_link
 254  PARAMS ((bfd *abfd,
 255     PTR data,
 256     boolean relocateable));
 257
 258 extern bfd_arch_info_type bfd_default_arch_struct;
 259 boolean
 260 bfd_default_set_arch_mach PARAMS ((bfd *abfd,
 261     enum bfd_architecture arch,
 262     unsigned long mach));
 263
 264 void
 265 bfd_arch_init PARAMS ((void));
 266
 267 void
 268 bfd_arch_linkin PARAMS ((bfd_arch_info_type *));
 269
 270 CONST bfd_arch_info_type *
 271 bfd_default_compatible
 272  PARAMS ((CONST bfd_arch_info_type *a,
 273     CONST bfd_arch_info_type *b));
 274
 275 boolean
 276 bfd_default_scan PARAMS ((CONST struct bfd_arch_info *, CONST char *));
 277
 278 struct elf_internal_shdr *
 279 bfd_elf32_find_section  PARAMS ((bfd *abfd, char *name));
 280