Merge branch 'vendor/OPENSSL'
[dragonfly.git] / contrib / binutils-2.22 / 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    Free Software Foundation, Inc.
5    Written by Cygnus Support.
6
7    This file is part of BFD, the Binary File Descriptor library.
8
9    This program is free software; you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation; either version 3 of the License, or
12    (at your option) any later version.
13
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18
19    You should have received a copy of the GNU General Public License
20    along with this program; if not, write to the Free Software
21    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
22    MA 02110-1301, USA.  */
23
24 /*
25 SECTION
26         Relocations
27
28         BFD maintains relocations in much the same way it maintains
29         symbols: they are left alone until required, then read in
30         en-masse and translated into an internal form.  A common
31         routine <<bfd_perform_relocation>> acts upon the
32         canonical form to do the fixup.
33
34         Relocations are maintained on a per section basis,
35         while symbols are maintained on a per BFD basis.
36
37         All that a back end has to do to fit the BFD interface is to create
38         a <<struct reloc_cache_entry>> for each relocation
39         in a particular section, and fill in the right bits of the structures.
40
41 @menu
42 @* typedef arelent::
43 @* howto manager::
44 @end menu
45
46 */
47
48 /* DO compile in the reloc_code name table from libbfd.h.  */
49 #define _BFD_MAKE_TABLE_bfd_reloc_code_real
50
51 #include "sysdep.h"
52 #include "bfd.h"
53 #include "bfdlink.h"
54 #include "libbfd.h"
55 /*
56 DOCDD
57 INODE
58         typedef arelent, howto manager, Relocations, Relocations
59
60 SUBSECTION
61         typedef arelent
62
63         This is the structure of a relocation entry:
64
65 CODE_FRAGMENT
66 .
67 .typedef enum bfd_reloc_status
68 .{
69 .  {* No errors detected.  *}
70 .  bfd_reloc_ok,
71 .
72 .  {* The relocation was performed, but there was an overflow.  *}
73 .  bfd_reloc_overflow,
74 .
75 .  {* The address to relocate was not within the section supplied.  *}
76 .  bfd_reloc_outofrange,
77 .
78 .  {* Used by special functions.  *}
79 .  bfd_reloc_continue,
80 .
81 .  {* Unsupported relocation size requested.  *}
82 .  bfd_reloc_notsupported,
83 .
84 .  {* Unused.  *}
85 .  bfd_reloc_other,
86 .
87 .  {* The symbol to relocate against was undefined.  *}
88 .  bfd_reloc_undefined,
89 .
90 .  {* The relocation was performed, but may not be ok - presently
91 .     generated only when linking i960 coff files with i960 b.out
92 .     symbols.  If this type is returned, the error_message argument
93 .     to bfd_perform_relocation will be set.  *}
94 .  bfd_reloc_dangerous
95 . }
96 . bfd_reloc_status_type;
97 .
98 .
99 .typedef struct reloc_cache_entry
100 .{
101 .  {* A pointer into the canonical table of pointers.  *}
102 .  struct bfd_symbol **sym_ptr_ptr;
103 .
104 .  {* offset in section.  *}
105 .  bfd_size_type address;
106 .
107 .  {* addend for relocation value.  *}
108 .  bfd_vma addend;
109 .
110 .  {* Pointer to how to perform the required relocation.  *}
111 .  reloc_howto_type *howto;
112 .
113 .}
114 .arelent;
115 .
116 */
117
118 /*
119 DESCRIPTION
120
121         Here is a description of each of the fields within an <<arelent>>:
122
123         o <<sym_ptr_ptr>>
124
125         The symbol table pointer points to a pointer to the symbol
126         associated with the relocation request.  It is the pointer
127         into the table returned by the back end's
128         <<canonicalize_symtab>> action. @xref{Symbols}. The symbol is
129         referenced through a pointer to a pointer so that tools like
130         the linker can fix up all the symbols of the same name by
131         modifying only one pointer. The relocation routine looks in
132         the symbol and uses the base of the section the symbol is
133         attached to and the value of the symbol as the initial
134         relocation offset. If the symbol pointer is zero, then the
135         section provided is looked up.
136
137         o <<address>>
138
139         The <<address>> field gives the offset in bytes from the base of
140         the section data which owns the relocation record to the first
141         byte of relocatable information. The actual data relocated
142         will be relative to this point; for example, a relocation
143         type which modifies the bottom two bytes of a four byte word
144         would not touch the first byte pointed to in a big endian
145         world.
146
147         o <<addend>>
148
149         The <<addend>> is a value provided by the back end to be added (!)
150         to the relocation offset. Its interpretation is dependent upon
151         the howto. For example, on the 68k the code:
152
153 |        char foo[];
154 |        main()
155 |                {
156 |                return foo[0x12345678];
157 |                }
158
159         Could be compiled into:
160
161 |        linkw fp,#-4
162 |        moveb @@#12345678,d0
163 |        extbl d0
164 |        unlk fp
165 |        rts
166
167         This could create a reloc pointing to <<foo>>, but leave the
168         offset in the data, something like:
169
170 |RELOCATION RECORDS FOR [.text]:
171 |offset   type      value
172 |00000006 32        _foo
173 |
174 |00000000 4e56 fffc          ; linkw fp,#-4
175 |00000004 1039 1234 5678     ; moveb @@#12345678,d0
176 |0000000a 49c0               ; extbl d0
177 |0000000c 4e5e               ; unlk fp
178 |0000000e 4e75               ; rts
179
180         Using coff and an 88k, some instructions don't have enough
181         space in them to represent the full address range, and
182         pointers have to be loaded in two parts. So you'd get something like:
183
184 |        or.u     r13,r0,hi16(_foo+0x12345678)
185 |        ld.b     r2,r13,lo16(_foo+0x12345678)
186 |        jmp      r1
187
188         This should create two relocs, both pointing to <<_foo>>, and with
189         0x12340000 in their addend field. The data would consist of:
190
191 |RELOCATION RECORDS FOR [.text]:
192 |offset   type      value
193 |00000002 HVRT16    _foo+0x12340000
194 |00000006 LVRT16    _foo+0x12340000
195 |
196 |00000000 5da05678           ; or.u r13,r0,0x5678
197 |00000004 1c4d5678           ; ld.b r2,r13,0x5678
198 |00000008 f400c001           ; jmp r1
199
200         The relocation routine digs out the value from the data, adds
201         it to the addend to get the original offset, and then adds the
202         value of <<_foo>>. Note that all 32 bits have to be kept around
203         somewhere, to cope with carry from bit 15 to bit 16.
204
205         One further example is the sparc and the a.out format. The
206         sparc has a similar problem to the 88k, in that some
207         instructions don't have room for an entire offset, but on the
208         sparc the parts are created in odd sized lumps. The designers of
209         the a.out format chose to not use the data within the section
210         for storing part of the offset; all the offset is kept within
211         the reloc. Anything in the data should be ignored.
212
213 |        save %sp,-112,%sp
214 |        sethi %hi(_foo+0x12345678),%g2
215 |        ldsb [%g2+%lo(_foo+0x12345678)],%i0
216 |        ret
217 |        restore
218
219         Both relocs contain a pointer to <<foo>>, and the offsets
220         contain junk.
221
222 |RELOCATION RECORDS FOR [.text]:
223 |offset   type      value
224 |00000004 HI22      _foo+0x12345678
225 |00000008 LO10      _foo+0x12345678
226 |
227 |00000000 9de3bf90     ; save %sp,-112,%sp
228 |00000004 05000000     ; sethi %hi(_foo+0),%g2
229 |00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
230 |0000000c 81c7e008     ; ret
231 |00000010 81e80000     ; restore
232
233         o <<howto>>
234
235         The <<howto>> field can be imagined as a
236         relocation instruction. It is a pointer to a structure which
237         contains information on what to do with all of the other
238         information in the reloc record and data section. A back end
239         would normally have a relocation instruction set and turn
240         relocations into pointers to the correct structure on input -
241         but it would be possible to create each howto field on demand.
242
243 */
244
245 /*
246 SUBSUBSECTION
247         <<enum complain_overflow>>
248
249         Indicates what sort of overflow checking should be done when
250         performing a relocation.
251
252 CODE_FRAGMENT
253 .
254 .enum complain_overflow
255 .{
256 .  {* Do not complain on overflow.  *}
257 .  complain_overflow_dont,
258 .
259 .  {* Complain if the value overflows when considered as a signed
260 .     number one bit larger than the field.  ie. A bitfield of N bits
261 .     is allowed to represent -2**n to 2**n-1.  *}
262 .  complain_overflow_bitfield,
263 .
264 .  {* Complain if the value overflows when considered as a signed
265 .     number.  *}
266 .  complain_overflow_signed,
267 .
268 .  {* Complain if the value overflows when considered as an
269 .     unsigned number.  *}
270 .  complain_overflow_unsigned
271 .};
272
273 */
274
275 /*
276 SUBSUBSECTION
277         <<reloc_howto_type>>
278
279         The <<reloc_howto_type>> is a structure which contains all the
280         information that libbfd needs to know to tie up a back end's data.
281
282 CODE_FRAGMENT
283 .struct bfd_symbol;             {* Forward declaration.  *}
284 .
285 .struct reloc_howto_struct
286 .{
287 .  {*  The type field has mainly a documentary use - the back end can
288 .      do what it wants with it, though normally the back end's
289 .      external idea of what a reloc number is stored
290 .      in this field.  For example, a PC relative word relocation
291 .      in a coff environment has the type 023 - because that's
292 .      what the outside world calls a R_PCRWORD reloc.  *}
293 .  unsigned int type;
294 .
295 .  {*  The value the final relocation is shifted right by.  This drops
296 .      unwanted data from the relocation.  *}
297 .  unsigned int rightshift;
298 .
299 .  {*  The size of the item to be relocated.  This is *not* a
300 .      power-of-two measure.  To get the number of bytes operated
301 .      on by a type of relocation, use bfd_get_reloc_size.  *}
302 .  int size;
303 .
304 .  {*  The number of bits in the item to be relocated.  This is used
305 .      when doing overflow checking.  *}
306 .  unsigned int bitsize;
307 .
308 .  {*  The relocation is relative to the field being relocated.  *}
309 .  bfd_boolean pc_relative;
310 .
311 .  {*  The bit position of the reloc value in the destination.
312 .      The relocated value is left shifted by this amount.  *}
313 .  unsigned int bitpos;
314 .
315 .  {* What type of overflow error should be checked for when
316 .     relocating.  *}
317 .  enum complain_overflow complain_on_overflow;
318 .
319 .  {* If this field is non null, then the supplied function is
320 .     called rather than the normal function.  This allows really
321 .     strange relocation methods to be accommodated (e.g., i960 callj
322 .     instructions).  *}
323 .  bfd_reloc_status_type (*special_function)
324 .    (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
325 .     bfd *, char **);
326 .
327 .  {* The textual name of the relocation type.  *}
328 .  char *name;
329 .
330 .  {* Some formats record a relocation addend in the section contents
331 .     rather than with the relocation.  For ELF formats this is the
332 .     distinction between USE_REL and USE_RELA (though the code checks
333 .     for USE_REL == 1/0).  The value of this field is TRUE if the
334 .     addend is recorded with the section contents; when performing a
335 .     partial link (ld -r) the section contents (the data) will be
336 .     modified.  The value of this field is FALSE if addends are
337 .     recorded with the relocation (in arelent.addend); when performing
338 .     a partial link the relocation will be modified.
339 .     All relocations for all ELF USE_RELA targets should set this field
340 .     to FALSE (values of TRUE should be looked on with suspicion).
341 .     However, the converse is not true: not all relocations of all ELF
342 .     USE_REL targets set this field to TRUE.  Why this is so is peculiar
343 .     to each particular target.  For relocs that aren't used in partial
344 .     links (e.g. GOT stuff) it doesn't matter what this is set to.  *}
345 .  bfd_boolean partial_inplace;
346 .
347 .  {* src_mask selects the part of the instruction (or data) to be used
348 .     in the relocation sum.  If the target relocations don't have an
349 .     addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
350 .     dst_mask to extract the addend from the section contents.  If
351 .     relocations do have an addend in the reloc, eg. ELF USE_RELA, this
352 .     field should be zero.  Non-zero values for ELF USE_RELA targets are
353 .     bogus as in those cases the value in the dst_mask part of the
354 .     section contents should be treated as garbage.  *}
355 .  bfd_vma src_mask;
356 .
357 .  {* dst_mask selects which parts of the instruction (or data) are
358 .     replaced with a relocated value.  *}
359 .  bfd_vma dst_mask;
360 .
361 .  {* When some formats create PC relative instructions, they leave
362 .     the value of the pc of the place being relocated in the offset
363 .     slot of the instruction, so that a PC relative relocation can
364 .     be made just by adding in an ordinary offset (e.g., sun3 a.out).
365 .     Some formats leave the displacement part of an instruction
366 .     empty (e.g., m88k bcs); this flag signals the fact.  *}
367 .  bfd_boolean pcrel_offset;
368 .};
369 .
370 */
371
372 /*
373 FUNCTION
374         The HOWTO Macro
375
376 DESCRIPTION
377         The HOWTO define is horrible and will go away.
378
379 .#define HOWTO(C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
380 .  { (unsigned) C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC }
381
382 DESCRIPTION
383         And will be replaced with the totally magic way. But for the
384         moment, we are compatible, so do it this way.
385
386 .#define NEWHOWTO(FUNCTION, NAME, SIZE, REL, IN) \
387 .  HOWTO (0, 0, SIZE, 0, REL, 0, complain_overflow_dont, FUNCTION, \
388 .         NAME, FALSE, 0, 0, IN)
389 .
390
391 DESCRIPTION
392         This is used to fill in an empty howto entry in an array.
393
394 .#define EMPTY_HOWTO(C) \
395 .  HOWTO ((C), 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL, \
396 .         NULL, FALSE, 0, 0, FALSE)
397 .
398
399 DESCRIPTION
400         Helper routine to turn a symbol into a relocation value.
401
402 .#define HOWTO_PREPARE(relocation, symbol)               \
403 .  {                                                     \
404 .    if (symbol != NULL)                                 \
405 .      {                                                 \
406 .        if (bfd_is_com_section (symbol->section))       \
407 .          {                                             \
408 .            relocation = 0;                             \
409 .          }                                             \
410 .        else                                            \
411 .          {                                             \
412 .            relocation = symbol->value;                 \
413 .          }                                             \
414 .      }                                                 \
415 .  }
416 .
417 */
418
419 /*
420 FUNCTION
421         bfd_get_reloc_size
422
423 SYNOPSIS
424         unsigned int bfd_get_reloc_size (reloc_howto_type *);
425
426 DESCRIPTION
427         For a reloc_howto_type that operates on a fixed number of bytes,
428         this returns the number of bytes operated on.
429  */
430
431 unsigned int
432 bfd_get_reloc_size (reloc_howto_type *howto)
433 {
434   switch (howto->size)
435     {
436     case 0: return 1;
437     case 1: return 2;
438     case 2: return 4;
439     case 3: return 0;
440     case 4: return 8;
441     case 8: return 16;
442     case -2: return 4;
443     default: abort ();
444     }
445 }
446
447 /*
448 TYPEDEF
449         arelent_chain
450
451 DESCRIPTION
452
453         How relocs are tied together in an <<asection>>:
454
455 .typedef struct relent_chain
456 .{
457 .  arelent relent;
458 .  struct relent_chain *next;
459 .}
460 .arelent_chain;
461 .
462 */
463
464 /* N_ONES produces N one bits, without overflowing machine arithmetic.  */
465 #define N_ONES(n) (((((bfd_vma) 1 << ((n) - 1)) - 1) << 1) | 1)
466
467 /*
468 FUNCTION
469         bfd_check_overflow
470
471 SYNOPSIS
472         bfd_reloc_status_type bfd_check_overflow
473           (enum complain_overflow how,
474            unsigned int bitsize,
475            unsigned int rightshift,
476            unsigned int addrsize,
477            bfd_vma relocation);
478
479 DESCRIPTION
480         Perform overflow checking on @var{relocation} which has
481         @var{bitsize} significant bits and will be shifted right by
482         @var{rightshift} bits, on a machine with addresses containing
483         @var{addrsize} significant bits.  The result is either of
484         @code{bfd_reloc_ok} or @code{bfd_reloc_overflow}.
485
486 */
487
488 bfd_reloc_status_type
489 bfd_check_overflow (enum complain_overflow how,
490                     unsigned int bitsize,
491                     unsigned int rightshift,
492                     unsigned int addrsize,
493                     bfd_vma relocation)
494 {
495   bfd_vma fieldmask, addrmask, signmask, ss, a;
496   bfd_reloc_status_type flag = bfd_reloc_ok;
497
498   /* Note: BITSIZE should always be <= ADDRSIZE, but in case it's not,
499      we'll be permissive: extra bits in the field mask will
500      automatically extend the address mask for purposes of the
501      overflow check.  */
502   fieldmask = N_ONES (bitsize);
503   signmask = ~fieldmask;
504   addrmask = N_ONES (addrsize) | (fieldmask << rightshift);
505   a = (relocation & addrmask) >> rightshift;;
506
507   switch (how)
508     {
509     case complain_overflow_dont:
510       break;
511
512     case complain_overflow_signed:
513       /* If any sign bits are set, all sign bits must be set.  That
514          is, A must be a valid negative address after shifting.  */
515       signmask = ~ (fieldmask >> 1);
516       /* Fall thru */
517
518     case complain_overflow_bitfield:
519       /* Bitfields are sometimes signed, sometimes unsigned.  We
520          explicitly allow an address wrap too, which means a bitfield
521          of n bits is allowed to store -2**n to 2**n-1.  Thus overflow
522          if the value has some, but not all, bits set outside the
523          field.  */
524       ss = a & signmask;
525       if (ss != 0 && ss != ((addrmask >> rightshift) & signmask))
526         flag = bfd_reloc_overflow;
527       break;
528
529     case complain_overflow_unsigned:
530       /* We have an overflow if the address does not fit in the field.  */
531       if ((a & signmask) != 0)
532         flag = bfd_reloc_overflow;
533       break;
534
535     default:
536       abort ();
537     }
538
539   return flag;
540 }
541
542 /*
543 FUNCTION
544         bfd_perform_relocation
545
546 SYNOPSIS
547         bfd_reloc_status_type bfd_perform_relocation
548           (bfd *abfd,
549            arelent *reloc_entry,
550            void *data,
551            asection *input_section,
552            bfd *output_bfd,
553            char **error_message);
554
555 DESCRIPTION
556         If @var{output_bfd} is supplied to this function, the
557         generated image will be relocatable; the relocations are
558         copied to the output file after they have been changed to
559         reflect the new state of the world. There are two ways of
560         reflecting the results of partial linkage in an output file:
561         by modifying the output data in place, and by modifying the
562         relocation record.  Some native formats (e.g., basic a.out and
563         basic coff) have no way of specifying an addend in the
564         relocation type, so the addend has to go in the output data.
565         This is no big deal since in these formats the output data
566         slot will always be big enough for the addend. Complex reloc
567         types with addends were invented to solve just this problem.
568         The @var{error_message} argument is set to an error message if
569         this return @code{bfd_reloc_dangerous}.
570
571 */
572
573 bfd_reloc_status_type
574 bfd_perform_relocation (bfd *abfd,
575                         arelent *reloc_entry,
576                         void *data,
577                         asection *input_section,
578                         bfd *output_bfd,
579                         char **error_message)
580 {
581   bfd_vma relocation;
582   bfd_reloc_status_type flag = bfd_reloc_ok;
583   bfd_size_type octets = reloc_entry->address * bfd_octets_per_byte (abfd);
584   bfd_vma output_base = 0;
585   reloc_howto_type *howto = reloc_entry->howto;
586   asection *reloc_target_output_section;
587   asymbol *symbol;
588
589   symbol = *(reloc_entry->sym_ptr_ptr);
590   if (bfd_is_abs_section (symbol->section)
591       && output_bfd != NULL)
592     {
593       reloc_entry->address += input_section->output_offset;
594       return bfd_reloc_ok;
595     }
596
597   /* If we are not producing relocatable output, return an error if
598      the symbol is not defined.  An undefined weak symbol is
599      considered to have a value of zero (SVR4 ABI, p. 4-27).  */
600   if (bfd_is_und_section (symbol->section)
601       && (symbol->flags & BSF_WEAK) == 0
602       && output_bfd == NULL)
603     flag = bfd_reloc_undefined;
604
605   /* If there is a function supplied to handle this relocation type,
606      call it.  It'll return `bfd_reloc_continue' if further processing
607      can be done.  */
608   if (howto->special_function)
609     {
610       bfd_reloc_status_type cont;
611       cont = howto->special_function (abfd, reloc_entry, symbol, data,
612                                       input_section, output_bfd,
613                                       error_message);
614       if (cont != bfd_reloc_continue)
615         return cont;
616     }
617
618   /* Is the address of the relocation really within the section?  */
619   if (reloc_entry->address > bfd_get_section_limit (abfd, input_section))
620     return bfd_reloc_outofrange;
621
622   /* Work out which section the relocation is targeted at and the
623      initial relocation command value.  */
624
625   /* Get symbol value.  (Common symbols are special.)  */
626   if (bfd_is_com_section (symbol->section))
627     relocation = 0;
628   else
629     relocation = symbol->value;
630
631   reloc_target_output_section = symbol->section->output_section;
632
633   /* Convert input-section-relative symbol value to absolute.  */
634   if ((output_bfd && ! howto->partial_inplace)
635       || reloc_target_output_section == NULL)
636     output_base = 0;
637   else
638     output_base = reloc_target_output_section->vma;
639
640   relocation += output_base + symbol->section->output_offset;
641
642   /* Add in supplied addend.  */
643   relocation += reloc_entry->addend;
644
645   /* Here the variable relocation holds the final address of the
646      symbol we are relocating against, plus any addend.  */
647
648   if (howto->pc_relative)
649     {
650       /* This is a PC relative relocation.  We want to set RELOCATION
651          to the distance between the address of the symbol and the
652          location.  RELOCATION is already the address of the symbol.
653
654          We start by subtracting the address of the section containing
655          the location.
656
657          If pcrel_offset is set, we must further subtract the position
658          of the location within the section.  Some targets arrange for
659          the addend to be the negative of the position of the location
660          within the section; for example, i386-aout does this.  For
661          i386-aout, pcrel_offset is FALSE.  Some other targets do not
662          include the position of the location; for example, m88kbcs,
663          or ELF.  For those targets, pcrel_offset is TRUE.
664
665          If we are producing relocatable output, then we must ensure
666          that this reloc will be correctly computed when the final
667          relocation is done.  If pcrel_offset is FALSE we want to wind
668          up with the negative of the location within the section,
669          which means we must adjust the existing addend by the change
670          in the location within the section.  If pcrel_offset is TRUE
671          we do not want to adjust the existing addend at all.
672
673          FIXME: This seems logical to me, but for the case of
674          producing relocatable output it is not what the code
675          actually does.  I don't want to change it, because it seems
676          far too likely that something will break.  */
677
678       relocation -=
679         input_section->output_section->vma + input_section->output_offset;
680
681       if (howto->pcrel_offset)
682         relocation -= reloc_entry->address;
683     }
684
685   if (output_bfd != NULL)
686     {
687       if (! howto->partial_inplace)
688         {
689           /* This is a partial relocation, and we want to apply the relocation
690              to the reloc entry rather than the raw data. Modify the reloc
691              inplace to reflect what we now know.  */
692           reloc_entry->addend = relocation;
693           reloc_entry->address += input_section->output_offset;
694           return flag;
695         }
696       else
697         {
698           /* This is a partial relocation, but inplace, so modify the
699              reloc record a bit.
700
701              If we've relocated with a symbol with a section, change
702              into a ref to the section belonging to the symbol.  */
703
704           reloc_entry->address += input_section->output_offset;
705
706           /* WTF?? */
707           if (abfd->xvec->flavour == bfd_target_coff_flavour
708               && strcmp (abfd->xvec->name, "coff-Intel-little") != 0
709               && strcmp (abfd->xvec->name, "coff-Intel-big") != 0)
710             {
711               /* For m68k-coff, the addend was being subtracted twice during
712                  relocation with -r.  Removing the line below this comment
713                  fixes that problem; see PR 2953.
714
715 However, Ian wrote the following, regarding removing the line below,
716 which explains why it is still enabled:  --djm
717
718 If you put a patch like that into BFD you need to check all the COFF
719 linkers.  I am fairly certain that patch will break coff-i386 (e.g.,
720 SCO); see coff_i386_reloc in coff-i386.c where I worked around the
721 problem in a different way.  There may very well be a reason that the
722 code works as it does.
723
724 Hmmm.  The first obvious point is that bfd_perform_relocation should
725 not have any tests that depend upon the flavour.  It's seem like
726 entirely the wrong place for such a thing.  The second obvious point
727 is that the current code ignores the reloc addend when producing
728 relocatable output for COFF.  That's peculiar.  In fact, I really
729 have no idea what the point of the line you want to remove is.
730
731 A typical COFF reloc subtracts the old value of the symbol and adds in
732 the new value to the location in the object file (if it's a pc
733 relative reloc it adds the difference between the symbol value and the
734 location).  When relocating we need to preserve that property.
735
736 BFD handles this by setting the addend to the negative of the old
737 value of the symbol.  Unfortunately it handles common symbols in a
738 non-standard way (it doesn't subtract the old value) but that's a
739 different story (we can't change it without losing backward
740 compatibility with old object files) (coff-i386 does subtract the old
741 value, to be compatible with existing coff-i386 targets, like SCO).
742
743 So everything works fine when not producing relocatable output.  When
744 we are producing relocatable output, logically we should do exactly
745 what we do when not producing relocatable output.  Therefore, your
746 patch is correct.  In fact, it should probably always just set
747 reloc_entry->addend to 0 for all cases, since it is, in fact, going to
748 add the value into the object file.  This won't hurt the COFF code,
749 which doesn't use the addend; I'm not sure what it will do to other
750 formats (the thing to check for would be whether any formats both use
751 the addend and set partial_inplace).
752
753 When I wanted to make coff-i386 produce relocatable output, I ran
754 into the problem that you are running into: I wanted to remove that
755 line.  Rather than risk it, I made the coff-i386 relocs use a special
756 function; it's coff_i386_reloc in coff-i386.c.  The function
757 specifically adds the addend field into the object file, knowing that
758 bfd_perform_relocation is not going to.  If you remove that line, then
759 coff-i386.c will wind up adding the addend field in twice.  It's
760 trivial to fix; it just needs to be done.
761
762 The problem with removing the line is just that it may break some
763 working code.  With BFD it's hard to be sure of anything.  The right
764 way to deal with this is simply to build and test at least all the
765 supported COFF targets.  It should be straightforward if time and disk
766 space consuming.  For each target:
767     1) build the linker
768     2) generate some executable, and link it using -r (I would
769        probably use paranoia.o and link against newlib/libc.a, which
770        for all the supported targets would be available in
771        /usr/cygnus/progressive/H-host/target/lib/libc.a).
772     3) make the change to reloc.c
773     4) rebuild the linker
774     5) repeat step 2
775     6) if the resulting object files are the same, you have at least
776        made it no worse
777     7) if they are different you have to figure out which version is
778        right
779 */
780               relocation -= reloc_entry->addend;
781               reloc_entry->addend = 0;
782             }
783           else
784             {
785               reloc_entry->addend = relocation;
786             }
787         }
788     }
789   else
790     {
791       reloc_entry->addend = 0;
792     }
793
794   /* FIXME: This overflow checking is incomplete, because the value
795      might have overflowed before we get here.  For a correct check we
796      need to compute the value in a size larger than bitsize, but we
797      can't reasonably do that for a reloc the same size as a host
798      machine word.
799      FIXME: We should also do overflow checking on the result after
800      adding in the value contained in the object file.  */
801   if (howto->complain_on_overflow != complain_overflow_dont
802       && flag == bfd_reloc_ok)
803     flag = bfd_check_overflow (howto->complain_on_overflow,
804                                howto->bitsize,
805                                howto->rightshift,
806                                bfd_arch_bits_per_address (abfd),
807                                relocation);
808
809   /* Either we are relocating all the way, or we don't want to apply
810      the relocation to the reloc entry (probably because there isn't
811      any room in the output format to describe addends to relocs).  */
812
813   /* The cast to bfd_vma avoids a bug in the Alpha OSF/1 C compiler
814      (OSF version 1.3, compiler version 3.11).  It miscompiles the
815      following program:
816
817      struct str
818      {
819        unsigned int i0;
820      } s = { 0 };
821
822      int
823      main ()
824      {
825        unsigned long x;
826
827        x = 0x100000000;
828        x <<= (unsigned long) s.i0;
829        if (x == 0)
830          printf ("failed\n");
831        else
832          printf ("succeeded (%lx)\n", x);
833      }
834      */
835
836   relocation >>= (bfd_vma) howto->rightshift;
837
838   /* Shift everything up to where it's going to be used.  */
839   relocation <<= (bfd_vma) howto->bitpos;
840
841   /* Wait for the day when all have the mask in them.  */
842
843   /* What we do:
844      i instruction to be left alone
845      o offset within instruction
846      r relocation offset to apply
847      S src mask
848      D dst mask
849      N ~dst mask
850      A part 1
851      B part 2
852      R result
853
854      Do this:
855      ((  i i i i i o o o o o  from bfd_get<size>
856      and           S S S S S) to get the size offset we want
857      +   r r r r r r r r r r) to get the final value to place
858      and           D D D D D  to chop to right size
859      -----------------------
860      =             A A A A A
861      And this:
862      (   i i i i i o o o o o  from bfd_get<size>
863      and N N N N N          ) get instruction
864      -----------------------
865      =   B B B B B
866
867      And then:
868      (   B B B B B
869      or            A A A A A)
870      -----------------------
871      =   R R R R R R R R R R  put into bfd_put<size>
872      */
873
874 #define DOIT(x) \
875   x = ( (x & ~howto->dst_mask) | (((x & howto->src_mask) +  relocation) & howto->dst_mask))
876
877   switch (howto->size)
878     {
879     case 0:
880       {
881         char x = bfd_get_8 (abfd, (char *) data + octets);
882         DOIT (x);
883         bfd_put_8 (abfd, x, (unsigned char *) data + octets);
884       }
885       break;
886
887     case 1:
888       {
889         short x = bfd_get_16 (abfd, (bfd_byte *) data + octets);
890         DOIT (x);
891         bfd_put_16 (abfd, (bfd_vma) x, (unsigned char *) data + octets);
892       }
893       break;
894     case 2:
895       {
896         long x = bfd_get_32 (abfd, (bfd_byte *) data + octets);
897         DOIT (x);
898         bfd_put_32 (abfd, (bfd_vma) x, (bfd_byte *) data + octets);
899       }
900       break;
901     case -2:
902       {
903         long x = bfd_get_32 (abfd, (bfd_byte *) data + octets);
904         relocation = -relocation;
905         DOIT (x);
906         bfd_put_32 (abfd, (bfd_vma) x, (bfd_byte *) data + octets);
907       }
908       break;
909
910     case -1:
911       {
912         long x = bfd_get_16 (abfd, (bfd_byte *) data + octets);
913         relocation = -relocation;
914         DOIT (x);
915         bfd_put_16 (abfd, (bfd_vma) x, (bfd_byte *) data + octets);
916       }
917       break;
918
919     case 3:
920       /* Do nothing */
921       break;
922
923     case 4:
924 #ifdef BFD64
925       {
926         bfd_vma x = bfd_get_64 (abfd, (bfd_byte *) data + octets);
927         DOIT (x);
928         bfd_put_64 (abfd, x, (bfd_byte *) data + octets);
929       }
930 #else
931       abort ();
932 #endif
933       break;
934     default:
935       return bfd_reloc_other;
936     }
937
938   return flag;
939 }
940
941 /*
942 FUNCTION
943         bfd_install_relocation
944
945 SYNOPSIS
946         bfd_reloc_status_type bfd_install_relocation
947           (bfd *abfd,
948            arelent *reloc_entry,
949            void *data, bfd_vma data_start,
950            asection *input_section,
951            char **error_message);
952
953 DESCRIPTION
954         This looks remarkably like <<bfd_perform_relocation>>, except it
955         does not expect that the section contents have been filled in.
956         I.e., it's suitable for use when creating, rather than applying
957         a relocation.
958
959         For now, this function should be considered reserved for the
960         assembler.
961 */
962
963 bfd_reloc_status_type
964 bfd_install_relocation (bfd *abfd,
965                         arelent *reloc_entry,
966                         void *data_start,
967                         bfd_vma data_start_offset,
968                         asection *input_section,
969                         char **error_message)
970 {
971   bfd_vma relocation;
972   bfd_reloc_status_type flag = bfd_reloc_ok;
973   bfd_size_type octets = reloc_entry->address * bfd_octets_per_byte (abfd);
974   bfd_vma output_base = 0;
975   reloc_howto_type *howto = reloc_entry->howto;
976   asection *reloc_target_output_section;
977   asymbol *symbol;
978   bfd_byte *data;
979
980   symbol = *(reloc_entry->sym_ptr_ptr);
981   if (bfd_is_abs_section (symbol->section))
982     {
983       reloc_entry->address += input_section->output_offset;
984       return bfd_reloc_ok;
985     }
986
987   /* If there is a function supplied to handle this relocation type,
988      call it.  It'll return `bfd_reloc_continue' if further processing
989      can be done.  */
990   if (howto->special_function)
991     {
992       bfd_reloc_status_type cont;
993
994       /* XXX - The special_function calls haven't been fixed up to deal
995          with creating new relocations and section contents.  */
996       cont = howto->special_function (abfd, reloc_entry, symbol,
997                                       /* XXX - Non-portable! */
998                                       ((bfd_byte *) data_start
999                                        - data_start_offset),
1000                                       input_section, abfd, error_message);
1001       if (cont != bfd_reloc_continue)
1002         return cont;
1003     }
1004
1005   /* Is the address of the relocation really within the section?  */
1006   if (reloc_entry->address > bfd_get_section_limit (abfd, input_section))
1007     return bfd_reloc_outofrange;
1008
1009   /* Work out which section the relocation is targeted at and the
1010      initial relocation command value.  */
1011
1012   /* Get symbol value.  (Common symbols are special.)  */
1013   if (bfd_is_com_section (symbol->section))
1014     relocation = 0;
1015   else
1016     relocation = symbol->value;
1017
1018   reloc_target_output_section = symbol->section->output_section;
1019
1020   /* Convert input-section-relative symbol value to absolute.  */
1021   if (! howto->partial_inplace)
1022     output_base = 0;
1023   else
1024     output_base = reloc_target_output_section->vma;
1025
1026   relocation += output_base + symbol->section->output_offset;
1027
1028   /* Add in supplied addend.  */
1029   relocation += reloc_entry->addend;
1030
1031   /* Here the variable relocation holds the final address of the
1032      symbol we are relocating against, plus any addend.  */
1033
1034   if (howto->pc_relative)
1035     {
1036       /* This is a PC relative relocation.  We want to set RELOCATION
1037          to the distance between the address of the symbol and the
1038          location.  RELOCATION is already the address of the symbol.
1039
1040          We start by subtracting the address of the section containing
1041          the location.
1042
1043          If pcrel_offset is set, we must further subtract the position
1044          of the location within the section.  Some targets arrange for
1045          the addend to be the negative of the position of the location
1046          within the section; for example, i386-aout does this.  For
1047          i386-aout, pcrel_offset is FALSE.  Some other targets do not
1048          include the position of the location; for example, m88kbcs,
1049          or ELF.  For those targets, pcrel_offset is TRUE.
1050
1051          If we are producing relocatable output, then we must ensure
1052          that this reloc will be correctly computed when the final
1053          relocation is done.  If pcrel_offset is FALSE we want to wind
1054          up with the negative of the location within the section,
1055          which means we must adjust the existing addend by the change
1056          in the location within the section.  If pcrel_offset is TRUE
1057          we do not want to adjust the existing addend at all.
1058
1059          FIXME: This seems logical to me, but for the case of
1060          producing relocatable output it is not what the code
1061          actually does.  I don't want to change it, because it seems
1062          far too likely that something will break.  */
1063
1064       relocation -=
1065         input_section->output_section->vma + input_section->output_offset;
1066
1067       if (howto->pcrel_offset && howto->partial_inplace)
1068         relocation -= reloc_entry->address;
1069     }
1070
1071   if (! howto->partial_inplace)
1072     {
1073       /* This is a partial relocation, and we want to apply the relocation
1074          to the reloc entry rather than the raw data. Modify the reloc
1075          inplace to reflect what we now know.  */
1076       reloc_entry->addend = relocation;
1077       reloc_entry->address += input_section->output_offset;
1078       return flag;
1079     }
1080   else
1081     {
1082       /* This is a partial relocation, but inplace, so modify the
1083          reloc record a bit.
1084
1085          If we've relocated with a symbol with a section, change
1086          into a ref to the section belonging to the symbol.  */
1087       reloc_entry->address += input_section->output_offset;
1088
1089       /* WTF?? */
1090       if (abfd->xvec->flavour == bfd_target_coff_flavour
1091           && strcmp (abfd->xvec->name, "coff-Intel-little") != 0
1092           && strcmp (abfd->xvec->name, "coff-Intel-big") != 0)
1093         {
1094
1095           /* For m68k-coff, the addend was being subtracted twice during
1096              relocation with -r.  Removing the line below this comment
1097              fixes that problem; see PR 2953.
1098
1099 However, Ian wrote the following, regarding removing the line below,
1100 which explains why it is still enabled:  --djm
1101
1102 If you put a patch like that into BFD you need to check all the COFF
1103 linkers.  I am fairly certain that patch will break coff-i386 (e.g.,
1104 SCO); see coff_i386_reloc in coff-i386.c where I worked around the
1105 problem in a different way.  There may very well be a reason that the
1106 code works as it does.
1107
1108 Hmmm.  The first obvious point is that bfd_install_relocation should
1109 not have any tests that depend upon the flavour.  It's seem like
1110 entirely the wrong place for such a thing.  The second obvious point
1111 is that the current code ignores the reloc addend when producing
1112 relocatable output for COFF.  That's peculiar.  In fact, I really
1113 have no idea what the point of the line you want to remove is.
1114
1115 A typical COFF reloc subtracts the old value of the symbol and adds in
1116 the new value to the location in the object file (if it's a pc
1117 relative reloc it adds the difference between the symbol value and the
1118 location).  When relocating we need to preserve that property.
1119
1120 BFD handles this by setting the addend to the negative of the old
1121 value of the symbol.  Unfortunately it handles common symbols in a
1122 non-standard way (it doesn't subtract the old value) but that's a
1123 different story (we can't change it without losing backward
1124 compatibility with old object files) (coff-i386 does subtract the old
1125 value, to be compatible with existing coff-i386 targets, like SCO).
1126
1127 So everything works fine when not producing relocatable output.  When
1128 we are producing relocatable output, logically we should do exactly
1129 what we do when not producing relocatable output.  Therefore, your
1130 patch is correct.  In fact, it should probably always just set
1131 reloc_entry->addend to 0 for all cases, since it is, in fact, going to
1132 add the value into the object file.  This won't hurt the COFF code,
1133 which doesn't use the addend; I'm not sure what it will do to other
1134 formats (the thing to check for would be whether any formats both use
1135 the addend and set partial_inplace).
1136
1137 When I wanted to make coff-i386 produce relocatable output, I ran
1138 into the problem that you are running into: I wanted to remove that
1139 line.  Rather than risk it, I made the coff-i386 relocs use a special
1140 function; it's coff_i386_reloc in coff-i386.c.  The function
1141 specifically adds the addend field into the object file, knowing that
1142 bfd_install_relocation is not going to.  If you remove that line, then
1143 coff-i386.c will wind up adding the addend field in twice.  It's
1144 trivial to fix; it just needs to be done.
1145
1146 The problem with removing the line is just that it may break some
1147 working code.  With BFD it's hard to be sure of anything.  The right
1148 way to deal with this is simply to build and test at least all the
1149 supported COFF targets.  It should be straightforward if time and disk
1150 space consuming.  For each target:
1151     1) build the linker
1152     2) generate some executable, and link it using -r (I would
1153        probably use paranoia.o and link against newlib/libc.a, which
1154        for all the supported targets would be available in
1155        /usr/cygnus/progressive/H-host/target/lib/libc.a).
1156     3) make the change to reloc.c
1157     4) rebuild the linker
1158     5) repeat step 2
1159     6) if the resulting object files are the same, you have at least
1160        made it no worse
1161     7) if they are different you have to figure out which version is
1162        right.  */
1163           relocation -= reloc_entry->addend;
1164           /* FIXME: There should be no target specific code here...  */
1165           if (strcmp (abfd->xvec->name, "coff-z8k") != 0)
1166             reloc_entry->addend = 0;
1167         }
1168       else
1169         {
1170           reloc_entry->addend = relocation;
1171         }
1172     }
1173
1174   /* FIXME: This overflow checking is incomplete, because the value
1175      might have overflowed before we get here.  For a correct check we
1176      need to compute the value in a size larger than bitsize, but we
1177      can't reasonably do that for a reloc the same size as a host
1178      machine word.
1179      FIXME: We should also do overflow checking on the result after
1180      adding in the value contained in the object file.  */
1181   if (howto->complain_on_overflow != complain_overflow_dont)
1182     flag = bfd_check_overflow (howto->complain_on_overflow,
1183                                howto->bitsize,
1184                                howto->rightshift,
1185                                bfd_arch_bits_per_address (abfd),
1186                                relocation);
1187
1188   /* Either we are relocating all the way, or we don't want to apply
1189      the relocation to the reloc entry (probably because there isn't
1190      any room in the output format to describe addends to relocs).  */
1191
1192   /* The cast to bfd_vma avoids a bug in the Alpha OSF/1 C compiler
1193      (OSF version 1.3, compiler version 3.11).  It miscompiles the
1194      following program:
1195
1196      struct str
1197      {
1198        unsigned int i0;
1199      } s = { 0 };
1200
1201      int
1202      main ()
1203      {
1204        unsigned long x;
1205
1206        x = 0x100000000;
1207        x <<= (unsigned long) s.i0;
1208        if (x == 0)
1209          printf ("failed\n");
1210        else
1211          printf ("succeeded (%lx)\n", x);
1212      }
1213      */
1214
1215   relocation >>= (bfd_vma) howto->rightshift;
1216
1217   /* Shift everything up to where it's going to be used.  */
1218   relocation <<= (bfd_vma) howto->bitpos;
1219
1220   /* Wait for the day when all have the mask in them.  */
1221
1222   /* What we do:
1223      i instruction to be left alone
1224      o offset within instruction
1225      r relocation offset to apply
1226      S src mask
1227      D dst mask
1228      N ~dst mask
1229      A part 1
1230      B part 2
1231      R result
1232
1233      Do this:
1234      ((  i i i i i o o o o o  from bfd_get<size>
1235      and           S S S S S) to get the size offset we want
1236      +   r r r r r r r r r r) to get the final value to place
1237      and           D D D D D  to chop to right size
1238      -----------------------
1239      =             A A A A A
1240      And this:
1241      (   i i i i i o o o o o  from bfd_get<size>
1242      and N N N N N          ) get instruction
1243      -----------------------
1244      =   B B B B B
1245
1246      And then:
1247      (   B B B B B
1248      or            A A A A A)
1249      -----------------------
1250      =   R R R R R R R R R R  put into bfd_put<size>
1251      */
1252
1253 #define DOIT(x) \
1254   x = ( (x & ~howto->dst_mask) | (((x & howto->src_mask) +  relocation) & howto->dst_mask))
1255
1256   data = (bfd_byte *) data_start + (octets - data_start_offset);
1257
1258   switch (howto->size)
1259     {
1260     case 0:
1261       {
1262         char x = bfd_get_8 (abfd, data);
1263         DOIT (x);
1264         bfd_put_8 (abfd, x, data);
1265       }
1266       break;
1267
1268     case 1:
1269       {
1270         short x = bfd_get_16 (abfd, data);
1271         DOIT (x);
1272         bfd_put_16 (abfd, (bfd_vma) x, data);
1273       }
1274       break;
1275     case 2:
1276       {
1277         long x = bfd_get_32 (abfd, data);
1278         DOIT (x);
1279         bfd_put_32 (abfd, (bfd_vma) x, data);
1280       }
1281       break;
1282     case -2:
1283       {
1284         long x = bfd_get_32 (abfd, data);
1285         relocation = -relocation;
1286         DOIT (x);
1287         bfd_put_32 (abfd, (bfd_vma) x, data);
1288       }
1289       break;
1290
1291     case 3:
1292       /* Do nothing */
1293       break;
1294
1295     case 4:
1296       {
1297         bfd_vma x = bfd_get_64 (abfd, data);
1298         DOIT (x);
1299         bfd_put_64 (abfd, x, data);
1300       }
1301       break;
1302     default:
1303       return bfd_reloc_other;
1304     }
1305
1306   return flag;
1307 }
1308
1309 /* This relocation routine is used by some of the backend linkers.
1310    They do not construct asymbol or arelent structures, so there is no
1311    reason for them to use bfd_perform_relocation.  Also,
1312    bfd_perform_relocation is so hacked up it is easier to write a new
1313    function than to try to deal with it.
1314
1315    This routine does a final relocation.  Whether it is useful for a
1316    relocatable link depends upon how the object format defines
1317    relocations.
1318
1319    FIXME: This routine ignores any special_function in the HOWTO,
1320    since the existing special_function values have been written for
1321    bfd_perform_relocation.
1322
1323    HOWTO is the reloc howto information.
1324    INPUT_BFD is the BFD which the reloc applies to.
1325    INPUT_SECTION is the section which the reloc applies to.
1326    CONTENTS is the contents of the section.
1327    ADDRESS is the address of the reloc within INPUT_SECTION.
1328    VALUE is the value of the symbol the reloc refers to.
1329    ADDEND is the addend of the reloc.  */
1330
1331 bfd_reloc_status_type
1332 _bfd_final_link_relocate (reloc_howto_type *howto,
1333                           bfd *input_bfd,
1334                           asection *input_section,
1335                           bfd_byte *contents,
1336                           bfd_vma address,
1337                           bfd_vma value,
1338                           bfd_vma addend)
1339 {
1340   bfd_vma relocation;
1341
1342   /* Sanity check the address.  */
1343   if (address > bfd_get_section_limit (input_bfd, input_section))
1344     return bfd_reloc_outofrange;
1345
1346   /* This function assumes that we are dealing with a basic relocation
1347      against a symbol.  We want to compute the value of the symbol to
1348      relocate to.  This is just VALUE, the value of the symbol, plus
1349      ADDEND, any addend associated with the reloc.  */
1350   relocation = value + addend;
1351
1352   /* If the relocation is PC relative, we want to set RELOCATION to
1353      the distance between the symbol (currently in RELOCATION) and the
1354      location we are relocating.  Some targets (e.g., i386-aout)
1355      arrange for the contents of the section to be the negative of the
1356      offset of the location within the section; for such targets
1357      pcrel_offset is FALSE.  Other targets (e.g., m88kbcs or ELF)
1358      simply leave the contents of the section as zero; for such
1359      targets pcrel_offset is TRUE.  If pcrel_offset is FALSE we do not
1360      need to subtract out the offset of the location within the
1361      section (which is just ADDRESS).  */
1362   if (howto->pc_relative)
1363     {
1364       relocation -= (input_section->output_section->vma
1365                      + input_section->output_offset);
1366       if (howto->pcrel_offset)
1367         relocation -= address;
1368     }
1369
1370   return _bfd_relocate_contents (howto, input_bfd, relocation,
1371                                  contents + address);
1372 }
1373
1374 /* Relocate a given location using a given value and howto.  */
1375
1376 bfd_reloc_status_type
1377 _bfd_relocate_contents (reloc_howto_type *howto,
1378                         bfd *input_bfd,
1379                         bfd_vma relocation,
1380                         bfd_byte *location)
1381 {
1382   int size;
1383   bfd_vma x = 0;
1384   bfd_reloc_status_type flag;
1385   unsigned int rightshift = howto->rightshift;
1386   unsigned int bitpos = howto->bitpos;
1387
1388   /* If the size is negative, negate RELOCATION.  This isn't very
1389      general.  */
1390   if (howto->size < 0)
1391     relocation = -relocation;
1392
1393   /* Get the value we are going to relocate.  */
1394   size = bfd_get_reloc_size (howto);
1395   switch (size)
1396     {
1397     default:
1398     case 0:
1399       abort ();
1400     case 1:
1401       x = bfd_get_8 (input_bfd, location);
1402       break;
1403     case 2:
1404       x = bfd_get_16 (input_bfd, location);
1405       break;
1406     case 4:
1407       x = bfd_get_32 (input_bfd, location);
1408       break;
1409     case 8:
1410 #ifdef BFD64
1411       x = bfd_get_64 (input_bfd, location);
1412 #else
1413       abort ();
1414 #endif
1415       break;
1416     }
1417
1418   /* Check for overflow.  FIXME: We may drop bits during the addition
1419      which we don't check for.  We must either check at every single
1420      operation, which would be tedious, or we must do the computations
1421      in a type larger than bfd_vma, which would be inefficient.  */
1422   flag = bfd_reloc_ok;
1423   if (howto->complain_on_overflow != complain_overflow_dont)
1424     {
1425       bfd_vma addrmask, fieldmask, signmask, ss;
1426       bfd_vma a, b, sum;
1427
1428       /* Get the values to be added together.  For signed and unsigned
1429          relocations, we assume that all values should be truncated to
1430          the size of an address.  For bitfields, all the bits matter.
1431          See also bfd_check_overflow.  */
1432       fieldmask = N_ONES (howto->bitsize);
1433       signmask = ~fieldmask;
1434       addrmask = (N_ONES (bfd_arch_bits_per_address (input_bfd))
1435                   | (fieldmask << rightshift));
1436       a = (relocation & addrmask) >> rightshift;
1437       b = (x & howto->src_mask & addrmask) >> bitpos;
1438       addrmask >>= rightshift;
1439
1440       switch (howto->complain_on_overflow)
1441         {
1442         case complain_overflow_signed:
1443           /* If any sign bits are set, all sign bits must be set.
1444              That is, A must be a valid negative address after
1445              shifting.  */
1446           signmask = ~(fieldmask >> 1);
1447           /* Fall thru */
1448
1449         case complain_overflow_bitfield:
1450           /* Much like the signed check, but for a field one bit
1451              wider.  We allow a bitfield to represent numbers in the
1452              range -2**n to 2**n-1, where n is the number of bits in the
1453              field.  Note that when bfd_vma is 32 bits, a 32-bit reloc
1454              can't overflow, which is exactly what we want.  */
1455           ss = a & signmask;
1456           if (ss != 0 && ss != (addrmask & signmask))
1457             flag = bfd_reloc_overflow;
1458
1459           /* We only need this next bit of code if the sign bit of B
1460              is below the sign bit of A.  This would only happen if
1461              SRC_MASK had fewer bits than BITSIZE.  Note that if
1462              SRC_MASK has more bits than BITSIZE, we can get into
1463              trouble; we would need to verify that B is in range, as
1464              we do for A above.  */
1465           ss = ((~howto->src_mask) >> 1) & howto->src_mask;
1466           ss >>= bitpos;
1467
1468           /* Set all the bits above the sign bit.  */
1469           b = (b ^ ss) - ss;
1470
1471           /* Now we can do the addition.  */
1472           sum = a + b;
1473
1474           /* See if the result has the correct sign.  Bits above the
1475              sign bit are junk now; ignore them.  If the sum is
1476              positive, make sure we did not have all negative inputs;
1477              if the sum is negative, make sure we did not have all
1478              positive inputs.  The test below looks only at the sign
1479              bits, and it really just
1480                  SIGN (A) == SIGN (B) && SIGN (A) != SIGN (SUM)
1481
1482              We mask with addrmask here to explicitly allow an address
1483              wrap-around.  The Linux kernel relies on it, and it is
1484              the only way to write assembler code which can run when
1485              loaded at a location 0x80000000 away from the location at
1486              which it is linked.  */
1487           if (((~(a ^ b)) & (a ^ sum)) & signmask & addrmask)
1488             flag = bfd_reloc_overflow;
1489           break;
1490
1491         case complain_overflow_unsigned:
1492           /* Checking for an unsigned overflow is relatively easy:
1493              trim the addresses and add, and trim the result as well.
1494              Overflow is normally indicated when the result does not
1495              fit in the field.  However, we also need to consider the
1496              case when, e.g., fieldmask is 0x7fffffff or smaller, an
1497              input is 0x80000000, and bfd_vma is only 32 bits; then we
1498              will get sum == 0, but there is an overflow, since the
1499              inputs did not fit in the field.  Instead of doing a
1500              separate test, we can check for this by or-ing in the
1501              operands when testing for the sum overflowing its final
1502              field.  */
1503           sum = (a + b) & addrmask;
1504           if ((a | b | sum) & signmask)
1505             flag = bfd_reloc_overflow;
1506           break;
1507
1508         default:
1509           abort ();
1510         }
1511     }
1512
1513   /* Put RELOCATION in the right bits.  */
1514   relocation >>= (bfd_vma) rightshift;
1515   relocation <<= (bfd_vma) bitpos;
1516
1517   /* Add RELOCATION to the right bits of X.  */
1518   x = ((x & ~howto->dst_mask)
1519        | (((x & howto->src_mask) + relocation) & howto->dst_mask));
1520
1521   /* Put the relocated value back in the object file.  */
1522   switch (size)
1523     {
1524     default:
1525       abort ();
1526     case 1:
1527       bfd_put_8 (input_bfd, x, location);
1528       break;
1529     case 2:
1530       bfd_put_16 (input_bfd, x, location);
1531       break;
1532     case 4:
1533       bfd_put_32 (input_bfd, x, location);
1534       break;
1535     case 8:
1536 #ifdef BFD64
1537       bfd_put_64 (input_bfd, x, location);
1538 #else
1539       abort ();
1540 #endif
1541       break;
1542     }
1543
1544   return flag;
1545 }
1546
1547 /* Clear a given location using a given howto, by applying a fixed relocation
1548    value and discarding any in-place addend.  This is used for fixed-up
1549    relocations against discarded symbols, to make ignorable debug or unwind
1550    information more obvious.  */
1551
1552 void
1553 _bfd_clear_contents (reloc_howto_type *howto,
1554                      bfd *input_bfd,
1555                      asection *input_section,
1556                      bfd_byte *location)
1557 {
1558   int size;
1559   bfd_vma x = 0;
1560
1561   /* Get the value we are going to relocate.  */
1562   size = bfd_get_reloc_size (howto);
1563   switch (size)
1564     {
1565     default:
1566     case 0:
1567       abort ();
1568     case 1:
1569       x = bfd_get_8 (input_bfd, location);
1570       break;
1571     case 2:
1572       x = bfd_get_16 (input_bfd, location);
1573       break;
1574     case 4:
1575       x = bfd_get_32 (input_bfd, location);
1576       break;
1577     case 8:
1578 #ifdef BFD64
1579       x = bfd_get_64 (input_bfd, location);
1580 #else
1581       abort ();
1582 #endif
1583       break;
1584     }
1585
1586   /* Zero out the unwanted bits of X.  */
1587   x &= ~howto->dst_mask;
1588
1589   /* For a range list, use 1 instead of 0 as placeholder.  0
1590      would terminate the list, hiding any later entries.  */
1591   if (strcmp (bfd_get_section_name (input_bfd, input_section),
1592               ".debug_ranges") == 0
1593       && (howto->dst_mask & 1) != 0)
1594     x |= 1;
1595
1596   /* Put the relocated value back in the object file.  */
1597   switch (size)
1598     {
1599     default:
1600     case 0:
1601       abort ();
1602     case 1:
1603       bfd_put_8 (input_bfd, x, location);
1604       break;
1605     case 2:
1606       bfd_put_16 (input_bfd, x, location);
1607       break;
1608     case 4:
1609       bfd_put_32 (input_bfd, x, location);
1610       break;
1611     case 8:
1612 #ifdef BFD64
1613       bfd_put_64 (input_bfd, x, location);
1614 #else
1615       abort ();
1616 #endif
1617       break;
1618     }
1619 }
1620
1621 /*
1622 DOCDD
1623 INODE
1624         howto manager,  , typedef arelent, Relocations
1625
1626 SUBSECTION
1627         The howto manager
1628
1629         When an application wants to create a relocation, but doesn't
1630         know what the target machine might call it, it can find out by
1631         using this bit of code.
1632
1633 */
1634
1635 /*
1636 TYPEDEF
1637         bfd_reloc_code_type
1638
1639 DESCRIPTION
1640         The insides of a reloc code.  The idea is that, eventually, there
1641         will be one enumerator for every type of relocation we ever do.
1642         Pass one of these values to <<bfd_reloc_type_lookup>>, and it'll
1643         return a howto pointer.
1644
1645         This does mean that the application must determine the correct
1646         enumerator value; you can't get a howto pointer from a random set
1647         of attributes.
1648
1649 SENUM
1650    bfd_reloc_code_real
1651
1652 ENUM
1653   BFD_RELOC_64
1654 ENUMX
1655   BFD_RELOC_32
1656 ENUMX
1657   BFD_RELOC_26
1658 ENUMX
1659   BFD_RELOC_24
1660 ENUMX
1661   BFD_RELOC_16
1662 ENUMX
1663   BFD_RELOC_14
1664 ENUMX
1665   BFD_RELOC_8
1666 ENUMDOC
1667   Basic absolute relocations of N bits.
1668
1669 ENUM
1670   BFD_RELOC_64_PCREL
1671 ENUMX
1672   BFD_RELOC_32_PCREL
1673 ENUMX
1674   BFD_RELOC_24_PCREL
1675 ENUMX
1676   BFD_RELOC_16_PCREL
1677 ENUMX
1678   BFD_RELOC_12_PCREL
1679 ENUMX
1680   BFD_RELOC_8_PCREL
1681 ENUMDOC
1682   PC-relative relocations.  Sometimes these are relative to the address
1683 of the relocation itself; sometimes they are relative to the start of
1684 the section containing the relocation.  It depends on the specific target.
1685
1686 The 24-bit relocation is used in some Intel 960 configurations.
1687
1688 ENUM
1689   BFD_RELOC_32_SECREL
1690 ENUMDOC
1691   Section relative relocations.  Some targets need this for DWARF2.
1692
1693 ENUM
1694   BFD_RELOC_32_GOT_PCREL
1695 ENUMX
1696   BFD_RELOC_16_GOT_PCREL
1697 ENUMX
1698   BFD_RELOC_8_GOT_PCREL
1699 ENUMX
1700   BFD_RELOC_32_GOTOFF
1701 ENUMX
1702   BFD_RELOC_16_GOTOFF
1703 ENUMX
1704   BFD_RELOC_LO16_GOTOFF
1705 ENUMX
1706   BFD_RELOC_HI16_GOTOFF
1707 ENUMX
1708   BFD_RELOC_HI16_S_GOTOFF
1709 ENUMX
1710   BFD_RELOC_8_GOTOFF
1711 ENUMX
1712   BFD_RELOC_64_PLT_PCREL
1713 ENUMX
1714   BFD_RELOC_32_PLT_PCREL
1715 ENUMX
1716   BFD_RELOC_24_PLT_PCREL
1717 ENUMX
1718   BFD_RELOC_16_PLT_PCREL
1719 ENUMX
1720   BFD_RELOC_8_PLT_PCREL
1721 ENUMX
1722   BFD_RELOC_64_PLTOFF
1723 ENUMX
1724   BFD_RELOC_32_PLTOFF
1725 ENUMX
1726   BFD_RELOC_16_PLTOFF
1727 ENUMX
1728   BFD_RELOC_LO16_PLTOFF
1729 ENUMX
1730   BFD_RELOC_HI16_PLTOFF
1731 ENUMX
1732   BFD_RELOC_HI16_S_PLTOFF
1733 ENUMX
1734   BFD_RELOC_8_PLTOFF
1735 ENUMDOC
1736   For ELF.
1737
1738 ENUM
1739   BFD_RELOC_68K_GLOB_DAT
1740 ENUMX
1741   BFD_RELOC_68K_JMP_SLOT
1742 ENUMX
1743   BFD_RELOC_68K_RELATIVE
1744 ENUMX
1745   BFD_RELOC_68K_TLS_GD32
1746 ENUMX
1747   BFD_RELOC_68K_TLS_GD16
1748 ENUMX
1749   BFD_RELOC_68K_TLS_GD8
1750 ENUMX
1751   BFD_RELOC_68K_TLS_LDM32
1752 ENUMX
1753   BFD_RELOC_68K_TLS_LDM16
1754 ENUMX
1755   BFD_RELOC_68K_TLS_LDM8
1756 ENUMX
1757   BFD_RELOC_68K_TLS_LDO32
1758 ENUMX
1759   BFD_RELOC_68K_TLS_LDO16
1760 ENUMX
1761   BFD_RELOC_68K_TLS_LDO8
1762 ENUMX
1763   BFD_RELOC_68K_TLS_IE32
1764 ENUMX
1765   BFD_RELOC_68K_TLS_IE16
1766 ENUMX
1767   BFD_RELOC_68K_TLS_IE8
1768 ENUMX
1769   BFD_RELOC_68K_TLS_LE32
1770 ENUMX
1771   BFD_RELOC_68K_TLS_LE16
1772 ENUMX
1773   BFD_RELOC_68K_TLS_LE8
1774 ENUMDOC
1775   Relocations used by 68K ELF.
1776
1777 ENUM
1778   BFD_RELOC_32_BASEREL
1779 ENUMX
1780   BFD_RELOC_16_BASEREL
1781 ENUMX
1782   BFD_RELOC_LO16_BASEREL
1783 ENUMX
1784   BFD_RELOC_HI16_BASEREL
1785 ENUMX
1786   BFD_RELOC_HI16_S_BASEREL
1787 ENUMX
1788   BFD_RELOC_8_BASEREL
1789 ENUMX
1790   BFD_RELOC_RVA
1791 ENUMDOC
1792   Linkage-table relative.
1793
1794 ENUM
1795   BFD_RELOC_8_FFnn
1796 ENUMDOC
1797   Absolute 8-bit relocation, but used to form an address like 0xFFnn.
1798
1799 ENUM
1800   BFD_RELOC_32_PCREL_S2
1801 ENUMX
1802   BFD_RELOC_16_PCREL_S2
1803 ENUMX
1804   BFD_RELOC_23_PCREL_S2
1805 ENUMDOC
1806   These PC-relative relocations are stored as word displacements --
1807 i.e., byte displacements shifted right two bits.  The 30-bit word
1808 displacement (<<32_PCREL_S2>> -- 32 bits, shifted 2) is used on the
1809 SPARC.  (SPARC tools generally refer to this as <<WDISP30>>.)  The
1810 signed 16-bit displacement is used on the MIPS, and the 23-bit
1811 displacement is used on the Alpha.
1812
1813 ENUM
1814   BFD_RELOC_HI22
1815 ENUMX
1816   BFD_RELOC_LO10
1817 ENUMDOC
1818   High 22 bits and low 10 bits of 32-bit value, placed into lower bits of
1819 the target word.  These are used on the SPARC.
1820
1821 ENUM
1822   BFD_RELOC_GPREL16
1823 ENUMX
1824   BFD_RELOC_GPREL32
1825 ENUMDOC
1826   For systems that allocate a Global Pointer register, these are
1827 displacements off that register.  These relocation types are
1828 handled specially, because the value the register will have is
1829 decided relatively late.
1830
1831 ENUM
1832   BFD_RELOC_I960_CALLJ
1833 ENUMDOC
1834   Reloc types used for i960/b.out.
1835
1836 ENUM
1837   BFD_RELOC_NONE
1838 ENUMX
1839   BFD_RELOC_SPARC_WDISP22
1840 ENUMX
1841   BFD_RELOC_SPARC22
1842 ENUMX
1843   BFD_RELOC_SPARC13
1844 ENUMX
1845   BFD_RELOC_SPARC_GOT10
1846 ENUMX
1847   BFD_RELOC_SPARC_GOT13
1848 ENUMX
1849   BFD_RELOC_SPARC_GOT22
1850 ENUMX
1851   BFD_RELOC_SPARC_PC10
1852 ENUMX
1853   BFD_RELOC_SPARC_PC22
1854 ENUMX
1855   BFD_RELOC_SPARC_WPLT30
1856 ENUMX
1857   BFD_RELOC_SPARC_COPY
1858 ENUMX
1859   BFD_RELOC_SPARC_GLOB_DAT
1860 ENUMX
1861   BFD_RELOC_SPARC_JMP_SLOT
1862 ENUMX
1863   BFD_RELOC_SPARC_RELATIVE
1864 ENUMX
1865   BFD_RELOC_SPARC_UA16
1866 ENUMX
1867   BFD_RELOC_SPARC_UA32
1868 ENUMX
1869   BFD_RELOC_SPARC_UA64
1870 ENUMX
1871   BFD_RELOC_SPARC_GOTDATA_HIX22
1872 ENUMX
1873   BFD_RELOC_SPARC_GOTDATA_LOX10
1874 ENUMX
1875   BFD_RELOC_SPARC_GOTDATA_OP_HIX22
1876 ENUMX
1877   BFD_RELOC_SPARC_GOTDATA_OP_LOX10
1878 ENUMX
1879   BFD_RELOC_SPARC_GOTDATA_OP
1880 ENUMX
1881   BFD_RELOC_SPARC_JMP_IREL
1882 ENUMX
1883   BFD_RELOC_SPARC_IRELATIVE
1884 ENUMDOC
1885   SPARC ELF relocations.  There is probably some overlap with other
1886   relocation types already defined.
1887
1888 ENUM
1889   BFD_RELOC_SPARC_BASE13
1890 ENUMX
1891   BFD_RELOC_SPARC_BASE22
1892 ENUMDOC
1893   I think these are specific to SPARC a.out (e.g., Sun 4).
1894
1895 ENUMEQ
1896   BFD_RELOC_SPARC_64
1897   BFD_RELOC_64
1898 ENUMX
1899   BFD_RELOC_SPARC_10
1900 ENUMX
1901   BFD_RELOC_SPARC_11
1902 ENUMX
1903   BFD_RELOC_SPARC_OLO10
1904 ENUMX
1905   BFD_RELOC_SPARC_HH22
1906 ENUMX
1907   BFD_RELOC_SPARC_HM10
1908 ENUMX
1909   BFD_RELOC_SPARC_LM22
1910 ENUMX
1911   BFD_RELOC_SPARC_PC_HH22
1912 ENUMX
1913   BFD_RELOC_SPARC_PC_HM10
1914 ENUMX
1915   BFD_RELOC_SPARC_PC_LM22
1916 ENUMX
1917   BFD_RELOC_SPARC_WDISP16
1918 ENUMX
1919   BFD_RELOC_SPARC_WDISP19
1920 ENUMX
1921   BFD_RELOC_SPARC_7
1922 ENUMX
1923   BFD_RELOC_SPARC_6
1924 ENUMX
1925   BFD_RELOC_SPARC_5
1926 ENUMEQX
1927   BFD_RELOC_SPARC_DISP64
1928   BFD_RELOC_64_PCREL
1929 ENUMX
1930   BFD_RELOC_SPARC_PLT32
1931 ENUMX
1932   BFD_RELOC_SPARC_PLT64
1933 ENUMX
1934   BFD_RELOC_SPARC_HIX22
1935 ENUMX
1936   BFD_RELOC_SPARC_LOX10
1937 ENUMX
1938   BFD_RELOC_SPARC_H44
1939 ENUMX
1940   BFD_RELOC_SPARC_M44
1941 ENUMX
1942   BFD_RELOC_SPARC_L44
1943 ENUMX
1944   BFD_RELOC_SPARC_REGISTER
1945 ENUMDOC
1946   SPARC64 relocations
1947
1948 ENUM
1949   BFD_RELOC_SPARC_REV32
1950 ENUMDOC
1951   SPARC little endian relocation
1952 ENUM
1953   BFD_RELOC_SPARC_TLS_GD_HI22
1954 ENUMX
1955   BFD_RELOC_SPARC_TLS_GD_LO10
1956 ENUMX
1957   BFD_RELOC_SPARC_TLS_GD_ADD
1958 ENUMX
1959   BFD_RELOC_SPARC_TLS_GD_CALL
1960 ENUMX
1961   BFD_RELOC_SPARC_TLS_LDM_HI22
1962 ENUMX
1963   BFD_RELOC_SPARC_TLS_LDM_LO10
1964 ENUMX
1965   BFD_RELOC_SPARC_TLS_LDM_ADD
1966 ENUMX
1967   BFD_RELOC_SPARC_TLS_LDM_CALL
1968 ENUMX
1969   BFD_RELOC_SPARC_TLS_LDO_HIX22
1970 ENUMX
1971   BFD_RELOC_SPARC_TLS_LDO_LOX10
1972 ENUMX
1973   BFD_RELOC_SPARC_TLS_LDO_ADD
1974 ENUMX
1975   BFD_RELOC_SPARC_TLS_IE_HI22
1976 ENUMX
1977   BFD_RELOC_SPARC_TLS_IE_LO10
1978 ENUMX
1979   BFD_RELOC_SPARC_TLS_IE_LD
1980 ENUMX
1981   BFD_RELOC_SPARC_TLS_IE_LDX
1982 ENUMX
1983   BFD_RELOC_SPARC_TLS_IE_ADD
1984 ENUMX
1985   BFD_RELOC_SPARC_TLS_LE_HIX22
1986 ENUMX
1987   BFD_RELOC_SPARC_TLS_LE_LOX10
1988 ENUMX
1989   BFD_RELOC_SPARC_TLS_DTPMOD32
1990 ENUMX
1991   BFD_RELOC_SPARC_TLS_DTPMOD64
1992 ENUMX
1993   BFD_RELOC_SPARC_TLS_DTPOFF32
1994 ENUMX
1995   BFD_RELOC_SPARC_TLS_DTPOFF64
1996 ENUMX
1997   BFD_RELOC_SPARC_TLS_TPOFF32
1998 ENUMX
1999   BFD_RELOC_SPARC_TLS_TPOFF64
2000 ENUMDOC
2001   SPARC TLS relocations
2002
2003 ENUM
2004   BFD_RELOC_SPU_IMM7
2005 ENUMX
2006   BFD_RELOC_SPU_IMM8
2007 ENUMX
2008   BFD_RELOC_SPU_IMM10
2009 ENUMX
2010   BFD_RELOC_SPU_IMM10W
2011 ENUMX
2012   BFD_RELOC_SPU_IMM16
2013 ENUMX
2014   BFD_RELOC_SPU_IMM16W
2015 ENUMX
2016   BFD_RELOC_SPU_IMM18
2017 ENUMX
2018   BFD_RELOC_SPU_PCREL9a
2019 ENUMX
2020   BFD_RELOC_SPU_PCREL9b
2021 ENUMX
2022   BFD_RELOC_SPU_PCREL16
2023 ENUMX
2024   BFD_RELOC_SPU_LO16
2025 ENUMX
2026   BFD_RELOC_SPU_HI16
2027 ENUMX
2028   BFD_RELOC_SPU_PPU32
2029 ENUMX
2030   BFD_RELOC_SPU_PPU64
2031 ENUMX
2032   BFD_RELOC_SPU_ADD_PIC
2033 ENUMDOC
2034   SPU Relocations.
2035
2036 ENUM
2037   BFD_RELOC_ALPHA_GPDISP_HI16
2038 ENUMDOC
2039   Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
2040      "addend" in some special way.
2041   For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
2042      writing; when reading, it will be the absolute section symbol.  The
2043      addend is the displacement in bytes of the "lda" instruction from
2044      the "ldah" instruction (which is at the address of this reloc).
2045 ENUM
2046   BFD_RELOC_ALPHA_GPDISP_LO16
2047 ENUMDOC
2048   For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
2049      with GPDISP_HI16 relocs.  The addend is ignored when writing the
2050      relocations out, and is filled in with the file's GP value on
2051      reading, for convenience.
2052
2053 ENUM
2054   BFD_RELOC_ALPHA_GPDISP
2055 ENUMDOC
2056   The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
2057      relocation except that there is no accompanying GPDISP_LO16
2058      relocation.
2059
2060 ENUM
2061   BFD_RELOC_ALPHA_LITERAL
2062 ENUMX
2063   BFD_RELOC_ALPHA_ELF_LITERAL
2064 ENUMX
2065   BFD_RELOC_ALPHA_LITUSE
2066 ENUMDOC
2067   The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
2068      the assembler turns it into a LDQ instruction to load the address of
2069      the symbol, and then fills in a register in the real instruction.
2070
2071      The LITERAL reloc, at the LDQ instruction, refers to the .lita
2072      section symbol.  The addend is ignored when writing, but is filled
2073      in with the file's GP value on reading, for convenience, as with the
2074      GPDISP_LO16 reloc.
2075
2076      The ELF_LITERAL reloc is somewhere between 16_GOTOFF and GPDISP_LO16.
2077      It should refer to the symbol to be referenced, as with 16_GOTOFF,
2078      but it generates output not based on the position within the .got
2079      section, but relative to the GP value chosen for the file during the
2080      final link stage.
2081
2082      The LITUSE reloc, on the instruction using the loaded address, gives
2083      information to the linker that it might be able to use to optimize
2084      away some literal section references.  The symbol is ignored (read
2085      as the absolute section symbol), and the "addend" indicates the type
2086      of instruction using the register:
2087               1 - "memory" fmt insn
2088               2 - byte-manipulation (byte offset reg)
2089               3 - jsr (target of branch)
2090
2091 ENUM
2092   BFD_RELOC_ALPHA_HINT
2093 ENUMDOC
2094   The HINT relocation indicates a value that should be filled into the
2095      "hint" field of a jmp/jsr/ret instruction, for possible branch-
2096      prediction logic which may be provided on some processors.
2097
2098 ENUM
2099   BFD_RELOC_ALPHA_LINKAGE
2100 ENUMDOC
2101   The LINKAGE relocation outputs a linkage pair in the object file,
2102      which is filled by the linker.
2103
2104 ENUM
2105   BFD_RELOC_ALPHA_CODEADDR
2106 ENUMDOC
2107   The CODEADDR relocation outputs a STO_CA in the object file,
2108      which is filled by the linker.
2109
2110 ENUM
2111   BFD_RELOC_ALPHA_GPREL_HI16
2112 ENUMX
2113   BFD_RELOC_ALPHA_GPREL_LO16
2114 ENUMDOC
2115   The GPREL_HI/LO relocations together form a 32-bit offset from the
2116      GP register.
2117
2118 ENUM
2119   BFD_RELOC_ALPHA_BRSGP
2120 ENUMDOC
2121   Like BFD_RELOC_23_PCREL_S2, except that the source and target must
2122   share a common GP, and the target address is adjusted for
2123   STO_ALPHA_STD_GPLOAD.
2124
2125 ENUM
2126   BFD_RELOC_ALPHA_NOP
2127 ENUMDOC
2128   The NOP relocation outputs a NOP if the longword displacement
2129      between two procedure entry points is < 2^21.
2130
2131 ENUM
2132   BFD_RELOC_ALPHA_BSR
2133 ENUMDOC
2134   The BSR relocation outputs a BSR if the longword displacement
2135      between two procedure entry points is < 2^21.
2136
2137 ENUM
2138   BFD_RELOC_ALPHA_LDA
2139 ENUMDOC
2140   The LDA relocation outputs a LDA if the longword displacement
2141      between two procedure entry points is < 2^16.
2142
2143 ENUM
2144   BFD_RELOC_ALPHA_BOH
2145 ENUMDOC
2146   The BOH relocation outputs a BSR if the longword displacement
2147      between two procedure entry points is < 2^21, or else a hint.
2148
2149 ENUM
2150   BFD_RELOC_ALPHA_TLSGD
2151 ENUMX
2152   BFD_RELOC_ALPHA_TLSLDM
2153 ENUMX
2154   BFD_RELOC_ALPHA_DTPMOD64
2155 ENUMX
2156   BFD_RELOC_ALPHA_GOTDTPREL16
2157 ENUMX
2158   BFD_RELOC_ALPHA_DTPREL64
2159 ENUMX
2160   BFD_RELOC_ALPHA_DTPREL_HI16
2161 ENUMX
2162   BFD_RELOC_ALPHA_DTPREL_LO16
2163 ENUMX
2164   BFD_RELOC_ALPHA_DTPREL16
2165 ENUMX
2166   BFD_RELOC_ALPHA_GOTTPREL16
2167 ENUMX
2168   BFD_RELOC_ALPHA_TPREL64
2169 ENUMX
2170   BFD_RELOC_ALPHA_TPREL_HI16
2171 ENUMX
2172   BFD_RELOC_ALPHA_TPREL_LO16
2173 ENUMX
2174   BFD_RELOC_ALPHA_TPREL16
2175 ENUMDOC
2176   Alpha thread-local storage relocations.
2177
2178 ENUM
2179   BFD_RELOC_MIPS_JMP
2180 ENUMX
2181   BFD_RELOC_MICROMIPS_JMP
2182 ENUMDOC
2183   The MIPS jump instruction.
2184
2185 ENUM
2186   BFD_RELOC_MIPS16_JMP
2187 ENUMDOC
2188   The MIPS16 jump instruction.
2189
2190 ENUM
2191   BFD_RELOC_MIPS16_GPREL
2192 ENUMDOC
2193   MIPS16 GP relative reloc.
2194
2195 ENUM
2196   BFD_RELOC_HI16
2197 ENUMDOC
2198   High 16 bits of 32-bit value; simple reloc.
2199
2200 ENUM
2201   BFD_RELOC_HI16_S
2202 ENUMDOC
2203   High 16 bits of 32-bit value but the low 16 bits will be sign
2204      extended and added to form the final result.  If the low 16
2205      bits form a negative number, we need to add one to the high value
2206      to compensate for the borrow when the low bits are added.
2207
2208 ENUM
2209   BFD_RELOC_LO16
2210 ENUMDOC
2211   Low 16 bits.
2212
2213 ENUM
2214   BFD_RELOC_HI16_PCREL
2215 ENUMDOC
2216   High 16 bits of 32-bit pc-relative value
2217 ENUM
2218   BFD_RELOC_HI16_S_PCREL
2219 ENUMDOC
2220   High 16 bits of 32-bit pc-relative value, adjusted
2221 ENUM
2222   BFD_RELOC_LO16_PCREL
2223 ENUMDOC
2224   Low 16 bits of pc-relative value
2225
2226 ENUM
2227   BFD_RELOC_MIPS16_GOT16
2228 ENUMX
2229   BFD_RELOC_MIPS16_CALL16
2230 ENUMDOC
2231   Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
2232      16-bit immediate fields
2233 ENUM
2234   BFD_RELOC_MIPS16_HI16
2235 ENUMDOC
2236   MIPS16 high 16 bits of 32-bit value.
2237 ENUM
2238   BFD_RELOC_MIPS16_HI16_S
2239 ENUMDOC
2240   MIPS16 high 16 bits of 32-bit value but the low 16 bits will be sign
2241      extended and added to form the final result.  If the low 16
2242      bits form a negative number, we need to add one to the high value
2243      to compensate for the borrow when the low bits are added.
2244 ENUM
2245   BFD_RELOC_MIPS16_LO16
2246 ENUMDOC
2247   MIPS16 low 16 bits.
2248
2249 ENUM
2250   BFD_RELOC_MIPS_LITERAL
2251 ENUMX
2252   BFD_RELOC_MICROMIPS_LITERAL
2253 ENUMDOC
2254   Relocation against a MIPS literal section.
2255
2256 ENUM
2257   BFD_RELOC_MICROMIPS_7_PCREL_S1
2258 ENUMX
2259   BFD_RELOC_MICROMIPS_10_PCREL_S1
2260 ENUMX
2261   BFD_RELOC_MICROMIPS_16_PCREL_S1
2262 ENUMDOC
2263   microMIPS PC-relative relocations.
2264
2265 ENUM
2266   BFD_RELOC_MICROMIPS_GPREL16
2267 ENUMX
2268   BFD_RELOC_MICROMIPS_HI16
2269 ENUMX
2270   BFD_RELOC_MICROMIPS_HI16_S
2271 ENUMX
2272   BFD_RELOC_MICROMIPS_LO16
2273 ENUMDOC
2274   microMIPS versions of generic BFD relocs.
2275
2276 ENUM
2277   BFD_RELOC_MIPS_GOT16
2278 ENUMX
2279   BFD_RELOC_MICROMIPS_GOT16
2280 ENUMX
2281   BFD_RELOC_MIPS_CALL16
2282 ENUMX
2283   BFD_RELOC_MICROMIPS_CALL16
2284 ENUMX
2285   BFD_RELOC_MIPS_GOT_HI16
2286 ENUMX
2287   BFD_RELOC_MICROMIPS_GOT_HI16
2288 ENUMX
2289   BFD_RELOC_MIPS_GOT_LO16
2290 ENUMX
2291   BFD_RELOC_MICROMIPS_GOT_LO16
2292 ENUMX
2293   BFD_RELOC_MIPS_CALL_HI16
2294 ENUMX
2295   BFD_RELOC_MICROMIPS_CALL_HI16
2296 ENUMX
2297   BFD_RELOC_MIPS_CALL_LO16
2298 ENUMX
2299   BFD_RELOC_MICROMIPS_CALL_LO16
2300 ENUMX
2301   BFD_RELOC_MIPS_SUB
2302 ENUMX
2303   BFD_RELOC_MICROMIPS_SUB
2304 ENUMX
2305   BFD_RELOC_MIPS_GOT_PAGE
2306 ENUMX
2307   BFD_RELOC_MICROMIPS_GOT_PAGE
2308 ENUMX
2309   BFD_RELOC_MIPS_GOT_OFST
2310 ENUMX
2311   BFD_RELOC_MICROMIPS_GOT_OFST
2312 ENUMX
2313   BFD_RELOC_MIPS_GOT_DISP
2314 ENUMX
2315   BFD_RELOC_MICROMIPS_GOT_DISP
2316 ENUMX
2317   BFD_RELOC_MIPS_SHIFT5
2318 ENUMX
2319   BFD_RELOC_MIPS_SHIFT6
2320 ENUMX
2321   BFD_RELOC_MIPS_INSERT_A
2322 ENUMX
2323   BFD_RELOC_MIPS_INSERT_B
2324 ENUMX
2325   BFD_RELOC_MIPS_DELETE
2326 ENUMX
2327   BFD_RELOC_MIPS_HIGHEST
2328 ENUMX
2329   BFD_RELOC_MICROMIPS_HIGHEST
2330 ENUMX
2331   BFD_RELOC_MIPS_HIGHER
2332 ENUMX
2333   BFD_RELOC_MICROMIPS_HIGHER
2334 ENUMX
2335   BFD_RELOC_MIPS_SCN_DISP
2336 ENUMX
2337   BFD_RELOC_MICROMIPS_SCN_DISP
2338 ENUMX
2339   BFD_RELOC_MIPS_REL16
2340 ENUMX
2341   BFD_RELOC_MIPS_RELGOT
2342 ENUMX
2343   BFD_RELOC_MIPS_JALR
2344 ENUMX
2345   BFD_RELOC_MICROMIPS_JALR
2346 ENUMX
2347   BFD_RELOC_MIPS_TLS_DTPMOD32
2348 ENUMX
2349   BFD_RELOC_MIPS_TLS_DTPREL32
2350 ENUMX
2351   BFD_RELOC_MIPS_TLS_DTPMOD64
2352 ENUMX
2353   BFD_RELOC_MIPS_TLS_DTPREL64
2354 ENUMX
2355   BFD_RELOC_MIPS_TLS_GD
2356 ENUMX
2357   BFD_RELOC_MICROMIPS_TLS_GD
2358 ENUMX
2359   BFD_RELOC_MIPS_TLS_LDM
2360 ENUMX
2361   BFD_RELOC_MICROMIPS_TLS_LDM
2362 ENUMX
2363   BFD_RELOC_MIPS_TLS_DTPREL_HI16
2364 ENUMX
2365   BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16
2366 ENUMX
2367   BFD_RELOC_MIPS_TLS_DTPREL_LO16
2368 ENUMX
2369   BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16
2370 ENUMX
2371   BFD_RELOC_MIPS_TLS_GOTTPREL
2372 ENUMX
2373   BFD_RELOC_MICROMIPS_TLS_GOTTPREL
2374 ENUMX
2375   BFD_RELOC_MIPS_TLS_TPREL32
2376 ENUMX
2377   BFD_RELOC_MIPS_TLS_TPREL64
2378 ENUMX
2379   BFD_RELOC_MIPS_TLS_TPREL_HI16
2380 ENUMX
2381   BFD_RELOC_MICROMIPS_TLS_TPREL_HI16
2382 ENUMX
2383   BFD_RELOC_MIPS_TLS_TPREL_LO16
2384 ENUMX
2385   BFD_RELOC_MICROMIPS_TLS_TPREL_LO16
2386 ENUMDOC
2387   MIPS ELF relocations.
2388 COMMENT
2389
2390 ENUM
2391   BFD_RELOC_MIPS_COPY
2392 ENUMX
2393   BFD_RELOC_MIPS_JUMP_SLOT
2394 ENUMDOC
2395   MIPS ELF relocations (VxWorks and PLT extensions).
2396 COMMENT
2397
2398 ENUM
2399   BFD_RELOC_MOXIE_10_PCREL
2400 ENUMDOC
2401   Moxie ELF relocations.
2402 COMMENT
2403
2404 ENUM
2405   BFD_RELOC_FRV_LABEL16
2406 ENUMX
2407   BFD_RELOC_FRV_LABEL24
2408 ENUMX
2409   BFD_RELOC_FRV_LO16
2410 ENUMX
2411   BFD_RELOC_FRV_HI16
2412 ENUMX
2413   BFD_RELOC_FRV_GPREL12
2414 ENUMX
2415   BFD_RELOC_FRV_GPRELU12
2416 ENUMX
2417   BFD_RELOC_FRV_GPREL32
2418 ENUMX
2419   BFD_RELOC_FRV_GPRELHI
2420 ENUMX
2421   BFD_RELOC_FRV_GPRELLO
2422 ENUMX
2423   BFD_RELOC_FRV_GOT12
2424 ENUMX
2425   BFD_RELOC_FRV_GOTHI
2426 ENUMX
2427   BFD_RELOC_FRV_GOTLO
2428 ENUMX
2429   BFD_RELOC_FRV_FUNCDESC
2430 ENUMX
2431   BFD_RELOC_FRV_FUNCDESC_GOT12
2432 ENUMX
2433   BFD_RELOC_FRV_FUNCDESC_GOTHI
2434 ENUMX
2435   BFD_RELOC_FRV_FUNCDESC_GOTLO
2436 ENUMX
2437   BFD_RELOC_FRV_FUNCDESC_VALUE
2438 ENUMX
2439   BFD_RELOC_FRV_FUNCDESC_GOTOFF12
2440 ENUMX
2441   BFD_RELOC_FRV_FUNCDESC_GOTOFFHI
2442 ENUMX
2443   BFD_RELOC_FRV_FUNCDESC_GOTOFFLO
2444 ENUMX
2445   BFD_RELOC_FRV_GOTOFF12
2446 ENUMX
2447   BFD_RELOC_FRV_GOTOFFHI
2448 ENUMX
2449   BFD_RELOC_FRV_GOTOFFLO
2450 ENUMX
2451   BFD_RELOC_FRV_GETTLSOFF
2452 ENUMX
2453   BFD_RELOC_FRV_TLSDESC_VALUE
2454 ENUMX
2455   BFD_RELOC_FRV_GOTTLSDESC12
2456 ENUMX
2457   BFD_RELOC_FRV_GOTTLSDESCHI
2458 ENUMX
2459   BFD_RELOC_FRV_GOTTLSDESCLO
2460 ENUMX
2461   BFD_RELOC_FRV_TLSMOFF12
2462 ENUMX
2463   BFD_RELOC_FRV_TLSMOFFHI
2464 ENUMX
2465   BFD_RELOC_FRV_TLSMOFFLO
2466 ENUMX
2467   BFD_RELOC_FRV_GOTTLSOFF12
2468 ENUMX
2469   BFD_RELOC_FRV_GOTTLSOFFHI
2470 ENUMX
2471   BFD_RELOC_FRV_GOTTLSOFFLO
2472 ENUMX
2473   BFD_RELOC_FRV_TLSOFF
2474 ENUMX
2475   BFD_RELOC_FRV_TLSDESC_RELAX
2476 ENUMX
2477   BFD_RELOC_FRV_GETTLSOFF_RELAX
2478 ENUMX
2479   BFD_RELOC_FRV_TLSOFF_RELAX
2480 ENUMX
2481   BFD_RELOC_FRV_TLSMOFF
2482 ENUMDOC
2483   Fujitsu Frv Relocations.
2484 COMMENT
2485
2486 ENUM
2487   BFD_RELOC_MN10300_GOTOFF24
2488 ENUMDOC
2489   This is a 24bit GOT-relative reloc for the mn10300.
2490 ENUM
2491   BFD_RELOC_MN10300_GOT32
2492 ENUMDOC
2493   This is a 32bit GOT-relative reloc for the mn10300, offset by two bytes
2494   in the instruction.
2495 ENUM
2496   BFD_RELOC_MN10300_GOT24
2497 ENUMDOC
2498   This is a 24bit GOT-relative reloc for the mn10300, offset by two bytes
2499   in the instruction.
2500 ENUM
2501   BFD_RELOC_MN10300_GOT16
2502 ENUMDOC
2503   This is a 16bit GOT-relative reloc for the mn10300, offset by two bytes
2504   in the instruction.
2505 ENUM
2506   BFD_RELOC_MN10300_COPY
2507 ENUMDOC
2508   Copy symbol at runtime.
2509 ENUM
2510   BFD_RELOC_MN10300_GLOB_DAT
2511 ENUMDOC
2512   Create GOT entry.
2513 ENUM
2514   BFD_RELOC_MN10300_JMP_SLOT
2515 ENUMDOC
2516   Create PLT entry.
2517 ENUM
2518   BFD_RELOC_MN10300_RELATIVE
2519 ENUMDOC
2520   Adjust by program base.
2521 ENUM
2522   BFD_RELOC_MN10300_SYM_DIFF
2523 ENUMDOC
2524   Together with another reloc targeted at the same location,
2525   allows for a value that is the difference of two symbols
2526   in the same section.
2527 ENUM
2528   BFD_RELOC_MN10300_ALIGN
2529 ENUMDOC
2530   The addend of this reloc is an alignment power that must
2531   be honoured at the offset's location, regardless of linker
2532   relaxation.
2533 COMMENT
2534
2535 ENUM
2536   BFD_RELOC_386_GOT32
2537 ENUMX
2538   BFD_RELOC_386_PLT32
2539 ENUMX
2540   BFD_RELOC_386_COPY
2541 ENUMX
2542   BFD_RELOC_386_GLOB_DAT
2543 ENUMX
2544   BFD_RELOC_386_JUMP_SLOT
2545 ENUMX
2546   BFD_RELOC_386_RELATIVE
2547 ENUMX
2548   BFD_RELOC_386_GOTOFF
2549 ENUMX
2550   BFD_RELOC_386_GOTPC
2551 ENUMX
2552   BFD_RELOC_386_TLS_TPOFF
2553 ENUMX
2554   BFD_RELOC_386_TLS_IE
2555 ENUMX
2556   BFD_RELOC_386_TLS_GOTIE
2557 ENUMX
2558   BFD_RELOC_386_TLS_LE
2559 ENUMX
2560   BFD_RELOC_386_TLS_GD
2561 ENUMX
2562   BFD_RELOC_386_TLS_LDM
2563 ENUMX
2564   BFD_RELOC_386_TLS_LDO_32
2565 ENUMX
2566   BFD_RELOC_386_TLS_IE_32
2567 ENUMX
2568   BFD_RELOC_386_TLS_LE_32
2569 ENUMX
2570   BFD_RELOC_386_TLS_DTPMOD32
2571 ENUMX
2572   BFD_RELOC_386_TLS_DTPOFF32
2573 ENUMX
2574   BFD_RELOC_386_TLS_TPOFF32
2575 ENUMX
2576   BFD_RELOC_386_TLS_GOTDESC
2577 ENUMX
2578   BFD_RELOC_386_TLS_DESC_CALL
2579 ENUMX
2580   BFD_RELOC_386_TLS_DESC
2581 ENUMX
2582   BFD_RELOC_386_IRELATIVE
2583 ENUMDOC
2584   i386/elf relocations
2585
2586 ENUM
2587   BFD_RELOC_X86_64_GOT32
2588 ENUMX
2589   BFD_RELOC_X86_64_PLT32
2590 ENUMX
2591   BFD_RELOC_X86_64_COPY
2592 ENUMX
2593   BFD_RELOC_X86_64_GLOB_DAT
2594 ENUMX
2595   BFD_RELOC_X86_64_JUMP_SLOT
2596 ENUMX
2597   BFD_RELOC_X86_64_RELATIVE
2598 ENUMX
2599   BFD_RELOC_X86_64_GOTPCREL
2600 ENUMX
2601   BFD_RELOC_X86_64_32S
2602 ENUMX
2603   BFD_RELOC_X86_64_DTPMOD64
2604 ENUMX
2605   BFD_RELOC_X86_64_DTPOFF64
2606 ENUMX
2607   BFD_RELOC_X86_64_TPOFF64
2608 ENUMX
2609   BFD_RELOC_X86_64_TLSGD
2610 ENUMX
2611   BFD_RELOC_X86_64_TLSLD
2612 ENUMX
2613   BFD_RELOC_X86_64_DTPOFF32
2614 ENUMX
2615   BFD_RELOC_X86_64_GOTTPOFF
2616 ENUMX
2617   BFD_RELOC_X86_64_TPOFF32
2618 ENUMX
2619   BFD_RELOC_X86_64_GOTOFF64
2620 ENUMX
2621   BFD_RELOC_X86_64_GOTPC32
2622 ENUMX
2623   BFD_RELOC_X86_64_GOT64
2624 ENUMX
2625   BFD_RELOC_X86_64_GOTPCREL64
2626 ENUMX
2627   BFD_RELOC_X86_64_GOTPC64
2628 ENUMX
2629   BFD_RELOC_X86_64_GOTPLT64
2630 ENUMX
2631   BFD_RELOC_X86_64_PLTOFF64
2632 ENUMX
2633   BFD_RELOC_X86_64_GOTPC32_TLSDESC
2634 ENUMX
2635   BFD_RELOC_X86_64_TLSDESC_CALL
2636 ENUMX
2637   BFD_RELOC_X86_64_TLSDESC
2638 ENUMX
2639   BFD_RELOC_X86_64_IRELATIVE
2640 ENUMDOC
2641   x86-64/elf relocations
2642
2643 ENUM
2644   BFD_RELOC_NS32K_IMM_8
2645 ENUMX
2646   BFD_RELOC_NS32K_IMM_16
2647 ENUMX
2648   BFD_RELOC_NS32K_IMM_32
2649 ENUMX
2650   BFD_RELOC_NS32K_IMM_8_PCREL
2651 ENUMX
2652   BFD_RELOC_NS32K_IMM_16_PCREL
2653 ENUMX
2654   BFD_RELOC_NS32K_IMM_32_PCREL
2655 ENUMX
2656   BFD_RELOC_NS32K_DISP_8
2657 ENUMX
2658   BFD_RELOC_NS32K_DISP_16
2659 ENUMX
2660   BFD_RELOC_NS32K_DISP_32
2661 ENUMX
2662   BFD_RELOC_NS32K_DISP_8_PCREL
2663 ENUMX
2664   BFD_RELOC_NS32K_DISP_16_PCREL
2665 ENUMX
2666   BFD_RELOC_NS32K_DISP_32_PCREL
2667 ENUMDOC
2668   ns32k relocations
2669
2670 ENUM
2671   BFD_RELOC_PDP11_DISP_8_PCREL
2672 ENUMX
2673   BFD_RELOC_PDP11_DISP_6_PCREL
2674 ENUMDOC
2675   PDP11 relocations
2676
2677 ENUM
2678   BFD_RELOC_PJ_CODE_HI16
2679 ENUMX
2680   BFD_RELOC_PJ_CODE_LO16
2681 ENUMX
2682   BFD_RELOC_PJ_CODE_DIR16
2683 ENUMX
2684   BFD_RELOC_PJ_CODE_DIR32
2685 ENUMX
2686   BFD_RELOC_PJ_CODE_REL16
2687 ENUMX
2688   BFD_RELOC_PJ_CODE_REL32
2689 ENUMDOC
2690   Picojava relocs.  Not all of these appear in object files.
2691
2692 ENUM
2693   BFD_RELOC_PPC_B26
2694 ENUMX
2695   BFD_RELOC_PPC_BA26
2696 ENUMX
2697   BFD_RELOC_PPC_TOC16
2698 ENUMX
2699   BFD_RELOC_PPC_B16
2700 ENUMX
2701   BFD_RELOC_PPC_B16_BRTAKEN
2702 ENUMX
2703   BFD_RELOC_PPC_B16_BRNTAKEN
2704 ENUMX
2705   BFD_RELOC_PPC_BA16
2706 ENUMX
2707   BFD_RELOC_PPC_BA16_BRTAKEN
2708 ENUMX
2709   BFD_RELOC_PPC_BA16_BRNTAKEN
2710 ENUMX
2711   BFD_RELOC_PPC_COPY
2712 ENUMX
2713   BFD_RELOC_PPC_GLOB_DAT
2714 ENUMX
2715   BFD_RELOC_PPC_JMP_SLOT
2716 ENUMX
2717   BFD_RELOC_PPC_RELATIVE
2718 ENUMX
2719   BFD_RELOC_PPC_LOCAL24PC
2720 ENUMX
2721   BFD_RELOC_PPC_EMB_NADDR32
2722 ENUMX
2723   BFD_RELOC_PPC_EMB_NADDR16
2724 ENUMX
2725   BFD_RELOC_PPC_EMB_NADDR16_LO
2726 ENUMX
2727   BFD_RELOC_PPC_EMB_NADDR16_HI
2728 ENUMX
2729   BFD_RELOC_PPC_EMB_NADDR16_HA
2730 ENUMX
2731   BFD_RELOC_PPC_EMB_SDAI16
2732 ENUMX
2733   BFD_RELOC_PPC_EMB_SDA2I16
2734 ENUMX
2735   BFD_RELOC_PPC_EMB_SDA2REL
2736 ENUMX
2737   BFD_RELOC_PPC_EMB_SDA21
2738 ENUMX
2739   BFD_RELOC_PPC_EMB_MRKREF
2740 ENUMX
2741   BFD_RELOC_PPC_EMB_RELSEC16
2742 ENUMX
2743   BFD_RELOC_PPC_EMB_RELST_LO
2744 ENUMX
2745   BFD_RELOC_PPC_EMB_RELST_HI
2746 ENUMX
2747   BFD_RELOC_PPC_EMB_RELST_HA
2748 ENUMX
2749   BFD_RELOC_PPC_EMB_BIT_FLD
2750 ENUMX
2751   BFD_RELOC_PPC_EMB_RELSDA
2752 ENUMX
2753   BFD_RELOC_PPC64_HIGHER
2754 ENUMX
2755   BFD_RELOC_PPC64_HIGHER_S
2756 ENUMX
2757   BFD_RELOC_PPC64_HIGHEST
2758 ENUMX
2759   BFD_RELOC_PPC64_HIGHEST_S
2760 ENUMX
2761   BFD_RELOC_PPC64_TOC16_LO
2762 ENUMX
2763   BFD_RELOC_PPC64_TOC16_HI
2764 ENUMX
2765   BFD_RELOC_PPC64_TOC16_HA
2766 ENUMX
2767   BFD_RELOC_PPC64_TOC
2768 ENUMX
2769   BFD_RELOC_PPC64_PLTGOT16
2770 ENUMX
2771   BFD_RELOC_PPC64_PLTGOT16_LO
2772 ENUMX
2773   BFD_RELOC_PPC64_PLTGOT16_HI
2774 ENUMX
2775   BFD_RELOC_PPC64_PLTGOT16_HA
2776 ENUMX
2777   BFD_RELOC_PPC64_ADDR16_DS
2778 ENUMX
2779   BFD_RELOC_PPC64_ADDR16_LO_DS
2780 ENUMX
2781   BFD_RELOC_PPC64_GOT16_DS
2782 ENUMX
2783   BFD_RELOC_PPC64_GOT16_LO_DS
2784 ENUMX
2785   BFD_RELOC_PPC64_PLT16_LO_DS
2786 ENUMX
2787   BFD_RELOC_PPC64_SECTOFF_DS
2788 ENUMX
2789   BFD_RELOC_PPC64_SECTOFF_LO_DS
2790 ENUMX
2791   BFD_RELOC_PPC64_TOC16_DS
2792 ENUMX
2793   BFD_RELOC_PPC64_TOC16_LO_DS
2794 ENUMX
2795   BFD_RELOC_PPC64_PLTGOT16_DS
2796 ENUMX
2797   BFD_RELOC_PPC64_PLTGOT16_LO_DS
2798 ENUMDOC
2799   Power(rs6000) and PowerPC relocations.
2800
2801 ENUM
2802   BFD_RELOC_PPC_TLS
2803 ENUMX
2804   BFD_RELOC_PPC_TLSGD
2805 ENUMX
2806   BFD_RELOC_PPC_TLSLD
2807 ENUMX
2808   BFD_RELOC_PPC_DTPMOD
2809 ENUMX
2810   BFD_RELOC_PPC_TPREL16
2811 ENUMX
2812   BFD_RELOC_PPC_TPREL16_LO
2813 ENUMX
2814   BFD_RELOC_PPC_TPREL16_HI
2815 ENUMX
2816   BFD_RELOC_PPC_TPREL16_HA
2817 ENUMX
2818   BFD_RELOC_PPC_TPREL
2819 ENUMX
2820   BFD_RELOC_PPC_DTPREL16
2821 ENUMX
2822   BFD_RELOC_PPC_DTPREL16_LO
2823 ENUMX
2824   BFD_RELOC_PPC_DTPREL16_HI
2825 ENUMX
2826   BFD_RELOC_PPC_DTPREL16_HA
2827 ENUMX
2828   BFD_RELOC_PPC_DTPREL
2829 ENUMX
2830   BFD_RELOC_PPC_GOT_TLSGD16
2831 ENUMX
2832   BFD_RELOC_PPC_GOT_TLSGD16_LO
2833 ENUMX
2834   BFD_RELOC_PPC_GOT_TLSGD16_HI
2835 ENUMX
2836   BFD_RELOC_PPC_GOT_TLSGD16_HA
2837 ENUMX
2838   BFD_RELOC_PPC_GOT_TLSLD16
2839 ENUMX
2840   BFD_RELOC_PPC_GOT_TLSLD16_LO
2841 ENUMX
2842   BFD_RELOC_PPC_GOT_TLSLD16_HI
2843 ENUMX
2844   BFD_RELOC_PPC_GOT_TLSLD16_HA
2845 ENUMX
2846   BFD_RELOC_PPC_GOT_TPREL16
2847 ENUMX
2848   BFD_RELOC_PPC_GOT_TPREL16_LO
2849 ENUMX
2850   BFD_RELOC_PPC_GOT_TPREL16_HI
2851 ENUMX
2852   BFD_RELOC_PPC_GOT_TPREL16_HA
2853 ENUMX
2854   BFD_RELOC_PPC_GOT_DTPREL16
2855 ENUMX
2856   BFD_RELOC_PPC_GOT_DTPREL16_LO
2857 ENUMX
2858   BFD_RELOC_PPC_GOT_DTPREL16_HI
2859 ENUMX
2860   BFD_RELOC_PPC_GOT_DTPREL16_HA
2861 ENUMX
2862   BFD_RELOC_PPC64_TPREL16_DS
2863 ENUMX
2864   BFD_RELOC_PPC64_TPREL16_LO_DS
2865 ENUMX
2866   BFD_RELOC_PPC64_TPREL16_HIGHER
2867 ENUMX
2868   BFD_RELOC_PPC64_TPREL16_HIGHERA
2869 ENUMX
2870   BFD_RELOC_PPC64_TPREL16_HIGHEST
2871 ENUMX
2872   BFD_RELOC_PPC64_TPREL16_HIGHESTA
2873 ENUMX
2874   BFD_RELOC_PPC64_DTPREL16_DS
2875 ENUMX
2876   BFD_RELOC_PPC64_DTPREL16_LO_DS
2877 ENUMX
2878   BFD_RELOC_PPC64_DTPREL16_HIGHER
2879 ENUMX
2880   BFD_RELOC_PPC64_DTPREL16_HIGHERA
2881 ENUMX
2882   BFD_RELOC_PPC64_DTPREL16_HIGHEST
2883 ENUMX
2884   BFD_RELOC_PPC64_DTPREL16_HIGHESTA
2885 ENUMDOC
2886   PowerPC and PowerPC64 thread-local storage relocations.
2887
2888 ENUM
2889   BFD_RELOC_I370_D12
2890 ENUMDOC
2891   IBM 370/390 relocations
2892
2893 ENUM
2894   BFD_RELOC_CTOR
2895 ENUMDOC
2896   The type of reloc used to build a constructor table - at the moment
2897   probably a 32 bit wide absolute relocation, but the target can choose.
2898   It generally does map to one of the other relocation types.
2899
2900 ENUM
2901   BFD_RELOC_ARM_PCREL_BRANCH
2902 ENUMDOC
2903   ARM 26 bit pc-relative branch.  The lowest two bits must be zero and are
2904   not stored in the instruction.
2905 ENUM
2906   BFD_RELOC_ARM_PCREL_BLX
2907 ENUMDOC
2908   ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
2909   not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2910   field in the instruction.
2911 ENUM
2912   BFD_RELOC_THUMB_PCREL_BLX
2913 ENUMDOC
2914   Thumb 22 bit pc-relative branch.  The lowest bit must be zero and is
2915   not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2916   field in the instruction.
2917 ENUM
2918   BFD_RELOC_ARM_PCREL_CALL
2919 ENUMDOC
2920   ARM 26-bit pc-relative branch for an unconditional BL or BLX instruction.
2921 ENUM
2922   BFD_RELOC_ARM_PCREL_JUMP
2923 ENUMDOC
2924   ARM 26-bit pc-relative branch for B or conditional BL instruction.
2925
2926 ENUM
2927   BFD_RELOC_THUMB_PCREL_BRANCH7
2928 ENUMX
2929   BFD_RELOC_THUMB_PCREL_BRANCH9
2930 ENUMX
2931   BFD_RELOC_THUMB_PCREL_BRANCH12
2932 ENUMX
2933   BFD_RELOC_THUMB_PCREL_BRANCH20
2934 ENUMX
2935   BFD_RELOC_THUMB_PCREL_BRANCH23
2936 ENUMX
2937   BFD_RELOC_THUMB_PCREL_BRANCH25
2938 ENUMDOC
2939   Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.
2940   The lowest bit must be zero and is not stored in the instruction.
2941   Note that the corresponding ELF R_ARM_THM_JUMPnn constant has an
2942   "nn" one smaller in all cases.  Note further that BRANCH23
2943   corresponds to R_ARM_THM_CALL.
2944
2945 ENUM
2946   BFD_RELOC_ARM_OFFSET_IMM
2947 ENUMDOC
2948   12-bit immediate offset, used in ARM-format ldr and str instructions.
2949
2950 ENUM
2951   BFD_RELOC_ARM_THUMB_OFFSET
2952 ENUMDOC
2953   5-bit immediate offset, used in Thumb-format ldr and str instructions.
2954
2955 ENUM
2956   BFD_RELOC_ARM_TARGET1
2957 ENUMDOC
2958   Pc-relative or absolute relocation depending on target.  Used for
2959   entries in .init_array sections.
2960 ENUM
2961   BFD_RELOC_ARM_ROSEGREL32
2962 ENUMDOC
2963   Read-only segment base relative address.
2964 ENUM
2965   BFD_RELOC_ARM_SBREL32
2966 ENUMDOC
2967   Data segment base relative address.
2968 ENUM
2969   BFD_RELOC_ARM_TARGET2
2970 ENUMDOC
2971   This reloc is used for references to RTTI data from exception handling
2972   tables.  The actual definition depends on the target.  It may be a
2973   pc-relative or some form of GOT-indirect relocation.
2974 ENUM
2975   BFD_RELOC_ARM_PREL31
2976 ENUMDOC
2977   31-bit PC relative address.
2978 ENUM
2979   BFD_RELOC_ARM_MOVW
2980 ENUMX
2981   BFD_RELOC_ARM_MOVT
2982 ENUMX
2983   BFD_RELOC_ARM_MOVW_PCREL
2984 ENUMX
2985   BFD_RELOC_ARM_MOVT_PCREL
2986 ENUMX
2987   BFD_RELOC_ARM_THUMB_MOVW
2988 ENUMX
2989   BFD_RELOC_ARM_THUMB_MOVT
2990 ENUMX
2991   BFD_RELOC_ARM_THUMB_MOVW_PCREL
2992 ENUMX
2993   BFD_RELOC_ARM_THUMB_MOVT_PCREL
2994 ENUMDOC
2995   Low and High halfword relocations for MOVW and MOVT instructions.
2996
2997 ENUM
2998   BFD_RELOC_ARM_JUMP_SLOT
2999 ENUMX
3000   BFD_RELOC_ARM_GLOB_DAT
3001 ENUMX
3002   BFD_RELOC_ARM_GOT32
3003 ENUMX
3004   BFD_RELOC_ARM_PLT32
3005 ENUMX
3006   BFD_RELOC_ARM_RELATIVE
3007 ENUMX
3008   BFD_RELOC_ARM_GOTOFF
3009 ENUMX
3010   BFD_RELOC_ARM_GOTPC
3011 ENUMX
3012   BFD_RELOC_ARM_GOT_PREL
3013 ENUMDOC
3014   Relocations for setting up GOTs and PLTs for shared libraries.
3015
3016 ENUM
3017   BFD_RELOC_ARM_TLS_GD32
3018 ENUMX
3019   BFD_RELOC_ARM_TLS_LDO32
3020 ENUMX
3021   BFD_RELOC_ARM_TLS_LDM32
3022 ENUMX
3023   BFD_RELOC_ARM_TLS_DTPOFF32
3024 ENUMX
3025   BFD_RELOC_ARM_TLS_DTPMOD32
3026 ENUMX
3027   BFD_RELOC_ARM_TLS_TPOFF32
3028 ENUMX
3029   BFD_RELOC_ARM_TLS_IE32
3030 ENUMX
3031   BFD_RELOC_ARM_TLS_LE32
3032 ENUMX
3033   BFD_RELOC_ARM_TLS_GOTDESC
3034 ENUMX
3035   BFD_RELOC_ARM_TLS_CALL
3036 ENUMX
3037   BFD_RELOC_ARM_THM_TLS_CALL
3038 ENUMX
3039   BFD_RELOC_ARM_TLS_DESCSEQ
3040 ENUMX
3041   BFD_RELOC_ARM_THM_TLS_DESCSEQ
3042 ENUMX
3043   BFD_RELOC_ARM_TLS_DESC
3044 ENUMDOC
3045   ARM thread-local storage relocations.
3046
3047 ENUM
3048   BFD_RELOC_ARM_ALU_PC_G0_NC
3049 ENUMX
3050   BFD_RELOC_ARM_ALU_PC_G0
3051 ENUMX
3052   BFD_RELOC_ARM_ALU_PC_G1_NC
3053 ENUMX
3054   BFD_RELOC_ARM_ALU_PC_G1
3055 ENUMX
3056   BFD_RELOC_ARM_ALU_PC_G2
3057 ENUMX
3058   BFD_RELOC_ARM_LDR_PC_G0
3059 ENUMX
3060   BFD_RELOC_ARM_LDR_PC_G1
3061 ENUMX
3062   BFD_RELOC_ARM_LDR_PC_G2
3063 ENUMX
3064   BFD_RELOC_ARM_LDRS_PC_G0
3065 ENUMX
3066   BFD_RELOC_ARM_LDRS_PC_G1
3067 ENUMX
3068   BFD_RELOC_ARM_LDRS_PC_G2
3069 ENUMX
3070   BFD_RELOC_ARM_LDC_PC_G0
3071 ENUMX
3072   BFD_RELOC_ARM_LDC_PC_G1
3073 ENUMX
3074   BFD_RELOC_ARM_LDC_PC_G2
3075 ENUMX
3076   BFD_RELOC_ARM_ALU_SB_G0_NC
3077 ENUMX
3078   BFD_RELOC_ARM_ALU_SB_G0
3079 ENUMX
3080   BFD_RELOC_ARM_ALU_SB_G1_NC
3081 ENUMX
3082   BFD_RELOC_ARM_ALU_SB_G1
3083 ENUMX
3084   BFD_RELOC_ARM_ALU_SB_G2
3085 ENUMX
3086   BFD_RELOC_ARM_LDR_SB_G0
3087 ENUMX
3088   BFD_RELOC_ARM_LDR_SB_G1
3089 ENUMX
3090   BFD_RELOC_ARM_LDR_SB_G2
3091 ENUMX
3092   BFD_RELOC_ARM_LDRS_SB_G0
3093 ENUMX
3094   BFD_RELOC_ARM_LDRS_SB_G1
3095 ENUMX
3096   BFD_RELOC_ARM_LDRS_SB_G2
3097 ENUMX
3098   BFD_RELOC_ARM_LDC_SB_G0
3099 ENUMX
3100   BFD_RELOC_ARM_LDC_SB_G1
3101 ENUMX
3102   BFD_RELOC_ARM_LDC_SB_G2
3103 ENUMDOC
3104   ARM group relocations.
3105
3106 ENUM
3107   BFD_RELOC_ARM_V4BX
3108 ENUMDOC
3109   Annotation of BX instructions.
3110
3111 ENUM
3112   BFD_RELOC_ARM_IRELATIVE
3113 ENUMDOC
3114   ARM support for STT_GNU_IFUNC.
3115
3116 ENUM
3117   BFD_RELOC_ARM_IMMEDIATE
3118 ENUMX
3119   BFD_RELOC_ARM_ADRL_IMMEDIATE
3120 ENUMX
3121   BFD_RELOC_ARM_T32_IMMEDIATE
3122 ENUMX
3123   BFD_RELOC_ARM_T32_ADD_IMM
3124 ENUMX
3125   BFD_RELOC_ARM_T32_IMM12
3126 ENUMX
3127   BFD_RELOC_ARM_T32_ADD_PC12
3128 ENUMX
3129   BFD_RELOC_ARM_SHIFT_IMM
3130 ENUMX
3131   BFD_RELOC_ARM_SMC
3132 ENUMX
3133   BFD_RELOC_ARM_HVC
3134 ENUMX
3135   BFD_RELOC_ARM_SWI
3136 ENUMX
3137   BFD_RELOC_ARM_MULTI
3138 ENUMX
3139   BFD_RELOC_ARM_CP_OFF_IMM
3140 ENUMX
3141   BFD_RELOC_ARM_CP_OFF_IMM_S2
3142 ENUMX
3143   BFD_RELOC_ARM_T32_CP_OFF_IMM
3144 ENUMX
3145   BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
3146 ENUMX
3147   BFD_RELOC_ARM_ADR_IMM
3148 ENUMX
3149   BFD_RELOC_ARM_LDR_IMM
3150 ENUMX
3151   BFD_RELOC_ARM_LITERAL
3152 ENUMX
3153   BFD_RELOC_ARM_IN_POOL
3154 ENUMX
3155   BFD_RELOC_ARM_OFFSET_IMM8
3156 ENUMX
3157   BFD_RELOC_ARM_T32_OFFSET_U8
3158 ENUMX
3159   BFD_RELOC_ARM_T32_OFFSET_IMM
3160 ENUMX
3161   BFD_RELOC_ARM_HWLITERAL
3162 ENUMX
3163   BFD_RELOC_ARM_THUMB_ADD
3164 ENUMX
3165   BFD_RELOC_ARM_THUMB_IMM
3166 ENUMX
3167   BFD_RELOC_ARM_THUMB_SHIFT
3168 ENUMDOC
3169   These relocs are only used within the ARM assembler.  They are not
3170   (at present) written to any object files.
3171
3172 ENUM
3173   BFD_RELOC_SH_PCDISP8BY2
3174 ENUMX
3175   BFD_RELOC_SH_PCDISP12BY2
3176 ENUMX
3177   BFD_RELOC_SH_IMM3
3178 ENUMX
3179   BFD_RELOC_SH_IMM3U
3180 ENUMX
3181   BFD_RELOC_SH_DISP12
3182 ENUMX
3183   BFD_RELOC_SH_DISP12BY2
3184 ENUMX
3185   BFD_RELOC_SH_DISP12BY4
3186 ENUMX
3187   BFD_RELOC_SH_DISP12BY8
3188 ENUMX
3189   BFD_RELOC_SH_DISP20
3190 ENUMX
3191   BFD_RELOC_SH_DISP20BY8
3192 ENUMX
3193   BFD_RELOC_SH_IMM4
3194 ENUMX
3195   BFD_RELOC_SH_IMM4BY2
3196 ENUMX
3197   BFD_RELOC_SH_IMM4BY4
3198 ENUMX
3199   BFD_RELOC_SH_IMM8
3200 ENUMX
3201   BFD_RELOC_SH_IMM8BY2
3202 ENUMX
3203   BFD_RELOC_SH_IMM8BY4
3204 ENUMX
3205   BFD_RELOC_SH_PCRELIMM8BY2
3206 ENUMX
3207   BFD_RELOC_SH_PCRELIMM8BY4
3208 ENUMX
3209   BFD_RELOC_SH_SWITCH16
3210 ENUMX
3211   BFD_RELOC_SH_SWITCH32
3212 ENUMX
3213   BFD_RELOC_SH_USES
3214 ENUMX
3215   BFD_RELOC_SH_COUNT
3216 ENUMX
3217   BFD_RELOC_SH_ALIGN
3218 ENUMX
3219   BFD_RELOC_SH_CODE
3220 ENUMX
3221   BFD_RELOC_SH_DATA
3222 ENUMX
3223   BFD_RELOC_SH_LABEL
3224 ENUMX
3225   BFD_RELOC_SH_LOOP_START
3226 ENUMX
3227   BFD_RELOC_SH_LOOP_END
3228 ENUMX
3229   BFD_RELOC_SH_COPY
3230 ENUMX
3231   BFD_RELOC_SH_GLOB_DAT
3232 ENUMX
3233   BFD_RELOC_SH_JMP_SLOT
3234 ENUMX
3235   BFD_RELOC_SH_RELATIVE
3236 ENUMX
3237   BFD_RELOC_SH_GOTPC
3238 ENUMX
3239   BFD_RELOC_SH_GOT_LOW16
3240 ENUMX
3241   BFD_RELOC_SH_GOT_MEDLOW16
3242 ENUMX
3243   BFD_RELOC_SH_GOT_MEDHI16
3244 ENUMX
3245   BFD_RELOC_SH_GOT_HI16
3246 ENUMX
3247   BFD_RELOC_SH_GOTPLT_LOW16
3248 ENUMX
3249   BFD_RELOC_SH_GOTPLT_MEDLOW16
3250 ENUMX
3251   BFD_RELOC_SH_GOTPLT_MEDHI16
3252 ENUMX
3253   BFD_RELOC_SH_GOTPLT_HI16
3254 ENUMX
3255   BFD_RELOC_SH_PLT_LOW16
3256 ENUMX
3257   BFD_RELOC_SH_PLT_MEDLOW16
3258 ENUMX
3259   BFD_RELOC_SH_PLT_MEDHI16
3260 ENUMX
3261   BFD_RELOC_SH_PLT_HI16
3262 ENUMX
3263   BFD_RELOC_SH_GOTOFF_LOW16
3264 ENUMX
3265   BFD_RELOC_SH_GOTOFF_MEDLOW16
3266 ENUMX
3267   BFD_RELOC_SH_GOTOFF_MEDHI16
3268 ENUMX
3269   BFD_RELOC_SH_GOTOFF_HI16
3270 ENUMX
3271   BFD_RELOC_SH_GOTPC_LOW16
3272 ENUMX
3273   BFD_RELOC_SH_GOTPC_MEDLOW16
3274 ENUMX
3275   BFD_RELOC_SH_GOTPC_MEDHI16
3276 ENUMX
3277   BFD_RELOC_SH_GOTPC_HI16
3278 ENUMX
3279   BFD_RELOC_SH_COPY64
3280 ENUMX
3281   BFD_RELOC_SH_GLOB_DAT64
3282 ENUMX
3283   BFD_RELOC_SH_JMP_SLOT64
3284 ENUMX
3285   BFD_RELOC_SH_RELATIVE64
3286 ENUMX
3287   BFD_RELOC_SH_GOT10BY4
3288 ENUMX
3289   BFD_RELOC_SH_GOT10BY8
3290 ENUMX
3291   BFD_RELOC_SH_GOTPLT10BY4
3292 ENUMX
3293   BFD_RELOC_SH_GOTPLT10BY8
3294 ENUMX
3295   BFD_RELOC_SH_GOTPLT32
3296 ENUMX
3297   BFD_RELOC_SH_SHMEDIA_CODE
3298 ENUMX
3299   BFD_RELOC_SH_IMMU5
3300 ENUMX
3301   BFD_RELOC_SH_IMMS6
3302 ENUMX
3303   BFD_RELOC_SH_IMMS6BY32
3304 ENUMX
3305   BFD_RELOC_SH_IMMU6
3306 ENUMX
3307   BFD_RELOC_SH_IMMS10
3308 ENUMX
3309   BFD_RELOC_SH_IMMS10BY2
3310 ENUMX
3311   BFD_RELOC_SH_IMMS10BY4
3312 ENUMX
3313   BFD_RELOC_SH_IMMS10BY8
3314 ENUMX
3315   BFD_RELOC_SH_IMMS16
3316 ENUMX
3317   BFD_RELOC_SH_IMMU16
3318 ENUMX
3319   BFD_RELOC_SH_IMM_LOW16
3320 ENUMX
3321   BFD_RELOC_SH_IMM_LOW16_PCREL
3322 ENUMX
3323   BFD_RELOC_SH_IMM_MEDLOW16
3324 ENUMX
3325   BFD_RELOC_SH_IMM_MEDLOW16_PCREL
3326 ENUMX
3327   BFD_RELOC_SH_IMM_MEDHI16
3328 ENUMX
3329   BFD_RELOC_SH_IMM_MEDHI16_PCREL
3330 ENUMX
3331   BFD_RELOC_SH_IMM_HI16
3332 ENUMX
3333   BFD_RELOC_SH_IMM_HI16_PCREL
3334 ENUMX
3335   BFD_RELOC_SH_PT_16
3336 ENUMX
3337   BFD_RELOC_SH_TLS_GD_32
3338 ENUMX
3339   BFD_RELOC_SH_TLS_LD_32
3340 ENUMX
3341   BFD_RELOC_SH_TLS_LDO_32
3342 ENUMX
3343   BFD_RELOC_SH_TLS_IE_32
3344 ENUMX
3345   BFD_RELOC_SH_TLS_LE_32
3346 ENUMX
3347   BFD_RELOC_SH_TLS_DTPMOD32
3348 ENUMX
3349   BFD_RELOC_SH_TLS_DTPOFF32
3350 ENUMX
3351   BFD_RELOC_SH_TLS_TPOFF32
3352 ENUMX
3353   BFD_RELOC_SH_GOT20
3354 ENUMX
3355   BFD_RELOC_SH_GOTOFF20
3356 ENUMX
3357   BFD_RELOC_SH_GOTFUNCDESC
3358 ENUMX
3359   BFD_RELOC_SH_GOTFUNCDESC20
3360 ENUMX
3361   BFD_RELOC_SH_GOTOFFFUNCDESC
3362 ENUMX
3363   BFD_RELOC_SH_GOTOFFFUNCDESC20
3364 ENUMX
3365   BFD_RELOC_SH_FUNCDESC
3366 ENUMDOC
3367   Renesas / SuperH SH relocs.  Not all of these appear in object files.
3368
3369 ENUM
3370   BFD_RELOC_ARC_B22_PCREL
3371 ENUMDOC
3372   ARC Cores relocs.
3373   ARC 22 bit pc-relative branch.  The lowest two bits must be zero and are
3374   not stored in the instruction.  The high 20 bits are installed in bits 26
3375   through 7 of the instruction.
3376 ENUM
3377   BFD_RELOC_ARC_B26
3378 ENUMDOC
3379   ARC 26 bit absolute branch.  The lowest two bits must be zero and are not
3380   stored in the instruction.  The high 24 bits are installed in bits 23
3381   through 0.
3382
3383 ENUM
3384   BFD_RELOC_BFIN_16_IMM
3385 ENUMDOC
3386   ADI Blackfin 16 bit immediate absolute reloc.
3387 ENUM
3388   BFD_RELOC_BFIN_16_HIGH
3389 ENUMDOC
3390   ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
3391 ENUM
3392   BFD_RELOC_BFIN_4_PCREL
3393 ENUMDOC
3394   ADI Blackfin 'a' part of LSETUP.
3395 ENUM
3396   BFD_RELOC_BFIN_5_PCREL
3397 ENUMDOC
3398   ADI Blackfin.
3399 ENUM
3400   BFD_RELOC_BFIN_16_LOW
3401 ENUMDOC
3402   ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
3403 ENUM
3404   BFD_RELOC_BFIN_10_PCREL
3405 ENUMDOC
3406   ADI Blackfin.
3407 ENUM
3408   BFD_RELOC_BFIN_11_PCREL
3409 ENUMDOC
3410   ADI Blackfin 'b' part of LSETUP.
3411 ENUM
3412   BFD_RELOC_BFIN_12_PCREL_JUMP
3413 ENUMDOC
3414   ADI Blackfin.
3415 ENUM
3416   BFD_RELOC_BFIN_12_PCREL_JUMP_S
3417 ENUMDOC
3418   ADI Blackfin Short jump, pcrel.
3419 ENUM
3420   BFD_RELOC_BFIN_24_PCREL_CALL_X
3421 ENUMDOC
3422   ADI Blackfin Call.x not implemented.
3423 ENUM
3424   BFD_RELOC_BFIN_24_PCREL_JUMP_L
3425 ENUMDOC
3426   ADI Blackfin Long Jump pcrel.
3427 ENUM
3428   BFD_RELOC_BFIN_GOT17M4
3429 ENUMX
3430   BFD_RELOC_BFIN_GOTHI
3431 ENUMX
3432   BFD_RELOC_BFIN_GOTLO
3433 ENUMX
3434   BFD_RELOC_BFIN_FUNCDESC
3435 ENUMX
3436   BFD_RELOC_BFIN_FUNCDESC_GOT17M4
3437 ENUMX
3438   BFD_RELOC_BFIN_FUNCDESC_GOTHI
3439 ENUMX
3440   BFD_RELOC_BFIN_FUNCDESC_GOTLO
3441 ENUMX
3442   BFD_RELOC_BFIN_FUNCDESC_VALUE
3443 ENUMX
3444   BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
3445 ENUMX
3446   BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
3447 ENUMX
3448   BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
3449 ENUMX
3450   BFD_RELOC_BFIN_GOTOFF17M4
3451 ENUMX
3452   BFD_RELOC_BFIN_GOTOFFHI
3453 ENUMX
3454   BFD_RELOC_BFIN_GOTOFFLO
3455 ENUMDOC
3456   ADI Blackfin FD-PIC relocations.
3457 ENUM
3458   BFD_RELOC_BFIN_GOT
3459 ENUMDOC
3460   ADI Blackfin GOT relocation.
3461 ENUM
3462   BFD_RELOC_BFIN_PLTPC
3463 ENUMDOC
3464   ADI Blackfin PLTPC relocation.
3465 ENUM
3466   BFD_ARELOC_BFIN_PUSH
3467 ENUMDOC
3468   ADI Blackfin arithmetic relocation.
3469 ENUM
3470   BFD_ARELOC_BFIN_CONST
3471 ENUMDOC
3472   ADI Blackfin arithmetic relocation.
3473 ENUM
3474   BFD_ARELOC_BFIN_ADD
3475 ENUMDOC
3476   ADI Blackfin arithmetic relocation.
3477 ENUM
3478   BFD_ARELOC_BFIN_SUB
3479 ENUMDOC
3480   ADI Blackfin arithmetic relocation.
3481 ENUM
3482   BFD_ARELOC_BFIN_MULT
3483 ENUMDOC
3484   ADI Blackfin arithmetic relocation.
3485 ENUM
3486   BFD_ARELOC_BFIN_DIV
3487 ENUMDOC
3488   ADI Blackfin arithmetic relocation.
3489 ENUM
3490   BFD_ARELOC_BFIN_MOD
3491 ENUMDOC
3492   ADI Blackfin arithmetic relocation.
3493 ENUM
3494   BFD_ARELOC_BFIN_LSHIFT
3495 ENUMDOC
3496   ADI Blackfin arithmetic relocation.
3497 ENUM
3498   BFD_ARELOC_BFIN_RSHIFT
3499 ENUMDOC
3500   ADI Blackfin arithmetic relocation.
3501 ENUM
3502   BFD_ARELOC_BFIN_AND
3503 ENUMDOC
3504   ADI Blackfin arithmetic relocation.
3505 ENUM
3506   BFD_ARELOC_BFIN_OR
3507 ENUMDOC
3508   ADI Blackfin arithmetic relocation.
3509 ENUM
3510   BFD_ARELOC_BFIN_XOR
3511 ENUMDOC
3512   ADI Blackfin arithmetic relocation.
3513 ENUM
3514   BFD_ARELOC_BFIN_LAND
3515 ENUMDOC
3516   ADI Blackfin arithmetic relocation.
3517 ENUM
3518   BFD_ARELOC_BFIN_LOR
3519 ENUMDOC
3520   ADI Blackfin arithmetic relocation.
3521 ENUM
3522   BFD_ARELOC_BFIN_LEN
3523 ENUMDOC
3524   ADI Blackfin arithmetic relocation.
3525 ENUM
3526   BFD_ARELOC_BFIN_NEG
3527 ENUMDOC
3528   ADI Blackfin arithmetic relocation.
3529 ENUM
3530   BFD_ARELOC_BFIN_COMP
3531 ENUMDOC
3532   ADI Blackfin arithmetic relocation.
3533 ENUM
3534   BFD_ARELOC_BFIN_PAGE
3535 ENUMDOC
3536   ADI Blackfin arithmetic relocation.
3537 ENUM
3538   BFD_ARELOC_BFIN_HWPAGE
3539 ENUMDOC
3540   ADI Blackfin arithmetic relocation.
3541 ENUM
3542   BFD_ARELOC_BFIN_ADDR
3543 ENUMDOC
3544   ADI Blackfin arithmetic relocation.
3545
3546 ENUM
3547   BFD_RELOC_D10V_10_PCREL_R
3548 ENUMDOC
3549   Mitsubishi D10V relocs.
3550   This is a 10-bit reloc with the right 2 bits
3551   assumed to be 0.
3552 ENUM
3553   BFD_RELOC_D10V_10_PCREL_L
3554 ENUMDOC
3555   Mitsubishi D10V relocs.
3556   This is a 10-bit reloc with the right 2 bits
3557   assumed to be 0.  This is the same as the previous reloc
3558   except it is in the left container, i.e.,
3559   shifted left 15 bits.
3560 ENUM
3561   BFD_RELOC_D10V_18
3562 ENUMDOC
3563   This is an 18-bit reloc with the right 2 bits
3564   assumed to be 0.
3565 ENUM
3566   BFD_RELOC_D10V_18_PCREL
3567 ENUMDOC
3568   This is an 18-bit reloc with the right 2 bits
3569   assumed to be 0.
3570
3571 ENUM
3572   BFD_RELOC_D30V_6
3573 ENUMDOC
3574   Mitsubishi D30V relocs.
3575   This is a 6-bit absolute reloc.
3576 ENUM
3577   BFD_RELOC_D30V_9_PCREL
3578 ENUMDOC
3579   This is a 6-bit pc-relative reloc with
3580   the right 3 bits assumed to be 0.
3581 ENUM
3582   BFD_RELOC_D30V_9_PCREL_R
3583 ENUMDOC
3584   This is a 6-bit pc-relative reloc with
3585   the right 3 bits assumed to be 0. Same
3586   as the previous reloc but on the right side
3587   of the container.
3588 ENUM
3589   BFD_RELOC_D30V_15
3590 ENUMDOC
3591   This is a 12-bit absolute reloc with the
3592   right 3 bitsassumed to be 0.
3593 ENUM
3594   BFD_RELOC_D30V_15_PCREL
3595 ENUMDOC
3596   This is a 12-bit pc-relative reloc with
3597   the right 3 bits assumed to be 0.
3598 ENUM
3599   BFD_RELOC_D30V_15_PCREL_R
3600 ENUMDOC
3601   This is a 12-bit pc-relative reloc with
3602   the right 3 bits assumed to be 0. Same
3603   as the previous reloc but on the right side
3604   of the container.
3605 ENUM
3606   BFD_RELOC_D30V_21
3607 ENUMDOC
3608   This is an 18-bit absolute reloc with
3609   the right 3 bits assumed to be 0.
3610 ENUM
3611   BFD_RELOC_D30V_21_PCREL
3612 ENUMDOC
3613   This is an 18-bit pc-relative reloc with
3614   the right 3 bits assumed to be 0.
3615 ENUM
3616   BFD_RELOC_D30V_21_PCREL_R
3617 ENUMDOC
3618   This is an 18-bit pc-relative reloc with
3619   the right 3 bits assumed to be 0. Same
3620   as the previous reloc but on the right side
3621   of the container.
3622 ENUM
3623   BFD_RELOC_D30V_32
3624 ENUMDOC
3625   This is a 32-bit absolute reloc.
3626 ENUM
3627   BFD_RELOC_D30V_32_PCREL
3628 ENUMDOC
3629   This is a 32-bit pc-relative reloc.
3630
3631 ENUM
3632   BFD_RELOC_DLX_HI16_S
3633 ENUMDOC
3634   DLX relocs
3635 ENUM
3636   BFD_RELOC_DLX_LO16
3637 ENUMDOC
3638   DLX relocs
3639 ENUM
3640   BFD_RELOC_DLX_JMP26
3641 ENUMDOC
3642   DLX relocs
3643
3644 ENUM
3645   BFD_RELOC_M32C_HI8
3646 ENUMX
3647   BFD_RELOC_M32C_RL_JUMP
3648 ENUMX
3649   BFD_RELOC_M32C_RL_1ADDR
3650 ENUMX
3651   BFD_RELOC_M32C_RL_2ADDR
3652 ENUMDOC
3653   Renesas M16C/M32C Relocations.
3654
3655 ENUM
3656   BFD_RELOC_M32R_24
3657 ENUMDOC
3658   Renesas M32R (formerly Mitsubishi M32R) relocs.
3659   This is a 24 bit absolute address.
3660 ENUM
3661   BFD_RELOC_M32R_10_PCREL
3662 ENUMDOC
3663   This is a 10-bit pc-relative reloc with the right 2 bits assumed to be 0.
3664 ENUM
3665   BFD_RELOC_M32R_18_PCREL
3666 ENUMDOC
3667   This is an 18-bit reloc with the right 2 bits assumed to be 0.
3668 ENUM
3669   BFD_RELOC_M32R_26_PCREL
3670 ENUMDOC
3671   This is a 26-bit reloc with the right 2 bits assumed to be 0.
3672 ENUM
3673   BFD_RELOC_M32R_HI16_ULO
3674 ENUMDOC
3675   This is a 16-bit reloc containing the high 16 bits of an address
3676   used when the lower 16 bits are treated as unsigned.
3677 ENUM
3678   BFD_RELOC_M32R_HI16_SLO
3679 ENUMDOC
3680   This is a 16-bit reloc containing the high 16 bits of an address
3681   used when the lower 16 bits are treated as signed.
3682 ENUM
3683   BFD_RELOC_M32R_LO16
3684 ENUMDOC
3685   This is a 16-bit reloc containing the lower 16 bits of an address.
3686 ENUM
3687   BFD_RELOC_M32R_SDA16
3688 ENUMDOC
3689   This is a 16-bit reloc containing the small data area offset for use in
3690   add3, load, and store instructions.
3691 ENUM
3692   BFD_RELOC_M32R_GOT24
3693 ENUMX
3694   BFD_RELOC_M32R_26_PLTREL
3695 ENUMX
3696   BFD_RELOC_M32R_COPY
3697 ENUMX
3698   BFD_RELOC_M32R_GLOB_DAT
3699 ENUMX
3700   BFD_RELOC_M32R_JMP_SLOT
3701 ENUMX
3702   BFD_RELOC_M32R_RELATIVE
3703 ENUMX
3704   BFD_RELOC_M32R_GOTOFF
3705 ENUMX
3706   BFD_RELOC_M32R_GOTOFF_HI_ULO
3707 ENUMX
3708   BFD_RELOC_M32R_GOTOFF_HI_SLO
3709 ENUMX
3710   BFD_RELOC_M32R_GOTOFF_LO
3711 ENUMX
3712   BFD_RELOC_M32R_GOTPC24
3713 ENUMX
3714   BFD_RELOC_M32R_GOT16_HI_ULO
3715 ENUMX
3716   BFD_RELOC_M32R_GOT16_HI_SLO
3717 ENUMX
3718   BFD_RELOC_M32R_GOT16_LO
3719 ENUMX
3720   BFD_RELOC_M32R_GOTPC_HI_ULO
3721 ENUMX
3722   BFD_RELOC_M32R_GOTPC_HI_SLO
3723 ENUMX
3724   BFD_RELOC_M32R_GOTPC_LO
3725 ENUMDOC
3726   For PIC.
3727
3728
3729 ENUM
3730   BFD_RELOC_V850_9_PCREL
3731 ENUMDOC
3732   This is a 9-bit reloc
3733 ENUM
3734   BFD_RELOC_V850_22_PCREL
3735 ENUMDOC
3736   This is a 22-bit reloc
3737
3738 ENUM
3739   BFD_RELOC_V850_SDA_16_16_OFFSET
3740 ENUMDOC
3741   This is a 16 bit offset from the short data area pointer.
3742 ENUM
3743   BFD_RELOC_V850_SDA_15_16_OFFSET
3744 ENUMDOC
3745   This is a 16 bit offset (of which only 15 bits are used) from the
3746   short data area pointer.
3747 ENUM
3748   BFD_RELOC_V850_ZDA_16_16_OFFSET
3749 ENUMDOC
3750   This is a 16 bit offset from the zero data area pointer.
3751 ENUM
3752   BFD_RELOC_V850_ZDA_15_16_OFFSET
3753 ENUMDOC
3754   This is a 16 bit offset (of which only 15 bits are used) from the
3755   zero data area pointer.
3756 ENUM
3757   BFD_RELOC_V850_TDA_6_8_OFFSET
3758 ENUMDOC
3759   This is an 8 bit offset (of which only 6 bits are used) from the
3760   tiny data area pointer.
3761 ENUM
3762   BFD_RELOC_V850_TDA_7_8_OFFSET
3763 ENUMDOC
3764   This is an 8bit offset (of which only 7 bits are used) from the tiny
3765   data area pointer.
3766 ENUM
3767   BFD_RELOC_V850_TDA_7_7_OFFSET
3768 ENUMDOC
3769   This is a 7 bit offset from the tiny data area pointer.
3770 ENUM
3771   BFD_RELOC_V850_TDA_16_16_OFFSET
3772 ENUMDOC
3773   This is a 16 bit offset from the tiny data area pointer.
3774 COMMENT
3775 ENUM
3776   BFD_RELOC_V850_TDA_4_5_OFFSET
3777 ENUMDOC
3778   This is a 5 bit offset (of which only 4 bits are used) from the tiny
3779   data area pointer.
3780 ENUM
3781   BFD_RELOC_V850_TDA_4_4_OFFSET
3782 ENUMDOC
3783   This is a 4 bit offset from the tiny data area pointer.
3784 ENUM
3785   BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
3786 ENUMDOC
3787   This is a 16 bit offset from the short data area pointer, with the
3788   bits placed non-contiguously in the instruction.
3789 ENUM
3790   BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
3791 ENUMDOC
3792   This is a 16 bit offset from the zero data area pointer, with the
3793   bits placed non-contiguously in the instruction.
3794 ENUM
3795   BFD_RELOC_V850_CALLT_6_7_OFFSET
3796 ENUMDOC
3797   This is a 6 bit offset from the call table base pointer.
3798 ENUM
3799   BFD_RELOC_V850_CALLT_16_16_OFFSET
3800 ENUMDOC
3801   This is a 16 bit offset from the call table base pointer.
3802 ENUM
3803   BFD_RELOC_V850_LONGCALL
3804 ENUMDOC
3805   Used for relaxing indirect function calls.
3806 ENUM
3807   BFD_RELOC_V850_LONGJUMP
3808 ENUMDOC
3809   Used for relaxing indirect jumps.
3810 ENUM
3811   BFD_RELOC_V850_ALIGN
3812 ENUMDOC
3813   Used to maintain alignment whilst relaxing.
3814 ENUM
3815   BFD_RELOC_V850_LO16_SPLIT_OFFSET
3816 ENUMDOC
3817   This is a variation of BFD_RELOC_LO16 that can be used in v850e ld.bu
3818   instructions.
3819 ENUM
3820   BFD_RELOC_V850_16_PCREL
3821 ENUMDOC
3822   This is a 16-bit reloc.
3823 ENUM     
3824   BFD_RELOC_V850_17_PCREL
3825 ENUMDOC
3826   This is a 17-bit reloc.
3827 ENUM     
3828   BFD_RELOC_V850_23
3829 ENUMDOC
3830   This is a 23-bit reloc.
3831 ENUM     
3832   BFD_RELOC_V850_32_PCREL
3833 ENUMDOC
3834   This is a 32-bit reloc.
3835 ENUM     
3836   BFD_RELOC_V850_32_ABS
3837 ENUMDOC
3838   This is a 32-bit reloc.
3839 ENUM     
3840   BFD_RELOC_V850_16_SPLIT_OFFSET
3841 ENUMDOC
3842   This is a 16-bit reloc.
3843 ENUM     
3844   BFD_RELOC_V850_16_S1
3845 ENUMDOC
3846   This is a 16-bit reloc.
3847 ENUM     
3848   BFD_RELOC_V850_LO16_S1
3849 ENUMDOC
3850   Low 16 bits. 16 bit shifted by 1.
3851 ENUM     
3852   BFD_RELOC_V850_CALLT_15_16_OFFSET
3853 ENUMDOC
3854   This is a 16 bit offset from the call table base pointer.
3855 ENUM     
3856   BFD_RELOC_V850_32_GOTPCREL
3857 ENUMDOC
3858   DSO relocations.
3859 ENUM     
3860   BFD_RELOC_V850_16_GOT
3861 ENUMDOC
3862   DSO relocations.
3863 ENUM     
3864   BFD_RELOC_V850_32_GOT
3865 ENUMDOC
3866   DSO relocations.
3867 ENUM     
3868   BFD_RELOC_V850_22_PLT_PCREL
3869 ENUMDOC
3870   DSO relocations.
3871 ENUM     
3872   BFD_RELOC_V850_32_PLT_PCREL
3873 ENUMDOC
3874   DSO relocations.
3875 ENUM     
3876   BFD_RELOC_V850_COPY
3877 ENUMDOC
3878   DSO relocations.
3879 ENUM     
3880   BFD_RELOC_V850_GLOB_DAT
3881 ENUMDOC
3882   DSO relocations.
3883 ENUM     
3884   BFD_RELOC_V850_JMP_SLOT
3885 ENUMDOC
3886   DSO relocations.
3887 ENUM     
3888   BFD_RELOC_V850_RELATIVE
3889 ENUMDOC
3890   DSO relocations.
3891 ENUM     
3892   BFD_RELOC_V850_16_GOTOFF
3893 ENUMDOC
3894   DSO relocations.
3895 ENUM     
3896   BFD_RELOC_V850_32_GOTOFF
3897 ENUMDOC
3898   DSO relocations.
3899 ENUM     
3900   BFD_RELOC_V850_CODE
3901 ENUMDOC
3902   start code.
3903 ENUM     
3904   BFD_RELOC_V850_DATA
3905 ENUMDOC
3906   start data in text.
3907 ENUM
3908   BFD_RELOC_MN10300_32_PCREL
3909 ENUMDOC
3910   This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the
3911   instruction.
3912 ENUM
3913   BFD_RELOC_MN10300_16_PCREL
3914 ENUMDOC
3915   This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the
3916   instruction.
3917
3918 ENUM
3919   BFD_RELOC_TIC30_LDP
3920 ENUMDOC
3921   This is a 8bit DP reloc for the tms320c30, where the most
3922   significant 8 bits of a 24 bit word are placed into the least
3923   significant 8 bits of the opcode.
3924
3925 ENUM
3926   BFD_RELOC_TIC54X_PARTLS7
3927 ENUMDOC
3928   This is a 7bit reloc for the tms320c54x, where the least
3929   significant 7 bits of a 16 bit word are placed into the least
3930   significant 7 bits of the opcode.
3931
3932 ENUM
3933   BFD_RELOC_TIC54X_PARTMS9
3934 ENUMDOC
3935   This is a 9bit DP reloc for the tms320c54x, where the most
3936   significant 9 bits of a 16 bit word are placed into the least
3937   significant 9 bits of the opcode.
3938
3939 ENUM
3940   BFD_RELOC_TIC54X_23
3941 ENUMDOC
3942   This is an extended address 23-bit reloc for the tms320c54x.
3943
3944 ENUM
3945   BFD_RELOC_TIC54X_16_OF_23
3946 ENUMDOC
3947   This is a 16-bit reloc for the tms320c54x, where the least
3948   significant 16 bits of a 23-bit extended address are placed into
3949   the opcode.
3950
3951 ENUM
3952   BFD_RELOC_TIC54X_MS7_OF_23
3953 ENUMDOC
3954   This is a reloc for the tms320c54x, where the most
3955   significant 7 bits of a 23-bit extended address are placed into
3956   the opcode.
3957
3958 ENUM
3959   BFD_RELOC_C6000_PCR_S21
3960 ENUMX
3961   BFD_RELOC_C6000_PCR_S12
3962 ENUMX
3963   BFD_RELOC_C6000_PCR_S10
3964 ENUMX
3965   BFD_RELOC_C6000_PCR_S7
3966 ENUMX
3967   BFD_RELOC_C6000_ABS_S16
3968 ENUMX
3969   BFD_RELOC_C6000_ABS_L16
3970 ENUMX
3971   BFD_RELOC_C6000_ABS_H16
3972 ENUMX
3973   BFD_RELOC_C6000_SBR_U15_B
3974 ENUMX
3975   BFD_RELOC_C6000_SBR_U15_H
3976 ENUMX
3977   BFD_RELOC_C6000_SBR_U15_W
3978 ENUMX
3979   BFD_RELOC_C6000_SBR_S16
3980 ENUMX
3981   BFD_RELOC_C6000_SBR_L16_B
3982 ENUMX
3983   BFD_RELOC_C6000_SBR_L16_H
3984 ENUMX
3985   BFD_RELOC_C6000_SBR_L16_W
3986 ENUMX
3987   BFD_RELOC_C6000_SBR_H16_B
3988 ENUMX
3989   BFD_RELOC_C6000_SBR_H16_H
3990 ENUMX
3991   BFD_RELOC_C6000_SBR_H16_W
3992 ENUMX
3993   BFD_RELOC_C6000_SBR_GOT_U15_W
3994 ENUMX
3995   BFD_RELOC_C6000_SBR_GOT_L16_W
3996 ENUMX
3997   BFD_RELOC_C6000_SBR_GOT_H16_W
3998 ENUMX
3999   BFD_RELOC_C6000_DSBT_INDEX
4000 ENUMX
4001   BFD_RELOC_C6000_PREL31
4002 ENUMX
4003   BFD_RELOC_C6000_COPY
4004 ENUMX
4005   BFD_RELOC_C6000_JUMP_SLOT
4006 ENUMX
4007   BFD_RELOC_C6000_EHTYPE
4008 ENUMX
4009   BFD_RELOC_C6000_PCR_H16
4010 ENUMX
4011   BFD_RELOC_C6000_PCR_L16
4012 ENUMX
4013   BFD_RELOC_C6000_ALIGN
4014 ENUMX
4015   BFD_RELOC_C6000_FPHEAD
4016 ENUMX
4017   BFD_RELOC_C6000_NOCMP
4018 ENUMDOC
4019   TMS320C6000 relocations.
4020
4021 ENUM
4022   BFD_RELOC_FR30_48
4023 ENUMDOC
4024   This is a 48 bit reloc for the FR30 that stores 32 bits.
4025 ENUM
4026   BFD_RELOC_FR30_20
4027 ENUMDOC
4028   This is a 32 bit reloc for the FR30 that stores 20 bits split up into
4029   two sections.
4030 ENUM
4031   BFD_RELOC_FR30_6_IN_4
4032 ENUMDOC
4033   This is a 16 bit reloc for the FR30 that stores a 6 bit word offset in
4034   4 bits.
4035 ENUM
4036   BFD_RELOC_FR30_8_IN_8
4037 ENUMDOC
4038   This is a 16 bit reloc for the FR30 that stores an 8 bit byte offset
4039   into 8 bits.
4040 ENUM
4041   BFD_RELOC_FR30_9_IN_8
4042 ENUMDOC
4043   This is a 16 bit reloc for the FR30 that stores a 9 bit short offset
4044   into 8 bits.
4045 ENUM
4046   BFD_RELOC_FR30_10_IN_8
4047 ENUMDOC
4048   This is a 16 bit reloc for the FR30 that stores a 10 bit word offset
4049   into 8 bits.
4050 ENUM
4051   BFD_RELOC_FR30_9_PCREL
4052 ENUMDOC
4053   This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
4054   short offset into 8 bits.
4055 ENUM
4056   BFD_RELOC_FR30_12_PCREL
4057 ENUMDOC
4058   This is a 16 bit reloc for the FR30 that stores a 12 bit pc relative
4059   short offset into 11 bits.
4060
4061 ENUM
4062   BFD_RELOC_MCORE_PCREL_IMM8BY4
4063 ENUMX
4064   BFD_RELOC_MCORE_PCREL_IMM11BY2
4065 ENUMX
4066   BFD_RELOC_MCORE_PCREL_IMM4BY2
4067 ENUMX
4068   BFD_RELOC_MCORE_PCREL_32
4069 ENUMX
4070   BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
4071 ENUMX
4072   BFD_RELOC_MCORE_RVA
4073 ENUMDOC
4074   Motorola Mcore relocations.
4075
4076 ENUM
4077   BFD_RELOC_MEP_8
4078 ENUMX
4079   BFD_RELOC_MEP_16
4080 ENUMX
4081   BFD_RELOC_MEP_32
4082 ENUMX
4083   BFD_RELOC_MEP_PCREL8A2
4084 ENUMX
4085   BFD_RELOC_MEP_PCREL12A2
4086 ENUMX
4087   BFD_RELOC_MEP_PCREL17A2
4088 ENUMX
4089   BFD_RELOC_MEP_PCREL24A2
4090 ENUMX
4091   BFD_RELOC_MEP_PCABS24A2
4092 ENUMX
4093   BFD_RELOC_MEP_LOW16
4094 ENUMX
4095   BFD_RELOC_MEP_HI16U
4096 ENUMX
4097   BFD_RELOC_MEP_HI16S
4098 ENUMX
4099   BFD_RELOC_MEP_GPREL
4100 ENUMX
4101   BFD_RELOC_MEP_TPREL
4102 ENUMX
4103   BFD_RELOC_MEP_TPREL7
4104 ENUMX
4105   BFD_RELOC_MEP_TPREL7A2
4106 ENUMX
4107   BFD_RELOC_MEP_TPREL7A4
4108 ENUMX
4109   BFD_RELOC_MEP_UIMM24
4110 ENUMX
4111   BFD_RELOC_MEP_ADDR24A4
4112 ENUMX
4113   BFD_RELOC_MEP_GNU_VTINHERIT
4114 ENUMX
4115   BFD_RELOC_MEP_GNU_VTENTRY
4116 ENUMDOC
4117   Toshiba Media Processor Relocations.
4118 COMMENT
4119
4120 ENUM
4121   BFD_RELOC_MMIX_GETA
4122 ENUMX
4123   BFD_RELOC_MMIX_GETA_1
4124 ENUMX
4125   BFD_RELOC_MMIX_GETA_2
4126 ENUMX
4127   BFD_RELOC_MMIX_GETA_3
4128 ENUMDOC
4129   These are relocations for the GETA instruction.
4130 ENUM
4131   BFD_RELOC_MMIX_CBRANCH
4132 ENUMX
4133   BFD_RELOC_MMIX_CBRANCH_J
4134 ENUMX
4135   BFD_RELOC_MMIX_CBRANCH_1
4136 ENUMX
4137   BFD_RELOC_MMIX_CBRANCH_2
4138 ENUMX
4139   BFD_RELOC_MMIX_CBRANCH_3
4140 ENUMDOC
4141   These are relocations for a conditional branch instruction.
4142 ENUM
4143   BFD_RELOC_MMIX_PUSHJ
4144 ENUMX
4145   BFD_RELOC_MMIX_PUSHJ_1
4146 ENUMX
4147   BFD_RELOC_MMIX_PUSHJ_2
4148 ENUMX
4149   BFD_RELOC_MMIX_PUSHJ_3
4150 ENUMX
4151   BFD_RELOC_MMIX_PUSHJ_STUBBABLE
4152 ENUMDOC
4153   These are relocations for the PUSHJ instruction.
4154 ENUM
4155   BFD_RELOC_MMIX_JMP
4156 ENUMX
4157   BFD_RELOC_MMIX_JMP_1
4158 ENUMX
4159   BFD_RELOC_MMIX_JMP_2
4160 ENUMX
4161   BFD_RELOC_MMIX_JMP_3
4162 ENUMDOC
4163   These are relocations for the JMP instruction.
4164 ENUM
4165   BFD_RELOC_MMIX_ADDR19
4166 ENUMDOC
4167   This is a relocation for a relative address as in a GETA instruction or
4168   a branch.
4169 ENUM
4170   BFD_RELOC_MMIX_ADDR27
4171 ENUMDOC
4172   This is a relocation for a relative address as in a JMP instruction.
4173 ENUM
4174   BFD_RELOC_MMIX_REG_OR_BYTE
4175 ENUMDOC
4176   This is a relocation for an instruction field that may be a general
4177   register or a value 0..255.
4178 ENUM
4179   BFD_RELOC_MMIX_REG
4180 ENUMDOC
4181   This is a relocation for an instruction field that may be a general
4182   register.
4183 ENUM
4184   BFD_RELOC_MMIX_BASE_PLUS_OFFSET
4185 ENUMDOC
4186   This is a relocation for two instruction fields holding a register and
4187   an offset, the equivalent of the relocation.
4188 ENUM
4189   BFD_RELOC_MMIX_LOCAL
4190 ENUMDOC
4191   This relocation is an assertion that the expression is not allocated as
4192   a global register.  It does not modify contents.
4193
4194 ENUM
4195   BFD_RELOC_AVR_7_PCREL
4196 ENUMDOC
4197   This is a 16 bit reloc for the AVR that stores 8 bit pc relative
4198   short offset into 7 bits.
4199 ENUM
4200   BFD_RELOC_AVR_13_PCREL
4201 ENUMDOC
4202   This is a 16 bit reloc for the AVR that stores 13 bit pc relative
4203   short offset into 12 bits.
4204 ENUM
4205   BFD_RELOC_AVR_16_PM
4206 ENUMDOC
4207   This is a 16 bit reloc for the AVR that stores 17 bit value (usually
4208   program memory address) into 16 bits.
4209 ENUM
4210   BFD_RELOC_AVR_LO8_LDI
4211 ENUMDOC
4212   This is a 16 bit reloc for the AVR that stores 8 bit value (usually
4213   data memory address) into 8 bit immediate value of LDI insn.
4214 ENUM
4215   BFD_RELOC_AVR_HI8_LDI
4216 ENUMDOC
4217   This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
4218   of data memory address) into 8 bit immediate value of LDI insn.
4219 ENUM
4220   BFD_RELOC_AVR_HH8_LDI
4221 ENUMDOC
4222   This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
4223   of program memory address) into 8 bit immediate value of LDI insn.
4224 ENUM
4225   BFD_RELOC_AVR_MS8_LDI
4226 ENUMDOC
4227   This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
4228   of 32 bit value) into 8 bit immediate value of LDI insn.
4229 ENUM
4230   BFD_RELOC_AVR_LO8_LDI_NEG
4231 ENUMDOC
4232   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4233   (usually data memory address) into 8 bit immediate value of SUBI insn.
4234 ENUM
4235   BFD_RELOC_AVR_HI8_LDI_NEG
4236 ENUMDOC
4237   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4238   (high 8 bit of data memory address) into 8 bit immediate value of
4239   SUBI insn.
4240 ENUM
4241   BFD_RELOC_AVR_HH8_LDI_NEG
4242 ENUMDOC
4243   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4244   (most high 8 bit of program memory address) into 8 bit immediate value
4245   of LDI or SUBI insn.
4246 ENUM
4247   BFD_RELOC_AVR_MS8_LDI_NEG
4248 ENUMDOC
4249   This is a 16 bit reloc for the AVR that stores negated 8 bit value (msb
4250   of 32 bit value) into 8 bit immediate value of LDI insn.
4251 ENUM
4252   BFD_RELOC_AVR_LO8_LDI_PM
4253 ENUMDOC
4254   This is a 16 bit reloc for the AVR that stores 8 bit value (usually
4255   command address) into 8 bit immediate value of LDI insn.
4256 ENUM
4257   BFD_RELOC_AVR_LO8_LDI_GS
4258 ENUMDOC
4259   This is a 16 bit reloc for the AVR that stores 8 bit value 
4260   (command address) into 8 bit immediate value of LDI insn. If the address
4261   is beyond the 128k boundary, the linker inserts a jump stub for this reloc
4262   in the lower 128k.
4263 ENUM
4264   BFD_RELOC_AVR_HI8_LDI_PM
4265 ENUMDOC
4266   This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
4267   of command address) into 8 bit immediate value of LDI insn.
4268 ENUM
4269   BFD_RELOC_AVR_HI8_LDI_GS
4270 ENUMDOC
4271   This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
4272   of command address) into 8 bit immediate value of LDI insn.  If the address
4273   is beyond the 128k boundary, the linker inserts a jump stub for this reloc
4274   below 128k.
4275 ENUM
4276   BFD_RELOC_AVR_HH8_LDI_PM
4277 ENUMDOC
4278   This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
4279   of command address) into 8 bit immediate value of LDI insn.
4280 ENUM
4281   BFD_RELOC_AVR_LO8_LDI_PM_NEG
4282 ENUMDOC
4283   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4284   (usually command address) into 8 bit immediate value of SUBI insn.
4285 ENUM
4286   BFD_RELOC_AVR_HI8_LDI_PM_NEG
4287 ENUMDOC
4288   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4289   (high 8 bit of 16 bit command address) into 8 bit immediate value
4290   of SUBI insn.
4291 ENUM
4292   BFD_RELOC_AVR_HH8_LDI_PM_NEG
4293 ENUMDOC
4294   This is a 16 bit reloc for the AVR that stores negated 8 bit value
4295   (high 6 bit of 22 bit command address) into 8 bit immediate
4296   value of SUBI insn.
4297 ENUM
4298   BFD_RELOC_AVR_CALL
4299 ENUMDOC
4300   This is a 32 bit reloc for the AVR that stores 23 bit value
4301   into 22 bits.
4302 ENUM
4303   BFD_RELOC_AVR_LDI
4304 ENUMDOC
4305   This is a 16 bit reloc for the AVR that stores all needed bits
4306   for absolute addressing with ldi with overflow check to linktime
4307 ENUM
4308   BFD_RELOC_AVR_6
4309 ENUMDOC
4310   This is a 6 bit reloc for the AVR that stores offset for ldd/std
4311   instructions
4312 ENUM
4313   BFD_RELOC_AVR_6_ADIW
4314 ENUMDOC
4315   This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
4316   instructions
4317
4318 ENUM
4319   BFD_RELOC_RX_NEG8
4320 ENUMX
4321   BFD_RELOC_RX_NEG16
4322 ENUMX
4323   BFD_RELOC_RX_NEG24
4324 ENUMX
4325   BFD_RELOC_RX_NEG32
4326 ENUMX
4327   BFD_RELOC_RX_16_OP
4328 ENUMX
4329   BFD_RELOC_RX_24_OP
4330 ENUMX
4331   BFD_RELOC_RX_32_OP
4332 ENUMX
4333   BFD_RELOC_RX_8U
4334 ENUMX
4335   BFD_RELOC_RX_16U
4336 ENUMX
4337   BFD_RELOC_RX_24U
4338 ENUMX
4339   BFD_RELOC_RX_DIR3U_PCREL
4340 ENUMX
4341   BFD_RELOC_RX_DIFF
4342 ENUMX
4343   BFD_RELOC_RX_GPRELB
4344 ENUMX
4345   BFD_RELOC_RX_GPRELW
4346 ENUMX
4347   BFD_RELOC_RX_GPRELL
4348 ENUMX
4349   BFD_RELOC_RX_SYM
4350 ENUMX
4351   BFD_RELOC_RX_OP_SUBTRACT
4352 ENUMX
4353   BFD_RELOC_RX_OP_NEG
4354 ENUMX
4355   BFD_RELOC_RX_ABS8
4356 ENUMX
4357   BFD_RELOC_RX_ABS16
4358 ENUMX
4359   BFD_RELOC_RX_ABS16_REV
4360 ENUMX
4361   BFD_RELOC_RX_ABS32
4362 ENUMX
4363   BFD_RELOC_RX_ABS32_REV
4364 ENUMX
4365   BFD_RELOC_RX_ABS16U
4366 ENUMX
4367   BFD_RELOC_RX_ABS16UW
4368 ENUMX
4369   BFD_RELOC_RX_ABS16UL
4370 ENUMX
4371   BFD_RELOC_RX_RELAX
4372 ENUMDOC
4373   Renesas RX Relocations.
4374
4375 ENUM
4376   BFD_RELOC_390_12
4377 ENUMDOC
4378    Direct 12 bit.
4379 ENUM
4380   BFD_RELOC_390_GOT12
4381 ENUMDOC
4382   12 bit GOT offset.
4383 ENUM
4384   BFD_RELOC_390_PLT32
4385 ENUMDOC
4386   32 bit PC relative PLT address.
4387 ENUM
4388   BFD_RELOC_390_COPY
4389 ENUMDOC
4390   Copy symbol at runtime.
4391 ENUM
4392   BFD_RELOC_390_GLOB_DAT
4393 ENUMDOC
4394   Create GOT entry.
4395 ENUM
4396   BFD_RELOC_390_JMP_SLOT
4397 ENUMDOC
4398   Create PLT entry.
4399 ENUM
4400   BFD_RELOC_390_RELATIVE
4401 ENUMDOC
4402   Adjust by program base.
4403 ENUM
4404   BFD_RELOC_390_GOTPC
4405 ENUMDOC
4406   32 bit PC relative offset to GOT.
4407 ENUM
4408   BFD_RELOC_390_GOT16
4409 ENUMDOC
4410   16 bit GOT offset.
4411 ENUM
4412   BFD_RELOC_390_PC16DBL
4413 ENUMDOC
4414   PC relative 16 bit shifted by 1.
4415 ENUM
4416   BFD_RELOC_390_PLT16DBL
4417 ENUMDOC
4418   16 bit PC rel. PLT shifted by 1.
4419 ENUM
4420   BFD_RELOC_390_PC32DBL
4421 ENUMDOC
4422   PC relative 32 bit shifted by 1.
4423 ENUM
4424   BFD_RELOC_390_PLT32DBL
4425 ENUMDOC
4426   32 bit PC rel. PLT shifted by 1.
4427 ENUM
4428   BFD_RELOC_390_GOTPCDBL
4429 ENUMDOC
4430   32 bit PC rel. GOT shifted by 1.
4431 ENUM
4432   BFD_RELOC_390_GOT64
4433 ENUMDOC
4434   64 bit GOT offset.
4435 ENUM
4436   BFD_RELOC_390_PLT64
4437 ENUMDOC
4438   64 bit PC relative PLT address.
4439 ENUM
4440   BFD_RELOC_390_GOTENT
4441 ENUMDOC
4442   32 bit rel. offset to GOT entry.
4443 ENUM
4444   BFD_RELOC_390_GOTOFF64
4445 ENUMDOC
4446   64 bit offset to GOT.
4447 ENUM
4448   BFD_RELOC_390_GOTPLT12
4449 ENUMDOC
4450   12-bit offset to symbol-entry within GOT, with PLT handling.
4451 ENUM
4452   BFD_RELOC_390_GOTPLT16
4453 ENUMDOC
4454   16-bit offset to symbol-entry within GOT, with PLT handling.
4455 ENUM
4456   BFD_RELOC_390_GOTPLT32
4457 ENUMDOC
4458   32-bit offset to symbol-entry within GOT, with PLT handling.
4459 ENUM
4460   BFD_RELOC_390_GOTPLT64
4461 ENUMDOC
4462   64-bit offset to symbol-entry within GOT, with PLT handling.
4463 ENUM
4464   BFD_RELOC_390_GOTPLTENT
4465 ENUMDOC
4466   32-bit rel. offset to symbol-entry within GOT, with PLT handling.
4467 ENUM
4468   BFD_RELOC_390_PLTOFF16
4469 ENUMDOC
4470   16-bit rel. offset from the GOT to a PLT entry.
4471 ENUM
4472   BFD_RELOC_390_PLTOFF32
4473 ENUMDOC
4474   32-bit rel. offset from the GOT to a PLT entry.
4475 ENUM
4476   BFD_RELOC_390_PLTOFF64
4477 ENUMDOC
4478   64-bit rel. offset from the GOT to a PLT entry.
4479
4480 ENUM
4481   BFD_RELOC_390_TLS_LOAD
4482 ENUMX
4483   BFD_RELOC_390_TLS_GDCALL
4484 ENUMX
4485   BFD_RELOC_390_TLS_LDCALL
4486 ENUMX
4487   BFD_RELOC_390_TLS_GD32
4488 ENUMX
4489   BFD_RELOC_390_TLS_GD64
4490 ENUMX
4491   BFD_RELOC_390_TLS_GOTIE12
4492 ENUMX
4493   BFD_RELOC_390_TLS_GOTIE32
4494 ENUMX
4495   BFD_RELOC_390_TLS_GOTIE64
4496 ENUMX
4497   BFD_RELOC_390_TLS_LDM32
4498 ENUMX
4499   BFD_RELOC_390_TLS_LDM64
4500 ENUMX
4501   BFD_RELOC_390_TLS_IE32
4502 ENUMX
4503   BFD_RELOC_390_TLS_IE64
4504 ENUMX
4505   BFD_RELOC_390_TLS_IEENT
4506 ENUMX
4507   BFD_RELOC_390_TLS_LE32
4508 ENUMX
4509   BFD_RELOC_390_TLS_LE64
4510 ENUMX
4511   BFD_RELOC_390_TLS_LDO32
4512 ENUMX
4513   BFD_RELOC_390_TLS_LDO64
4514 ENUMX
4515   BFD_RELOC_390_TLS_DTPMOD
4516 ENUMX
4517   BFD_RELOC_390_TLS_DTPOFF
4518 ENUMX
4519   BFD_RELOC_390_TLS_TPOFF
4520 ENUMDOC
4521   s390 tls relocations.
4522
4523 ENUM
4524   BFD_RELOC_390_20
4525 ENUMX
4526   BFD_RELOC_390_GOT20
4527 ENUMX
4528   BFD_RELOC_390_GOTPLT20
4529 ENUMX
4530   BFD_RELOC_390_TLS_GOTIE20
4531 ENUMDOC
4532   Long displacement extension.
4533
4534 ENUM
4535   BFD_RELOC_SCORE_GPREL15
4536 ENUMDOC
4537   Score relocations
4538   Low 16 bit for load/store  
4539 ENUM
4540   BFD_RELOC_SCORE_DUMMY2
4541 ENUMX
4542   BFD_RELOC_SCORE_JMP
4543 ENUMDOC
4544   This is a 24-bit reloc with the right 1 bit assumed to be 0
4545 ENUM
4546   BFD_RELOC_SCORE_BRANCH
4547 ENUMDOC
4548   This is a 19-bit reloc with the right 1 bit assumed to be 0
4549 ENUM
4550   BFD_RELOC_SCORE_IMM30
4551 ENUMDOC
4552   This is a 32-bit reloc for 48-bit instructions.
4553 ENUM
4554   BFD_RELOC_SCORE_IMM32
4555 ENUMDOC
4556   This is a 32-bit reloc for 48-bit instructions.
4557 ENUM
4558   BFD_RELOC_SCORE16_JMP
4559 ENUMDOC
4560   This is a 11-bit reloc with the right 1 bit assumed to be 0
4561 ENUM
4562   BFD_RELOC_SCORE16_BRANCH
4563 ENUMDOC
4564   This is a 8-bit reloc with the right 1 bit assumed to be 0
4565 ENUM
4566   BFD_RELOC_SCORE_BCMP
4567 ENUMDOC
4568    This is a 9-bit reloc with the right 1 bit assumed to be 0
4569 ENUM
4570   BFD_RELOC_SCORE_GOT15
4571 ENUMX
4572   BFD_RELOC_SCORE_GOT_LO16
4573 ENUMX
4574   BFD_RELOC_SCORE_CALL15
4575 ENUMX
4576   BFD_RELOC_SCORE_DUMMY_HI16
4577 ENUMDOC
4578   Undocumented Score relocs
4579   
4580 ENUM
4581   BFD_RELOC_IP2K_FR9
4582 ENUMDOC
4583   Scenix IP2K - 9-bit register number / data address
4584 ENUM
4585   BFD_RELOC_IP2K_BANK
4586 ENUMDOC
4587   Scenix IP2K - 4-bit register/data bank number
4588 ENUM
4589   BFD_RELOC_IP2K_ADDR16CJP
4590 ENUMDOC
4591   Scenix IP2K - low 13 bits of instruction word address
4592 ENUM
4593   BFD_RELOC_IP2K_PAGE3
4594 ENUMDOC