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