bfd/bfd-in2.h

   1 /* DO NOT EDIT!  -*- buffer-read-only: t -*-  This file is automatically
   2    generated from "bfd-in.h", "init.c", "opncls.c", "libbfd.c",
   3    "bfdio.c", "bfdwin.c", "section.c", "archures.c", "reloc.c",
   4    "syms.c", "bfd.c", "archive.c", "corefile.c", "targets.c", "format.c",
   5    "linker.c" and "simple.c".
   6    Run "make headers" in your build bfd/ to regenerate.  */
   7
   8 /* Main header file for the bfd library -- portable access to object files.
   9
  10    Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
  11    1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
  12
  13    Contributed by Cygnus Support.
  14
  15    This file is part of BFD, the Binary File Descriptor library.
  16
  17    This program is free software; you can redistribute it and/or modify
  18    it under the terms of the GNU General Public License as published by
  19    the Free Software Foundation; either version 2 of the License, or
  20    (at your option) any later version.
  21
  22    This program is distributed in the hope that it will be useful,
  23    but WITHOUT ANY WARRANTY; without even the implied warranty of
  24    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  25    GNU General Public License for more details.
  26
  27    You should have received a copy of the GNU General Public License
  28    along with this program; if not, write to the Free Software
  29    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  30
  31 #ifndef __BFD_H_SEEN__
  32 #define __BFD_H_SEEN__
  33
  34 #ifdef __cplusplus
  35 extern "C" {
  36 #endif
  37
  38 #include "ansidecl.h"
  39 #include "symcat.h"
  40 #if defined (__STDC__) || defined (ALMOST_STDC) || defined (HAVE_STRINGIZE)
  41 #ifndef SABER
  42 /* This hack is to avoid a problem with some strict ANSI C preprocessors.
  43    The problem is, "32_" is not a valid preprocessing token, and we don't
  44    want extra underscores (e.g., "nlm_32_").  The XCONCAT2 macro will
  45    cause the inner CONCAT2 macros to be evaluated first, producing
  46    still-valid pp-tokens.  Then the final concatenation can be done.  */
  47 #undef CONCAT4
  48 #define CONCAT4(a,b,c,d) XCONCAT2(CONCAT2(a,b),CONCAT2(c,d))
  49 #endif
  50 #endif
  51
  52 /* The word size used by BFD on the host.  This may be 64 with a 32
  53    bit target if the host is 64 bit, or if other 64 bit targets have
  54    been selected with --enable-targets, or if --enable-64-bit-bfd.  */
  55 #define BFD_ARCH_SIZE @wordsize@
  56
  57 /* The word size of the default bfd target.  */
  58 #define BFD_DEFAULT_TARGET_SIZE @bfd_default_target_size@
  59
  60 #define BFD_HOST_64BIT_LONG @BFD_HOST_64BIT_LONG@
  61 #if @BFD_HOST_64_BIT_DEFINED@
  62 #define BFD_HOST_64_BIT @BFD_HOST_64_BIT@
  63 #define BFD_HOST_U_64_BIT @BFD_HOST_U_64_BIT@
  64 #endif
  65
  66 #if BFD_ARCH_SIZE >= 64
  67 #define BFD64
  68 #endif
  69
  70 #ifndef INLINE
  71 #if __GNUC__ >= 2
  72 #define INLINE __inline__
  73 #else
  74 #define INLINE
  75 #endif
  76 #endif
  77
  78 /* Forward declaration.  */
  79 typedef struct bfd bfd;
  80
  81 /* Boolean type used in bfd.  Too many systems define their own
  82    versions of "boolean" for us to safely typedef a "boolean" of
  83    our own.  Using an enum for "bfd_boolean" has its own set of
  84    problems, with strange looking casts required to avoid warnings
  85    on some older compilers.  Thus we just use an int.
  86
  87    General rule: Functions which are bfd_boolean return TRUE on
  88    success and FALSE on failure (unless they're a predicate).  */
  89
  90 typedef int bfd_boolean;
  91 #undef FALSE
  92 #undef TRUE
  93 #define FALSE 0
  94 #define TRUE 1
  95
  96 #if 0
  97 /* Poison.  */
  98 #undef false
  99 #undef true
 100 #define false dont_use_false_in_bfd
 101 #define true dont_use_true_in_bfd
 102 #endif
 103
 104 /* Support for different sizes of target format ints and addresses.
 105    If the type `long' is at least 64 bits, BFD_HOST_64BIT_LONG will be
 106    set to 1 above.  Otherwise, if gcc is being used, this code will
 107    use gcc's "long long" type.  Otherwise, BFD_HOST_64_BIT must be
 108    defined above.  */
 109
 110 #ifndef BFD_HOST_64_BIT
 111 # if BFD_HOST_64BIT_LONG
 112 #  define BFD_HOST_64_BIT long
 113 #  define BFD_HOST_U_64_BIT unsigned long
 114 # else
 115 #  ifdef __GNUC__
 116 #   if __GNUC__ >= 2
 117 #    define BFD_HOST_64_BIT long long
 118 #    define BFD_HOST_U_64_BIT unsigned long long
 119 #   endif /* __GNUC__ >= 2 */
 120 #  endif /* ! defined (__GNUC__) */
 121 # endif /* ! BFD_HOST_64BIT_LONG */
 122 #endif /* ! defined (BFD_HOST_64_BIT) */
 123
 124 #ifdef BFD64
 125
 126 #ifndef BFD_HOST_64_BIT
 127  #error No 64 bit integer type available
 128 #endif /* ! defined (BFD_HOST_64_BIT) */
 129
 130 typedef BFD_HOST_U_64_BIT bfd_vma;
 131 typedef BFD_HOST_64_BIT bfd_signed_vma;
 132 typedef BFD_HOST_U_64_BIT bfd_size_type;
 133 typedef BFD_HOST_U_64_BIT symvalue;
 134
 135 #ifndef fprintf_vma
 136 #if BFD_HOST_64BIT_LONG
 137 #define sprintf_vma(s,x) sprintf (s, "%016lx", x)
 138 #define fprintf_vma(f,x) fprintf (f, "%016lx", x)
 139 #else
 140 #define _bfd_int64_low(x) ((unsigned long) (((x) & 0xffffffff)))
 141 #define _bfd_int64_high(x) ((unsigned long) (((x) >> 32) & 0xffffffff))
 142 #define fprintf_vma(s,x) \
 143   fprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
 144 #define sprintf_vma(s,x) \
 145   sprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
 146 #endif
 147 #endif
 148
 149 #else /* not BFD64  */
 150
 151 /* Represent a target address.  Also used as a generic unsigned type
 152    which is guaranteed to be big enough to hold any arithmetic types
 153    we need to deal with.  */
 154 typedef unsigned long bfd_vma;
 155
 156 /* A generic signed type which is guaranteed to be big enough to hold any
 157    arithmetic types we need to deal with.  Can be assumed to be compatible
 158    with bfd_vma in the same way that signed and unsigned ints are compatible
 159    (as parameters, in assignment, etc).  */
 160 typedef long bfd_signed_vma;
 161
 162 typedef unsigned long symvalue;
 163 typedef unsigned long bfd_size_type;
 164
 165 /* Print a bfd_vma x on stream s.  */
 166 #define fprintf_vma(s,x) fprintf (s, "%08lx", x)
 167 #define sprintf_vma(s,x) sprintf (s, "%08lx", x)
 168
 169 #endif /* not BFD64  */
 170
 171 /* A pointer to a position in a file.  */
 172 /* FIXME:  This should be using off_t from <sys/types.h>.
 173    For now, try to avoid breaking stuff by not including <sys/types.h> here.
 174    This will break on systems with 64-bit file offsets (e.g. 4.4BSD).
 175    Probably the best long-term answer is to avoid using file_ptr AND off_t
 176    in this header file, and to handle this in the BFD implementation
 177    rather than in its interface.  */
 178 /* typedef off_t        file_ptr; */
 179 typedef bfd_signed_vma file_ptr;
 180 typedef bfd_vma ufile_ptr;
 181
 182 extern void bfd_sprintf_vma
 183   PARAMS ((bfd *, char *, bfd_vma));
 184 extern void bfd_fprintf_vma
 185   PARAMS ((bfd *, PTR, bfd_vma));
 186
 187 #define printf_vma(x) fprintf_vma(stdout,x)
 188 #define bfd_printf_vma(abfd,x) bfd_fprintf_vma (abfd,stdout,x)
 189
 190 typedef unsigned int flagword;  /* 32 bits of flags */
 191 typedef unsigned char bfd_byte;
 192 \f
 193 /* File formats.  */
 194
 195 typedef enum bfd_format
 196 {
 197   bfd_unknown = 0,      /* File format is unknown.  */
 198   bfd_object,           /* Linker/assember/compiler output.  */
 199   bfd_archive,          /* Object archive file.  */
 200   bfd_core,             /* Core dump.  */
 201   bfd_type_end          /* Marks the end; don't use it!  */
 202 }
 203 bfd_format;
 204
 205 /* Values that may appear in the flags field of a BFD.  These also
 206    appear in the object_flags field of the bfd_target structure, where
 207    they indicate the set of flags used by that backend (not all flags
 208    are meaningful for all object file formats) (FIXME: at the moment,
 209    the object_flags values have mostly just been copied from backend
 210    to another, and are not necessarily correct).  */
 211
 212 /* No flags.  */
 213 #define BFD_NO_FLAGS    0x00
 214
 215 /* BFD contains relocation entries.  */
 216 #define HAS_RELOC       0x01
 217
 218 /* BFD is directly executable.  */
 219 #define EXEC_P          0x02
 220
 221 /* BFD has line number information (basically used for F_LNNO in a
 222    COFF header).  */
 223 #define HAS_LINENO      0x04
 224
 225 /* BFD has debugging information.  */
 226 #define HAS_DEBUG       0x08
 227
 228 /* BFD has symbols.  */
 229 #define HAS_SYMS        0x10
 230
 231 /* BFD has local symbols (basically used for F_LSYMS in a COFF
 232    header).  */
 233 #define HAS_LOCALS      0x20
 234
 235 /* BFD is a dynamic object.  */
 236 #define DYNAMIC         0x40
 237
 238 /* Text section is write protected (if D_PAGED is not set, this is
 239    like an a.out NMAGIC file) (the linker sets this by default, but
 240    clears it for -r or -N).  */
 241 #define WP_TEXT         0x80
 242
 243 /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
 244    linker sets this by default, but clears it for -r or -n or -N).  */
 245 #define D_PAGED         0x100
 246
 247 /* BFD is relaxable (this means that bfd_relax_section may be able to
 248    do something) (sometimes bfd_relax_section can do something even if
 249    this is not set).  */
 250 #define BFD_IS_RELAXABLE 0x200
 251
 252 /* This may be set before writing out a BFD to request using a
 253    traditional format.  For example, this is used to request that when
 254    writing out an a.out object the symbols not be hashed to eliminate
 255    duplicates.  */
 256 #define BFD_TRADITIONAL_FORMAT 0x400
 257
 258 /* This flag indicates that the BFD contents are actually cached in
 259    memory.  If this is set, iostream points to a bfd_in_memory struct.  */
 260 #define BFD_IN_MEMORY 0x800
 261
 262 /* The sections in this BFD specify a memory page.  */
 263 #define HAS_LOAD_PAGE 0x1000
 264 \f
 265 /* Symbols and relocation.  */
 266
 267 /* A count of carsyms (canonical archive symbols).  */
 268 typedef unsigned long symindex;
 269
 270 /* How to perform a relocation.  */
 271 typedef const struct reloc_howto_struct reloc_howto_type;
 272
 273 #define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
 274
 275 /* General purpose part of a symbol X;
 276    target specific parts are in libcoff.h, libaout.h, etc.  */
 277
 278 #define bfd_get_section(x) ((x)->section)
 279 #define bfd_get_output_section(x) ((x)->section->output_section)
 280 #define bfd_set_section(x,y) ((x)->section) = (y)
 281 #define bfd_asymbol_base(x) ((x)->section->vma)
 282 #define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value)
 283 #define bfd_asymbol_name(x) ((x)->name)
 284 /*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/
 285 #define bfd_asymbol_bfd(x) ((x)->the_bfd)
 286 #define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour)
 287
 288 /* A canonical archive symbol.  */
 289 /* This is a type pun with struct ranlib on purpose!  */
 290 typedef struct carsym
 291 {
 292   char *name;
 293   file_ptr file_offset; /* Look here to find the file.  */
 294 }
 295 carsym;                 /* To make these you call a carsymogen.  */
 296
 297 /* Used in generating armaps (archive tables of contents).
 298    Perhaps just a forward definition would do?  */
 299 struct orl                      /* Output ranlib.  */
 300 {
 301   char **name;          /* Symbol name.  */
 302   union
 303   {
 304     file_ptr pos;
 305     bfd *abfd;
 306   } u;                  /* bfd* or file position.  */
 307   int namidx;           /* Index into string table.  */
 308 };
 309 \f
 310 /* Linenumber stuff.  */
 311 typedef struct lineno_cache_entry
 312 {
 313   unsigned int line_number;     /* Linenumber from start of function.  */
 314   union
 315   {
 316     struct symbol_cache_entry *sym;     /* Function name.  */
 317     bfd_vma offset;                     /* Offset into section.  */
 318   } u;
 319 }
 320 alent;
 321 \f
 322 /* Object and core file sections.  */
 323
 324 #define align_power(addr, align)        \
 325   (((addr) + ((bfd_vma) 1 << (align)) - 1) & ((bfd_vma) -1 << (align)))
 326
 327 typedef struct sec *sec_ptr;
 328
 329 #define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
 330 #define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
 331 #define bfd_get_section_lma(bfd, ptr) ((ptr)->lma + 0)
 332 #define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
 333 #define bfd_section_name(bfd, ptr) ((ptr)->name)
 334 #define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr))
 335 #define bfd_section_vma(bfd, ptr) ((ptr)->vma)
 336 #define bfd_section_lma(bfd, ptr) ((ptr)->lma)
 337 #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
 338 #define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
 339 #define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
 340
 341 #define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0)
 342
 343 #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma = (val)), ((ptr)->user_set_vma = TRUE), TRUE)
 344 #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),TRUE)
 345 #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),TRUE)
 346
 347 typedef struct stat stat_type;
 348 \f
 349 typedef enum bfd_print_symbol
 350 {
 351   bfd_print_symbol_name,
 352   bfd_print_symbol_more,
 353   bfd_print_symbol_all
 354 } bfd_print_symbol_type;
 355
 356 /* Information about a symbol that nm needs.  */
 357
 358 typedef struct _symbol_info
 359 {
 360   symvalue value;
 361   char type;
 362   const char *name;            /* Symbol name.  */
 363   unsigned char stab_type;     /* Stab type.  */
 364   char stab_other;             /* Stab other.  */
 365   short stab_desc;             /* Stab desc.  */
 366   const char *stab_name;       /* String for stab type.  */
 367 } symbol_info;
 368
 369 /* Get the name of a stabs type code.  */
 370
 371 extern const char *bfd_get_stab_name
 372   PARAMS ((int));
 373 \f
 374 /* Hash table routines.  There is no way to free up a hash table.  */
 375
 376 /* An element in the hash table.  Most uses will actually use a larger
 377    structure, and an instance of this will be the first field.  */
 378
 379 struct bfd_hash_entry
 380 {
 381   /* Next entry for this hash code.  */
 382   struct bfd_hash_entry *next;
 383   /* String being hashed.  */
 384   const char *string;
 385   /* Hash code.  This is the full hash code, not the index into the
 386      table.  */
 387   unsigned long hash;
 388 };
 389
 390 /* A hash table.  */
 391
 392 struct bfd_hash_table
 393 {
 394   /* The hash array.  */
 395   struct bfd_hash_entry **table;
 396   /* The number of slots in the hash table.  */
 397   unsigned int size;
 398   /* A function used to create new elements in the hash table.  The
 399      first entry is itself a pointer to an element.  When this
 400      function is first invoked, this pointer will be NULL.  However,
 401      having the pointer permits a hierarchy of method functions to be
 402      built each of which calls the function in the superclass.  Thus
 403      each function should be written to allocate a new block of memory
 404      only if the argument is NULL.  */
 405   struct bfd_hash_entry *(*newfunc)
 406     PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *, const char *));
 407    /* An objalloc for this hash table.  This is a struct objalloc *,
 408      but we use PTR to avoid requiring the inclusion of objalloc.h.  */
 409   PTR memory;
 410 };
 411
 412 /* Initialize a hash table.  */
 413 extern bfd_boolean bfd_hash_table_init
 414   PARAMS ((struct bfd_hash_table *,
 415            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
 416                                        struct bfd_hash_table *,
 417                                        const char *)));
 418
 419 /* Initialize a hash table specifying a size.  */
 420 extern bfd_boolean bfd_hash_table_init_n
 421   PARAMS ((struct bfd_hash_table *,
 422            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
 423                                        struct bfd_hash_table *,
 424                                        const char *),
 425            unsigned int size));
 426
 427 /* Free up a hash table.  */
 428 extern void bfd_hash_table_free
 429   PARAMS ((struct bfd_hash_table *));
 430
 431 /* Look up a string in a hash table.  If CREATE is TRUE, a new entry
 432    will be created for this string if one does not already exist.  The
 433    COPY argument must be TRUE if this routine should copy the string
 434    into newly allocated memory when adding an entry.  */
 435 extern struct bfd_hash_entry *bfd_hash_lookup
 436   PARAMS ((struct bfd_hash_table *, const char *, bfd_boolean create,
 437            bfd_boolean copy));
 438
 439 /* Replace an entry in a hash table.  */
 440 extern void bfd_hash_replace
 441   PARAMS ((struct bfd_hash_table *, struct bfd_hash_entry *old,
 442            struct bfd_hash_entry *nw));
 443
 444 /* Base method for creating a hash table entry.  */
 445 extern struct bfd_hash_entry *bfd_hash_newfunc
 446   PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *,
 447            const char *));
 448
 449 /* Grab some space for a hash table entry.  */
 450 extern PTR bfd_hash_allocate
 451   PARAMS ((struct bfd_hash_table *, unsigned int));
 452
 453 /* Traverse a hash table in a random order, calling a function on each
 454    element.  If the function returns FALSE, the traversal stops.  The
 455    INFO argument is passed to the function.  */
 456 extern void bfd_hash_traverse
 457   PARAMS ((struct bfd_hash_table *,
 458            bfd_boolean (*) (struct bfd_hash_entry *, PTR),
 459            PTR info));
 460
 461 #define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table
 462
 463 /* User program access to BFD facilities.  */
 464
 465 /* Direct I/O routines, for programs which know more about the object
 466    file than BFD does.  Use higher level routines if possible.  */
 467
 468 extern bfd_size_type bfd_bread
 469   PARAMS ((PTR, bfd_size_type, bfd *));
 470 extern bfd_size_type bfd_bwrite
 471   PARAMS ((const PTR, bfd_size_type, bfd *));
 472 extern int bfd_seek
 473   PARAMS ((bfd *, file_ptr, int));
 474 extern ufile_ptr bfd_tell
 475   PARAMS ((bfd *));
 476 extern int bfd_flush
 477   PARAMS ((bfd *));
 478 extern int bfd_stat
 479   PARAMS ((bfd *, struct stat *));
 480
 481 /* Deprecated old routines.  */
 482 #if __GNUC__
 483 #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD)                            \
 484   (warn_deprecated ("bfd_read", __FILE__, __LINE__, __FUNCTION__),      \
 485    bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
 486 #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD)                           \
 487   (warn_deprecated ("bfd_write", __FILE__, __LINE__, __FUNCTION__),     \
 488    bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
 489 #else
 490 #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD)                            \
 491   (warn_deprecated ("bfd_read", (const char *) 0, 0, (const char *) 0), \
 492    bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
 493 #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD)                           \
 494   (warn_deprecated ("bfd_write", (const char *) 0, 0, (const char *) 0),\
 495    bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
 496 #endif
 497 extern void warn_deprecated
 498   PARAMS ((const char *, const char *, int, const char *));
 499
 500 /* Cast from const char * to char * so that caller can assign to
 501    a char * without a warning.  */
 502 #define bfd_get_filename(abfd) ((char *) (abfd)->filename)
 503 #define bfd_get_cacheable(abfd) ((abfd)->cacheable)
 504 #define bfd_get_format(abfd) ((abfd)->format)
 505 #define bfd_get_target(abfd) ((abfd)->xvec->name)
 506 #define bfd_get_flavour(abfd) ((abfd)->xvec->flavour)
 507 #define bfd_family_coff(abfd) \
 508   (bfd_get_flavour (abfd) == bfd_target_coff_flavour || \
 509    bfd_get_flavour (abfd) == bfd_target_xcoff_flavour)
 510 #define bfd_big_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_BIG)
 511 #define bfd_little_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_LITTLE)
 512 #define bfd_header_big_endian(abfd) \
 513   ((abfd)->xvec->header_byteorder == BFD_ENDIAN_BIG)
 514 #define bfd_header_little_endian(abfd) \
 515   ((abfd)->xvec->header_byteorder == BFD_ENDIAN_LITTLE)
 516 #define bfd_get_file_flags(abfd) ((abfd)->flags)
 517 #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
 518 #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
 519 #define bfd_my_archive(abfd) ((abfd)->my_archive)
 520 #define bfd_has_map(abfd) ((abfd)->has_armap)
 521
 522 #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
 523 #define bfd_usrdata(abfd) ((abfd)->usrdata)
 524
 525 #define bfd_get_start_address(abfd) ((abfd)->start_address)
 526 #define bfd_get_symcount(abfd) ((abfd)->symcount)
 527 #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
 528 #define bfd_count_sections(abfd) ((abfd)->section_count)
 529
 530 #define bfd_get_dynamic_symcount(abfd) ((abfd)->dynsymcount)
 531
 532 #define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char)
 533
 534 #define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = bool), TRUE)
 535
 536 extern bfd_boolean bfd_cache_close
 537   PARAMS ((bfd *abfd));
 538 /* NB: This declaration should match the autogenerated one in libbfd.h.  */
 539
 540 extern bfd_boolean bfd_record_phdr
 541   PARAMS ((bfd *, unsigned long, bfd_boolean, flagword, bfd_boolean, bfd_vma,
 542            bfd_boolean, bfd_boolean, unsigned int, struct sec **));
 543
 544 /* Byte swapping routines.  */
 545
 546 bfd_vma bfd_getb64
 547   PARAMS ((const unsigned char *));
 548 bfd_vma bfd_getl64
 549   PARAMS ((const unsigned char *));
 550 bfd_signed_vma bfd_getb_signed_64
 551   PARAMS ((const unsigned char *));
 552 bfd_signed_vma bfd_getl_signed_64
 553   PARAMS ((const unsigned char *));
 554 bfd_vma bfd_getb32
 555   PARAMS ((const unsigned char *));
 556 bfd_vma bfd_getl32
 557   PARAMS ((const unsigned char *));
 558 bfd_signed_vma bfd_getb_signed_32
 559   PARAMS ((const unsigned char *));
 560 bfd_signed_vma bfd_getl_signed_32
 561   PARAMS ((const unsigned char *));
 562 bfd_vma bfd_getb16
 563   PARAMS ((const unsigned char *));
 564 bfd_vma bfd_getl16
 565   PARAMS ((const unsigned char *));
 566 bfd_signed_vma bfd_getb_signed_16
 567   PARAMS ((const unsigned char *));
 568 bfd_signed_vma bfd_getl_signed_16
 569   PARAMS ((const unsigned char *));
 570 void bfd_putb64
 571   PARAMS ((bfd_vma, unsigned char *));
 572 void bfd_putl64
 573   PARAMS ((bfd_vma, unsigned char *));
 574 void bfd_putb32
 575   PARAMS ((bfd_vma, unsigned char *));
 576 void bfd_putl32
 577   PARAMS ((bfd_vma, unsigned char *));
 578 void bfd_putb16
 579   PARAMS ((bfd_vma, unsigned char *));
 580 void bfd_putl16
 581   PARAMS ((bfd_vma, unsigned char *));
 582
 583 /* Byte swapping routines which take size and endiannes as arguments.  */
 584
 585 bfd_vma bfd_get_bits
 586   PARAMS ((bfd_byte *, int, bfd_boolean));
 587 void bfd_put_bits
 588   PARAMS ((bfd_vma, bfd_byte *, int, bfd_boolean));
 589 \f
 590 /* Externally visible ECOFF routines.  */
 591
 592 #if defined(__STDC__) || defined(ALMOST_STDC)
 593 struct ecoff_debug_info;
 594 struct ecoff_debug_swap;
 595 struct ecoff_extr;
 596 struct symbol_cache_entry;
 597 struct bfd_link_info;
 598 struct bfd_link_hash_entry;
 599 struct bfd_elf_version_tree;
 600 #endif
 601 extern bfd_vma bfd_ecoff_get_gp_value
 602   PARAMS ((bfd * abfd));
 603 extern bfd_boolean bfd_ecoff_set_gp_value
 604   PARAMS ((bfd *abfd, bfd_vma gp_value));
 605 extern bfd_boolean bfd_ecoff_set_regmasks
 606   PARAMS ((bfd *abfd, unsigned long gprmask, unsigned long fprmask,
 607            unsigned long *cprmask));
 608 extern PTR bfd_ecoff_debug_init
 609   PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
 610            const struct ecoff_debug_swap *output_swap,
 611            struct bfd_link_info *));
 612 extern void bfd_ecoff_debug_free
 613   PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
 614            const struct ecoff_debug_swap *output_swap,
 615            struct bfd_link_info *));
 616 extern bfd_boolean bfd_ecoff_debug_accumulate
 617   PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
 618            const struct ecoff_debug_swap *output_swap,
 619            bfd *input_bfd, struct ecoff_debug_info *input_debug,
 620            const struct ecoff_debug_swap *input_swap,
 621            struct bfd_link_info *));
 622 extern bfd_boolean bfd_ecoff_debug_accumulate_other
 623   PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
 624            const struct ecoff_debug_swap *output_swap, bfd *input_bfd,
 625            struct bfd_link_info *));
 626 extern bfd_boolean bfd_ecoff_debug_externals
 627   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
 628            const struct ecoff_debug_swap *swap,
 629            bfd_boolean relocatable,
 630            bfd_boolean (*get_extr) (struct symbol_cache_entry *,
 631                                     struct ecoff_extr *),
 632            void (*set_index) (struct symbol_cache_entry *,
 633                               bfd_size_type)));
 634 extern bfd_boolean bfd_ecoff_debug_one_external
 635   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
 636            const struct ecoff_debug_swap *swap,
 637            const char *name, struct ecoff_extr *esym));
 638 extern bfd_size_type bfd_ecoff_debug_size
 639   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
 640            const struct ecoff_debug_swap *swap));
 641 extern bfd_boolean bfd_ecoff_write_debug
 642   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
 643            const struct ecoff_debug_swap *swap, file_ptr where));
 644 extern bfd_boolean bfd_ecoff_write_accumulated_debug
 645   PARAMS ((PTR handle, bfd *abfd, struct ecoff_debug_info *debug,
 646            const struct ecoff_debug_swap *swap,
 647            struct bfd_link_info *info, file_ptr where));
 648 extern bfd_boolean bfd_mips_ecoff_create_embedded_relocs
 649   PARAMS ((bfd *, struct bfd_link_info *, struct sec *, struct sec *,
 650            char **));
 651
 652 /* Externally visible ELF routines.  */
 653
 654 struct bfd_link_needed_list
 655 {
 656   struct bfd_link_needed_list *next;
 657   bfd *by;
 658   const char *name;
 659 };
 660
 661 extern bfd_boolean bfd_elf_record_link_assignment
 662   PARAMS ((bfd *, struct bfd_link_info *, const char *, bfd_boolean));
 663 extern struct bfd_link_needed_list *bfd_elf_get_needed_list
 664   PARAMS ((bfd *, struct bfd_link_info *));
 665 extern bfd_boolean bfd_elf_get_bfd_needed_list
 666   PARAMS ((bfd *, struct bfd_link_needed_list **));
 667 extern bfd_boolean bfd_elf32_size_dynamic_sections
 668   PARAMS ((bfd *, const char *, const char *, const char *,
 669            const char * const *, struct bfd_link_info *, struct sec **,
 670            struct bfd_elf_version_tree *));
 671 extern bfd_boolean bfd_elf64_size_dynamic_sections
 672   PARAMS ((bfd *, const char *, const char *, const char *,
 673            const char * const *, struct bfd_link_info *, struct sec **,
 674            struct bfd_elf_version_tree *));
 675 extern void bfd_elf_set_dt_needed_name
 676   PARAMS ((bfd *, const char *));
 677 extern void bfd_elf_set_dt_needed_soname
 678   PARAMS ((bfd *, const char *));
 679 extern const char *bfd_elf_get_dt_soname
 680   PARAMS ((bfd *));
 681 extern struct bfd_link_needed_list *bfd_elf_get_runpath_list
 682   PARAMS ((bfd *, struct bfd_link_info *));
 683 extern bfd_boolean bfd_elf32_discard_info
 684   PARAMS ((bfd *, struct bfd_link_info *));
 685 extern bfd_boolean bfd_elf64_discard_info
 686   PARAMS ((bfd *, struct bfd_link_info *));
 687
 688 /* Return an upper bound on the number of bytes required to store a
 689    copy of ABFD's program header table entries.  Return -1 if an error
 690    occurs; bfd_get_error will return an appropriate code.  */
 691 extern long bfd_get_elf_phdr_upper_bound
 692   PARAMS ((bfd *abfd));
 693
 694 /* Copy ABFD's program header table entries to *PHDRS.  The entries
 695    will be stored as an array of Elf_Internal_Phdr structures, as
 696    defined in include/elf/internal.h.  To find out how large the
 697    buffer needs to be, call bfd_get_elf_phdr_upper_bound.
 698
 699    Return the number of program header table entries read, or -1 if an
 700    error occurs; bfd_get_error will return an appropriate code.  */
 701 extern int bfd_get_elf_phdrs
 702   PARAMS ((bfd *abfd, void *phdrs));
 703
 704 /* Create a new BFD as if by bfd_openr.  Rather than opening a file,
 705    reconstruct an ELF file by reading the segments out of remote memory
 706    based on the ELF file header at EHDR_VMA and the ELF program headers it
 707    points to.  If not null, *LOADBASEP is filled in with the difference
 708    between the VMAs from which the segments were read, and the VMAs the
 709    file headers (and hence BFD's idea of each section's VMA) put them at.
 710
 711    The function TARGET_READ_MEMORY is called to copy LEN bytes from the
 712    remote memory at target address VMA into the local buffer at MYADDR; it
 713    should return zero on success or an `errno' code on failure.  TEMPL must
 714    be a BFD for an ELF target with the word size and byte order found in
 715    the remote memory.  */
 716 extern bfd *bfd_elf_bfd_from_remote_memory
 717   PARAMS ((bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
 718            int (*target_read_memory) (bfd_vma vma, char *myaddr, int len)));
 719
 720 /* Return the arch_size field of an elf bfd, or -1 if not elf.  */
 721 extern int bfd_get_arch_size
 722   PARAMS ((bfd *));
 723
 724 /* Return TRUE if address "naturally" sign extends, or -1 if not elf.  */
 725 extern int bfd_get_sign_extend_vma
 726   PARAMS ((bfd *));
 727
 728 extern bfd_boolean bfd_m68k_elf32_create_embedded_relocs
 729   PARAMS ((bfd *, struct bfd_link_info *, struct sec *, struct sec *,
 730            char **));
 731 extern bfd_boolean bfd_mips_elf32_create_embedded_relocs
 732   PARAMS ((bfd *, struct bfd_link_info *, struct sec *, struct sec *,
 733            char **));
 734
 735 /* SunOS shared library support routines for the linker.  */
 736
 737 extern struct bfd_link_needed_list *bfd_sunos_get_needed_list
 738   PARAMS ((bfd *, struct bfd_link_info *));
 739 extern bfd_boolean bfd_sunos_record_link_assignment
 740   PARAMS ((bfd *, struct bfd_link_info *, const char *));
 741 extern bfd_boolean bfd_sunos_size_dynamic_sections
 742   PARAMS ((bfd *, struct bfd_link_info *, struct sec **, struct sec **,
 743            struct sec **));
 744
 745 /* Linux shared library support routines for the linker.  */
 746
 747 extern bfd_boolean bfd_i386linux_size_dynamic_sections
 748   PARAMS ((bfd *, struct bfd_link_info *));
 749 extern bfd_boolean bfd_m68klinux_size_dynamic_sections
 750   PARAMS ((bfd *, struct bfd_link_info *));
 751 extern bfd_boolean bfd_sparclinux_size_dynamic_sections
 752   PARAMS ((bfd *, struct bfd_link_info *));
 753
 754 /* mmap hacks */
 755
 756 struct _bfd_window_internal;
 757 typedef struct _bfd_window_internal bfd_window_internal;
 758
 759 typedef struct _bfd_window
 760 {
 761   /* What the user asked for.  */
 762   PTR data;
 763   bfd_size_type size;
 764   /* The actual window used by BFD.  Small user-requested read-only
 765      regions sharing a page may share a single window into the object
 766      file.  Read-write versions shouldn't until I've fixed things to
 767      keep track of which portions have been claimed by the
 768      application; don't want to give the same region back when the
 769      application wants two writable copies!  */
 770   struct _bfd_window_internal *i;
 771 }
 772 bfd_window;
 773
 774 extern void bfd_init_window
 775   PARAMS ((bfd_window *));
 776 extern void bfd_free_window
 777   PARAMS ((bfd_window *));
 778 extern bfd_boolean bfd_get_file_window
 779   PARAMS ((bfd *, file_ptr, bfd_size_type, bfd_window *, bfd_boolean));
 780
 781 /* XCOFF support routines for the linker.  */
 782
 783 extern bfd_boolean bfd_xcoff_link_record_set
 784   PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
 785            bfd_size_type));
 786 extern bfd_boolean bfd_xcoff_import_symbol
 787   PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
 788            bfd_vma, const char *, const char *, const char *, unsigned int));
 789 extern bfd_boolean bfd_xcoff_export_symbol
 790   PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *));
 791 extern bfd_boolean bfd_xcoff_link_count_reloc
 792   PARAMS ((bfd *, struct bfd_link_info *, const char *));
 793 extern bfd_boolean bfd_xcoff_record_link_assignment
 794   PARAMS ((bfd *, struct bfd_link_info *, const char *));
 795 extern bfd_boolean bfd_xcoff_size_dynamic_sections
 796   PARAMS ((bfd *, struct bfd_link_info *, const char *, const char *,
 797            unsigned long, unsigned long, unsigned long, bfd_boolean,
 798            int, bfd_boolean, bfd_boolean, struct sec **, bfd_boolean));
 799 extern bfd_boolean bfd_xcoff_link_generate_rtinit
 800   PARAMS ((bfd *, const char *, const char *, bfd_boolean));
 801
 802 /* XCOFF support routines for ar.  */
 803 extern bfd_boolean bfd_xcoff_ar_archive_set_magic
 804   PARAMS ((bfd *, char *));
 805
 806 /* Externally visible COFF routines.  */
 807
 808 #if defined(__STDC__) || defined(ALMOST_STDC)
 809 struct internal_syment;
 810 union internal_auxent;
 811 #endif
 812
 813 extern bfd_boolean bfd_coff_get_syment
 814   PARAMS ((bfd *, struct symbol_cache_entry *, struct internal_syment *));
 815
 816 extern bfd_boolean bfd_coff_get_auxent
 817   PARAMS ((bfd *, struct symbol_cache_entry *, int, union internal_auxent *));
 818
 819 extern bfd_boolean bfd_coff_set_symbol_class
 820   PARAMS ((bfd *, struct symbol_cache_entry *, unsigned int));
 821
 822 extern bfd_boolean bfd_m68k_coff_create_embedded_relocs
 823   PARAMS ((bfd *, struct bfd_link_info *, struct sec *, struct sec *,
 824            char **));
 825
 826 /* ARM Interworking support.  Called from linker.  */
 827 extern bfd_boolean bfd_arm_allocate_interworking_sections
 828   PARAMS ((struct bfd_link_info *));
 829
 830 extern bfd_boolean bfd_arm_process_before_allocation
 831   PARAMS ((bfd *, struct bfd_link_info *, int));
 832
 833 extern bfd_boolean bfd_arm_get_bfd_for_interworking
 834   PARAMS ((bfd *, struct bfd_link_info *));
 835
 836 /* PE ARM Interworking support.  Called from linker.  */
 837 extern bfd_boolean bfd_arm_pe_allocate_interworking_sections
 838   PARAMS ((struct bfd_link_info *));
 839
 840 extern bfd_boolean bfd_arm_pe_process_before_allocation
 841   PARAMS ((bfd *, struct bfd_link_info *, int));
 842
 843 extern bfd_boolean bfd_arm_pe_get_bfd_for_interworking
 844   PARAMS ((bfd *, struct bfd_link_info *));
 845
 846 /* ELF ARM Interworking support.  Called from linker.  */
 847 extern bfd_boolean bfd_elf32_arm_allocate_interworking_sections
 848   PARAMS ((struct bfd_link_info *));
 849
 850 extern bfd_boolean bfd_elf32_arm_process_before_allocation
 851   PARAMS ((bfd *, struct bfd_link_info *, int));
 852
 853 extern bfd_boolean bfd_elf32_arm_get_bfd_for_interworking
 854   PARAMS ((bfd *, struct bfd_link_info *));
 855
 856 extern bfd_boolean bfd_elf32_arm_add_glue_sections_to_bfd
 857   PARAMS ((bfd *, struct bfd_link_info *));
 858
 859 /* ARM Note section processing.  */
 860 extern bfd_boolean bfd_arm_merge_machines
 861   PARAMS ((bfd *, bfd *));
 862
 863 extern bfd_boolean bfd_arm_update_notes
 864   PARAMS ((bfd *, const char *));
 865
 866 extern unsigned int bfd_arm_get_mach_from_notes
 867   PARAMS ((bfd *, const char *));
 868
 869 /* TI COFF load page support.  */
 870 extern void bfd_ticoff_set_section_load_page
 871   PARAMS ((struct sec *, int));
 872
 873 extern int bfd_ticoff_get_section_load_page
 874   PARAMS ((struct sec *));
 875
 876 /* Extracted from init.c.  */
 877 void
 878 bfd_init PARAMS ((void));
 879
 880 /* Extracted from opncls.c.  */
 881 bfd *
 882 bfd_openr PARAMS ((const char *filename, const char *target));
 883
 884 bfd *
 885 bfd_fdopenr PARAMS ((const char *filename, const char *target, int fd));
 886
 887 bfd *
 888 bfd_openstreamr PARAMS ((const char *, const char *, PTR));
 889
 890 bfd *
 891 bfd_openw PARAMS ((const char *filename, const char *target));
 892
 893 bfd_boolean
 894 bfd_close PARAMS ((bfd *abfd));
 895
 896 bfd_boolean
 897 bfd_close_all_done PARAMS ((bfd *));
 898
 899 bfd *
 900 bfd_create PARAMS ((const char *filename, bfd *templ));
 901
 902 bfd_boolean
 903 bfd_make_writable PARAMS ((bfd *abfd));
 904
 905 bfd_boolean
 906 bfd_make_readable PARAMS ((bfd *abfd));
 907
 908 unsigned long
 909 bfd_calc_gnu_debuglink_crc32 PARAMS ((unsigned long crc, const unsigned char *buf, bfd_size_type len));
 910
 911 char *
 912 bfd_follow_gnu_debuglink PARAMS ((bfd *abfd, const char *dir));
 913
 914 struct sec *
 915 bfd_create_gnu_debuglink_section PARAMS ((bfd * abfd, const char * filename));
 916
 917 bfd_boolean
 918 bfd_fill_in_gnu_debuglink_section PARAMS ((bfd * abfd, struct sec * sect, const char * filename));
 919
 920 /* Extracted from libbfd.c.  */
 921
 922 /* Byte swapping macros for user section data.  */
 923
 924 #define bfd_put_8(abfd, val, ptr) \
 925                 ((void) (*((unsigned char *) (ptr)) = (unsigned char) (val)))
 926 #define bfd_put_signed_8 \
 927                bfd_put_8
 928 #define bfd_get_8(abfd, ptr) \
 929                 (*(unsigned char *) (ptr) & 0xff)
 930 #define bfd_get_signed_8(abfd, ptr) \
 931                (((*(unsigned char *) (ptr) & 0xff) ^ 0x80) - 0x80)
 932
 933 #define bfd_put_16(abfd, val, ptr) \
 934                 BFD_SEND(abfd, bfd_putx16, ((val),(ptr)))
 935 #define bfd_put_signed_16 \
 936                 bfd_put_16
 937 #define bfd_get_16(abfd, ptr) \
 938                 BFD_SEND(abfd, bfd_getx16, (ptr))
 939 #define bfd_get_signed_16(abfd, ptr) \
 940                 BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
 941
 942 #define bfd_put_32(abfd, val, ptr) \
 943                 BFD_SEND(abfd, bfd_putx32, ((val),(ptr)))
 944 #define bfd_put_signed_32 \
 945                 bfd_put_32
 946 #define bfd_get_32(abfd, ptr) \
 947                 BFD_SEND(abfd, bfd_getx32, (ptr))
 948 #define bfd_get_signed_32(abfd, ptr) \
 949                 BFD_SEND(abfd, bfd_getx_signed_32, (ptr))
 950
 951 #define bfd_put_64(abfd, val, ptr) \
 952                 BFD_SEND(abfd, bfd_putx64, ((val), (ptr)))
 953 #define bfd_put_signed_64 \
 954                 bfd_put_64
 955 #define bfd_get_64(abfd, ptr) \
 956                 BFD_SEND(abfd, bfd_getx64, (ptr))
 957 #define bfd_get_signed_64(abfd, ptr) \
 958                 BFD_SEND(abfd, bfd_getx_signed_64, (ptr))
 959
 960 #define bfd_get(bits, abfd, ptr)                               \
 961                 ( (bits) ==  8 ? (bfd_vma) bfd_get_8 (abfd, ptr)       \
 962                 : (bits) == 16 ? bfd_get_16 (abfd, ptr)        \
 963                 : (bits) == 32 ? bfd_get_32 (abfd, ptr)        \
 964                 : (bits) == 64 ? bfd_get_64 (abfd, ptr)        \
 965                 : (abort (), (bfd_vma) - 1))
 966
 967 #define bfd_put(bits, abfd, val, ptr)                          \
 968                 ( (bits) ==  8 ? bfd_put_8  (abfd, val, ptr)   \
 969                 : (bits) == 16 ? bfd_put_16 (abfd, val, ptr)   \
 970                 : (bits) == 32 ? bfd_put_32 (abfd, val, ptr)   \
 971                 : (bits) == 64 ? bfd_put_64 (abfd, val, ptr)   \
 972                 : (abort (), (void) 0))
 973
 974
 975 /* Byte swapping macros for file header data.  */
 976
 977 #define bfd_h_put_8(abfd, val, ptr) \
 978   bfd_put_8 (abfd, val, ptr)
 979 #define bfd_h_put_signed_8(abfd, val, ptr) \
 980   bfd_put_8 (abfd, val, ptr)
 981 #define bfd_h_get_8(abfd, ptr) \
 982   bfd_get_8 (abfd, ptr)
 983 #define bfd_h_get_signed_8(abfd, ptr) \
 984   bfd_get_signed_8 (abfd, ptr)
 985
 986 #define bfd_h_put_16(abfd, val, ptr) \
 987   BFD_SEND (abfd, bfd_h_putx16, (val, ptr))
 988 #define bfd_h_put_signed_16 \
 989   bfd_h_put_16
 990 #define bfd_h_get_16(abfd, ptr) \
 991   BFD_SEND (abfd, bfd_h_getx16, (ptr))
 992 #define bfd_h_get_signed_16(abfd, ptr) \
 993   BFD_SEND (abfd, bfd_h_getx_signed_16, (ptr))
 994
 995 #define bfd_h_put_32(abfd, val, ptr) \
 996   BFD_SEND (abfd, bfd_h_putx32, (val, ptr))
 997 #define bfd_h_put_signed_32 \
 998   bfd_h_put_32
 999 #define bfd_h_get_32(abfd, ptr) \
1000   BFD_SEND (abfd, bfd_h_getx32, (ptr))
1001 #define bfd_h_get_signed_32(abfd, ptr) \
1002   BFD_SEND (abfd, bfd_h_getx_signed_32, (ptr))
1003
1004 #define bfd_h_put_64(abfd, val, ptr) \
1005   BFD_SEND (abfd, bfd_h_putx64, (val, ptr))
1006 #define bfd_h_put_signed_64 \
1007   bfd_h_put_64
1008 #define bfd_h_get_64(abfd, ptr) \
1009   BFD_SEND (abfd, bfd_h_getx64, (ptr))
1010 #define bfd_h_get_signed_64(abfd, ptr) \
1011   BFD_SEND (abfd, bfd_h_getx_signed_64, (ptr))
1012
1013 /* Refinements on the above, which should eventually go away.  Save
1014    cluttering the source with (bfd_vma) and (bfd_byte *) casts.  */
1015
1016 #define H_PUT_64(abfd, val, where) \
1017   bfd_h_put_64 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
1018
1019 #define H_PUT_32(abfd, val, where) \
1020   bfd_h_put_32 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
1021
1022 #define H_PUT_16(abfd, val, where) \
1023   bfd_h_put_16 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
1024
1025 #define H_PUT_8 bfd_h_put_8
1026
1027 #define H_PUT_S64(abfd, val, where) \
1028   bfd_h_put_signed_64 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
1029
1030 #define H_PUT_S32(abfd, val, where) \
1031   bfd_h_put_signed_32 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
1032
1033 #define H_PUT_S16(abfd, val, where) \
1034   bfd_h_put_signed_16 ((abfd), (bfd_vma) (val), (bfd_byte *) (where))
1035
1036 #define H_PUT_S8 bfd_h_put_signed_8
1037
1038 #define H_GET_64(abfd, where) \
1039   bfd_h_get_64 ((abfd), (bfd_byte *) (where))
1040
1041 #define H_GET_32(abfd, where) \
1042   bfd_h_get_32 ((abfd), (bfd_byte *) (where))
1043
1044 #define H_GET_16(abfd, where) \
1045   bfd_h_get_16 ((abfd), (bfd_byte *) (where))
1046
1047 #define H_GET_8 bfd_h_get_8
1048
1049 #define H_GET_S64(abfd, where) \
1050   bfd_h_get_signed_64 ((abfd), (bfd_byte *) (where))
1051
1052 #define H_GET_S32(abfd, where) \
1053   bfd_h_get_signed_32 ((abfd), (bfd_byte *) (where))
1054
1055 #define H_GET_S16(abfd, where) \
1056   bfd_h_get_signed_16 ((abfd), (bfd_byte *) (where))
1057
1058 #define H_GET_S8 bfd_h_get_signed_8
1059
1060
1061 /* Extracted from bfdio.c.  */
1062 long
1063 bfd_get_mtime PARAMS ((bfd *abfd));
1064
1065 long
1066 bfd_get_size PARAMS ((bfd *abfd));
1067
1068 /* Extracted from bfdwin.c.  */
1069 /* Extracted from section.c.  */
1070 /* This structure is used for a comdat section, as in PE.  A comdat
1071    section is associated with a particular symbol.  When the linker
1072    sees a comdat section, it keeps only one of the sections with a
1073    given name and associated with a given symbol.  */
1074
1075 struct bfd_comdat_info
1076 {
1077   /* The name of the symbol associated with a comdat section.  */
1078   const char *name;
1079
1080   /* The local symbol table index of the symbol associated with a
1081      comdat section.  This is only meaningful to the object file format
1082      specific code; it is not an index into the list returned by
1083      bfd_canonicalize_symtab.  */
1084   long symbol;
1085 };
1086
1087 typedef struct sec
1088 {
1089   /* The name of the section; the name isn't a copy, the pointer is
1090      the same as that passed to bfd_make_section.  */
1091   const char *name;
1092
1093   /* A unique sequence number.  */
1094   int id;
1095
1096   /* Which section in the bfd; 0..n-1 as sections are created in a bfd.  */
1097   int index;
1098
1099   /* The next section in the list belonging to the BFD, or NULL.  */
1100   struct sec *next;
1101
1102   /* The field flags contains attributes of the section. Some
1103      flags are read in from the object file, and some are
1104      synthesized from other information.  */
1105   flagword flags;
1106
1107 #define SEC_NO_FLAGS   0x000
1108
1109   /* Tells the OS to allocate space for this section when loading.
1110      This is clear for a section containing debug information only.  */
1111 #define SEC_ALLOC      0x001
1112
1113   /* Tells the OS to load the section from the file when loading.
1114      This is clear for a .bss section.  */
1115 #define SEC_LOAD       0x002
1116
1117   /* The section contains data still to be relocated, so there is
1118      some relocation information too.  */
1119 #define SEC_RELOC      0x004
1120
1121   /* ELF reserves 4 processor specific bits and 8 operating system
1122      specific bits in sh_flags; at present we can get away with just
1123      one in communicating between the assembler and BFD, but this
1124      isn't a good long-term solution.  */
1125 #define SEC_ARCH_BIT_0 0x008
1126
1127   /* A signal to the OS that the section contains read only data.  */
1128 #define SEC_READONLY   0x010
1129
1130   /* The section contains code only.  */
1131 #define SEC_CODE       0x020
1132
1133   /* The section contains data only.  */
1134 #define SEC_DATA       0x040
1135
1136   /* The section will reside in ROM.  */
1137 #define SEC_ROM        0x080
1138
1139   /* The section contains constructor information. This section
1140      type is used by the linker to create lists of constructors and
1141      destructors used by <<g++>>. When a back end sees a symbol
1142      which should be used in a constructor list, it creates a new
1143      section for the type of name (e.g., <<__CTOR_LIST__>>), attaches
1144      the symbol to it, and builds a relocation. To build the lists
1145      of constructors, all the linker has to do is catenate all the
1146      sections called <<__CTOR_LIST__>> and relocate the data
1147      contained within - exactly the operations it would peform on
1148      standard data.  */
1149 #define SEC_CONSTRUCTOR 0x100
1150
1151   /* The section has contents - a data section could be
1152      <<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>; a debug section could be
1153      <<SEC_HAS_CONTENTS>>  */
1154 #define SEC_HAS_CONTENTS 0x200
1155
1156   /* An instruction to the linker to not output the section
1157      even if it has information which would normally be written.  */
1158 #define SEC_NEVER_LOAD 0x400
1159
1160   /* The section is a COFF shared library section.  This flag is
1161      only for the linker.  If this type of section appears in
1162      the input file, the linker must copy it to the output file
1163      without changing the vma or size.  FIXME: Although this
1164      was originally intended to be general, it really is COFF
1165      specific (and the flag was renamed to indicate this).  It
1166      might be cleaner to have some more general mechanism to
1167      allow the back end to control what the linker does with
1168      sections.  */
1169 #define SEC_COFF_SHARED_LIBRARY 0x800
1170
1171   /* The section contains thread local data.  */
1172 #define SEC_THREAD_LOCAL 0x1000
1173
1174   /* The section has GOT references.  This flag is only for the
1175      linker, and is currently only used by the elf32-hppa back end.
1176      It will be set if global offset table references were detected
1177      in this section, which indicate to the linker that the section
1178      contains PIC code, and must be handled specially when doing a
1179      static link.  */
1180 #define SEC_HAS_GOT_REF 0x4000
1181
1182   /* The section contains common symbols (symbols may be defined
1183      multiple times, the value of a symbol is the amount of
1184      space it requires, and the largest symbol value is the one
1185      used).  Most targets have exactly one of these (which we
1186      translate to bfd_com_section_ptr), but ECOFF has two.  */
1187 #define SEC_IS_COMMON 0x8000
1188
1189   /* The section contains only debugging information.  For
1190      example, this is set for ELF .debug and .stab sections.
1191      strip tests this flag to see if a section can be
1192      discarded.  */
1193 #define SEC_DEBUGGING 0x10000
1194
1195   /* The contents of this section are held in memory pointed to
1196      by the contents field.  This is checked by bfd_get_section_contents,
1197      and the data is retrieved from memory if appropriate.  */
1198 #define SEC_IN_MEMORY 0x20000
1199
1200   /* The contents of this section are to be excluded by the
1201      linker for executable and shared objects unless those
1202      objects are to be further relocated.  */
1203 #define SEC_EXCLUDE 0x40000
1204
1205   /* The contents of this section are to be sorted based on the sum of
1206      the symbol and addend values specified by the associated relocation
1207      entries.  Entries without associated relocation entries will be
1208      appended to the end of the section in an unspecified order.  */
1209 #define SEC_SORT_ENTRIES 0x80000
1210
1211   /* When linking, duplicate sections of the same name should be
1212      discarded, rather than being combined into a single section as
1213      is usually done.  This is similar to how common symbols are
1214      handled.  See SEC_LINK_DUPLICATES below.  */
1215 #define SEC_LINK_ONCE 0x100000
1216
1217   /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
1218      should handle duplicate sections.  */
1219 #define SEC_LINK_DUPLICATES 0x600000
1220
1221   /* This value for SEC_LINK_DUPLICATES means that duplicate
1222      sections with the same name should simply be discarded.  */
1223 #define SEC_LINK_DUPLICATES_DISCARD 0x0
1224
1225   /* This value for SEC_LINK_DUPLICATES means that the linker
1226      should warn if there are any duplicate sections, although
1227      it should still only link one copy.  */
1228 #define SEC_LINK_DUPLICATES_ONE_ONLY 0x200000
1229
1230   /* This value for SEC_LINK_DUPLICATES means that the linker
1231      should warn if any duplicate sections are a different size.  */
1232 #define SEC_LINK_DUPLICATES_SAME_SIZE 0x400000
1233
1234   /* This value for SEC_LINK_DUPLICATES means that the linker
1235      should warn if any duplicate sections contain different
1236      contents.  */
1237 #define SEC_LINK_DUPLICATES_SAME_CONTENTS 0x600000
1238
1239   /* This section was created by the linker as part of dynamic
1240      relocation or other arcane processing.  It is skipped when
1241      going through the first-pass output, trusting that someone
1242      else up the line will take care of it later.  */
1243 #define SEC_LINKER_CREATED 0x800000
1244
1245   /* This section should not be subject to garbage collection.  */
1246 #define SEC_KEEP 0x1000000
1247
1248   /* This section contains "short" data, and should be placed
1249      "near" the GP.  */
1250 #define SEC_SMALL_DATA 0x2000000
1251
1252   /* This section contains data which may be shared with other
1253      executables or shared objects.  */
1254 #define SEC_SHARED 0x4000000
1255
1256   /* When a section with this flag is being linked, then if the size of
1257      the input section is less than a page, it should not cross a page
1258      boundary.  If the size of the input section is one page or more, it
1259      should be aligned on a page boundary.  */
1260 #define SEC_BLOCK 0x8000000
1261
1262   /* Conditionally link this section; do not link if there are no
1263      references found to any symbol in the section.  */
1264 #define SEC_CLINK 0x10000000
1265
1266   /* Attempt to merge identical entities in the section.
1267      Entity size is given in the entsize field.  */
1268 #define SEC_MERGE 0x20000000
1269
1270   /* If given with SEC_MERGE, entities to merge are zero terminated
1271      strings where entsize specifies character size instead of fixed
1272      size entries.  */
1273 #define SEC_STRINGS 0x40000000
1274
1275   /* This section contains data about section groups.  */
1276 #define SEC_GROUP 0x80000000
1277
1278   /*  End of section flags.  */
1279
1280   /* Some internal packed boolean fields.  */
1281
1282   /* See the vma field.  */
1283   unsigned int user_set_vma : 1;
1284
1285   /* Whether relocations have been processed.  */
1286   unsigned int reloc_done : 1;
1287
1288   /* A mark flag used by some of the linker backends.  */
1289   unsigned int linker_mark : 1;
1290
1291   /* Another mark flag used by some of the linker backends.  Set for
1292      output sections that have an input section.  */
1293   unsigned int linker_has_input : 1;
1294
1295   /* A mark flag used by some linker backends for garbage collection.  */
1296   unsigned int gc_mark : 1;
1297
1298   /* The following flags are used by the ELF linker. */
1299
1300   /* Mark sections which have been allocated to segments.  */
1301   unsigned int segment_mark : 1;
1302
1303   /* Type of sec_info information.  */
1304   unsigned int sec_info_type:3;
1305 #define ELF_INFO_TYPE_NONE      0
1306 #define ELF_INFO_TYPE_STABS     1
1307 #define ELF_INFO_TYPE_MERGE     2
1308 #define ELF_INFO_TYPE_EH_FRAME  3
1309 #define ELF_INFO_TYPE_JUST_SYMS 4
1310
1311   /* Nonzero if this section uses RELA relocations, rather than REL.  */
1312   unsigned int use_rela_p:1;
1313
1314   /* Bits used by various backends.  */
1315   unsigned int has_tls_reloc:1;
1316
1317   /* Nonzero if this section needs the relax finalize pass.  */
1318   unsigned int need_finalize_relax:1;
1319
1320   /* Nonzero if this section has a gp reloc.  */
1321   unsigned int has_gp_reloc:1;
1322
1323   /* Usused bits.  */
1324   unsigned int flag13:1;
1325   unsigned int flag14:1;
1326   unsigned int flag15:1;
1327   unsigned int flag16:4;
1328   unsigned int flag20:4;
1329   unsigned int flag24:8;
1330
1331   /* End of internal packed boolean fields.  */
1332
1333   /*  The virtual memory address of the section - where it will be
1334       at run time.  The symbols are relocated against this.  The
1335       user_set_vma flag is maintained by bfd; if it's not set, the
1336       backend can assign addresses (for example, in <<a.out>>, where
1337       the default address for <<.data>> is dependent on the specific
1338       target and various flags).  */
1339   bfd_vma vma;
1340
1341   /*  The load address of the section - where it would be in a
1342       rom image; really only used for writing section header
1343       information.  */
1344   bfd_vma lma;
1345
1346   /* The size of the section in octets, as it will be output.
1347      Contains a value even if the section has no contents (e.g., the
1348      size of <<.bss>>).  This will be filled in after relocation.  */
1349   bfd_size_type _cooked_size;
1350
1351   /* The original size on disk of the section, in octets.  Normally this
1352      value is the same as the size, but if some relaxing has
1353      been done, then this value will be bigger.  */
1354   bfd_size_type _raw_size;
1355
1356   /* If this section is going to be output, then this value is the
1357      offset in *bytes* into the output section of the first byte in the
1358      input section (byte ==> smallest addressable unit on the
1359      target).  In most cases, if this was going to start at the
1360      100th octet (8-bit quantity) in the output section, this value
1361      would be 100.  However, if the target byte size is 16 bits
1362      (bfd_octets_per_byte is "2"), this value would be 50.  */
1363   bfd_vma output_offset;
1364
1365   /* The output section through which to map on output.  */
1366   struct sec *output_section;
1367
1368   /* The alignment requirement of the section, as an exponent of 2 -
1369      e.g., 3 aligns to 2^3 (or 8).  */
1370   unsigned int alignment_power;
1371
1372   /* If an input section, a pointer to a vector of relocation
1373      records for the data in this section.  */
1374   struct reloc_cache_entry *relocation;
1375
1376   /* If an output section, a pointer to a vector of pointers to
1377      relocation records for the data in this section.  */
1378   struct reloc_cache_entry **orelocation;
1379
1380   /* The number of relocation records in one of the above.  */
1381   unsigned reloc_count;
1382
1383   /* Information below is back end specific - and not always used
1384      or updated.  */
1385
1386   /* File position of section data.  */
1387   file_ptr filepos;
1388
1389   /* File position of relocation info.  */
1390   file_ptr rel_filepos;
1391
1392   /* File position of line data.  */
1393   file_ptr line_filepos;
1394
1395   /* Pointer to data for applications.  */
1396   PTR userdata;
1397
1398   /* If the SEC_IN_MEMORY flag is set, this points to the actual
1399      contents.  */
1400   unsigned char *contents;
1401
1402   /* Attached line number information.  */
1403   alent *lineno;
1404
1405   /* Number of line number records.  */
1406   unsigned int lineno_count;
1407
1408   /* Entity size for merging purposes.  */
1409   unsigned int entsize;
1410
1411   /* Optional information about a COMDAT entry; NULL if not COMDAT.  */
1412   struct bfd_comdat_info *comdat;
1413
1414   /* Points to the kept section if this section is a link-once section,
1415      and is discarded.  */
1416   struct sec *kept_section;
1417
1418   /* When a section is being output, this value changes as more
1419      linenumbers are written out.  */
1420   file_ptr moving_line_filepos;
1421
1422   /* What the section number is in the target world.  */
1423   int target_index;
1424
1425   PTR used_by_bfd;
1426
1427   /* If this is a constructor section then here is a list of the
1428      relocations created to relocate items within it.  */
1429   struct relent_chain *constructor_chain;
1430
1431   /* The BFD which owns the section.  */
1432   bfd *owner;
1433
1434   /* A symbol which points at this section only.  */
1435   struct symbol_cache_entry *symbol;
1436   struct symbol_cache_entry **symbol_ptr_ptr;
1437
1438   struct bfd_link_order *link_order_head;
1439   struct bfd_link_order *link_order_tail;
1440 } asection;
1441
1442 /* These sections are global, and are managed by BFD.  The application
1443    and target back end are not permitted to change the values in
1444    these sections.  New code should use the section_ptr macros rather
1445    than referring directly to the const sections.  The const sections
1446    may eventually vanish.  */
1447 #define BFD_ABS_SECTION_NAME "*ABS*"
1448 #define BFD_UND_SECTION_NAME "*UND*"
1449 #define BFD_COM_SECTION_NAME "*COM*"
1450 #define BFD_IND_SECTION_NAME "*IND*"
1451
1452 /* The absolute section.  */
1453 extern const asection bfd_abs_section;
1454 #define bfd_abs_section_ptr ((asection *) &bfd_abs_section)
1455 #define bfd_is_abs_section(sec) ((sec) == bfd_abs_section_ptr)
1456 /* Pointer to the undefined section.  */
1457 extern const asection bfd_und_section;
1458 #define bfd_und_section_ptr ((asection *) &bfd_und_section)
1459 #define bfd_is_und_section(sec) ((sec) == bfd_und_section_ptr)
1460 /* Pointer to the common section.  */
1461 extern const asection bfd_com_section;
1462 #define bfd_com_section_ptr ((asection *) &bfd_com_section)
1463 /* Pointer to the indirect section.  */
1464 extern const asection bfd_ind_section;
1465 #define bfd_ind_section_ptr ((asection *) &bfd_ind_section)
1466 #define bfd_is_ind_section(sec) ((sec) == bfd_ind_section_ptr)
1467
1468 #define bfd_is_const_section(SEC)              \
1469  (   ((SEC) == bfd_abs_section_ptr)            \
1470   || ((SEC) == bfd_und_section_ptr)            \
1471   || ((SEC) == bfd_com_section_ptr)            \
1472   || ((SEC) == bfd_ind_section_ptr))
1473
1474 extern const struct symbol_cache_entry * const bfd_abs_symbol;
1475 extern const struct symbol_cache_entry * const bfd_com_symbol;
1476 extern const struct symbol_cache_entry * const bfd_und_symbol;
1477 extern const struct symbol_cache_entry * const bfd_ind_symbol;
1478 #define bfd_get_section_size_before_reloc(section) \
1479      ((section)->reloc_done ? (abort (), (bfd_size_type) 1) \
1480                             : (section)->_raw_size)
1481 #define bfd_get_section_size_after_reloc(section) \
1482      ((section)->reloc_done ? (section)->_cooked_size \
1483                             : (abort (), (bfd_size_type) 1))
1484
1485 /* Macros to handle insertion and deletion of a bfd's sections.  These
1486    only handle the list pointers, ie. do not adjust section_count,
1487    target_index etc.  */
1488 #define bfd_section_list_remove(ABFD, PS) \
1489   do                                                   \
1490     {                                                  \
1491       asection **_ps = PS;                             \
1492       asection *_s = *_ps;                             \
1493       *_ps = _s->next;                                 \
1494       if (_s->next == NULL)                            \
1495         (ABFD)->section_tail = _ps;                    \
1496     }                                                  \
1497   while (0)
1498 #define bfd_section_list_insert(ABFD, PS, S) \
1499   do                                                   \
1500     {                                                  \
1501       asection **_ps = PS;                             \
1502       asection *_s = S;                                \
1503       _s->next = *_ps;                                 \
1504       *_ps = _s;                                       \
1505       if (_s->next == NULL)                            \
1506         (ABFD)->section_tail = &_s->next;              \
1507     }                                                  \
1508   while (0)
1509
1510 void
1511 bfd_section_list_clear PARAMS ((bfd *));
1512
1513 asection *
1514 bfd_get_section_by_name PARAMS ((bfd *abfd, const char *name));
1515
1516 char *
1517 bfd_get_unique_section_name PARAMS ((bfd *abfd,
1518     const char *templat,
1519     int *count));
1520
1521 asection *
1522 bfd_make_section_old_way PARAMS ((bfd *abfd, const char *name));
1523
1524 asection *
1525 bfd_make_section_anyway PARAMS ((bfd *abfd, const char *name));
1526
1527 asection *
1528 bfd_make_section PARAMS ((bfd *, const char *name));
1529
1530 bfd_boolean
1531 bfd_set_section_flags PARAMS ((bfd *abfd, asection *sec, flagword flags));
1532
1533 void
1534 bfd_map_over_sections PARAMS ((bfd *abfd,
1535     void (*func) (bfd *abfd,
1536     asection *sect,
1537     PTR obj),
1538     PTR obj));
1539
1540 bfd_boolean
1541 bfd_set_section_size PARAMS ((bfd *abfd, asection *sec, bfd_size_type val));
1542
1543 bfd_boolean
1544 bfd_set_section_contents PARAMS ((bfd *abfd, asection *section,
1545     PTR data, file_ptr offset,
1546     bfd_size_type count));
1547
1548 bfd_boolean
1549 bfd_get_section_contents PARAMS ((bfd *abfd, asection *section,
1550     PTR location, file_ptr offset,
1551     bfd_size_type count));
1552
1553 bfd_boolean
1554 bfd_copy_private_section_data PARAMS ((bfd *ibfd, asection *isec,
1555     bfd *obfd, asection *osec));
1556
1557 #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
1558      BFD_SEND (obfd, _bfd_copy_private_section_data, \
1559                (ibfd, isection, obfd, osection))
1560 void
1561 _bfd_strip_section_from_output PARAMS ((struct bfd_link_info *info, asection *section));
1562
1563 bfd_boolean
1564 bfd_generic_discard_group PARAMS ((bfd *abfd, asection *group));
1565
1566 /* Extracted from archures.c.  */
1567 enum bfd_architecture
1568 {
1569   bfd_arch_unknown,   /* File arch not known.  */
1570   bfd_arch_obscure,   /* Arch known, not one of these.  */
1571   bfd_arch_m68k,      /* Motorola 68xxx */
1572 #define bfd_mach_m68000 1
1573 #define bfd_mach_m68008 2
1574 #define bfd_mach_m68010 3
1575 #define bfd_mach_m68020 4
1576 #define bfd_mach_m68030 5
1577 #define bfd_mach_m68040 6
1578 #define bfd_mach_m68060 7
1579 #define bfd_mach_cpu32  8
1580 #define bfd_mach_mcf5200  9
1581 #define bfd_mach_mcf5206e 10
1582 #define bfd_mach_mcf5307  11
1583 #define bfd_mach_mcf5407  12
1584   bfd_arch_vax,       /* DEC Vax */
1585   bfd_arch_i960,      /* Intel 960 */
1586     /* The order of the following is important.
1587        lower number indicates a machine type that
1588        only accepts a subset of the instructions
1589        available to machines with higher numbers.
1590        The exception is the "ca", which is
1591        incompatible with all other machines except
1592        "core".  */
1593
1594 #define bfd_mach_i960_core      1
1595 #define bfd_mach_i960_ka_sa     2
1596 #define bfd_mach_i960_kb_sb     3
1597 #define bfd_mach_i960_mc        4
1598 #define bfd_mach_i960_xa        5
1599 #define bfd_mach_i960_ca        6
1600 #define bfd_mach_i960_jx        7
1601 #define bfd_mach_i960_hx        8
1602
1603   bfd_arch_or32,      /* OpenRISC 32 */
1604
1605   bfd_arch_a29k,      /* AMD 29000 */
1606   bfd_arch_sparc,     /* SPARC */
1607 #define bfd_mach_sparc                 1
1608 /* The difference between v8plus and v9 is that v9 is a true 64 bit env.  */
1609 #define bfd_mach_sparc_sparclet        2
1610 #define bfd_mach_sparc_sparclite       3
1611 #define bfd_mach_sparc_v8plus          4
1612 #define bfd_mach_sparc_v8plusa         5 /* with ultrasparc add'ns.  */
1613 #define bfd_mach_sparc_sparclite_le    6
1614 #define bfd_mach_sparc_v9              7
1615 #define bfd_mach_sparc_v9a             8 /* with ultrasparc add'ns.  */
1616 #define bfd_mach_sparc_v8plusb         9 /* with cheetah add'ns.  */
1617 #define bfd_mach_sparc_v9b             10 /* with cheetah add'ns.  */
1618 /* Nonzero if MACH has the v9 instruction set.  */
1619 #define bfd_mach_sparc_v9_p(mach) \
1620   ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9b \
1621    && (mach) != bfd_mach_sparc_sparclite_le)
1622   bfd_arch_mips,      /* MIPS Rxxxx */
1623 #define bfd_mach_mips3000              3000
1624 #define bfd_mach_mips3900              3900
1625 #define bfd_mach_mips4000              4000
1626 #define bfd_mach_mips4010              4010
1627 #define bfd_mach_mips4100              4100
1628 #define bfd_mach_mips4111              4111
1629 #define bfd_mach_mips4120              4120
1630 #define bfd_mach_mips4300              4300
1631 #define bfd_mach_mips4400              4400
1632 #define bfd_mach_mips4600              4600
1633 #define bfd_mach_mips4650              4650
1634 #define bfd_mach_mips5000              5000
1635 #define bfd_mach_mips5400              5400
1636 #define bfd_mach_mips5500              5500
1637 #define bfd_mach_mips6000              6000
1638 #define bfd_mach_mips8000              8000
1639 #define bfd_mach_mips10000             10000
1640 #define bfd_mach_mips12000             12000
1641 #define bfd_mach_mips16                16
1642 #define bfd_mach_mips5                 5
1643 #define bfd_mach_mips_sb1              12310201 /* octal 'SB', 01 */
1644 #define bfd_mach_mipsisa32             32
1645 #define bfd_mach_mipsisa32r2           33
1646 #define bfd_mach_mipsisa64             64
1647   bfd_arch_i386,      /* Intel 386 */
1648 #define bfd_mach_i386_i386 1
1649 #define bfd_mach_i386_i8086 2
1650 #define bfd_mach_i386_i386_intel_syntax 3
1651 #define bfd_mach_x86_64 64
1652 #define bfd_mach_x86_64_intel_syntax 65
1653   bfd_arch_we32k,     /* AT&T WE32xxx */
1654   bfd_arch_tahoe,     /* CCI/Harris Tahoe */
1655   bfd_arch_i860,      /* Intel 860 */
1656   bfd_arch_i370,      /* IBM 360/370 Mainframes */
1657   bfd_arch_romp,      /* IBM ROMP PC/RT */
1658   bfd_arch_alliant,   /* Alliant */
1659   bfd_arch_convex,    /* Convex */
1660   bfd_arch_m88k,      /* Motorola 88xxx */
1661   bfd_arch_m98k,      /* Motorola 98xxx */
1662   bfd_arch_pyramid,   /* Pyramid Technology */
1663   bfd_arch_h8300,     /* Renesas H8/300 (formerly Hitachi H8/300) */
1664 #define bfd_mach_h8300    1
1665 #define bfd_mach_h8300h   2
1666 #define bfd_mach_h8300s   3
1667 #define bfd_mach_h8300hn  4
1668 #define bfd_mach_h8300sn  5
1669 #define bfd_mach_h8300sx  6
1670 #define bfd_mach_h8300sxn 7
1671   bfd_arch_pdp11,     /* DEC PDP-11 */
1672   bfd_arch_powerpc,   /* PowerPC */
1673 #define bfd_mach_ppc           32
1674 #define bfd_mach_ppc64         64
1675 #define bfd_mach_ppc_403       403
1676 #define bfd_mach_ppc_403gc     4030
1677 #define bfd_mach_ppc_505       505
1678 #define bfd_mach_ppc_601       601
1679 #define bfd_mach_ppc_602       602
1680 #define bfd_mach_ppc_603       603
1681 #define bfd_mach_ppc_ec603e    6031
1682 #define bfd_mach_ppc_604       604
1683 #define bfd_mach_ppc_620       620
1684 #define bfd_mach_ppc_630       630
1685 #define bfd_mach_ppc_750       750
1686 #define bfd_mach_ppc_860       860
1687 #define bfd_mach_ppc_a35       35
1688 #define bfd_mach_ppc_rs64ii    642
1689 #define bfd_mach_ppc_rs64iii   643
1690 #define bfd_mach_ppc_7400      7400
1691 #define bfd_mach_ppc_e500      500
1692   bfd_arch_rs6000,    /* IBM RS/6000 */
1693 #define bfd_mach_rs6k          6000
1694 #define bfd_mach_rs6k_rs1      6001
1695 #define bfd_mach_rs6k_rsc      6003
1696 #define bfd_mach_rs6k_rs2      6002
1697   bfd_arch_hppa,      /* HP PA RISC */
1698   bfd_arch_d10v,      /* Mitsubishi D10V */
1699 #define bfd_mach_d10v          1
1700 #define bfd_mach_d10v_ts2      2
1701 #define bfd_mach_d10v_ts3      3
1702   bfd_arch_d30v,      /* Mitsubishi D30V */
1703   bfd_arch_dlx,       /* DLX */
1704   bfd_arch_m68hc11,   /* Motorola 68HC11 */
1705   bfd_arch_m68hc12,   /* Motorola 68HC12 */
1706 #define bfd_mach_m6812_default 0
1707 #define bfd_mach_m6812         1
1708 #define bfd_mach_m6812s        2
1709   bfd_arch_z8k,       /* Zilog Z8000 */
1710 #define bfd_mach_z8001         1
1711 #define bfd_mach_z8002         2
1712   bfd_arch_h8500,     /* Renesas H8/500 (formerly Hitachi H8/500) */
1713   bfd_arch_sh,        /* Renesas / SuperH SH (formerly Hitachi SH) */
1714 #define bfd_mach_sh            1
1715 #define bfd_mach_sh2        0x20
1716 #define bfd_mach_sh_dsp     0x2d
1717 #define bfd_mach_sh2e       0x2e
1718 #define bfd_mach_sh3        0x30
1719 #define bfd_mach_sh3_dsp    0x3d
1720 #define bfd_mach_sh3e       0x3e
1721 #define bfd_mach_sh4        0x40
1722 #define bfd_mach_sh5        0x50
1723   bfd_arch_alpha,     /* Dec Alpha */
1724 #define bfd_mach_alpha_ev4  0x10
1725 #define bfd_mach_alpha_ev5  0x20
1726 #define bfd_mach_alpha_ev6  0x30
1727   bfd_arch_arm,       /* Advanced Risc Machines ARM.  */
1728 #define bfd_mach_arm_unknown   0
1729 #define bfd_mach_arm_2         1
1730 #define bfd_mach_arm_2a        2
1731 #define bfd_mach_arm_3         3
1732 #define bfd_mach_arm_3M        4
1733 #define bfd_mach_arm_4         5
1734 #define bfd_mach_arm_4T        6
1735 #define bfd_mach_arm_5         7
1736 #define bfd_mach_arm_5T        8
1737 #define bfd_mach_arm_5TE       9
1738 #define bfd_mach_arm_XScale    10
1739 #define bfd_mach_arm_ep9312    11
1740 #define bfd_mach_arm_iWMMXt    12
1741   bfd_arch_ns32k,     /* National Semiconductors ns32000 */
1742   bfd_arch_w65,       /* WDC 65816 */
1743   bfd_arch_tic30,     /* Texas Instruments TMS320C30 */
1744   bfd_arch_tic4x,     /* Texas Instruments TMS320C3X/4X */
1745 #define bfd_mach_tic3x         30
1746 #define bfd_mach_tic4x         40
1747   bfd_arch_tic54x,    /* Texas Instruments TMS320C54X */
1748   bfd_arch_tic80,     /* TI TMS320c80 (MVP) */
1749   bfd_arch_v850,      /* NEC V850 */
1750 #define bfd_mach_v850          1
1751 #define bfd_mach_v850e         'E'
1752   bfd_arch_arc,       /* ARC Cores */
1753 #define bfd_mach_arc_5         5
1754 #define bfd_mach_arc_6         6
1755 #define bfd_mach_arc_7         7
1756 #define bfd_mach_arc_8         8
1757   bfd_arch_m32r,      /* Renesas M32R (formerly Mitsubishi M32R/D) */
1758 #define bfd_mach_m32r          1 /* For backwards compatibility.  */
1759 #define bfd_mach_m32rx         'x'
1760   bfd_arch_mn10200,   /* Matsushita MN10200 */
1761   bfd_arch_mn10300,   /* Matsushita MN10300 */
1762 #define bfd_mach_mn10300               300
1763 #define bfd_mach_am33          330
1764   bfd_arch_fr30,
1765 #define bfd_mach_fr30          0x46523330
1766   bfd_arch_frv,
1767 #define bfd_mach_frv           1
1768 #define bfd_mach_frvsimple     2
1769 #define bfd_mach_fr300         300
1770 #define bfd_mach_fr400         400
1771 #define bfd_mach_frvtomcat     499     /* fr500 prototype */
1772 #define bfd_mach_fr500         500
1773   bfd_arch_mcore,
1774   bfd_arch_ia64,      /* HP/Intel ia64 */
1775 #define bfd_mach_ia64_elf64    64
1776 #define bfd_mach_ia64_elf32    32
1777   bfd_arch_ip2k,      /* Ubicom IP2K microcontrollers. */
1778 #define bfd_mach_ip2022        1
1779 #define bfd_mach_ip2022ext     2
1780  bfd_arch_iq2000,     /* Vitesse IQ2000.  */
1781 #define bfd_mach_iq2000        1
1782 #define bfd_mach_iq10          2
1783   bfd_arch_pj,
1784   bfd_arch_avr,       /* Atmel AVR microcontrollers.  */
1785 #define bfd_mach_avr1          1
1786 #define bfd_mach_avr2          2
1787 #define bfd_mach_avr3          3
1788 #define bfd_mach_avr4          4
1789 #define bfd_mach_avr5          5
1790   bfd_arch_cris,      /* Axis CRIS */
1791   bfd_arch_s390,      /* IBM s390 */
1792 #define bfd_mach_s390_31       31
1793 #define bfd_mach_s390_64       64
1794   bfd_arch_openrisc,  /* OpenRISC */
1795   bfd_arch_mmix,      /* Donald Knuth's educational processor.  */
1796   bfd_arch_xstormy16,
1797 #define bfd_mach_xstormy16     1
1798   bfd_arch_msp430,    /* Texas Instruments MSP430 architecture.  */
1799 #define bfd_mach_msp110         110
1800 #define bfd_mach_msp11          11
1801 #define bfd_mach_msp12          12
1802 #define bfd_mach_msp13          13
1803 #define bfd_mach_msp14          14
1804 #define bfd_mach_msp41          41
1805 #define bfd_mach_msp31          31
1806 #define bfd_mach_msp32          32
1807 #define bfd_mach_msp33          33
1808 #define bfd_mach_msp43          43
1809 #define bfd_mach_msp44          44
1810 #define bfd_mach_msp15          15
1811 #define bfd_mach_msp16          16
1812   bfd_arch_xtensa,    /* Tensilica's Xtensa cores.  */
1813 #define bfd_mach_xtensa        1
1814   bfd_arch_last
1815   };
1816
1817 typedef struct bfd_arch_info
1818 {
1819   int bits_per_word;
1820   int bits_per_address;
1821   int bits_per_byte;
1822   enum bfd_architecture arch;
1823   unsigned long mach;
1824   const char *arch_name;
1825   const char *printable_name;
1826   unsigned int section_align_power;
1827   /* TRUE if this is the default machine for the architecture.
1828      The default arch should be the first entry for an arch so that
1829      all the entries for that arch can be accessed via <<next>>.  */
1830   bfd_boolean the_default;
1831   const struct bfd_arch_info * (*compatible)
1832        PARAMS ((const struct bfd_arch_info *a,
1833                 const struct bfd_arch_info *b));
1834
1835   bfd_boolean (*scan) PARAMS ((const struct bfd_arch_info *, const char *));
1836
1837   const struct bfd_arch_info *next;
1838 }
1839 bfd_arch_info_type;
1840
1841 const char *
1842 bfd_printable_name PARAMS ((bfd *abfd));
1843
1844 const bfd_arch_info_type *
1845 bfd_scan_arch PARAMS ((const char *string));
1846
1847 const char **
1848 bfd_arch_list PARAMS ((void));
1849
1850 const bfd_arch_info_type *
1851 bfd_arch_get_compatible PARAMS ((
1852     const bfd *abfd,
1853     const bfd *bbfd,
1854     bfd_boolean accept_unknowns));
1855
1856 void
1857 bfd_set_arch_info PARAMS ((bfd *abfd, const bfd_arch_info_type *arg));
1858
1859 enum bfd_architecture
1860 bfd_get_arch PARAMS ((bfd *abfd));
1861
1862 unsigned long
1863 bfd_get_mach PARAMS ((bfd *abfd));
1864
1865 unsigned int
1866 bfd_arch_bits_per_byte PARAMS ((bfd *abfd));
1867
1868 unsigned int
1869 bfd_arch_bits_per_address PARAMS ((bfd *abfd));
1870
1871 const bfd_arch_info_type *
1872 bfd_get_arch_info PARAMS ((bfd *abfd));
1873
1874 const bfd_arch_info_type *
1875 bfd_lookup_arch PARAMS ((enum bfd_architecture
1876     arch,
1877     unsigned long machine));
1878
1879 const char *
1880 bfd_printable_arch_mach PARAMS ((enum bfd_architecture arch, unsigned long machine));
1881
1882 unsigned int
1883 bfd_octets_per_byte PARAMS ((bfd *abfd));
1884
1885 unsigned int
1886 bfd_arch_mach_octets_per_byte PARAMS ((enum bfd_architecture arch,
1887     unsigned long machine));
1888
1889 /* Extracted from reloc.c.  */
1890 typedef enum bfd_reloc_status
1891 {
1892   /* No errors detected.  */
1893   bfd_reloc_ok,
1894
1895   /* The relocation was performed, but there was an overflow.  */
1896   bfd_reloc_overflow,
1897
1898   /* The address to relocate was not within the section supplied.  */
1899   bfd_reloc_outofrange,
1900
1901   /* Used by special functions.  */
1902   bfd_reloc_continue,
1903
1904   /* Unsupported relocation size requested.  */
1905   bfd_reloc_notsupported,
1906
1907   /* Unused.  */
1908   bfd_reloc_other,
1909
1910   /* The symbol to relocate against was undefined.  */
1911   bfd_reloc_undefined,
1912
1913   /* The relocation was performed, but may not be ok - presently
1914      generated only when linking i960 coff files with i960 b.out
1915      symbols.  If this type is returned, the error_message argument
1916      to bfd_perform_relocation will be set.  */
1917   bfd_reloc_dangerous
1918  }
1919  bfd_reloc_status_type;
1920
1921
1922 typedef struct reloc_cache_entry
1923 {
1924   /* A pointer into the canonical table of pointers.  */
1925   struct symbol_cache_entry **sym_ptr_ptr;
1926
1927   /* offset in section.  */
1928   bfd_size_type address;
1929
1930   /* addend for relocation value.  */
1931   bfd_vma addend;
1932
1933   /* Pointer to how to perform the required relocation.  */
1934   reloc_howto_type *howto;
1935
1936 }
1937 arelent;
1938
1939 enum complain_overflow
1940 {
1941   /* Do not complain on overflow.  */
1942   complain_overflow_dont,
1943
1944   /* Complain if the bitfield overflows, whether it is considered
1945      as signed or unsigned.  */
1946   complain_overflow_bitfield,
1947
1948   /* Complain if the value overflows when considered as signed
1949      number.  */
1950   complain_overflow_signed,
1951
1952   /* Complain if the value overflows when considered as an
1953      unsigned number.  */
1954   complain_overflow_unsigned
1955 };
1956
1957 struct reloc_howto_struct
1958 {
1959   /*  The type field has mainly a documentary use - the back end can
1960       do what it wants with it, though normally the back end's
1961       external idea of what a reloc number is stored
1962       in this field.  For example, a PC relative word relocation
1963       in a coff environment has the type 023 - because that's
1964       what the outside world calls a R_PCRWORD reloc.  */
1965   unsigned int type;
1966
1967   /*  The value the final relocation is shifted right by.  This drops
1968       unwanted data from the relocation.  */
1969   unsigned int rightshift;
1970
1971   /*  The size of the item to be relocated.  This is *not* a
1972       power-of-two measure.  To get the number of bytes operated
1973       on by a type of relocation, use bfd_get_reloc_size.  */
1974   int size;
1975
1976   /*  The number of bits in the item to be relocated.  This is used
1977       when doing overflow checking.  */
1978   unsigned int bitsize;
1979
1980   /*  Notes that the relocation is relative to the location in the
1981       data section of the addend.  The relocation function will
1982       subtract from the relocation value the address of the location
1983       being relocated.  */
1984   bfd_boolean pc_relative;
1985
1986   /*  The bit position of the reloc value in the destination.
1987       The relocated value is left shifted by this amount.  */
1988   unsigned int bitpos;
1989
1990   /* What type of overflow error should be checked for when
1991      relocating.  */
1992   enum complain_overflow complain_on_overflow;
1993
1994   /* If this field is non null, then the supplied function is
1995      called rather than the normal function.  This allows really
1996      strange relocation methods to be accomodated (e.g., i960 callj
1997      instructions).  */
1998   bfd_reloc_status_type (*special_function)
1999     PARAMS ((bfd *, arelent *, struct symbol_cache_entry *, PTR, asection *,
2000              bfd *, char **));
2001
2002   /* The textual name of the relocation type.  */
2003   char *name;
2004
2005   /* Some formats record a relocation addend in the section contents
2006      rather than with the relocation.  For ELF formats this is the
2007      distinction between USE_REL and USE_RELA (though the code checks
2008      for USE_REL == 1/0).  The value of this field is TRUE if the
2009      addend is recorded with the section contents; when performing a
2010      partial link (ld -r) the section contents (the data) will be
2011      modified.  The value of this field is FALSE if addends are
2012      recorded with the relocation (in arelent.addend); when performing
2013      a partial link the relocation will be modified.
2014      All relocations for all ELF USE_RELA targets should set this field
2015      to FALSE (values of TRUE should be looked on with suspicion).
2016      However, the converse is not true: not all relocations of all ELF
2017      USE_REL targets set this field to TRUE.  Why this is so is peculiar
2018      to each particular target.  For relocs that aren't used in partial
2019      links (e.g. GOT stuff) it doesn't matter what this is set to.  */
2020   bfd_boolean partial_inplace;
2021
2022   /* src_mask selects the part of the instruction (or data) to be used
2023      in the relocation sum.  If the target relocations don't have an
2024      addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
2025      dst_mask to extract the addend from the section contents.  If
2026      relocations do have an addend in the reloc, eg. ELF USE_RELA, this
2027      field should be zero.  Non-zero values for ELF USE_RELA targets are
2028      bogus as in those cases the value in the dst_mask part of the
2029      section contents should be treated as garbage.  */
2030   bfd_vma src_mask;
2031
2032   /* dst_mask selects which parts of the instruction (or data) are
2033      replaced with a relocated value.  */
2034   bfd_vma dst_mask;
2035
2036   /* When some formats create PC relative instructions, they leave
2037      the value of the pc of the place being relocated in the offset
2038      slot of the instruction, so that a PC relative relocation can
2039      be made just by adding in an ordinary offset (e.g., sun3 a.out).
2040      Some formats leave the displacement part of an instruction
2041      empty (e.g., m88k bcs); this flag signals the fact.  */
2042   bfd_boolean pcrel_offset;
2043 };
2044
2045 #define HOWTO(C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
2046   { (unsigned) C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC }
2047 #define NEWHOWTO(FUNCTION, NAME, SIZE, REL, IN) \
2048   HOWTO (0, 0, SIZE, 0, REL, 0, complain_overflow_dont, FUNCTION, \
2049          NAME, FALSE, 0, 0, IN)
2050
2051 #define EMPTY_HOWTO(C) \
2052   HOWTO ((C), 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL, \
2053          NULL, FALSE, 0, 0, FALSE)
2054
2055 #define HOWTO_PREPARE(relocation, symbol)               \
2056   {                                                     \
2057     if (symbol != (asymbol *) NULL)                     \
2058       {                                                 \
2059         if (bfd_is_com_section (symbol->section))       \
2060           {                                             \
2061             relocation = 0;                             \
2062           }                                             \
2063         else                                            \
2064           {                                             \
2065             relocation = symbol->value;                 \
2066           }                                             \
2067       }                                                 \
2068   }
2069
2070 unsigned int
2071 bfd_get_reloc_size PARAMS ((reloc_howto_type *));
2072
2073 typedef struct relent_chain
2074 {
2075   arelent relent;
2076   struct relent_chain *next;
2077 }
2078 arelent_chain;
2079
2080 bfd_reloc_status_type
2081 bfd_check_overflow PARAMS ((enum complain_overflow how,
2082     unsigned int bitsize,
2083     unsigned int rightshift,
2084     unsigned int addrsize,
2085     bfd_vma relocation));
2086
2087 bfd_reloc_status_type
2088 bfd_perform_relocation PARAMS ((bfd *abfd,
2089     arelent *reloc_entry,
2090     PTR data,
2091     asection *input_section,
2092     bfd *output_bfd,
2093     char **error_message));
2094
2095 bfd_reloc_status_type
2096 bfd_install_relocation PARAMS ((bfd *abfd,
2097     arelent *reloc_entry,
2098     PTR data, bfd_vma data_start,
2099     asection *input_section,
2100     char **error_message));
2101
2102 enum bfd_reloc_code_real {
2103   _dummy_first_bfd_reloc_code_real,
2104
2105
2106 /* Basic absolute relocations of N bits.  */
2107   BFD_RELOC_64,
2108   BFD_RELOC_32,
2109   BFD_RELOC_26,
2110   BFD_RELOC_24,
2111   BFD_RELOC_16,
2112   BFD_RELOC_14,
2113   BFD_RELOC_8,
2114
2115 /* PC-relative relocations.  Sometimes these are relative to the address
2116 of the relocation itself; sometimes they are relative to the start of
2117 the section containing the relocation.  It depends on the specific target.
2118
2119 The 24-bit relocation is used in some Intel 960 configurations.  */
2120   BFD_RELOC_64_PCREL,
2121   BFD_RELOC_32_PCREL,
2122   BFD_RELOC_24_PCREL,
2123   BFD_RELOC_16_PCREL,
2124   BFD_RELOC_12_PCREL,
2125   BFD_RELOC_8_PCREL,
2126
2127 /* For ELF.  */
2128   BFD_RELOC_32_GOT_PCREL,
2129   BFD_RELOC_16_GOT_PCREL,
2130   BFD_RELOC_8_GOT_PCREL,
2131   BFD_RELOC_32_GOTOFF,
2132   BFD_RELOC_16_GOTOFF,
2133   BFD_RELOC_LO16_GOTOFF,
2134   BFD_RELOC_HI16_GOTOFF,
2135   BFD_RELOC_HI16_S_GOTOFF,
2136   BFD_RELOC_8_GOTOFF,
2137   BFD_RELOC_64_PLT_PCREL,
2138   BFD_RELOC_32_PLT_PCREL,
2139   BFD_RELOC_24_PLT_PCREL,
2140   BFD_RELOC_16_PLT_PCREL,
2141   BFD_RELOC_8_PLT_PCREL,
2142   BFD_RELOC_64_PLTOFF,
2143   BFD_RELOC_32_PLTOFF,
2144   BFD_RELOC_16_PLTOFF,
2145   BFD_RELOC_LO16_PLTOFF,
2146   BFD_RELOC_HI16_PLTOFF,
2147   BFD_RELOC_HI16_S_PLTOFF,
2148   BFD_RELOC_8_PLTOFF,
2149
2150 /* Relocations used by 68K ELF.  */
2151   BFD_RELOC_68K_GLOB_DAT,
2152   BFD_RELOC_68K_JMP_SLOT,
2153   BFD_RELOC_68K_RELATIVE,
2154
2155 /* Linkage-table relative.  */
2156   BFD_RELOC_32_BASEREL,
2157   BFD_RELOC_16_BASEREL,
2158   BFD_RELOC_LO16_BASEREL,
2159   BFD_RELOC_HI16_BASEREL,
2160   BFD_RELOC_HI16_S_BASEREL,
2161   BFD_RELOC_8_BASEREL,
2162   BFD_RELOC_RVA,
2163
2164 /* Absolute 8-bit relocation, but used to form an address like 0xFFnn.  */
2165   BFD_RELOC_8_FFnn,
2166
2167 /* These PC-relative relocations are stored as word displacements --
2168 i.e., byte displacements shifted right two bits.  The 30-bit word
2169 displacement (<<32_PCREL_S2>> -- 32 bits, shifted 2) is used on the
2170 SPARC.  (SPARC tools generally refer to this as <<WDISP30>>.)  The
2171 signed 16-bit displacement is used on the MIPS, and the 23-bit
2172 displacement is used on the Alpha.  */
2173   BFD_RELOC_32_PCREL_S2,
2174   BFD_RELOC_16_PCREL_S2,
2175   BFD_RELOC_23_PCREL_S2,
2176
2177 /* High 22 bits and low 10 bits of 32-bit value, placed into lower bits of
2178 the target word.  These are used on the SPARC.  */
2179   BFD_RELOC_HI22,
2180   BFD_RELOC_LO10,
2181
2182 /* For systems that allocate a Global Pointer register, these are
2183 displacements off that register.  These relocation types are
2184 handled specially, because the value the register will have is
2185 decided relatively late.  */
2186   BFD_RELOC_GPREL16,
2187   BFD_RELOC_GPREL32,
2188
2189 /* Reloc types used for i960/b.out.  */
2190   BFD_RELOC_I960_CALLJ,
2191
2192 /* SPARC ELF relocations.  There is probably some overlap with other
2193 relocation types already defined.  */
2194   BFD_RELOC_NONE,
2195   BFD_RELOC_SPARC_WDISP22,
2196   BFD_RELOC_SPARC22,
2197   BFD_RELOC_SPARC13,
2198   BFD_RELOC_SPARC_GOT10,
2199   BFD_RELOC_SPARC_GOT13,
2200   BFD_RELOC_SPARC_GOT22,
2201   BFD_RELOC_SPARC_PC10,
2202   BFD_RELOC_SPARC_PC22,
2203   BFD_RELOC_SPARC_WPLT30,
2204   BFD_RELOC_SPARC_COPY,
2205   BFD_RELOC_SPARC_GLOB_DAT,
2206   BFD_RELOC_SPARC_JMP_SLOT,
2207   BFD_RELOC_SPARC_RELATIVE,
2208   BFD_RELOC_SPARC_UA16,
2209   BFD_RELOC_SPARC_UA32,
2210   BFD_RELOC_SPARC_UA64,
2211
2212 /* I think these are specific to SPARC a.out (e.g., Sun 4).  */
2213   BFD_RELOC_SPARC_BASE13,
2214   BFD_RELOC_SPARC_BASE22,
2215
2216 /* SPARC64 relocations  */
2217 #define BFD_RELOC_SPARC_64 BFD_RELOC_64
2218   BFD_RELOC_SPARC_10,
2219   BFD_RELOC_SPARC_11,
2220   BFD_RELOC_SPARC_OLO10,
2221   BFD_RELOC_SPARC_HH22,
2222   BFD_RELOC_SPARC_HM10,
2223   BFD_RELOC_SPARC_LM22,
2224   BFD_RELOC_SPARC_PC_HH22,
2225   BFD_RELOC_SPARC_PC_HM10,
2226   BFD_RELOC_SPARC_PC_LM22,
2227   BFD_RELOC_SPARC_WDISP16,
2228   BFD_RELOC_SPARC_WDISP19,
2229   BFD_RELOC_SPARC_7,
2230   BFD_RELOC_SPARC_6,
2231   BFD_RELOC_SPARC_5,
2232 #define BFD_RELOC_SPARC_DISP64 BFD_RELOC_64_PCREL
2233   BFD_RELOC_SPARC_PLT32,
2234   BFD_RELOC_SPARC_PLT64,
2235   BFD_RELOC_SPARC_HIX22,
2236   BFD_RELOC_SPARC_LOX10,
2237   BFD_RELOC_SPARC_H44,
2238   BFD_RELOC_SPARC_M44,
2239   BFD_RELOC_SPARC_L44,
2240   BFD_RELOC_SPARC_REGISTER,
2241
2242 /* SPARC little endian relocation  */
2243   BFD_RELOC_SPARC_REV32,
2244
2245 /* SPARC TLS relocations  */
2246   BFD_RELOC_SPARC_TLS_GD_HI22,
2247   BFD_RELOC_SPARC_TLS_GD_LO10,
2248   BFD_RELOC_SPARC_TLS_GD_ADD,
2249   BFD_RELOC_SPARC_TLS_GD_CALL,
2250   BFD_RELOC_SPARC_TLS_LDM_HI22,
2251   BFD_RELOC_SPARC_TLS_LDM_LO10,
2252   BFD_RELOC_SPARC_TLS_LDM_ADD,
2253   BFD_RELOC_SPARC_TLS_LDM_CALL,
2254   BFD_RELOC_SPARC_TLS_LDO_HIX22,
2255   BFD_RELOC_SPARC_TLS_LDO_LOX10,
2256   BFD_RELOC_SPARC_TLS_LDO_ADD,
2257   BFD_RELOC_SPARC_TLS_IE_HI22,
2258   BFD_RELOC_SPARC_TLS_IE_LO10,
2259   BFD_RELOC_SPARC_TLS_IE_LD,
2260   BFD_RELOC_SPARC_TLS_IE_LDX,
2261   BFD_RELOC_SPARC_TLS_IE_ADD,
2262   BFD_RELOC_SPARC_TLS_LE_HIX22,
2263   BFD_RELOC_SPARC_TLS_LE_LOX10,
2264   BFD_RELOC_SPARC_TLS_DTPMOD32,
2265   BFD_RELOC_SPARC_TLS_DTPMOD64,
2266   BFD_RELOC_SPARC_TLS_DTPOFF32,
2267   BFD_RELOC_SPARC_TLS_DTPOFF64,
2268   BFD_RELOC_SPARC_TLS_TPOFF32,
2269   BFD_RELOC_SPARC_TLS_TPOFF64,
2270
2271 /* Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
2272 "addend" in some special way.
2273 For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
2274 writing; when reading, it will be the absolute section symbol.  The
2275 addend is the displacement in bytes of the "lda" instruction from
2276 the "ldah" instruction (which is at the address of this reloc).  */
2277   BFD_RELOC_ALPHA_GPDISP_HI16,
2278
2279 /* For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
2280 with GPDISP_HI16 relocs.  The addend is ignored when writing the
2281 relocations out, and is filled in with the file's GP value on
2282 reading, for convenience.  */
2283   BFD_RELOC_ALPHA_GPDISP_LO16,
2284
2285 /* The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
2286 relocation except that there is no accompanying GPDISP_LO16
2287 relocation.  */
2288   BFD_RELOC_ALPHA_GPDISP,
2289
2290 /* The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
2291 the assembler turns it into a LDQ instruction to load the address of
2292 the symbol, and then fills in a register in the real instruction.
2293
2294 The LITERAL reloc, at the LDQ instruction, refers to the .lita
2295 section symbol.  The addend is ignored when writing, but is filled
2296 in with the file's GP value on reading, for convenience, as with the
2297 GPDISP_LO16 reloc.
2298
2299 The ELF_LITERAL reloc is somewhere between 16_GOTOFF and GPDISP_LO16.
2300 It should refer to the symbol to be referenced, as with 16_GOTOFF,
2301 but it generates output not based on the position within the .got
2302 section, but relative to the GP value chosen for the file during the
2303 final link stage.
2304
2305 The LITUSE reloc, on the instruction using the loaded address, gives
2306 information to the linker that it might be able to use to optimize
2307 away some literal section references.  The symbol is ignored (read
2308 as the absolute section symbol), and the "addend" indicates the type
2309 of instruction using the register:
2310 1 - "memory" fmt insn
2311 2 - byte-manipulation (byte offset reg)
2312 3 - jsr (target of branch)  */
2313   BFD_RELOC_ALPHA_LITERAL,
2314   BFD_RELOC_ALPHA_ELF_LITERAL,
2315   BFD_RELOC_ALPHA_LITUSE,
2316
2317 /* The HINT relocation indicates a value that should be filled into the
2318 "hint" field of a jmp/jsr/ret instruction, for possible branch-
2319 prediction logic which may be provided on some processors.  */
2320   BFD_RELOC_ALPHA_HINT,
2321
2322 /* The LINKAGE relocation outputs a linkage pair in the object file,
2323 which is filled by the linker.  */
2324   BFD_RELOC_ALPHA_LINKAGE,
2325
2326 /* The CODEADDR relocation outputs a STO_CA in the object file,
2327 which is filled by the linker.  */
2328   BFD_RELOC_ALPHA_CODEADDR,
2329
2330 /* The GPREL_HI/LO relocations together form a 32-bit offset from the
2331 GP register.  */
2332   BFD_RELOC_ALPHA_GPREL_HI16,
2333   BFD_RELOC_ALPHA_GPREL_LO16,
2334
2335 /* Like BFD_RELOC_23_PCREL_S2, except that the source and target must
2336 share a common GP, and the target address is adjusted for
2337 STO_ALPHA_STD_GPLOAD.  */
2338   BFD_RELOC_ALPHA_BRSGP,
2339
2340 /* Alpha thread-local storage relocations.  */
2341   BFD_RELOC_ALPHA_TLSGD,
2342   BFD_RELOC_ALPHA_TLSLDM,
2343   BFD_RELOC_ALPHA_DTPMOD64,
2344   BFD_RELOC_ALPHA_GOTDTPREL16,
2345   BFD_RELOC_ALPHA_DTPREL64,
2346   BFD_RELOC_ALPHA_DTPREL_HI16,
2347   BFD_RELOC_ALPHA_DTPREL_LO16,
2348   BFD_RELOC_ALPHA_DTPREL16,
2349   BFD_RELOC_ALPHA_GOTTPREL16,
2350   BFD_RELOC_ALPHA_TPREL64,
2351   BFD_RELOC_ALPHA_TPREL_HI16,
2352   BFD_RELOC_ALPHA_TPREL_LO16,
2353   BFD_RELOC_ALPHA_TPREL16,
2354
2355 /* Bits 27..2 of the relocation address shifted right 2 bits;
2356 simple reloc otherwise.  */
2357   BFD_RELOC_MIPS_JMP,
2358
2359 /* The MIPS16 jump instruction.  */
2360   BFD_RELOC_MIPS16_JMP,
2361
2362 /* MIPS16 GP relative reloc.  */
2363   BFD_RELOC_MIPS16_GPREL,
2364
2365 /* High 16 bits of 32-bit value; simple reloc.  */
2366   BFD_RELOC_HI16,
2367
2368 /* High 16 bits of 32-bit value but the low 16 bits will be sign
2369 extended and added to form the final result.  If the low 16
2370 bits form a negative number, we need to add one to the high value
2371 to compensate for the borrow when the low bits are added.  */
2372   BFD_RELOC_HI16_S,
2373
2374 /* Low 16 bits.  */
2375   BFD_RELOC_LO16,
2376
2377 /* Like BFD_RELOC_HI16_S, but PC relative.  */
2378   BFD_RELOC_PCREL_HI16_S,
2379
2380 /* Like BFD_RELOC_LO16, but PC relative.  */
2381   BFD_RELOC_PCREL_LO16,
2382
2383 /* Relocation against a MIPS literal section.  */
2384   BFD_RELOC_MIPS_LITERAL,
2385
2386 /* MIPS ELF relocations.  */
2387   BFD_RELOC_MIPS_GOT16,
2388   BFD_RELOC_MIPS_CALL16,
2389   BFD_RELOC_MIPS_GOT_HI16,
2390   BFD_RELOC_MIPS_GOT_LO16,
2391   BFD_RELOC_MIPS_CALL_HI16,
2392   BFD_RELOC_MIPS_CALL_LO16,
2393   BFD_RELOC_MIPS_SUB,
2394   BFD_RELOC_MIPS_GOT_PAGE,
2395   BFD_RELOC_MIPS_GOT_OFST,
2396   BFD_RELOC_MIPS_GOT_DISP,
2397   BFD_RELOC_MIPS_SHIFT5,
2398   BFD_RELOC_MIPS_SHIFT6,
2399   BFD_RELOC_MIPS_INSERT_A,
2400   BFD_RELOC_MIPS_INSERT_B,
2401   BFD_RELOC_MIPS_DELETE,
2402   BFD_RELOC_MIPS_HIGHEST,
2403   BFD_RELOC_MIPS_HIGHER,
2404   BFD_RELOC_MIPS_SCN_DISP,
2405   BFD_RELOC_MIPS_REL16,
2406   BFD_RELOC_MIPS_RELGOT,
2407   BFD_RELOC_MIPS_JALR,
2408
2409 /* Fujitsu Frv Relocations.  */
2410   BFD_RELOC_FRV_LABEL16,
2411   BFD_RELOC_FRV_LABEL24,
2412   BFD_RELOC_FRV_LO16,
2413   BFD_RELOC_FRV_HI16,
2414   BFD_RELOC_FRV_GPREL12,
2415   BFD_RELOC_FRV_GPRELU12,
2416   BFD_RELOC_FRV_GPREL32,
2417   BFD_RELOC_FRV_GPRELHI,
2418   BFD_RELOC_FRV_GPRELLO,
2419
2420
2421 /* i386/elf relocations  */
2422   BFD_RELOC_386_GOT32,
2423   BFD_RELOC_386_PLT32,
2424   BFD_RELOC_386_COPY,
2425   BFD_RELOC_386_GLOB_DAT,
2426   BFD_RELOC_386_JUMP_SLOT,
2427   BFD_RELOC_386_RELATIVE,
2428   BFD_RELOC_386_GOTOFF,
2429   BFD_RELOC_386_GOTPC,
2430   BFD_RELOC_386_TLS_TPOFF,
2431   BFD_RELOC_386_TLS_IE,
2432   BFD_RELOC_386_TLS_GOTIE,
2433   BFD_RELOC_386_TLS_LE,
2434   BFD_RELOC_386_TLS_GD,
2435   BFD_RELOC_386_TLS_LDM,
2436   BFD_RELOC_386_TLS_LDO_32,
2437   BFD_RELOC_386_TLS_IE_32,
2438   BFD_RELOC_386_TLS_LE_32,
2439   BFD_RELOC_386_TLS_DTPMOD32,
2440   BFD_RELOC_386_TLS_DTPOFF32,
2441   BFD_RELOC_386_TLS_TPOFF32,
2442
2443 /* x86-64/elf relocations  */
2444   BFD_RELOC_X86_64_GOT32,
2445   BFD_RELOC_X86_64_PLT32,
2446   BFD_RELOC_X86_64_COPY,
2447   BFD_RELOC_X86_64_GLOB_DAT,
2448   BFD_RELOC_X86_64_JUMP_SLOT,
2449   BFD_RELOC_X86_64_RELATIVE,
2450   BFD_RELOC_X86_64_GOTPCREL,
2451   BFD_RELOC_X86_64_32S,
2452   BFD_RELOC_X86_64_DTPMOD64,
2453   BFD_RELOC_X86_64_DTPOFF64,
2454   BFD_RELOC_X86_64_TPOFF64,
2455   BFD_RELOC_X86_64_TLSGD,
2456   BFD_RELOC_X86_64_TLSLD,
2457   BFD_RELOC_X86_64_DTPOFF32,
2458   BFD_RELOC_X86_64_GOTTPOFF,
2459   BFD_RELOC_X86_64_TPOFF32,
2460
2461 /* ns32k relocations  */
2462   BFD_RELOC_NS32K_IMM_8,
2463   BFD_RELOC_NS32K_IMM_16,
2464   BFD_RELOC_NS32K_IMM_32,
2465   BFD_RELOC_NS32K_IMM_8_PCREL,
2466   BFD_RELOC_NS32K_IMM_16_PCREL,
2467   BFD_RELOC_NS32K_IMM_32_PCREL,
2468   BFD_RELOC_NS32K_DISP_8,
2469   BFD_RELOC_NS32K_DISP_16,
2470   BFD_RELOC_NS32K_DISP_32,
2471   BFD_RELOC_NS32K_DISP_8_PCREL,
2472   BFD_RELOC_NS32K_DISP_16_PCREL,
2473   BFD_RELOC_NS32K_DISP_32_PCREL,
2474
2475 /* PDP11 relocations  */
2476   BFD_RELOC_PDP11_DISP_8_PCREL,
2477   BFD_RELOC_PDP11_DISP_6_PCREL,
2478
2479 /* Picojava relocs.  Not all of these appear in object files.  */
2480   BFD_RELOC_PJ_CODE_HI16,
2481   BFD_RELOC_PJ_CODE_LO16,
2482   BFD_RELOC_PJ_CODE_DIR16,
2483   BFD_RELOC_PJ_CODE_DIR32,
2484   BFD_RELOC_PJ_CODE_REL16,
2485   BFD_RELOC_PJ_CODE_REL32,
2486
2487 /* Power(rs6000) and PowerPC relocations.  */
2488   BFD_RELOC_PPC_B26,
2489   BFD_RELOC_PPC_BA26,
2490   BFD_RELOC_PPC_TOC16,
2491   BFD_RELOC_PPC_B16,
2492   BFD_RELOC_PPC_B16_BRTAKEN,
2493   BFD_RELOC_PPC_B16_BRNTAKEN,
2494   BFD_RELOC_PPC_BA16,
2495   BFD_RELOC_PPC_BA16_BRTAKEN,
2496   BFD_RELOC_PPC_BA16_BRNTAKEN,
2497   BFD_RELOC_PPC_COPY,
2498   BFD_RELOC_PPC_GLOB_DAT,
2499   BFD_RELOC_PPC_JMP_SLOT,
2500   BFD_RELOC_PPC_RELATIVE,
2501   BFD_RELOC_PPC_LOCAL24PC,
2502   BFD_RELOC_PPC_EMB_NADDR32,
2503   BFD_RELOC_PPC_EMB_NADDR16,
2504   BFD_RELOC_PPC_EMB_NADDR16_LO,
2505   BFD_RELOC_PPC_EMB_NADDR16_HI,
2506   BFD_RELOC_PPC_EMB_NADDR16_HA,
2507   BFD_RELOC_PPC_EMB_SDAI16,
2508   BFD_RELOC_PPC_EMB_SDA2I16,
2509   BFD_RELOC_PPC_EMB_SDA2REL,
2510   BFD_RELOC_PPC_EMB_SDA21,
2511   BFD_RELOC_PPC_EMB_MRKREF,
2512   BFD_RELOC_PPC_EMB_RELSEC16,
2513   BFD_RELOC_PPC_EMB_RELST_LO,
2514   BFD_RELOC_PPC_EMB_RELST_HI,
2515   BFD_RELOC_PPC_EMB_RELST_HA,
2516   BFD_RELOC_PPC_EMB_BIT_FLD,
2517   BFD_RELOC_PPC_EMB_RELSDA,
2518   BFD_RELOC_PPC64_HIGHER,
2519   BFD_RELOC_PPC64_HIGHER_S,
2520   BFD_RELOC_PPC64_HIGHEST,
2521   BFD_RELOC_PPC64_HIGHEST_S,
2522   BFD_RELOC_PPC64_TOC16_LO,
2523   BFD_RELOC_PPC64_TOC16_HI,
2524   BFD_RELOC_PPC64_TOC16_HA,
2525   BFD_RELOC_PPC64_TOC,
2526   BFD_RELOC_PPC64_PLTGOT16,
2527   BFD_RELOC_PPC64_PLTGOT16_LO,
2528   BFD_RELOC_PPC64_PLTGOT16_HI,
2529   BFD_RELOC_PPC64_PLTGOT16_HA,
2530   BFD_RELOC_PPC64_ADDR16_DS,
2531   BFD_RELOC_PPC64_ADDR16_LO_DS,
2532   BFD_RELOC_PPC64_GOT16_DS,
2533   BFD_RELOC_PPC64_GOT16_LO_DS,
2534   BFD_RELOC_PPC64_PLT16_LO_DS,
2535   BFD_RELOC_PPC64_SECTOFF_DS,
2536   BFD_RELOC_PPC64_SECTOFF_LO_DS,
2537   BFD_RELOC_PPC64_TOC16_DS,
2538   BFD_RELOC_PPC64_TOC16_LO_DS,
2539   BFD_RELOC_PPC64_PLTGOT16_DS,
2540   BFD_RELOC_PPC64_PLTGOT16_LO_DS,
2541
2542 /* PowerPC and PowerPC64 thread-local storage relocations.  */
2543   BFD_RELOC_PPC_TLS,
2544   BFD_RELOC_PPC_DTPMOD,
2545   BFD_RELOC_PPC_TPREL16,
2546   BFD_RELOC_PPC_TPREL16_LO,
2547   BFD_RELOC_PPC_TPREL16_HI,
2548   BFD_RELOC_PPC_TPREL16_HA,
2549   BFD_RELOC_PPC_TPREL,
2550   BFD_RELOC_PPC_DTPREL16,
2551   BFD_RELOC_PPC_DTPREL16_LO,
2552   BFD_RELOC_PPC_DTPREL16_HI,
2553   BFD_RELOC_PPC_DTPREL16_HA,
2554   BFD_RELOC_PPC_DTPREL,
2555   BFD_RELOC_PPC_GOT_TLSGD16,
2556   BFD_RELOC_PPC_GOT_TLSGD16_LO,
2557   BFD_RELOC_PPC_GOT_TLSGD16_HI,
2558   BFD_RELOC_PPC_GOT_TLSGD16_HA,
2559   BFD_RELOC_PPC_GOT_TLSLD16,
2560   BFD_RELOC_PPC_GOT_TLSLD16_LO,
2561   BFD_RELOC_PPC_GOT_TLSLD16_HI,
2562   BFD_RELOC_PPC_GOT_TLSLD16_HA,
2563   BFD_RELOC_PPC_GOT_TPREL16,
2564   BFD_RELOC_PPC_GOT_TPREL16_LO,
2565   BFD_RELOC_PPC_GOT_TPREL16_HI,
2566   BFD_RELOC_PPC_GOT_TPREL16_HA,
2567   BFD_RELOC_PPC_GOT_DTPREL16,
2568   BFD_RELOC_PPC_GOT_DTPREL16_LO,
2569   BFD_RELOC_PPC_GOT_DTPREL16_HI,
2570   BFD_RELOC_PPC_GOT_DTPREL16_HA,
2571   BFD_RELOC_PPC64_TPREL16_DS,
2572   BFD_RELOC_PPC64_TPREL16_LO_DS,
2573   BFD_RELOC_PPC64_TPREL16_HIGHER,
2574   BFD_RELOC_PPC64_TPREL16_HIGHERA,
2575   BFD_RELOC_PPC64_TPREL16_HIGHEST,
2576   BFD_RELOC_PPC64_TPREL16_HIGHESTA,
2577   BFD_RELOC_PPC64_DTPREL16_DS,
2578   BFD_RELOC_PPC64_DTPREL16_LO_DS,
2579   BFD_RELOC_PPC64_DTPREL16_HIGHER,
2580   BFD_RELOC_PPC64_DTPREL16_HIGHERA,
2581   BFD_RELOC_PPC64_DTPREL16_HIGHEST,
2582   BFD_RELOC_PPC64_DTPREL16_HIGHESTA,
2583
2584 /* IBM 370/390 relocations  */
2585   BFD_RELOC_I370_D12,
2586
2587 /* The type of reloc used to build a contructor table - at the moment
2588 probably a 32 bit wide absolute relocation, but the target can choose.
2589 It generally does map to one of the other relocation types.  */
2590   BFD_RELOC_CTOR,
2591
2592 /* ARM 26 bit pc-relative branch.  The lowest two bits must be zero and are
2593 not stored in the instruction.  */
2594   BFD_RELOC_ARM_PCREL_BRANCH,
2595
2596 /* ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
2597 not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2598 field in the instruction.  */
2599   BFD_RELOC_ARM_PCREL_BLX,
2600
2601 /* Thumb 22 bit pc-relative branch.  The lowest bit must be zero and is
2602 not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2603 field in the instruction.  */
2604   BFD_RELOC_THUMB_PCREL_BLX,
2605
2606 /* These relocs are only used within the ARM assembler.  They are not
2607 (at present) written to any object files.  */
2608   BFD_RELOC_ARM_IMMEDIATE,
2609   BFD_RELOC_ARM_ADRL_IMMEDIATE,
2610   BFD_RELOC_ARM_OFFSET_IMM,
2611   BFD_RELOC_ARM_SHIFT_IMM,
2612   BFD_RELOC_ARM_SWI,
2613   BFD_RELOC_ARM_MULTI,
2614   BFD_RELOC_ARM_CP_OFF_IMM,
2615   BFD_RELOC_ARM_CP_OFF_IMM_S2,
2616   BFD_RELOC_ARM_ADR_IMM,
2617   BFD_RELOC_ARM_LDR_IMM,
2618   BFD_RELOC_ARM_LITERAL,
2619   BFD_RELOC_ARM_IN_POOL,
2620   BFD_RELOC_ARM_OFFSET_IMM8,
2621   BFD_RELOC_ARM_HWLITERAL,
2622   BFD_RELOC_ARM_THUMB_ADD,
2623   BFD_RELOC_ARM_THUMB_IMM,
2624   BFD_RELOC_ARM_THUMB_SHIFT,
2625   BFD_RELOC_ARM_THUMB_OFFSET,
2626   BFD_RELOC_ARM_GOT12,
2627   BFD_RELOC_ARM_GOT32,
2628   BFD_RELOC_ARM_JUMP_SLOT,
2629   BFD_RELOC_ARM_COPY,
2630   BFD_RELOC_ARM_GLOB_DAT,
2631   BFD_RELOC_ARM_PLT32,
2632   BFD_RELOC_ARM_RELATIVE,
2633   BFD_RELOC_ARM_GOTOFF,
2634   BFD_RELOC_ARM_GOTPC,
2635
2636 /* Renesas / SuperH SH relocs.  Not all of these appear in object files.  */
2637   BFD_RELOC_SH_PCDISP8BY2,
2638   BFD_RELOC_SH_PCDISP12BY2,
2639   BFD_RELOC_SH_IMM4,
2640   BFD_RELOC_SH_IMM4BY2,
2641   BFD_RELOC_SH_IMM4BY4,
2642   BFD_RELOC_SH_IMM8,
2643   BFD_RELOC_SH_IMM8BY2,
2644   BFD_RELOC_SH_IMM8BY4,
2645   BFD_RELOC_SH_PCRELIMM8BY2,
2646   BFD_RELOC_SH_PCRELIMM8BY4,
2647   BFD_RELOC_SH_SWITCH16,
2648   BFD_RELOC_SH_SWITCH32,
2649   BFD_RELOC_SH_USES,
2650   BFD_RELOC_SH_COUNT,
2651   BFD_RELOC_SH_ALIGN,
2652   BFD_RELOC_SH_CODE,
2653   BFD_RELOC_SH_DATA,
2654   BFD_RELOC_SH_LABEL,
2655   BFD_RELOC_SH_LOOP_START,
2656   BFD_RELOC_SH_LOOP_END,
2657   BFD_RELOC_SH_COPY,
2658   BFD_RELOC_SH_GLOB_DAT,
2659   BFD_RELOC_SH_JMP_SLOT,
2660   BFD_RELOC_SH_RELATIVE,
2661   BFD_RELOC_SH_GOTPC,
2662   BFD_RELOC_SH_GOT_LOW16,
2663   BFD_RELOC_SH_GOT_MEDLOW16,
2664   BFD_RELOC_SH_GOT_MEDHI16,
2665   BFD_RELOC_SH_GOT_HI16,
2666   BFD_RELOC_SH_GOTPLT_LOW16,
2667   BFD_RELOC_SH_GOTPLT_MEDLOW16,
2668   BFD_RELOC_SH_GOTPLT_MEDHI16,
2669   BFD_RELOC_SH_GOTPLT_HI16,
2670   BFD_RELOC_SH_PLT_LOW16,
2671   BFD_RELOC_SH_PLT_MEDLOW16,
2672   BFD_RELOC_SH_PLT_MEDHI16,
2673   BFD_RELOC_SH_PLT_HI16,
2674   BFD_RELOC_SH_GOTOFF_LOW16,
2675   BFD_RELOC_SH_GOTOFF_MEDLOW16,
2676   BFD_RELOC_SH_GOTOFF_MEDHI16,
2677   BFD_RELOC_SH_GOTOFF_HI16,
2678   BFD_RELOC_SH_GOTPC_LOW16,
2679   BFD_RELOC_SH_GOTPC_MEDLOW16,
2680   BFD_RELOC_SH_GOTPC_MEDHI16,
2681   BFD_RELOC_SH_GOTPC_HI16,
2682   BFD_RELOC_SH_COPY64,
2683   BFD_RELOC_SH_GLOB_DAT64,
2684   BFD_RELOC_SH_JMP_SLOT64,
2685   BFD_RELOC_SH_RELATIVE64,
2686   BFD_RELOC_SH_GOT10BY4,
2687   BFD_RELOC_SH_GOT10BY8,
2688   BFD_RELOC_SH_GOTPLT10BY4,
2689   BFD_RELOC_SH_GOTPLT10BY8,
2690   BFD_RELOC_SH_GOTPLT32,
2691   BFD_RELOC_SH_SHMEDIA_CODE,
2692   BFD_RELOC_SH_IMMU5,
2693   BFD_RELOC_SH_IMMS6,
2694   BFD_RELOC_SH_IMMS6BY32,
2695   BFD_RELOC_SH_IMMU6,
2696   BFD_RELOC_SH_IMMS10,
2697   BFD_RELOC_SH_IMMS10BY2,
2698   BFD_RELOC_SH_IMMS10BY4,
2699   BFD_RELOC_SH_IMMS10BY8,
2700   BFD_RELOC_SH_IMMS16,
2701   BFD_RELOC_SH_IMMU16,
2702   BFD_RELOC_SH_IMM_LOW16,
2703   BFD_RELOC_SH_IMM_LOW16_PCREL,
2704   BFD_RELOC_SH_IMM_MEDLOW16,
2705   BFD_RELOC_SH_IMM_MEDLOW16_PCREL,
2706   BFD_RELOC_SH_IMM_MEDHI16,
2707   BFD_RELOC_SH_IMM_MEDHI16_PCREL,
2708   BFD_RELOC_SH_IMM_HI16,
2709   BFD_RELOC_SH_IMM_HI16_PCREL,
2710   BFD_RELOC_SH_PT_16,
2711   BFD_RELOC_SH_TLS_GD_32,
2712   BFD_RELOC_SH_TLS_LD_32,
2713   BFD_RELOC_SH_TLS_LDO_32,
2714   BFD_RELOC_SH_TLS_IE_32,
2715   BFD_RELOC_SH_TLS_LE_32,
2716   BFD_RELOC_SH_TLS_DTPMOD32,
2717   BFD_RELOC_SH_TLS_DTPOFF32,
2718   BFD_RELOC_SH_TLS_TPOFF32,
2719
2720 /* Thumb 23-, 12- and 9-bit pc-relative branches.  The lowest bit must
2721 be zero and is not stored in the instruction.  */
2722   BFD_RELOC_THUMB_PCREL_BRANCH9,
2723   BFD_RELOC_THUMB_PCREL_BRANCH12,
2724   BFD_RELOC_THUMB_PCREL_BRANCH23,
2725
2726 /* ARC Cores relocs.
2727 ARC 22 bit pc-relative branch.  The lowest two bits must be zero and are
2728 not stored in the instruction.  The high 20 bits are installed in bits 26
2729 through 7 of the instruction.  */
2730   BFD_RELOC_ARC_B22_PCREL,
2731
2732 /* ARC 26 bit absolute branch.  The lowest two bits must be zero and are not
2733 stored in the instruction.  The high 24 bits are installed in bits 23
2734 through 0.  */
2735   BFD_RELOC_ARC_B26,
2736
2737 /* Mitsubishi D10V relocs.
2738 This is a 10-bit reloc with the right 2 bits
2739 assumed to be 0.  */
2740   BFD_RELOC_D10V_10_PCREL_R,
2741
2742 /* Mitsubishi D10V relocs.
2743 This is a 10-bit reloc with the right 2 bits
2744 assumed to be 0.  This is the same as the previous reloc
2745 except it is in the left container, i.e.,
2746 shifted left 15 bits.  */
2747   BFD_RELOC_D10V_10_PCREL_L,
2748
2749 /* This is an 18-bit reloc with the right 2 bits
2750 assumed to be 0.  */
2751   BFD_RELOC_D10V_18,
2752
2753 /* This is an 18-bit reloc with the right 2 bits
2754 assumed to be 0.  */
2755   BFD_RELOC_D10V_18_PCREL,
2756
2757 /* Mitsubishi D30V relocs.
2758 This is a 6-bit absolute reloc.  */
2759   BFD_RELOC_D30V_6,
2760
2761 /* This is a 6-bit pc-relative reloc with
2762 the right 3 bits assumed to be 0.  */
2763   BFD_RELOC_D30V_9_PCREL,
2764
2765 /* This is a 6-bit pc-relative reloc with
2766 the right 3 bits assumed to be 0. Same
2767 as the previous reloc but on the right side
2768 of the container.  */
2769   BFD_RELOC_D30V_9_PCREL_R,
2770
2771 /* This is a 12-bit absolute reloc with the
2772 right 3 bitsassumed to be 0.  */
2773   BFD_RELOC_D30V_15,
2774
2775 /* This is a 12-bit pc-relative reloc with
2776 the right 3 bits assumed to be 0.  */
2777   BFD_RELOC_D30V_15_PCREL,
2778
2779 /* This is a 12-bit pc-relative reloc with
2780 the right 3 bits assumed to be 0. Same
2781 as the previous reloc but on the right side
2782 of the container.  */
2783   BFD_RELOC_D30V_15_PCREL_R,
2784
2785 /* This is an 18-bit absolute reloc with
2786 the right 3 bits assumed to be 0.  */
2787   BFD_RELOC_D30V_21,
2788
2789 /* This is an 18-bit pc-relative reloc with
2790 the right 3 bits assumed to be 0.  */
2791   BFD_RELOC_D30V_21_PCREL,
2792
2793 /* This is an 18-bit pc-relative reloc with
2794 the right 3 bits assumed to be 0. Same
2795 as the previous reloc but on the right side
2796 of the container.  */
2797   BFD_RELOC_D30V_21_PCREL_R,
2798
2799 /* This is a 32-bit absolute reloc.  */
2800   BFD_RELOC_D30V_32,
2801
2802 /* This is a 32-bit pc-relative reloc.  */
2803   BFD_RELOC_D30V_32_PCREL,
2804
2805 /* DLX relocs  */
2806   BFD_RELOC_DLX_HI16_S,
2807
2808 /* DLX relocs  */
2809   BFD_RELOC_DLX_LO16,
2810
2811 /* DLX relocs  */
2812   BFD_RELOC_DLX_JMP26,
2813
2814 /* Renesas M32R (formerly Mitsubishi M32R) relocs.
2815 This is a 24 bit absolute address.  */
2816   BFD_RELOC_M32R_24,
2817
2818 /* This is a 10-bit pc-relative reloc with the right 2 bits assumed to be 0.  */
2819   BFD_RELOC_M32R_10_PCREL,
2820
2821 /* This is an 18-bit reloc with the right 2 bits assumed to be 0.  */
2822   BFD_RELOC_M32R_18_PCREL,
2823
2824 /* This is a 26-bit reloc with the right 2 bits assumed to be 0.  */
2825   BFD_RELOC_M32R_26_PCREL,
2826
2827 /* This is a 16-bit reloc containing the high 16 bits of an address
2828 used when the lower 16 bits are treated as unsigned.  */
2829   BFD_RELOC_M32R_HI16_ULO,
2830
2831 /* This is a 16-bit reloc containing the high 16 bits of an address
2832 used when the lower 16 bits are treated as signed.  */
2833   BFD_RELOC_M32R_HI16_SLO,
2834
2835 /* This is a 16-bit reloc containing the lower 16 bits of an address.  */
2836   BFD_RELOC_M32R_LO16,
2837
2838 /* This is a 16-bit reloc containing the small data area offset for use in
2839 add3, load, and store instructions.  */
2840   BFD_RELOC_M32R_SDA16,
2841
2842 /* This is a 9-bit reloc  */
2843   BFD_RELOC_V850_9_PCREL,
2844
2845 /* This is a 22-bit reloc  */
2846   BFD_RELOC_V850_22_PCREL,
2847
2848 /* This is a 16 bit offset from the short data area pointer.  */
2849   BFD_RELOC_V850_SDA_16_16_OFFSET,
2850
2851 /* This is a 16 bit offset (of which only 15 bits are used) from the
2852 short data area pointer.  */
2853   BFD_RELOC_V850_SDA_15_16_OFFSET,
2854
2855 /* This is a 16 bit offset from the zero data area pointer.  */
2856   BFD_RELOC_V850_ZDA_16_16_OFFSET,
2857
2858 /* This is a 16 bit offset (of which only 15 bits are used) from the
2859 zero data area pointer.  */
2860   BFD_RELOC_V850_ZDA_15_16_OFFSET,
2861
2862 /* This is an 8 bit offset (of which only 6 bits are used) from the
2863 tiny data area pointer.  */
2864   BFD_RELOC_V850_TDA_6_8_OFFSET,
2865
2866 /* This is an 8bit offset (of which only 7 bits are used) from the tiny
2867 data area pointer.  */
2868   BFD_RELOC_V850_TDA_7_8_OFFSET,
2869
2870 /* This is a 7 bit offset from the tiny data area pointer.  */
2871   BFD_RELOC_V850_TDA_7_7_OFFSET,
2872
2873 /* This is a 16 bit offset from the tiny data area pointer.  */
2874   BFD_RELOC_V850_TDA_16_16_OFFSET,
2875
2876 /* This is a 5 bit offset (of which only 4 bits are used) from the tiny
2877 data area pointer.  */
2878   BFD_RELOC_V850_TDA_4_5_OFFSET,
2879
2880 /* This is a 4 bit offset from the tiny data area pointer.  */
2881   BFD_RELOC_V850_TDA_4_4_OFFSET,
2882
2883 /* This is a 16 bit offset from the short data area pointer, with the
2884 bits placed non-contigously in the instruction.  */
2885   BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET,
2886
2887 /* This is a 16 bit offset from the zero data area pointer, with the
2888 bits placed non-contigously in the instruction.  */
2889   BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET,
2890
2891 /* This is a 6 bit offset from the call table base pointer.  */
2892   BFD_RELOC_V850_CALLT_6_7_OFFSET,
2893
2894 /* This is a 16 bit offset from the call table base pointer.  */
2895   BFD_RELOC_V850_CALLT_16_16_OFFSET,
2896
2897 /* Used for relaxing indirect function calls.  */
2898   BFD_RELOC_V850_LONGCALL,
2899
2900 /* Used for relaxing indirect jumps.  */
2901   BFD_RELOC_V850_LONGJUMP,
2902
2903 /* Used to maintain alignment whilst relaxing.  */
2904   BFD_RELOC_V850_ALIGN,
2905
2906 /* This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the
2907 instruction.  */
2908   BFD_RELOC_MN10300_32_PCREL,
2909
2910 /* This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the
2911 instruction.  */
2912   BFD_RELOC_MN10300_16_PCREL,
2913
2914 /* This is a 8bit DP reloc for the tms320c30, where the most
2915 significant 8 bits of a 24 bit word are placed into the least
2916 significant 8 bits of the opcode.  */
2917   BFD_RELOC_TIC30_LDP,
2918
2919 /* This is a 7bit reloc for the tms320c54x, where the least
2920 significant 7 bits of a 16 bit word are placed into the least
2921 significant 7 bits of the opcode.  */
2922   BFD_RELOC_TIC54X_PARTLS7,
2923
2924 /* This is a 9bit DP reloc for the tms320c54x, where the most
2925 significant 9 bits of a 16 bit word are placed into the least
2926 significant 9 bits of the opcode.  */
2927   BFD_RELOC_TIC54X_PARTMS9,
2928
2929 /* This is an extended address 23-bit reloc for the tms320c54x.  */
2930   BFD_RELOC_TIC54X_23,
2931
2932 /* This is a 16-bit reloc for the tms320c54x, where the least
2933 significant 16 bits of a 23-bit extended address are placed into
2934 the opcode.  */
2935   BFD_RELOC_TIC54X_16_OF_23,
2936
2937 /* This is a reloc for the tms320c54x, where the most
2938 significant 7 bits of a 23-bit extended address are placed into
2939 the opcode.  */
2940   BFD_RELOC_TIC54X_MS7_OF_23,
2941
2942 /* This is a 48 bit reloc for the FR30 that stores 32 bits.  */
2943   BFD_RELOC_FR30_48,
2944
2945 /* This is a 32 bit reloc for the FR30 that stores 20 bits split up into
2946 two sections.  */
2947   BFD_RELOC_FR30_20,
2948
2949 /* This is a 16 bit reloc for the FR30 that stores a 6 bit word offset in
2950 4 bits.  */
2951   BFD_RELOC_FR30_6_IN_4,
2952
2953 /* This is a 16 bit reloc for the FR30 that stores an 8 bit byte offset
2954 into 8 bits.  */
2955   BFD_RELOC_FR30_8_IN_8,
2956
2957 /* This is a 16 bit reloc for the FR30 that stores a 9 bit short offset
2958 into 8 bits.  */
2959   BFD_RELOC_FR30_9_IN_8,
2960
2961 /* This is a 16 bit reloc for the FR30 that stores a 10 bit word offset
2962 into 8 bits.  */
2963   BFD_RELOC_FR30_10_IN_8,
2964
2965 /* This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
2966 short offset into 8 bits.  */
2967   BFD_RELOC_FR30_9_PCREL,
2968
2969 /* This is a 16 bit reloc for the FR30 that stores a 12 bit pc relative
2970 short offset into 11 bits.  */
2971   BFD_RELOC_FR30_12_PCREL,
2972
2973 /* Motorola Mcore relocations.  */
2974   BFD_RELOC_MCORE_PCREL_IMM8BY4,
2975   BFD_RELOC_MCORE_PCREL_IMM11BY2,
2976   BFD_RELOC_MCORE_PCREL_IMM4BY2,
2977   BFD_RELOC_MCORE_PCREL_32,
2978   BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2,
2979   BFD_RELOC_MCORE_RVA,
2980
2981 /* These are relocations for the GETA instruction.  */
2982   BFD_RELOC_MMIX_GETA,
2983   BFD_RELOC_MMIX_GETA_1,
2984   BFD_RELOC_MMIX_GETA_2,
2985   BFD_RELOC_MMIX_GETA_3,
2986
2987 /* These are relocations for a conditional branch instruction.  */
2988   BFD_RELOC_MMIX_CBRANCH,
2989   BFD_RELOC_MMIX_CBRANCH_J,
2990   BFD_RELOC_MMIX_CBRANCH_1,
2991   BFD_RELOC_MMIX_CBRANCH_2,
2992   BFD_RELOC_MMIX_CBRANCH_3,
2993
2994 /* These are relocations for the PUSHJ instruction.  */
2995   BFD_RELOC_MMIX_PUSHJ,
2996   BFD_RELOC_MMIX_PUSHJ_1,
2997   BFD_RELOC_MMIX_PUSHJ_2,
2998   BFD_RELOC_MMIX_PUSHJ_3,
2999
3000 /* These are relocations for the JMP instruction.  */
3001   BFD_RELOC_MMIX_JMP,
3002   BFD_RELOC_MMIX_JMP_1,
3003   BFD_RELOC_MMIX_JMP_2,
3004   BFD_RELOC_MMIX_JMP_3,
3005
3006 /* This is a relocation for a relative address as in a GETA instruction or
3007 a branch.  */
3008   BFD_RELOC_MMIX_ADDR19,
3009
3010 /* This is a relocation for a relative address as in a JMP instruction.  */
3011   BFD_RELOC_MMIX_ADDR27,
3012
3013 /* This is a relocation for an instruction field that may be a general
3014 register or a value 0..255.  */
3015   BFD_RELOC_MMIX_REG_OR_BYTE,
3016
3017 /* This is a relocation for an instruction field that may be a general
3018 register.  */
3019   BFD_RELOC_MMIX_REG,
3020
3021 /* This is a relocation for two instruction fields holding a register and
3022 an offset, the equivalent of the relocation.  */
3023   BFD_RELOC_MMIX_BASE_PLUS_OFFSET,
3024
3025 /* This relocation is an assertion that the expression is not allocated as
3026 a global register.  It does not modify contents.  */
3027   BFD_RELOC_MMIX_LOCAL,
3028
3029 /* This is a 16 bit reloc for the AVR that stores 8 bit pc relative
3030 short offset into 7 bits.  */
3031   BFD_RELOC_AVR_7_PCREL,
3032
3033 /* This is a 16 bit reloc for the AVR that stores 13 bit pc relative
3034 short offset into 12 bits.  */
3035   BFD_RELOC_AVR_13_PCREL,
3036
3037 /* This is a 16 bit reloc for the AVR that stores 17 bit value (usually
3038 program memory address) into 16 bits.  */
3039   BFD_RELOC_AVR_16_PM,
3040
3041 /* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
3042 data memory address) into 8 bit immediate value of LDI insn.  */
3043   BFD_RELOC_AVR_LO8_LDI,
3044
3045 /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3046 of data memory address) into 8 bit immediate value of LDI insn.  */
3047   BFD_RELOC_AVR_HI8_LDI,
3048
3049 /* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3050 of program memory address) into 8 bit immediate value of LDI insn.  */
3051   BFD_RELOC_AVR_HH8_LDI,
3052
3053 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3054 (usually data memory address) into 8 bit immediate value of SUBI insn.  */
3055   BFD_RELOC_AVR_LO8_LDI_NEG,
3056
3057 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3058 (high 8 bit of data memory address) into 8 bit immediate value of
3059 SUBI insn.  */
3060   BFD_RELOC_AVR_HI8_LDI_NEG,
3061
3062 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3063 (most high 8 bit of program memory address) into 8 bit immediate value
3064 of LDI or SUBI insn.  */
3065   BFD_RELOC_AVR_HH8_LDI_NEG,
3066
3067 /* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
3068 command address) into 8 bit immediate value of LDI insn.  */
3069   BFD_RELOC_AVR_LO8_LDI_PM,
3070
3071 /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3072 of command address) into 8 bit immediate value of LDI insn.  */
3073   BFD_RELOC_AVR_HI8_LDI_PM,
3074
3075 /* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3076 of command address) into 8 bit immediate value of LDI insn.  */
3077   BFD_RELOC_AVR_HH8_LDI_PM,
3078
3079 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3080 (usually command address) into 8 bit immediate value of SUBI insn.  */
3081   BFD_RELOC_AVR_LO8_LDI_PM_NEG,
3082
3083 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3084 (high 8 bit of 16 bit command address) into 8 bit immediate value
3085 of SUBI insn.  */
3086   BFD_RELOC_AVR_HI8_LDI_PM_NEG,
3087
3088 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3089 (high 6 bit of 22 bit command address) into 8 bit immediate
3090 value of SUBI insn.  */
3091   BFD_RELOC_AVR_HH8_LDI_PM_NEG,
3092
3093 /* This is a 32 bit reloc for the AVR that stores 23 bit value
3094 into 22 bits.  */
3095   BFD_RELOC_AVR_CALL,
3096
3097 /* Direct 12 bit.  */
3098   BFD_RELOC_390_12,
3099
3100 /* 12 bit GOT offset.  */
3101   BFD_RELOC_390_GOT12,
3102
3103 /* 32 bit PC relative PLT address.  */
3104   BFD_RELOC_390_PLT32,
3105
3106 /* Copy symbol at runtime.  */
3107   BFD_RELOC_390_COPY,
3108
3109 /* Create GOT entry.  */
3110   BFD_RELOC_390_GLOB_DAT,
3111
3112 /* Create PLT entry.  */
3113   BFD_RELOC_390_JMP_SLOT,
3114
3115 /* Adjust by program base.  */
3116   BFD_RELOC_390_RELATIVE,
3117
3118 /* 32 bit PC relative offset to GOT.  */
3119   BFD_RELOC_390_GOTPC,
3120
3121 /* 16 bit GOT offset.  */
3122   BFD_RELOC_390_GOT16,
3123
3124 /* PC relative 16 bit shifted by 1.  */
3125   BFD_RELOC_390_PC16DBL,
3126
3127 /* 16 bit PC rel. PLT shifted by 1.  */
3128   BFD_RELOC_390_PLT16DBL,
3129
3130 /* PC relative 32 bit shifted by 1.  */
3131   BFD_RELOC_390_PC32DBL,
3132
3133 /* 32 bit PC rel. PLT shifted by 1.  */
3134   BFD_RELOC_390_PLT32DBL,
3135
3136 /* 32 bit PC rel. GOT shifted by 1.  */
3137   BFD_RELOC_390_GOTPCDBL,
3138
3139 /* 64 bit GOT offset.  */
3140   BFD_RELOC_390_GOT64,
3141
3142 /* 64 bit PC relative PLT address.  */
3143   BFD_RELOC_390_PLT64,
3144
3145 /* 32 bit rel. offset to GOT entry.  */
3146   BFD_RELOC_390_GOTENT,
3147
3148 /* 64 bit offset to GOT.  */
3149   BFD_RELOC_390_GOTOFF64,
3150
3151 /* 12-bit offset to symbol-entry within GOT, with PLT handling.  */
3152   BFD_RELOC_390_GOTPLT12,
3153
3154 /* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
3155   BFD_RELOC_390_GOTPLT16,
3156
3157 /* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
3158   BFD_RELOC_390_GOTPLT32,
3159
3160 /* 64-bit offset to symbol-entry within GOT, with PLT handling.  */
3161   BFD_RELOC_390_GOTPLT64,
3162
3163 /* 32-bit rel. offset to symbol-entry within GOT, with PLT handling.  */
3164   BFD_RELOC_390_GOTPLTENT,
3165
3166 /* 16-bit rel. offset from the GOT to a PLT entry.  */
3167   BFD_RELOC_390_PLTOFF16,
3168
3169 /* 32-bit rel. offset from the GOT to a PLT entry.  */
3170   BFD_RELOC_390_PLTOFF32,
3171
3172 /* 64-bit rel. offset from the GOT to a PLT entry.  */
3173   BFD_RELOC_390_PLTOFF64,
3174
3175 /* s390 tls relocations.  */
3176   BFD_RELOC_390_TLS_LOAD,
3177   BFD_RELOC_390_TLS_GDCALL,
3178   BFD_RELOC_390_TLS_LDCALL,
3179   BFD_RELOC_390_TLS_GD32,
3180   BFD_RELOC_390_TLS_GD64,
3181   BFD_RELOC_390_TLS_GOTIE12,
3182   BFD_RELOC_390_TLS_GOTIE32,
3183   BFD_RELOC_390_TLS_GOTIE64,
3184   BFD_RELOC_390_TLS_LDM32,
3185   BFD_RELOC_390_TLS_LDM64,
3186   BFD_RELOC_390_TLS_IE32,
3187   BFD_RELOC_390_TLS_IE64,
3188   BFD_RELOC_390_TLS_IEENT,
3189   BFD_RELOC_390_TLS_LE32,
3190   BFD_RELOC_390_TLS_LE64,
3191   BFD_RELOC_390_TLS_LDO32,
3192   BFD_RELOC_390_TLS_LDO64,
3193   BFD_RELOC_390_TLS_DTPMOD,
3194   BFD_RELOC_390_TLS_DTPOFF,
3195   BFD_RELOC_390_TLS_TPOFF,
3196
3197 /* Scenix IP2K - 9-bit register number / data address  */
3198   BFD_RELOC_IP2K_FR9,
3199
3200 /* Scenix IP2K - 4-bit register/data bank number  */
3201   BFD_RELOC_IP2K_BANK,
3202
3203 /* Scenix IP2K - low 13 bits of instruction word address  */
3204   BFD_RELOC_IP2K_ADDR16CJP,
3205
3206 /* Scenix IP2K - high 3 bits of instruction word address  */
3207   BFD_RELOC_IP2K_PAGE3,
3208
3209 /* Scenix IP2K - ext/low/high 8 bits of data address  */
3210   BFD_RELOC_IP2K_LO8DATA,
3211   BFD_RELOC_IP2K_HI8DATA,
3212   BFD_RELOC_IP2K_EX8DATA,
3213
3214 /* Scenix IP2K - low/high 8 bits of instruction word address  */
3215   BFD_RELOC_IP2K_LO8INSN,
3216   BFD_RELOC_IP2K_HI8INSN,
3217
3218 /* Scenix IP2K - even/odd PC modifier to modify snb pcl.0  */
3219   BFD_RELOC_IP2K_PC_SKIP,
3220
3221 /* Scenix IP2K - 16 bit word address in text section.  */
3222   BFD_RELOC_IP2K_TEXT,
3223
3224 /* Scenix IP2K - 7-bit sp or dp offset  */
3225   BFD_RELOC_IP2K_FR_OFFSET,
3226
3227 /* Scenix VPE4K coprocessor - data/insn-space addressing  */
3228   BFD_RELOC_VPE4KMATH_DATA,
3229   BFD_RELOC_VPE4KMATH_INSN,
3230
3231 /* These two relocations are used by the linker to determine which of
3232 the entries in a C++ virtual function table are actually used.  When
3233 the --gc-sections option is given, the linker will zero out the entries
3234 that are not used, so that the code for those functions need not be
3235 included in the output.
3236
3237 VTABLE_INHERIT is a zero-space relocation used to describe to the
3238 linker the inheritence tree of a C++ virtual function table.  The
3239 relocation's symbol should be the parent class' vtable, and the
3240 relocation should be located at the child vtable.
3241
3242 VTABLE_ENTRY is a zero-space relocation that describes the use of a
3243 virtual function table entry.  The reloc's symbol should refer to the
3244 table of the class mentioned in the code.  Off of that base, an offset
3245 describes the entry that is being used.  For Rela hosts, this offset
3246 is stored in the reloc's addend.  For Rel hosts, we are forced to put
3247 this offset in the reloc's section offset.  */
3248   BFD_RELOC_VTABLE_INHERIT,
3249   BFD_RELOC_VTABLE_ENTRY,
3250
3251 /* Intel IA64 Relocations.  */
3252   BFD_RELOC_IA64_IMM14,
3253   BFD_RELOC_IA64_IMM22,
3254   BFD_RELOC_IA64_IMM64,
3255   BFD_RELOC_IA64_DIR32MSB,
3256   BFD_RELOC_IA64_DIR32LSB,
3257   BFD_RELOC_IA64_DIR64MSB,
3258   BFD_RELOC_IA64_DIR64LSB,
3259   BFD_RELOC_IA64_GPREL22,
3260   BFD_RELOC_IA64_GPREL64I,
3261   BFD_RELOC_IA64_GPREL32MSB,
3262   BFD_RELOC_IA64_GPREL32LSB,
3263   BFD_RELOC_IA64_GPREL64MSB,
3264   BFD_RELOC_IA64_GPREL64LSB,
3265   BFD_RELOC_IA64_LTOFF22,
3266   BFD_RELOC_IA64_LTOFF64I,
3267   BFD_RELOC_IA64_PLTOFF22,
3268   BFD_RELOC_IA64_PLTOFF64I,
3269   BFD_RELOC_IA64_PLTOFF64MSB,
3270   BFD_RELOC_IA64_PLTOFF64LSB,
3271   BFD_RELOC_IA64_FPTR64I,
3272   BFD_RELOC_IA64_FPTR32MSB,
3273   BFD_RELOC_IA64_FPTR32LSB,
3274   BFD_RELOC_IA64_FPTR64MSB,
3275   BFD_RELOC_IA64_FPTR64LSB,
3276   BFD_RELOC_IA64_PCREL21B,
3277   BFD_RELOC_IA64_PCREL21BI,
3278   BFD_RELOC_IA64_PCREL21M,
3279   BFD_RELOC_IA64_PCREL21F,
3280   BFD_RELOC_IA64_PCREL22,
3281   BFD_RELOC_IA64_PCREL60B,
3282   BFD_RELOC_IA64_PCREL64I,
3283   BFD_RELOC_IA64_PCREL32MSB,
3284   BFD_RELOC_IA64_PCREL32LSB,
3285   BFD_RELOC_IA64_PCREL64MSB,
3286   BFD_RELOC_IA64_PCREL64LSB,
3287   BFD_RELOC_IA64_LTOFF_FPTR22,
3288   BFD_RELOC_IA64_LTOFF_FPTR64I,
3289   BFD_RELOC_IA64_LTOFF_FPTR32MSB,
3290   BFD_RELOC_IA64_LTOFF_FPTR32LSB,
3291   BFD_RELOC_IA64_LTOFF_FPTR64MSB,
3292   BFD_RELOC_IA64_LTOFF_FPTR64LSB,
3293   BFD_RELOC_IA64_SEGREL32MSB,
3294   BFD_RELOC_IA64_SEGREL32LSB,
3295   BFD_RELOC_IA64_SEGREL64MSB,
3296   BFD_RELOC_IA64_SEGREL64LSB,
3297   BFD_RELOC_IA64_SECREL32MSB,
3298   BFD_RELOC_IA64_SECREL32LSB,
3299   BFD_RELOC_IA64_SECREL64MSB,
3300   BFD_RELOC_IA64_SECREL64LSB,
3301   BFD_RELOC_IA64_REL32MSB,
3302   BFD_RELOC_IA64_REL32LSB,
3303   BFD_RELOC_IA64_REL64MSB,
3304   BFD_RELOC_IA64_REL64LSB,
3305   BFD_RELOC_IA64_LTV32MSB,
3306   BFD_RELOC_IA64_LTV32LSB,
3307   BFD_RELOC_IA64_LTV64MSB,
3308   BFD_RELOC_IA64_LTV64LSB,
3309   BFD_RELOC_IA64_IPLTMSB,
3310   BFD_RELOC_IA64_IPLTLSB,
3311   BFD_RELOC_IA64_COPY,
3312   BFD_RELOC_IA64_LTOFF22X,
3313   BFD_RELOC_IA64_LDXMOV,
3314   BFD_RELOC_IA64_TPREL14,
3315   BFD_RELOC_IA64_TPREL22,
3316   BFD_RELOC_IA64_TPREL64I,
3317   BFD_RELOC_IA64_TPREL64MSB,
3318   BFD_RELOC_IA64_TPREL64LSB,
3319   BFD_RELOC_IA64_LTOFF_TPREL22,
3320   BFD_RELOC_IA64_DTPMOD64MSB,
3321   BFD_RELOC_IA64_DTPMOD64LSB,
3322   BFD_RELOC_IA64_LTOFF_DTPMOD22,
3323   BFD_RELOC_IA64_DTPREL14,
3324   BFD_RELOC_IA64_DTPREL22,
3325   BFD_RELOC_IA64_DTPREL64I,
3326   BFD_RELOC_IA64_DTPREL32MSB,
3327   BFD_RELOC_IA64_DTPREL32LSB,
3328   BFD_RELOC_IA64_DTPREL64MSB,
3329   BFD_RELOC_IA64_DTPREL64LSB,
3330   BFD_RELOC_IA64_LTOFF_DTPREL22,
3331
3332 /* Motorola 68HC11 reloc.
3333 This is the 8 bit high part of an absolute address.  */
3334   BFD_RELOC_M68HC11_HI8,
3335
3336 /* Motorola 68HC11 reloc.
3337 This is the 8 bit low part of an absolute address.  */
3338   BFD_RELOC_M68HC11_LO8,
3339
3340 /* Motorola 68HC11 reloc.
3341 This is the 3 bit of a value.  */
3342   BFD_RELOC_M68HC11_3B,
3343
3344 /* Motorola 68HC11 reloc.
3345 This reloc marks the beginning of a jump/call instruction.
3346 It is used for linker relaxation to correctly identify beginning
3347 of instruction and change some branchs to use PC-relative
3348 addressing mode.  */
3349   BFD_RELOC_M68HC11_RL_JUMP,
3350
3351 /* Motorola 68HC11 reloc.
3352 This reloc marks a group of several instructions that gcc generates
3353 and for which the linker relaxation pass can modify and/or remove
3354 some of them.  */
3355   BFD_RELOC_M68HC11_RL_GROUP,
3356
3357 /* Motorola 68HC11 reloc.
3358 This is the 16-bit lower part of an address.  It is used for 'call'
3359 instruction to specify the symbol address without any special
3360 transformation (due to memory bank window).  */
3361   BFD_RELOC_M68HC11_LO16,
3362
3363 /* Motorola 68HC11 reloc.
3364 This is a 8-bit reloc that specifies the page number of an address.
3365 It is used by 'call' instruction to specify the page number of
3366 the symbol.  */
3367   BFD_RELOC_M68HC11_PAGE,
3368
3369 /* Motorola 68HC11 reloc.
3370 This is a 24-bit reloc that represents the address with a 16-bit
3371 value and a 8-bit page number.  The symbol address is transformed
3372 to follow the 16K memory bank of 68HC12 (seen as mapped in the window).  */
3373   BFD_RELOC_M68HC11_24,
3374
3375 /* These relocs are only used within the CRIS assembler.  They are not
3376 (at present) written to any object files.  */
3377   BFD_RELOC_CRIS_BDISP8,
3378   BFD_RELOC_CRIS_UNSIGNED_5,
3379   BFD_RELOC_CRIS_SIGNED_6,
3380   BFD_RELOC_CRIS_UNSIGNED_6,
3381   BFD_RELOC_CRIS_UNSIGNED_4,
3382
3383 /* Relocs used in ELF shared libraries for CRIS.  */
3384   BFD_RELOC_CRIS_COPY,
3385   BFD_RELOC_CRIS_GLOB_DAT,
3386   BFD_RELOC_CRIS_JUMP_SLOT,
3387   BFD_RELOC_CRIS_RELATIVE,
3388
3389 /* 32-bit offset to symbol-entry within GOT.  */
3390   BFD_RELOC_CRIS_32_GOT,
3391
3392 /* 16-bit offset to symbol-entry within GOT.  */
3393   BFD_RELOC_CRIS_16_GOT,
3394
3395 /* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
3396   BFD_RELOC_CRIS_32_GOTPLT,
3397
3398 /* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
3399   BFD_RELOC_CRIS_16_GOTPLT,
3400
3401 /* 32-bit offset to symbol, relative to GOT.  */
3402   BFD_RELOC_CRIS_32_GOTREL,
3403
3404 /* 32-bit offset to symbol with PLT entry, relative to GOT.  */
3405   BFD_RELOC_CRIS_32_PLT_GOTREL,
3406
3407 /* 32-bit offset to symbol with PLT entry, relative to this relocation.  */
3408   BFD_RELOC_CRIS_32_PLT_PCREL,
3409
3410 /* Intel i860 Relocations.  */
3411   BFD_RELOC_860_COPY,
3412   BFD_RELOC_860_GLOB_DAT,
3413   BFD_RELOC_860_JUMP_SLOT,
3414   BFD_RELOC_860_RELATIVE,
3415   BFD_RELOC_860_PC26,
3416   BFD_RELOC_860_PLT26,
3417   BFD_RELOC_860_PC16,
3418   BFD_RELOC_860_LOW0,
3419   BFD_RELOC_860_SPLIT0,
3420   BFD_RELOC_860_LOW1,
3421   BFD_RELOC_860_SPLIT1,
3422   BFD_RELOC_860_LOW2,
3423   BFD_RELOC_860_SPLIT2,
3424   BFD_RELOC_860_LOW3,
3425   BFD_RELOC_860_LOGOT0,
3426   BFD_RELOC_860_SPGOT0,
3427   BFD_RELOC_860_LOGOT1,
3428   BFD_RELOC_860_SPGOT1,
3429   BFD_RELOC_860_LOGOTOFF0,
3430   BFD_RELOC_860_SPGOTOFF0,
3431   BFD_RELOC_860_LOGOTOFF1,
3432   BFD_RELOC_860_SPGOTOFF1,
3433   BFD_RELOC_860_LOGOTOFF2,
3434   BFD_RELOC_860_LOGOTOFF3,
3435   BFD_RELOC_860_LOPC,
3436   BFD_RELOC_860_HIGHADJ,
3437   BFD_RELOC_860_HAGOT,
3438   BFD_RELOC_860_HAGOTOFF,
3439   BFD_RELOC_860_HAPC,
3440   BFD_RELOC_860_HIGH,
3441   BFD_RELOC_860_HIGOT,
3442   BFD_RELOC_860_HIGOTOFF,
3443
3444 /* OpenRISC Relocations.  */
3445   BFD_RELOC_OPENRISC_ABS_26,
3446   BFD_RELOC_OPENRISC_REL_26,
3447
3448 /* H8 elf Relocations.  */
3449   BFD_RELOC_H8_DIR16A8,
3450   BFD_RELOC_H8_DIR16R8,
3451   BFD_RELOC_H8_DIR24A8,
3452   BFD_RELOC_H8_DIR24R8,
3453   BFD_RELOC_H8_DIR32A16,
3454
3455 /* Sony Xstormy16 Relocations.  */
3456   BFD_RELOC_XSTORMY16_REL_12,
3457   BFD_RELOC_XSTORMY16_12,
3458   BFD_RELOC_XSTORMY16_24,
3459   BFD_RELOC_XSTORMY16_FPTR16,
3460
3461 /* Relocations used by VAX ELF.  */
3462   BFD_RELOC_VAX_GLOB_DAT,
3463   BFD_RELOC_VAX_JMP_SLOT,
3464   BFD_RELOC_VAX_RELATIVE,
3465
3466 /* msp430 specific relocation codes  */
3467   BFD_RELOC_MSP430_10_PCREL,
3468   BFD_RELOC_MSP430_16_PCREL,
3469   BFD_RELOC_MSP430_16,
3470   BFD_RELOC_MSP430_16_PCREL_BYTE,
3471   BFD_RELOC_MSP430_16_BYTE,
3472
3473 /* IQ2000 Relocations.  */
3474   BFD_RELOC_IQ2000_OFFSET_16,
3475   BFD_RELOC_IQ2000_OFFSET_21,
3476   BFD_RELOC_IQ2000_UHI16,
3477
3478 /* Special Xtensa relocation used only by PLT entries in ELF shared
3479 objects to indicate that the runtime linker should set the value
3480 to one of its own internal functions or data structures.  */
3481   BFD_RELOC_XTENSA_RTLD,
3482
3483 /* Xtensa relocations for ELF shared objects.  */
3484   BFD_RELOC_XTENSA_GLOB_DAT,
3485   BFD_RELOC_XTENSA_JMP_SLOT,
3486   BFD_RELOC_XTENSA_RELATIVE,
3487
3488 /* Xtensa relocation used in ELF object files for symbols that may require
3489 PLT entries.  Otherwise, this is just a generic 32-bit relocation.  */
3490   BFD_RELOC_XTENSA_PLT,
3491
3492 /* Generic Xtensa relocations.  Only the operand number is encoded
3493 in the relocation.  The details are determined by extracting the
3494 instruction opcode.  */
3495   BFD_RELOC_XTENSA_OP0,
3496   BFD_RELOC_XTENSA_OP1,
3497   BFD_RELOC_XTENSA_OP2,
3498
3499 /* Xtensa relocation to mark that the assembler expanded the
3500 instructions from an original target.  The expansion size is
3501 encoded in the reloc size.  */
3502   BFD_RELOC_XTENSA_ASM_EXPAND,
3503
3504 /* Xtensa relocation to mark that the linker should simplify
3505 assembler-expanded instructions.  This is commonly used
3506 internally by the linker after analysis of a
3507 BFD_RELOC_XTENSA_ASM_EXPAND.  */
3508   BFD_RELOC_XTENSA_ASM_SIMPLIFY,
3509   BFD_RELOC_UNUSED };
3510 typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
3511 reloc_howto_type *
3512 bfd_reloc_type_lookup PARAMS ((bfd *abfd, bfd_reloc_code_real_type code));
3513
3514 const char *
3515 bfd_get_reloc_code_name PARAMS ((bfd_reloc_code_real_type code));
3516
3517 /* Extracted from syms.c.  */
3518
3519 typedef struct symbol_cache_entry
3520 {
3521   /* A pointer to the BFD which owns the symbol. This information
3522      is necessary so that a back end can work out what additional
3523      information (invisible to the application writer) is carried
3524      with the symbol.
3525
3526      This field is *almost* redundant, since you can use section->owner
3527      instead, except that some symbols point to the global sections
3528      bfd_{abs,com,und}_section.  This could be fixed by making
3529      these globals be per-bfd (or per-target-flavor).  FIXME.  */
3530   struct bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field.  */
3531
3532   /* The text of the symbol. The name is left alone, and not copied; the
3533      application may not alter it.  */
3534   const char *name;
3535
3536   /* The value of the symbol.  This really should be a union of a
3537      numeric value with a pointer, since some flags indicate that
3538      a pointer to another symbol is stored here.  */
3539   symvalue value;
3540
3541   /* Attributes of a symbol.  */
3542 #define BSF_NO_FLAGS    0x00
3543
3544   /* The symbol has local scope; <<static>> in <<C>>. The value
3545      is the offset into the section of the data.  */
3546 #define BSF_LOCAL      0x01
3547
3548   /* The symbol has global scope; initialized data in <<C>>. The
3549      value is the offset into the section of the data.  */
3550 #define BSF_GLOBAL     0x02
3551
3552   /* The symbol has global scope and is exported. The value is
3553      the offset into the section of the data.  */
3554 #define BSF_EXPORT     BSF_GLOBAL /* No real difference.  */
3555
3556   /* A normal C symbol would be one of:
3557      <<BSF_LOCAL>>, <<BSF_FORT_COMM>>,  <<BSF_UNDEFINED>> or
3558      <<BSF_GLOBAL>>.  */
3559
3560   /* The symbol is a debugging record. The value has an arbitary
3561      meaning, unless BSF_DEBUGGING_RELOC is also set.  */
3562 #define BSF_DEBUGGING  0x08
3563
3564   /* The symbol denotes a function entry point.  Used in ELF,
3565      perhaps others someday.  */
3566 #define BSF_FUNCTION    0x10
3567
3568   /* Used by the linker.  */
3569 #define BSF_KEEP        0x20
3570 #define BSF_KEEP_G      0x40
3571
3572   /* A weak global symbol, overridable without warnings by
3573      a regular global symbol of the same name.  */
3574 #define BSF_WEAK        0x80
3575
3576   /* This symbol was created to point to a section, e.g. ELF's
3577      STT_SECTION symbols.  */
3578 #define BSF_SECTION_SYM 0x100
3579
3580   /* The symbol used to be a common symbol, but now it is
3581      allocated.  */
3582 #define BSF_OLD_COMMON  0x200
3583
3584   /* The default value for common data.  */
3585 #define BFD_FORT_COMM_DEFAULT_VALUE 0
3586
3587   /* In some files the type of a symbol sometimes alters its
3588      location in an output file - ie in coff a <<ISFCN>> symbol
3589      which is also <<C_EXT>> symbol appears where it was
3590      declared and not at the end of a section.  This bit is set
3591      by the target BFD part to convey this information.  */
3592 #define BSF_NOT_AT_END    0x400
3593
3594   /* Signal that the symbol is the label of constructor section.  */
3595 #define BSF_CONSTRUCTOR   0x800
3596
3597   /* Signal that the symbol is a warning symbol.  The name is a
3598      warning.  The name of the next symbol is the one to warn about;
3599      if a reference is made to a symbol with the same name as the next
3600      symbol, a warning is issued by the linker.  */
3601 #define BSF_WARNING       0x1000
3602
3603   /* Signal that the symbol is indirect.  This symbol is an indirect
3604      pointer to the symbol with the same name as the next symbol.  */
3605 #define BSF_INDIRECT      0x2000
3606
3607   /* BSF_FILE marks symbols that contain a file name.  This is used
3608      for ELF STT_FILE symbols.  */
3609 #define BSF_FILE          0x4000
3610
3611   /* Symbol is from dynamic linking information.  */
3612 #define BSF_DYNAMIC       0x8000
3613
3614   /* The symbol denotes a data object.  Used in ELF, and perhaps
3615      others someday.  */
3616 #define BSF_OBJECT        0x10000
3617
3618   /* This symbol is a debugging symbol.  The value is the offset
3619      into the section of the data.  BSF_DEBUGGING should be set
3620      as well.  */
3621 #define BSF_DEBUGGING_RELOC 0x20000
3622
3623   /* This symbol is thread local.  Used in ELF.  */
3624 #define BSF_THREAD_LOCAL  0x40000
3625
3626   flagword flags;
3627
3628   /* A pointer to the section to which this symbol is
3629      relative.  This will always be non NULL, there are special
3630      sections for undefined and absolute symbols.  */
3631   struct sec *section;
3632
3633   /* Back end special data.  */
3634   union
3635     {
3636       PTR p;
3637       bfd_vma i;
3638     }
3639   udata;
3640 }
3641 asymbol;
3642
3643 #define bfd_get_symtab_upper_bound(abfd) \
3644      BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
3645
3646 bfd_boolean
3647 bfd_is_local_label PARAMS ((bfd *abfd, asymbol *sym));
3648
3649 bfd_boolean
3650 bfd_is_local_label_name PARAMS ((bfd *abfd, const char *name));
3651
3652 #define bfd_is_local_label_name(abfd, name) \
3653      BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
3654
3655 #define bfd_canonicalize_symtab(abfd, location) \
3656      BFD_SEND (abfd, _bfd_canonicalize_symtab,\
3657                   (abfd, location))
3658
3659 bfd_boolean
3660 bfd_set_symtab PARAMS ((bfd *abfd, asymbol **location, unsigned int count));
3661
3662 void
3663 bfd_print_symbol_vandf PARAMS ((bfd *abfd, PTR file, asymbol *symbol));
3664
3665 #define bfd_make_empty_symbol(abfd) \
3666      BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
3667
3668 asymbol *
3669 _bfd_generic_make_empty_symbol PARAMS ((bfd *));
3670
3671 #define bfd_make_debug_symbol(abfd,ptr,size) \
3672         BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
3673
3674 int
3675 bfd_decode_symclass PARAMS ((asymbol *symbol));
3676
3677 bfd_boolean
3678 bfd_is_undefined_symclass PARAMS ((int symclass));
3679
3680 void
3681 bfd_symbol_info PARAMS ((asymbol *symbol, symbol_info *ret));
3682
3683 bfd_boolean
3684 bfd_copy_private_symbol_data PARAMS ((bfd *ibfd, asymbol *isym, bfd *obfd, asymbol *osym));
3685
3686 #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
3687      BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
3688                (ibfd, isymbol, obfd, osymbol))
3689
3690 /* Extracted from bfd.c.  */
3691 struct bfd
3692 {
3693   /* A unique identifier of the BFD  */
3694   unsigned int id;
3695
3696   /* The filename the application opened the BFD with.  */
3697   const char *filename;
3698
3699   /* A pointer to the target jump table.  */
3700   const struct bfd_target *xvec;
3701
3702   /* To avoid dragging too many header files into every file that
3703      includes `<<bfd.h>>', IOSTREAM has been declared as a "char *",
3704      and MTIME as a "long".  Their correct types, to which they
3705      are cast when used, are "FILE *" and "time_t".    The iostream
3706      is the result of an fopen on the filename.  However, if the
3707      BFD_IN_MEMORY flag is set, then iostream is actually a pointer
3708      to a bfd_in_memory struct.  */
3709   PTR iostream;
3710
3711   /* Is the file descriptor being cached?  That is, can it be closed as
3712      needed, and re-opened when accessed later?  */
3713   bfd_boolean cacheable;
3714
3715   /* Marks whether there was a default target specified when the
3716      BFD was opened. This is used to select which matching algorithm
3717      to use to choose the back end.  */
3718   bfd_boolean target_defaulted;
3719
3720   /* The caching routines use these to maintain a
3721      least-recently-used list of BFDs.  */
3722   struct bfd *lru_prev, *lru_next;
3723
3724   /* When a file is closed by the caching routines, BFD retains
3725      state information on the file here...  */
3726   ufile_ptr where;
3727
3728   /* ... and here: (``once'' means at least once).  */
3729   bfd_boolean opened_once;
3730
3731   /* Set if we have a locally maintained mtime value, rather than
3732      getting it from the file each time.  */
3733   bfd_boolean mtime_set;
3734
3735   /* File modified time, if mtime_set is TRUE.  */
3736   long mtime;
3737
3738   /* Reserved for an unimplemented file locking extension.  */
3739   int ifd;
3740
3741   /* The format which belongs to the BFD. (object, core, etc.)  */
3742   bfd_format format;
3743
3744   /* The direction with which the BFD was opened.  */
3745   enum bfd_direction
3746     {
3747       no_direction = 0,
3748       read_direction = 1,
3749       write_direction = 2,
3750       both_direction = 3
3751     }
3752   direction;
3753
3754   /* Format_specific flags.  */
3755   flagword flags;
3756
3757   /* Currently my_archive is tested before adding origin to
3758      anything. I believe that this can become always an add of
3759      origin, with origin set to 0 for non archive files.  */
3760   ufile_ptr origin;
3761
3762   /* Remember when output has begun, to stop strange things
3763      from happening.  */
3764   bfd_boolean output_has_begun;
3765
3766   /* A hash table for section names.  */
3767   struct bfd_hash_table section_htab;
3768
3769   /* Pointer to linked list of sections.  */
3770   struct sec *sections;
3771
3772   /* The place where we add to the section list.  */
3773   struct sec **section_tail;
3774
3775   /* The number of sections.  */
3776   unsigned int section_count;
3777
3778   /* Stuff only useful for object files:
3779      The start address.  */
3780   bfd_vma start_address;
3781
3782   /* Used for input and output.  */
3783   unsigned int symcount;
3784
3785   /* Symbol table for output BFD (with symcount entries).  */
3786   struct symbol_cache_entry  **outsymbols;
3787
3788   /* Used for slurped dynamic symbol tables.  */
3789   unsigned int dynsymcount;
3790
3791   /* Pointer to structure which contains architecture information.  */
3792   const struct bfd_arch_info *arch_info;
3793
3794   /* Stuff only useful for archives.  */
3795   PTR arelt_data;
3796   struct bfd *my_archive;      /* The containing archive BFD.  */
3797   struct bfd *next;            /* The next BFD in the archive.  */
3798   struct bfd *archive_head;    /* The first BFD in the archive.  */
3799   bfd_boolean has_armap;
3800
3801   /* A chain of BFD structures involved in a link.  */
3802   struct bfd *link_next;
3803
3804   /* A field used by _bfd_generic_link_add_archive_symbols.  This will
3805      be used only for archive elements.  */
3806   int archive_pass;
3807
3808   /* Used by the back end to hold private data.  */
3809   union
3810     {
3811       struct aout_data_struct *aout_data;
3812       struct artdata *aout_ar_data;
3813       struct _oasys_data *oasys_obj_data;
3814       struct _oasys_ar_data *oasys_ar_data;
3815       struct coff_tdata *coff_obj_data;
3816       struct pe_tdata *pe_obj_data;
3817       struct xcoff_tdata *xcoff_obj_data;
3818       struct ecoff_tdata *ecoff_obj_data;
3819       struct ieee_data_struct *ieee_data;
3820       struct ieee_ar_data_struct *ieee_ar_data;
3821       struct srec_data_struct *srec_data;
3822       struct ihex_data_struct *ihex_data;
3823       struct tekhex_data_struct *tekhex_data;
3824       struct elf_obj_tdata *elf_obj_data;
3825       struct nlm_obj_tdata *nlm_obj_data;
3826       struct bout_data_struct *bout_data;
3827       struct mmo_data_struct *mmo_data;
3828       struct sun_core_struct *sun_core_data;
3829       struct sco5_core_struct *sco5_core_data;
3830       struct trad_core_struct *trad_core_data;
3831       struct som_data_struct *som_data;
3832       struct hpux_core_struct *hpux_core_data;
3833       struct hppabsd_core_struct *hppabsd_core_data;
3834       struct sgi_core_struct *sgi_core_data;
3835       struct lynx_core_struct *lynx_core_data;
3836       struct osf_core_struct *osf_core_data;
3837       struct cisco_core_struct *cisco_core_data;
3838       struct versados_data_struct *versados_data;
3839       struct netbsd_core_struct *netbsd_core_data;
3840       struct mach_o_data_struct *mach_o_data;
3841       struct mach_o_fat_data_struct *mach_o_fat_data;
3842       struct bfd_pef_data_struct *pef_data;
3843       struct bfd_pef_xlib_data_struct *pef_xlib_data;
3844       struct bfd_sym_data_struct *sym_data;
3845       PTR any;
3846     }
3847   tdata;
3848
3849   /* Used by the application to hold private data.  */
3850   PTR usrdata;
3851
3852   /* Where all the allocated stuff under this BFD goes.  This is a
3853      struct objalloc *, but we use PTR to avoid requiring the inclusion of
3854      objalloc.h.  */
3855   PTR memory;
3856 };
3857
3858 typedef enum bfd_error
3859 {
3860   bfd_error_no_error = 0,
3861   bfd_error_system_call,
3862   bfd_error_invalid_target,
3863   bfd_error_wrong_format,
3864   bfd_error_wrong_object_format,
3865   bfd_error_invalid_operation,
3866   bfd_error_no_memory,
3867   bfd_error_no_symbols,
3868   bfd_error_no_armap,
3869   bfd_error_no_more_archived_files,
3870   bfd_error_malformed_archive,
3871   bfd_error_file_not_recognized,
3872   bfd_error_file_ambiguously_recognized,
3873   bfd_error_no_contents,
3874   bfd_error_nonrepresentable_section,
3875   bfd_error_no_debug_section,
3876   bfd_error_bad_value,
3877   bfd_error_file_truncated,
3878   bfd_error_file_too_big,
3879   bfd_error_invalid_error_code
3880 }
3881 bfd_error_type;
3882
3883 bfd_error_type
3884 bfd_get_error PARAMS ((void));
3885
3886 void
3887 bfd_set_error PARAMS ((bfd_error_type error_tag));
3888
3889 const char *
3890 bfd_errmsg PARAMS ((bfd_error_type error_tag));
3891
3892 void
3893 bfd_perror PARAMS ((const char *message));
3894
3895 typedef void (*bfd_error_handler_type) PARAMS ((const char *, ...));
3896
3897 bfd_error_handler_type
3898 bfd_set_error_handler PARAMS ((bfd_error_handler_type));
3899
3900 void
3901 bfd_set_error_program_name PARAMS ((const char *));
3902
3903 bfd_error_handler_type
3904 bfd_get_error_handler PARAMS ((void));
3905
3906 const char *
3907 bfd_archive_filename PARAMS ((bfd *));
3908
3909 long
3910 bfd_get_reloc_upper_bound PARAMS ((bfd *abfd, asection *sect));
3911
3912 long
3913 bfd_canonicalize_reloc PARAMS ((bfd *abfd,
3914     asection *sec,
3915     arelent **loc,
3916     asymbol **syms));
3917
3918 void
3919 bfd_set_reloc PARAMS ((bfd *abfd, asection *sec, arelent **rel, unsigned int count));
3920
3921 bfd_boolean
3922 bfd_set_file_flags PARAMS ((bfd *abfd, flagword flags));
3923
3924 int
3925 bfd_get_arch_size PARAMS ((bfd *abfd));
3926
3927 int
3928 bfd_get_sign_extend_vma PARAMS ((bfd *abfd));
3929
3930 bfd_boolean
3931 bfd_set_start_address PARAMS ((bfd *abfd, bfd_vma vma));
3932
3933 unsigned int
3934 bfd_get_gp_size PARAMS ((bfd *abfd));
3935
3936 void
3937 bfd_set_gp_size PARAMS ((bfd *abfd, unsigned int i));
3938
3939 bfd_vma
3940 bfd_scan_vma PARAMS ((const char *string, const char **end, int base));
3941
3942 bfd_boolean
3943 bfd_copy_private_bfd_data PARAMS ((bfd *ibfd, bfd *obfd));
3944
3945 #define bfd_copy_private_bfd_data(ibfd, obfd) \
3946      BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
3947                (ibfd, obfd))
3948 bfd_boolean
3949 bfd_merge_private_bfd_data PARAMS ((bfd *ibfd, bfd *obfd));
3950
3951 #define bfd_merge_private_bfd_data(ibfd, obfd) \
3952      BFD_SEND (obfd, _bfd_merge_private_bfd_data, \
3953                (ibfd, obfd))
3954 bfd_boolean
3955 bfd_set_private_flags PARAMS ((bfd *abfd, flagword flags));
3956
3957 #define bfd_set_private_flags(abfd, flags) \
3958      BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags))
3959 #define bfd_sizeof_headers(abfd, reloc) \
3960        BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc))
3961
3962 #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
3963        BFD_SEND (abfd, _bfd_find_nearest_line, \
3964                  (abfd, sec, syms, off, file, func, line))
3965
3966 #define bfd_debug_info_start(abfd) \
3967        BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
3968
3969 #define bfd_debug_info_end(abfd) \
3970        BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
3971
3972 #define bfd_debug_info_accumulate(abfd, section) \
3973        BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
3974
3975 #define bfd_stat_arch_elt(abfd, stat) \
3976        BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
3977
3978 #define bfd_update_armap_timestamp(abfd) \
3979        BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
3980
3981 #define bfd_set_arch_mach(abfd, arch, mach)\
3982        BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
3983
3984 #define bfd_relax_section(abfd, section, link_info, again) \
3985        BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
3986
3987 #define bfd_gc_sections(abfd, link_info) \
3988        BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info))
3989
3990 #define bfd_merge_sections(abfd, link_info) \
3991        BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info))
3992
3993 #define bfd_discard_group(abfd, sec) \
3994        BFD_SEND (abfd, _bfd_discard_group, (abfd, sec))
3995
3996 #define bfd_link_hash_table_create(abfd) \
3997        BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
3998
3999 #define bfd_link_hash_table_free(abfd, hash) \
4000        BFD_SEND (abfd, _bfd_link_hash_table_free, (hash))
4001
4002 #define bfd_link_add_symbols(abfd, info) \
4003        BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
4004
4005 #define bfd_link_just_syms(sec, info) \
4006        BFD_SEND (abfd, _bfd_link_just_syms, (sec, info))
4007
4008 #define bfd_final_link(abfd, info) \
4009        BFD_SEND (abfd, _bfd_final_link, (abfd, info))
4010
4011 #define bfd_free_cached_info(abfd) \
4012        BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
4013
4014 #define bfd_get_dynamic_symtab_upper_bound(abfd) \
4015        BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
4016
4017 #define bfd_print_private_bfd_data(abfd, file)\
4018        BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
4019
4020 #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
4021        BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
4022
4023 #define bfd_get_dynamic_reloc_upper_bound(abfd) \
4024        BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
4025
4026 #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
4027        BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
4028
4029 extern bfd_byte *bfd_get_relocated_section_contents
4030        PARAMS ((bfd *, struct bfd_link_info *,
4031                  struct bfd_link_order *, bfd_byte *,
4032                  bfd_boolean, asymbol **));
4033
4034 bfd_boolean
4035 bfd_alt_mach_code PARAMS ((bfd *abfd, int alternative));
4036
4037 struct bfd_preserve
4038 {
4039   PTR marker;
4040   PTR tdata;
4041   flagword flags;
4042   const struct bfd_arch_info *arch_info;
4043   struct sec *sections;
4044   struct sec **section_tail;
4045   unsigned int section_count;
4046   struct bfd_hash_table section_htab;
4047 };
4048
4049 bfd_boolean
4050 bfd_preserve_save PARAMS ((bfd *, struct bfd_preserve *));
4051
4052 void
4053 bfd_preserve_restore PARAMS ((bfd *, struct bfd_preserve *));
4054
4055 void
4056 bfd_preserve_finish PARAMS ((bfd *, struct bfd_preserve *));
4057
4058 /* Extracted from archive.c.  */
4059 symindex
4060 bfd_get_next_mapent PARAMS ((bfd *abfd, symindex previous, carsym **sym));
4061
4062 bfd_boolean
4063 bfd_set_archive_head PARAMS ((bfd *output, bfd *new_head));
4064
4065 bfd *
4066 bfd_openr_next_archived_file PARAMS ((bfd *archive, bfd *previous));
4067
4068 /* Extracted from corefile.c.  */
4069 const char *
4070 bfd_core_file_failing_command PARAMS ((bfd *abfd));
4071
4072 int
4073 bfd_core_file_failing_signal PARAMS ((bfd *abfd));
4074
4075 bfd_boolean
4076 core_file_matches_executable_p PARAMS ((bfd *core_bfd, bfd *exec_bfd));
4077
4078 /* Extracted from targets.c.  */
4079 #define BFD_SEND(bfd, message, arglist) \
4080                ((*((bfd)->xvec->message)) arglist)
4081
4082 #ifdef DEBUG_BFD_SEND
4083 #undef BFD_SEND
4084 #define BFD_SEND(bfd, message, arglist) \
4085   (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
4086     ((*((bfd)->xvec->message)) arglist) : \
4087     (bfd_assert (__FILE__,__LINE__), NULL))
4088 #endif
4089 #define BFD_SEND_FMT(bfd, message, arglist) \
4090             (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
4091
4092 #ifdef DEBUG_BFD_SEND
4093 #undef BFD_SEND_FMT
4094 #define BFD_SEND_FMT(bfd, message, arglist) \
4095   (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
4096    (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
4097    (bfd_assert (__FILE__,__LINE__), NULL))
4098 #endif
4099
4100 enum bfd_flavour
4101 {
4102   bfd_target_unknown_flavour,
4103   bfd_target_aout_flavour,
4104   bfd_target_coff_flavour,
4105   bfd_target_ecoff_flavour,
4106   bfd_target_xcoff_flavour,
4107   bfd_target_elf_flavour,
4108   bfd_target_ieee_flavour,
4109   bfd_target_nlm_flavour,
4110   bfd_target_oasys_flavour,
4111   bfd_target_tekhex_flavour,
4112   bfd_target_srec_flavour,
4113   bfd_target_ihex_flavour,
4114   bfd_target_som_flavour,
4115   bfd_target_os9k_flavour,
4116   bfd_target_versados_flavour,
4117   bfd_target_msdos_flavour,
4118   bfd_target_ovax_flavour,
4119   bfd_target_evax_flavour,
4120   bfd_target_mmo_flavour,
4121   bfd_target_mach_o_flavour,
4122   bfd_target_pef_flavour,
4123   bfd_target_pef_xlib_flavour,
4124   bfd_target_sym_flavour
4125 };
4126
4127 enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
4128
4129 /* Forward declaration.  */
4130 typedef struct bfd_link_info _bfd_link_info;
4131
4132 typedef struct bfd_target
4133 {
4134   /* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  */
4135   char *name;
4136
4137  /* The "flavour" of a back end is a general indication about
4138     the contents of a file.  */
4139   enum bfd_flavour flavour;
4140
4141   /* The order of bytes within the data area of a file.  */
4142   enum bfd_endian byteorder;
4143
4144  /* The order of bytes within the header parts of a file.  */
4145   enum bfd_endian header_byteorder;
4146
4147   /* A mask of all the flags which an executable may have set -
4148      from the set <<BFD_NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>.  */
4149   flagword object_flags;
4150
4151  /* A mask of all the flags which a section may have set - from
4152     the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>.  */
4153   flagword section_flags;
4154
4155  /* The character normally found at the front of a symbol.
4156     (if any), perhaps `_'.  */
4157   char symbol_leading_char;
4158
4159  /* The pad character for file names within an archive header.  */
4160   char ar_pad_char;
4161
4162   /* The maximum number of characters in an archive header.  */
4163   unsigned short ar_max_namelen;
4164
4165   /* Entries for byte swapping for data. These are different from the
4166      other entry points, since they don't take a BFD asthe first argument.
4167      Certain other handlers could do the same.  */
4168   bfd_vma        (*bfd_getx64) PARAMS ((const bfd_byte *));
4169   bfd_signed_vma (*bfd_getx_signed_64) PARAMS ((const bfd_byte *));
4170   void           (*bfd_putx64) PARAMS ((bfd_vma, bfd_byte *));
4171   bfd_vma        (*bfd_getx32) PARAMS ((const bfd_byte *));
4172   bfd_signed_vma (*bfd_getx_signed_32) PARAMS ((const bfd_byte *));
4173   void           (*bfd_putx32) PARAMS ((bfd_vma, bfd_byte *));
4174   bfd_vma        (*bfd_getx16) PARAMS ((const bfd_byte *));
4175   bfd_signed_vma (*bfd_getx_signed_16) PARAMS ((const bfd_byte *));
4176   void           (*bfd_putx16) PARAMS ((bfd_vma, bfd_byte *));
4177
4178   /* Byte swapping for the headers.  */
4179   bfd_vma        (*bfd_h_getx64) PARAMS ((const bfd_byte *));
4180   bfd_signed_vma (*bfd_h_getx_signed_64) PARAMS ((const bfd_byte *));
4181   void           (*bfd_h_putx64) PARAMS ((bfd_vma, bfd_byte *));
4182   bfd_vma        (*bfd_h_getx32) PARAMS ((const bfd_byte *));
4183   bfd_signed_vma (*bfd_h_getx_signed_32) PARAMS ((const bfd_byte *));
4184   void           (*bfd_h_putx32) PARAMS ((bfd_vma, bfd_byte *));
4185   bfd_vma        (*bfd_h_getx16) PARAMS ((const bfd_byte *));
4186   bfd_signed_vma (*bfd_h_getx_signed_16) PARAMS ((const bfd_byte *));
4187   void           (*bfd_h_putx16) PARAMS ((bfd_vma, bfd_byte *));
4188
4189   /* Format dependent routines: these are vectors of entry points
4190      within the target vector structure, one for each format to check.  */
4191
4192   /* Check the format of a file being read.  Return a <<bfd_target *>> or zero.  */
4193   const struct bfd_target *(*_bfd_check_format[bfd_type_end]) PARAMS ((bfd *));
4194
4195   /* Set the format of a file being written.  */
4196   bfd_boolean (*_bfd_set_format[bfd_type_end]) PARAMS ((bfd *));
4197
4198   /* Write cached information into a file being written, at <<bfd_close>>.  */
4199   bfd_boolean (*_bfd_write_contents[bfd_type_end]) PARAMS ((bfd *));
4200
4201
4202   /* Generic entry points.  */
4203 #define BFD_JUMP_TABLE_GENERIC(NAME) \
4204 CONCAT2 (NAME,_close_and_cleanup), \
4205 CONCAT2 (NAME,_bfd_free_cached_info), \
4206 CONCAT2 (NAME,_new_section_hook), \
4207 CONCAT2 (NAME,_get_section_contents), \
4208 CONCAT2 (NAME,_get_section_contents_in_window)
4209
4210   /* Called when the BFD is being closed to do any necessary cleanup.  */
4211   bfd_boolean (*_close_and_cleanup) PARAMS ((bfd *));
4212   /* Ask the BFD to free all cached information.  */
4213   bfd_boolean (*_bfd_free_cached_info) PARAMS ((bfd *));
4214   /* Called when a new section is created.  */
4215   bfd_boolean (*_new_section_hook) PARAMS ((bfd *, sec_ptr));
4216   /* Read the contents of a section.  */
4217   bfd_boolean (*_bfd_get_section_contents)
4218     PARAMS ((bfd *, sec_ptr, PTR, file_ptr, bfd_size_type));
4219   bfd_boolean (*_bfd_get_section_contents_in_window)
4220     PARAMS ((bfd *, sec_ptr, bfd_window *, file_ptr, bfd_size_type));
4221
4222   /* Entry points to copy private data.  */
4223 #define BFD_JUMP_TABLE_COPY(NAME) \
4224 CONCAT2 (NAME,_bfd_copy_private_bfd_data), \
4225 CONCAT2 (NAME,_bfd_merge_private_bfd_data), \
4226 CONCAT2 (NAME,_bfd_copy_private_section_data), \
4227 CONCAT2 (NAME,_bfd_copy_private_symbol_data), \
4228 CONCAT2 (NAME,_bfd_set_private_flags), \
4229 CONCAT2 (NAME,_bfd_print_private_bfd_data) \
4230   /* Called to copy BFD general private data from one object file
4231      to another.  */
4232   bfd_boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *));
4233   /* Called to merge BFD general private data from one object file
4234      to a common output file when linking.  */
4235   bfd_boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *));
4236   /* Called to copy BFD private section data from one object file
4237      to another.  */
4238   bfd_boolean (*_bfd_copy_private_section_data)
4239     PARAMS ((bfd *, sec_ptr, bfd *, sec_ptr));
4240   /* Called to copy BFD private symbol data from one symbol
4241      to another.  */
4242   bfd_boolean (*_bfd_copy_private_symbol_data)
4243     PARAMS ((bfd *, asymbol *, bfd *, asymbol *));
4244   /* Called to set private backend flags.  */
4245   bfd_boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword));
4246
4247   /* Called to print private BFD data.  */
4248   bfd_boolean (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR));
4249
4250   /* Core file entry points.  */
4251 #define BFD_JUMP_TABLE_CORE(NAME) \
4252 CONCAT2 (NAME,_core_file_failing_command), \
4253 CONCAT2 (NAME,_core_file_failing_signal), \
4254 CONCAT2 (NAME,_core_file_matches_executable_p)
4255   char *      (*_core_file_failing_command) PARAMS ((bfd *));
4256   int         (*_core_file_failing_signal) PARAMS ((bfd *));
4257   bfd_boolean (*_core_file_matches_executable_p) PARAMS ((bfd *, bfd *));
4258
4259   /* Archive entry points.  */
4260 #define BFD_JUMP_TABLE_ARCHIVE(NAME) \
4261 CONCAT2 (NAME,_slurp_armap), \
4262 CONCAT2 (NAME,_slurp_extended_name_table), \
4263 CONCAT2 (NAME,_construct_extended_name_table), \
4264 CONCAT2 (NAME,_truncate_arname), \
4265 CONCAT2 (NAME,_write_armap), \
4266 CONCAT2 (NAME,_read_ar_hdr), \
4267 CONCAT2 (NAME,_openr_next_archived_file), \
4268 CONCAT2 (NAME,_get_elt_at_index), \
4269 CONCAT2 (NAME,_generic_stat_arch_elt), \
4270 CONCAT2 (NAME,_update_armap_timestamp)
4271   bfd_boolean (*_bfd_slurp_armap) PARAMS ((bfd *));
4272   bfd_boolean (*_bfd_slurp_extended_name_table) PARAMS ((bfd *));
4273   bfd_boolean (*_bfd_construct_extended_name_table)
4274     PARAMS ((bfd *, char **, bfd_size_type *, const char **));
4275   void        (*_bfd_truncate_arname) PARAMS ((bfd *, const char *, char *));
4276   bfd_boolean (*write_armap)
4277     PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int));
4278   PTR         (*_bfd_read_ar_hdr_fn) PARAMS ((bfd *));
4279   bfd *       (*openr_next_archived_file) PARAMS ((bfd *, bfd *));
4280 #define bfd_get_elt_at_index(b,i) BFD_SEND(b, _bfd_get_elt_at_index, (b,i))
4281   bfd *       (*_bfd_get_elt_at_index) PARAMS ((bfd *, symindex));
4282   int         (*_bfd_stat_arch_elt) PARAMS ((bfd *, struct stat *));
4283   bfd_boolean (*_bfd_update_armap_timestamp) PARAMS ((bfd *));
4284
4285   /* Entry points used for symbols.  */
4286 #define BFD_JUMP_TABLE_SYMBOLS(NAME) \
4287 CONCAT2 (NAME,_get_symtab_upper_bound), \
4288 CONCAT2 (NAME,_get_symtab), \
4289 CONCAT2 (NAME,_make_empty_symbol), \
4290 CONCAT2 (NAME,_print_symbol), \
4291 CONCAT2 (NAME,_get_symbol_info), \
4292 CONCAT2 (NAME,_bfd_is_local_label_name), \
4293 CONCAT2 (NAME,_get_lineno), \
4294 CONCAT2 (NAME,_find_nearest_line), \
4295 CONCAT2 (NAME,_bfd_make_debug_symbol), \
4296 CONCAT2 (NAME,_read_minisymbols), \
4297 CONCAT2 (NAME,_minisymbol_to_symbol)
4298   long        (*_bfd_get_symtab_upper_bound) PARAMS ((bfd *));
4299   long        (*_bfd_canonicalize_symtab) PARAMS ((bfd *,
4300                                                 struct symbol_cache_entry **));
4301   struct symbol_cache_entry *
4302               (*_bfd_make_empty_symbol) PARAMS ((bfd *));
4303   void        (*_bfd_print_symbol)
4304     PARAMS ((bfd *, PTR, struct symbol_cache_entry *, bfd_print_symbol_type));
4305 #define bfd_print_symbol(b,p,s,e) BFD_SEND(b, _bfd_print_symbol, (b,p,s,e))
4306   void        (*_bfd_get_symbol_info)
4307     PARAMS ((bfd *, struct symbol_cache_entry *, symbol_info *));
4308 #define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e))
4309   bfd_boolean (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *));
4310
4311   alent *     (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *));
4312   bfd_boolean (*_bfd_find_nearest_line)
4313     PARAMS ((bfd *, struct sec *, struct symbol_cache_entry **, bfd_vma,
4314              const char **, const char **, unsigned int *));
4315  /* Back-door to allow format-aware applications to create debug symbols
4316     while using BFD for everything else.  Currently used by the assembler
4317     when creating COFF files.  */
4318   asymbol *   (*_bfd_make_debug_symbol)
4319     PARAMS ((bfd *, void *, unsigned long size));
4320 #define bfd_read_minisymbols(b, d, m, s) \
4321   BFD_SEND (b, _read_minisymbols, (b, d, m, s))
4322   long        (*_read_minisymbols)
4323     PARAMS ((bfd *, bfd_boolean, PTR *, unsigned int *));
4324 #define bfd_minisymbol_to_symbol(b, d, m, f) \
4325   BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
4326   asymbol *   (*_minisymbol_to_symbol)
4327     PARAMS ((bfd *, bfd_boolean, const PTR, asymbol *));
4328
4329   /* Routines for relocs.  */
4330 #define BFD_JUMP_TABLE_RELOCS(NAME) \
4331 CONCAT2 (NAME,_get_reloc_upper_bound), \
4332 CONCAT2 (NAME,_canonicalize_reloc), \
4333 CONCAT2 (NAME,_bfd_reloc_type_lookup)
4334   long        (*_get_reloc_upper_bound) PARAMS ((bfd *, sec_ptr));
4335   long        (*_bfd_canonicalize_reloc)
4336     PARAMS ((bfd *, sec_ptr, arelent **, struct symbol_cache_entry **));
4337   /* See documentation on reloc types.  */
4338   reloc_howto_type *
4339               (*reloc_type_lookup) PARAMS ((bfd *, bfd_reloc_code_real_type));
4340
4341   /* Routines used when writing an object file.  */
4342 #define BFD_JUMP_TABLE_WRITE(NAME) \
4343 CONCAT2 (NAME,_set_arch_mach), \
4344 CONCAT2 (NAME,_set_section_contents)
4345   bfd_boolean (*_bfd_set_arch_mach)
4346     PARAMS ((bfd *, enum bfd_architecture, unsigned long));
4347   bfd_boolean (*_bfd_set_section_contents)
4348     PARAMS ((bfd *, sec_ptr, PTR, file_ptr, bfd_size_type));
4349
4350   /* Routines used by the linker.  */
4351 #define BFD_JUMP_TABLE_LINK(NAME) \
4352 CONCAT2 (NAME,_sizeof_headers), \
4353 CONCAT2 (NAME,_bfd_get_relocated_section_contents), \
4354 CONCAT2 (NAME,_bfd_relax_section), \
4355 CONCAT2 (NAME,_bfd_link_hash_table_create), \
4356 CONCAT2 (NAME,_bfd_link_hash_table_free), \
4357 CONCAT2 (NAME,_bfd_link_add_symbols), \
4358 CONCAT2 (NAME,_bfd_link_just_syms), \
4359 CONCAT2 (NAME,_bfd_final_link), \
4360 CONCAT2 (NAME,_bfd_link_split_section), \
4361 CONCAT2 (NAME,_bfd_gc_sections), \
4362 CONCAT2 (NAME,_bfd_merge_sections), \
4363 CONCAT2 (NAME,_bfd_discard_group)
4364   int         (*_bfd_sizeof_headers) PARAMS ((bfd *, bfd_boolean));
4365   bfd_byte *  (*_bfd_get_relocated_section_contents)
4366     PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *,
4367              bfd_byte *, bfd_boolean, struct symbol_cache_entry **));
4368
4369   bfd_boolean (*_bfd_relax_section)
4370     PARAMS ((bfd *, struct sec *, struct bfd_link_info *, bfd_boolean *));
4371
4372   /* Create a hash table for the linker.  Different backends store
4373      different information in this table.  */
4374   struct bfd_link_hash_table *
4375               (*_bfd_link_hash_table_create) PARAMS ((bfd *));
4376
4377   /* Release the memory associated with the linker hash table.  */
4378   void        (*_bfd_link_hash_table_free)
4379     PARAMS ((struct bfd_link_hash_table *));
4380
4381   /* Add symbols from this object file into the hash table.  */
4382   bfd_boolean (*_bfd_link_add_symbols)
4383     PARAMS ((bfd *, struct bfd_link_info *));
4384
4385   /* Indicate that we are only retrieving symbol values from this section.  */
4386   void        (*_bfd_link_just_syms)
4387     PARAMS ((asection *, struct bfd_link_info *));
4388
4389   /* Do a link based on the link_order structures attached to each
4390      section of the BFD.  */
4391   bfd_boolean (*_bfd_final_link) PARAMS ((bfd *, struct bfd_link_info *));
4392
4393   /* Should this section be split up into smaller pieces during linking.  */
4394   bfd_boolean (*_bfd_link_split_section) PARAMS ((bfd *, struct sec *));
4395
4396   /* Remove sections that are not referenced from the output.  */
4397   bfd_boolean (*_bfd_gc_sections) PARAMS ((bfd *, struct bfd_link_info *));
4398
4399   /* Attempt to merge SEC_MERGE sections.  */
4400   bfd_boolean (*_bfd_merge_sections) PARAMS ((bfd *, struct bfd_link_info *));
4401
4402   /* Discard members of a group.  */
4403   bfd_boolean (*_bfd_discard_group) PARAMS ((bfd *, struct sec *));
4404
4405   /* Routines to handle dynamic symbols and relocs.  */
4406 #define BFD_JUMP_TABLE_DYNAMIC(NAME) \
4407 CONCAT2 (NAME,_get_dynamic_symtab_upper_bound), \
4408 CONCAT2 (NAME,_canonicalize_dynamic_symtab), \
4409 CONCAT2 (NAME,_get_dynamic_reloc_upper_bound), \
4410 CONCAT2 (NAME,_canonicalize_dynamic_reloc)
4411   /* Get the amount of memory required to hold the dynamic symbols.  */
4412   long        (*_bfd_get_dynamic_symtab_upper_bound) PARAMS ((bfd *));
4413   /* Read in the dynamic symbols.  */
4414   long        (*_bfd_canonicalize_dynamic_symtab)
4415     PARAMS ((bfd *, struct symbol_cache_entry **));
4416   /* Get the amount of memory required to hold the dynamic relocs.  */
4417   long        (*_bfd_get_dynamic_reloc_upper_bound) PARAMS ((bfd *));
4418   /* Read in the dynamic relocs.  */
4419   long        (*_bfd_canonicalize_dynamic_reloc)
4420     PARAMS ((bfd *, arelent **, struct symbol_cache_entry **));
4421
4422   /* Opposite endian version of this target.  */
4423   const struct bfd_target * alternative_target;
4424
4425   /* Data for use by back-end routines, which isn't
4426      generic enough to belong in this structure.  */
4427   PTR backend_data;
4428
4429 } bfd_target;
4430
4431 bfd_boolean
4432 bfd_set_default_target PARAMS ((const char *name));
4433
4434 const bfd_target *
4435 bfd_find_target PARAMS ((const char *target_name, bfd *abfd));
4436
4437 const char **
4438 bfd_target_list PARAMS ((void));
4439
4440 const bfd_target *
4441 bfd_search_for_target PARAMS ((int (* search_func)
4442        (const bfd_target *, void *),
4443     void *));
4444
4445 /* Extracted from format.c.  */
4446 bfd_boolean
4447 bfd_check_format PARAMS ((bfd *abfd, bfd_format format));
4448
4449 bfd_boolean
4450 bfd_check_format_matches PARAMS ((bfd *abfd, bfd_format format,
4451     char ***matching));
4452
4453 bfd_boolean
4454 bfd_set_format PARAMS ((bfd *abfd, bfd_format format));
4455
4456 const char *
4457 bfd_format_string PARAMS ((bfd_format format));
4458
4459 /* Extracted from linker.c.  */
4460 bfd_boolean
4461 bfd_link_split_section PARAMS ((bfd *abfd, asection *sec));
4462
4463 #define bfd_link_split_section(abfd, sec) \
4464        BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
4465
4466 /* Extracted from simple.c.  */
4467 bfd_byte *
4468 bfd_simple_get_relocated_section_contents PARAMS ((bfd *abfd, asection *sec, bfd_byte *outbuf, asymbol **symbol_table));
4469
4470 #ifdef __cplusplus
4471 }
4472 #endif
4473 #endif