bfd/reloc.c

   1 /* BFD support for handling relocation entries.
   2    Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
   3    2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
   4    2012
   5    Free Software Foundation, Inc.
   6    Written by Cygnus Support.
   7
   8    This file is part of BFD, the Binary File Descriptor library.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program; if not, write to the Free Software
  22    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
  23    MA 02110-1301, USA.  */
  24
  25 /*
  26 SECTION
  27         Relocations
  28
  29         BFD maintains relocations in much the same way it maintains
  30         symbols: they are left alone until required, then read in
  31         en-masse and translated into an internal form.  A common
  32         routine <<bfd_perform_relocation>> acts upon the
  33         canonical form to do the fixup.
  34
  35         Relocations are maintained on a per section basis,
  36         while symbols are maintained on a per BFD basis.
  37
  38         All that a back end has to do to fit the BFD interface is to create
  39         a <<struct reloc_cache_entry>> for each relocation
  40         in a particular section, and fill in the right bits of the structures.
  41
  42 @menu
  43 @* typedef arelent::
  44 @* howto manager::
  45 @end menu
  46
  47 */
  48
  49 /* DO compile in the reloc_code name table from libbfd.h.  */
  50 #define _BFD_MAKE_TABLE_bfd_reloc_code_real
  51
  52 #include "sysdep.h"
  53 #include "bfd.h"
  54 #include "bfdlink.h"
  55 #include "libbfd.h"
  56 /*
  57 DOCDD
  58 INODE
  59         typedef arelent, howto manager, Relocations, Relocations
  60
  61 SUBSECTION
  62         typedef arelent
  63
  64         This is the structure of a relocation entry:
  65
  66 CODE_FRAGMENT
  67 .
  68 .typedef enum bfd_reloc_status
  69 .{
  70 .  {* No errors detected.  *}
  71 .  bfd_reloc_ok,
  72 .
  73 .  {* The relocation was performed, but there was an overflow.  *}
  74 .  bfd_reloc_overflow,
  75 .
  76 .  {* The address to relocate was not within the section supplied.  *}
  77 .  bfd_reloc_outofrange,
  78 .
  79 .  {* Used by special functions.  *}
  80 .  bfd_reloc_continue,
  81 .
  82 .  {* Unsupported relocation size requested.  *}
  83 .  bfd_reloc_notsupported,
  84 .
  85 .  {* Unused.  *}
  86 .  bfd_reloc_other,
  87 .
  88 .  {* The symbol to relocate against was undefined.  *}
  89 .  bfd_reloc_undefined,
  90 .
  91 .  {* The relocation was performed, but may not be ok - presently
  92 .     generated only when linking i960 coff files with i960 b.out
  93 .     symbols.  If this type is returned, the error_message argument
  94 .     to bfd_perform_relocation will be set.  *}
  95 .  bfd_reloc_dangerous
  96 . }
  97 . bfd_reloc_status_type;
  98 .
  99 .
 100 .typedef struct reloc_cache_entry
 101 .{
 102 .  {* A pointer into the canonical table of pointers.  *}
 103 .  struct bfd_symbol **sym_ptr_ptr;
 104 .
 105 .  {* offset in section.  *}
 106 .  bfd_size_type address;
 107 .
 108 .  {* addend for relocation value.  *}
 109 .  bfd_vma addend;
 110 .
 111 .  {* Pointer to how to perform the required relocation.  *}
 112 .  reloc_howto_type *howto;
 113 .
 114 .}
 115 .arelent;
 116 .
 117 */
 118
 119 /*
 120 DESCRIPTION
 121
 122         Here is a description of each of the fields within an <<arelent>>:
 123
 124         o <<sym_ptr_ptr>>
 125
 126         The symbol table pointer points to a pointer to the symbol
 127         associated with the relocation request.  It is the pointer
 128         into the table returned by the back end's
 129         <<canonicalize_symtab>> action. @xref{Symbols}. The symbol is
 130         referenced through a pointer to a pointer so that tools like
 131         the linker can fix up all the symbols of the same name by
 132         modifying only one pointer. The relocation routine looks in
 133         the symbol and uses the base of the section the symbol is
 134         attached to and the value of the symbol as the initial
 135         relocation offset. If the symbol pointer is zero, then the
 136         section provided is looked up.
 137
 138         o <<address>>
 139
 140         The <<address>> field gives the offset in bytes from the base of
 141         the section data which owns the relocation record to the first
 142         byte of relocatable information. The actual data relocated
 143         will be relative to this point; for example, a relocation
 144         type which modifies the bottom two bytes of a four byte word
 145         would not touch the first byte pointed to in a big endian
 146         world.
 147
 148         o <<addend>>
 149
 150         The <<addend>> is a value provided by the back end to be added (!)
 151         to the relocation offset. Its interpretation is dependent upon
 152         the howto. For example, on the 68k the code:
 153
 154 |        char foo[];
 155 |        main()
 156 |                {
 157 |                return foo[0x12345678];
 158 |                }
 159
 160         Could be compiled into:
 161
 162 |        linkw fp,#-4
 163 |        moveb @@#12345678,d0
 164 |        extbl d0
 165 |        unlk fp
 166 |        rts
 167
 168         This could create a reloc pointing to <<foo>>, but leave the
 169         offset in the data, something like:
 170
 171 |RELOCATION RECORDS FOR [.text]:
 172 |offset   type      value
 173 |00000006 32        _foo
 174 |
 175 |00000000 4e56 fffc          ; linkw fp,#-4
 176 |00000004 1039 1234 5678     ; moveb @@#12345678,d0
 177 |0000000a 49c0               ; extbl d0
 178 |0000000c 4e5e               ; unlk fp
 179 |0000000e 4e75               ; rts
 180
 181         Using coff and an 88k, some instructions don't have enough
 182         space in them to represent the full address range, and
 183         pointers have to be loaded in two parts. So you'd get something like:
 184
 185 |        or.u     r13,r0,hi16(_foo+0x12345678)
 186 |        ld.b     r2,r13,lo16(_foo+0x12345678)
 187 |        jmp      r1
 188
 189         This should create two relocs, both pointing to <<_foo>>, and with
 190         0x12340000 in their addend field. The data would consist of:
 191
 192 |RELOCATION RECORDS FOR [.text]:
 193 |offset   type      value
 194 |00000002 HVRT16    _foo+0x12340000
 195 |00000006 LVRT16    _foo+0x12340000
 196 |
 197 |00000000 5da05678           ; or.u r13,r0,0x5678
 198 |00000004 1c4d5678           ; ld.b r2,r13,0x5678
 199 |00000008 f400c001           ; jmp r1
 200
 201         The relocation routine digs out the value from the data, adds
 202         it to the addend to get the original offset, and then adds the
 203         value of <<_foo>>. Note that all 32 bits have to be kept around
 204         somewhere, to cope with carry from bit 15 to bit 16.
 205
 206         One further example is the sparc and the a.out format. The
 207         sparc has a similar problem to the 88k, in that some
 208         instructions don't have room for an entire offset, but on the
 209         sparc the parts are created in odd sized lumps. The designers of
 210         the a.out format chose to not use the data within the section
 211         for storing part of the offset; all the offset is kept within
 212         the reloc. Anything in the data should be ignored.
 213
 214 |        save %sp,-112,%sp
 215 |        sethi %hi(_foo+0x12345678),%g2
 216 |        ldsb [%g2+%lo(_foo+0x12345678)],%i0
 217 |        ret
 218 |        restore
 219
 220         Both relocs contain a pointer to <<foo>>, and the offsets
 221         contain junk.
 222
 223 |RELOCATION RECORDS FOR [.text]:
 224 |offset   type      value
 225 |00000004 HI22      _foo+0x12345678
 226 |00000008 LO10      _foo+0x12345678
 227 |
 228 |00000000 9de3bf90     ; save %sp,-112,%sp
 229 |00000004 05000000     ; sethi %hi(_foo+0),%g2
 230 |00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
 231 |0000000c 81c7e008     ; ret
 232 |00000010 81e80000     ; restore
 233
 234         o <<howto>>
 235
 236         The <<howto>> field can be imagined as a
 237         relocation instruction. It is a pointer to a structure which
 238         contains information on what to do with all of the other
 239         information in the reloc record and data section. A back end
 240         would normally have a relocation instruction set and turn
 241         relocations into pointers to the correct structure on input -
 242         but it would be possible to create each howto field on demand.
 243
 244 */
 245
 246 /*
 247 SUBSUBSECTION
 248         <<enum complain_overflow>>
 249
 250         Indicates what sort of overflow checking should be done when
 251         performing a relocation.
 252
 253 CODE_FRAGMENT
 254 .
 255 .enum complain_overflow
 256 .{
 257 .  {* Do not complain on overflow.  *}
 258 .  complain_overflow_dont,
 259 .
 260 .  {* Complain if the value overflows when considered as a signed
 261 .     number one bit larger than the field.  ie. A bitfield of N bits
 262 .     is allowed to represent -2**n to 2**n-1.  *}
 263 .  complain_overflow_bitfield,
 264 .
 265 .  {* Complain if the value overflows when considered as a signed
 266 .     number.  *}
 267 .  complain_overflow_signed,
 268 .
 269 .  {* Complain if the value overflows when considered as an
 270 .     unsigned number.  *}
 271 .  complain_overflow_unsigned
 272 .};
 273
 274 */
 275
 276 /*
 277 SUBSUBSECTION
 278         <<reloc_howto_type>>
 279
 280         The <<reloc_howto_type>> is a structure which contains all the
 281         information that libbfd needs to know to tie up a back end's data.
 282
 283 CODE_FRAGMENT
 284 .struct bfd_symbol;             {* Forward declaration.  *}
 285 .
 286 .struct reloc_howto_struct
 287 .{
 288 .  {*  The type field has mainly a documentary use - the back end can
 289 .      do what it wants with it, though normally the back end's
 290 .      external idea of what a reloc number is stored
 291 .      in this field.  For example, a PC relative word relocation
 292 .      in a coff environment has the type 023 - because that's
 293 .      what the outside world calls a R_PCRWORD reloc.  *}
 294 .  unsigned int type;
 295 .
 296 .  {*  The value the final relocation is shifted right by.  This drops
 297 .      unwanted data from the relocation.  *}
 298 .  unsigned int rightshift;
 299 .
 300 .  {*  The size of the item to be relocated.  This is *not* a
 301 .      power-of-two measure.  To get the number of bytes operated
 302 .      on by a type of relocation, use bfd_get_reloc_size.  *}
 303 .  int size;
 304 .
 305 .  {*  The number of bits in the item to be relocated.  This is used
 306 .      when doing overflow checking.  *}
 307 .  unsigned int bitsize;
 308 .
 309 .  {*  The relocation is relative to the field being relocated.  *}
 310 .  bfd_boolean pc_relative;
 311 .
 312 .  {*  The bit position of the reloc value in the destination.
 313 .      The relocated value is left shifted by this amount.  *}
 314 .  unsigned int bitpos;
 315 .
 316 .  {* What type of overflow error should be checked for when
 317 .     relocating.  *}
 318 .  enum complain_overflow complain_on_overflow;
 319 .
 320 .  {* If this field is non null, then the supplied function is
 321 .     called rather than the normal function.  This allows really
 322 .     strange relocation methods to be accommodated (e.g., i960 callj
 323 .     instructions).  *}
 324 .  bfd_reloc_status_type (*special_function)
 325 .    (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
 326 .     bfd *, char **);
 327 .
 328 .  {* The textual name of the relocation type.  *}
 329 .  char *name;
 330 .
 331 .  {* Some formats record a relocation addend in the section contents
 332 .     rather than with the relocation.  For ELF formats this is the
 333 .     distinction between USE_REL and USE_RELA (though the code checks
 334 .     for USE_REL == 1/0).  The value of this field is TRUE if the
 335 .     addend is recorded with the section contents; when performing a
 336 .     partial link (ld -r) the section contents (the data) will be
 337 .     modified.  The value of this field is FALSE if addends are
 338 .     recorded with the relocation (in arelent.addend); when performing
 339 .     a partial link the relocation will be modified.
 340 .     All relocations for all ELF USE_RELA targets should set this field
 341 .     to FALSE (values of TRUE should be looked on with suspicion).
 342 .     However, the converse is not true: not all relocations of all ELF
 343 .     USE_REL targets set this field to TRUE.  Why this is so is peculiar
 344 .     to each particular target.  For relocs that aren't used in partial
 345 .     links (e.g. GOT stuff) it doesn't matter what this is set to.  *}
 346 .  bfd_boolean partial_inplace;
 347 .
 348 .  {* src_mask selects the part of the instruction (or data) to be used
 349 .     in the relocation sum.  If the target relocations don't have an
 350 .     addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
 351 .     dst_mask to extract the addend from the section contents.  If
 352 .     relocations do have an addend in the reloc, eg. ELF USE_RELA, this
 353 .     field should be zero.  Non-zero values for ELF USE_RELA targets are
 354 .     bogus as in those cases the value in the dst_mask part of the
 355 .     section contents should be treated as garbage.  *}
 356 .  bfd_vma src_mask;
 357 .
 358 .  {* dst_mask selects which parts of the instruction (or data) are
 359 .     replaced with a relocated value.  *}
 360 .  bfd_vma dst_mask;
 361 .
 362 .  {* When some formats create PC relative instructions, they leave
 363 .     the value of the pc of the place being relocated in the offset
 364 .     slot of the instruction, so that a PC relative relocation can
 365 .     be made just by adding in an ordinary offset (e.g., sun3 a.out).
 366 .     Some formats leave the displacement part of an instruction
 367 .     empty (e.g., m88k bcs); this flag signals the fact.  *}
 368 .  bfd_boolean pcrel_offset;
 369 .};
 370 .
 371 */
 372
 373 /*
 374 FUNCTION
 375         The HOWTO Macro
 376
 377 DESCRIPTION
 378         The HOWTO define is horrible and will go away.
 379
 380 .#define HOWTO(C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
 381 .  { (unsigned) C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC }
 382
 383 DESCRIPTION
 384         And will be replaced with the totally magic way. But for the
 385         moment, we are compatible, so do it this way.
 386
 387 .#define NEWHOWTO(FUNCTION, NAME, SIZE, REL, IN) \
 388 .  HOWTO (0, 0, SIZE, 0, REL, 0, complain_overflow_dont, FUNCTION, \
 389 .         NAME, FALSE, 0, 0, IN)
 390 .
 391
 392 DESCRIPTION
 393         This is used to fill in an empty howto entry in an array.
 394
 395 .#define EMPTY_HOWTO(C) \
 396 .  HOWTO ((C), 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL, \
 397 .         NULL, FALSE, 0, 0, FALSE)
 398 .
 399
 400 DESCRIPTION
 401         Helper routine to turn a symbol into a relocation value.
 402
 403 .#define HOWTO_PREPARE(relocation, symbol)               \
 404 .  {                                                     \
 405 .    if (symbol != NULL)                                 \
 406 .      {                                                 \
 407 .        if (bfd_is_com_section (symbol->section))       \
 408 .          {                                             \
 409 .            relocation = 0;                             \
 410 .          }                                             \
 411 .        else                                            \
 412 .          {                                             \
 413 .            relocation = symbol->value;                 \
 414 .          }                                             \
 415 .      }                                                 \
 416 .  }
 417 .
 418 */
 419
 420 /*
 421 FUNCTION
 422         bfd_get_reloc_size
 423
 424 SYNOPSIS
 425         unsigned int bfd_get_reloc_size (reloc_howto_type *);
 426
 427 DESCRIPTION
 428         For a reloc_howto_type that operates on a fixed number of bytes,
 429         this returns the number of bytes operated on.
 430  */
 431
 432 unsigned int
 433 bfd_get_reloc_size (reloc_howto_type *howto)
 434 {
 435   switch (howto->size)
 436     {
 437     case 0: return 1;
 438     case 1: return 2;
 439     case 2: return 4;
 440     case 3: return 0;
 441     case 4: return 8;
 442     case 8: return 16;
 443     case -2: return 4;
 444     default: abort ();
 445     }
 446 }
 447
 448 /*
 449 TYPEDEF
 450         arelent_chain
 451
 452 DESCRIPTION
 453
 454         How relocs are tied together in an <<asection>>:
 455
 456 .typedef struct relent_chain
 457 .{
 458 .  arelent relent;
 459 .  struct relent_chain *next;
 460 .}
 461 .arelent_chain;
 462 .
 463 */
 464
 465 /* N_ONES produces N one bits, without overflowing machine arithmetic.  */
 466 #define N_ONES(n) (((((bfd_vma) 1 << ((n) - 1)) - 1) << 1) | 1)
 467
 468 /*
 469 FUNCTION
 470         bfd_check_overflow
 471
 472 SYNOPSIS
 473         bfd_reloc_status_type bfd_check_overflow
 474           (enum complain_overflow how,
 475            unsigned int bitsize,
 476            unsigned int rightshift,
 477            unsigned int addrsize,
 478            bfd_vma relocation);
 479
 480 DESCRIPTION
 481         Perform overflow checking on @var{relocation} which has
 482         @var{bitsize} significant bits and will be shifted right by
 483         @var{rightshift} bits, on a machine with addresses containing
 484         @var{addrsize} significant bits.  The result is either of
 485         @code{bfd_reloc_ok} or @code{bfd_reloc_overflow}.
 486
 487 */
 488
 489 bfd_reloc_status_type
 490 bfd_check_overflow (enum complain_overflow how,
 491                     unsigned int bitsize,
 492                     unsigned int rightshift,
 493                     unsigned int addrsize,
 494                     bfd_vma relocation)
 495 {
 496   bfd_vma fieldmask, addrmask, signmask, ss, a;
 497   bfd_reloc_status_type flag = bfd_reloc_ok;
 498
 499   /* Note: BITSIZE should always be <= ADDRSIZE, but in case it's not,
 500      we'll be permissive: extra bits in the field mask will
 501      automatically extend the address mask for purposes of the
 502      overflow check.  */
 503   fieldmask = N_ONES (bitsize);
 504   signmask = ~fieldmask;
 505   addrmask = N_ONES (addrsize) | (fieldmask << rightshift);
 506   a = (relocation & addrmask) >> rightshift;;
 507
 508   switch (how)
 509     {
 510     case complain_overflow_dont:
 511       break;
 512
 513     case complain_overflow_signed:
 514       /* If any sign bits are set, all sign bits must be set.  That
 515          is, A must be a valid negative address after shifting.  */
 516       signmask = ~ (fieldmask >> 1);
 517       /* Fall thru */
 518
 519     case complain_overflow_bitfield:
 520       /* Bitfields are sometimes signed, sometimes unsigned.  We
 521          explicitly allow an address wrap too, which means a bitfield
 522          of n bits is allowed to store -2**n to 2**n-1.  Thus overflow
 523          if the value has some, but not all, bits set outside the
 524          field.  */
 525       ss = a & signmask;
 526       if (ss != 0 && ss != ((addrmask >> rightshift) & signmask))
 527         flag = bfd_reloc_overflow;
 528       break;
 529
 530     case complain_overflow_unsigned:
 531       /* We have an overflow if the address does not fit in the field.  */
 532       if ((a & signmask) != 0)
 533         flag = bfd_reloc_overflow;
 534       break;
 535
 536     default:
 537       abort ();
 538     }
 539
 540   return flag;
 541 }
 542
 543 /*
 544 FUNCTION
 545         bfd_perform_relocation
 546
 547 SYNOPSIS
 548         bfd_reloc_status_type bfd_perform_relocation
 549           (bfd *abfd,
 550            arelent *reloc_entry,
 551            void *data,
 552            asection *input_section,
 553            bfd *output_bfd,
 554            char **error_message);
 555
 556 DESCRIPTION
 557         If @var{output_bfd} is supplied to this function, the
 558         generated image will be relocatable; the relocations are
 559         copied to the output file after they have been changed to
 560         reflect the new state of the world. There are two ways of
 561         reflecting the results of partial linkage in an output file:
 562         by modifying the output data in place, and by modifying the
 563         relocation record.  Some native formats (e.g., basic a.out and
 564         basic coff) have no way of specifying an addend in the
 565         relocation type, so the addend has to go in the output data.
 566         This is no big deal since in these formats the output data
 567         slot will always be big enough for the addend. Complex reloc
 568         types with addends were invented to solve just this problem.
 569         The @var{error_message} argument is set to an error message if
 570         this return @code{bfd_reloc_dangerous}.
 571
 572 */
 573
 574 bfd_reloc_status_type
 575 bfd_perform_relocation (bfd *abfd,
 576                         arelent *reloc_entry,
 577                         void *data,
 578                         asection *input_section,
 579                         bfd *output_bfd,
 580                         char **error_message)
 581 {
 582   bfd_vma relocation;
 583   bfd_reloc_status_type flag = bfd_reloc_ok;
 584   bfd_size_type octets = reloc_entry->address * bfd_octets_per_byte (abfd);
 585   bfd_vma output_base = 0;
 586   reloc_howto_type *howto = reloc_entry->howto;
 587   asection *reloc_target_output_section;
 588   asymbol *symbol;
 589
 590   symbol = *(reloc_entry->sym_ptr_ptr);
 591   if (bfd_is_abs_section (symbol->section)
 592       && output_bfd != NULL)
 593     {
 594       reloc_entry->address += input_section->output_offset;
 595       return bfd_reloc_ok;
 596     }
 597
 598   /* If we are not producing relocatable output, return an error if
 599      the symbol is not defined.  An undefined weak symbol is
 600      considered to have a value of zero (SVR4 ABI, p. 4-27).  */
 601   if (bfd_is_und_section (symbol->section)
 602       && (symbol->flags & BSF_WEAK) == 0
 603       && output_bfd == NULL)
 604     flag = bfd_reloc_undefined;
 605
 606   /* If there is a function supplied to handle this relocation type,
 607      call it.  It'll return `bfd_reloc_continue' if further processing
 608      can be done.  */
 609   if (howto->special_function)
 610     {
 611       bfd_reloc_status_type cont;
 612       cont = howto->special_function (abfd, reloc_entry, symbol, data,
 613                                       input_section, output_bfd,
 614                                       error_message);
 615       if (cont != bfd_reloc_continue)
 616         return cont;
 617     }
 618
 619   /* Is the address of the relocation really within the section?  */
 620   if (reloc_entry->address > bfd_get_section_limit (abfd, input_section))
 621     return bfd_reloc_outofrange;
 622
 623   /* Work out which section the relocation is targeted at and the
 624      initial relocation command value.  */
 625
 626   /* Get symbol value.  (Common symbols are special.)  */
 627   if (bfd_is_com_section (symbol->section))
 628     relocation = 0;
 629   else
 630     relocation = symbol->value;
 631
 632   reloc_target_output_section = symbol->section->output_section;
 633
 634   /* Convert input-section-relative symbol value to absolute.  */
 635   if ((output_bfd && ! howto->partial_inplace)
 636       || reloc_target_output_section == NULL)
 637     output_base = 0;
 638   else
 639     output_base = reloc_target_output_section->vma;
 640
 641   relocation += output_base + symbol->section->output_offset;
 642
 643   /* Add in supplied addend.  */
 644   relocation += reloc_entry->addend;
 645
 646   /* Here the variable relocation holds the final address of the
 647      symbol we are relocating against, plus any addend.  */
 648
 649   if (howto->pc_relative)
 650     {
 651       /* This is a PC relative relocation.  We want to set RELOCATION
 652          to the distance between the address of the symbol and the
 653          location.  RELOCATION is already the address of the symbol.
 654
 655          We start by subtracting the address of the section containing
 656          the location.
 657
 658          If pcrel_offset is set, we must further subtract the position
 659          of the location within the section.  Some targets arrange for
 660          the addend to be the negative of the position of the location
 661          within the section; for example, i386-aout does this.  For
 662          i386-aout, pcrel_offset is FALSE.  Some other targets do not
 663          include the position of the location; for example, m88kbcs,
 664          or ELF.  For those targets, pcrel_offset is TRUE.
 665
 666          If we are producing relocatable output, then we must ensure
 667          that this reloc will be correctly computed when the final
 668          relocation is done.  If pcrel_offset is FALSE we want to wind
 669          up with the negative of the location within the section,
 670          which means we must adjust the existing addend by the change
 671          in the location within the section.  If pcrel_offset is TRUE
 672          we do not want to adjust the existing addend at all.
 673
 674          FIXME: This seems logical to me, but for the case of
 675          producing relocatable output it is not what the code
 676          actually does.  I don't want to change it, because it seems
 677          far too likely that something will break.  */
 678
 679       relocation -=
 680         input_section->output_section->vma + input_section->output_offset;
 681
 682       if (howto->pcrel_offset)
 683         relocation -= reloc_entry->address;
 684     }
 685
 686   if (output_bfd != NULL)
 687     {
 688       if (! howto->partial_inplace)
 689         {
 690           /* This is a partial relocation, and we want to apply the relocation
 691              to the reloc entry rather than the raw data. Modify the reloc
 692              inplace to reflect what we now know.  */
 693           reloc_entry->addend = relocation;
 694           reloc_entry->address += input_section->output_offset;
 695           return flag;
 696         }
 697       else
 698         {
 699           /* This is a partial relocation, but inplace, so modify the
 700              reloc record a bit.
 701
 702              If we've relocated with a symbol with a section, change
 703              into a ref to the section belonging to the symbol.  */
 704
 705           reloc_entry->address += input_section->output_offset;
 706
 707           /* WTF?? */
 708           if (abfd->xvec->flavour == bfd_target_coff_flavour
 709               && strcmp (abfd->xvec->name, "coff-Intel-little") != 0
 710               && strcmp (abfd->xvec->name, "coff-Intel-big") != 0)
 711             {
 712               /* For m68k-coff, the addend was being subtracted twice during
 713                  relocation with -r.  Removing the line below this comment
 714                  fixes that problem; see PR 2953.
 715
 716 However, Ian wrote the following, regarding removing the line below,
 717 which explains why it is still enabled:  --djm
 718
 719 If you put a patch like that into BFD you need to check all the COFF
 720 linkers.  I am fairly certain that patch will break coff-i386 (e.g.,
 721 SCO); see coff_i386_reloc in coff-i386.c where I worked around the
 722 problem in a different way.  There may very well be a reason that the
 723 code works as it does.
 724
 725 Hmmm.  The first obvious point is that bfd_perform_relocation should
 726 not have any tests that depend upon the flavour.  It's seem like
 727 entirely the wrong place for such a thing.  The second obvious point
 728 is that the current code ignores the reloc addend when producing
 729 relocatable output for COFF.  That's peculiar.  In fact, I really
 730 have no idea what the point of the line you want to remove is.
 731
 732 A typical COFF reloc subtracts the old value of the symbol and adds in
 733 the new value to the location in the object file (if it's a pc
 734 relative reloc it adds the difference between the symbol value and the
 735 location).  When relocating we need to preserve that property.
 736
 737 BFD handles this by setting the addend to the negative of the old
 738 value of the symbol.  Unfortunately it handles common symbols in a
 739 non-standard way (it doesn't subtract the old value) but that's a
 740 different story (we can't change it without losing backward
 741 compatibility with old object files) (coff-i386 does subtract the old
 742 value, to be compatible with existing coff-i386 targets, like SCO).
 743
 744 So everything works fine when not producing relocatable output.  When
 745 we are producing relocatable output, logically we should do exactly
 746 what we do when not producing relocatable output.  Therefore, your
 747 patch is correct.  In fact, it should probably always just set
 748 reloc_entry->addend to 0 for all cases, since it is, in fact, going to
 749 add the value into the object file.  This won't hurt the COFF code,
 750 which doesn't use the addend; I'm not sure what it will do to other
 751 formats (the thing to check for would be whether any formats both use
 752 the addend and set partial_inplace).
 753
 754 When I wanted to make coff-i386 produce relocatable output, I ran
 755 into the problem that you are running into: I wanted to remove that
 756 line.  Rather than risk it, I made the coff-i386 relocs use a special
 757 function; it's coff_i386_reloc in coff-i386.c.  The function
 758 specifically adds the addend field into the object file, knowing that
 759 bfd_perform_relocation is not going to.  If you remove that line, then
 760 coff-i386.c will wind up adding the addend field in twice.  It's
 761 trivial to fix; it just needs to be done.
 762
 763 The problem with removing the line is just that it may break some
 764 working code.  With BFD it's hard to be sure of anything.  The right
 765 way to deal with this is simply to build and test at least all the
 766 supported COFF targets.  It should be straightforward if time and disk
 767 space consuming.  For each target:
 768     1) build the linker
 769     2) generate some executable, and link it using -r (I would
 770        probably use paranoia.o and link against newlib/libc.a, which
 771        for all the supported targets would be available in
 772        /usr/cygnus/progressive/H-host/target/lib/libc.a).
 773     3) make the change to reloc.c
 774     4) rebuild the linker
 775     5) repeat step 2
 776     6) if the resulting object files are the same, you have at least
 777        made it no worse
 778     7) if they are different you have to figure out which version is
 779        right
 780 */
 781               relocation -= reloc_entry->addend;
 782               reloc_entry->addend = 0;
 783             }
 784           else
 785             {
 786               reloc_entry->addend = relocation;
 787             }
 788         }
 789     }
 790   else
 791     {
 792       reloc_entry->addend = 0;
 793     }
 794
 795   /* FIXME: This overflow checking is incomplete, because the value
 796      might have overflowed before we get here.  For a correct check we
 797      need to compute the value in a size larger than bitsize, but we
 798      can't reasonably do that for a reloc the same size as a host
 799      machine word.
 800      FIXME: We should also do overflow checking on the result after
 801      adding in the value contained in the object file.  */
 802   if (howto->complain_on_overflow != complain_overflow_dont
 803       && flag == bfd_reloc_ok)
 804     flag = bfd_check_overflow (howto->complain_on_overflow,
 805                                howto->bitsize,
 806                                howto->rightshift,
 807                                bfd_arch_bits_per_address (abfd),
 808                                relocation);
 809
 810   /* Either we are relocating all the way, or we don't want to apply
 811      the relocation to the reloc entry (probably because there isn't
 812      any room in the output format to describe addends to relocs).  */
 813
 814   /* The cast to bfd_vma avoids a bug in the Alpha OSF/1 C compiler
 815      (OSF version 1.3, compiler version 3.11).  It miscompiles the
 816      following program:
 817
 818      struct str
 819      {
 820        unsigned int i0;
 821      } s = { 0 };
 822
 823      int
 824      main ()
 825      {
 826        unsigned long x;
 827
 828        x = 0x100000000;
 829        x <<= (unsigned long) s.i0;
 830        if (x == 0)
 831          printf ("failed\n");
 832        else
 833          printf ("succeeded (%lx)\n", x);
 834      }
 835      */
 836
 837   relocation >>= (bfd_vma) howto->rightshift;
 838
 839   /* Shift everything up to where it's going to be used.  */
 840   relocation <<= (bfd_vma) howto->bitpos;
 841
 842   /* Wait for the day when all have the mask in them.  */
 843
 844   /* What we do:
 845      i instruction to be left alone
 846      o offset within instruction
 847      r relocation offset to apply
 848      S src mask
 849      D dst mask
 850      N ~dst mask
 851      A part 1
 852      B part 2
 853      R result
 854
 855      Do this:
 856      ((  i i i i i o o o o o  from bfd_get<size>
 857      and           S S S S S) to get the size offset we want
 858      +   r r r r r r r r r r) to get the final value to place
 859      and           D D D D D  to chop to right size
 860      -----------------------
 861      =             A A A A A
 862      And this:
 863      (   i i i i i o o o o o  from bfd_get<size>
 864      and N N N N N          ) get instruction
 865      -----------------------
 866      =   B B B B B
 867
 868      And then:
 869      (   B B B B B
 870      or            A A A A A)
 871      -----------------------
 872      =   R R R R R R R R R R  put into bfd_put<size>
 873      */
 874
 875 #define DOIT(x) \
 876   x = ( (x & ~howto->dst_mask) | (((x & howto->src_mask) +  relocation) & howto->dst_mask))
 877
 878   switch (howto->size)
 879     {
 880     case 0:
 881       {
 882         char x = bfd_get_8 (abfd, (char *) data + octets);
 883         DOIT (x);
 884         bfd_put_8 (abfd, x, (unsigned char *) data + octets);
 885       }
 886       break;
 887
 888     case 1:
 889       {
 890         short x = bfd_get_16 (abfd, (bfd_byte *) data + octets);
 891         DOIT (x);
 892         bfd_put_16 (abfd, (bfd_vma) x, (unsigned char *) data + octets);
 893       }
 894       break;
 895     case 2:
 896       {
 897         long x = bfd_get_32 (abfd, (bfd_byte *) data + octets);
 898         DOIT (x);
 899         bfd_put_32 (abfd, (bfd_vma) x, (bfd_byte *) data + octets);
 900       }
 901       break;
 902     case -2:
 903       {
 904         long x = bfd_get_32 (abfd, (bfd_byte *) data + octets);
 905         relocation = -relocation;
 906         DOIT (x);
 907         bfd_put_32 (abfd, (bfd_vma) x, (bfd_byte *) data + octets);
 908       }
 909       break;
 910
 911     case -1:
 912       {
 913         long x = bfd_get_16 (abfd, (bfd_byte *) data + octets);
 914         relocation = -relocation;
 915         DOIT (x);
 916         bfd_put_16 (abfd, (bfd_vma) x, (bfd_byte *) data + octets);
 917       }
 918       break;
 919
 920     case 3:
 921       /* Do nothing */
 922       break;
 923
 924     case 4:
 925 #ifdef BFD64
 926       {
 927         bfd_vma x = bfd_get_64 (abfd, (bfd_byte *) data + octets);
 928         DOIT (x);
 929         bfd_put_64 (abfd, x, (bfd_byte *) data + octets);
 930       }
 931 #else
 932       abort ();
 933 #endif
 934       break;
 935     default:
 936       return bfd_reloc_other;
 937     }
 938
 939   return flag;
 940 }
 941
 942 /*
 943 FUNCTION
 944         bfd_install_relocation
 945
 946 SYNOPSIS
 947         bfd_reloc_status_type bfd_install_relocation
 948           (bfd *abfd,
 949            arelent *reloc_entry,
 950            void *data, bfd_vma data_start,
 951            asection *input_section,
 952            char **error_message);
 953
 954 DESCRIPTION
 955         This looks remarkably like <<bfd_perform_relocation>>, except it
 956         does not expect that the section contents have been filled in.
 957         I.e., it's suitable for use when creating, rather than applying
 958         a relocation.
 959
 960         For now, this function should be considered reserved for the
 961         assembler.
 962 */
 963
 964 bfd_reloc_status_type
 965 bfd_install_relocation (bfd *abfd,
 966                         arelent *reloc_entry,
 967                         void *data_start,
 968                         bfd_vma data_start_offset,
 969                         asection *input_section,
 970                         char **error_message)
 971 {
 972   bfd_vma relocation;
 973   bfd_reloc_status_type flag = bfd_reloc_ok;
 974   bfd_size_type octets = reloc_entry->address * bfd_octets_per_byte (abfd);
 975   bfd_vma output_base = 0;
 976   reloc_howto_type *howto = reloc_entry->howto;
 977   asection *reloc_target_output_section;
 978   asymbol *symbol;
 979   bfd_byte *data;
 980
 981   symbol = *(reloc_entry->sym_ptr_ptr);
 982   if (bfd_is_abs_section (symbol->section))
 983     {
 984       reloc_entry->address += input_section->output_offset;
 985       return bfd_reloc_ok;
 986     }
 987
 988   /* If there is a function supplied to handle this relocation type,
 989      call it.  It'll return `bfd_reloc_continue' if further processing
 990      can be done.  */
 991   if (howto->special_function)
 992     {
 993       bfd_reloc_status_type cont;
 994
 995       /* XXX - The special_function calls haven't been fixed up to deal
 996          with creating new relocations and section contents.  */
 997       cont = howto->special_function (abfd, reloc_entry, symbol,
 998                                       /* XXX - Non-portable! */
 999                                       ((bfd_byte *) data_start
1000                                        - data_start_offset),
1001                                       input_section, abfd, error_message);
1002       if (cont != bfd_reloc_continue)
1003         return cont;
1004     }
1005
1006   /* Is the address of the relocation really within the section?  */
1007   if (reloc_entry->address > bfd_get_section_limit (abfd, input_section))
1008     return bfd_reloc_outofrange;
1009
1010   /* Work out which section the relocation is targeted at and the
1011      initial relocation command value.  */
1012
1013   /* Get symbol value.  (Common symbols are special.)  */
1014   if (bfd_is_com_section (symbol->section))
1015     relocation = 0;
1016   else
1017     relocation = symbol->value;
1018
1019   reloc_target_output_section = symbol->section->output_section;
1020
1021   /* Convert input-section-relative symbol value to absolute.  */
1022   if (! howto->partial_inplace)
1023     output_base = 0;
1024   else
1025     output_base = reloc_target_output_section->vma;
1026
1027   relocation += output_base + symbol->section->output_offset;
1028
1029   /* Add in supplied addend.  */
1030   relocation += reloc_entry->addend;
1031
1032   /* Here the variable relocation holds the final address of the
1033      symbol we are relocating against, plus any addend.  */
1034
1035   if (howto->pc_relative)
1036     {
1037       /* This is a PC relative relocation.  We want to set RELOCATION
1038          to the distance between the address of the symbol and the
1039          location.  RELOCATION is already the address of the symbol.
1040
1041          We start by subtracting the address of the section containing
1042          the location.
1043
1044          If pcrel_offset is set, we must further subtract the position
1045          of the location within the section.  Some targets arrange for
1046          the addend to be the negative of the position of the location
1047          within the section; for example, i386-aout does this.  For
1048          i386-aout, pcrel_offset is FALSE.  Some other targets do not
1049          include the position of the location; for example, m88kbcs,
1050          or ELF.  For those targets, pcrel_offset is TRUE.
1051
1052          If we are producing relocatable output, then we must ensure
1053          that this reloc will be correctly computed when the final
1054          relocation is done.  If pcrel_offset is FALSE we want to wind
1055          up with the negative of the location within the section,
1056          which means we must adjust the existing addend by the change
1057          in the location within the section.  If pcrel_offset is TRUE
1058          we do not want to adjust the existing addend at all.
1059
1060          FIXME: This seems logical to me, but for the case of
1061          producing relocatable output it is not what the code
1062          actually does.  I don't want to change it, because it seems
1063          far too likely that something will break.  */
1064
1065       relocation -=
1066         input_section->output_section->vma + input_section->output_offset;
1067
1068       if (howto->pcrel_offset && howto->partial_inplace)
1069         relocation -= reloc_entry->address;
1070     }
1071
1072   if (! howto->partial_inplace)
1073     {
1074       /* This is a partial relocation, and we want to apply the relocation
1075          to the reloc entry rather than the raw data. Modify the reloc
1076          inplace to reflect what we now know.  */
1077       reloc_entry->addend = relocation;
1078       reloc_entry->address += input_section->output_offset;
1079       return flag;
1080     }
1081   else
1082     {
1083       /* This is a partial relocation, but inplace, so modify the
1084          reloc record a bit.
1085
1086          If we've relocated with a symbol with a section, change
1087          into a ref to the section belonging to the symbol.  */
1088       reloc_entry->address += input_section->output_offset;
1089
1090       /* WTF?? */
1091       if (abfd->xvec->flavour == bfd_target_coff_flavour
1092           && strcmp (abfd->xvec->name, "coff-Intel-little") != 0
1093           && strcmp (abfd->xvec->name, "coff-Intel-big") != 0)
1094         {
1095
1096           /* For m68k-coff, the addend was being subtracted twice during
1097              relocation with -r.  Removing the line below this comment
1098              fixes that problem; see PR 2953.
1099
1100 However, Ian wrote the following, regarding removing the line below,
1101 which explains why it is still enabled:  --djm
1102
1103 If you put a patch like that into BFD you need to check all the COFF
1104 linkers.  I am fairly certain that patch will break coff-i386 (e.g.,
1105 SCO); see coff_i386_reloc in coff-i386.c where I worked around the
1106 problem in a different way.  There may very well be a reason that the
1107 code works as it does.
1108
1109 Hmmm.  The first obvious point is that bfd_install_relocation should
1110 not have any tests that depend upon the flavour.  It's seem like
1111 entirely the wrong place for such a thing.  The second obvious point
1112 is that the current code ignores the reloc addend when producing
1113 relocatable output for COFF.  That's peculiar.  In fact, I really
1114 have no idea what the point of the line you want to remove is.
1115
1116 A typical COFF reloc subtracts the old value of the symbol and adds in
1117 the new value to the location in the object file (if it's a pc
1118 relative reloc it adds the difference between the symbol value and the
1119 location).  When relocating we need to preserve that property.
1120
1121 BFD handles this by setting the addend to the negative of the old
1122 value of the symbol.  Unfortunately it handles common symbols in a
1123 non-standard way (it doesn't subtract the old value) but that's a
1124 different story (we can't change it without losing backward
1125 compatibility with old object files) (coff-i386 does subtract the old
1126 value, to be compatible with existing coff-i386 targets, like SCO).
1127
1128 So everything works fine when not producing relocatable output.  When
1129 we are producing relocatable output, logically we should do exactly
1130 what we do when not producing relocatable output.  Therefore, your
1131 patch is correct.  In fact, it should probably always just set
1132 reloc_entry->addend to 0 for all cases, since it is, in fact, going to
1133 add the value into the object file.  This won't hurt the COFF code,
1134 which doesn't use the addend; I'm not sure what it will do to other
1135 formats (the thing to check for would be whether any formats both use
1136 the addend and set partial_inplace).
1137
1138 When I wanted to make coff-i386 produce relocatable output, I ran
1139 into the problem that you are running into: I wanted to remove that
1140 line.  Rather than risk it, I made the coff-i386 relocs use a special
1141 function; it's coff_i386_reloc in coff-i386.c.  The function
1142 specifically adds the addend field into the object file, knowing that
1143 bfd_install_relocation is not going to.  If you remove that line, then
1144 coff-i386.c will wind up adding the addend field in twice.  It's
1145 trivial to fix; it just needs to be done.
1146
1147 The problem with removing the line is just that it may break some
1148 working code.  With BFD it's hard to be sure of anything.  The right
1149 way to deal with this is simply to build and test at least all the
1150 supported COFF targets.  It should be straightforward if time and disk
1151 space consuming.  For each target:
1152     1) build the linker
1153     2) generate some executable, and link it using -r (I would
1154        probably use paranoia.o and link against newlib/libc.a, which
1155        for all the supported targets would be available in
1156        /usr/cygnus/progressive/H-host/target/lib/libc.a).
1157     3) make the change to reloc.c
1158     4) rebuild the linker
1159     5) repeat step 2
1160     6) if the resulting object files are the same, you have at least
1161        made it no worse
1162     7) if they are different you have to figure out which version is
1163        right.  */
1164           relocation -= reloc_entry->addend;
1165           /* FIXME: There should be no target specific code here...  */
1166           if (strcmp (abfd->xvec->name, "coff-z8k") != 0)
1167             reloc_entry->addend = 0;
1168         }
1169       else
1170         {
1171           reloc_entry->addend = relocation;
1172         }
1173     }
1174
1175   /* FIXME: This overflow checking is incomplete, because the value
1176      might have overflowed before we get here.  For a correct check we
1177      need to compute the value in a size larger than bitsize, but we
1178      can't reasonably do that for a reloc the same size as a host
1179      machine word.
1180      FIXME: We should also do overflow checking on the result after
1181      adding in the value contained in the object file.  */
1182   if (howto->complain_on_overflow != complain_overflow_dont)
1183     flag = bfd_check_overflow (howto->complain_on_overflow,
1184                                howto->bitsize,
1185                                howto->rightshift,
1186                                bfd_arch_bits_per_address (abfd),
1187                                relocation);
1188
1189   /* Either we are relocating all the way, or we don't want to apply
1190      the relocation to the reloc entry (probably because there isn't
1191      any room in the output format to describe addends to relocs).  */
1192
1193   /* The cast to bfd_vma avoids a bug in the Alpha OSF/1 C compiler
1194      (OSF version 1.3, compiler version 3.11).  It miscompiles the
1195      following program:
1196
1197      struct str
1198      {
1199        unsigned int i0;
1200      } s = { 0 };
1201
1202      int
1203      main ()
1204      {
1205        unsigned long x;
1206
1207        x = 0x100000000;
1208        x <<= (unsigned long) s.i0;
1209        if (x == 0)
1210          printf ("failed\n");
1211        else
1212          printf ("succeeded (%lx)\n", x);
1213      }
1214      */
1215
1216   relocation >>= (bfd_vma) howto->rightshift;
1217
1218   /* Shift everything up to where it's going to be used.  */
1219   relocation <<= (bfd_vma) howto->bitpos;
1220
1221   /* Wait for the day when all have the mask in them.  */
1222
1223   /* What we do:
1224      i instruction to be left alone
1225      o offset within instruction
1226      r relocation offset to apply
1227      S src mask
1228      D dst mask
1229      N ~dst mask
1230      A part 1
1231      B part 2
1232      R result
1233
1234      Do this:
1235      ((  i i i i i o o o o o  from bfd_get<size>
1236      and           S S S S S) to get the size offset we want
1237      +   r r r r r r r r r r) to get the final value to place
1238      and           D D D D D  to chop to right size
1239      -----------------------
1240      =             A A A A A
1241      And this:
1242      (   i i i i i o o o o o  from bfd_get<size>
1243      and N N N N N          ) get instruction
1244      -----------------------
1245      =   B B B B B
1246
1247      And then:
1248      (   B B B B B
1249      or            A A A A A)
1250      -----------------------
1251      =   R R R R R R R R R R  put into bfd_put<size>
1252      */
1253
1254 #define DOIT(x) \
1255   x = ( (x & ~howto->dst_mask) | (((x & howto->src_mask) +  relocation) & howto->dst_mask))
1256
1257   data = (bfd_byte *) data_start + (octets - data_start_offset);
1258
1259   switch (howto->size)
1260     {
1261     case 0:
1262       {
1263         char x = bfd_get_8 (abfd, data);
1264         DOIT (x);
1265         bfd_put_8 (abfd, x, data);
1266       }
1267       break;
1268
1269     case 1:
1270       {
1271         short x = bfd_get_16 (abfd, data);
1272         DOIT (x);
1273         bfd_put_16 (abfd, (bfd_vma) x, data);
1274       }
1275       break;
1276     case 2:
1277       {
1278         long x = bfd_get_32 (abfd, data);
1279         DOIT (x);
1280         bfd_put_32 (abfd, (bfd_vma) x, data);
1281       }
1282       break;
1283     case -2:
1284       {
1285         long x = bfd_get_32 (abfd, data);
1286         relocation = -relocation;
1287         DOIT (x);
1288         bfd_put_32 (abfd, (bfd_vma) x, data);
1289       }
1290       break;
1291
1292     case 3:
1293       /* Do nothing */
1294       break;
1295
1296     case 4:
1297       {
1298         bfd_vma x = bfd_get_64 (abfd, data);
1299         DOIT (x);
1300         bfd_put_64 (abfd, x, data);
1301       }
1302       break;
1303     default:
1304       return bfd_reloc_other;
1305     }
1306
1307   return flag;
1308 }
1309
1310 /* This relocation routine is used by some of the backend linkers.
1311    They do not construct asymbol or arelent structures, so there is no
1312    reason for them to use bfd_perform_relocation.  Also,
1313    bfd_perform_relocation is so hacked up it is easier to write a new
1314    function than to try to deal with it.
1315
1316    This routine does a final relocation.  Whether it is useful for a
1317    relocatable link depends upon how the object format defines
1318    relocations.
1319
1320    FIXME: This routine ignores any special_function in the HOWTO,
1321    since the existing special_function values have been written for
1322    bfd_perform_relocation.
1323
1324    HOWTO is the reloc howto information.
1325    INPUT_BFD is the BFD which the reloc applies to.
1326    INPUT_SECTION is the section which the reloc applies to.
1327    CONTENTS is the contents of the section.
1328    ADDRESS is the address of the reloc within INPUT_SECTION.
1329    VALUE is the value of the symbol the reloc refers to.
1330    ADDEND is the addend of the reloc.  */
1331
1332 bfd_reloc_status_type
1333 _bfd_final_link_relocate (reloc_howto_type *howto,
1334                           bfd *input_bfd,
1335                           asection *input_section,
1336                           bfd_byte *contents,
1337                           bfd_vma address,
1338                           bfd_vma value,
1339                           bfd_vma addend)
1340 {
1341   bfd_vma relocation;
1342
1343   /* Sanity check the address.  */
1344   if (address > bfd_get_section_limit (input_bfd, input_section))
1345     return bfd_reloc_outofrange;
1346
1347   /* This function assumes that we are dealing with a basic relocation
1348      against a symbol.  We want to compute the value of the symbol to
1349      relocate to.  This is just VALUE, the value of the symbol, plus
1350      ADDEND, any addend associated with the reloc.  */
1351   relocation = value + addend;
1352
1353   /* If the relocation is PC relative, we want to set RELOCATION to
1354      the distance between the symbol (currently in RELOCATION) and the
1355      location we are relocating.  Some targets (e.g., i386-aout)
1356      arrange for the contents of the section to be the negative of the
1357      offset of the location within the section; for such targets
1358      pcrel_offset is FALSE.  Other targets (e.g., m88kbcs or ELF)
1359      simply leave the contents of the section as zero; for such
1360      targets pcrel_offset is TRUE.  If pcrel_offset is FALSE we do not
1361      need to subtract out the offset of the location within the
1362      section (which is just ADDRESS).  */
1363   if (howto->pc_relative)
1364     {
1365       relocation -= (input_section->output_section->vma
1366                      + input_section->output_offset);
1367       if (howto->pcrel_offset)
1368         relocation -= address;
1369     }
1370
1371   return _bfd_relocate_contents (howto, input_bfd, relocation,
1372                                  contents + address);
1373 }
1374
1375 /* Relocate a given location using a given value and howto.  */
1376
1377 bfd_reloc_status_type
1378 _bfd_relocate_contents (reloc_howto_type *howto,
1379                         bfd *input_bfd,
1380                         bfd_vma relocation,
1381                         bfd_byte *location)
1382 {
1383   int size;
1384   bfd_vma x = 0;
1385   bfd_reloc_status_type flag;
1386   unsigned int rightshift = howto->rightshift;
1387   unsigned int bitpos = howto->bitpos;
1388
1389   /* If the size is negative, negate RELOCATION.  This isn't very
1390      general.  */
1391   if (howto->size < 0)
1392     relocation = -relocation;
1393
1394   /* Get the value we are going to relocate.  */
1395   size = bfd_get_reloc_size (howto);
1396   switch (size)
1397     {
1398     default:
1399     case 0:
1400       abort ();
1401     case 1:
1402       x = bfd_get_8 (input_bfd, location);
1403       break;
1404     case 2:
1405       x = bfd_get_16 (input_bfd, location);
1406       break;
1407     case 4:
1408       x = bfd_get_32 (input_bfd, location);
1409       break;
1410     case 8:
1411 #ifdef BFD64
1412       x = bfd_get_64 (input_bfd, location);
1413 #else
1414       abort ();
1415 #endif
1416       break;
1417     }
1418
1419   /* Check for overflow.  FIXME: We may drop bits during the addition
1420      which we don't check for.  We must either check at every single
1421      operation, which would be tedious, or we must do the computations
1422      in a type larger than bfd_vma, which would be inefficient.  */
1423   flag = bfd_reloc_ok;
1424   if (howto->complain_on_overflow != complain_overflow_dont)
1425     {
1426       bfd_vma addrmask, fieldmask, signmask, ss;
1427       bfd_vma a, b, sum;
1428
1429       /* Get the values to be added together.  For signed and unsigned
1430          relocations, we assume that all values should be truncated to
1431          the size of an address.  For bitfields, all the bits matter.
1432          See also bfd_check_overflow.  */
1433       fieldmask = N_ONES (howto->bitsize);
1434       signmask = ~fieldmask;
1435       addrmask = (N_ONES (bfd_arch_bits_per_address (input_bfd))
1436                   | (fieldmask << rightshift));
1437       a = (relocation & addrmask) >> rightshift;
1438       b = (x & howto->src_mask & addrmask) >> bitpos;
1439       addrmask >>= rightshift;
1440
1441       switch (howto->complain_on_overflow)
1442         {
1443         case complain_overflow_signed:
1444           /* If any sign bits are set, all sign bits must be set.
1445              That is, A must be a valid negative address after
1446              shifting.  */
1447           signmask = ~(fieldmask >> 1);
1448           /* Fall thru */
1449
1450         case complain_overflow_bitfield:
1451           /* Much like the signed check, but for a field one bit
1452              wider.  We allow a bitfield to represent numbers in the
1453              range -2**n to 2**n-1, where n is the number of bits in the
1454              field.  Note that when bfd_vma is 32 bits, a 32-bit reloc
1455              can't overflow, which is exactly what we want.  */
1456           ss = a & signmask;
1457           if (ss != 0 && ss != (addrmask & signmask))
1458             flag = bfd_reloc_overflow;
1459
1460           /* We only need this next bit of code if the sign bit of B
1461              is below the sign bit of A.  This would only happen if
1462              SRC_MASK had fewer bits than BITSIZE.  Note that if
1463              SRC_MASK has more bits than BITSIZE, we can get into
1464              trouble; we would need to verify that B is in range, as
1465              we do for A above.  */
1466           ss = ((~howto->src_mask) >> 1) & howto->src_mask;
1467           ss >>= bitpos;
1468
1469           /* Set all the bits above the sign bit.  */
1470           b = (b ^ ss) - ss;
1471
1472           /* Now we can do the addition.  */
1473           sum = a + b;
1474
1475           /* See if the result has the correct sign.  Bits above the
1476              sign bit are junk now; ignore them.  If the sum is
1477              positive, make sure we did not have all negative inputs;
1478              if the sum is negative, make sure we did not have all
1479              positive inputs.  The test below looks only at the sign
1480              bits, and it really just
1481                  SIGN (A) == SIGN (B) && SIGN (A) != SIGN (SUM)
1482
1483              We mask with addrmask here to explicitly allow an address
1484              wrap-around.  The Linux kernel relies on it, and it is
1485              the only way to write assembler code which can run when
1486              loaded at a location 0x80000000 away from the location at
1487              which it is linked.  */
1488           if (((~(a ^ b)) & (a ^ sum)) & signmask & addrmask)
1489             flag = bfd_reloc_overflow;
1490           break;
1491
1492         case complain_overflow_unsigned:
1493           /* Checking for an unsigned overflow is relatively easy:
1494              trim the addresses and add, and trim the result as well.
1495              Overflow is normally indicated when the result does not
1496              fit in the field.  However, we also need to consider the
1497              case when, e.g., fieldmask is 0x7fffffff or smaller, an
1498              input is 0x80000000, and bfd_vma is only 32 bits; then we
1499              will get sum == 0, but there is an overflow, since the
1500              inputs did not fit in the field.  Instead of doing a
1501              separate test, we can check for this by or-ing in the
1502              operands when testing for the sum overflowing its final
1503              field.  */
1504           sum = (a + b) & addrmask;
1505           if ((a | b | sum) & signmask)
1506             flag = bfd_reloc_overflow;
1507           break;
1508
1509         default:
1510           abort ();
1511         }
1512     }
1513
1514   /* Put RELOCATION in the right bits.  */
1515   relocation >>= (bfd_vma) rightshift;
1516   relocation <<= (bfd_vma) bitpos;
1517
1518   /* Add RELOCATION to the right bits of X.  */
1519   x = ((x & ~howto->dst_mask)
1520        | (((x & howto->src_mask) + relocation) & howto->dst_mask));
1521
1522   /* Put the relocated value back in the object file.  */
1523   switch (size)
1524     {
1525     default:
1526       abort ();
1527     case 1:
1528       bfd_put_8 (input_bfd, x, location);
1529       break;
1530     case 2:
1531       bfd_put_16 (input_bfd, x, location);
1532       break;
1533     case 4:
1534       bfd_put_32 (input_bfd, x, location);
1535       break;
1536     case 8:
1537 #ifdef BFD64
1538       bfd_put_64 (input_bfd, x, location);
1539 #else
1540       abort ();
1541 #endif
1542       break;
1543     }
1544
1545   return flag;
1546 }
1547
1548 /* Clear a given location using a given howto, by applying a fixed relocation
1549    value and discarding any in-place addend.  This is used for fixed-up
1550    relocations against discarded symbols, to make ignorable debug or unwind
1551    information more obvious.  */
1552
1553 void
1554 _bfd_clear_contents (reloc_howto_type *howto,
1555                      bfd *input_bfd,
1556                      asection *input_section,
1557                      bfd_byte *location)
1558 {
1559   int size;
1560   bfd_vma x = 0;
1561
1562   /* Get the value we are going to relocate.  */
1563   size = bfd_get_reloc_size (howto);
1564   switch (size)
1565     {
1566     default:
1567     case 0:
1568       abort ();
1569     case 1:
1570       x = bfd_get_8 (input_bfd, location);
1571       break;
1572     case 2:
1573       x = bfd_get_16 (input_bfd, location);
1574       break;
1575     case 4:
1576       x = bfd_get_32 (input_bfd, location);
1577       break;
1578     case 8:
1579 #ifdef BFD64
1580       x = bfd_get_64 (input_bfd, location);
1581 #else
1582       abort ();
1583 #endif
1584       break;
1585     }
1586
1587   /* Zero out the unwanted bits of X.  */
1588   x &= ~howto->dst_mask;
1589
1590   /* For a range list, use 1 instead of 0 as placeholder.  0
1591      would terminate the list, hiding any later entries.  */
1592   if (strcmp (bfd_get_section_name (input_bfd, input_section),
1593               ".debug_ranges") == 0
1594       && (howto->dst_mask & 1) != 0)
1595     x |= 1;
1596
1597   /* Put the relocated value back in the object file.  */
1598   switch (size)
1599     {
1600     default:
1601     case 0:
1602       abort ();
1603     case 1:
1604       bfd_put_8 (input_bfd, x, location);
1605       break;
1606     case 2:
1607       bfd_put_16 (input_bfd, x, location);
1608       break;
1609     case 4:
1610       bfd_put_32 (input_bfd, x, location);
1611       break;
1612     case 8:
1613 #ifdef BFD64
1614       bfd_put_64 (input_bfd, x, location);
1615 #else
1616       abort ();
1617 #endif
1618       break;
1619     }
1620 }
1621
1622 /*
1623 DOCDD
1624 INODE
1625         howto manager,  , typedef arelent, Relocations
1626
1627 SUBSECTION
1628         The howto manager
1629
1630         When an application wants to create a relocation, but doesn't
1631         know what the target machine might call it, it can find out by
1632         using this bit of code.
1633
1634 */
1635
1636 /*
1637 TYPEDEF
1638         bfd_reloc_code_type
1639
1640 DESCRIPTION
1641         The insides of a reloc code.  The idea is that, eventually, there
1642         will be one enumerator for every type of relocation we ever do.
1643         Pass one of these values to <<bfd_reloc_type_lookup>>, and it'll
1644         return a howto pointer.
1645
1646         This does mean that the application must determine the correct
1647         enumerator value; you can't get a howto pointer from a random set
1648         of attributes.
1649
1650 SENUM
1651    bfd_reloc_code_real
1652
1653 ENUM
1654   BFD_RELOC_64
1655 ENUMX
1656   BFD_RELOC_32
1657 ENUMX
1658   BFD_RELOC_26
1659 ENUMX
1660   BFD_RELOC_24
1661 ENUMX
1662   BFD_RELOC_16
1663 ENUMX
1664   BFD_RELOC_14
1665 ENUMX
1666   BFD_RELOC_8
1667 ENUMDOC
1668   Basic absolute relocations of N bits.
1669
1670 ENUM
1671   BFD_RELOC_64_PCREL
1672 ENUMX
1673   BFD_RELOC_32_PCREL
1674 ENUMX
1675   BFD_RELOC_24_PCREL
1676 ENUMX
1677   BFD_RELOC_16_PCREL
1678 ENUMX
1679   BFD_RELOC_12_PCREL
1680 ENUMX
1681   BFD_RELOC_8_PCREL
1682 ENUMDOC
1683   PC-relative relocations.  Sometimes these are relative to the address
1684 of the relocation itself; sometimes they are relative to the start of
1685 the section containing the relocation.  It depends on the specific target.
1686
1687 The 24-bit relocation is used in some Intel 960 configurations.
1688
1689 ENUM
1690   BFD_RELOC_32_SECREL
1691 ENUMDOC
1692   Section relative relocations.  Some targets need this for DWARF2.
1693
1694 ENUM
1695   BFD_RELOC_32_GOT_PCREL
1696 ENUMX
1697   BFD_RELOC_16_GOT_PCREL
1698 ENUMX
1699   BFD_RELOC_8_GOT_PCREL
1700 ENUMX
1701   BFD_RELOC_32_GOTOFF
1702 ENUMX
1703   BFD_RELOC_16_GOTOFF
1704 ENUMX
1705   BFD_RELOC_LO16_GOTOFF
1706 ENUMX
1707   BFD_RELOC_HI16_GOTOFF
1708 ENUMX
1709   BFD_RELOC_HI16_S_GOTOFF
1710 ENUMX
1711   BFD_RELOC_8_GOTOFF
1712 ENUMX
1713   BFD_RELOC_64_PLT_PCREL
1714 ENUMX
1715   BFD_RELOC_32_PLT_PCREL
1716 ENUMX
1717   BFD_RELOC_24_PLT_PCREL
1718 ENUMX
1719   BFD_RELOC_16_PLT_PCREL
1720 ENUMX
1721   BFD_RELOC_8_PLT_PCREL
1722 ENUMX
1723   BFD_RELOC_64_PLTOFF
1724 ENUMX
1725   BFD_RELOC_32_PLTOFF
1726 ENUMX
1727   BFD_RELOC_16_PLTOFF
1728 ENUMX
1729   BFD_RELOC_LO16_PLTOFF
1730 ENUMX
1731   BFD_RELOC_HI16_PLTOFF
1732 ENUMX
1733   BFD_RELOC_HI16_S_PLTOFF
1734 ENUMX
1735   BFD_RELOC_8_PLTOFF
1736 ENUMDOC
1737   For ELF.
1738
1739 ENUM
1740   BFD_RELOC_68K_GLOB_DAT
1741 ENUMX
1742   BFD_RELOC_68K_JMP_SLOT
1743 ENUMX
1744   BFD_RELOC_68K_RELATIVE
1745 ENUMX
1746   BFD_RELOC_68K_TLS_GD32
1747 ENUMX
1748   BFD_RELOC_68K_TLS_GD16
1749 ENUMX
1750   BFD_RELOC_68K_TLS_GD8
1751 ENUMX
1752   BFD_RELOC_68K_TLS_LDM32
1753 ENUMX
1754   BFD_RELOC_68K_TLS_LDM16
1755 ENUMX
1756   BFD_RELOC_68K_TLS_LDM8
1757 ENUMX
1758   BFD_RELOC_68K_TLS_LDO32
1759 ENUMX
1760   BFD_RELOC_68K_TLS_LDO16
1761 ENUMX
1762   BFD_RELOC_68K_TLS_LDO8
1763 ENUMX
1764   BFD_RELOC_68K_TLS_IE32
1765 ENUMX
1766   BFD_RELOC_68K_TLS_IE16
1767 ENUMX
1768   BFD_RELOC_68K_TLS_IE8
1769 ENUMX
1770   BFD_RELOC_68K_TLS_LE32
1771 ENUMX
1772   BFD_RELOC_68K_TLS_LE16
1773 ENUMX
1774   BFD_RELOC_68K_TLS_LE8
1775 ENUMDOC
1776   Relocations used by 68K ELF.
1777
1778 ENUM
1779   BFD_RELOC_32_BASEREL
1780 ENUMX
1781   BFD_RELOC_16_BASEREL
1782 ENUMX
1783   BFD_RELOC_LO16_BASEREL
1784 ENUMX
1785   BFD_RELOC_HI16_BASEREL
1786 ENUMX
1787   BFD_RELOC_HI16_S_BASEREL
1788 ENUMX
1789   BFD_RELOC_8_BASEREL
1790 ENUMX
1791   BFD_RELOC_RVA
1792 ENUMDOC
1793   Linkage-table relative.
1794
1795 ENUM
1796   BFD_RELOC_8_FFnn
1797 ENUMDOC
1798   Absolute 8-bit relocation, but used to form an address like 0xFFnn.
1799
1800 ENUM
1801   BFD_RELOC_32_PCREL_S2
1802 ENUMX
1803   BFD_RELOC_16_PCREL_S2
1804 ENUMX
1805   BFD_RELOC_23_PCREL_S2
1806 ENUMDOC
1807   These PC-relative relocations are stored as word displacements --
1808 i.e., byte displacements shifted right two bits.  The 30-bit word
1809 displacement (<<32_PCREL_S2>> -- 32 bits, shifted 2) is used on the
1810 SPARC.  (SPARC tools generally refer to this as <<WDISP30>>.)  The
1811 signed 16-bit displacement is used on the MIPS, and the 23-bit
1812 displacement is used on the Alpha.
1813
1814 ENUM
1815   BFD_RELOC_HI22
1816 ENUMX
1817   BFD_RELOC_LO10
1818 ENUMDOC
1819   High 22 bits and low 10 bits of 32-bit value, placed into lower bits of
1820 the target word.  These are used on the SPARC.
1821
1822 ENUM
1823   BFD_RELOC_GPREL16
1824 ENUMX
1825   BFD_RELOC_GPREL32
1826 ENUMDOC
1827   For systems that allocate a Global Pointer register, these are
1828 displacements off that register.  These relocation types are
1829 handled specially, because the value the register will have is
1830 decided relatively late.
1831
1832 ENUM
1833   BFD_RELOC_I960_CALLJ
1834 ENUMDOC
1835   Reloc types used for i960/b.out.
1836
1837 ENUM
1838   BFD_RELOC_NONE
1839 ENUMX
1840   BFD_RELOC_SPARC_WDISP22
1841 ENUMX
1842   BFD_RELOC_SPARC22
1843 ENUMX
1844   BFD_RELOC_SPARC13
1845 ENUMX
1846   BFD_RELOC_SPARC_GOT10
1847 ENUMX
1848   BFD_RELOC_SPARC_GOT13
1849 ENUMX
1850   BFD_RELOC_SPARC_GOT22
1851 ENUMX
1852   BFD_RELOC_SPARC_PC10
1853 ENUMX
1854   BFD_RELOC_SPARC_PC22
1855 ENUMX
1856   BFD_RELOC_SPARC_WPLT30
1857 ENUMX
1858   BFD_RELOC_SPARC_COPY
1859 ENUMX
1860   BFD_RELOC_SPARC_GLOB_DAT
1861 ENUMX
1862   BFD_RELOC_SPARC_JMP_SLOT
1863 ENUMX
1864   BFD_RELOC_SPARC_RELATIVE
1865 ENUMX
1866   BFD_RELOC_SPARC_UA16
1867 ENUMX
1868   BFD_RELOC_SPARC_UA32
1869 ENUMX
1870   BFD_RELOC_SPARC_UA64
1871 ENUMX
1872   BFD_RELOC_SPARC_GOTDATA_HIX22
1873 ENUMX
1874   BFD_RELOC_SPARC_GOTDATA_LOX10
1875 ENUMX
1876   BFD_RELOC_SPARC_GOTDATA_OP_HIX22
1877 ENUMX
1878   BFD_RELOC_SPARC_GOTDATA_OP_LOX10
1879 ENUMX
1880   BFD_RELOC_SPARC_GOTDATA_OP
1881 ENUMX
1882   BFD_RELOC_SPARC_JMP_IREL
1883 ENUMX
1884   BFD_RELOC_SPARC_IRELATIVE
1885 ENUMDOC
1886   SPARC ELF relocations.  There is probably some overlap with other
1887   relocation types already defined.
1888
1889 ENUM
1890   BFD_RELOC_SPARC_BASE13
1891 ENUMX
1892   BFD_RELOC_SPARC_BASE22
1893 ENUMDOC
1894   I think these are specific to SPARC a.out (e.g., Sun 4).
1895
1896 ENUMEQ
1897   BFD_RELOC_SPARC_64
1898   BFD_RELOC_64
1899 ENUMX
1900   BFD_RELOC_SPARC_10
1901 ENUMX
1902   BFD_RELOC_SPARC_11
1903 ENUMX
1904   BFD_RELOC_SPARC_OLO10
1905 ENUMX
1906   BFD_RELOC_SPARC_HH22
1907 ENUMX
1908   BFD_RELOC_SPARC_HM10
1909 ENUMX
1910   BFD_RELOC_SPARC_LM22
1911 ENUMX
1912   BFD_RELOC_SPARC_PC_HH22
1913 ENUMX
1914   BFD_RELOC_SPARC_PC_HM10
1915 ENUMX
1916   BFD_RELOC_SPARC_PC_LM22
1917 ENUMX
1918   BFD_RELOC_SPARC_WDISP16
1919 ENUMX
1920   BFD_RELOC_SPARC_WDISP19
1921 ENUMX
1922   BFD_RELOC_SPARC_7
1923 ENUMX
1924   BFD_RELOC_SPARC_6
1925 ENUMX
1926   BFD_RELOC_SPARC_5
1927 ENUMEQX
1928   BFD_RELOC_SPARC_DISP64
1929   BFD_RELOC_64_PCREL
1930 ENUMX
1931   BFD_RELOC_SPARC_PLT32
1932 ENUMX
1933   BFD_RELOC_SPARC_PLT64
1934 ENUMX
1935   BFD_RELOC_SPARC_HIX22
1936 ENUMX
1937   BFD_RELOC_SPARC_LOX10
1938 ENUMX
1939   BFD_RELOC_SPARC_H44
1940 ENUMX
1941   BFD_RELOC_SPARC_M44
1942 ENUMX
1943   BFD_RELOC_SPARC_L44
1944 ENUMX
1945   BFD_RELOC_SPARC_REGISTER
1946 ENUMX
1947   BFD_RELOC_SPARC_H34
1948 ENUMX
1949   BFD_RELOC_SPARC_SIZE32
1950 ENUMX
1951   BFD_RELOC_SPARC_SIZE64
1952 ENUMX
1953   BFD_RELOC_SPARC_WDISP10
1954 ENUMDOC
1955   SPARC64 relocations
1956
1957 ENUM
1958   BFD_RELOC_SPARC_REV32
1959 ENUMDOC
1960   SPARC little endian relocation
1961 ENUM
1962   BFD_RELOC_SPARC_TLS_GD_HI22
1963 ENUMX
1964   BFD_RELOC_SPARC_TLS_GD_LO10
1965 ENUMX
1966   BFD_RELOC_SPARC_TLS_GD_ADD
1967 ENUMX
1968   BFD_RELOC_SPARC_TLS_GD_CALL
1969 ENUMX
1970   BFD_RELOC_SPARC_TLS_LDM_HI22
1971 ENUMX
1972   BFD_RELOC_SPARC_TLS_LDM_LO10
1973 ENUMX
1974   BFD_RELOC_SPARC_TLS_LDM_ADD
1975 ENUMX
1976   BFD_RELOC_SPARC_TLS_LDM_CALL
1977 ENUMX
1978   BFD_RELOC_SPARC_TLS_LDO_HIX22
1979 ENUMX
1980   BFD_RELOC_SPARC_TLS_LDO_LOX10
1981 ENUMX
1982   BFD_RELOC_SPARC_TLS_LDO_ADD
1983 ENUMX
1984   BFD_RELOC_SPARC_TLS_IE_HI22
1985 ENUMX
1986   BFD_RELOC_SPARC_TLS_IE_LO10
1987 ENUMX
1988   BFD_RELOC_SPARC_TLS_IE_LD
1989 ENUMX
1990   BFD_RELOC_SPARC_TLS_IE_LDX
1991 ENUMX
1992   BFD_RELOC_SPARC_TLS_IE_ADD
1993 ENUMX
1994   BFD_RELOC_SPARC_TLS_LE_HIX22
1995 ENUMX
1996   BFD_RELOC_SPARC_TLS_LE_LOX10
1997 ENUMX
1998   BFD_RELOC_SPARC_TLS_DTPMOD32
1999 ENUMX
2000   BFD_RELOC_SPARC_TLS_DTPMOD64
2001 ENUMX
2002   BFD_RELOC_SPARC_TLS_DTPOFF32
2003 ENUMX
2004   BFD_RELOC_SPARC_TLS_DTPOFF64
2005 ENUMX
2006   BFD_RELOC_SPARC_TLS_TPOFF32
2007 ENUMX
2008   BFD_RELOC_SPARC_TLS_TPOFF64
2009 ENUMDOC
2010   SPARC TLS relocations
2011
2012 ENUM
2013   BFD_RELOC_SPU_IMM7
2014 ENUMX
2015   BFD_RELOC_SPU_IMM8
2016 ENUMX
2017   BFD_RELOC_SPU_IMM10
2018 ENUMX
2019   BFD_RELOC_SPU_IMM10W
2020 ENUMX
2021   BFD_RELOC_SPU_IMM16
2022 ENUMX
2023   BFD_RELOC_SPU_IMM16W
2024 ENUMX
2025   BFD_RELOC_SPU_IMM18
2026 ENUMX
2027   BFD_RELOC_SPU_PCREL9a
2028 ENUMX
2029   BFD_RELOC_SPU_PCREL9b
2030 ENUMX
2031   BFD_RELOC_SPU_PCREL16
2032 ENUMX
2033   BFD_RELOC_SPU_LO16
2034 ENUMX
2035   BFD_RELOC_SPU_HI16
2036 ENUMX
2037   BFD_RELOC_SPU_PPU32
2038 ENUMX
2039   BFD_RELOC_SPU_PPU64
2040 ENUMX
2041   BFD_RELOC_SPU_ADD_PIC
2042 ENUMDOC
2043   SPU Relocations.
2044
2045 ENUM
2046   BFD_RELOC_ALPHA_GPDISP_HI16
2047 ENUMDOC
2048   Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
2049      "addend" in some special way.
2050   For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
2051      writing; when reading, it will be the absolute section symbol.  The
2052      addend is the displacement in bytes of the "lda" instruction from
2053      the "ldah" instruction (which is at the address of this reloc).
2054 ENUM
2055   BFD_RELOC_ALPHA_GPDISP_LO16
2056 ENUMDOC
2057   For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
2058      with GPDISP_HI16 relocs.  The addend is ignored when writing the
2059      relocations out, and is filled in with the file's GP value on
2060      reading, for convenience.
2061
2062 ENUM
2063   BFD_RELOC_ALPHA_GPDISP
2064 ENUMDOC
2065   The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
2066      relocation except that there is no accompanying GPDISP_LO16
2067      relocation.
2068
2069 ENUM
2070   BFD_RELOC_ALPHA_LITERAL
2071 ENUMX
2072   BFD_RELOC_ALPHA_ELF_LITERAL
2073 ENUMX
2074   BFD_RELOC_ALPHA_LITUSE
2075 ENUMDOC
2076   The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
2077      the assembler turns it into a LDQ instruction to load the address of
2078      the symbol, and then fills in a register in the real instruction.
2079
2080      The LITERAL reloc, at the LDQ instruction, refers to the .lita
2081      section symbol.  The addend is ignored when writing, but is filled
2082      in with the file's GP value on reading, for convenience, as with the
2083      GPDISP_LO16 reloc.
2084
2085      The ELF_LITERAL reloc is somewhere between 16_GOTOFF and GPDISP_LO16.
2086      It should refer to the symbol to be referenced, as with 16_GOTOFF,
2087      but it generates output not based on the position within the .got
2088      section, but relative to the GP value chosen for the file during the
2089      final link stage.
2090
2091      The LITUSE reloc, on the instruction using the loaded address, gives
2092      information to the linker that it might be able to use to optimize
2093      away some literal section references.  The symbol is ignored (read
2094      as the absolute section symbol), and the "addend" indicates the type
2095      of instruction using the register:
2096               1 - "memory" fmt insn
2097               2 - byte-manipulation (byte offset reg)
2098               3 - jsr (target of branch)
2099
2100 ENUM
2101   BFD_RELOC_ALPHA_HINT
2102 ENUMDOC
2103   The HINT relocation indicates a value that should be filled into the
2104      "hint" field of a jmp/jsr/ret instruction, for possible branch-
2105      prediction logic which may be provided on some processors.
2106
2107 ENUM
2108   BFD_RELOC_ALPHA_LINKAGE
2109 ENUMDOC
2110   The LINKAGE relocation outputs a linkage pair in the object file,
2111      which is filled by the linker.
2112
2113 ENUM
2114   BFD_RELOC_ALPHA_CODEADDR
2115 ENUMDOC
2116   The CODEADDR relocation outputs a STO_CA in the object file,
2117      which is filled by the linker.
2118
2119 ENUM
2120   BFD_RELOC_ALPHA_GPREL_HI16
2121 ENUMX
2122   BFD_RELOC_ALPHA_GPREL_LO16
2123 ENUMDOC
2124   The GPREL_HI/LO relocations together form a 32-bit offset from the
2125      GP register.
2126
2127 ENUM
2128   BFD_RELOC_ALPHA_BRSGP
2129 ENUMDOC
2130   Like BFD_RELOC_23_PCREL_S2, except that the source and target must
2131   share a common GP, and the target address is adjusted for
2132   STO_ALPHA_STD_GPLOAD.
2133
2134 ENUM
2135   BFD_RELOC_ALPHA_NOP
2136 ENUMDOC
2137   The NOP relocation outputs a NOP if the longword displacement
2138      between two procedure entry points is < 2^21.
2139
2140 ENUM
2141   BFD_RELOC_ALPHA_BSR
2142 ENUMDOC
2143   The BSR relocation outputs a BSR if the longword displacement
2144      between two procedure entry points is < 2^21.
2145
2146 ENUM
2147   BFD_RELOC_ALPHA_LDA
2148 ENUMDOC
2149   The LDA relocation outputs a LDA if the longword displacement
2150      between two procedure entry points is < 2^16.
2151
2152 ENUM
2153   BFD_RELOC_ALPHA_BOH
2154 ENUMDOC
2155   The BOH relocation outputs a BSR if the longword displacement
2156      between two procedure entry points is < 2^21, or else a hint.
2157
2158 ENUM
2159   BFD_RELOC_ALPHA_TLSGD
2160 ENUMX
2161   BFD_RELOC_ALPHA_TLSLDM
2162 ENUMX
2163   BFD_RELOC_ALPHA_DTPMOD64
2164 ENUMX
2165   BFD_RELOC_ALPHA_GOTDTPREL16
2166 ENUMX
2167   BFD_RELOC_ALPHA_DTPREL64
2168 ENUMX
2169   BFD_RELOC_ALPHA_DTPREL_HI16
2170 ENUMX
2171   BFD_RELOC_ALPHA_DTPREL_LO16
2172 ENUMX
2173   BFD_RELOC_ALPHA_DTPREL16
2174 ENUMX
2175   BFD_RELOC_ALPHA_GOTTPREL16
2176 ENUMX
2177   BFD_RELOC_ALPHA_TPREL64
2178 ENUMX
2179   BFD_RELOC_ALPHA_TPREL_HI16
2180 ENUMX
2181   BFD_RELOC_ALPHA_TPREL_LO16
2182 ENUMX
2183   BFD_RELOC_ALPHA_TPREL16
2184 ENUMDOC
2185   Alpha thread-local storage relocations.
2186
2187 ENUM
2188   BFD_RELOC_MIPS_JMP
2189 ENUMX
2190   BFD_RELOC_MICROMIPS_JMP
2191 ENUMDOC
2192   The MIPS jump instruction.
2193
2194 ENUM
2195   BFD_RELOC_MIPS16_JMP
2196 ENUMDOC
2197   The MIPS16 jump instruction.
2198
2199 ENUM
2200   BFD_RELOC_MIPS16_GPREL
2201 ENUMDOC
2202   MIPS16 GP relative reloc.
2203
2204 ENUM
2205   BFD_RELOC_HI16
2206 ENUMDOC
2207   High 16 bits of 32-bit value; simple reloc.
2208
2209 ENUM
2210   BFD_RELOC_HI16_S
2211 ENUMDOC
2212   High 16 bits of 32-bit value but the low 16 bits will be sign
2213      extended and added to form the final result.  If the low 16
2214      bits form a negative number, we need to add one to the high value
2215      to compensate for the borrow when the low bits are added.
2216
2217 ENUM
2218   BFD_RELOC_LO16
2219 ENUMDOC
2220   Low 16 bits.
2221
2222 ENUM
2223   BFD_RELOC_HI16_PCREL
2224 ENUMDOC
2225   High 16 bits of 32-bit pc-relative value
2226 ENUM
2227   BFD_RELOC_HI16_S_PCREL
2228 ENUMDOC
2229   High 16 bits of 32-bit pc-relative value, adjusted
2230 ENUM
2231   BFD_RELOC_LO16_PCREL
2232 ENUMDOC
2233   Low 16 bits of pc-relative value
2234
2235 ENUM
2236   BFD_RELOC_MIPS16_GOT16
2237 ENUMX
2238   BFD_RELOC_MIPS16_CALL16
2239 ENUMDOC
2240   Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
2241      16-bit immediate fields
2242 ENUM
2243   BFD_RELOC_MIPS16_HI16
2244 ENUMDOC
2245   MIPS16 high 16 bits of 32-bit value.
2246 ENUM
2247   BFD_RELOC_MIPS16_HI16_S
2248 ENUMDOC
2249   MIPS16 high 16 bits of 32-bit value but the low 16 bits will be sign
2250      extended and added to form the final result.  If the low 16
2251      bits form a negative number, we need to add one to the high value
2252      to compensate for the borrow when the low bits are added.
2253 ENUM
2254   BFD_RELOC_MIPS16_LO16
2255 ENUMDOC
2256   MIPS16 low 16 bits.
2257
2258 ENUM
2259   BFD_RELOC_MIPS16_TLS_GD
2260 ENUMX
2261   BFD_RELOC_MIPS16_TLS_LDM
2262 ENUMX
2263   BFD_RELOC_MIPS16_TLS_DTPREL_HI16
2264 ENUMX
2265   BFD_RELOC_MIPS16_TLS_DTPREL_LO16
2266 ENUMX
2267   BFD_RELOC_MIPS16_TLS_GOTTPREL
2268 ENUMX
2269   BFD_RELOC_MIPS16_TLS_TPREL_HI16
2270 ENUMX
2271   BFD_RELOC_MIPS16_TLS_TPREL_LO16
2272 ENUMDOC
2273   MIPS16 TLS relocations
2274
2275 ENUM
2276   BFD_RELOC_MIPS_LITERAL
2277 ENUMX
2278   BFD_RELOC_MICROMIPS_LITERAL
2279 ENUMDOC
2280   Relocation against a MIPS literal section.
2281
2282 ENUM
2283   BFD_RELOC_MICROMIPS_7_PCREL_S1
2284 ENUMX
2285   BFD_RELOC_MICROMIPS_10_PCREL_S1
2286 ENUMX
2287   BFD_RELOC_MICROMIPS_16_PCREL_S1
2288 ENUMDOC
2289   microMIPS PC-relative relocations.
2290
2291 ENUM
2292   BFD_RELOC_MICROMIPS_GPREL16
2293 ENUMX
2294   BFD_RELOC_MICROMIPS_HI16
2295 ENUMX
2296   BFD_RELOC_MICROMIPS_HI16_S
2297 ENUMX
2298   BFD_RELOC_MICROMIPS_LO16
2299 ENUMDOC
2300   microMIPS versions of generic BFD relocs.
2301
2302 ENUM
2303   BFD_RELOC_MIPS_GOT16
2304 ENUMX
2305   BFD_RELOC_MICROMIPS_GOT16
2306 ENUMX
2307   BFD_RELOC_MIPS_CALL16
2308 ENUMX
2309   BFD_RELOC_MICROMIPS_CALL16
2310 ENUMX
2311   BFD_RELOC_MIPS_GOT_HI16
2312 ENUMX
2313   BFD_RELOC_MICROMIPS_GOT_HI16
2314 ENUMX
2315   BFD_RELOC_MIPS_GOT_LO16
2316 ENUMX
2317   BFD_RELOC_MICROMIPS_GOT_LO16
2318 ENUMX
2319   BFD_RELOC_MIPS_CALL_HI16
2320 ENUMX
2321   BFD_RELOC_MICROMIPS_CALL_HI16
2322 ENUMX
2323   BFD_RELOC_MIPS_CALL_LO16
2324 ENUMX
2325   BFD_RELOC_MICROMIPS_CALL_LO16
2326 ENUMX
2327   BFD_RELOC_MIPS_SUB
2328 ENUMX
2329   BFD_RELOC_MICROMIPS_SUB
2330 ENUMX
2331   BFD_RELOC_MIPS_GOT_PAGE
2332 ENUMX
2333   BFD_RELOC_MICROMIPS_GOT_PAGE
2334 ENUMX
2335   BFD_RELOC_MIPS_GOT_OFST
2336 ENUMX
2337   BFD_RELOC_MICROMIPS_GOT_OFST
2338 ENUMX
2339   BFD_RELOC_MIPS_GOT_DISP
2340 ENUMX
2341   BFD_RELOC_MICROMIPS_GOT_DISP
2342 ENUMX
2343   BFD_RELOC_MIPS_SHIFT5
2344 ENUMX
2345   BFD_RELOC_MIPS_SHIFT6
2346 ENUMX
2347   BFD_RELOC_MIPS_INSERT_A
2348 ENUMX
2349   BFD_RELOC_MIPS_INSERT_B
2350 ENUMX
2351   BFD_RELOC_MIPS_DELETE
2352 ENUMX
2353   BFD_RELOC_MIPS_HIGHEST
2354 ENUMX
2355   BFD_RELOC_MICROMIPS_HIGHEST
2356 ENUMX
2357   BFD_RELOC_MIPS_HIGHER
2358 ENUMX
2359   BFD_RELOC_MICROMIPS_HIGHER
2360 ENUMX
2361   BFD_RELOC_MIPS_SCN_DISP
2362 ENUMX
2363   BFD_RELOC_MICROMIPS_SCN_DISP
2364 ENUMX
2365   BFD_RELOC_MIPS_REL16
2366 ENUMX
2367   BFD_RELOC_MIPS_RELGOT
2368 ENUMX
2369   BFD_RELOC_MIPS_JALR
2370 ENUMX
2371   BFD_RELOC_MICROMIPS_JALR
2372 ENUMX
2373   BFD_RELOC_MIPS_TLS_DTPMOD32
2374 ENUMX
2375   BFD_RELOC_MIPS_TLS_DTPREL32
2376 ENUMX
2377   BFD_RELOC_MIPS_TLS_DTPMOD64
2378 ENUMX
2379   BFD_RELOC_MIPS_TLS_DTPREL64
2380 ENUMX
2381   BFD_RELOC_MIPS_TLS_GD
2382 ENUMX
2383   BFD_RELOC_MICROMIPS_TLS_GD
2384 ENUMX
2385   BFD_RELOC_MIPS_TLS_LDM
2386 ENUMX
2387   BFD_RELOC_MICROMIPS_TLS_LDM
2388 ENUMX
2389   BFD_RELOC_MIPS_TLS_DTPREL_HI16
2390 ENUMX
2391   BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16
2392 ENUMX
2393   BFD_RELOC_MIPS_TLS_DTPREL_LO16
2394 ENUMX
2395   BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16
2396 ENUMX
2397   BFD_RELOC_MIPS_TLS_GOTTPREL
2398 ENUMX
2399   BFD_RELOC_MICROMIPS_TLS_GOTTPREL
2400 ENUMX
2401   BFD_RELOC_MIPS_TLS_TPREL32
2402 ENUMX
2403   BFD_RELOC_MIPS_TLS_TPREL64
2404 ENUMX
2405   BFD_RELOC_MIPS_TLS_TPREL_HI16
2406 ENUMX
2407   BFD_RELOC_MICROMIPS_TLS_TPREL_HI16
2408 ENUMX
2409   BFD_RELOC_MIPS_TLS_TPREL_LO16
2410 ENUMX
2411   BFD_RELOC_MICROMIPS_TLS_TPREL_LO16
2412 ENUMDOC
2413   MIPS ELF relocations.
2414 COMMENT
2415
2416 ENUM
2417   BFD_RELOC_MIPS_COPY
2418 ENUMX
2419   BFD_RELOC_MIPS_JUMP_SLOT
2420 ENUMDOC
2421   MIPS ELF relocations (VxWorks and PLT extensions).
2422 COMMENT
2423
2424 ENUM
2425   BFD_RELOC_MOXIE_10_PCREL
2426 ENUMDOC
2427   Moxie ELF relocations.
2428 COMMENT
2429
2430 ENUM
2431   BFD_RELOC_FRV_LABEL16
2432 ENUMX
2433   BFD_RELOC_FRV_LABEL24
2434 ENUMX
2435   BFD_RELOC_FRV_LO16
2436 ENUMX
2437   BFD_RELOC_FRV_HI16
2438 ENUMX
2439   BFD_RELOC_FRV_GPREL12
2440 ENUMX
2441   BFD_RELOC_FRV_GPRELU12
2442 ENUMX
2443   BFD_RELOC_FRV_GPREL32
2444 ENUMX
2445   BFD_RELOC_FRV_GPRELHI
2446 ENUMX
2447   BFD_RELOC_FRV_GPRELLO
2448 ENUMX
2449   BFD_RELOC_FRV_GOT12
2450 ENUMX
2451   BFD_RELOC_FRV_GOTHI
2452 ENUMX
2453   BFD_RELOC_FRV_GOTLO
2454 ENUMX
2455   BFD_RELOC_FRV_FUNCDESC
2456 ENUMX
2457   BFD_RELOC_FRV_FUNCDESC_GOT12
2458 ENUMX
2459   BFD_RELOC_FRV_FUNCDESC_GOTHI
2460 ENUMX
2461   BFD_RELOC_FRV_FUNCDESC_GOTLO
2462 ENUMX
2463   BFD_RELOC_FRV_FUNCDESC_VALUE
2464 ENUMX
2465   BFD_RELOC_FRV_FUNCDESC_GOTOFF12
2466 ENUMX
2467   BFD_RELOC_FRV_FUNCDESC_GOTOFFHI
2468 ENUMX
2469   BFD_RELOC_FRV_FUNCDESC_GOTOFFLO
2470 ENUMX
2471   BFD_RELOC_FRV_GOTOFF12
2472 ENUMX
2473   BFD_RELOC_FRV_GOTOFFHI
2474 ENUMX
2475   BFD_RELOC_FRV_GOTOFFLO
2476 ENUMX
2477   BFD_RELOC_FRV_GETTLSOFF
2478 ENUMX
2479   BFD_RELOC_FRV_TLSDESC_VALUE
2480 ENUMX
2481   BFD_RELOC_FRV_GOTTLSDESC12
2482 ENUMX
2483   BFD_RELOC_FRV_GOTTLSDESCHI
2484 ENUMX
2485   BFD_RELOC_FRV_GOTTLSDESCLO
2486 ENUMX
2487   BFD_RELOC_FRV_TLSMOFF12
2488 ENUMX
2489   BFD_RELOC_FRV_TLSMOFFHI
2490 ENUMX
2491   BFD_RELOC_FRV_TLSMOFFLO
2492 ENUMX
2493   BFD_RELOC_FRV_GOTTLSOFF12
2494 ENUMX
2495   BFD_RELOC_FRV_GOTTLSOFFHI
2496 ENUMX
2497   BFD_RELOC_FRV_GOTTLSOFFLO
2498 ENUMX
2499   BFD_RELOC_FRV_TLSOFF
2500 ENUMX
2501   BFD_RELOC_FRV_TLSDESC_RELAX
2502 ENUMX
2503   BFD_RELOC_FRV_GETTLSOFF_RELAX
2504 ENUMX
2505   BFD_RELOC_FRV_TLSOFF_RELAX
2506 ENUMX
2507   BFD_RELOC_FRV_TLSMOFF
2508 ENUMDOC
2509   Fujitsu Frv Relocations.
2510 COMMENT
2511
2512 ENUM
2513   BFD_RELOC_MN10300_GOTOFF24
2514 ENUMDOC
2515   This is a 24bit GOT-relative reloc for the mn10300.
2516 ENUM
2517   BFD_RELOC_MN10300_GOT32
2518 ENUMDOC
2519   This is a 32bit GOT-relative reloc for the mn10300, offset by two bytes
2520   in the instruction.
2521 ENUM
2522   BFD_RELOC_MN10300_GOT24
2523 ENUMDOC
2524   This is a 24bit GOT-relative reloc for the mn10300, offset by two bytes
2525   in the instruction.
2526 ENUM
2527   BFD_RELOC_MN10300_GOT16
2528 ENUMDOC
2529   This is a 16bit GOT-relative reloc for the mn10300, offset by two bytes
2530   in the instruction.
2531 ENUM
2532   BFD_RELOC_MN10300_COPY
2533 ENUMDOC
2534   Copy symbol at runtime.
2535 ENUM
2536   BFD_RELOC_MN10300_GLOB_DAT
2537 ENUMDOC
2538   Create GOT entry.
2539 ENUM
2540   BFD_RELOC_MN10300_JMP_SLOT
2541 ENUMDOC
2542   Create PLT entry.
2543 ENUM
2544   BFD_RELOC_MN10300_RELATIVE
2545 ENUMDOC
2546   Adjust by program base.
2547 ENUM
2548   BFD_RELOC_MN10300_SYM_DIFF
2549 ENUMDOC
2550   Together with another reloc targeted at the same location,
2551   allows for a value that is the difference of two symbols
2552   in the same section.
2553 ENUM
2554   BFD_RELOC_MN10300_ALIGN
2555 ENUMDOC
2556   The addend of this reloc is an alignment power that must
2557   be honoured at the offset's location, regardless of linker
2558   relaxation.
2559 ENUM
2560   BFD_RELOC_MN10300_TLS_GD
2561 ENUMX
2562   BFD_RELOC_MN10300_TLS_LD
2563 ENUMX
2564   BFD_RELOC_MN10300_TLS_LDO
2565 ENUMX
2566   BFD_RELOC_MN10300_TLS_GOTIE
2567 ENUMX
2568   BFD_RELOC_MN10300_TLS_IE
2569 ENUMX
2570   BFD_RELOC_MN10300_TLS_LE
2571 ENUMX
2572   BFD_RELOC_MN10300_TLS_DTPMOD
2573 ENUMX
2574   BFD_RELOC_MN10300_TLS_DTPOFF
2575 ENUMX
2576   BFD_RELOC_MN10300_TLS_TPOFF
2577 ENUMDOC
2578   Various TLS-related relocations.
2579 ENUM
2580   BFD_RELOC_MN10300_32_PCREL
2581 ENUMDOC
2582   This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the
2583   instruction.
2584 ENUM
2585   BFD_RELOC_MN10300_16_PCREL
2586 ENUMDOC
2587   This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the
2588   instruction.
2589 COMMENT
2590
2591 ENUM
2592   BFD_RELOC_386_GOT32
2593 ENUMX
2594   BFD_RELOC_386_PLT32
2595 ENUMX
2596   BFD_RELOC_386_COPY
2597 ENUMX
2598   BFD_RELOC_386_GLOB_DAT
2599 ENUMX
2600   BFD_RELOC_386_JUMP_SLOT
2601 ENUMX
2602   BFD_RELOC_386_RELATIVE
2603 ENUMX
2604   BFD_RELOC_386_GOTOFF
2605 ENUMX
2606   BFD_RELOC_386_GOTPC
2607 ENUMX
2608   BFD_RELOC_386_TLS_TPOFF
2609 ENUMX
2610   BFD_RELOC_386_TLS_IE
2611 ENUMX
2612   BFD_RELOC_386_TLS_GOTIE
2613 ENUMX
2614   BFD_RELOC_386_TLS_LE
2615 ENUMX
2616   BFD_RELOC_386_TLS_GD
2617 ENUMX
2618   BFD_RELOC_386_TLS_LDM
2619 ENUMX
2620   BFD_RELOC_386_TLS_LDO_32
2621 ENUMX
2622   BFD_RELOC_386_TLS_IE_32
2623 ENUMX
2624   BFD_RELOC_386_TLS_LE_32
2625 ENUMX
2626   BFD_RELOC_386_TLS_DTPMOD32
2627 ENUMX
2628   BFD_RELOC_386_TLS_DTPOFF32
2629 ENUMX
2630   BFD_RELOC_386_TLS_TPOFF32
2631 ENUMX
2632   BFD_RELOC_386_TLS_GOTDESC
2633 ENUMX
2634   BFD_RELOC_386_TLS_DESC_CALL
2635 ENUMX
2636   BFD_RELOC_386_TLS_DESC
2637 ENUMX
2638   BFD_RELOC_386_IRELATIVE
2639 ENUMDOC
2640   i386/elf relocations
2641
2642 ENUM
2643   BFD_RELOC_X86_64_GOT32
2644 ENUMX
2645   BFD_RELOC_X86_64_PLT32
2646 ENUMX
2647   BFD_RELOC_X86_64_COPY
2648 ENUMX
2649   BFD_RELOC_X86_64_GLOB_DAT
2650 ENUMX
2651   BFD_RELOC_X86_64_JUMP_SLOT
2652 ENUMX
2653   BFD_RELOC_X86_64_RELATIVE
2654 ENUMX
2655   BFD_RELOC_X86_64_GOTPCREL
2656 ENUMX
2657   BFD_RELOC_X86_64_32S
2658 ENUMX
2659   BFD_RELOC_X86_64_DTPMOD64
2660 ENUMX
2661   BFD_RELOC_X86_64_DTPOFF64
2662 ENUMX
2663   BFD_RELOC_X86_64_TPOFF64
2664 ENUMX
2665   BFD_RELOC_X86_64_TLSGD
2666 ENUMX
2667   BFD_RELOC_X86_64_TLSLD
2668 ENUMX
2669   BFD_RELOC_X86_64_DTPOFF32
2670 ENUMX
2671   BFD_RELOC_X86_64_GOTTPOFF
2672 ENUMX
2673   BFD_RELOC_X86_64_TPOFF32
2674 ENUMX
2675   BFD_RELOC_X86_64_GOTOFF64
2676 ENUMX
2677   BFD_RELOC_X86_64_GOTPC32
2678 ENUMX
2679   BFD_RELOC_X86_64_GOT64
2680 ENUMX
2681   BFD_RELOC_X86_64_GOTPCREL64
2682 ENUMX
2683   BFD_RELOC_X86_64_GOTPC64
2684 ENUMX
2685   BFD_RELOC_X86_64_GOTPLT64
2686 ENUMX
2687   BFD_RELOC_X86_64_PLTOFF64
2688 ENUMX
2689   BFD_RELOC_X86_64_GOTPC32_TLSDESC
2690 ENUMX
2691   BFD_RELOC_X86_64_TLSDESC_CALL
2692 ENUMX
2693   BFD_RELOC_X86_64_TLSDESC
2694 ENUMX
2695   BFD_RELOC_X86_64_IRELATIVE
2696 ENUMDOC
2697   x86-64/elf relocations
2698
2699 ENUM
2700   BFD_RELOC_NS32K_IMM_8
2701 ENUMX
2702   BFD_RELOC_NS32K_IMM_16
2703 ENUMX
2704   BFD_RELOC_NS32K_IMM_32
2705 ENUMX
2706   BFD_RELOC_NS32K_IMM_8_PCREL
2707 ENUMX
2708   BFD_RELOC_NS32K_IMM_16_PCREL
2709 ENUMX
2710   BFD_RELOC_NS32K_IMM_32_PCREL
2711 ENUMX
2712   BFD_RELOC_NS32K_DISP_8
2713 ENUMX
2714   BFD_RELOC_NS32K_DISP_16
2715 ENUMX
2716   BFD_RELOC_NS32K_DISP_32
2717 ENUMX
2718   BFD_RELOC_NS32K_DISP_8_PCREL
2719 ENUMX
2720   BFD_RELOC_NS32K_DISP_16_PCREL
2721 ENUMX
2722   BFD_RELOC_NS32K_DISP_32_PCREL
2723 ENUMDOC
2724   ns32k relocations
2725
2726 ENUM
2727   BFD_RELOC_PDP11_DISP_8_PCREL
2728 ENUMX
2729   BFD_RELOC_PDP11_DISP_6_PCREL
2730 ENUMDOC
2731   PDP11 relocations
2732
2733 ENUM
2734   BFD_RELOC_PJ_CODE_HI16
2735 ENUMX
2736   BFD_RELOC_PJ_CODE_LO16
2737 ENUMX
2738   BFD_RELOC_PJ_CODE_DIR16
2739 ENUMX
2740   BFD_RELOC_PJ_CODE_DIR32
2741 ENUMX
2742   BFD_RELOC_PJ_CODE_REL16
2743 ENUMX
2744   BFD_RELOC_PJ_CODE_REL32
2745 ENUMDOC
2746   Picojava relocs.  Not all of these appear in object files.
2747
2748 ENUM
2749   BFD_RELOC_PPC_B26
2750 ENUMX
2751   BFD_RELOC_PPC_BA26
2752 ENUMX
2753   BFD_RELOC_PPC_TOC16
2754 ENUMX
2755   BFD_RELOC_PPC_B16
2756 ENUMX
2757   BFD_RELOC_PPC_B16_BRTAKEN
2758 ENUMX
2759   BFD_RELOC_PPC_B16_BRNTAKEN
2760 ENUMX
2761   BFD_RELOC_PPC_BA16
2762 ENUMX
2763   BFD_RELOC_PPC_BA16_BRTAKEN
2764 ENUMX
2765   BFD_RELOC_PPC_BA16_BRNTAKEN
2766 ENUMX
2767   BFD_RELOC_PPC_COPY
2768 ENUMX
2769   BFD_RELOC_PPC_GLOB_DAT
2770 ENUMX
2771   BFD_RELOC_PPC_JMP_SLOT
2772 ENUMX
2773   BFD_RELOC_PPC_RELATIVE
2774 ENUMX
2775   BFD_RELOC_PPC_LOCAL24PC
2776 ENUMX
2777   BFD_RELOC_PPC_EMB_NADDR32
2778 ENUMX
2779   BFD_RELOC_PPC_EMB_NADDR16
2780 ENUMX
2781   BFD_RELOC_PPC_EMB_NADDR16_LO
2782 ENUMX
2783   BFD_RELOC_PPC_EMB_NADDR16_HI
2784 ENUMX
2785   BFD_RELOC_PPC_EMB_NADDR16_HA
2786 ENUMX
2787   BFD_RELOC_PPC_EMB_SDAI16
2788 ENUMX
2789   BFD_RELOC_PPC_EMB_SDA2I16
2790 ENUMX
2791   BFD_RELOC_PPC_EMB_SDA2REL
2792 ENUMX
2793   BFD_RELOC_PPC_EMB_SDA21
2794 ENUMX
2795   BFD_RELOC_PPC_EMB_MRKREF
2796 ENUMX
2797   BFD_RELOC_PPC_EMB_RELSEC16
2798 ENUMX
2799   BFD_RELOC_PPC_EMB_RELST_LO
2800 ENUMX
2801   BFD_RELOC_PPC_EMB_RELST_HI
2802 ENUMX
2803   BFD_RELOC_PPC_EMB_RELST_HA
2804 ENUMX
2805   BFD_RELOC_PPC_EMB_BIT_FLD
2806 ENUMX
2807   BFD_RELOC_PPC_EMB_RELSDA
2808 ENUMX
2809   BFD_RELOC_PPC64_HIGHER
2810 ENUMX
2811   BFD_RELOC_PPC64_HIGHER_S
2812 ENUMX
2813   BFD_RELOC_PPC64_HIGHEST
2814 ENUMX
2815   BFD_RELOC_PPC64_HIGHEST_S
2816 ENUMX
2817   BFD_RELOC_PPC64_TOC16_LO
2818 ENUMX
2819   BFD_RELOC_PPC64_TOC16_HI
2820 ENUMX
2821   BFD_RELOC_PPC64_TOC16_HA
2822 ENUMX
2823   BFD_RELOC_PPC64_TOC
2824 ENUMX
2825   BFD_RELOC_PPC64_PLTGOT16
2826 ENUMX
2827   BFD_RELOC_PPC64_PLTGOT16_LO
2828 ENUMX
2829   BFD_RELOC_PPC64_PLTGOT16_HI
2830 ENUMX
2831   BFD_RELOC_PPC64_PLTGOT16_HA
2832 ENUMX
2833   BFD_RELOC_PPC64_ADDR16_DS
2834 ENUMX
2835   BFD_RELOC_PPC64_ADDR16_LO_DS
2836 ENUMX
2837   BFD_RELOC_PPC64_GOT16_DS
2838 ENUMX
2839   BFD_RELOC_PPC64_GOT16_LO_DS
2840 ENUMX
2841   BFD_RELOC_PPC64_PLT16_LO_DS
2842 ENUMX
2843   BFD_RELOC_PPC64_SECTOFF_DS
2844 ENUMX
2845   BFD_RELOC_PPC64_SECTOFF_LO_DS
2846 ENUMX
2847   BFD_RELOC_PPC64_TOC16_DS
2848 ENUMX
2849   BFD_RELOC_PPC64_TOC16_LO_DS
2850 ENUMX
2851   BFD_RELOC_PPC64_PLTGOT16_DS
2852 ENUMX
2853   BFD_RELOC_PPC64_PLTGOT16_LO_DS
2854 ENUMDOC
2855   Power(rs6000) and PowerPC relocations.
2856
2857 ENUM
2858   BFD_RELOC_PPC_TLS
2859 ENUMX
2860   BFD_RELOC_PPC_TLSGD
2861 ENUMX
2862   BFD_RELOC_PPC_TLSLD
2863 ENUMX
2864   BFD_RELOC_PPC_DTPMOD
2865 ENUMX
2866   BFD_RELOC_PPC_TPREL16
2867 ENUMX
2868   BFD_RELOC_PPC_TPREL16_LO
2869 ENUMX
2870   BFD_RELOC_PPC_TPREL16_HI
2871 ENUMX
2872   BFD_RELOC_PPC_TPREL16_HA
2873 ENUMX
2874   BFD_RELOC_PPC_TPREL
2875 ENUMX
2876   BFD_RELOC_PPC_DTPREL16
2877 ENUMX
2878   BFD_RELOC_PPC_DTPREL16_LO
2879 ENUMX
2880   BFD_RELOC_PPC_DTPREL16_HI
2881 ENUMX
2882   BFD_RELOC_PPC_DTPREL16_HA
2883 ENUMX
2884   BFD_RELOC_PPC_DTPREL
2885 ENUMX
2886   BFD_RELOC_PPC_GOT_TLSGD16
2887 ENUMX
2888   BFD_RELOC_PPC_GOT_TLSGD16_LO
2889 ENUMX
2890   BFD_RELOC_PPC_GOT_TLSGD16_HI
2891 ENUMX
2892   BFD_RELOC_PPC_GOT_TLSGD16_HA
2893 ENUMX
2894   BFD_RELOC_PPC_GOT_TLSLD16
2895 ENUMX
2896   BFD_RELOC_PPC_GOT_TLSLD16_LO
2897 ENUMX
2898   BFD_RELOC_PPC_GOT_TLSLD16_HI
2899 ENUMX
2900   BFD_RELOC_PPC_GOT_TLSLD16_HA
2901 ENUMX
2902   BFD_RELOC_PPC_GOT_TPREL16
2903 ENUMX
2904   BFD_RELOC_PPC_GOT_TPREL16_LO
2905 ENUMX
2906   BFD_RELOC_PPC_GOT_TPREL16_HI
2907 ENUMX
2908   BFD_RELOC_PPC_GOT_TPREL16_HA
2909 ENUMX
2910   BFD_RELOC_PPC_GOT_DTPREL16
2911 ENUMX
2912   BFD_RELOC_PPC_GOT_DTPREL16_LO
2913 ENUMX
2914   BFD_RELOC_PPC_GOT_DTPREL16_HI
2915 ENUMX
2916   BFD_RELOC_PPC_GOT_DTPREL16_HA
2917 ENUMX
2918   BFD_RELOC_PPC64_TPREL16_DS
2919 ENUMX
2920   BFD_RELOC_PPC64_TPREL16_LO_DS
2921 ENUMX
2922   BFD_RELOC_PPC64_TPREL16_HIGHER
2923 ENUMX
2924   BFD_RELOC_PPC64_TPREL16_HIGHERA
2925 ENUMX
2926   BFD_RELOC_PPC64_TPREL16_HIGHEST
2927 ENUMX
2928   BFD_RELOC_PPC64_TPREL16_HIGHESTA
2929 ENUMX
2930   BFD_RELOC_PPC64_DTPREL16_DS
2931 ENUMX
2932   BFD_RELOC_PPC64_DTPREL16_LO_DS
2933 ENUMX
2934   BFD_RELOC_PPC64_DTPREL16_HIGHER
2935 ENUMX
2936   BFD_RELOC_PPC64_DTPREL16_HIGHERA
2937 ENUMX
2938   BFD_RELOC_PPC64_DTPREL16_HIGHEST
2939 ENUMX
2940   BFD_RELOC_PPC64_DTPREL16_HIGHESTA
2941 ENUMDOC
2942   PowerPC and PowerPC64 thread-local storage relocations.
2943
2944 ENUM
2945   BFD_RELOC_I370_D12
2946 ENUMDOC
2947   IBM 370/390 relocations
2948
2949 ENUM
2950   BFD_RELOC_CTOR
2951 ENUMDOC
2952   The type of reloc used to build a constructor table - at the moment
2953   probably a 32 bit wide absolute relocation, but the target can choose.
2954   It generally does map to one of the other relocation types.
2955
2956 ENUM
2957   BFD_RELOC_ARM_PCREL_BRANCH
2958 ENUMDOC
2959   ARM 26 bit pc-relative branch.  The lowest two bits must be zero and are
2960   not stored in the instruction.
2961 ENUM
2962   BFD_RELOC_ARM_PCREL_BLX
2963 ENUMDOC
2964   ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
2965   not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2966   field in the instruction.
2967 ENUM
2968   BFD_RELOC_THUMB_PCREL_BLX
2969 ENUMDOC
2970   Thumb 22 bit pc-relative branch.  The lowest bit must be zero and is
2971   not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2972   field in the instruction.
2973 ENUM
2974   BFD_RELOC_ARM_PCREL_CALL
2975 ENUMDOC
2976   ARM 26-bit pc-relative branch for an unconditional BL or BLX instruction.
2977 ENUM
2978   BFD_RELOC_ARM_PCREL_JUMP
2979 ENUMDOC
2980   ARM 26-bit pc-relative branch for B or conditional BL instruction.
2981
2982 ENUM
2983   BFD_RELOC_THUMB_PCREL_BRANCH7
2984 ENUMX
2985   BFD_RELOC_THUMB_PCREL_BRANCH9
2986 ENUMX
2987   BFD_RELOC_THUMB_PCREL_BRANCH12
2988 ENUMX
2989   BFD_RELOC_THUMB_PCREL_BRANCH20
2990 ENUMX
2991   BFD_RELOC_THUMB_PCREL_BRANCH23
2992 ENUMX
2993   BFD_RELOC_THUMB_PCREL_BRANCH25
2994 ENUMDOC
2995   Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.
2996   The lowest bit must be zero and is not stored in the instruction.
2997   Note that the corresponding ELF R_ARM_THM_JUMPnn constant has an
2998   "nn" one smaller in all cases.  Note further that BRANCH23
2999   corresponds to R_ARM_THM_CALL.
3000
3001 ENUM
3002   BFD_RELOC_ARM_OFFSET_IMM
3003 ENUMDOC
3004   12-bit immediate offset, used in ARM-format ldr and str instructions.
3005
3006 ENUM
3007   BFD_RELOC_ARM_THUMB_OFFSET
3008 ENUMDOC
3009   5-bit immediate offset, used in Thumb-format ldr and str instructions.
3010
3011 ENUM
3012   BFD_RELOC_ARM_TARGET1
3013 ENUMDOC
3014   Pc-relative or absolute relocation depending on target.  Used for
3015   entries in .init_array sections.
3016 ENUM
3017   BFD_RELOC_ARM_ROSEGREL32
3018 ENUMDOC
3019   Read-only segment base relative address.
3020 ENUM
3021   BFD_RELOC_ARM_SBREL32
3022 ENUMDOC
3023   Data segment base relative address.
3024 ENUM
3025   BFD_RELOC_ARM_TARGET2
3026 ENUMDOC
3027   This reloc is used for references to RTTI data from exception handling
3028   tables.  The actual definition depends on the target.  It may be a
3029   pc-relative or some form of GOT-indirect relocation.
3030 ENUM
3031   BFD_RELOC_ARM_PREL31
3032 ENUMDOC
3033   31-bit PC relative address.
3034 ENUM
3035   BFD_RELOC_ARM_MOVW
3036 ENUMX
3037   BFD_RELOC_ARM_MOVT
3038 ENUMX
3039   BFD_RELOC_ARM_MOVW_PCREL
3040 ENUMX
3041   BFD_RELOC_ARM_MOVT_PCREL
3042 ENUMX
3043   BFD_RELOC_ARM_THUMB_MOVW
3044 ENUMX
3045   BFD_RELOC_ARM_THUMB_MOVT
3046 ENUMX
3047   BFD_RELOC_ARM_THUMB_MOVW_PCREL
3048 ENUMX
3049   BFD_RELOC_ARM_THUMB_MOVT_PCREL
3050 ENUMDOC
3051   Low and High halfword relocations for MOVW and MOVT instructions.
3052
3053 ENUM
3054   BFD_RELOC_ARM_JUMP_SLOT
3055 ENUMX
3056   BFD_RELOC_ARM_GLOB_DAT
3057 ENUMX
3058   BFD_RELOC_ARM_GOT32
3059 ENUMX
3060   BFD_RELOC_ARM_PLT32
3061 ENUMX
3062   BFD_RELOC_ARM_RELATIVE
3063 ENUMX
3064   BFD_RELOC_ARM_GOTOFF
3065 ENUMX
3066   BFD_RELOC_ARM_GOTPC
3067 ENUMX
3068   BFD_RELOC_ARM_GOT_PREL
3069 ENUMDOC
3070   Relocations for setting up GOTs and PLTs for shared libraries.
3071
3072 ENUM
3073   BFD_RELOC_ARM_TLS_GD32
3074 ENUMX
3075   BFD_RELOC_ARM_TLS_LDO32
3076 ENUMX
3077   BFD_RELOC_ARM_TLS_LDM32
3078 ENUMX
3079   BFD_RELOC_ARM_TLS_DTPOFF32
3080 ENUMX
3081   BFD_RELOC_ARM_TLS_DTPMOD32
3082 ENUMX
3083   BFD_RELOC_ARM_TLS_TPOFF32
3084 ENUMX
3085   BFD_RELOC_ARM_TLS_IE32
3086 ENUMX
3087   BFD_RELOC_ARM_TLS_LE32
3088 ENUMX
3089   BFD_RELOC_ARM_TLS_GOTDESC
3090 ENUMX
3091   BFD_RELOC_ARM_TLS_CALL
3092 ENUMX
3093   BFD_RELOC_ARM_THM_TLS_CALL
3094 ENUMX
3095   BFD_RELOC_ARM_TLS_DESCSEQ
3096 ENUMX
3097   BFD_RELOC_ARM_THM_TLS_DESCSEQ
3098 ENUMX
3099   BFD_RELOC_ARM_TLS_DESC
3100 ENUMDOC
3101   ARM thread-local storage relocations.
3102
3103 ENUM
3104   BFD_RELOC_ARM_ALU_PC_G0_NC
3105 ENUMX
3106   BFD_RELOC_ARM_ALU_PC_G0
3107 ENUMX
3108   BFD_RELOC_ARM_ALU_PC_G1_NC
3109 ENUMX
3110   BFD_RELOC_ARM_ALU_PC_G1
3111 ENUMX
3112   BFD_RELOC_ARM_ALU_PC_G2
3113 ENUMX
3114   BFD_RELOC_ARM_LDR_PC_G0
3115 ENUMX
3116   BFD_RELOC_ARM_LDR_PC_G1
3117 ENUMX
3118   BFD_RELOC_ARM_LDR_PC_G2
3119 ENUMX
3120   BFD_RELOC_ARM_LDRS_PC_G0
3121 ENUMX
3122   BFD_RELOC_ARM_LDRS_PC_G1
3123 ENUMX
3124   BFD_RELOC_ARM_LDRS_PC_G2
3125 ENUMX
3126   BFD_RELOC_ARM_LDC_PC_G0
3127 ENUMX
3128   BFD_RELOC_ARM_LDC_PC_G1
3129 ENUMX
3130   BFD_RELOC_ARM_LDC_PC_G2
3131 ENUMX
3132   BFD_RELOC_ARM_ALU_SB_G0_NC
3133 ENUMX
3134   BFD_RELOC_ARM_ALU_SB_G0
3135 ENUMX
3136   BFD_RELOC_ARM_ALU_SB_G1_NC
3137 ENUMX
3138   BFD_RELOC_ARM_ALU_SB_G1
3139 ENUMX
3140   BFD_RELOC_ARM_ALU_SB_G2
3141 ENUMX
3142   BFD_RELOC_ARM_LDR_SB_G0
3143 ENUMX
3144   BFD_RELOC_ARM_LDR_SB_G1
3145 ENUMX
3146   BFD_RELOC_ARM_LDR_SB_G2
3147 ENUMX
3148   BFD_RELOC_ARM_LDRS_SB_G0
3149 ENUMX
3150   BFD_RELOC_ARM_LDRS_SB_G1
3151 ENUMX
3152   BFD_RELOC_ARM_LDRS_SB_G2
3153 ENUMX
3154   BFD_RELOC_ARM_LDC_SB_G0
3155 ENUMX
3156   BFD_RELOC_ARM_LDC_SB_G1
3157 ENUMX
3158   BFD_RELOC_ARM_LDC_SB_G2
3159 ENUMDOC
3160   ARM group relocations.
3161
3162 ENUM
3163   BFD_RELOC_ARM_V4BX
3164 ENUMDOC
3165   Annotation of BX instructions.
3166
3167 ENUM
3168   BFD_RELOC_ARM_IRELATIVE
3169 ENUMDOC
3170   ARM support for STT_GNU_IFUNC.
3171
3172 ENUM
3173   BFD_RELOC_ARM_IMMEDIATE
3174 ENUMX
3175   BFD_RELOC_ARM_ADRL_IMMEDIATE
3176 ENUMX
3177   BFD_RELOC_ARM_T32_IMMEDIATE
3178 ENUMX
3179   BFD_RELOC_ARM_T32_ADD_IMM
3180 ENUMX
3181   BFD_RELOC_ARM_T32_IMM12
3182 ENUMX
3183   BFD_RELOC_ARM_T32_ADD_PC12
3184 ENUMX
3185   BFD_RELOC_ARM_SHIFT_IMM
3186 ENUMX
3187   BFD_RELOC_ARM_SMC
3188 ENUMX
3189   BFD_RELOC_ARM_HVC
3190 ENUMX
3191   BFD_RELOC_ARM_SWI
3192 ENUMX
3193   BFD_RELOC_ARM_MULTI
3194 ENUMX
3195   BFD_RELOC_ARM_CP_OFF_IMM
3196 ENUMX
3197   BFD_RELOC_ARM_CP_OFF_IMM_S2
3198 ENUMX
3199   BFD_RELOC_ARM_T32_CP_OFF_IMM
3200 ENUMX
3201   BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
3202 ENUMX
3203   BFD_RELOC_ARM_ADR_IMM
3204 ENUMX
3205   BFD_RELOC_ARM_LDR_IMM
3206 ENUMX
3207   BFD_RELOC_ARM_LITERAL
3208 ENUMX
3209   BFD_RELOC_ARM_IN_POOL
3210 ENUMX
3211   BFD_RELOC_ARM_OFFSET_IMM8
3212 ENUMX
3213   BFD_RELOC_ARM_T32_OFFSET_U8
3214 ENUMX
3215   BFD_RELOC_ARM_T32_OFFSET_IMM
3216 ENUMX
3217   BFD_RELOC_ARM_HWLITERAL
3218 ENUMX
3219   BFD_RELOC_ARM_THUMB_ADD
3220 ENUMX
3221   BFD_RELOC_ARM_THUMB_IMM
3222 ENUMX
3223   BFD_RELOC_ARM_THUMB_SHIFT
3224 ENUMDOC
3225   These relocs are only used within the ARM assembler.  They are not
3226   (at present) written to any object files.
3227
3228 ENUM
3229   BFD_RELOC_SH_PCDISP8BY2
3230 ENUMX
3231   BFD_RELOC_SH_PCDISP12BY2
3232 ENUMX
3233   BFD_RELOC_SH_IMM3
3234 ENUMX
3235   BFD_RELOC_SH_IMM3U
3236 ENUMX
3237   BFD_RELOC_SH_DISP12
3238 ENUMX
3239   BFD_RELOC_SH_DISP12BY2
3240 ENUMX
3241   BFD_RELOC_SH_DISP12BY4
3242 ENUMX
3243   BFD_RELOC_SH_DISP12BY8
3244 ENUMX
3245   BFD_RELOC_SH_DISP20
3246 ENUMX
3247   BFD_RELOC_SH_DISP20BY8
3248 ENUMX
3249   BFD_RELOC_SH_IMM4
3250 ENUMX
3251   BFD_RELOC_SH_IMM4BY2
3252 ENUMX
3253   BFD_RELOC_SH_IMM4BY4
3254 ENUMX
3255   BFD_RELOC_SH_IMM8
3256 ENUMX
3257   BFD_RELOC_SH_IMM8BY2
3258 ENUMX
3259   BFD_RELOC_SH_IMM8BY4
3260 ENUMX
3261   BFD_RELOC_SH_PCRELIMM8BY2
3262 ENUMX
3263   BFD_RELOC_SH_PCRELIMM8BY4
3264 ENUMX
3265   BFD_RELOC_SH_SWITCH16
3266 ENUMX
3267   BFD_RELOC_SH_SWITCH32
3268 ENUMX
3269   BFD_RELOC_SH_USES
3270 ENUMX
3271   BFD_RELOC_SH_COUNT
3272 ENUMX
3273   BFD_RELOC_SH_ALIGN
3274 ENUMX
3275   BFD_RELOC_SH_CODE
3276 ENUMX
3277   BFD_RELOC_SH_DATA
3278 ENUMX
3279   BFD_RELOC_SH_LABEL
3280 ENUMX
3281   BFD_RELOC_SH_LOOP_START
3282 ENUMX
3283   BFD_RELOC_SH_LOOP_END
3284 ENUMX
3285   BFD_RELOC_SH_COPY
3286 ENUMX
3287   BFD_RELOC_SH_GLOB_DAT
3288 ENUMX
3289   BFD_RELOC_SH_JMP_SLOT
3290 ENUMX
3291   BFD_RELOC_SH_RELATIVE
3292 ENUMX
3293   BFD_RELOC_SH_GOTPC
3294 ENUMX
3295   BFD_RELOC_SH_GOT_LOW16
3296 ENUMX
3297   BFD_RELOC_SH_GOT_MEDLOW16
3298 ENUMX
3299   BFD_RELOC_SH_GOT_MEDHI16
3300 ENUMX
3301   BFD_RELOC_SH_GOT_HI16
3302 ENUMX
3303   BFD_RELOC_SH_GOTPLT_LOW16
3304 ENUMX
3305   BFD_RELOC_SH_GOTPLT_MEDLOW16
3306 ENUMX
3307   BFD_RELOC_SH_GOTPLT_MEDHI16
3308 ENUMX
3309   BFD_RELOC_SH_GOTPLT_HI16
3310 ENUMX
3311   BFD_RELOC_SH_PLT_LOW16
3312 ENUMX
3313   BFD_RELOC_SH_PLT_MEDLOW16
3314 ENUMX
3315   BFD_RELOC_SH_PLT_MEDHI16
3316 ENUMX
3317   BFD_RELOC_SH_PLT_HI16
3318 ENUMX
3319   BFD_RELOC_SH_GOTOFF_LOW16
3320 ENUMX
3321   BFD_RELOC_SH_GOTOFF_MEDLOW16
3322 ENUMX
3323   BFD_RELOC_SH_GOTOFF_MEDHI16
3324 ENUMX
3325   BFD_RELOC_SH_GOTOFF_HI16
3326 ENUMX
3327   BFD_RELOC_SH_GOTPC_LOW16
3328 ENUMX
3329   BFD_RELOC_SH_GOTPC_MEDLOW16
3330 ENUMX
3331   BFD_RELOC_SH_GOTPC_MEDHI16
3332 ENUMX
3333   BFD_RELOC_SH_GOTPC_HI16
3334 ENUMX
3335   BFD_RELOC_SH_COPY64
3336 ENUMX
3337   BFD_RELOC_SH_GLOB_DAT64
3338 ENUMX
3339   BFD_RELOC_SH_JMP_SLOT64
3340 ENUMX
3341   BFD_RELOC_SH_RELATIVE64
3342 ENUMX
3343   BFD_RELOC_SH_GOT10BY4
3344 ENUMX
3345   BFD_RELOC_SH_GOT10BY8
3346 ENUMX
3347   BFD_RELOC_SH_GOTPLT10BY4
3348 ENUMX
3349   BFD_RELOC_SH_GOTPLT10BY8
3350 ENUMX
3351   BFD_RELOC_SH_GOTPLT32
3352 ENUMX
3353   BFD_RELOC_SH_SHMEDIA_CODE
3354 ENUMX
3355   BFD_RELOC_SH_IMMU5
3356 ENUMX
3357   BFD_RELOC_SH_IMMS6
3358 ENUMX
3359   BFD_RELOC_SH_IMMS6BY32
3360 ENUMX
3361   BFD_RELOC_SH_IMMU6
3362 ENUMX
3363   BFD_RELOC_SH_IMMS10
3364 ENUMX
3365   BFD_RELOC_SH_IMMS10BY2
3366 ENUMX
3367   BFD_RELOC_SH_IMMS10BY4
3368 ENUMX
3369   BFD_RELOC_SH_IMMS10BY8
3370 ENUMX
3371   BFD_RELOC_SH_IMMS16
3372 ENUMX
3373   BFD_RELOC_SH_IMMU16
3374 ENUMX
3375   BFD_RELOC_SH_IMM_LOW16
3376 ENUMX
3377   BFD_RELOC_SH_IMM_LOW16_PCREL
3378 ENUMX
3379   BFD_RELOC_SH_IMM_MEDLOW16
3380 ENUMX
3381   BFD_RELOC_SH_IMM_MEDLOW16_PCREL
3382 ENUMX
3383   BFD_RELOC_SH_IMM_MEDHI16
3384 ENUMX
3385   BFD_RELOC_SH_IMM_MEDHI16_PCREL
3386 ENUMX
3387   BFD_RELOC_SH_IMM_HI16
3388 ENUMX
3389   BFD_RELOC_SH_IMM_HI16_PCREL
3390 ENUMX
3391   BFD_RELOC_SH_PT_16
3392 ENUMX
3393   BFD_RELOC_SH_TLS_GD_32
3394 ENUMX
3395   BFD_RELOC_SH_TLS_LD_32
3396 ENUMX
3397   BFD_RELOC_SH_TLS_LDO_32
3398 ENUMX
3399   BFD_RELOC_SH_TLS_IE_32
3400 ENUMX
3401   BFD_RELOC_SH_TLS_LE_32
3402 ENUMX
3403   BFD_RELOC_SH_TLS_DTPMOD32
3404 ENUMX
3405   BFD_RELOC_SH_TLS_DTPOFF32
3406 ENUMX
3407   BFD_RELOC_SH_TLS_TPOFF32
3408 ENUMX
3409   BFD_RELOC_SH_GOT20
3410 ENUMX
3411   BFD_RELOC_SH_GOTOFF20
3412 ENUMX
3413   BFD_RELOC_SH_GOTFUNCDESC
3414 ENUMX
3415   BFD_RELOC_SH_GOTFUNCDESC20
3416 ENUMX
3417   BFD_RELOC_SH_GOTOFFFUNCDESC
3418 ENUMX
3419   BFD_RELOC_SH_GOTOFFFUNCDESC20
3420 ENUMX
3421   BFD_RELOC_SH_FUNCDESC
3422 ENUMDOC
3423   Renesas / SuperH SH relocs.  Not all of these appear in object files.
3424
3425 ENUM
3426   BFD_RELOC_ARC_B22_PCREL
3427 ENUMDOC
3428   ARC Cores relocs.
3429   ARC 22 bit pc-relative branch.  The lowest two bits must be zero and are
3430   not stored in the instruction.  The high 20 bits are installed in bits 26
3431   through 7 of the instruction.
3432 ENUM
3433   BFD_RELOC_ARC_B26
3434 ENUMDOC
3435   ARC 26 bit absolute branch.  The lowest two bits must be zero and are not
3436   stored in the instruction.  The high 24 bits are installed in bits 23
3437   through 0.
3438
3439 ENUM
3440   BFD_RELOC_BFIN_16_IMM
3441 ENUMDOC
3442   ADI Blackfin 16 bit immediate absolute reloc.
3443 ENUM
3444   BFD_RELOC_BFIN_16_HIGH
3445 ENUMDOC
3446   ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
3447 ENUM
3448   BFD_RELOC_BFIN_4_PCREL
3449 ENUMDOC
3450   ADI Blackfin 'a' part of LSETUP.
3451 ENUM
3452   BFD_RELOC_BFIN_5_PCREL
3453 ENUMDOC
3454   ADI Blackfin.
3455 ENUM
3456   BFD_RELOC_BFIN_16_LOW
3457 ENUMDOC
3458   ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
3459 ENUM
3460   BFD_RELOC_BFIN_10_PCREL
3461 ENUMDOC
3462   ADI Blackfin.
3463 ENUM
3464   BFD_RELOC_BFIN_11_PCREL
3465 ENUMDOC
3466   ADI Blackfin 'b' part of LSETUP.
3467 ENUM
3468   BFD_RELOC_BFIN_12_PCREL_JUMP
3469 ENUMDOC
3470   ADI Blackfin.
3471 ENUM
3472   BFD_RELOC_BFIN_12_PCREL_JUMP_S
3473 ENUMDOC
3474   ADI Blackfin Short jump, pcrel.
3475 ENUM
3476   BFD_RELOC_BFIN_24_PCREL_CALL_X
3477 ENUMDOC
3478   ADI Blackfin Call.x not implemented.
3479 ENUM
3480   BFD_RELOC_BFIN_24_PCREL_JUMP_L
3481 ENUMDOC
3482   ADI Blackfin Long Jump pcrel.
3483 ENUM
3484   BFD_RELOC_BFIN_GOT17M4
3485 ENUMX
3486   BFD_RELOC_BFIN_GOTHI
3487 ENUMX
3488   BFD_RELOC_BFIN_GOTLO
3489 ENUMX
3490   BFD_RELOC_BFIN_FUNCDESC
3491 ENUMX
3492   BFD_RELOC_BFIN_FUNCDESC_GOT17M4
3493 ENUMX
3494   BFD_RELOC_BFIN_FUNCDESC_GOTHI
3495 ENUMX
3496   BFD_RELOC_BFIN_FUNCDESC_GOTLO
3497 ENUMX
3498   BFD_RELOC_BFIN_FUNCDESC_VALUE
3499 ENUMX
3500   BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
3501 ENUMX
3502   BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
3503 ENUMX
3504   BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
3505 ENUMX
3506   BFD_RELOC_BFIN_GOTOFF17M4
3507 ENUMX
3508   BFD_RELOC_BFIN_GOTOFFHI
3509 ENUMX
3510   BFD_RELOC_BFIN_GOTOFFLO
3511 ENUMDOC
3512   ADI Blackfin FD-PIC relocations.
3513 ENUM
3514   BFD_RELOC_BFIN_GOT
3515 ENUMDOC
3516   ADI Blackfin GOT relocation.
3517 ENUM
3518   BFD_RELOC_BFIN_PLTPC
3519 ENUMDOC
3520   ADI Blackfin PLTPC relocation.
3521 ENUM
3522   BFD_ARELOC_BFIN_PUSH
3523 ENUMDOC
3524   ADI Blackfin arithmetic relocation.
3525 ENUM
3526   BFD_ARELOC_BFIN_CONST
3527 ENUMDOC
3528   ADI Blackfin arithmetic relocation.
3529 ENUM
3530   BFD_ARELOC_BFIN_ADD
3531 ENUMDOC
3532   ADI Blackfin arithmetic relocation.
3533 ENUM
3534   BFD_ARELOC_BFIN_SUB
3535 ENUMDOC
3536   ADI Blackfin arithmetic relocation.
3537 ENUM
3538   BFD_ARELOC_BFIN_MULT
3539 ENUMDOC
3540   ADI Blackfin arithmetic relocation.
3541 ENUM
3542   BFD_ARELOC_BFIN_DIV
3543 ENUMDOC
3544   ADI Blackfin arithmetic relocation.
3545 ENUM
3546   BFD_ARELOC_BFIN_MOD
3547 ENUMDOC
3548   ADI Blackfin arithmetic relocation.
3549 ENUM
3550   BFD_ARELOC_BFIN_LSHIFT
3551 ENUMDOC
3552   ADI Blackfin arithmetic relocation.
3553 ENUM
3554   BFD_ARELOC_BFIN_RSHIFT
3555 ENUMDOC
3556   ADI Blackfin arithmetic relocation.
3557 ENUM
3558   BFD_ARELOC_BFIN_AND
3559 ENUMDOC
3560   ADI Blackfin arithmetic relocation.
3561 ENUM
3562   BFD_ARELOC_BFIN_OR
3563 ENUMDOC
3564   ADI Blackfin arithmetic relocation.
3565 ENUM
3566   BFD_ARELOC_BFIN_XOR
3567 ENUMDOC
3568   ADI Blackfin arithmetic relocation.
3569 ENUM
3570   BFD_ARELOC_BFIN_LAND
3571 ENUMDOC
3572   ADI Blackfin arithmetic relocation.
3573 ENUM
3574   BFD_ARELOC_BFIN_LOR
3575 ENUMDOC
3576   ADI Blackfin arithmetic relocation.
3577 ENUM
3578   BFD_ARELOC_BFIN_LEN
3579 ENUMDOC
3580   ADI Blackfin arithmetic relocation.
3581 ENUM
3582   BFD_ARELOC_BFIN_NEG
3583 ENUMDOC
3584   ADI Blackfin arithmetic relocation.
3585 ENUM
3586   BFD_ARELOC_BFIN_COMP
3587 ENUMDOC
3588   ADI Blackfin arithmetic relocation.
3589 ENUM
3590   BFD_ARELOC_BFIN_PAGE
3591 ENUMDOC
3592   ADI Blackfin arithmetic relocation.
3593 ENUM
3594   BFD_ARELOC_BFIN_HWPAGE
3595 ENUMDOC
3596   ADI Blackfin arithmetic relocation.
3597 ENUM
3598   BFD_ARELOC_BFIN_ADDR
3599 ENUMDOC
3600   ADI Blackfin arithmetic relocation.
3601
3602 ENUM
3603   BFD_RELOC_D10V_10_PCREL_R
3604 ENUMDOC
3605   Mitsubishi D10V relocs.
3606   This is a 10-bit reloc with the right 2 bits
3607   assumed to be 0.
3608 ENUM
3609   BFD_RELOC_D10V_10_PCREL_L
3610 ENUMDOC
3611   Mitsubishi D10V relocs.
3612   This is a 10-bit reloc with the right 2 bits
3613   assumed to be 0.  This is the same as the previous reloc
3614   except it is in the left container, i.e.,
3615   shifted left 15 bits.
3616 ENUM
3617   BFD_RELOC_D10V_18
3618 ENUMDOC
3619   This is an 18-bit reloc with the right 2 bits
3620   assumed to be 0.
3621 ENUM
3622   BFD_RELOC_D10V_18_PCREL
3623 ENUMDOC
3624   This is an 18-bit reloc with the right 2 bits
3625   assumed to be 0.
3626
3627 ENUM
3628   BFD_RELOC_D30V_6
3629 ENUMDOC
3630   Mitsubishi D30V relocs.
3631   This is a 6-bit absolute reloc.
3632 ENUM
3633   BFD_RELOC_D30V_9_PCREL
3634 ENUMDOC
3635   This is a 6-bit pc-relative reloc with
3636   the right 3 bits assumed to be 0.
3637 ENUM
3638   BFD_RELOC_D30V_9_PCREL_R
3639 ENUMDOC
3640   This is a 6-bit pc-relative reloc with
3641   the right 3 bits assumed to be 0. Same
3642   as the previous reloc but on the right side
3643   of the container.
3644 ENUM
3645   BFD_RELOC_D30V_15
3646 ENUMDOC
3647   This is a 12-bit absolute reloc with the
3648   right 3 bitsassumed to be 0.
3649 ENUM
3650   BFD_RELOC_D30V_15_PCREL
3651 ENUMDOC
3652   This is a 12-bit pc-relative reloc with
3653   the right 3 bits assumed to be 0.
3654 ENUM
3655   BFD_RELOC_D30V_15_PCREL_R
3656 ENUMDOC
3657   This is a 12-bit pc-relative reloc with
3658   the right 3 bits assumed to be 0. Same
3659   as the previous reloc but on the right side
3660   of the container.
3661 ENUM
3662   BFD_RELOC_D30V_21
3663 ENUMDOC
3664   This is an 18-bit absolute reloc with
3665   the right 3 bits assumed to be 0.
3666 ENUM
3667   BFD_RELOC_D30V_21_PCREL
3668 ENUMDOC
3669   This is an 18-bit pc-relative reloc with
3670   the right 3 bits assumed to be 0.
3671 ENUM
3672   BFD_RELOC_D30V_21_PCREL_R
3673 ENUMDOC
3674   This is an 18-bit pc-relative reloc with
3675   the right 3 bits assumed to be 0. Same
3676   as the previous reloc but on the right side
3677   of the container.
3678 ENUM
3679   BFD_RELOC_D30V_32
3680 ENUMDOC
3681   This is a 32-bit absolute reloc.
3682 ENUM
3683   BFD_RELOC_D30V_32_PCREL
3684 ENUMDOC
3685   This is a 32-bit pc-relative reloc.
3686
3687 ENUM
3688   BFD_RELOC_DLX_HI16_S
3689 ENUMDOC
3690   DLX relocs
3691 ENUM
3692   BFD_RELOC_DLX_LO16
3693 ENUMDOC
3694   DLX relocs
3695 ENUM
3696   BFD_RELOC_DLX_JMP26
3697 ENUMDOC
3698   DLX relocs
3699
3700 ENUM
3701   BFD_RELOC_M32C_HI8
3702 ENUMX
3703   BFD_RELOC_M32C_RL_JUMP
3704 ENUMX
3705   BFD_RELOC_M32C_RL_1ADDR
3706 ENUMX
3707   BFD_RELOC_M32C_RL_2ADDR
3708 ENUMDOC
3709   Renesas M16C/M32C Relocations.
3710
3711 ENUM
3712   BFD_RELOC_M32R_24
3713 ENUMDOC
3714   Renesas M32R (formerly Mitsubishi M32R) relocs.
3715   This is a 24 bit absolute address.
3716 ENUM
3717   BFD_RELOC_M32R_10_PCREL
3718 ENUMDOC
3719   This is a 10-bit pc-relative reloc with the right 2 bits assumed to be 0.
3720 ENUM
3721   BFD_RELOC_M32R_18_PCREL
3722 ENUMDOC
3723   This is an 18-bit reloc with the right 2 bits assumed to be 0.
3724 ENUM
3725   BFD_RELOC_M32R_26_PCREL
3726 ENUMDOC
3727   This is a 26-bit reloc with the right 2 bits assumed to be 0.
3728 ENUM
3729   BFD_RELOC_M32R_HI16_ULO
3730 ENUMDOC
3731   This is a 16-bit reloc containing the high 16 bits of an address
3732   used when the lower 16 bits are treated as unsigned.
3733 ENUM
3734   BFD_RELOC_M32R_HI16_SLO
3735 ENUMDOC
3736   This is a 16-bit reloc containing the high 16 bits of an address
3737   used when the lower 16 bits are treated as signed.
3738 ENUM
3739   BFD_RELOC_M32R_LO16
3740 ENUMDOC
3741   This is a 16-bit reloc containing the lower 16 bits of an address.
3742 ENUM
3743   BFD_RELOC_M32R_SDA16
3744 ENUMDOC
3745   This is a 16-bit reloc containing the small data area offset for use in
3746   add3, load, and store instructions.
3747 ENUM
3748   BFD_RELOC_M32R_GOT24
3749 ENUMX
3750   BFD_RELOC_M32R_26_PLTREL
3751 ENUMX
3752   BFD_RELOC_M32R_COPY
3753 ENUMX
3754   BFD_RELOC_M32R_GLOB_DAT
3755 ENUMX
3756   BFD_RELOC_M32R_JMP_SLOT
3757 ENUMX
3758   BFD_RELOC_M32R_RELATIVE
3759 ENUMX
3760   BFD_RELOC_M32R_GOTOFF
3761 ENUMX
3762   BFD_RELOC_M32R_GOTOFF_HI_ULO
3763 ENUMX
3764   BFD_RELOC_M32R_GOTOFF_HI_SLO
3765 ENUMX
3766   BFD_RELOC_M32R_GOTOFF_LO
3767 ENUMX
3768   BFD_RELOC_M32R_GOTPC24
3769 ENUMX
3770   BFD_RELOC_M32R_GOT16_HI_ULO
3771 ENUMX
3772   BFD_RELOC_M32R_GOT16_HI_SLO
3773 ENUMX
3774   BFD_RELOC_M32R_GOT16_LO
3775 ENUMX
3776   BFD_RELOC_M32R_GOTPC_HI_ULO
3777 ENUMX
3778   BFD_RELOC_M32R_GOTPC_HI_SLO
3779 ENUMX
3780   BFD_RELOC_M32R_GOTPC_LO
3781 ENUMDOC
3782   For PIC.
3783
3784
3785 ENUM
3786   BFD_RELOC_V850_9_PCREL
3787 ENUMDOC
3788   This is a 9-bit reloc
3789 ENUM
3790   BFD_RELOC_V850_22_PCREL
3791 ENUMDOC
3792   This is a 22-bit reloc
3793
3794 ENUM
3795   BFD_RELOC_V850_SDA_16_16_OFFSET
3796 ENUMDOC
3797   This is a 16 bit offset from the short data area pointer.
3798 ENUM
3799   BFD_RELOC_V850_SDA_15_16_OFFSET
3800 ENUMDOC
3801   This is a 16 bit offset (of which only 15 bits are used) from the
3802   short data area pointer.
3803 ENUM
3804   BFD_RELOC_V850_ZDA_16_16_OFFSET
3805 ENUMDOC
3806   This is a 16 bit offset from the zero data area pointer.
3807 ENUM
3808   BFD_RELOC_V850_ZDA_15_16_OFFSET
3809 ENUMDOC
3810   This is a 16 bit offset (of which only 15 bits are used) from the
3811   zero data area pointer.
3812 ENUM
3813   BFD_RELOC_V850_TDA_6_8_OFFSET
3814 ENUMDOC
3815   This is an 8 bit offset (of which only 6 bits are used) from the
3816   tiny data area pointer.
3817 ENUM
3818   BFD_RELOC_V850_TDA_7_8_OFFSET
3819 ENUMDOC
3820   This is an 8bit offset (of which only 7 bits are used) from the tiny
3821   data area pointer.
3822 ENUM
3823   BFD_RELOC_V850_TDA_7_7_OFFSET
3824 ENUMDOC
3825   This is a 7 bit offset from the tiny data area pointer.
3826 ENUM
3827   BFD_RELOC_V850_TDA_16_16_OFFSET
3828 ENUMDOC
3829   This is a 16 bit offset from the tiny data area pointer.
3830 COMMENT
3831 ENUM
3832   BFD_RELOC_V850_TDA_4_5_OFFSET
3833 ENUMDOC
3834   This is a 5 bit offset (of which only 4 bits are used) from the tiny
3835   data area pointer.
3836 ENUM
3837   BFD_RELOC_V850_TDA_4_4_OFFSET
3838 ENUMDOC
3839   This is a 4 bit offset from the tiny data area pointer.
3840 ENUM
3841   BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
3842 ENUMDOC
3843   This is a 16 bit offset from the short data area pointer, with the
3844   bits placed non-contiguously in the instruction.
3845 ENUM
3846   BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
3847 ENUMDOC
3848   This is a 16 bit offset from the zero data area pointer, with the
3849   bits placed non-contiguously in the instruction.
3850 ENUM
3851   BFD_RELOC_V850_CALLT_6_7_OFFSET
3852 ENUMDOC
3853   This is a 6 bit offset from the call table base pointer.
3854 ENUM
3855   BFD_RELOC_V850_CALLT_16_16_OFFSET
3856 ENUMDOC
3857   This is a 16 bit offset from the call table base pointer.
3858 ENUM
3859   BFD_RELOC_V850_LONGCALL
3860 ENUMDOC
3861   Used for relaxing indirect function calls.
3862 ENUM
3863   BFD_RELOC_V850_LONGJUMP
3864 ENUMDOC
3865   Used for relaxing indirect jumps.
3866 ENUM
3867   BFD_RELOC_V850_ALIGN
3868 ENUMDOC
3869   Used to maintain alignment whilst relaxing.
3870 ENUM
3871   BFD_RELOC_V850_LO16_SPLIT_OFFSET
3872 ENUMDOC
3873   This is a variation of BFD_RELOC_LO16 that can be used in v850e ld.bu
3874   instructions.
3875 ENUM
3876   BFD_RELOC_V850_16_PCREL
3877 ENUMDOC
3878   This is a 16-bit reloc.
3879 ENUM
3880   BFD_RELOC_V850_17_PCREL
3881 ENUMDOC
3882   This is a 17-bit reloc.
3883 ENUM
3884   BFD_RELOC_V850_23
3885 ENUMDOC
3886   This is a 23-bit reloc.
3887 ENUM
3888   BFD_RELOC_V850_32_PCREL
3889 ENUMDOC
3890   This is a 32-bit reloc.
3891 ENUM
3892   BFD_RELOC_V850_32_ABS
3893 ENUMDOC
3894   This is a 32-bit reloc.
3895 ENUM
3896   BFD_RELOC_V850_16_SPLIT_OFFSET
3897 ENUMDOC
3898   This is a 16-bit reloc.
3899 ENUM
3900   BFD_RELOC_V850_16_S1
3901 ENUMDOC
3902   This is a 16-bit reloc.
3903 ENUM
3904   BFD_RELOC_V850_LO16_S1
3905 ENUMDOC
3906   Low 16 bits. 16 bit shifted by 1.
3907 ENUM
3908   BFD_RELOC_V850_CALLT_15_16_OFFSET
3909 ENUMDOC
3910   This is a 16 bit offset from the call table base pointer.
3911 ENUM
3912   BFD_RELOC_V850_32_GOTPCREL
3913 ENUMDOC
3914   DSO relocations.
3915 ENUM
3916   BFD_RELOC_V850_16_GOT
3917 ENUMDOC
3918   DSO relocations.
3919 ENUM
3920   BFD_RELOC_V850_32_GOT
3921 ENUMDOC
3922   DSO relocations.
3923 ENUM
3924   BFD_RELOC_V850_22_PLT_PCREL
3925 ENUMDOC
3926   DSO relocations.
3927 ENUM
3928   BFD_RELOC_V850_32_PLT_PCREL
3929 ENUMDOC
3930   DSO relocations.
3931 ENUM
3932   BFD_RELOC_V850_COPY
3933 ENUMDOC
3934   DSO relocations.
3935 ENUM
3936   BFD_RELOC_V850_GLOB_DAT
3937 ENUMDOC
3938   DSO relocations.
3939 ENUM
3940   BFD_RELOC_V850_JMP_SLOT
3941 ENUMDOC
3942   DSO relocations.
3943 ENUM
3944   BFD_RELOC_V850_RELATIVE
3945 ENUMDOC
3946   DSO relocations.
3947 ENUM
3948   BFD_RELOC_V850_16_GOTOFF
3949 ENUMDOC
3950   DSO relocations.
3951 ENUM
3952   BFD_RELOC_V850_32_GOTOFF
3953 ENUMDOC
3954   DSO relocations.
3955 ENUM
3956   BFD_RELOC_V850_CODE
3957 ENUMDOC
3958   start code.
3959 ENUM
3960   BFD_RELOC_V850_DATA
3961 ENUMDOC
3962   start data in text.
3963
3964 ENUM
3965   BFD_RELOC_TIC30_LDP
3966 ENUMDOC
3967   This is a 8bit DP reloc for the tms320c30, where the most
3968   significant 8 bits of a 24 bit word are placed into the least
3969   significant 8 bits of the opcode.
3970
3971 ENUM
3972   BFD_RELOC_TIC54X_PARTLS7
3973 ENUMDOC
3974   This is a 7bit reloc for the tms320c54x, where the least
3975   significant 7 bits of a 16 bit word are placed into the least
3976   significant 7 bits of the opcode.
3977
3978 ENUM
3979   BFD_RELOC_TIC54X_PARTMS9
3980 ENUMDOC
3981   This is a 9bit DP reloc for the tms320c54x, where the most
3982   significant 9 bits of a 16 bit word are placed into the least
3983   significant 9 bits of the opcode.
3984
3985 ENUM
3986   BFD_RELOC_TIC54X_23
3987 ENUMDOC
3988   This is an extended address 23-bit reloc for the tms320c54x.
3989
3990 ENUM
3991   BFD_RELOC_TIC54X_16_OF_23
3992 ENUMDOC
3993   This is a 16-bit reloc for the tms320c54x, where the least
3994   significant 16 bits of a 23-bit extended address are placed into
3995   the opcode.
3996
3997 ENUM
3998   BFD_RELOC_TIC54X_MS7_OF_23
3999 ENUMDOC
4000   This is a reloc for the tms320c54x, where the most
4001   significant 7 bits of a 23-bit extended address are placed into
4002   the opcode.
4003
4004 ENUM
4005   BFD_RELOC_C6000_PCR_S21
4006 ENUMX
4007   BFD_RELOC_C6000_PCR_S12
4008 ENUMX
4009   BFD_RELOC_C6000_PCR_S10
4010 ENUMX
4011   BFD_RELOC_C6000_PCR_S7
4012 ENUMX
4013   BFD_RELOC_C6000_ABS_S16
4014 ENUMX
4015   BFD_RELOC_C6000_ABS_L16
4016 ENUMX
4017   BFD_RELOC_C6000_ABS_H16
4018 ENUMX
4019   BFD_RELOC_C6000_SBR_U15_B
4020 ENUMX
4021   BFD_RELOC_C6000_SBR_U15_H
4022 ENUMX
4023   BFD_RELOC_C6000_SBR_U15_W
4024 ENUMX
4025   BFD_RELOC_C6000_SBR_S16
4026 ENUMX
4027   BFD_RELOC_C6000_SBR_L16_B
4028 ENUMX
4029   BFD_RELOC_C6000_SBR_L16_H
4030 ENUMX
4031   BFD_RELOC_C6000_SBR_L16_W
4032 ENUMX
4033   BFD_RELOC_C6000_SBR_H16_B
4034 ENUMX
4035   BFD_RELOC_C6000_SBR_H16_H
4036 ENUMX
4037   BFD_RELOC_C6000_SBR_H16_W
4038 ENUMX
4039   BFD_RELOC_C6000_SBR_GOT_U15_W
4040 ENUMX
4041   BFD_RELOC_C6000_SBR_GOT_L16_W
4042 ENUMX
4043   BFD_RELOC_C6000_SBR_GOT_H16_W
4044 ENUMX
4045   BFD_RELOC_C6000_DSBT_INDEX
4046 ENUMX
4047   BFD_RELOC_C6000_PREL31
4048 ENUMX
4049   BFD_RELOC_C6000_COPY
4050 ENUMX
4051   BFD_RELOC_C6000_JUMP_SLOT
4052 ENUMX
4053   BFD_RELOC_C6000_EHTYPE
4054 ENUMX
4055   BFD_RELOC_C6000_PCR_H16
4056 ENUMX
4057   BFD_RELOC_C6000_PCR_L16
4058 ENUMX
4059   BFD_RELOC_C6000_ALIGN
4060 ENUMX
4061   BFD_RELOC_C6000_FPHEAD
4062 ENUMX
4063   BFD_RELOC_C6000_NOCMP
4064 ENUMDOC
4065   TMS320C6000 relocations.
4066
4067 ENUM
4068   BFD_RELOC_FR30_48
4069 ENUMDOC
4070   This is a 48 bit reloc for the FR30 that stores 32 bits.
4071 ENUM
4072   BFD_RELOC_FR30_20
4073 ENUMDOC
4074   This is a 32 bit reloc for the FR30 that stores 20 bits split up into
4075   two sections.
4076 ENUM
4077   BFD_RELOC_FR30_6_IN_4
4078 ENUMDOC
4079   This is a 16 bit reloc for the FR30 that stores a 6 bit word offset in
4080   4 bits.
4081 ENUM
4082   BFD_RELOC_FR30_8_IN_8
4083 ENUMDOC
4084   This is a 16 bit reloc for the FR30 that stores an 8 bit byte offset
4085   into 8 bits.
4086 ENUM
4087   BFD_RELOC_FR30_9_IN_8
4088 ENUMDOC
4089   This is a 16 bit reloc for the FR30 that stores a 9 bit short offset
4090   into 8 bits.
4091 ENUM
4092   BFD_RELOC_FR30_10_IN_8
4093 ENUMDOC
4094   This is a 16 bit reloc for the FR30 that stores a 10 bit word offset
4095   into 8 bits.
4096 ENUM
4097   BFD_RELOC_FR30_9_PCREL
4098 ENUMDOC
4099   This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
4100   short offset into 8 bits.
4101 ENUM
4102   BFD_RELOC_FR30_12_PCREL
4103 ENUMDOC
4104   This is a 16 bit reloc for the FR30 that stores a 12 bit pc relative
4105   short offset into 11 bits.
4106
4107 ENUM
4108   BFD_RELOC_MCORE_PCREL_IMM8BY4
4109 ENUMX
4110   BFD_RELOC_MCORE_PCREL_IMM11BY2
4111 ENUMX
4112   BFD_RELOC_MCORE_PCREL_IMM4BY2
4113 ENUMX
4114   BFD_RELOC_MCORE_PCREL_32
4115 ENUMX
4116   BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
4117 ENUMX
4118   BFD_RELOC_MCORE_RVA
4119 ENUMDOC
4120   Motorola Mcore relocations.
4121
4122 ENUM
4123   BFD_RELOC_MEP_8
4124 ENUMX
4125   BFD_RELOC_MEP_16
4126 ENUMX
4127   BFD_RELOC_MEP_32
4128 ENUMX
4129   BFD_RELOC_MEP_PCREL8A2
4130 ENUMX
4131   BFD_RELOC_MEP_PCREL12A2
4132 ENUMX
4133   BFD_RELOC_MEP_PCREL17A2
4134 ENUMX
4135   BFD_RELOC_MEP_PCREL24A2
4136 ENUMX
4137   BFD_RELOC_MEP_PCABS24A2
4138 ENUMX
4139   BFD_RELOC_MEP_LOW16
4140 ENUMX
4141   BFD_RELOC_MEP_HI16U
4142 ENUMX
4143   BFD_RELOC_MEP_HI16S
4144 ENUMX
4145   BFD_RELOC_MEP_GPREL
4146 ENUMX
4147   BFD_RELOC_MEP_TPREL
4148 ENUMX
4149   BFD_RELOC_MEP_TPREL7
4150 ENUMX
4151   BFD_RELOC_MEP_TPREL7A2
4152 ENUMX
4153   BFD_RELOC_MEP_TPREL7A4
4154 ENUMX
4155   BFD_RELOC_MEP_UIMM24
4156 ENUMX
4157   BFD_RELOC_MEP_ADDR24A4
4158 ENUMX
4159   BFD_RELOC_MEP_GNU_VTINHERIT
4160 ENUMX
4161   BFD_RELOC_MEP_GNU_VTENTRY
4162 ENUMDOC
4163   Toshiba Media Processor Relocations.
4164 COMMENT
4165
4166 ENUM
4167   BFD_RELOC_MMIX_GETA
4168 ENUMX
4169   BFD_RELOC_MMIX_GETA_1
4170 ENUMX
4171   BFD_RELOC_MMIX_GETA_2
4172 ENUMX
4173   BFD_RELOC_MMIX_GETA_3
4174 ENUMDOC
4175   These are relocations for the GETA instruction.
4176 ENUM
4177   BFD_RELOC_MMIX_CBRANCH
4178 ENUMX
4179   BFD_RELOC_MMIX_CBRANCH_J
4180 ENUMX
4181   BFD_RELOC_MMIX_CBRANCH_1
4182 ENUMX
4183   BFD_RELOC_MMIX_CBRANCH_2
4184 ENUMX
4185   BFD_RELOC_MMIX_CBRANCH_3
4186 ENUMDOC
4187   These are relocations for a conditional branch instruction.
4188 ENUM
4189   BFD_RELOC_MMIX_PUSHJ
4190 ENUMX
4191   BFD_RELOC_MMIX_PUSHJ_1
4192 ENUMX
4193   BFD_RELOC_MMIX_PUSHJ_2
4194 ENUMX
4195   BFD_RELOC_MMIX_PUSHJ_3
4196 ENUMX
4197   BFD_RELOC_MMIX_PUSHJ_STUBBABLE
4198 ENUMDOC
4199   These are relocations for the PUSHJ instruction.
4200 ENUM
4201   BFD_RELOC_MMIX_JMP
4202 ENUMX
4203   BFD_RELOC_MMIX_JMP_1
4204 ENUMX
4205   BFD_RELOC_MMIX_JMP_2
4206 ENUMX
4207   BFD_RELOC_MMIX_JMP_3
4208 ENUMDOC
4209   These are relocations for the JMP instruction.
4210 ENUM
4211   BFD_RELOC_MMIX_ADDR19
4212 ENUMDOC
4213   This is a relocation for a relative address as in a GETA instruction or
4214   a branch.
4215 ENUM
4216   BFD_RELOC_MMIX_ADDR27
4217 ENUMDOC
4218   This is a relocation for a relative address as in a JMP instruction.
4219 ENUM
4220   BFD_RELOC_MMIX_REG_OR_BYTE
4221 ENUMDOC
4222   This is a relocation for an instruction field that may be a general
4223   register or a value 0..255.
4224 ENUM
4225   BFD_RELOC_MMIX_REG
4226 ENUMDOC
4227   This is a relocation for an instruction field that may be a general
4228   register.
4229 ENUM
4230   BFD_RELOC_MMIX_BASE_PLUS_OFFSET
4231 ENUMDOC
4232   This is a relocation for two instruction fields holding a register and
4233   an offset, the equivalent of the relocation.
4234 ENUM
4235   BFD_RELOC_MMIX_LOCAL
4236 ENUMDOC
4237   This relocation is an assertion that the expression is not allocated as
4238   a global register.  It does not modify contents.
4239
4240 ENUM
4241   BFD_RELOC_AVR_7_PCREL
4242 ENUMDOC
4243   This is a 16 bit reloc for the AVR that stores 8 bit pc relative
4244   short offset into 7 bits.
4245 ENUM
4246   BFD_RELOC_AVR_13_PCREL
4247 ENUMDOC
4248   This is a 16 bit reloc for the AVR that stores 13 bit pc relative
4249   short offset into 12 bits.
4250 ENUM
4251   BFD_RELOC_AVR_16_PM
4252 ENUMDOC
4253   This is a 16 bit reloc for the AVR that stores 17 bit value (usually
4254   program memory address) into 16 bits.
4255 ENUM
4256   BFD_RELOC_AVR_LO8_LDI
4257 ENUMDOC
4258   This is a 16 bit reloc for the AVR that stores 8 bit value (usually
4259   data memory address) into 8 bit immediate value of LDI insn.
4260 ENUM
4261   BFD_RELOC_AVR_HI8_LDI
4262 ENUMDOC
4263   This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
4264   of data memory address) into 8 bit immediate value of LDI insn.
4265 ENUM
4266   BFD_RELOC_AVR_HH8_LDI
4267 ENUMDOC
4268   This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
4269   of program memory address) into 8 bit immediate value of LDI insn.
4270 ENUM
4271   BFD_RELOC_AVR_MS8_LDI
4272 ENUMDOC
4273   This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
4274   of 32 bit value) into 8 bit immediate value of LDI insn.
4275 ENUM
4276   BFD_RELOC_AVR_LO8_LDI_NEG
4277 ENUMDOC
4278   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4279   (usually data memory address) into 8 bit immediate value of SUBI insn.
4280 ENUM
4281   BFD_RELOC_AVR_HI8_LDI_NEG
4282 ENUMDOC
4283   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4284   (high 8 bit of data memory address) into 8 bit immediate value of
4285   SUBI insn.
4286 ENUM
4287   BFD_RELOC_AVR_HH8_LDI_NEG
4288 ENUMDOC
4289   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4290   (most high 8 bit of program memory address) into 8 bit immediate value
4291   of LDI or SUBI insn.
4292 ENUM
4293   BFD_RELOC_AVR_MS8_LDI_NEG
4294 ENUMDOC
4295   This is a 16 bit reloc for the AVR that stores negated 8 bit value (msb
4296   of 32 bit value) into 8 bit immediate value of LDI insn.
4297 ENUM
4298   BFD_RELOC_AVR_LO8_LDI_PM
4299 ENUMDOC
4300   This is a 16 bit reloc for the AVR that stores 8 bit value (usually
4301   command address) into 8 bit immediate value of LDI insn.
4302 ENUM
4303   BFD_RELOC_AVR_LO8_LDI_GS
4304 ENUMDOC
4305   This is a 16 bit reloc for the AVR that stores 8 bit value
4306   (command address) into 8 bit immediate value of LDI insn. If the address
4307   is beyond the 128k boundary, the linker inserts a jump stub for this reloc
4308   in the lower 128k.
4309 ENUM
4310   BFD_RELOC_AVR_HI8_LDI_PM
4311 ENUMDOC
4312   This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
4313   of command address) into 8 bit immediate value of LDI insn.
4314 ENUM
4315   BFD_RELOC_AVR_HI8_LDI_GS
4316 ENUMDOC
4317   This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
4318   of command address) into 8 bit immediate value of LDI insn.  If the address
4319   is beyond the 128k boundary, the linker inserts a jump stub for this reloc
4320   below 128k.
4321 ENUM
4322   BFD_RELOC_AVR_HH8_LDI_PM
4323 ENUMDOC
4324   This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
4325   of command address) into 8 bit immediate value of LDI insn.
4326 ENUM
4327   BFD_RELOC_AVR_LO8_LDI_PM_NEG
4328 ENUMDOC
4329   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4330   (usually command address) into 8 bit immediate value of SUBI insn.
4331 ENUM
4332   BFD_RELOC_AVR_HI8_LDI_PM_NEG
4333 ENUMDOC
4334   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4335   (high 8 bit of 16 bit command address) into 8 bit immediate value
4336   of SUBI insn.
4337 ENUM
4338   BFD_RELOC_AVR_HH8_LDI_PM_NEG
4339 ENUMDOC
4340   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4341   (high 6 bit of 22 bit command address) into 8 bit immediate
4342   value of SUBI insn.
4343 ENUM
4344   BFD_RELOC_AVR_CALL
4345 ENUMDOC
4346   This is a 32 bit reloc for the AVR that stores 23 bit value
4347   into 22 bits.
4348 ENUM
4349   BFD_RELOC_AVR_LDI
4350 ENUMDOC
4351   This is a 16 bit reloc for the AVR that stores all needed bits
4352   for absolute addressing with ldi with overflow check to linktime
4353 ENUM
4354   BFD_RELOC_AVR_6
4355 ENUMDOC
4356   This is a 6 bit reloc for the AVR that stores offset for ldd/std
4357   instructions
4358 ENUM
4359   BFD_RELOC_AVR_6_ADIW
4360 ENUMDOC
4361   This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
4362   instructions
4363
4364 ENUM
4365   BFD_RELOC_RL78_NEG8
4366 ENUMX
4367   BFD_RELOC_RL78_NEG16
4368 ENUMX
4369   BFD_RELOC_RL78_NEG24
4370 ENUMX
4371   BFD_RELOC_RL78_NEG32
4372 ENUMX
4373   BFD_RELOC_RL78_16_OP
4374 ENUMX
4375   BFD_RELOC_RL78_24_OP
4376 ENUMX
4377   BFD_RELOC_RL78_32_OP
4378 ENUMX
4379   BFD_RELOC_RL78_8U
4380 ENUMX
4381   BFD_RELOC_RL78_16U
4382 ENUMX
4383   BFD_RELOC_RL78_24U
4384 ENUMX
4385   BFD_RELOC_RL78_DIR3U_PCREL
4386 ENUMX
4387   BFD_RELOC_RL78_DIFF
4388 ENUMX
4389   BFD_RELOC_RL78_GPRELB
4390 ENUMX
4391   BFD_RELOC_RL78_GPRELW
4392 ENUMX
4393   BFD_RELOC_RL78_GPRELL
4394 ENUMX
4395   BFD_RELOC_RL78_SYM
4396 ENUMX
4397   BFD_RELOC_RL78_OP_SUBTRACT
4398 ENUMX
4399   BFD_RELOC_RL78_OP_NEG
4400 ENUMX
4401   BFD_RELOC_RL78_OP_AND
4402 ENUMX
4403   BFD_RELOC_RL78_OP_SHRA
4404 ENUMX
4405   BFD_RELOC_RL78_ABS8
4406 ENUMX
4407   BFD_RELOC_RL78_ABS16
4408 ENUMX
4409   BFD_RELOC_RL78_ABS16_REV
4410 ENUMX
4411   BFD_RELOC_RL78_ABS32
4412 ENUMX
4413   BFD_RELOC_RL78_ABS32_REV
4414 ENUMX
4415   BFD_RELOC_RL78_ABS16U
4416 ENUMX
4417   BFD_RELOC_RL78_ABS16UW
4418 ENUMX
4419   BFD_RELOC_RL78_ABS16UL
4420 ENUMX
4421   BFD_RELOC_RL78_RELAX
4422 ENUMX
4423   BFD_RELOC_RL78_HI16
4424 ENUMX
4425   BFD_RELOC_RL78_HI8
4426 ENUMX
4427   BFD_RELOC_RL78_LO16
4428 ENUMDOC
4429   Renesas RL78 Relocations.
4430
4431 ENUM
4432   BFD_RELOC_RX_NEG8
4433 ENUMX
4434   BFD_RELOC_RX_NEG16
4435 ENUMX
4436   BFD_RELOC_RX_NEG24
4437 ENUMX
4438   BFD_RELOC_RX_NEG32
4439 ENUMX
4440   BFD_RELOC_RX_16_OP
4441 ENUMX
4442   BFD_RELOC_RX_24_OP
4443 ENUMX
4444   BFD_RELOC_RX_32_OP
4445 ENUMX
4446   BFD_RELOC_RX_8U
4447 ENUMX
4448   BFD_RELOC_RX_16U
4449 ENUMX
4450   BFD_RELOC_RX_24U
4451 ENUMX
4452   BFD_RELOC_RX_DIR3U_PCREL
4453 ENUMX
4454   BFD_RELOC_RX_DIFF
4455 ENUMX
4456   BFD_RELOC_RX_GPRELB
4457 ENUMX
4458   BFD_RELOC_RX_GPRELW
4459 ENUMX
4460   BFD_RELOC_RX_GPRELL
4461 ENUMX
4462   BFD_RELOC_RX_SYM
4463 ENUMX
4464   BFD_RELOC_RX_OP_SUBTRACT
4465 ENUMX
4466   BFD_RELOC_RX_OP_NEG
4467 ENUMX
4468   BFD_RELOC_RX_ABS8
4469 ENUMX
4470   BFD_RELOC_RX_ABS16
4471 ENUMX
4472   BFD_RELOC_RX_ABS16_REV
4473 ENUMX
4474   BFD_RELOC_RX_ABS32
4475 ENUMX
4476   BFD_RELOC_RX_ABS32_REV
4477 ENUMX
4478   BFD_RELOC_RX_ABS16U
4479 ENUMX
4480   BFD_RELOC_RX_ABS16UW
4481 ENUMX
4482   BFD_RELOC_RX_ABS16UL
4483 ENUMX
4484   BFD_RELOC_RX_RELAX
4485 ENUMDOC
4486   Renesas RX Relocations.
4487
4488 ENUM
4489   BFD_RELOC_390_12
4490 ENUMDOC
4491    Direct 12 bit.
4492 ENUM
4493   BFD_RELOC_390_GOT12
4494 ENUMDOC
4495   12 bit GOT offset.
4496 ENUM
4497   BFD_RELOC_390_PLT32
4498 ENUMDOC
4499   32 bit PC relative PLT address.
4500 ENUM
4501   BFD_RELOC_390_COPY
4502 ENUMDOC
4503   Copy symbol at runtime.
4504 ENUM
4505   BFD_RELOC_390_GLOB_DAT
4506 ENUMDOC
4507   Create GOT entry.
4508 ENUM
4509   BFD_RELOC_390_JMP_SLOT
4510 ENUMDOC
4511   Create PLT entry.
4512 ENUM
4513   BFD_RELOC_390_RELATIVE
4514 ENUMDOC
4515   Adjust by program base.
4516 ENUM
4517   BFD_RELOC_390_GOTPC
4518 ENUMDOC
4519   32 bit PC relative offset to GOT.
4520 ENUM
4521   BFD_RELOC_390_GOT16
4522 ENUMDOC
4523   16 bit GOT offset.
4524 ENUM
4525   BFD_RELOC_390_PC16DBL
4526 ENUMDOC
4527   PC relative 16 bit shifted by 1.
4528 ENUM
4529   BFD_RELOC_390_PLT16DBL
4530 ENUMDOC
4531   16 bit PC rel. PLT shifted by 1.
4532 ENUM
4533   BFD_RELOC_390_PC32DBL
4534 ENUMDOC
4535   PC relative 32 bit shifted by 1.
4536 ENUM
4537   BFD_RELOC_390_PLT32DBL
4538 ENUMDOC
4539   32 bit PC rel. PLT shifted by 1.
4540 ENUM
4541   BFD_RELOC_390_GOTPCDBL
4542 ENUMDOC
4543   32 bit PC rel. GOT shifted by 1.
4544 ENUM
4545   BFD_RELOC_390_GOT64
4546 ENUMDOC
4547   64 bit GOT offset.
4548 ENUM
4549   BFD_RELOC_390_PLT64
4550 ENUMDOC
4551   64 bit PC relative PLT address.
4552 ENUM
4553   BFD_RELOC_390_GOTENT
4554 ENUMDOC
4555   32 bit rel. offset to GOT entry.
4556 ENUM
4557   BFD_RELOC_390_GOTOFF64
4558 ENUMDOC
4559   64 bit offset to GOT.
4560 ENUM
4561   BFD_RELOC_390_GOTPLT12
4562 ENUMDOC
4563   12-bit offset to symbol-entry within GOT, with PLT handling.
4564 ENUM
4565   BFD_RELOC_390_GOTPLT16
4566 ENUMDOC
4567   16-bit offset to symbol-entry within GOT, with PLT handling.
4568 ENUM
4569   BFD_RELOC_390_GOTPLT32
4570 ENUMDOC
4571   32-bit offset to symbol-entry within GOT, with PLT handling.
4572 ENUM
4573   BFD_RELOC_390_GOTPLT64
4574 ENUMDOC
4575   64-bit offset to symbol-entry within GOT, with PLT handling.
4576 ENUM
4577   BFD_RELOC_390_GOTPLTENT
4578 ENUMDOC
4579   32-bit rel. offset to symbol-entry within GOT, with PLT handling.
4580 ENUM
4581   BFD_RELOC_390_PLTOFF16
4582 ENUMDOC
4583   16-bit rel. offset from the GOT to a PLT entry.
4584 ENUM
4585   BFD_RELOC_390_PLTOFF32
4586 ENUMDOC
4587   32-bit rel. offset from the GOT to a PLT entry.
4588 ENUM
4589   BFD_RELOC_390_PLTOFF64
4590 ENUMDOC
4591   64-bit rel. offset from the GOT to a PLT entry.
4592
4593 ENUM
4594   BFD_RELOC_390_TLS_LOAD
4595 ENUMX
4596   BFD_RELOC_390_TLS_GDCALL
4597 ENUMX
4598   BFD_RELOC_390_TLS_LDCALL
4599 ENUMX
4600   BFD_RELOC_390_TLS_GD32
4601 ENUMX
4602   BFD_RELOC_390_TLS_GD64
4603 ENUMX
4604   BFD_RELOC_390_TLS_GOTIE12
4605 ENUMX
4606   BFD_RELOC_390_TLS_GOTIE32
4607 ENUMX
4608   BFD_RELOC_390_TLS_GOTIE64
4609 ENUMX
4610   BFD_RELOC_390_TLS_LDM32
4611 ENUMX
4612   BFD_RELOC_390_TLS_LDM64
4613 ENUMX
4614   BFD_RELOC_390_TLS_IE32
4615 ENUMX
4616   BFD_RELOC_390_TLS_IE64
4617 ENUMX
4618   BFD_RELOC_390_TLS_IEENT
4619 ENUMX
4620   BFD_RELOC_390_TLS_LE32
4621 ENUMX
4622   BFD_RELOC_390_TLS_LE64
4623 ENUMX
4624   BFD_RELOC_390_TLS_LDO32
4625 ENUMX
4626   BFD_RELOC_390_TLS_LDO64
4627 ENUMX
4628   BFD_RELOC_390_TLS_DTPMOD
4629 ENUMX
4630   BFD_RELOC_390_TLS_DTPOFF
4631 ENUMX
4632   BFD_RELOC_390_TLS_TPOFF
4633 ENUMDOC
4634   s390 tls relocations.
4635
4636 ENUM
4637   BFD_RELOC_390_20
4638 ENUMX
4639   BFD_RELOC_390_GOT20
4640 ENUMX
4641   BFD_RELOC_390_GOTPLT20
4642 ENUMX
4643   BFD_RELOC_390_TLS_GOTIE20
4644 ENUMDOC
4645   Long displacement extension.
4646
4647 ENUM
4648   BFD_RELOC_SCORE_GPREL15
4649 ENUMDOC
4650   Score relocations
4651   Low 16 bit for load/store
4652 ENUM
4653   BFD_RELOC_SCORE_DUMMY2
4654 ENUMX
4655   BFD_RELOC_SCORE_JMP
4656 ENUMDOC
4657   This is a 24-bit reloc with the right 1 bit assumed to be 0
4658 ENUM
4659   BFD_RELOC_SCORE_BRANCH
4660 ENUMDOC
4661   This is a 19-bit reloc with the right 1 bit assumed to be 0
4662 ENUM
4663   BFD_RELOC_SCORE_IMM30
4664 ENUMDOC
4665   This is a 32-bit reloc for 48-bit instructions.
4666 ENUM
4667   BFD_RELOC_SCORE_IMM32
4668 ENUMDOC
4669   This is a 32-bit reloc for 48-bit instructions.
4670 ENUM
4671   BFD_RELOC_SCORE16_JMP
4672 ENUMDOC
4673   This is a 11-bit reloc with the right 1 bit assumed to be 0
4674 ENUM
4675   BFD_RELOC_SCORE16_BRANCH
4676 ENUMDOC
4677   This is a 8-bit reloc with the right 1 bit assumed to be 0
4678 ENUM
4679   BFD_RELOC_SCORE_BCMP
4680 ENUMDOC
4681    This is a 9-bit reloc with the right 1 bit assumed to be 0
4682 ENUM
4683   BFD_RELOC_SCORE_GOT15
4684 ENUMX
4685   BFD_RELOC_SCORE_GOT_LO16
4686 ENUMX
4687   BFD_RELOC_SCORE_CALL15
4688 ENUMX
4689   BFD_RELOC_SCORE_DUMMY_HI16
4690 ENUMDOC
4691   Undocumented Score relocs
4692
4693 ENUM
4694   BFD_RELOC_IP2K_FR9
4695 ENUMDOC
4696   Scenix IP2K - 9-bit register number / data address
4697 ENUM
4698   BFD_RELOC_IP2K_BANK
4699 ENUMDOC
4700   Scenix IP2K - 4-bit register/data bank number
4701 ENUM
4702   BFD_RELOC_IP2K_ADDR16CJP
4703 ENUMDOC
4704   Scenix IP2K - low 13 bits of instruction word address
4705 ENUM
4706   BFD_RELOC_IP2K_PAGE3
4707 ENUMDOC
4708   Scenix IP2K - high 3 bits of instruction word address
4709 ENUM
4710   BFD_RELOC_IP2K_LO8DATA
4711 ENUMX
4712   BFD_RELOC_IP2K_HI8DATA
4713 ENUMX
4714   BFD_RELOC_IP2K_EX8DATA
4715 ENUMDOC
4716   Scenix IP2K - ext/low/high 8 bits of data address
4717 ENUM
4718   BFD_RELOC_IP2K_LO8INSN
4719 ENUMX
4720   BFD_RELOC_IP2K_HI8INSN
4721 ENUMDOC
4722   Scenix IP2K - low/high 8 bits of instruction word address
4723 ENUM
4724   BFD_RELOC_IP2K_PC_SKIP
4725 ENUMDOC
4726   Scenix IP2K - even/odd PC modifier to modify snb pcl.0
4727 ENUM
4728   BFD_RELOC_IP2K_TEXT
4729 ENUMDOC
4730   Scenix IP2K - 16 bit word address in text section.
4731 ENUM
4732   BFD_RELOC_IP2K_FR_OFFSET
4733 ENUMDOC
4734   Scenix IP2K - 7-bit sp or dp offset
4735 ENUM
4736   BFD_RELOC_VPE4KMATH_DATA
4737 ENUMX
4738   BFD_RELOC_VPE4KMATH_INSN
4739 ENUMDOC
4740   Scenix VPE4K coprocessor - data/insn-space addressing
4741
4742 ENUM
4743   BFD_RELOC_VTABLE_INHERIT
4744 ENUMX
4745   BFD_RELOC_VTABLE_ENTRY
4746 ENUMDOC
4747   These two relocations are used by the linker to determine which of
4748   the entries in a C++ virtual function table are actually used.  When
4749   the --gc-sections option is given, the linker will zero out the entries
4750   that are not used, so that the code for those functions need not be
4751   included in the output.
4752
4753   VTABLE_INHERIT is a zero-space relocation used to describe to the
4754   linker the inheritance tree of a C++ virtual function table.  The
4755   relocation's symbol should be the parent class' vtable, and the
4756   relocation should be located at the child vtable.
4757
4758   VTABLE_ENTRY is a zero-space relocation that describes the use of a
4759   virtual function table entry.  The reloc's symbol should refer to the
4760   table of the class mentioned in the code.  Off of that base, an offset
4761   describes the entry that is being used.  For Rela hosts, this offset
4762   is stored in the reloc's addend.  For Rel hosts, we are forced to put
4763   this offset in the reloc's section offset.
4764
4765 ENUM
4766   BFD_RELOC_IA64_IMM14
4767 ENUMX
4768   BFD_RELOC_IA64_IMM22
4769 ENUMX
4770   BFD_RELOC_IA64_IMM64
4771 ENUMX
4772   BFD_RELOC_IA64_DIR32MSB
4773 ENUMX
4774   BFD_RELOC_IA64_DIR32LSB
4775 ENUMX
4776   BFD_RELOC_IA64_DIR64MSB
4777 ENUMX
4778   BFD_RELOC_IA64_DIR64LSB
4779 ENUMX
4780   BFD_RELOC_IA64_GPREL22
4781 ENUMX
4782   BFD_RELOC_IA64_GPREL64I
4783 ENUMX
4784   BFD_RELOC_IA64_GPREL32MSB
4785 ENUMX
4786   BFD_RELOC_IA64_GPREL32LSB
4787 ENUMX
4788   BFD_RELOC_IA64_GPREL64MSB
4789 ENUMX
4790   BFD_RELOC_IA64_GPREL64LSB
4791 ENUMX
4792   BFD_RELOC_IA64_LTOFF22
4793 ENUMX
4794   BFD_RELOC_IA64_LTOFF64I
4795 ENUMX
4796   BFD_RELOC_IA64_PLTOFF22
4797 ENUMX
4798   BFD_RELOC_IA64_PLTOFF64I
4799 ENUMX
4800   BFD_RELOC_IA64_PLTOFF64MSB
4801 ENUMX
4802   BFD_RELOC_IA64_PLTOFF64LSB
4803 ENUMX
4804   BFD_RELOC_IA64_FPTR64I
4805 ENUMX
4806   BFD_RELOC_IA64_FPTR32MSB
4807 ENUMX
4808   BFD_RELOC_IA64_FPTR32LSB
4809 ENUMX
4810   BFD_RELOC_IA64_FPTR64MSB
4811 ENUMX
4812   BFD_RELOC_IA64_FPTR64LSB
4813 ENUMX
4814   BFD_RELOC_IA64_PCREL21B
4815 ENUMX
4816   BFD_RELOC_IA64_PCREL21BI
4817 ENUMX
4818   BFD_RELOC_IA64_PCREL21M
4819 ENUMX
4820   BFD_RELOC_IA64_PCREL21F
4821 ENUMX
4822   BFD_RELOC_IA64_PCREL22
4823 ENUMX
4824   BFD_RELOC_IA64_PCREL60B
4825 ENUMX
4826   BFD_RELOC_IA64_PCREL64I
4827 ENUMX
4828   BFD_RELOC_IA64_PCREL32MSB
4829 ENUMX
4830   BFD_RELOC_IA64_PCREL32LSB
4831 ENUMX
4832   BFD_RELOC_IA64_PCREL64MSB
4833 ENUMX
4834   BFD_RELOC_IA64_PCREL64LSB
4835 ENUMX
4836   BFD_RELOC_IA64_LTOFF_FPTR22
4837 ENUMX
4838   BFD_RELOC_IA64_LTOFF_FPTR64I
4839 ENUMX
4840   BFD_RELOC_IA64_LTOFF_FPTR32MSB
4841 ENUMX
4842   BFD_RELOC_IA64_LTOFF_FPTR32LSB
4843 ENUMX
4844   BFD_RELOC_IA64_LTOFF_FPTR64MSB
4845 ENUMX
4846   BFD_RELOC_IA64_LTOFF_FPTR64LSB
4847 ENUMX
4848   BFD_RELOC_IA64_SEGREL32MSB
4849 ENUMX
4850   BFD_RELOC_IA64_SEGREL32LSB
4851 ENUMX
4852   BFD_RELOC_IA64_SEGREL64MSB
4853 ENUMX
4854   BFD_RELOC_IA64_SEGREL64LSB
4855 ENUMX
4856   BFD_RELOC_IA64_SECREL32MSB
4857 ENUMX
4858   BFD_RELOC_IA64_SECREL32LSB
4859 ENUMX
4860   BFD_RELOC_IA64_SECREL64MSB
4861 ENUMX
4862   BFD_RELOC_IA64_SECREL64LSB
4863 ENUMX
4864   BFD_RELOC_IA64_REL32MSB
4865 ENUMX
4866   BFD_RELOC_IA64_REL32LSB
4867 ENUMX
4868   BFD_RELOC_IA64_REL64MSB
4869 ENUMX
4870   BFD_RELOC_IA64_REL64LSB
4871 ENUMX
4872   BFD_RELOC_IA64_LTV32MSB
4873 ENUMX
4874   BFD_RELOC_IA64_LTV32LSB
4875 ENUMX
4876   BFD_RELOC_IA64_LTV64MSB
4877 ENUMX
4878   BFD_RELOC_IA64_LTV64LSB
4879 ENUMX
4880   BFD_RELOC_IA64_IPLTMSB
4881 ENUMX
4882   BFD_RELOC_IA64_IPLTLSB
4883 ENUMX
4884   BFD_RELOC_IA64_COPY
4885 ENUMX
4886   BFD_RELOC_IA64_LTOFF22X
4887 ENUMX
4888   BFD_RELOC_IA64_LDXMOV
4889 ENUMX
4890   BFD_RELOC_IA64_TPREL14
4891 ENUMX
4892   BFD_RELOC_IA64_TPREL22
4893 ENUMX
4894   BFD_RELOC_IA64_TPREL64I
4895 ENUMX
4896   BFD_RELOC_IA64_TPREL64MSB
4897 ENUMX
4898   BFD_RELOC_IA64_TPREL64LSB
4899 ENUMX
4900   BFD_RELOC_IA64_LTOFF_TPREL22
4901 ENUMX
4902   BFD_RELOC_IA64_DTPMOD64MSB
4903 ENUMX
4904   BFD_RELOC_IA64_DTPMOD64LSB
4905 ENUMX
4906   BFD_RELOC_IA64_LTOFF_DTPMOD22
4907 ENUMX
4908   BFD_RELOC_IA64_DTPREL14
4909 ENUMX
4910   BFD_RELOC_IA64_DTPREL22
4911 ENUMX
4912   BFD_RELOC_IA64_DTPREL64I
4913 ENUMX
4914   BFD_RELOC_IA64_DTPREL32MSB
4915 ENUMX
4916   BFD_RELOC_IA64_DTPREL32LSB
4917 ENUMX
4918   BFD_RELOC_IA64_DTPREL64MSB
4919 ENUMX
4920   BFD_RELOC_IA64_DTPREL64LSB
4921 ENUMX
4922   BFD_RELOC_IA64_LTOFF_DTPREL22
4923 ENUMDOC
4924   Intel IA64 Relocations.
4925
4926 ENUM
4927   BFD_RELOC_M68HC11_HI8
4928 ENUMDOC
4929   Motorola 68HC11 reloc.
4930   This is the 8 bit high part of an absolute address.
4931 ENUM
4932   BFD_RELOC_M68HC11_LO8
4933 ENUMDOC
4934   Motorola 68HC11 reloc.
4935   This is the 8 bit low part of an absolute address.
4936 ENUM
4937   BFD_RELOC_M68HC11_3B
4938 ENUMDOC
4939   Motorola 68HC11 reloc.
4940   This is the 3 bit of a value.
4941 ENUM
4942   BFD_RELOC_M68HC11_RL_JUMP
4943 ENUMDOC
4944   Motorola 68HC11 reloc.
4945   This reloc marks the beginning of a jump/call instruction.
4946   It is used for linker relaxation to correctly identify beginning
4947   of instruction and change some branches to use PC-relative
4948   addressing mode.
4949 ENUM
4950   BFD_RELOC_M68HC11_RL_GROUP
4951 ENUMDOC
4952   Motorola 68HC11 reloc.
4953   This reloc marks a group of several instructions that gcc generates
4954   and for which the linker relaxation pass can modify and/or remove
4955   some of them.
4956 ENUM
4957   BFD_RELOC_M68HC11_LO16
4958 ENUMDOC
4959   Motorola 68HC11 reloc.
4960   This is the 16-bit lower part of an address.  It is used for 'call'
4961   instruction to specify the symbol address without any special
4962   transformation (due to memory bank window).
4963 ENUM
4964   BFD_RELOC_M68HC11_PAGE
4965 ENUMDOC
4966   Motorola 68HC11 reloc.
4967   This is a 8-bit reloc that specifies the page number of an address.
4968   It is used by 'call' instruction to specify the page number of
4969   the symbol.
4970 ENUM
4971   BFD_RELOC_M68HC11_24
4972 ENUMDOC
4973   Motorola 68HC11 reloc.
4974   This is a 24-bit reloc that represents the address with a 16-bit
4975   value and a 8-bit page number.  The symbol address is transformed
4976   to follow the 16K memory bank of 68HC12 (seen as mapped in the window).
4977 ENUM
4978   BFD_RELOC_M68HC12_5B
4979 ENUMDOC
4980   Motorola 68HC12 reloc.
4981   This is the 5 bits of a value.
4982 ENUM
4983   BFD_RELOC_XGATE_RL_JUMP
4984 ENUMDOC
4985   Freescale XGATE reloc.
4986   This reloc marks the beginning of a bra/jal instruction.
4987 ENUM
4988   BFD_RELOC_XGATE_RL_GROUP
4989 ENUMDOC
4990   Freescale XGATE reloc.
4991   This reloc marks a group of several instructions that gcc generates
4992   and for which the linker relaxation pass can modify and/or remove
4993   some of them.
4994 ENUM
4995   BFD_RELOC_XGATE_LO16
4996 ENUMDOC
4997   Freescale XGATE reloc.
4998   This is the 16-bit lower part of an address.  It is used for the '16-bit'
4999   instructions.
5000 ENUM
5001   BFD_RELOC_XGATE_GPAGE
5002 ENUMDOC
5003   Freescale XGATE reloc.
5004 ENUM
5005   BFD_RELOC_XGATE_24
5006 ENUMDOC
5007   Freescale XGATE reloc.
5008 ENUM
5009   BFD_RELOC_XGATE_PCREL_9
5010 ENUMDOC
5011   Freescale XGATE reloc.
5012   This is a 9-bit pc-relative reloc.
5013 ENUM
5014   BFD_RELOC_XGATE_PCREL_10
5015 ENUMDOC
5016   Freescale XGATE reloc.
5017   This is a 10-bit pc-relative reloc.
5018 ENUM
5019   BFD_RELOC_XGATE_IMM8_LO
5020 ENUMDOC
5021   Freescale XGATE reloc.
5022   This is the 16-bit lower part of an address.  It is used for the '16-bit'
5023   instructions.
5024 ENUM
5025   BFD_RELOC_XGATE_IMM8_HI
5026 ENUMDOC
5027   Freescale XGATE reloc.
5028   This is the 16-bit higher part of an address.  It is used for the '16-bit'
5029   instructions.
5030 ENUM
5031   BFD_RELOC_XGATE_IMM3
5032 ENUMDOC
5033   Freescale XGATE reloc.
5034   This is a 3-bit pc-relative reloc.
5035 ENUM
5036   BFD_RELOC_XGATE_IMM4
5037 ENUMDOC
5038   Freescale XGATE reloc.
5039   This is a 4-bit pc-relative reloc.
5040 ENUM
5041   BFD_RELOC_XGATE_IMM5
5042 ENUMDOC
5043   Freescale XGATE reloc.
5044   This is a 5-bit pc-relative reloc.
5045 ENUM
5046   BFD_RELOC_16C_NUM08
5047 ENUMX
5048   BFD_RELOC_16C_NUM08_C
5049 ENUMX
5050   BFD_RELOC_16C_NUM16
5051 ENUMX
5052   BFD_RELOC_16C_NUM16_C
5053 ENUMX
5054   BFD_RELOC_16C_NUM32
5055 ENUMX
5056   BFD_RELOC_16C_NUM32_C
5057 ENUMX
5058   BFD_RELOC_16C_DISP04
5059 ENUMX
5060   BFD_RELOC_16C_DISP04_C
5061 ENUMX
5062   BFD_RELOC_16C_DISP08
5063 ENUMX
5064   BFD_RELOC_16C_DISP08_C
5065 ENUMX
5066   BFD_RELOC_16C_DISP16
5067 ENUMX
5068   BFD_RELOC_16C_DISP16_C
5069 ENUMX
5070   BFD_RELOC_16C_DISP24
5071 ENUMX
5072   BFD_RELOC_16C_DISP24_C
5073 ENUMX
5074   BFD_RELOC_16C_DISP24a
5075 ENUMX
5076   BFD_RELOC_16C_DISP24a_C
5077 ENUMX
5078   BFD_RELOC_16C_REG04
5079 ENUMX
5080   BFD_RELOC_16C_REG04_C
5081 ENUMX
5082   BFD_RELOC_16C_REG04a
5083 ENUMX
5084   BFD_RELOC_16C_REG04a_C
5085 ENUMX
5086   BFD_RELOC_16C_REG14
5087 ENUMX
5088   BFD_RELOC_16C_REG14_C
5089 ENUMX
5090   BFD_RELOC_16C_REG16
5091 ENUMX
5092   BFD_RELOC_16C_REG16_C
5093 ENUMX
5094   BFD_RELOC_16C_REG20
5095 ENUMX
5096   BFD_RELOC_16C_REG20_C
5097 ENUMX
5098   BFD_RELOC_16C_ABS20
5099 ENUMX
5100   BFD_RELOC_16C_ABS20_C
5101 ENUMX
5102   BFD_RELOC_16C_ABS24
5103 ENUMX
5104   BFD_RELOC_16C_ABS24_C
5105 ENUMX
5106   BFD_RELOC_16C_IMM04
5107 ENUMX
5108   BFD_RELOC_16C_IMM04_C
5109 ENUMX
5110   BFD_RELOC_16C_IMM16
5111 ENUMX
5112   BFD_RELOC_16C_IMM16_C
5113 ENUMX
5114   BFD_RELOC_16C_IMM20
5115 ENUMX
5116   BFD_RELOC_16C_IMM20_C
5117 ENUMX
5118   BFD_RELOC_16C_IMM24
5119 ENUMX
5120   BFD_RELOC_16C_IMM24_C
5121 ENUMX
5122   BFD_RELOC_16C_IMM32
5123 ENUMX
5124   BFD_RELOC_16C_IMM32_C
5125 ENUMDOC
5126   NS CR16C Relocations.
5127
5128 ENUM
5129   BFD_RELOC_CR16_NUM8
5130 ENUMX
5131   BFD_RELOC_CR16_NUM16
5132 ENUMX
5133   BFD_RELOC_CR16_NUM32
5134 ENUMX
5135   BFD_RELOC_CR16_NUM32a
5136 ENUMX
5137   BFD_RELOC_CR16_REGREL0
5138 ENUMX
5139   BFD_RELOC_CR16_REGREL4
5140 ENUMX
5141   BFD_RELOC_CR16_REGREL4a
5142 ENUMX
5143   BFD_RELOC_CR16_REGREL14
5144 ENUMX
5145   BFD_RELOC_CR16_REGREL14a
5146 ENUMX
5147   BFD_RELOC_CR16_REGREL16
5148 ENUMX
5149   BFD_RELOC_CR16_REGREL20
5150 ENUMX
5151   BFD_RELOC_CR16_REGREL20a
5152 ENUMX
5153   BFD_RELOC_CR16_ABS20
5154 ENUMX
5155   BFD_RELOC_CR16_ABS24
5156 ENUMX
5157   BFD_RELOC_CR16_IMM4
5158 ENUMX
5159   BFD_RELOC_CR16_IMM8
5160 ENUMX
5161   BFD_RELOC_CR16_IMM16
5162 ENUMX
5163   BFD_RELOC_CR16_IMM20
5164 ENUMX
5165   BFD_RELOC_CR16_IMM24
5166 ENUMX
5167   BFD_RELOC_CR16_IMM32
5168 ENUMX
5169   BFD_RELOC_CR16_IMM32a
5170 ENUMX
5171   BFD_RELOC_CR16_DISP4
5172 ENUMX
5173   BFD_RELOC_CR16_DISP8
5174 ENUMX
5175   BFD_RELOC_CR16_DISP16
5176 ENUMX
5177   BFD_RELOC_CR16_DISP20
5178 ENUMX
5179   BFD_RELOC_CR16_DISP24
5180 ENUMX
5181   BFD_RELOC_CR16_DISP24a
5182 ENUMX
5183   BFD_RELOC_CR16_SWITCH8
5184 ENUMX
5185   BFD_RELOC_CR16_SWITCH16
5186 ENUMX
5187   BFD_RELOC_CR16_SWITCH32
5188 ENUMX
5189   BFD_RELOC_CR16_GOT_REGREL20
5190 ENUMX
5191   BFD_RELOC_CR16_GOTC_REGREL20
5192 ENUMX
5193   BFD_RELOC_CR16_GLOB_DAT
5194 ENUMDOC
5195   NS CR16 Relocations.
5196
5197 ENUM
5198   BFD_RELOC_CRX_REL4
5199 ENUMX
5200   BFD_RELOC_CRX_REL8
5201 ENUMX
5202   BFD_RELOC_CRX_REL8_CMP
5203 ENUMX
5204   BFD_RELOC_CRX_REL16
5205 ENUMX
5206   BFD_RELOC_CRX_REL24
5207 ENUMX
5208   BFD_RELOC_CRX_REL32
5209 ENUMX
5210   BFD_RELOC_CRX_REGREL12
5211 ENUMX
5212   BFD_RELOC_CRX_REGREL22
5213 ENUMX
5214   BFD_RELOC_CRX_REGREL28
5215 ENUMX
5216   BFD_RELOC_CRX_REGREL32
5217 ENUMX
5218   BFD_RELOC_CRX_ABS16
5219 ENUMX
5220   BFD_RELOC_CRX_ABS32
5221 ENUMX
5222   BFD_RELOC_CRX_NUM8
5223 ENUMX
5224   BFD_RELOC_CRX_NUM16
5225 ENUMX
5226   BFD_RELOC_CRX_NUM32
5227 ENUMX
5228   BFD_RELOC_CRX_IMM16
5229 ENUMX
5230   BFD_RELOC_CRX_IMM32
5231 ENUMX
5232   BFD_RELOC_CRX_SWITCH8
5233 ENUMX
5234   BFD_RELOC_CRX_SWITCH16
5235 ENUMX
5236   BFD_RELOC_CRX_SWITCH32
5237 ENUMDOC
5238   NS CRX Relocations.
5239
5240 ENUM
5241   BFD_RELOC_CRIS_BDISP8
5242 ENUMX
5243   BFD_RELOC_CRIS_UNSIGNED_5
5244 ENUMX
5245   BFD_RELOC_CRIS_SIGNED_6
5246 ENUMX
5247   BFD_RELOC_CRIS_UNSIGNED_6
5248 ENUMX
5249   BFD_RELOC_CRIS_SIGNED_8
5250 ENUMX
5251   BFD_RELOC_CRIS_UNSIGNED_8
5252 ENUMX
5253   BFD_RELOC_CRIS_SIGNED_16
5254 ENUMX
5255   BFD_RELOC_CRIS_UNSIGNED_16
5256 ENUMX
5257   BFD_RELOC_CRIS_LAPCQ_OFFSET
5258 ENUMX
5259   BFD_RELOC_CRIS_UNSIGNED_4
5260 ENUMDOC
5261   These relocs are only used within the CRIS assembler.  They are not
5262   (at present) written to any object files.
5263 ENUM
5264   BFD_RELOC_CRIS_COPY
5265 ENUMX
5266   BFD_RELOC_CRIS_GLOB_DAT
5267 ENUMX
5268   BFD_RELOC_CRIS_JUMP_SLOT
5269 ENUMX
5270   BFD_RELOC_CRIS_RELATIVE
5271 ENUMDOC
5272   Relocs used in ELF shared libraries for CRIS.
5273 ENUM
5274   BFD_RELOC_CRIS_32_GOT
5275 ENUMDOC
5276   32-bit offset to symbol-entry within GOT.
5277 ENUM
5278   BFD_RELOC_CRIS_16_GOT
5279 ENUMDOC
5280   16-bit offset to symbol-entry within GOT.
5281 ENUM
5282   BFD_RELOC_CRIS_32_GOTPLT
5283 ENUMDOC
5284   32-bit offset to symbol-entry within GOT, with PLT handling.
5285 ENUM
5286   BFD_RELOC_CRIS_16_GOTPLT
5287 ENUMDOC
5288   16-bit offset to symbol-entry within GOT, with PLT handling.
5289 ENUM
5290   BFD_RELOC_CRIS_32_GOTREL
5291 ENUMDOC
5292   32-bit offset to symbol, relative to GOT.
5293 ENUM
5294   BFD_RELOC_CRIS_32_PLT_GOTREL
5295 ENUMDOC
5296   32-bit offset to symbol with PLT entry, relative to GOT.
5297 ENUM
5298   BFD_RELOC_CRIS_32_PLT_PCREL
5299 ENUMDOC
5300   32-bit offset to symbol with PLT entry, relative to this relocation.
5301
5302 ENUM
5303   BFD_RELOC_CRIS_32_GOT_GD
5304 ENUMX
5305   BFD_RELOC_CRIS_16_GOT_GD
5306 ENUMX
5307   BFD_RELOC_CRIS_32_GD
5308 ENUMX
5309   BFD_RELOC_CRIS_DTP
5310 ENUMX
5311   BFD_RELOC_CRIS_32_DTPREL
5312 ENUMX
5313   BFD_RELOC_CRIS_16_DTPREL
5314 ENUMX
5315   BFD_RELOC_CRIS_32_GOT_TPREL
5316 ENUMX
5317   BFD_RELOC_CRIS_16_GOT_TPREL
5318 ENUMX
5319   BFD_RELOC_CRIS_32_TPREL
5320 ENUMX
5321   BFD_RELOC_CRIS_16_TPREL
5322 ENUMX
5323   BFD_RELOC_CRIS_DTPMOD
5324 ENUMX
5325   BFD_RELOC_CRIS_32_IE
5326 ENUMDOC
5327   Relocs used in TLS code for CRIS.
5328
5329 ENUM
5330   BFD_RELOC_860_COPY
5331 ENUMX
5332   BFD_RELOC_860_GLOB_DAT
5333 ENUMX
5334   BFD_RELOC_860_JUMP_SLOT
5335 ENUMX
5336   BFD_RELOC_860_RELATIVE
5337 ENUMX
5338   BFD_RELOC_860_PC26
5339 ENUMX
5340   BFD_RELOC_860_PLT26
5341 ENUMX
5342   BFD_RELOC_860_PC16
5343 ENUMX
5344   BFD_RELOC_860_LOW0
5345 ENUMX
5346   BFD_RELOC_860_SPLIT0
5347 ENUMX
5348   BFD_RELOC_860_LOW1
5349 ENUMX
5350   BFD_RELOC_860_SPLIT1
5351 ENUMX
5352   BFD_RELOC_860_LOW2
5353 ENUMX
5354   BFD_RELOC_860_SPLIT2
5355 ENUMX
5356   BFD_RELOC_860_LOW3
5357 ENUMX
5358   BFD_RELOC_860_LOGOT0
5359 ENUMX
5360   BFD_RELOC_860_SPGOT0
5361 ENUMX
5362   BFD_RELOC_860_LOGOT1
5363 ENUMX
5364   BFD_RELOC_860_SPGOT1
5365 ENUMX
5366   BFD_RELOC_860_LOGOTOFF0
5367 ENUMX
5368   BFD_RELOC_860_SPGOTOFF0
5369 ENUMX
5370   BFD_RELOC_860_LOGOTOFF1
5371 ENUMX
5372   BFD_RELOC_860_SPGOTOFF1
5373 ENUMX
5374   BFD_RELOC_860_LOGOTOFF2
5375 ENUMX
5376   BFD_RELOC_860_LOGOTOFF3
5377 ENUMX
5378   BFD_RELOC_860_LOPC
5379 ENUMX
5380   BFD_RELOC_860_HIGHADJ
5381 ENUMX
5382   BFD_RELOC_860_HAGOT
5383 ENUMX
5384   BFD_RELOC_860_HAGOTOFF
5385 ENUMX
5386   BFD_RELOC_860_HAPC
5387 ENUMX
5388   BFD_RELOC_860_HIGH
5389 ENUMX
5390   BFD_RELOC_860_HIGOT
5391 ENUMX
5392   BFD_RELOC_860_HIGOTOFF
5393 ENUMDOC
5394   Intel i860 Relocations.
5395
5396 ENUM
5397   BFD_RELOC_OPENRISC_ABS_26
5398 ENUMX
5399   BFD_RELOC_OPENRISC_REL_26
5400 ENUMDOC
5401   OpenRISC Relocations.
5402
5403 ENUM
5404   BFD_RELOC_H8_DIR16A8
5405 ENUMX
5406   BFD_RELOC_H8_DIR16R8
5407 ENUMX
5408   BFD_RELOC_H8_DIR24A8
5409 ENUMX
5410   BFD_RELOC_H8_DIR24R8
5411 ENUMX
5412   BFD_RELOC_H8_DIR32A16
5413 ENUMDOC
5414   H8 elf Relocations.
5415
5416 ENUM
5417   BFD_RELOC_XSTORMY16_REL_12
5418 ENUMX
5419   BFD_RELOC_XSTORMY16_12
5420 ENUMX
5421   BFD_RELOC_XSTORMY16_24
5422 ENUMX
5423   BFD_RELOC_XSTORMY16_FPTR16
5424 ENUMDOC
5425   Sony Xstormy16 Relocations.
5426
5427 ENUM
5428   BFD_RELOC_RELC
5429 ENUMDOC
5430   Self-describing complex relocations.
5431 COMMENT
5432
5433 ENUM
5434   BFD_RELOC_XC16X_PAG
5435 ENUMX
5436   BFD_RELOC_XC16X_POF
5437 ENUMX
5438   BFD_RELOC_XC16X_SEG
5439 ENUMX
5440   BFD_RELOC_XC16X_SOF
5441 ENUMDOC
5442   Infineon Relocations.
5443
5444 ENUM
5445   BFD_RELOC_VAX_GLOB_DAT
5446 ENUMX
5447   BFD_RELOC_VAX_JMP_SLOT
5448 ENUMX
5449   BFD_RELOC_VAX_RELATIVE
5450 ENUMDOC
5451   Relocations used by VAX ELF.
5452
5453 ENUM
5454   BFD_RELOC_MT_PC16
5455 ENUMDOC
5456   Morpho MT - 16 bit immediate relocation.
5457 ENUM
5458   BFD_RELOC_MT_HI16
5459 ENUMDOC
5460   Morpho MT - Hi 16 bits of an address.
5461 ENUM
5462   BFD_RELOC_MT_LO16
5463 ENUMDOC
5464   Morpho MT - Low 16 bits of an address.
5465 ENUM
5466   BFD_RELOC_MT_GNU_VTINHERIT
5467 ENUMDOC
5468   Morpho MT - Used to tell the linker which vtable entries are used.
5469 ENUM
5470   BFD_RELOC_MT_GNU_VTENTRY
5471 ENUMDOC
5472   Morpho MT - Used to tell the linker which vtable entries are used.
5473 ENUM
5474   BFD_RELOC_MT_PCINSN8
5475 ENUMDOC
5476   Morpho MT - 8 bit immediate relocation.
5477
5478 ENUM
5479   BFD_RELOC_MSP430_10_PCREL
5480 ENUMX
5481   BFD_RELOC_MSP430_16_PCREL
5482 ENUMX
5483   BFD_RELOC_MSP430_16
5484 ENUMX
5485   BFD_RELOC_MSP430_16_PCREL_BYTE
5486 ENUMX
5487   BFD_RELOC_MSP430_16_BYTE
5488 ENUMX
5489   BFD_RELOC_MSP430_2X_PCREL
5490 ENUMX
5491   BFD_RELOC_MSP430_RL_PCREL
5492 ENUMDOC
5493   msp430 specific relocation codes
5494
5495 ENUM
5496   BFD_RELOC_IQ2000_OFFSET_16
5497 ENUMX
5498   BFD_RELOC_IQ2000_OFFSET_21
5499 ENUMX
5500   BFD_RELOC_IQ2000_UHI16
5501 ENUMDOC
5502   IQ2000 Relocations.
5503
5504 ENUM
5505   BFD_RELOC_XTENSA_RTLD
5506 ENUMDOC
5507   Special Xtensa relocation used only by PLT entries in ELF shared
5508   objects to indicate that the runtime linker should set the value
5509   to one of its own internal functions or data structures.
5510 ENUM
5511   BFD_RELOC_XTENSA_GLOB_DAT
5512 ENUMX
5513   BFD_RELOC_XTENSA_JMP_SLOT
5514 ENUMX
5515   BFD_RELOC_XTENSA_RELATIVE
5516 ENUMDOC
5517   Xtensa relocations for ELF shared objects.
5518 ENUM
5519   BFD_RELOC_XTENSA_PLT
5520 ENUMDOC
5521   Xtensa relocation used in ELF object files for symbols that may require
5522   PLT entries.  Otherwise, this is just a generic 32-bit relocation.
5523 ENUM
5524   BFD_RELOC_XTENSA_DIFF8
5525 ENUMX
5526   BFD_RELOC_XTENSA_DIFF16
5527 ENUMX
5528   BFD_RELOC_XTENSA_DIFF32
5529 ENUMDOC
5530   Xtensa relocations to mark the difference of two local symbols.
5531   These are only needed to support linker relaxation and can be ignored
5532   when not relaxing.  The field is set to the value of the difference
5533   assuming no relaxation.  The relocation encodes the position of the
5534   first symbol so the linker can determine whether to adjust the field
5535   value.
5536 ENUM
5537   BFD_RELOC_XTENSA_SLOT0_OP
5538 ENUMX
5539   BFD_RELOC_XTENSA_SLOT1_OP
5540 ENUMX
5541   BFD_RELOC_XTENSA_SLOT2_OP
5542 ENUMX
5543   BFD_RELOC_XTENSA_SLOT3_OP
5544 ENUMX
5545   BFD_RELOC_XTENSA_SLOT4_OP
5546 ENUMX
5547   BFD_RELOC_XTENSA_SLOT5_OP
5548 ENUMX
5549   BFD_RELOC_XTENSA_SLOT6_OP
5550 ENUMX
5551   BFD_RELOC_XTENSA_SLOT7_OP
5552 ENUMX
5553   BFD_RELOC_XTENSA_SLOT8_OP
5554 ENUMX
5555   BFD_RELOC_XTENSA_SLOT9_OP
5556 ENUMX
5557   BFD_RELOC_XTENSA_SLOT10_OP
5558 ENUMX
5559   BFD_RELOC_XTENSA_SLOT11_OP
5560 ENUMX
5561   BFD_RELOC_XTENSA_SLOT12_OP
5562 ENUMX
5563   BFD_RELOC_XTENSA_SLOT13_OP
5564 ENUMX
5565   BFD_RELOC_XTENSA_SLOT14_OP
5566 ENUMDOC
5567   Generic Xtensa relocations for instruction operands.  Only the slot
5568   number is encoded in the relocation.  The relocation applies to the
5569   last PC-relative immediate operand, or if there are no PC-relative
5570   immediates, to the last immediate operand.
5571 ENUM
5572   BFD_RELOC_XTENSA_SLOT0_ALT
5573 ENUMX
5574   BFD_RELOC_XTENSA_SLOT1_ALT
5575 ENUMX
5576   BFD_RELOC_XTENSA_SLOT2_ALT
5577 ENUMX
5578   BFD_RELOC_XTENSA_SLOT3_ALT
5579 ENUMX
5580   BFD_RELOC_XTENSA_SLOT4_ALT
5581 ENUMX
5582   BFD_RELOC_XTENSA_SLOT5_ALT
5583 ENUMX
5584   BFD_RELOC_XTENSA_SLOT6_ALT
5585 ENUMX
5586   BFD_RELOC_XTENSA_SLOT7_ALT
5587 ENUMX
5588   BFD_RELOC_XTENSA_SLOT8_ALT
5589 ENUMX
5590   BFD_RELOC_XTENSA_SLOT9_ALT
5591 ENUMX
5592   BFD_RELOC_XTENSA_SLOT10_ALT
5593 ENUMX
5594   BFD_RELOC_XTENSA_SLOT11_ALT
5595 ENUMX
5596   BFD_RELOC_XTENSA_SLOT12_ALT
5597 ENUMX
5598   BFD_RELOC_XTENSA_SLOT13_ALT
5599 ENUMX
5600   BFD_RELOC_XTENSA_SLOT14_ALT
5601 ENUMDOC
5602   Alternate Xtensa relocations.  Only the slot is encoded in the
5603   relocation.  The meaning of these relocations is opcode-specific.
5604 ENUM
5605   BFD_RELOC_XTENSA_OP0
5606 ENUMX
5607   BFD_RELOC_XTENSA_OP1
5608 ENUMX
5609   BFD_RELOC_XTENSA_OP2
5610 ENUMDOC
5611   Xtensa relocations for backward compatibility.  These have all been
5612   replaced by BFD_RELOC_XTENSA_SLOT0_OP.
5613 ENUM
5614   BFD_RELOC_XTENSA_ASM_EXPAND
5615 ENUMDOC
5616   Xtensa relocation to mark that the assembler expanded the
5617   instructions from an original target.  The expansion size is
5618   encoded in the reloc size.
5619 ENUM
5620   BFD_RELOC_XTENSA_ASM_SIMPLIFY
5621 ENUMDOC
5622   Xtensa relocation to mark that the linker should simplify
5623   assembler-expanded instructions.  This is commonly used
5624   internally by the linker after analysis of a
5625   BFD_RELOC_XTENSA_ASM_EXPAND.
5626 ENUM
5627   BFD_RELOC_XTENSA_TLSDESC_FN
5628 ENUMX
5629   BFD_RELOC_XTENSA_TLSDESC_ARG
5630 ENUMX
5631   BFD_RELOC_XTENSA_TLS_DTPOFF
5632 ENUMX
5633   BFD_RELOC_XTENSA_TLS_TPOFF
5634 ENUMX
5635   BFD_RELOC_XTENSA_TLS_FUNC
5636 ENUMX
5637   BFD_RELOC_XTENSA_TLS_ARG
5638 ENUMX
5639   BFD_RELOC_XTENSA_TLS_CALL
5640 ENUMDOC
5641   Xtensa TLS relocations.
5642
5643 ENUM
5644   BFD_RELOC_Z80_DISP8
5645 ENUMDOC
5646   8 bit signed offset in (ix+d) or (iy+d).
5647
5648 ENUM
5649   BFD_RELOC_Z8K_DISP7
5650 ENUMDOC
5651   DJNZ offset.
5652 ENUM
5653   BFD_RELOC_Z8K_CALLR
5654 ENUMDOC
5655   CALR offset.
5656 ENUM
5657   BFD_RELOC_Z8K_IMM4L
5658 ENUMDOC
5659   4 bit value.
5660
5661 ENUM
5662    BFD_RELOC_LM32_CALL
5663 ENUMX
5664    BFD_RELOC_LM32_BRANCH
5665 ENUMX
5666    BFD_RELOC_LM32_16_GOT
5667 ENUMX
5668    BFD_RELOC_LM32_GOTOFF_HI16
5669 ENUMX
5670    BFD_RELOC_LM32_GOTOFF_LO16
5671 ENUMX
5672    BFD_RELOC_LM32_COPY
5673 ENUMX
5674    BFD_RELOC_LM32_GLOB_DAT
5675 ENUMX
5676    BFD_RELOC_LM32_JMP_SLOT
5677 ENUMX
5678    BFD_RELOC_LM32_RELATIVE
5679 ENUMDOC
5680  Lattice Mico32 relocations.
5681
5682 ENUM
5683   BFD_RELOC_MACH_O_SECTDIFF
5684 ENUMDOC
5685   Difference between two section addreses.  Must be followed by a
5686   BFD_RELOC_MACH_O_PAIR.
5687 ENUM
5688   BFD_RELOC_MACH_O_LOCAL_SECTDIFF
5689 ENUMDOC
5690   Like BFD_RELOC_MACH_O_SECTDIFF but with a local symbol.
5691 ENUM
5692   BFD_RELOC_MACH_O_PAIR
5693 ENUMDOC
5694   Pair of relocation.  Contains the first symbol.
5695
5696 ENUM
5697   BFD_RELOC_MACH_O_X86_64_BRANCH32
5698 ENUMX
5699   BFD_RELOC_MACH_O_X86_64_BRANCH8
5700 ENUMDOC
5701   PCREL relocations.  They are marked as branch to create PLT entry if
5702   required.
5703 ENUM
5704   BFD_RELOC_MACH_O_X86_64_GOT
5705 ENUMDOC
5706   Used when referencing a GOT entry.
5707 ENUM
5708   BFD_RELOC_MACH_O_X86_64_GOT_LOAD
5709 ENUMDOC
5710   Used when loading a GOT entry with movq.  It is specially marked so that
5711   the linker could optimize the movq to a leaq if possible.
5712 ENUM
5713   BFD_RELOC_MACH_O_X86_64_SUBTRACTOR32
5714 ENUMDOC
5715   Symbol will be substracted.  Must be followed by a BFD_RELOC_64.
5716 ENUM
5717   BFD_RELOC_MACH_O_X86_64_SUBTRACTOR64
5718 ENUMDOC
5719   Symbol will be substracted.  Must be followed by a BFD_RELOC_64.
5720 ENUM
5721   BFD_RELOC_MACH_O_X86_64_PCREL32_1
5722 ENUMDOC
5723   Same as BFD_RELOC_32_PCREL but with an implicit -1 addend.
5724 ENUM
5725   BFD_RELOC_MACH_O_X86_64_PCREL32_2
5726 ENUMDOC
5727   Same as BFD_RELOC_32_PCREL but with an implicit -2 addend.
5728 ENUM
5729   BFD_RELOC_MACH_O_X86_64_PCREL32_4
5730 ENUMDOC
5731   Same as BFD_RELOC_32_PCREL but with an implicit -4 addend.
5732
5733 ENUM
5734   BFD_RELOC_MICROBLAZE_32_LO
5735 ENUMDOC
5736   This is a 32 bit reloc for the microblaze that stores the
5737   low 16 bits of a value
5738 ENUM
5739   BFD_RELOC_MICROBLAZE_32_LO_PCREL
5740 ENUMDOC
5741   This is a 32 bit pc-relative reloc for the microblaze that
5742   stores the low 16 bits of a value
5743 ENUM
5744   BFD_RELOC_MICROBLAZE_32_ROSDA
5745 ENUMDOC
5746   This is a 32 bit reloc for the microblaze that stores a
5747   value relative to the read-only small data area anchor
5748 ENUM
5749   BFD_RELOC_MICROBLAZE_32_RWSDA
5750 ENUMDOC
5751   This is a 32 bit reloc for the microblaze that stores a
5752   value relative to the read-write small data area anchor
5753 ENUM
5754   BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM
5755 ENUMDOC
5756   This is a 32 bit reloc for the microblaze to handle
5757   expressions of the form "Symbol Op Symbol"
5758 ENUM
5759   BFD_RELOC_MICROBLAZE_64_NONE
5760 ENUMDOC
5761   This is a 64 bit reloc that stores the 32 bit pc relative
5762   value in two words (with an imm instruction).  No relocation is
5763   done here - only used for relaxing
5764 ENUM
5765   BFD_RELOC_MICROBLAZE_64_GOTPC
5766 ENUMDOC
5767   This is a 64 bit reloc that stores the 32 bit pc relative
5768   value in two words (with an imm instruction).  The relocation is
5769   PC-relative GOT offset
5770 ENUM
5771   BFD_RELOC_MICROBLAZE_64_GOT
5772 ENUMDOC
5773   This is a 64 bit reloc that stores the 32 bit pc relative
5774   value in two words (with an imm instruction).  The relocation is
5775   GOT offset
5776 ENUM
5777   BFD_RELOC_MICROBLAZE_64_PLT
5778 ENUMDOC
5779   This is a 64 bit reloc that stores the 32 bit pc relative
5780   value in two words (with an imm instruction).  The relocation is
5781   PC-relative offset into PLT
5782 ENUM
5783   BFD_RELOC_MICROBLAZE_64_GOTOFF
5784 ENUMDOC
5785   This is a 64 bit reloc that stores the 32 bit GOT relative
5786   value in two words (with an imm instruction).  The relocation is
5787   relative offset from _GLOBAL_OFFSET_TABLE_
5788 ENUM
5789   BFD_RELOC_MICROBLAZE_32_GOTOFF
5790 ENUMDOC
5791   This is a 32 bit reloc that stores the 32 bit GOT relative
5792   value in a word.  The relocation is relative offset from
5793   _GLOBAL_OFFSET_TABLE_
5794 ENUM
5795   BFD_RELOC_MICROBLAZE_COPY
5796 ENUMDOC
5797   This is used to tell the dynamic linker to copy the value out of
5798   the dynamic object into the runtime process image.
5799
5800 ENUM
5801   BFD_RELOC_TILEPRO_COPY
5802 ENUMX
5803   BFD_RELOC_TILEPRO_GLOB_DAT
5804 ENUMX
5805   BFD_RELOC_TILEPRO_JMP_SLOT
5806 ENUMX
5807   BFD_RELOC_TILEPRO_RELATIVE
5808 ENUMX
5809   BFD_RELOC_TILEPRO_BROFF_X1
5810 ENUMX
5811   BFD_RELOC_TILEPRO_JOFFLONG_X1
5812 ENUMX
5813   BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT
5814 ENUMX
5815   BFD_RELOC_TILEPRO_IMM8_X0
5816 ENUMX
5817   BFD_RELOC_TILEPRO_IMM8_Y0
5818 ENUMX
5819   BFD_RELOC_TILEPRO_IMM8_X1
5820 ENUMX
5821   BFD_RELOC_TILEPRO_IMM8_Y1
5822 ENUMX
5823   BFD_RELOC_TILEPRO_DEST_IMM8_X1
5824 ENUMX
5825   BFD_RELOC_TILEPRO_MT_IMM15_X1
5826 ENUMX
5827   BFD_RELOC_TILEPRO_MF_IMM15_X1
5828 ENUMX
5829   BFD_RELOC_TILEPRO_IMM16_X0
5830 ENUMX
5831   BFD_RELOC_TILEPRO_IMM16_X1
5832 ENUMX
5833   BFD_RELOC_TILEPRO_IMM16_X0_LO
5834 ENUMX
5835   BFD_RELOC_TILEPRO_IMM16_X1_LO
5836 ENUMX
5837   BFD_RELOC_TILEPRO_IMM16_X0_HI
5838 ENUMX
5839   BFD_RELOC_TILEPRO_IMM16_X1_HI
5840 ENUMX
5841   BFD_RELOC_TILEPRO_IMM16_X0_HA
5842 ENUMX
5843   BFD_RELOC_TILEPRO_IMM16_X1_HA
5844 ENUMX
5845   BFD_RELOC_TILEPRO_IMM16_X0_PCREL
5846 ENUMX
5847   BFD_RELOC_TILEPRO_IMM16_X1_PCREL
5848 ENUMX
5849   BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL
5850 ENUMX
5851   BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL
5852 ENUMX
5853   BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL
5854 ENUMX
5855   BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL
5856 ENUMX
5857   BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL
5858 ENUMX
5859   BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL
5860 ENUMX
5861   BFD_RELOC_TILEPRO_IMM16_X0_GOT
5862 ENUMX
5863   BFD_RELOC_TILEPRO_IMM16_X1_GOT
5864 ENUMX
5865   BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO
5866 ENUMX
5867   BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO
5868 ENUMX
5869   BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI
5870 ENUMX
5871   BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI
5872 ENUMX
5873   BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA
5874 ENUMX
5875   BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA
5876 ENUMX
5877   BFD_RELOC_TILEPRO_MMSTART_X0
5878 ENUMX
5879   BFD_RELOC_TILEPRO_MMEND_X0
5880 ENUMX
5881   BFD_RELOC_TILEPRO_MMSTART_X1
5882 ENUMX
5883   BFD_RELOC_TILEPRO_MMEND_X1
5884 ENUMX
5885   BFD_RELOC_TILEPRO_SHAMT_X0
5886 ENUMX
5887   BFD_RELOC_TILEPRO_SHAMT_X1
5888 ENUMX
5889   BFD_RELOC_TILEPRO_SHAMT_Y0
5890 ENUMX
5891   BFD_RELOC_TILEPRO_SHAMT_Y1
5892 ENUMX
5893   BFD_RELOC_TILEPRO_TLS_GD_CALL
5894 ENUMX
5895   BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD
5896 ENUMX
5897   BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD
5898 ENUMX
5899   BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD
5900 ENUMX
5901   BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD
5902 ENUMX
5903   BFD_RELOC_TILEPRO_TLS_IE_LOAD
5904 ENUMX
5905   BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD
5906 ENUMX
5907   BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD
5908 ENUMX
5909   BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO
5910 ENUMX
5911   BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO
5912 ENUMX
5913   BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI
5914 ENUMX
5915   BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI
5916 ENUMX
5917   BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA
5918 ENUMX
5919   BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA
5920 ENUMX
5921   BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE
5922 ENUMX
5923   BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE
5924 ENUMX
5925   BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO
5926 ENUMX
5927   BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO
5928 ENUMX
5929   BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI
5930 ENUMX
5931   BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI
5932 ENUMX
5933   BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA
5934 ENUMX
5935   BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA
5936 ENUMX
5937   BFD_RELOC_TILEPRO_TLS_DTPMOD32
5938 ENUMX
5939   BFD_RELOC_TILEPRO_TLS_DTPOFF32
5940 ENUMX
5941   BFD_RELOC_TILEPRO_TLS_TPOFF32
5942 ENUMX
5943   BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE
5944 ENUMX
5945   BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE
5946 ENUMX
5947   BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO
5948 ENUMX
5949   BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO
5950 ENUMX
5951   BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI
5952 ENUMX
5953   BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI
5954 ENUMX
5955   BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA
5956 ENUMX
5957   BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA
5958 ENUMDOC
5959   Tilera TILEPro Relocations.
5960
5961 ENUM
5962   BFD_RELOC_TILEGX_HW0
5963 ENUMX
5964   BFD_RELOC_TILEGX_HW1
5965 ENUMX
5966   BFD_RELOC_TILEGX_HW2
5967 ENUMX
5968   BFD_RELOC_TILEGX_HW3
5969 ENUMX
5970   BFD_RELOC_TILEGX_HW0_LAST
5971 ENUMX
5972   BFD_RELOC_TILEGX_HW1_LAST
5973 ENUMX
5974   BFD_RELOC_TILEGX_HW2_LAST
5975 ENUMX
5976   BFD_RELOC_TILEGX_COPY
5977 ENUMX
5978   BFD_RELOC_TILEGX_GLOB_DAT
5979 ENUMX
5980   BFD_RELOC_TILEGX_JMP_SLOT
5981 ENUMX
5982   BFD_RELOC_TILEGX_RELATIVE
5983 ENUMX
5984   BFD_RELOC_TILEGX_BROFF_X1
5985 ENUMX
5986   BFD_RELOC_TILEGX_JUMPOFF_X1
5987 ENUMX
5988   BFD_RELOC_TILEGX_JUMPOFF_X1_PLT
5989 ENUMX
5990   BFD_RELOC_TILEGX_IMM8_X0
5991 ENUMX
5992   BFD_RELOC_TILEGX_IMM8_Y0
5993 ENUMX
5994   BFD_RELOC_TILEGX_IMM8_X1
5995 ENUMX
5996   BFD_RELOC_TILEGX_IMM8_Y1
5997 ENUMX
5998   BFD_RELOC_TILEGX_DEST_IMM8_X1
5999 ENUMX
6000   BFD_RELOC_TILEGX_MT_IMM14_X1
6001 ENUMX
6002   BFD_RELOC_TILEGX_MF_IMM14_X1
6003 ENUMX
6004   BFD_RELOC_TILEGX_MMSTART_X0
6005 ENUMX
6006   BFD_RELOC_TILEGX_MMEND_X0
6007 ENUMX
6008   BFD_RELOC_TILEGX_SHAMT_X0
6009 ENUMX
6010   BFD_RELOC_TILEGX_SHAMT_X1
6011 ENUMX
6012   BFD_RELOC_TILEGX_SHAMT_Y0
6013 ENUMX
6014   BFD_RELOC_TILEGX_SHAMT_Y1
6015 ENUMX
6016   BFD_RELOC_TILEGX_IMM16_X0_HW0
6017 ENUMX
6018   BFD_RELOC_TILEGX_IMM16_X1_HW0
6019 ENUMX
6020   BFD_RELOC_TILEGX_IMM16_X0_HW1
6021 ENUMX
6022   BFD_RELOC_TILEGX_IMM16_X1_HW1
6023 ENUMX
6024   BFD_RELOC_TILEGX_IMM16_X0_HW2
6025 ENUMX
6026   BFD_RELOC_TILEGX_IMM16_X1_HW2
6027 ENUMX
6028   BFD_RELOC_TILEGX_IMM16_X0_HW3
6029 ENUMX
6030   BFD_RELOC_TILEGX_IMM16_X1_HW3
6031 ENUMX
6032   BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST
6033 ENUMX
6034   BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST
6035 ENUMX
6036   BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST
6037 ENUMX
6038   BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST
6039 ENUMX
6040   BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST
6041 ENUMX
6042   BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST
6043 ENUMX
6044   BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL
6045 ENUMX
6046   BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL
6047 ENUMX
6048   BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL
6049 ENUMX
6050   BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL
6051 ENUMX
6052   BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL
6053 ENUMX
6054   BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL
6055 ENUMX
6056   BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL
6057 ENUMX
6058   BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL
6059 ENUMX
6060   BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL
6061 ENUMX
6062   BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL
6063 ENUMX
6064   BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL
6065 ENUMX
6066   BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL
6067 ENUMX
6068   BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL
6069 ENUMX
6070   BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL
6071 ENUMX
6072   BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT
6073 ENUMX
6074   BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT
6075 ENUMX
6076   BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT
6077 ENUMX
6078   BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT
6079 ENUMX
6080   BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT
6081 ENUMX
6082   BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT
6083 ENUMX
6084   BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD
6085 ENUMX
6086   BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD
6087 ENUMX
6088   BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE
6089 ENUMX
6090   BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE
6091 ENUMX
6092   BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE
6093 ENUMX
6094   BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE
6095 ENUMX
6096   BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE
6097 ENUMX
6098   BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE
6099 ENUMX
6100   BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD
6101 ENUMX
6102   BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD
6103 ENUMX
6104   BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD
6105 ENUMX
6106   BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD
6107 ENUMX
6108   BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE
6109 ENUMX
6110   BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE
6111 ENUMX
6112   BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE
6113 ENUMX
6114   BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE
6115 ENUMX
6116   BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE
6117 ENUMX
6118   BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE
6119 ENUMX
6120   BFD_RELOC_TILEGX_TLS_DTPMOD64
6121 ENUMX
6122   BFD_RELOC_TILEGX_TLS_DTPOFF64
6123 ENUMX
6124   BFD_RELOC_TILEGX_TLS_TPOFF64
6125 ENUMX
6126   BFD_RELOC_TILEGX_TLS_DTPMOD32
6127 ENUMX
6128   BFD_RELOC_TILEGX_TLS_DTPOFF32
6129 ENUMX
6130   BFD_RELOC_TILEGX_TLS_TPOFF32
6131 ENUMX
6132   BFD_RELOC_TILEGX_TLS_GD_CALL
6133 ENUMX
6134   BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD
6135 ENUMX
6136   BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD
6137 ENUMX
6138   BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD
6139 ENUMX
6140   BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD
6141 ENUMX
6142   BFD_RELOC_TILEGX_TLS_IE_LOAD
6143 ENUMX
6144   BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD
6145 ENUMX
6146   BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD
6147 ENUMX
6148   BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD
6149 ENUMX
6150   BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD
6151 ENUMDOC
6152   Tilera TILE-Gx Relocations.
6153
6154 ENUM
6155   BFD_RELOC_EPIPHANY_SIMM8
6156 ENUMDOC
6157   Adapteva EPIPHANY - 8 bit signed pc-relative displacement
6158 ENUM
6159   BFD_RELOC_EPIPHANY_SIMM24
6160 ENUMDOC
6161   Adapteva EPIPHANY - 24 bit signed pc-relative displacement
6162 ENUM
6163   BFD_RELOC_EPIPHANY_HIGH
6164 ENUMDOC
6165   Adapteva EPIPHANY - 16 most-significant bits of absolute address
6166 ENUM
6167   BFD_RELOC_EPIPHANY_LOW
6168 ENUMDOC
6169   Adapteva EPIPHANY - 16 least-significant bits of absolute address
6170 ENUM
6171   BFD_RELOC_EPIPHANY_SIMM11
6172 ENUMDOC
6173   Adapteva EPIPHANY - 11 bit signed number - add/sub immediate
6174 ENUM
6175   BFD_RELOC_EPIPHANY_IMM11
6176 ENUMDOC
6177   Adapteva EPIPHANY - 11 bit sign-magnitude number (ld/st displacement)
6178 ENUM
6179   BFD_RELOC_EPIPHANY_IMM8
6180 ENUMDOC
6181   Adapteva EPIPHANY - 8 bit immediate for 16 bit mov instruction.
6182
6183
6184 ENDSENUM
6185   BFD_RELOC_UNUSED
6186 CODE_FRAGMENT
6187 .
6188 .typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
6189 */
6190
6191 /*
6192 FUNCTION
6193         bfd_reloc_type_lookup
6194         bfd_reloc_name_lookup
6195
6196 SYNOPSIS
6197         reloc_howto_type *bfd_reloc_type_lookup
6198           (bfd *abfd, bfd_reloc_code_real_type code);
6199         reloc_howto_type *bfd_reloc_name_lookup
6200           (bfd *abfd, const char *reloc_name);
6201
6202 DESCRIPTION
6203         Return a pointer to a howto structure which, when
6204         invoked, will perform the relocation @var{code} on data from the
6205         architecture noted.
6206
6207 */
6208
6209 reloc_howto_type *
6210 bfd_reloc_type_lookup (bfd *abfd, bfd_reloc_code_real_type code)
6211 {
6212   return BFD_SEND (abfd, reloc_type_lookup, (abfd, code));
6213 }
6214
6215 reloc_howto_type *
6216 bfd_reloc_name_lookup (bfd *abfd, const char *reloc_name)
6217 {
6218   return BFD_SEND (abfd, reloc_name_lookup, (abfd, reloc_name));
6219 }
6220
6221 static reloc_howto_type bfd_howto_32 =
6222 HOWTO (0, 00, 2, 32, FALSE, 0, complain_overflow_dont, 0, "VRT32", FALSE, 0xffffffff, 0xffffffff, TRUE);
6223
6224 /*
6225 INTERNAL_FUNCTION
6226         bfd_default_reloc_type_lookup
6227
6228 SYNOPSIS
6229         reloc_howto_type *bfd_default_reloc_type_lookup
6230           (bfd *abfd, bfd_reloc_code_real_type  code);
6231
6232 DESCRIPTION
6233         Provides a default relocation lookup routine for any architecture.
6234
6235 */
6236
6237 reloc_howto_type *
6238 bfd_default_reloc_type_lookup (bfd *abfd, bfd_reloc_code_real_type code)
6239 {
6240   switch (code)
6241     {
6242     case BFD_RELOC_CTOR:
6243       /* The type of reloc used in a ctor, which will be as wide as the
6244          address - so either a 64, 32, or 16 bitter.  */
6245       switch (bfd_arch_bits_per_address (abfd))
6246         {
6247         case 64:
6248           BFD_FAIL ();
6249         case 32:
6250           return &bfd_howto_32;
6251         case 16:
6252           BFD_FAIL ();
6253         default:
6254           BFD_FAIL ();
6255         }
6256     default:
6257       BFD_FAIL ();
6258     }
6259   return NULL;
6260 }
6261
6262 /*
6263 FUNCTION
6264         bfd_get_reloc_code_name
6265
6266 SYNOPSIS
6267         const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code);
6268
6269 DESCRIPTION
6270         Provides a printable name for the supplied relocation code.
6271         Useful mainly for printing error messages.
6272 */
6273
6274 const char *
6275 bfd_get_reloc_code_name (bfd_reloc_code_real_type code)
6276 {
6277   if (code > BFD_RELOC_UNUSED)
6278     return 0;
6279   return bfd_reloc_code_real_names[code];
6280 }
6281
6282 /*
6283 INTERNAL_FUNCTION
6284         bfd_generic_relax_section
6285
6286 SYNOPSIS
6287         bfd_boolean bfd_generic_relax_section
6288           (bfd *abfd,
6289            asection *section,
6290            struct bfd_link_info *,
6291            bfd_boolean *);
6292
6293 DESCRIPTION
6294         Provides default handling for relaxing for back ends which
6295         don't do relaxing.
6296 */
6297
6298 bfd_boolean
6299 bfd_generic_relax_section (bfd *abfd ATTRIBUTE_UNUSED,
6300                            asection *section ATTRIBUTE_UNUSED,
6301                            struct bfd_link_info *link_info ATTRIBUTE_UNUSED,
6302                            bfd_boolean *again)
6303 {
6304   if (link_info->relocatable)
6305     (*link_info->callbacks->einfo)
6306       (_("%P%F: --relax and -r may not be used together\n"));
6307
6308   *again = FALSE;
6309   return TRUE;
6310 }
6311
6312 /*
6313 INTERNAL_FUNCTION
6314         bfd_generic_gc_sections
6315
6316 SYNOPSIS
6317         bfd_boolean bfd_generic_gc_sections
6318           (bfd *, struct bfd_link_info *);
6319
6320 DESCRIPTION
6321         Provides default handling for relaxing for back ends which
6322         don't do section gc -- i.e., does nothing.
6323 */
6324
6325 bfd_boolean
6326 bfd_generic_gc_sections (bfd *abfd ATTRIBUTE_UNUSED,
6327                          struct bfd_link_info *info ATTRIBUTE_UNUSED)
6328 {
6329   return TRUE;
6330 }
6331
6332 /*
6333 INTERNAL_FUNCTION
6334         bfd_generic_lookup_section_flags
6335
6336 SYNOPSIS
6337         void bfd_generic_lookup_section_flags
6338           (struct bfd_link_info *, struct flag_info *);
6339
6340 DESCRIPTION
6341         Provides default handling for section flags lookup
6342         -- i.e., does nothing.
6343 */
6344
6345 void
6346 bfd_generic_lookup_section_flags (struct bfd_link_info *info ATTRIBUTE_UNUSED,
6347                                   struct flag_info *flaginfo)
6348 {
6349   if (flaginfo != NULL)
6350     {
6351       (*_bfd_error_handler) (_("INPUT_SECTION_FLAGS are not supported.\n"));
6352       return;
6353     }
6354 }
6355
6356 /*
6357 INTERNAL_FUNCTION
6358         bfd_generic_merge_sections
6359
6360 SYNOPSIS
6361         bfd_boolean bfd_generic_merge_sections
6362           (bfd *, struct bfd_link_info *);
6363
6364 DESCRIPTION
6365         Provides default handling for SEC_MERGE section merging for back ends
6366         which don't have SEC_MERGE support -- i.e., does nothing.
6367 */
6368
6369 bfd_boolean
6370 bfd_generic_merge_sections (bfd *abfd ATTRIBUTE_UNUSED,
6371                             struct bfd_link_info *link_info ATTRIBUTE_UNUSED)
6372 {
6373   return TRUE;
6374 }
6375
6376 /*
6377 INTERNAL_FUNCTION
6378         bfd_generic_get_relocated_section_contents
6379
6380 SYNOPSIS
6381         bfd_byte *bfd_generic_get_relocated_section_contents
6382           (bfd *abfd,
6383            struct bfd_link_info *link_info,
6384            struct bfd_link_order *link_order,
6385            bfd_byte *data,
6386            bfd_boolean relocatable,
6387            asymbol **symbols);
6388
6389 DESCRIPTION
6390         Provides default handling of relocation effort for back ends
6391         which can't be bothered to do it efficiently.
6392
6393 */
6394
6395 bfd_byte *
6396 bfd_generic_get_relocated_section_contents (bfd *abfd,
6397                                             struct bfd_link_info *link_info,
6398                                             struct bfd_link_order *link_order,
6399                                             bfd_byte *data,
6400                                             bfd_boolean relocatable,
6401                                             asymbol **symbols)
6402 {
6403   bfd *input_bfd = link_order->u.indirect.section->owner;
6404   asection *input_section = link_order->u.indirect.section;
6405   long reloc_size;
6406   arelent **reloc_vector;
6407   long reloc_count;
6408
6409   reloc_size = bfd_get_reloc_upper_bound (input_bfd, input_section);
6410   if (reloc_size < 0)
6411     return NULL;
6412
6413   /* Read in the section.  */
6414   if (!bfd_get_full_section_contents (input_bfd, input_section, &data))
6415     return NULL;
6416
6417   if (reloc_size == 0)
6418     return data;
6419
6420   reloc_vector = (arelent **) bfd_malloc (reloc_size);
6421   if (reloc_vector == NULL)
6422     return NULL;
6423
6424   reloc_count = bfd_canonicalize_reloc (input_bfd,
6425                                         input_section,
6426                                         reloc_vector,
6427                                         symbols);
6428   if (reloc_count < 0)
6429     goto error_return;
6430
6431   if (reloc_count > 0)
6432     {
6433       arelent **parent;
6434       for (parent = reloc_vector; *parent != NULL; parent++)
6435         {
6436           char *error_message = NULL;
6437           asymbol *symbol;
6438           bfd_reloc_status_type r;
6439
6440           symbol = *(*parent)->sym_ptr_ptr;
6441           if (symbol->section && discarded_section (symbol->section))
6442             {
6443               bfd_byte *p;
6444               static reloc_howto_type none_howto
6445                 = HOWTO (0, 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL,
6446                          "unused", FALSE, 0, 0, FALSE);
6447
6448               p = data + (*parent)->address * bfd_octets_per_byte (input_bfd);
6449               _bfd_clear_contents ((*parent)->howto, input_bfd, input_section,
6450                                    p);
6451               (*parent)->sym_ptr_ptr = bfd_abs_section.symbol_ptr_ptr;
6452               (*parent)->addend = 0;
6453               (*parent)->howto = &none_howto;
6454               r = bfd_reloc_ok;
6455             }
6456           else
6457             r = bfd_perform_relocation (input_bfd,
6458                                         *parent,
6459                                         data,
6460                                         input_section,
6461                                         relocatable ? abfd : NULL,
6462                                         &error_message);
6463
6464           if (relocatable)
6465             {
6466               asection *os = input_section->output_section;
6467
6468               /* A partial link, so keep the relocs.  */
6469               os->orelocation[os->reloc_count] = *parent;
6470               os->reloc_count++;
6471             }
6472
6473           if (r != bfd_reloc_ok)
6474             {
6475               switch (r)
6476                 {
6477                 case bfd_reloc_undefined:
6478                   if (!((*link_info->callbacks->undefined_symbol)
6479                         (link_info, bfd_asymbol_name (*(*parent)->sym_ptr_ptr),
6480                          input_bfd, input_section, (*parent)->address,
6481                          TRUE)))
6482                     goto error_return;
6483                   break;
6484                 case bfd_reloc_dangerous:
6485                   BFD_ASSERT (error_message != NULL);
6486                   if (!((*link_info->callbacks->reloc_dangerous)
6487                         (link_info, error_message, input_bfd, input_section,
6488                          (*parent)->address)))
6489                     goto error_return;
6490                   break;
6491                 case bfd_reloc_overflow:
6492                   if (!((*link_info->callbacks->reloc_overflow)
6493                         (link_info, NULL,
6494                          bfd_asymbol_name (*(*parent)->sym_ptr_ptr),
6495                          (*parent)->howto->name, (*parent)->addend,
6496                          input_bfd, input_section, (*parent)->address)))
6497                     goto error_return;
6498                   break;
6499                 case bfd_reloc_outofrange:
6500                   /* PR ld/13730:
6501                      This error can result when processing some partially
6502                      complete binaries.  Do not abort, but issue an error
6503                      message instead.  */
6504                   link_info->callbacks->einfo
6505                     (_("%X%P: %B(%A): relocation \"%R\" goes out of range\n"),
6506                      abfd, input_section, * parent);
6507                   goto error_return;
6508
6509                 default:
6510                   abort ();
6511                   break;
6512                 }
6513
6514             }
6515         }
6516     }
6517
6518   free (reloc_vector);
6519   return data;
6520
6521 error_return:
6522   free (reloc_vector);
6523   return NULL;
6524 }