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