bfd/libbfd-in.h

   1 /* libbfd.h -- Declarations used by bfd library *implementation*.
   2    (This include file is not for users of the library.)
   3    Copyright 1990, 91, 92, 93, 94, 95, 96, 97, 1998 Free Software Foundation, Inc.
   4    Written by Cygnus Support.
   5
   6 ** NOTE: libbfd.h is a GENERATED file.  Don't change it; instead,
   7 ** change libbfd-in.h or the other BFD source files processed to
   8 ** generate this file.
   9
  10 This file is part of BFD, the Binary File Descriptor library.
  11
  12 This program is free software; you can redistribute it and/or modify
  13 it under the terms of the GNU General Public License as published by
  14 the Free Software Foundation; either version 2 of the License, or
  15 (at your option) any later version.
  16
  17 This program is distributed in the hope that it will be useful,
  18 but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 GNU General Public License for more details.
  21
  22 You should have received a copy of the GNU General Public License
  23 along with this program; if not, write to the Free Software
  24 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  25
  26 #ifdef ENABLE_NLS
  27 #include <libintl.h>
  28 #define _(String) dgettext (PACKAGE, String)
  29 #ifdef gettext_noop
  30 #define N_(String) gettext_noop (String)
  31 #else
  32 #define N_(String) (String)
  33 #endif
  34 #else
  35 /* Stubs that do something close enough.  */
  36 #define textdomain(String) (String)
  37 #define gettext(String) (String)
  38 #define dgettext(Domain,Message) (Message)
  39 #define dcgettext(Domain,Message,Type) (Message)
  40 #define bindtextdomain(Domain,Directory) (Domain)
  41 #define _(String) (String)
  42 #define N_(String) (String)
  43 /* In this case we don't care about the value.  */
  44 #ifndef LC_MESSAGES
  45 #define LC_MESSAGES 0
  46 #endif
  47 #endif
  48
  49 /* Align an address upward to a boundary, expressed as a number of bytes.
  50    E.g. align to an 8-byte boundary with argument of 8.  Take care never
  51    to wrap around if the address is within boundary-1 of the end of the
  52    address space.  */
  53 #define BFD_ALIGN(this, boundary)                                       \
  54   ((((bfd_vma) (this) + (boundary) - 1) >= (bfd_vma) (this))            \
  55    ? (((bfd_vma) (this) + ((boundary) - 1)) & (~((boundary)-1)))        \
  56    : ~ (bfd_vma) 0)
  57
  58 /* If you want to read and write large blocks, you might want to do it
  59    in quanta of this amount */
  60 #define DEFAULT_BUFFERSIZE 8192
  61
  62 /* Set a tdata field.  Can't use the other macros for this, since they
  63    do casts, and casting to the left of assignment isn't portable.  */
  64 #define set_tdata(bfd, v) ((bfd)->tdata.any = (PTR) (v))
  65
  66 /* If BFD_IN_MEMORY is set for a BFD, then the iostream fields points
  67    to an instance of this structure.  */
  68
  69 struct bfd_in_memory
  70 {
  71   /* Size of buffer.  */
  72   bfd_size_type size;
  73   /* Buffer holding contents of BFD.  */
  74   bfd_byte *buffer;
  75 };
  76
  77 /* tdata for an archive.  For an input archive, cache
  78    needs to be free()'d.  For an output archive, symdefs do.  */
  79
  80 struct artdata {
  81   file_ptr first_file_filepos;
  82   /* Speed up searching the armap */
  83   struct ar_cache *cache;
  84   bfd *archive_head;            /* Only interesting in output routines */
  85   carsym *symdefs;              /* the symdef entries */
  86   symindex symdef_count;             /* how many there are */
  87   char *extended_names;         /* clever intel extension */
  88   /* when more compilers are standard C, this can be a time_t */
  89   long  armap_timestamp;        /* Timestamp value written into armap.
  90                                    This is used for BSD archives to check
  91                                    that the timestamp is recent enough
  92                                    for the BSD linker to not complain,
  93                                    just before we finish writing an
  94                                    archive.  */
  95   file_ptr armap_datepos;       /* Position within archive to seek to
  96                                    rewrite the date field.  */
  97   PTR tdata;                    /* Backend specific information.  */
  98 };
  99
 100 #define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data)
 101
 102 /* Goes in bfd's arelt_data slot */
 103 struct areltdata {
 104   char * arch_header;                        /* it's actually a string */
 105   unsigned int parsed_size;     /* octets of filesize not including ar_hdr */
 106   char *filename;                            /* null-terminated */
 107 };
 108
 109 #define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size)
 110
 111 extern PTR bfd_malloc PARAMS ((size_t));
 112 extern PTR bfd_realloc PARAMS ((PTR, size_t));
 113 extern PTR bfd_zmalloc PARAMS ((size_t));
 114
 115 extern bfd_error_handler_type _bfd_error_handler;
 116
 117 /* These routines allocate and free things on the BFD's objalloc.  */
 118
 119 extern PTR bfd_alloc PARAMS ((bfd *, size_t));
 120 extern PTR bfd_zalloc PARAMS ((bfd *, size_t));
 121 extern void bfd_release PARAMS ((bfd *, PTR));
 122
 123 bfd *   _bfd_create_empty_archive_element_shell PARAMS ((bfd *obfd));
 124 bfd *   _bfd_look_for_bfd_in_cache PARAMS ((bfd *arch_bfd, file_ptr index));
 125 boolean _bfd_add_bfd_to_archive_cache PARAMS ((bfd *, file_ptr, bfd *));
 126 boolean _bfd_generic_mkarchive PARAMS ((bfd *abfd));
 127 const bfd_target *bfd_generic_archive_p PARAMS ((bfd *abfd));
 128 boolean bfd_slurp_armap PARAMS ((bfd *abfd));
 129 boolean bfd_slurp_bsd_armap_f2 PARAMS ((bfd *abfd));
 130 #define bfd_slurp_bsd_armap bfd_slurp_armap
 131 #define bfd_slurp_coff_armap bfd_slurp_armap
 132 boolean _bfd_slurp_extended_name_table PARAMS ((bfd *abfd));
 133 extern boolean _bfd_construct_extended_name_table
 134   PARAMS ((bfd *, boolean, char **, bfd_size_type *));
 135 boolean _bfd_write_archive_contents PARAMS ((bfd *abfd));
 136 boolean _bfd_compute_and_write_armap PARAMS ((bfd *, unsigned int elength));
 137 bfd *_bfd_get_elt_at_filepos PARAMS ((bfd *archive, file_ptr filepos));
 138 extern bfd *_bfd_generic_get_elt_at_index PARAMS ((bfd *, symindex));
 139 bfd * _bfd_new_bfd PARAMS ((void));
 140
 141 boolean bfd_false PARAMS ((bfd *ignore));
 142 boolean bfd_true PARAMS ((bfd *ignore));
 143 PTR     bfd_nullvoidptr PARAMS ((bfd *ignore));
 144 int     bfd_0 PARAMS ((bfd *ignore));
 145 unsigned int    bfd_0u PARAMS ((bfd *ignore));
 146 long    bfd_0l PARAMS ((bfd *ignore));
 147 long    _bfd_n1 PARAMS ((bfd *ignore));
 148 void    bfd_void PARAMS ((bfd *ignore));
 149
 150 bfd *_bfd_new_bfd_contained_in PARAMS ((bfd *));
 151 const bfd_target *_bfd_dummy_target PARAMS ((bfd *abfd));
 152
 153 void    bfd_dont_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
 154                                         char *hdr));
 155 void    bfd_bsd_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
 156                                         char *hdr));
 157 void    bfd_gnu_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
 158                                         char *hdr));
 159
 160 boolean bsd_write_armap PARAMS ((bfd *arch, unsigned int elength,
 161                                   struct orl *map, unsigned int orl_count, int stridx));
 162
 163 boolean coff_write_armap PARAMS ((bfd *arch, unsigned int elength,
 164                                    struct orl *map, unsigned int orl_count, int stridx));
 165
 166 extern PTR _bfd_generic_read_ar_hdr PARAMS ((bfd *));
 167
 168 extern PTR _bfd_generic_read_ar_hdr_mag PARAMS ((bfd *, const char *));
 169
 170 bfd *   bfd_generic_openr_next_archived_file PARAMS ((bfd *archive,
 171                                                      bfd *last_file));
 172
 173 int     bfd_generic_stat_arch_elt PARAMS ((bfd *, struct stat *));
 174
 175 #define _bfd_read_ar_hdr(abfd) \
 176   BFD_SEND (abfd, _bfd_read_ar_hdr_fn, (abfd))
 177 \f
 178 /* Generic routines to use for BFD_JUMP_TABLE_GENERIC.  Use
 179    BFD_JUMP_TABLE_GENERIC (_bfd_generic).  */
 180
 181 #define _bfd_generic_close_and_cleanup bfd_true
 182 #define _bfd_generic_bfd_free_cached_info bfd_true
 183 #define _bfd_generic_new_section_hook \
 184   ((boolean (*) PARAMS ((bfd *, asection *))) bfd_true)
 185 extern boolean _bfd_generic_get_section_contents
 186   PARAMS ((bfd *, asection *, PTR location, file_ptr offset,
 187            bfd_size_type count));
 188 extern boolean _bfd_generic_get_section_contents_in_window
 189   PARAMS ((bfd *, asection *, bfd_window *, file_ptr, bfd_size_type));
 190
 191 /* Generic routines to use for BFD_JUMP_TABLE_COPY.  Use
 192    BFD_JUMP_TABLE_COPY (_bfd_generic).  */
 193
 194 #define _bfd_generic_bfd_copy_private_bfd_data \
 195   ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
 196 #define _bfd_generic_bfd_merge_private_bfd_data \
 197   ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
 198 #define _bfd_generic_bfd_set_private_flags \
 199   ((boolean (*) PARAMS ((bfd *, flagword))) bfd_true)
 200 #define _bfd_generic_bfd_copy_private_section_data \
 201   ((boolean (*) PARAMS ((bfd *, asection *, bfd *, asection *))) bfd_true)
 202 #define _bfd_generic_bfd_copy_private_symbol_data \
 203   ((boolean (*) PARAMS ((bfd *, asymbol *, bfd *, asymbol *))) bfd_true)
 204 #define _bfd_generic_bfd_print_private_bfd_data \
 205   ((boolean (*) PARAMS ((bfd *, PTR))) bfd_true)
 206
 207 /* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file
 208    support.  Use BFD_JUMP_TABLE_CORE (_bfd_nocore).  */
 209
 210 extern char *_bfd_nocore_core_file_failing_command PARAMS ((bfd *));
 211 extern int _bfd_nocore_core_file_failing_signal PARAMS ((bfd *));
 212 extern boolean _bfd_nocore_core_file_matches_executable_p
 213   PARAMS ((bfd *, bfd *));
 214
 215 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive
 216    file support.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive).  */
 217
 218 #define _bfd_noarchive_slurp_armap bfd_false
 219 #define _bfd_noarchive_slurp_extended_name_table bfd_false
 220 #define _bfd_noarchive_construct_extended_name_table \
 221   ((boolean (*) PARAMS ((bfd *, char **, bfd_size_type *, const char **))) \
 222    bfd_false)
 223 #define _bfd_noarchive_truncate_arname \
 224   ((void (*) PARAMS ((bfd *, const char *, char *))) bfd_void)
 225 #define _bfd_noarchive_write_armap \
 226   ((boolean (*) \
 227     PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int))) \
 228    bfd_false)
 229 #define _bfd_noarchive_read_ar_hdr bfd_nullvoidptr
 230 #define _bfd_noarchive_openr_next_archived_file \
 231   ((bfd *(*) PARAMS ((bfd *, bfd *))) bfd_nullvoidptr)
 232 #define _bfd_noarchive_get_elt_at_index \
 233   ((bfd *(*) PARAMS ((bfd *, symindex))) bfd_nullvoidptr)
 234 #define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt
 235 #define _bfd_noarchive_update_armap_timestamp bfd_false
 236
 237 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style
 238    archives.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd).  */
 239
 240 #define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap
 241 #define _bfd_archive_bsd_slurp_extended_name_table \
 242   _bfd_slurp_extended_name_table
 243 extern boolean _bfd_archive_bsd_construct_extended_name_table
 244   PARAMS ((bfd *, char **, bfd_size_type *, const char **));
 245 #define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname
 246 #define _bfd_archive_bsd_write_armap bsd_write_armap
 247 #define _bfd_archive_bsd_read_ar_hdr _bfd_generic_read_ar_hdr
 248 #define _bfd_archive_bsd_openr_next_archived_file \
 249   bfd_generic_openr_next_archived_file
 250 #define _bfd_archive_bsd_get_elt_at_index _bfd_generic_get_elt_at_index
 251 #define _bfd_archive_bsd_generic_stat_arch_elt \
 252   bfd_generic_stat_arch_elt
 253 extern boolean _bfd_archive_bsd_update_armap_timestamp PARAMS ((bfd *));
 254
 255 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style
 256    archives.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff).  */
 257
 258 #define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap
 259 #define _bfd_archive_coff_slurp_extended_name_table \
 260   _bfd_slurp_extended_name_table
 261 extern boolean _bfd_archive_coff_construct_extended_name_table
 262   PARAMS ((bfd *, char **, bfd_size_type *, const char **));
 263 #define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname
 264 #define _bfd_archive_coff_write_armap coff_write_armap
 265 #define _bfd_archive_coff_read_ar_hdr _bfd_generic_read_ar_hdr
 266 #define _bfd_archive_coff_openr_next_archived_file \
 267   bfd_generic_openr_next_archived_file
 268 #define _bfd_archive_coff_get_elt_at_index _bfd_generic_get_elt_at_index
 269 #define _bfd_archive_coff_generic_stat_arch_elt \
 270   bfd_generic_stat_arch_elt
 271 #define _bfd_archive_coff_update_armap_timestamp bfd_true
 272
 273 /* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol
 274    support.  Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols).  */
 275
 276 #define _bfd_nosymbols_get_symtab_upper_bound _bfd_n1
 277 #define _bfd_nosymbols_get_symtab \
 278   ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
 279 #define _bfd_nosymbols_make_empty_symbol \
 280   ((asymbol *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
 281 #define _bfd_nosymbols_print_symbol \
 282   ((void (*) PARAMS ((bfd *, PTR, asymbol *, bfd_print_symbol_type))) bfd_void)
 283 #define _bfd_nosymbols_get_symbol_info \
 284   ((void (*) PARAMS ((bfd *, asymbol *, symbol_info *))) bfd_void)
 285 #define _bfd_nosymbols_bfd_is_local_label_name \
 286   ((boolean (*) PARAMS ((bfd *, const char *))) bfd_false)
 287 #define _bfd_nosymbols_get_lineno \
 288   ((alent *(*) PARAMS ((bfd *, asymbol *))) bfd_nullvoidptr)
 289 #define _bfd_nosymbols_find_nearest_line \
 290   ((boolean (*) \
 291     PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **, \
 292              const char **, unsigned int *))) \
 293    bfd_false)
 294 #define _bfd_nosymbols_bfd_make_debug_symbol \
 295   ((asymbol *(*) PARAMS ((bfd *, PTR, unsigned long))) bfd_nullvoidptr)
 296 #define _bfd_nosymbols_read_minisymbols \
 297   ((long (*) PARAMS ((bfd *, boolean, PTR *, unsigned int *))) _bfd_n1)
 298 #define _bfd_nosymbols_minisymbol_to_symbol \
 299   ((asymbol *(*) PARAMS ((bfd *, boolean, const PTR, asymbol *))) \
 300    bfd_nullvoidptr)
 301
 302 /* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc
 303    support.  Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs).  */
 304
 305 #define _bfd_norelocs_get_reloc_upper_bound \
 306   ((long (*) PARAMS ((bfd *, asection *))) _bfd_n1)
 307 #define _bfd_norelocs_canonicalize_reloc \
 308   ((long (*) PARAMS ((bfd *, asection *, arelent **, asymbol **))) _bfd_n1)
 309 #define _bfd_norelocs_bfd_reloc_type_lookup \
 310   ((reloc_howto_type *(*) PARAMS ((bfd *, bfd_reloc_code_real_type))) \
 311    bfd_nullvoidptr)
 312
 313 /* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not
 314    be written.  Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite).  */
 315
 316 #define _bfd_nowrite_set_arch_mach \
 317   ((boolean (*) PARAMS ((bfd *, enum bfd_architecture, unsigned long))) \
 318    bfd_false)
 319 #define _bfd_nowrite_set_section_contents \
 320   ((boolean (*) PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type))) \
 321    bfd_false)
 322
 323 /* Generic routines to use for BFD_JUMP_TABLE_WRITE.  Use
 324    BFD_JUMP_TABLE_WRITE (_bfd_generic).  */
 325
 326 #define _bfd_generic_set_arch_mach bfd_default_set_arch_mach
 327 extern boolean _bfd_generic_set_section_contents
 328   PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type));
 329
 330 /* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not
 331    support linking.  Use BFD_JUMP_TABLE_LINK (_bfd_nolink).  */
 332
 333 #define _bfd_nolink_sizeof_headers ((int (*) PARAMS ((bfd *, boolean))) bfd_0)
 334 #define _bfd_nolink_bfd_get_relocated_section_contents \
 335   ((bfd_byte *(*) \
 336     PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *, \
 337              bfd_byte *, boolean, asymbol **))) \
 338    bfd_nullvoidptr)
 339 #define _bfd_nolink_bfd_relax_section \
 340   ((boolean (*) \
 341     PARAMS ((bfd *, asection *, struct bfd_link_info *, boolean *))) \
 342    bfd_false)
 343 #define _bfd_nolink_bfd_link_hash_table_create \
 344   ((struct bfd_link_hash_table *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
 345 #define _bfd_nolink_bfd_link_add_symbols \
 346   ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
 347 #define _bfd_nolink_bfd_final_link \
 348   ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
 349 #define _bfd_nolink_bfd_link_split_section \
 350   ((boolean (*) PARAMS ((bfd *, struct sec *))) bfd_false)
 351
 352 /* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not
 353    have dynamic symbols or relocs.  Use BFD_JUMP_TABLE_DYNAMIC
 354    (_bfd_nodynamic).  */
 355
 356 #define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_n1
 357 #define _bfd_nodynamic_canonicalize_dynamic_symtab \
 358   ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
 359 #define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_n1
 360 #define _bfd_nodynamic_canonicalize_dynamic_reloc \
 361   ((long (*) PARAMS ((bfd *, arelent **, asymbol **))) _bfd_n1)
 362 \f
 363 /* Generic routine to determine of the given symbol is a local
 364    label.  */
 365 extern boolean bfd_generic_is_local_label_name PARAMS ((bfd *, const char *));
 366
 367 /* Generic minisymbol routines.  */
 368 extern long _bfd_generic_read_minisymbols
 369   PARAMS ((bfd *, boolean, PTR *, unsigned int *));
 370 extern asymbol *_bfd_generic_minisymbol_to_symbol
 371   PARAMS ((bfd *, boolean, const PTR, asymbol *));
 372
 373 /* Find the nearest line using .stab/.stabstr sections.  */
 374 extern boolean _bfd_stab_section_find_nearest_line
 375   PARAMS ((bfd *, asymbol **, asection *, bfd_vma, boolean *, const char **,
 376            const char **, unsigned int *, PTR *));
 377
 378 /* Find the nearest line using DWARF 2 debugging information.  */
 379 extern boolean _bfd_dwarf2_find_nearest_line
 380   PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **,
 381            const char **, unsigned int *));
 382
 383 /* A routine to create entries for a bfd_link_hash_table.  */
 384 extern struct bfd_hash_entry *_bfd_link_hash_newfunc
 385   PARAMS ((struct bfd_hash_entry *entry,
 386            struct bfd_hash_table *table,
 387            const char *string));
 388
 389 /* Initialize a bfd_link_hash_table.  */
 390 extern boolean _bfd_link_hash_table_init
 391   PARAMS ((struct bfd_link_hash_table *, bfd *,
 392            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
 393                                        struct bfd_hash_table *,
 394                                        const char *)));
 395
 396 /* Generic link hash table creation routine.  */
 397 extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create
 398   PARAMS ((bfd *));
 399
 400 /* Generic add symbol routine.  */
 401 extern boolean _bfd_generic_link_add_symbols
 402   PARAMS ((bfd *, struct bfd_link_info *));
 403
 404 /* Generic add symbol routine.  This version is used by targets for
 405    which the linker must collect constructors and destructors by name,
 406    as the collect2 program does.  */
 407 extern boolean _bfd_generic_link_add_symbols_collect
 408   PARAMS ((bfd *, struct bfd_link_info *));
 409
 410 /* Generic archive add symbol routine.  */
 411 extern boolean _bfd_generic_link_add_archive_symbols
 412   PARAMS ((bfd *, struct bfd_link_info *,
 413            boolean (*checkfn) (bfd *, struct bfd_link_info *, boolean *)));
 414
 415
 416
 417 /* Forward declaration to avoid prototype errors.  */
 418 typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
 419
 420 /* Generic routine to add a single symbol.  */
 421 extern boolean _bfd_generic_link_add_one_symbol
 422   PARAMS ((struct bfd_link_info *, bfd *, const char *name, flagword,
 423            asection *, bfd_vma, const char *, boolean copy,
 424            boolean constructor, struct bfd_link_hash_entry **));
 425
 426 /* Generic link routine.  */
 427 extern boolean _bfd_generic_final_link
 428   PARAMS ((bfd *, struct bfd_link_info *));
 429
 430 extern boolean _bfd_generic_link_split_section
 431   PARAMS ((bfd *, struct sec *));
 432
 433 /* Generic reloc_link_order processing routine.  */
 434 extern boolean _bfd_generic_reloc_link_order
 435   PARAMS ((bfd *, struct bfd_link_info *, asection *,
 436            struct bfd_link_order *));
 437
 438 /* Default link order processing routine.  */
 439 extern boolean _bfd_default_link_order
 440   PARAMS ((bfd *, struct bfd_link_info *, asection *,
 441            struct bfd_link_order *));
 442
 443 /* Count the number of reloc entries in a link order list.  */
 444 extern unsigned int _bfd_count_link_order_relocs
 445   PARAMS ((struct bfd_link_order *));
 446
 447 /* Final link relocation routine.  */
 448 extern bfd_reloc_status_type _bfd_final_link_relocate
 449   PARAMS ((reloc_howto_type *, bfd *, asection *, bfd_byte *,
 450            bfd_vma address, bfd_vma value, bfd_vma addend));
 451
 452 /* Relocate a particular location by a howto and a value.  */
 453 extern bfd_reloc_status_type _bfd_relocate_contents
 454   PARAMS ((reloc_howto_type *, bfd *, bfd_vma, bfd_byte *));
 455
 456 /* Link stabs in sections in the first pass.  */
 457
 458 extern boolean _bfd_link_section_stabs
 459   PARAMS ((bfd *, PTR *, asection *, asection *, PTR *));
 460
 461 /* Write out the .stab section when linking stabs in sections.  */
 462
 463 extern boolean _bfd_write_section_stabs
 464   PARAMS ((bfd *, PTR *, asection *, PTR *, bfd_byte *));
 465
 466 /* Write out the .stabstr string table when linking stabs in sections.  */
 467
 468 extern boolean _bfd_write_stab_strings PARAMS ((bfd *, PTR *));
 469
 470 /* Find an offset within a .stab section when linking stabs in
 471    sections.  */
 472
 473 extern bfd_vma _bfd_stab_section_offset
 474   PARAMS ((bfd *, PTR *, asection *, PTR *, bfd_vma));
 475
 476 /* Create a string table.  */
 477 extern struct bfd_strtab_hash *_bfd_stringtab_init PARAMS ((void));
 478
 479 /* Create an XCOFF .debug section style string table.  */
 480 extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init PARAMS ((void));
 481
 482 /* Free a string table.  */
 483 extern void _bfd_stringtab_free PARAMS ((struct bfd_strtab_hash *));
 484
 485 /* Get the size of a string table.  */
 486 extern bfd_size_type _bfd_stringtab_size PARAMS ((struct bfd_strtab_hash *));
 487
 488 /* Add a string to a string table.  */
 489 extern bfd_size_type _bfd_stringtab_add
 490   PARAMS ((struct bfd_strtab_hash *, const char *, boolean hash,
 491            boolean copy));
 492
 493 /* Write out a string table.  */
 494 extern boolean _bfd_stringtab_emit PARAMS ((bfd *, struct bfd_strtab_hash *));
 495 \f
 496 /* Macros to tell if bfds are read or write enabled.
 497
 498    Note that bfds open for read may be scribbled into if the fd passed
 499    to bfd_fdopenr is actually open both for read and write
 500    simultaneously.  However an output bfd will never be open for
 501    read.  Therefore sometimes you want to check bfd_read_p or
 502    !bfd_read_p, and only sometimes bfd_write_p.
 503 */
 504
 505 #define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
 506 #define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
 507
 508 void    bfd_assert PARAMS ((const char*,int));
 509
 510 #define BFD_ASSERT(x) \
 511 { if (!(x)) bfd_assert(__FILE__,__LINE__); }
 512
 513 #define BFD_FAIL() \
 514 { bfd_assert(__FILE__,__LINE__); }
 515
 516 FILE *  bfd_cache_lookup_worker PARAMS ((bfd *));
 517
 518 extern bfd *bfd_last_cache;
 519
 520 /* List of supported target vectors, and the default vector (if
 521    bfd_default_vector[0] is NULL, there is no default).  */
 522 extern const bfd_target * const bfd_target_vector[];
 523 extern const bfd_target *bfd_default_vector[];
 524
 525 /* Functions shared by the ECOFF and MIPS ELF backends, which have no
 526    other common header files.  */
 527
 528 #if defined(__STDC__) || defined(ALMOST_STDC)
 529 struct ecoff_find_line;
 530 #endif
 531
 532 extern boolean _bfd_ecoff_locate_line
 533   PARAMS ((bfd *, asection *, bfd_vma, struct ecoff_debug_info * const,
 534            const struct ecoff_debug_swap * const, struct ecoff_find_line *,
 535            const char **, const char **, unsigned int *));
 536 extern boolean _bfd_ecoff_get_accumulated_pdr PARAMS ((PTR, bfd_byte *));
 537 extern boolean _bfd_ecoff_get_accumulated_sym PARAMS ((PTR, bfd_byte *));
 538 extern boolean _bfd_ecoff_get_accumulated_ss PARAMS ((PTR, bfd_byte *));
 539
 540 extern bfd_vma _bfd_get_gp_value PARAMS ((bfd *));
 541 extern void _bfd_set_gp_value PARAMS ((bfd *, bfd_vma));
 542
 543 /* Function shared by the COFF and ELF SH backends, which have no
 544    other common header files.  */
 545
 546 extern boolean _bfd_sh_align_load_span
 547   PARAMS ((bfd *, asection *, bfd_byte *,
 548            boolean (*) (bfd *, asection *, PTR, bfd_byte *, bfd_vma),
 549            PTR, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, boolean *));
 550
 551 /* And more follows */
 552