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_DTPMOD
2631ENUMX
2632  BFD_RELOC_PPC_TPREL16
2633ENUMX
2634  BFD_RELOC_PPC_TPREL16_LO
2635ENUMX
2636  BFD_RELOC_PPC_TPREL16_HI
2637ENUMX
2638  BFD_RELOC_PPC_TPREL16_HA
2639ENUMX
2640  BFD_RELOC_PPC_TPREL
2641ENUMX
2642  BFD_RELOC_PPC_DTPREL16
2643ENUMX
2644  BFD_RELOC_PPC_DTPREL16_LO
2645ENUMX
2646  BFD_RELOC_PPC_DTPREL16_HI
2647ENUMX
2648  BFD_RELOC_PPC_DTPREL16_HA
2649ENUMX
2650  BFD_RELOC_PPC_DTPREL
2651ENUMX
2652  BFD_RELOC_PPC_GOT_TLSGD16
2653ENUMX
2654  BFD_RELOC_PPC_GOT_TLSGD16_LO
2655ENUMX
2656  BFD_RELOC_PPC_GOT_TLSGD16_HI
2657ENUMX
2658  BFD_RELOC_PPC_GOT_TLSGD16_HA
2659ENUMX
2660  BFD_RELOC_PPC_GOT_TLSLD16
2661ENUMX
2662  BFD_RELOC_PPC_GOT_TLSLD16_LO
2663ENUMX
2664  BFD_RELOC_PPC_GOT_TLSLD16_HI
2665ENUMX
2666  BFD_RELOC_PPC_GOT_TLSLD16_HA
2667ENUMX
2668  BFD_RELOC_PPC_GOT_TPREL16
2669ENUMX
2670  BFD_RELOC_PPC_GOT_TPREL16_LO
2671ENUMX
2672  BFD_RELOC_PPC_GOT_TPREL16_HI
2673ENUMX
2674  BFD_RELOC_PPC_GOT_TPREL16_HA
2675ENUMX
2676  BFD_RELOC_PPC_GOT_DTPREL16
2677ENUMX
2678  BFD_RELOC_PPC_GOT_DTPREL16_LO
2679ENUMX
2680  BFD_RELOC_PPC_GOT_DTPREL16_HI
2681ENUMX
2682  BFD_RELOC_PPC_GOT_DTPREL16_HA
2683ENUMX
2684  BFD_RELOC_PPC64_TPREL16_DS
2685ENUMX
2686  BFD_RELOC_PPC64_TPREL16_LO_DS
2687ENUMX
2688  BFD_RELOC_PPC64_TPREL16_HIGHER
2689ENUMX
2690  BFD_RELOC_PPC64_TPREL16_HIGHERA
2691ENUMX
2692  BFD_RELOC_PPC64_TPREL16_HIGHEST
2693ENUMX
2694  BFD_RELOC_PPC64_TPREL16_HIGHESTA
2695ENUMX
2696  BFD_RELOC_PPC64_DTPREL16_DS
2697ENUMX
2698  BFD_RELOC_PPC64_DTPREL16_LO_DS
2699ENUMX
2700  BFD_RELOC_PPC64_DTPREL16_HIGHER
2701ENUMX
2702  BFD_RELOC_PPC64_DTPREL16_HIGHERA
2703ENUMX
2704  BFD_RELOC_PPC64_DTPREL16_HIGHEST
2705ENUMX
2706  BFD_RELOC_PPC64_DTPREL16_HIGHESTA
2707ENUMDOC
2708  PowerPC and PowerPC64 thread-local storage relocations.
2709
2710ENUM
2711  BFD_RELOC_I370_D12
2712ENUMDOC
2713  IBM 370/390 relocations
2714
2715ENUM
2716  BFD_RELOC_CTOR
2717ENUMDOC
2718  The type of reloc used to build a constructor table - at the moment
2719  probably a 32 bit wide absolute relocation, but the target can choose.
2720  It generally does map to one of the other relocation types.
2721
2722ENUM
2723  BFD_RELOC_ARM_PCREL_BRANCH
2724ENUMDOC
2725  ARM 26 bit pc-relative branch.  The lowest two bits must be zero and are
2726  not stored in the instruction.
2727ENUM
2728  BFD_RELOC_ARM_PCREL_BLX
2729ENUMDOC
2730  ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
2731  not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2732  field in the instruction.
2733ENUM
2734  BFD_RELOC_THUMB_PCREL_BLX
2735ENUMDOC
2736  Thumb 22 bit pc-relative branch.  The lowest bit must be zero and is
2737  not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2738  field in the instruction.
2739ENUM
2740  BFD_RELOC_ARM_PCREL_CALL
2741ENUMDOC
2742  ARM 26-bit pc-relative branch for an unconditional BL or BLX instruction.
2743ENUM
2744  BFD_RELOC_ARM_PCREL_JUMP
2745ENUMDOC
2746  ARM 26-bit pc-relative branch for B or conditional BL instruction.
2747
2748ENUM
2749  BFD_RELOC_THUMB_PCREL_BRANCH7
2750ENUMX
2751  BFD_RELOC_THUMB_PCREL_BRANCH9
2752ENUMX
2753  BFD_RELOC_THUMB_PCREL_BRANCH12
2754ENUMX
2755  BFD_RELOC_THUMB_PCREL_BRANCH20
2756ENUMX
2757  BFD_RELOC_THUMB_PCREL_BRANCH23
2758ENUMX
2759  BFD_RELOC_THUMB_PCREL_BRANCH25
2760ENUMDOC
2761  Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.
2762  The lowest bit must be zero and is not stored in the instruction.
2763  Note that the corresponding ELF R_ARM_THM_JUMPnn constant has an
2764  "nn" one smaller in all cases.  Note further that BRANCH23
2765  corresponds to R_ARM_THM_CALL.
2766
2767ENUM
2768  BFD_RELOC_ARM_OFFSET_IMM
2769ENUMDOC
2770  12-bit immediate offset, used in ARM-format ldr and str instructions.
2771
2772ENUM
2773  BFD_RELOC_ARM_THUMB_OFFSET
2774ENUMDOC
2775  5-bit immediate offset, used in Thumb-format ldr and str instructions.
2776
2777ENUM
2778  BFD_RELOC_ARM_TARGET1
2779ENUMDOC
2780  Pc-relative or absolute relocation depending on target.  Used for
2781  entries in .init_array sections.
2782ENUM
2783  BFD_RELOC_ARM_ROSEGREL32
2784ENUMDOC
2785  Read-only segment base relative address.
2786ENUM
2787  BFD_RELOC_ARM_SBREL32
2788ENUMDOC
2789  Data segment base relative address.
2790ENUM
2791  BFD_RELOC_ARM_TARGET2
2792ENUMDOC
2793  This reloc is used for references to RTTI data from exception handling
2794  tables.  The actual definition depends on the target.  It may be a
2795  pc-relative or some form of GOT-indirect relocation.
2796ENUM
2797  BFD_RELOC_ARM_PREL31
2798ENUMDOC
2799  31-bit PC relative address.
2800ENUM
2801  BFD_RELOC_ARM_MOVW
2802ENUMX
2803  BFD_RELOC_ARM_MOVT
2804ENUMX
2805  BFD_RELOC_ARM_MOVW_PCREL
2806ENUMX
2807  BFD_RELOC_ARM_MOVT_PCREL
2808ENUMX
2809  BFD_RELOC_ARM_THUMB_MOVW
2810ENUMX
2811  BFD_RELOC_ARM_THUMB_MOVT
2812ENUMX
2813  BFD_RELOC_ARM_THUMB_MOVW_PCREL
2814ENUMX
2815  BFD_RELOC_ARM_THUMB_MOVT_PCREL
2816ENUMDOC
2817  Low and High halfword relocations for MOVW and MOVT instructions.
2818
2819ENUM
2820  BFD_RELOC_ARM_JUMP_SLOT
2821ENUMX
2822  BFD_RELOC_ARM_GLOB_DAT
2823ENUMX
2824  BFD_RELOC_ARM_GOT32
2825ENUMX
2826  BFD_RELOC_ARM_PLT32
2827ENUMX
2828  BFD_RELOC_ARM_RELATIVE
2829ENUMX
2830  BFD_RELOC_ARM_GOTOFF
2831ENUMX
2832  BFD_RELOC_ARM_GOTPC
2833ENUMDOC
2834  Relocations for setting up GOTs and PLTs for shared libraries.
2835
2836ENUM
2837  BFD_RELOC_ARM_TLS_GD32
2838ENUMX
2839  BFD_RELOC_ARM_TLS_LDO32
2840ENUMX
2841  BFD_RELOC_ARM_TLS_LDM32
2842ENUMX
2843  BFD_RELOC_ARM_TLS_DTPOFF32
2844ENUMX
2845  BFD_RELOC_ARM_TLS_DTPMOD32
2846ENUMX
2847  BFD_RELOC_ARM_TLS_TPOFF32
2848ENUMX
2849  BFD_RELOC_ARM_TLS_IE32
2850ENUMX
2851  BFD_RELOC_ARM_TLS_LE32
2852ENUMDOC
2853  ARM thread-local storage relocations.
2854
2855ENUM
2856  BFD_RELOC_ARM_ALU_PC_G0_NC
2857ENUMX
2858  BFD_RELOC_ARM_ALU_PC_G0
2859ENUMX
2860  BFD_RELOC_ARM_ALU_PC_G1_NC
2861ENUMX
2862  BFD_RELOC_ARM_ALU_PC_G1
2863ENUMX
2864  BFD_RELOC_ARM_ALU_PC_G2
2865ENUMX
2866  BFD_RELOC_ARM_LDR_PC_G0
2867ENUMX
2868  BFD_RELOC_ARM_LDR_PC_G1
2869ENUMX
2870  BFD_RELOC_ARM_LDR_PC_G2
2871ENUMX
2872  BFD_RELOC_ARM_LDRS_PC_G0
2873ENUMX
2874  BFD_RELOC_ARM_LDRS_PC_G1
2875ENUMX
2876  BFD_RELOC_ARM_LDRS_PC_G2
2877ENUMX
2878  BFD_RELOC_ARM_LDC_PC_G0
2879ENUMX
2880  BFD_RELOC_ARM_LDC_PC_G1
2881ENUMX
2882  BFD_RELOC_ARM_LDC_PC_G2
2883ENUMX
2884  BFD_RELOC_ARM_ALU_SB_G0_NC
2885ENUMX
2886  BFD_RELOC_ARM_ALU_SB_G0
2887ENUMX
2888  BFD_RELOC_ARM_ALU_SB_G1_NC
2889ENUMX
2890  BFD_RELOC_ARM_ALU_SB_G1
2891ENUMX
2892  BFD_RELOC_ARM_ALU_SB_G2
2893ENUMX
2894  BFD_RELOC_ARM_LDR_SB_G0
2895ENUMX
2896  BFD_RELOC_ARM_LDR_SB_G1
2897ENUMX
2898  BFD_RELOC_ARM_LDR_SB_G2
2899ENUMX
2900  BFD_RELOC_ARM_LDRS_SB_G0
2901ENUMX
2902  BFD_RELOC_ARM_LDRS_SB_G1
2903ENUMX
2904  BFD_RELOC_ARM_LDRS_SB_G2
2905ENUMX
2906  BFD_RELOC_ARM_LDC_SB_G0
2907ENUMX
2908  BFD_RELOC_ARM_LDC_SB_G1
2909ENUMX
2910  BFD_RELOC_ARM_LDC_SB_G2
2911ENUMDOC
2912  ARM group relocations.
2913
2914ENUM
2915  BFD_RELOC_ARM_IMMEDIATE
2916ENUMX
2917  BFD_RELOC_ARM_ADRL_IMMEDIATE
2918ENUMX
2919  BFD_RELOC_ARM_T32_IMMEDIATE
2920ENUMX
2921  BFD_RELOC_ARM_T32_ADD_IMM
2922ENUMX
2923  BFD_RELOC_ARM_T32_IMM12
2924ENUMX
2925  BFD_RELOC_ARM_T32_ADD_PC12
2926ENUMX
2927  BFD_RELOC_ARM_SHIFT_IMM
2928ENUMX
2929  BFD_RELOC_ARM_SMC
2930ENUMX
2931  BFD_RELOC_ARM_SWI
2932ENUMX
2933  BFD_RELOC_ARM_MULTI
2934ENUMX
2935  BFD_RELOC_ARM_CP_OFF_IMM
2936ENUMX
2937  BFD_RELOC_ARM_CP_OFF_IMM_S2
2938ENUMX
2939  BFD_RELOC_ARM_T32_CP_OFF_IMM
2940ENUMX
2941  BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
2942ENUMX
2943  BFD_RELOC_ARM_ADR_IMM
2944ENUMX
2945  BFD_RELOC_ARM_LDR_IMM
2946ENUMX
2947  BFD_RELOC_ARM_LITERAL
2948ENUMX
2949  BFD_RELOC_ARM_IN_POOL
2950ENUMX
2951  BFD_RELOC_ARM_OFFSET_IMM8
2952ENUMX
2953  BFD_RELOC_ARM_T32_OFFSET_U8
2954ENUMX
2955  BFD_RELOC_ARM_T32_OFFSET_IMM
2956ENUMX
2957  BFD_RELOC_ARM_HWLITERAL
2958ENUMX
2959  BFD_RELOC_ARM_THUMB_ADD
2960ENUMX
2961  BFD_RELOC_ARM_THUMB_IMM
2962ENUMX
2963  BFD_RELOC_ARM_THUMB_SHIFT
2964ENUMDOC
2965  These relocs are only used within the ARM assembler.  They are not
2966  (at present) written to any object files.
2967
2968ENUM
2969  BFD_RELOC_SH_PCDISP8BY2
2970ENUMX
2971  BFD_RELOC_SH_PCDISP12BY2
2972ENUMX
2973  BFD_RELOC_SH_IMM3
2974ENUMX
2975  BFD_RELOC_SH_IMM3U
2976ENUMX
2977  BFD_RELOC_SH_DISP12
2978ENUMX
2979  BFD_RELOC_SH_DISP12BY2
2980ENUMX
2981  BFD_RELOC_SH_DISP12BY4
2982ENUMX
2983  BFD_RELOC_SH_DISP12BY8
2984ENUMX
2985  BFD_RELOC_SH_DISP20
2986ENUMX
2987  BFD_RELOC_SH_DISP20BY8
2988ENUMX
2989  BFD_RELOC_SH_IMM4
2990ENUMX
2991  BFD_RELOC_SH_IMM4BY2
2992ENUMX
2993  BFD_RELOC_SH_IMM4BY4
2994ENUMX
2995  BFD_RELOC_SH_IMM8
2996ENUMX
2997  BFD_RELOC_SH_IMM8BY2
2998ENUMX
2999  BFD_RELOC_SH_IMM8BY4
3000ENUMX
3001  BFD_RELOC_SH_PCRELIMM8BY2
3002ENUMX
3003  BFD_RELOC_SH_PCRELIMM8BY4
3004ENUMX
3005  BFD_RELOC_SH_SWITCH16
3006ENUMX
3007  BFD_RELOC_SH_SWITCH32
3008ENUMX
3009  BFD_RELOC_SH_USES
3010ENUMX
3011  BFD_RELOC_SH_COUNT
3012ENUMX
3013  BFD_RELOC_SH_ALIGN
3014ENUMX
3015  BFD_RELOC_SH_CODE
3016ENUMX
3017  BFD_RELOC_SH_DATA
3018ENUMX
3019  BFD_RELOC_SH_LABEL
3020ENUMX
3021  BFD_RELOC_SH_LOOP_START
3022ENUMX
3023  BFD_RELOC_SH_LOOP_END
3024ENUMX
3025  BFD_RELOC_SH_COPY
3026ENUMX
3027  BFD_RELOC_SH_GLOB_DAT
3028ENUMX
3029  BFD_RELOC_SH_JMP_SLOT
3030ENUMX
3031  BFD_RELOC_SH_RELATIVE
3032ENUMX
3033  BFD_RELOC_SH_GOTPC
3034ENUMX
3035  BFD_RELOC_SH_GOT_LOW16
3036ENUMX
3037  BFD_RELOC_SH_GOT_MEDLOW16
3038ENUMX
3039  BFD_RELOC_SH_GOT_MEDHI16
3040ENUMX
3041  BFD_RELOC_SH_GOT_HI16
3042ENUMX
3043  BFD_RELOC_SH_GOTPLT_LOW16
3044ENUMX
3045  BFD_RELOC_SH_GOTPLT_MEDLOW16
3046ENUMX
3047  BFD_RELOC_SH_GOTPLT_MEDHI16
3048ENUMX
3049  BFD_RELOC_SH_GOTPLT_HI16
3050ENUMX
3051  BFD_RELOC_SH_PLT_LOW16
3052ENUMX
3053  BFD_RELOC_SH_PLT_MEDLOW16
3054ENUMX
3055  BFD_RELOC_SH_PLT_MEDHI16
3056ENUMX
3057  BFD_RELOC_SH_PLT_HI16
3058ENUMX
3059  BFD_RELOC_SH_GOTOFF_LOW16
3060ENUMX
3061  BFD_RELOC_SH_GOTOFF_MEDLOW16
3062ENUMX
3063  BFD_RELOC_SH_GOTOFF_MEDHI16
3064ENUMX
3065  BFD_RELOC_SH_GOTOFF_HI16
3066ENUMX
3067  BFD_RELOC_SH_GOTPC_LOW16
3068ENUMX
3069  BFD_RELOC_SH_GOTPC_MEDLOW16
3070ENUMX
3071  BFD_RELOC_SH_GOTPC_MEDHI16
3072ENUMX
3073  BFD_RELOC_SH_GOTPC_HI16
3074ENUMX
3075  BFD_RELOC_SH_COPY64
3076ENUMX
3077  BFD_RELOC_SH_GLOB_DAT64
3078ENUMX
3079  BFD_RELOC_SH_JMP_SLOT64
3080ENUMX
3081  BFD_RELOC_SH_RELATIVE64
3082ENUMX
3083  BFD_RELOC_SH_GOT10BY4
3084ENUMX
3085  BFD_RELOC_SH_GOT10BY8
3086ENUMX
3087  BFD_RELOC_SH_GOTPLT10BY4
3088ENUMX
3089  BFD_RELOC_SH_GOTPLT10BY8
3090ENUMX
3091  BFD_RELOC_SH_GOTPLT32
3092ENUMX
3093  BFD_RELOC_SH_SHMEDIA_CODE
3094ENUMX
3095  BFD_RELOC_SH_IMMU5
3096ENUMX
3097  BFD_RELOC_SH_IMMS6
3098ENUMX
3099  BFD_RELOC_SH_IMMS6BY32
3100ENUMX
3101  BFD_RELOC_SH_IMMU6
3102ENUMX
3103  BFD_RELOC_SH_IMMS10
3104ENUMX
3105  BFD_RELOC_SH_IMMS10BY2
3106ENUMX
3107  BFD_RELOC_SH_IMMS10BY4
3108ENUMX
3109  BFD_RELOC_SH_IMMS10BY8
3110ENUMX
3111  BFD_RELOC_SH_IMMS16
3112ENUMX
3113  BFD_RELOC_SH_IMMU16
3114ENUMX
3115  BFD_RELOC_SH_IMM_LOW16
3116ENUMX
3117  BFD_RELOC_SH_IMM_LOW16_PCREL
3118ENUMX
3119  BFD_RELOC_SH_IMM_MEDLOW16
3120ENUMX
3121  BFD_RELOC_SH_IMM_MEDLOW16_PCREL
3122ENUMX
3123  BFD_RELOC_SH_IMM_MEDHI16
3124ENUMX
3125  BFD_RELOC_SH_IMM_MEDHI16_PCREL
3126ENUMX
3127  BFD_RELOC_SH_IMM_HI16
3128ENUMX
3129  BFD_RELOC_SH_IMM_HI16_PCREL
3130ENUMX
3131  BFD_RELOC_SH_PT_16
3132ENUMX
3133  BFD_RELOC_SH_TLS_GD_32
3134ENUMX
3135  BFD_RELOC_SH_TLS_LD_32
3136ENUMX
3137  BFD_RELOC_SH_TLS_LDO_32
3138ENUMX
3139  BFD_RELOC_SH_TLS_IE_32
3140ENUMX
3141  BFD_RELOC_SH_TLS_LE_32
3142ENUMX
3143  BFD_RELOC_SH_TLS_DTPMOD32
3144ENUMX
3145  BFD_RELOC_SH_TLS_DTPOFF32
3146ENUMX
3147  BFD_RELOC_SH_TLS_TPOFF32
3148ENUMDOC
3149  Renesas / SuperH SH relocs.  Not all of these appear in object files.
3150
3151ENUM
3152  BFD_RELOC_ARC_B22_PCREL
3153ENUMDOC
3154  ARC Cores relocs.
3155  ARC 22 bit pc-relative branch.  The lowest two bits must be zero and are
3156  not stored in the instruction.  The high 20 bits are installed in bits 26
3157  through 7 of the instruction.
3158ENUM
3159  BFD_RELOC_ARC_B26
3160ENUMDOC
3161  ARC 26 bit absolute branch.  The lowest two bits must be zero and are not
3162  stored in the instruction.  The high 24 bits are installed in bits 23
3163  through 0.
3164
3165ENUM
3166  BFD_RELOC_BFIN_16_IMM
3167ENUMDOC
3168  ADI Blackfin 16 bit immediate absolute reloc.
3169ENUM
3170  BFD_RELOC_BFIN_16_HIGH
3171ENUMDOC
3172  ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
3173ENUM
3174  BFD_RELOC_BFIN_4_PCREL
3175ENUMDOC
3176  ADI Blackfin 'a' part of LSETUP.
3177ENUM
3178  BFD_RELOC_BFIN_5_PCREL
3179ENUMDOC
3180  ADI Blackfin.
3181ENUM
3182  BFD_RELOC_BFIN_16_LOW
3183ENUMDOC
3184  ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
3185ENUM
3186  BFD_RELOC_BFIN_10_PCREL
3187ENUMDOC
3188  ADI Blackfin.
3189ENUM
3190  BFD_RELOC_BFIN_11_PCREL
3191ENUMDOC
3192  ADI Blackfin 'b' part of LSETUP.
3193ENUM
3194  BFD_RELOC_BFIN_12_PCREL_JUMP
3195ENUMDOC
3196  ADI Blackfin.
3197ENUM
3198  BFD_RELOC_BFIN_12_PCREL_JUMP_S
3199ENUMDOC
3200  ADI Blackfin Short jump, pcrel.
3201ENUM
3202  BFD_RELOC_BFIN_24_PCREL_CALL_X
3203ENUMDOC
3204  ADI Blackfin Call.x not implemented.
3205ENUM
3206  BFD_RELOC_BFIN_24_PCREL_JUMP_L
3207ENUMDOC
3208  ADI Blackfin Long Jump pcrel.
3209ENUM
3210  BFD_RELOC_BFIN_GOT17M4
3211ENUMX
3212  BFD_RELOC_BFIN_GOTHI
3213ENUMX
3214  BFD_RELOC_BFIN_GOTLO
3215ENUMX
3216  BFD_RELOC_BFIN_FUNCDESC
3217ENUMX
3218  BFD_RELOC_BFIN_FUNCDESC_GOT17M4
3219ENUMX
3220  BFD_RELOC_BFIN_FUNCDESC_GOTHI
3221ENUMX
3222  BFD_RELOC_BFIN_FUNCDESC_GOTLO
3223ENUMX
3224  BFD_RELOC_BFIN_FUNCDESC_VALUE
3225ENUMX
3226  BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
3227ENUMX
3228  BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
3229ENUMX
3230  BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
3231ENUMX
3232  BFD_RELOC_BFIN_GOTOFF17M4
3233ENUMX
3234  BFD_RELOC_BFIN_GOTOFFHI
3235ENUMX
3236  BFD_RELOC_BFIN_GOTOFFLO
3237ENUMDOC
3238  ADI Blackfin FD-PIC relocations.
3239ENUM
3240  BFD_RELOC_BFIN_GOT
3241ENUMDOC
3242  ADI Blackfin GOT relocation.
3243ENUM
3244  BFD_RELOC_BFIN_PLTPC
3245ENUMDOC
3246  ADI Blackfin PLTPC relocation.
3247ENUM
3248  BFD_ARELOC_BFIN_PUSH
3249ENUMDOC
3250  ADI Blackfin arithmetic relocation.
3251ENUM
3252  BFD_ARELOC_BFIN_CONST
3253ENUMDOC
3254  ADI Blackfin arithmetic relocation.
3255ENUM
3256  BFD_ARELOC_BFIN_ADD
3257ENUMDOC
3258  ADI Blackfin arithmetic relocation.
3259ENUM
3260  BFD_ARELOC_BFIN_SUB
3261ENUMDOC
3262  ADI Blackfin arithmetic relocation.
3263ENUM
3264  BFD_ARELOC_BFIN_MULT
3265ENUMDOC
3266  ADI Blackfin arithmetic relocation.
3267ENUM
3268  BFD_ARELOC_BFIN_DIV
3269ENUMDOC
3270  ADI Blackfin arithmetic relocation.
3271ENUM
3272  BFD_ARELOC_BFIN_MOD
3273ENUMDOC
3274  ADI Blackfin arithmetic relocation.
3275ENUM
3276  BFD_ARELOC_BFIN_LSHIFT
3277ENUMDOC
3278  ADI Blackfin arithmetic relocation.
3279ENUM
3280  BFD_ARELOC_BFIN_RSHIFT
3281ENUMDOC
3282  ADI Blackfin arithmetic relocation.
3283ENUM
3284  BFD_ARELOC_BFIN_AND
3285ENUMDOC
3286  ADI Blackfin arithmetic relocation.
3287ENUM
3288  BFD_ARELOC_BFIN_OR
3289ENUMDOC
3290  ADI Blackfin arithmetic relocation.
3291ENUM
3292  BFD_ARELOC_BFIN_XOR
3293ENUMDOC
3294  ADI Blackfin arithmetic relocation.
3295ENUM
3296  BFD_ARELOC_BFIN_LAND
3297ENUMDOC
3298  ADI Blackfin arithmetic relocation.
3299ENUM
3300  BFD_ARELOC_BFIN_LOR
3301ENUMDOC
3302  ADI Blackfin arithmetic relocation.
3303ENUM
3304  BFD_ARELOC_BFIN_LEN
3305ENUMDOC
3306  ADI Blackfin arithmetic relocation.
3307ENUM
3308  BFD_ARELOC_BFIN_NEG
3309ENUMDOC
3310  ADI Blackfin arithmetic relocation.
3311ENUM
3312  BFD_ARELOC_BFIN_COMP
3313ENUMDOC
3314  ADI Blackfin arithmetic relocation.
3315ENUM
3316  BFD_ARELOC_BFIN_PAGE
3317ENUMDOC
3318  ADI Blackfin arithmetic relocation.
3319ENUM
3320  BFD_ARELOC_BFIN_HWPAGE
3321ENUMDOC
3322  ADI Blackfin arithmetic relocation.
3323ENUM
3324  BFD_ARELOC_BFIN_ADDR
3325ENUMDOC
3326  ADI Blackfin arithmetic relocation.
3327
3328ENUM
3329  BFD_RELOC_D10V_10_PCREL_R
3330ENUMDOC
3331  Mitsubishi D10V relocs.
3332  This is a 10-bit reloc with the right 2 bits
3333  assumed to be 0.
3334ENUM
3335  BFD_RELOC_D10V_10_PCREL_L
3336ENUMDOC
3337  Mitsubishi D10V relocs.
3338  This is a 10-bit reloc with the right 2 bits
3339  assumed to be 0.  This is the same as the previous reloc
3340  except it is in the left container, i.e.,
3341  shifted left 15 bits.
3342ENUM
3343  BFD_RELOC_D10V_18
3344ENUMDOC
3345  This is an 18-bit reloc with the right 2 bits
3346  assumed to be 0.
3347ENUM
3348  BFD_RELOC_D10V_18_PCREL
3349ENUMDOC
3350  This is an 18-bit reloc with the right 2 bits
3351  assumed to be 0.
3352
3353ENUM
3354  BFD_RELOC_D30V_6
3355ENUMDOC
3356  Mitsubishi D30V relocs.
3357  This is a 6-bit absolute reloc.
3358ENUM
3359  BFD_RELOC_D30V_9_PCREL
3360ENUMDOC
3361  This is a 6-bit pc-relative reloc with
3362  the right 3 bits assumed to be 0.
3363ENUM
3364  BFD_RELOC_D30V_9_PCREL_R
3365ENUMDOC
3366  This is a 6-bit pc-relative reloc with
3367  the right 3 bits assumed to be 0. Same
3368  as the previous reloc but on the right side
3369  of the container.
3370ENUM
3371  BFD_RELOC_D30V_15
3372ENUMDOC
3373  This is a 12-bit absolute reloc with the
3374  right 3 bitsassumed to be 0.
3375ENUM
3376  BFD_RELOC_D30V_15_PCREL
3377ENUMDOC
3378  This is a 12-bit pc-relative reloc with
3379  the right 3 bits assumed to be 0.
3380ENUM
3381  BFD_RELOC_D30V_15_PCREL_R
3382ENUMDOC
3383  This is a 12-bit pc-relative reloc with
3384  the right 3 bits assumed to be 0. Same
3385  as the previous reloc but on the right side
3386  of the container.
3387ENUM
3388  BFD_RELOC_D30V_21
3389ENUMDOC
3390  This is an 18-bit absolute reloc with
3391  the right 3 bits assumed to be 0.
3392ENUM
3393  BFD_RELOC_D30V_21_PCREL
3394ENUMDOC
3395  This is an 18-bit pc-relative reloc with
3396  the right 3 bits assumed to be 0.
3397ENUM
3398  BFD_RELOC_D30V_21_PCREL_R
3399ENUMDOC
3400  This is an 18-bit pc-relative reloc with
3401  the right 3 bits assumed to be 0. Same
3402  as the previous reloc but on the right side
3403  of the container.
3404ENUM
3405  BFD_RELOC_D30V_32
3406ENUMDOC
3407  This is a 32-bit absolute reloc.
3408ENUM
3409  BFD_RELOC_D30V_32_PCREL
3410ENUMDOC
3411  This is a 32-bit pc-relative reloc.
3412
3413ENUM
3414  BFD_RELOC_DLX_HI16_S
3415ENUMDOC
3416  DLX relocs
3417ENUM
3418  BFD_RELOC_DLX_LO16
3419ENUMDOC
3420  DLX relocs
3421ENUM
3422  BFD_RELOC_DLX_JMP26
3423ENUMDOC
3424  DLX relocs
3425
3426ENUM
3427  BFD_RELOC_M32C_HI8
3428ENUMX
3429  BFD_RELOC_M32C_RL_JUMP
3430ENUMX
3431  BFD_RELOC_M32C_RL_1ADDR
3432ENUMX
3433  BFD_RELOC_M32C_RL_2ADDR
3434ENUMDOC
3435  Renesas M16C/M32C Relocations.
3436
3437ENUM
3438  BFD_RELOC_M32R_24
3439ENUMDOC
3440  Renesas M32R (formerly Mitsubishi M32R) relocs.
3441  This is a 24 bit absolute address.
3442ENUM
3443  BFD_RELOC_M32R_10_PCREL
3444ENUMDOC
3445  This is a 10-bit pc-relative reloc with the right 2 bits assumed to be 0.
3446ENUM
3447  BFD_RELOC_M32R_18_PCREL
3448ENUMDOC
3449  This is an 18-bit reloc with the right 2 bits assumed to be 0.
3450ENUM
3451  BFD_RELOC_M32R_26_PCREL
3452ENUMDOC
3453  This is a 26-bit reloc with the right 2 bits assumed to be 0.
3454ENUM
3455  BFD_RELOC_M32R_HI16_ULO
3456ENUMDOC
3457  This is a 16-bit reloc containing the high 16 bits of an address
3458  used when the lower 16 bits are treated as unsigned.
3459ENUM
3460  BFD_RELOC_M32R_HI16_SLO
3461ENUMDOC
3462  This is a 16-bit reloc containing the high 16 bits of an address
3463  used when the lower 16 bits are treated as signed.
3464ENUM
3465  BFD_RELOC_M32R_LO16
3466ENUMDOC
3467  This is a 16-bit reloc containing the lower 16 bits of an address.
3468ENUM
3469  BFD_RELOC_M32R_SDA16
3470ENUMDOC
3471  This is a 16-bit reloc containing the small data area offset for use in
3472  add3, load, and store instructions.
3473ENUM
3474  BFD_RELOC_M32R_GOT24
3475ENUMX
3476  BFD_RELOC_M32R_26_PLTREL
3477ENUMX
3478  BFD_RELOC_M32R_COPY
3479ENUMX
3480  BFD_RELOC_M32R_GLOB_DAT
3481ENUMX
3482  BFD_RELOC_M32R_JMP_SLOT
3483ENUMX
3484  BFD_RELOC_M32R_RELATIVE
3485ENUMX
3486  BFD_RELOC_M32R_GOTOFF
3487ENUMX
3488  BFD_RELOC_M32R_GOTOFF_HI_ULO
3489ENUMX
3490  BFD_RELOC_M32R_GOTOFF_HI_SLO
3491ENUMX
3492  BFD_RELOC_M32R_GOTOFF_LO
3493ENUMX
3494  BFD_RELOC_M32R_GOTPC24
3495ENUMX
3496  BFD_RELOC_M32R_GOT16_HI_ULO
3497ENUMX
3498  BFD_RELOC_M32R_GOT16_HI_SLO
3499ENUMX
3500  BFD_RELOC_M32R_GOT16_LO
3501ENUMX
3502  BFD_RELOC_M32R_GOTPC_HI_ULO
3503ENUMX
3504  BFD_RELOC_M32R_GOTPC_HI_SLO
3505ENUMX
3506  BFD_RELOC_M32R_GOTPC_LO
3507ENUMDOC
3508  For PIC.
3509
3510
3511ENUM
3512  BFD_RELOC_V850_9_PCREL
3513ENUMDOC
3514  This is a 9-bit reloc
3515ENUM
3516  BFD_RELOC_V850_22_PCREL
3517ENUMDOC
3518  This is a 22-bit reloc
3519
3520ENUM
3521  BFD_RELOC_V850_SDA_16_16_OFFSET
3522ENUMDOC
3523  This is a 16 bit offset from the short data area pointer.
3524ENUM
3525  BFD_RELOC_V850_SDA_15_16_OFFSET
3526ENUMDOC
3527  This is a 16 bit offset (of which only 15 bits are used) from the
3528  short data area pointer.
3529ENUM
3530  BFD_RELOC_V850_ZDA_16_16_OFFSET
3531ENUMDOC
3532  This is a 16 bit offset from the zero data area pointer.
3533ENUM
3534  BFD_RELOC_V850_ZDA_15_16_OFFSET
3535ENUMDOC
3536  This is a 16 bit offset (of which only 15 bits are used) from the
3537  zero data area pointer.
3538ENUM
3539  BFD_RELOC_V850_TDA_6_8_OFFSET
3540ENUMDOC
3541  This is an 8 bit offset (of which only 6 bits are used) from the
3542  tiny data area pointer.
3543ENUM
3544  BFD_RELOC_V850_TDA_7_8_OFFSET
3545ENUMDOC
3546  This is an 8bit offset (of which only 7 bits are used) from the tiny
3547  data area pointer.
3548ENUM
3549  BFD_RELOC_V850_TDA_7_7_OFFSET
3550ENUMDOC
3551  This is a 7 bit offset from the tiny data area pointer.
3552ENUM
3553  BFD_RELOC_V850_TDA_16_16_OFFSET
3554ENUMDOC
3555  This is a 16 bit offset from the tiny data area pointer.
3556COMMENT
3557ENUM
3558  BFD_RELOC_V850_TDA_4_5_OFFSET
3559ENUMDOC
3560  This is a 5 bit offset (of which only 4 bits are used) from the tiny
3561  data area pointer.
3562ENUM
3563  BFD_RELOC_V850_TDA_4_4_OFFSET
3564ENUMDOC
3565  This is a 4 bit offset from the tiny data area pointer.
3566ENUM
3567  BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
3568ENUMDOC
3569  This is a 16 bit offset from the short data area pointer, with the
3570  bits placed non-contiguously in the instruction.
3571ENUM
3572  BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
3573ENUMDOC
3574  This is a 16 bit offset from the zero data area pointer, with the
3575  bits placed non-contiguously in the instruction.
3576ENUM
3577  BFD_RELOC_V850_CALLT_6_7_OFFSET
3578ENUMDOC
3579  This is a 6 bit offset from the call table base pointer.
3580ENUM
3581  BFD_RELOC_V850_CALLT_16_16_OFFSET
3582ENUMDOC
3583  This is a 16 bit offset from the call table base pointer.
3584ENUM
3585  BFD_RELOC_V850_LONGCALL
3586ENUMDOC
3587  Used for relaxing indirect function calls.
3588ENUM
3589  BFD_RELOC_V850_LONGJUMP
3590ENUMDOC
3591  Used for relaxing indirect jumps.
3592ENUM
3593  BFD_RELOC_V850_ALIGN
3594ENUMDOC
3595  Used to maintain alignment whilst relaxing.
3596ENUM
3597  BFD_RELOC_V850_LO16_SPLIT_OFFSET
3598ENUMDOC
3599  This is a variation of BFD_RELOC_LO16 that can be used in v850e ld.bu
3600  instructions.
3601ENUM
3602  BFD_RELOC_MN10300_32_PCREL
3603ENUMDOC
3604  This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the
3605  instruction.
3606ENUM
3607  BFD_RELOC_MN10300_16_PCREL
3608ENUMDOC
3609  This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the
3610  instruction.
3611
3612ENUM
3613  BFD_RELOC_TIC30_LDP
3614ENUMDOC
3615  This is a 8bit DP reloc for the tms320c30, where the most
3616  significant 8 bits of a 24 bit word are placed into the least
3617  significant 8 bits of the opcode.
3618
3619ENUM
3620  BFD_RELOC_TIC54X_PARTLS7
3621ENUMDOC
3622  This is a 7bit reloc for the tms320c54x, where the least
3623  significant 7 bits of a 16 bit word are placed into the least
3624  significant 7 bits of the opcode.
3625
3626ENUM
3627  BFD_RELOC_TIC54X_PARTMS9
3628ENUMDOC
3629  This is a 9bit DP reloc for the tms320c54x, where the most
3630  significant 9 bits of a 16 bit word are placed into the least
3631  significant 9 bits of the opcode.
3632
3633ENUM
3634  BFD_RELOC_TIC54X_23
3635ENUMDOC
3636  This is an extended address 23-bit reloc for the tms320c54x.
3637
3638ENUM
3639  BFD_RELOC_TIC54X_16_OF_23
3640ENUMDOC
3641  This is a 16-bit reloc for the tms320c54x, where the least
3642  significant 16 bits of a 23-bit extended address are placed into
3643  the opcode.
3644
3645ENUM
3646  BFD_RELOC_TIC54X_MS7_OF_23
3647ENUMDOC
3648  This is a reloc for the tms320c54x, where the most
3649  significant 7 bits of a 23-bit extended address are placed into
3650  the opcode.
3651
3652ENUM
3653  BFD_RELOC_FR30_48
3654ENUMDOC
3655  This is a 48 bit reloc for the FR30 that stores 32 bits.
3656ENUM
3657  BFD_RELOC_FR30_20
3658ENUMDOC
3659  This is a 32 bit reloc for the FR30 that stores 20 bits split up into
3660  two sections.
3661ENUM
3662  BFD_RELOC_FR30_6_IN_4
3663ENUMDOC
3664  This is a 16 bit reloc for the FR30 that stores a 6 bit word offset in
3665  4 bits.
3666ENUM
3667  BFD_RELOC_FR30_8_IN_8
3668ENUMDOC
3669  This is a 16 bit reloc for the FR30 that stores an 8 bit byte offset
3670  into 8 bits.
3671ENUM
3672  BFD_RELOC_FR30_9_IN_8
3673ENUMDOC
3674  This is a 16 bit reloc for the FR30 that stores a 9 bit short offset
3675  into 8 bits.
3676ENUM
3677  BFD_RELOC_FR30_10_IN_8
3678ENUMDOC
3679  This is a 16 bit reloc for the FR30 that stores a 10 bit word offset
3680  into 8 bits.
3681ENUM
3682  BFD_RELOC_FR30_9_PCREL
3683ENUMDOC
3684  This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
3685  short offset into 8 bits.
3686ENUM
3687  BFD_RELOC_FR30_12_PCREL
3688ENUMDOC
3689  This is a 16 bit reloc for the FR30 that stores a 12 bit pc relative
3690  short offset into 11 bits.
3691
3692ENUM
3693  BFD_RELOC_MCORE_PCREL_IMM8BY4
3694ENUMX
3695  BFD_RELOC_MCORE_PCREL_IMM11BY2
3696ENUMX
3697  BFD_RELOC_MCORE_PCREL_IMM4BY2
3698ENUMX
3699  BFD_RELOC_MCORE_PCREL_32
3700ENUMX
3701  BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
3702ENUMX
3703  BFD_RELOC_MCORE_RVA
3704ENUMDOC
3705  Motorola Mcore relocations.
3706
3707ENUM
3708  BFD_RELOC_MEP_8
3709ENUMX
3710  BFD_RELOC_MEP_16
3711ENUMX
3712  BFD_RELOC_MEP_32
3713ENUMX
3714  BFD_RELOC_MEP_PCREL8A2
3715ENUMX
3716  BFD_RELOC_MEP_PCREL12A2
3717ENUMX
3718  BFD_RELOC_MEP_PCREL17A2
3719ENUMX
3720  BFD_RELOC_MEP_PCREL24A2
3721ENUMX
3722  BFD_RELOC_MEP_PCABS24A2
3723ENUMX
3724  BFD_RELOC_MEP_LOW16
3725ENUMX
3726  BFD_RELOC_MEP_HI16U
3727ENUMX
3728  BFD_RELOC_MEP_HI16S
3729ENUMX
3730  BFD_RELOC_MEP_GPREL
3731ENUMX
3732  BFD_RELOC_MEP_TPREL
3733ENUMX
3734  BFD_RELOC_MEP_TPREL7
3735ENUMX
3736  BFD_RELOC_MEP_TPREL7A2
3737ENUMX
3738  BFD_RELOC_MEP_TPREL7A4
3739ENUMX
3740  BFD_RELOC_MEP_UIMM24
3741ENUMX
3742  BFD_RELOC_MEP_ADDR24A4
3743ENUMX
3744  BFD_RELOC_MEP_GNU_VTINHERIT
3745ENUMX
3746  BFD_RELOC_MEP_GNU_VTENTRY
3747ENUMDOC
3748  Toshiba Media Processor Relocations.
3749COMMENT
3750
3751ENUM
3752  BFD_RELOC_MMIX_GETA
3753ENUMX
3754  BFD_RELOC_MMIX_GETA_1
3755ENUMX
3756  BFD_RELOC_MMIX_GETA_2
3757ENUMX
3758  BFD_RELOC_MMIX_GETA_3
3759ENUMDOC
3760  These are relocations for the GETA instruction.
3761ENUM
3762  BFD_RELOC_MMIX_CBRANCH
3763ENUMX
3764  BFD_RELOC_MMIX_CBRANCH_J
3765ENUMX
3766  BFD_RELOC_MMIX_CBRANCH_1
3767ENUMX
3768  BFD_RELOC_MMIX_CBRANCH_2
3769ENUMX
3770  BFD_RELOC_MMIX_CBRANCH_3
3771ENUMDOC
3772  These are relocations for a conditional branch instruction.
3773ENUM
3774  BFD_RELOC_MMIX_PUSHJ
3775ENUMX
3776  BFD_RELOC_MMIX_PUSHJ_1
3777ENUMX
3778  BFD_RELOC_MMIX_PUSHJ_2
3779ENUMX
3780  BFD_RELOC_MMIX_PUSHJ_3
3781ENUMX
3782  BFD_RELOC_MMIX_PUSHJ_STUBBABLE
3783ENUMDOC
3784  These are relocations for the PUSHJ instruction.
3785ENUM
3786  BFD_RELOC_MMIX_JMP
3787ENUMX
3788  BFD_RELOC_MMIX_JMP_1
3789ENUMX
3790  BFD_RELOC_MMIX_JMP_2
3791ENUMX
3792  BFD_RELOC_MMIX_JMP_3
3793ENUMDOC
3794  These are relocations for the JMP instruction.
3795ENUM
3796  BFD_RELOC_MMIX_ADDR19
3797ENUMDOC
3798  This is a relocation for a relative address as in a GETA instruction or
3799  a branch.
3800ENUM
3801  BFD_RELOC_MMIX_ADDR27
3802ENUMDOC
3803  This is a relocation for a relative address as in a JMP instruction.
3804ENUM
3805  BFD_RELOC_MMIX_REG_OR_BYTE
3806ENUMDOC
3807  This is a relocation for an instruction field that may be a general
3808  register or a value 0..255.
3809ENUM
3810  BFD_RELOC_MMIX_REG
3811ENUMDOC
3812  This is a relocation for an instruction field that may be a general
3813  register.
3814ENUM
3815  BFD_RELOC_MMIX_BASE_PLUS_OFFSET
3816ENUMDOC
3817  This is a relocation for two instruction fields holding a register and
3818  an offset, the equivalent of the relocation.
3819ENUM
3820  BFD_RELOC_MMIX_LOCAL
3821ENUMDOC
3822  This relocation is an assertion that the expression is not allocated as
3823  a global register.  It does not modify contents.
3824
3825ENUM
3826  BFD_RELOC_AVR_7_PCREL
3827ENUMDOC
3828  This is a 16 bit reloc for the AVR that stores 8 bit pc relative
3829  short offset into 7 bits.
3830ENUM
3831  BFD_RELOC_AVR_13_PCREL
3832ENUMDOC
3833  This is a 16 bit reloc for the AVR that stores 13 bit pc relative
3834  short offset into 12 bits.
3835ENUM
3836  BFD_RELOC_AVR_16_PM
3837ENUMDOC
3838  This is a 16 bit reloc for the AVR that stores 17 bit value (usually
3839  program memory address) into 16 bits.
3840ENUM
3841  BFD_RELOC_AVR_LO8_LDI
3842ENUMDOC
3843  This is a 16 bit reloc for the AVR that stores 8 bit value (usually
3844  data memory address) into 8 bit immediate value of LDI insn.
3845ENUM
3846  BFD_RELOC_AVR_HI8_LDI
3847ENUMDOC
3848  This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3849  of data memory address) into 8 bit immediate value of LDI insn.
3850ENUM
3851  BFD_RELOC_AVR_HH8_LDI
3852ENUMDOC
3853  This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3854  of program memory address) into 8 bit immediate value of LDI insn.
3855ENUM
3856  BFD_RELOC_AVR_MS8_LDI
3857ENUMDOC
3858  This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3859  of 32 bit value) into 8 bit immediate value of LDI insn.
3860ENUM
3861  BFD_RELOC_AVR_LO8_LDI_NEG
3862ENUMDOC
3863  This is a 16 bit reloc for the AVR that stores negated 8 bit value
3864  (usually data memory address) into 8 bit immediate value of SUBI insn.
3865ENUM
3866  BFD_RELOC_AVR_HI8_LDI_NEG
3867ENUMDOC
3868  This is a 16 bit reloc for the AVR that stores negated 8 bit value
3869  (high 8 bit of data memory address) into 8 bit immediate value of
3870  SUBI insn.
3871ENUM
3872  BFD_RELOC_AVR_HH8_LDI_NEG
3873ENUMDOC
3874  This is a 16 bit reloc for the AVR that stores negated 8 bit value
3875  (most high 8 bit of program memory address) into 8 bit immediate value
3876  of LDI or SUBI insn.
3877ENUM
3878  BFD_RELOC_AVR_MS8_LDI_NEG
3879ENUMDOC
3880  This is a 16 bit reloc for the AVR that stores negated 8 bit value (msb
3881  of 32 bit value) into 8 bit immediate value of LDI insn.
3882ENUM
3883  BFD_RELOC_AVR_LO8_LDI_PM
3884ENUMDOC
3885  This is a 16 bit reloc for the AVR that stores 8 bit value (usually
3886  command address) into 8 bit immediate value of LDI insn.
3887ENUM
3888  BFD_RELOC_AVR_LO8_LDI_GS
3889ENUMDOC
3890  This is a 16 bit reloc for the AVR that stores 8 bit value
3891  (command address) into 8 bit immediate value of LDI insn. If the address
3892  is beyond the 128k boundary, the linker inserts a jump stub for this reloc
3893  in the lower 128k.
3894ENUM
3895  BFD_RELOC_AVR_HI8_LDI_PM
3896ENUMDOC
3897  This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3898  of command address) into 8 bit immediate value of LDI insn.
3899ENUM
3900  BFD_RELOC_AVR_HI8_LDI_GS
3901ENUMDOC
3902  This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3903  of command address) into 8 bit immediate value of LDI insn.  If the address
3904  is beyond the 128k boundary, the linker inserts a jump stub for this reloc
3905  below 128k.
3906ENUM
3907  BFD_RELOC_AVR_HH8_LDI_PM
3908ENUMDOC
3909  This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3910  of command address) into 8 bit immediate value of LDI insn.
3911ENUM
3912  BFD_RELOC_AVR_LO8_LDI_PM_NEG
3913ENUMDOC
3914  This is a 16 bit reloc for the AVR that stores negated 8 bit value
3915  (usually command address) into 8 bit immediate value of SUBI insn.
3916ENUM
3917  BFD_RELOC_AVR_HI8_LDI_PM_NEG
3918ENUMDOC
3919  This is a 16 bit reloc for the AVR that stores negated 8 bit value
3920  (high 8 bit of 16 bit command address) into 8 bit immediate value
3921  of SUBI insn.
3922ENUM
3923  BFD_RELOC_AVR_HH8_LDI_PM_NEG
3924ENUMDOC
3925  This is a 16 bit reloc for the AVR that stores negated 8 bit value
3926  (high 6 bit of 22 bit command address) into 8 bit immediate
3927  value of SUBI insn.
3928ENUM
3929  BFD_RELOC_AVR_CALL
3930ENUMDOC
3931  This is a 32 bit reloc for the AVR that stores 23 bit value
3932  into 22 bits.
3933ENUM
3934  BFD_RELOC_AVR_LDI
3935ENUMDOC
3936  This is a 16 bit reloc for the AVR that stores all needed bits
3937  for absolute addressing with ldi with overflow check to linktime
3938ENUM
3939  BFD_RELOC_AVR_6
3940ENUMDOC
3941  This is a 6 bit reloc for the AVR that stores offset for ldd/std
3942  instructions
3943ENUM
3944  BFD_RELOC_AVR_6_ADIW
3945ENUMDOC
3946  This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
3947  instructions
3948
3949ENUM
3950  BFD_RELOC_390_12
3951ENUMDOC
3952   Direct 12 bit.
3953ENUM
3954  BFD_RELOC_390_GOT12
3955ENUMDOC
3956  12 bit GOT offset.
3957ENUM
3958  BFD_RELOC_390_PLT32
3959ENUMDOC
3960  32 bit PC relative PLT address.
3961ENUM
3962  BFD_RELOC_390_COPY
3963ENUMDOC
3964  Copy symbol at runtime.
3965ENUM
3966  BFD_RELOC_390_GLOB_DAT
3967ENUMDOC
3968  Create GOT entry.
3969ENUM
3970  BFD_RELOC_390_JMP_SLOT
3971ENUMDOC
3972  Create PLT entry.
3973ENUM
3974  BFD_RELOC_390_RELATIVE
3975ENUMDOC
3976  Adjust by program base.
3977ENUM
3978  BFD_RELOC_390_GOTPC
3979ENUMDOC
3980  32 bit PC relative offset to GOT.
3981ENUM
3982  BFD_RELOC_390_GOT16
3983ENUMDOC
3984  16 bit GOT offset.
3985ENUM
3986  BFD_RELOC_390_PC16DBL
3987ENUMDOC
3988  PC relative 16 bit shifted by 1.
3989ENUM
3990  BFD_RELOC_390_PLT16DBL
3991ENUMDOC
3992  16 bit PC rel. PLT shifted by 1.
3993ENUM
3994  BFD_RELOC_390_PC32DBL
3995ENUMDOC
3996  PC relative 32 bit shifted by 1.
3997ENUM
3998  BFD_RELOC_390_PLT32DBL
3999ENUMDOC
4000  32 bit PC rel. PLT shifted by 1.
4001ENUM
4002  BFD_RELOC_390_GOTPCDBL
4003ENUMDOC
4004  32 bit PC rel. GOT shifted by 1.
4005ENUM
4006  BFD_RELOC_390_GOT64
4007ENUMDOC
4008  64 bit GOT offset.
4009ENUM
4010  BFD_RELOC_390_PLT64
4011ENUMDOC
4012  64 bit PC relative PLT address.
4013ENUM
4014  BFD_RELOC_390_GOTENT
4015ENUMDOC
4016  32 bit rel. offset to GOT entry.
4017ENUM
4018  BFD_RELOC_390_GOTOFF64
4019ENUMDOC
4020  64 bit offset to GOT.
4021ENUM
4022  BFD_RELOC_390_GOTPLT12
4023ENUMDOC
4024  12-bit offset to symbol-entry within GOT, with PLT handling.
4025ENUM
4026  BFD_RELOC_390_GOTPLT16
4027ENUMDOC
4028  16-bit offset to symbol-entry within GOT, with PLT handling.
4029ENUM
4030  BFD_RELOC_390_GOTPLT32
4031ENUMDOC
4032  32-bit offset to symbol-entry within GOT, with PLT handling.
4033ENUM
4034  BFD_RELOC_390_GOTPLT64
4035ENUMDOC
4036  64-bit offset to symbol-entry within GOT, with PLT handling.
4037ENUM
4038  BFD_RELOC_390_GOTPLTENT
4039ENUMDOC
4040  32-bit rel. offset to symbol-entry within GOT, with PLT handling.
4041ENUM
4042  BFD_RELOC_390_PLTOFF16
4043ENUMDOC
4044  16-bit rel. offset from the GOT to a PLT entry.
4045ENUM
4046  BFD_RELOC_390_PLTOFF32
4047ENUMDOC
4048  32-bit rel. offset from the GOT to a PLT entry.
4049ENUM
4050  BFD_RELOC_390_PLTOFF64
4051ENUMDOC
4052  64-bit rel. offset from the GOT to a PLT entry.
4053
4054ENUM
4055  BFD_RELOC_390_TLS_LOAD
4056ENUMX
4057  BFD_RELOC_390_TLS_GDCALL
4058ENUMX
4059  BFD_RELOC_390_TLS_LDCALL
4060ENUMX
4061  BFD_RELOC_390_TLS_GD32
4062ENUMX
4063  BFD_RELOC_390_TLS_GD64
4064ENUMX
4065  BFD_RELOC_390_TLS_GOTIE12
4066ENUMX
4067  BFD_RELOC_390_TLS_GOTIE32
4068ENUMX
4069  BFD_RELOC_390_TLS_GOTIE64
4070ENUMX
4071  BFD_RELOC_390_TLS_LDM32
4072ENUMX
4073  BFD_RELOC_390_TLS_LDM64
4074ENUMX
4075  BFD_RELOC_390_TLS_IE32
4076ENUMX
4077  BFD_RELOC_390_TLS_IE64
4078ENUMX
4079  BFD_RELOC_390_TLS_IEENT
4080ENUMX
4081  BFD_RELOC_390_TLS_LE32
4082ENUMX
4083  BFD_RELOC_390_TLS_LE64
4084ENUMX
4085  BFD_RELOC_390_TLS_LDO32
4086ENUMX
4087  BFD_RELOC_390_TLS_LDO64
4088ENUMX
4089  BFD_RELOC_390_TLS_DTPMOD
4090ENUMX
4091  BFD_RELOC_390_TLS_DTPOFF
4092ENUMX
4093  BFD_RELOC_390_TLS_TPOFF
4094ENUMDOC
4095  s390 tls relocations.
4096
4097ENUM
4098  BFD_RELOC_390_20
4099ENUMX
4100  BFD_RELOC_390_GOT20
4101ENUMX
4102  BFD_RELOC_390_GOTPLT20
4103ENUMX
4104  BFD_RELOC_390_TLS_GOTIE20
4105ENUMDOC
4106  Long displacement extension.
4107
4108ENUM
4109  BFD_RELOC_SCORE_DUMMY1
4110ENUMDOC
4111  Score relocations
4112ENUM
4113  BFD_RELOC_SCORE_GPREL15
4114ENUMDOC
4115  Low 16 bit for load/store
4116ENUM
4117  BFD_RELOC_SCORE_DUMMY2
4118ENUMX
4119  BFD_RELOC_SCORE_JMP
4120ENUMDOC
4121  This is a 24-bit reloc with the right 1 bit assumed to be 0
4122ENUM
4123  BFD_RELOC_SCORE_BRANCH
4124ENUMDOC
4125  This is a 19-bit reloc with the right 1 bit assumed to be 0
4126ENUM
4127  BFD_RELOC_SCORE16_JMP
4128ENUMDOC
4129  This is a 11-bit reloc with the right 1 bit assumed to be 0
4130ENUM
4131  BFD_RELOC_SCORE16_BRANCH
4132ENUMDOC
4133  This is a 8-bit reloc with the right 1 bit assumed to be 0
4134ENUM
4135  BFD_RELOC_SCORE_GOT15
4136ENUMX
4137  BFD_RELOC_SCORE_GOT_LO16
4138ENUMX
4139  BFD_RELOC_SCORE_CALL15
4140ENUMX
4141  BFD_RELOC_SCORE_DUMMY_HI16
4142ENUMDOC
4143  Undocumented Score relocs
4144
4145ENUM
4146  BFD_RELOC_IP2K_FR9
4147ENUMDOC
4148  Scenix IP2K - 9-bit register number / data address
4149ENUM
4150  BFD_RELOC_IP2K_BANK
4151ENUMDOC
4152  Scenix IP2K - 4-bit register/data bank number
4153ENUM
4154  BFD_RELOC_IP2K_ADDR16CJP
4155ENUMDOC
4156  Scenix IP2K - low 13 bits of instruction word address
4157ENUM
4158  BFD_RELOC_IP2K_PAGE3
4159ENUMDOC
4160  Scenix IP2K - high 3 bits of instruction word address
4161ENUM
4162  BFD_RELOC_IP2K_LO8DATA
4163ENUMX
4164  BFD_RELOC_IP2K_HI8DATA
4165ENUMX
4166  BFD_RELOC_IP2K_EX8DATA
4167ENUMDOC
4168  Scenix IP2K - ext/low/high 8 bits of data address
4169ENUM
4170  BFD_RELOC_IP2K_LO8INSN
4171ENUMX
4172  BFD_RELOC_IP2K_HI8INSN
4173ENUMDOC
4174  Scenix IP2K - low/high 8 bits of instruction word address
4175ENUM
4176  BFD_RELOC_IP2K_PC_SKIP
4177ENUMDOC
4178  Scenix IP2K - even/odd PC modifier to modify snb pcl.0
4179ENUM
4180  BFD_RELOC_IP2K_TEXT
4181ENUMDOC
4182  Scenix IP2K - 16 bit word address in text section.
4183ENUM
4184  BFD_RELOC_IP2K_FR_OFFSET
4185ENUMDOC
4186  Scenix IP2K - 7-bit sp or dp offset
4187ENUM
4188  BFD_RELOC_VPE4KMATH_DATA
4189ENUMX
4190  BFD_RELOC_VPE4KMATH_INSN
4191ENUMDOC
4192  Scenix VPE4K coprocessor - data/insn-space addressing
4193
4194ENUM
4195  BFD_RELOC_VTABLE_INHERIT
4196ENUMX
4197  BFD_RELOC_VTABLE_ENTRY
4198ENUMDOC
4199  These two relocations are used by the linker to determine which of
4200  the entries in a C++ virtual function table are actually used.  When
4201  the --gc-sections option is given, the linker will zero out the entries
4202  that are not used, so that the code for those functions need not be
4203  included in the output.
4204
4205  VTABLE_INHERIT is a zero-space relocation used to describe to the
4206  linker the inheritance tree of a C++ virtual function table.  The
4207  relocation's symbol should be the parent class' vtable, and the
4208  relocation should be located at the child vtable.
4209
4210  VTABLE_ENTRY is a zero-space relocation that describes the use of a
4211  virtual function table entry.  The reloc's symbol should refer to the
4212  table of the class mentioned in the code.  Off of that base, an offset
4213  describes the entry that is being used.  For Rela hosts, this offset
4214  is stored in the reloc's addend.  For Rel hosts, we are forced to put
4215  this offset in the reloc's section offset.
4216
4217ENUM
4218  BFD_RELOC_IA64_IMM14
4219ENUMX
4220  BFD_RELOC_IA64_IMM22
4221ENUMX
4222  BFD_RELOC_IA64_IMM64
4223ENUMX
4224  BFD_RELOC_IA64_DIR32MSB
4225ENUMX
4226  BFD_RELOC_IA64_DIR32LSB
4227ENUMX
4228  BFD_RELOC_IA64_DIR64MSB
4229ENUMX
4230  BFD_RELOC_IA64_DIR64LSB
4231ENUMX
4232  BFD_RELOC_IA64_GPREL22
4233ENUMX
4234  BFD_RELOC_IA64_GPREL64I
4235ENUMX
4236  BFD_RELOC_IA64_GPREL32MSB
4237ENUMX
4238  BFD_RELOC_IA64_GPREL32LSB
4239ENUMX
4240  BFD_RELOC_IA64_GPREL64MSB
4241ENUMX
4242  BFD_RELOC_IA64_GPREL64LSB
4243ENUMX
4244  BFD_RELOC_IA64_LTOFF22
4245ENUMX
4246  BFD_RELOC_IA64_LTOFF64I
4247ENUMX
4248  BFD_RELOC_IA64_PLTOFF22
4249ENUMX
4250  BFD_RELOC_IA64_PLTOFF64I
4251ENUMX
4252  BFD_RELOC_IA64_PLTOFF64MSB
4253ENUMX
4254  BFD_RELOC_IA64_PLTOFF64LSB
4255ENUMX
4256  BFD_RELOC_IA64_FPTR64I
4257ENUMX
4258  BFD_RELOC_IA64_FPTR32MSB
4259ENUMX
4260  BFD_RELOC_IA64_FPTR32LSB
4261ENUMX
4262  BFD_RELOC_IA64_FPTR64MSB
4263ENUMX
4264  BFD_RELOC_IA64_FPTR64LSB
4265ENUMX
4266  BFD_RELOC_IA64_PCREL21B
4267ENUMX
4268  BFD_RELOC_IA64_PCREL21BI
4269ENUMX
4270  BFD_RELOC_IA64_PCREL21M
4271ENUMX
4272  BFD_RELOC_IA64_PCREL21F
4273ENUMX
4274  BFD_RELOC_IA64_PCREL22
4275ENUMX
4276  BFD_RELOC_IA64_PCREL60B
4277ENUMX
4278  BFD_RELOC_IA64_PCREL64I
4279ENUMX
4280  BFD_RELOC_IA64_PCREL32MSB
4281ENUMX
4282  BFD_RELOC_IA64_PCREL32LSB
4283ENUMX
4284  BFD_RELOC_IA64_PCREL64MSB
4285ENUMX
4286  BFD_RELOC_IA64_PCREL64LSB
4287ENUMX
4288  BFD_RELOC_IA64_LTOFF_FPTR22
4289ENUMX
4290  BFD_RELOC_IA64_LTOFF_FPTR64I
4291ENUMX
4292  BFD_RELOC_IA64_LTOFF_FPTR32MSB
4293ENUMX
4294  BFD_RELOC_IA64_LTOFF_FPTR32LSB
4295ENUMX
4296  BFD_RELOC_IA64_LTOFF_FPTR64MSB
4297ENUMX
4298  BFD_RELOC_IA64_LTOFF_FPTR64LSB
4299ENUMX
4300  BFD_RELOC_IA64_SEGREL32MSB
4301ENUMX
4302  BFD_RELOC_IA64_SEGREL32LSB
4303ENUMX
4304  BFD_RELOC_IA64_SEGREL64MSB
4305ENUMX
4306  BFD_RELOC_IA64_SEGREL64LSB
4307ENUMX
4308  BFD_RELOC_IA64_SECREL32MSB
4309ENUMX
4310  BFD_RELOC_IA64_SECREL32LSB
4311ENUMX
4312  BFD_RELOC_IA64_SECREL64MSB
4313ENUMX
4314  BFD_RELOC_IA64_SECREL64LSB
4315ENUMX
4316  BFD_RELOC_IA64_REL32MSB
4317ENUMX
4318  BFD_RELOC_IA64_REL32LSB
4319ENUMX
4320  BFD_RELOC_IA64_REL64MSB
4321ENUMX
4322  BFD_RELOC_IA64_REL64LSB
4323ENUMX
4324  BFD_RELOC_IA64_LTV32MSB
4325ENUMX
4326  BFD_RELOC_IA64_LTV32LSB
4327ENUMX
4328  BFD_RELOC_IA64_LTV64MSB
4329ENUMX
4330  BFD_RELOC_IA64_LTV64LSB
4331ENUMX
4332  BFD_RELOC_IA64_IPLTMSB
4333ENUMX
4334  BFD_RELOC_IA64_IPLTLSB
4335ENUMX
4336  BFD_RELOC_IA64_COPY
4337ENUMX
4338  BFD_RELOC_IA64_LTOFF22X
4339ENUMX
4340  BFD_RELOC_IA64_LDXMOV
4341ENUMX
4342  BFD_RELOC_IA64_TPREL14
4343ENUMX
4344  BFD_RELOC_IA64_TPREL22
4345ENUMX
4346  BFD_RELOC_IA64_TPREL64I
4347ENUMX
4348  BFD_RELOC_IA64_TPREL64MSB
4349ENUMX
4350  BFD_RELOC_IA64_TPREL64LSB
4351ENUMX
4352  BFD_RELOC_IA64_LTOFF_TPREL22
4353ENUMX
4354  BFD_RELOC_IA64_DTPMOD64MSB
4355ENUMX
4356  BFD_RELOC_IA64_DTPMOD64LSB
4357ENUMX
4358  BFD_RELOC_IA64_LTOFF_DTPMOD22
4359ENUMX
4360  BFD_RELOC_IA64_DTPREL14
4361ENUMX
4362  BFD_RELOC_IA64_DTPREL22
4363ENUMX
4364  BFD_RELOC_IA64_DTPREL64I
4365ENUMX
4366  BFD_RELOC_IA64_DTPREL32MSB
4367ENUMX
4368  BFD_RELOC_IA64_DTPREL32LSB
4369ENUMX
4370  BFD_RELOC_IA64_DTPREL64MSB
4371ENUMX
4372  BFD_RELOC_IA64_DTPREL64LSB
4373ENUMX
4374  BFD_RELOC_IA64_LTOFF_DTPREL22
4375ENUMDOC
4376  Intel IA64 Relocations.
4377
4378ENUM
4379  BFD_RELOC_M68HC11_HI8
4380ENUMDOC
4381  Motorola 68HC11 reloc.
4382  This is the 8 bit high part of an absolute address.
4383ENUM
4384  BFD_RELOC_M68HC11_LO8
4385ENUMDOC
4386  Motorola 68HC11 reloc.
4387  This is the 8 bit low part of an absolute address.
4388ENUM
4389  BFD_RELOC_M68HC11_3B
4390ENUMDOC
4391  Motorola 68HC11 reloc.
4392  This is the 3 bit of a value.
4393ENUM
4394  BFD_RELOC_M68HC11_RL_JUMP
4395ENUMDOC
4396  Motorola 68HC11 reloc.
4397  This reloc marks the beginning of a jump/call instruction.
4398  It is used for linker relaxation to correctly identify beginning
4399  of instruction and change some branches to use PC-relative
4400  addressing mode.
4401ENUM
4402  BFD_RELOC_M68HC11_RL_GROUP
4403ENUMDOC
4404  Motorola 68HC11 reloc.
4405  This reloc marks a group of several instructions that gcc generates
4406  and for which the linker relaxation pass can modify and/or remove
4407  some of them.
4408ENUM
4409  BFD_RELOC_M68HC11_LO16
4410ENUMDOC
4411  Motorola 68HC11 reloc.
4412  This is the 16-bit lower part of an address.  It is used for 'call'
4413  instruction to specify the symbol address without any special
4414  transformation (due to memory bank window).
4415ENUM
4416  BFD_RELOC_M68HC11_PAGE
4417ENUMDOC
4418  Motorola 68HC11 reloc.
4419  This is a 8-bit reloc that specifies the page number of an address.
4420  It is used by 'call' instruction to specify the page number of
4421  the symbol.
4422ENUM
4423  BFD_RELOC_M68HC11_24
4424ENUMDOC
4425  Motorola 68HC11 reloc.
4426  This is a 24-bit reloc that represents the address with a 16-bit
4427  value and a 8-bit page number.  The symbol address is transformed
4428  to follow the 16K memory bank of 68HC12 (seen as mapped in the window).
4429ENUM
4430  BFD_RELOC_M68HC12_5B
4431ENUMDOC
4432  Motorola 68HC12 reloc.
4433  This is the 5 bits of a value.
4434
4435ENUM
4436  BFD_RELOC_16C_NUM08
4437ENUMX
4438  BFD_RELOC_16C_NUM08_C
4439ENUMX
4440  BFD_RELOC_16C_NUM16
4441ENUMX
4442  BFD_RELOC_16C_NUM16_C
4443ENUMX
4444  BFD_RELOC_16C_NUM32
4445ENUMX
4446  BFD_RELOC_16C_NUM32_C
4447ENUMX
4448  BFD_RELOC_16C_DISP04
4449ENUMX
4450  BFD_RELOC_16C_DISP04_C
4451ENUMX
4452  BFD_RELOC_16C_DISP08
4453ENUMX
4454  BFD_RELOC_16C_DISP08_C
4455ENUMX
4456  BFD_RELOC_16C_DISP16
4457ENUMX
4458  BFD_RELOC_16C_DISP16_C
4459ENUMX
4460  BFD_RELOC_16C_DISP24
4461ENUMX
4462  BFD_RELOC_16C_DISP24_C
4463ENUMX
4464  BFD_RELOC_16C_DISP24a
4465ENUMX
4466  BFD_RELOC_16C_DISP24a_C
4467ENUMX
4468  BFD_RELOC_16C_REG04
4469ENUMX
4470  BFD_RELOC_16C_REG04_C
4471ENUMX
4472  BFD_RELOC_16C_REG04a
4473ENUMX
4474  BFD_RELOC_16C_REG04a_C
4475ENUMX
4476  BFD_RELOC_16C_REG14
4477ENUMX
4478  BFD_RELOC_16C_REG14_C
4479ENUMX
4480  BFD_RELOC_16C_REG16
4481ENUMX
4482  BFD_RELOC_16C_REG16_C
4483ENUMX
4484  BFD_RELOC_16C_REG20
4485ENUMX
4486  BFD_RELOC_16C_REG20_C
4487ENUMX
4488  BFD_RELOC_16C_ABS20
4489ENUMX
4490  BFD_RELOC_16C_ABS20_C
4491ENUMX
4492  BFD_RELOC_16C_ABS24
4493ENUMX
4494  BFD_RELOC_16C_ABS24_C
4495ENUMX
4496  BFD_RELOC_16C_IMM04
4497ENUMX
4498  BFD_RELOC_16C_IMM04_C
4499ENUMX
4500  BFD_RELOC_16C_IMM16
4501ENUMX
4502  BFD_RELOC_16C_IMM16_C
4503ENUMX
4504  BFD_RELOC_16C_IMM20
4505ENUMX
4506  BFD_RELOC_16C_IMM20_C
4507ENUMX
4508  BFD_RELOC_16C_IMM24
4509ENUMX
4510  BFD_RELOC_16C_IMM24_C
4511ENUMX
4512  BFD_RELOC_16C_IMM32
4513ENUMX
4514  BFD_RELOC_16C_IMM32_C
4515ENUMDOC
4516  NS CR16C Relocations.
4517
4518ENUM
4519  BFD_RELOC_CR16_NUM8
4520ENUMX
4521  BFD_RELOC_CR16_NUM16
4522ENUMX
4523  BFD_RELOC_CR16_NUM32
4524ENUMX
4525  BFD_RELOC_CR16_NUM32a
4526ENUMX
4527  BFD_RELOC_CR16_REGREL0
4528ENUMX
4529  BFD_RELOC_CR16_REGREL4
4530ENUMX
4531  BFD_RELOC_CR16_REGREL4a
4532ENUMX
4533  BFD_RELOC_CR16_REGREL14
4534ENUMX
4535  BFD_RELOC_CR16_REGREL14a
4536ENUMX
4537  BFD_RELOC_CR16_REGREL16
4538ENUMX
4539  BFD_RELOC_CR16_REGREL20
4540ENUMX
4541  BFD_RELOC_CR16_REGREL20a
4542ENUMX
4543  BFD_RELOC_CR16_ABS20
4544ENUMX
4545  BFD_RELOC_CR16_ABS24
4546ENUMX
4547  BFD_RELOC_CR16_IMM4
4548ENUMX
4549  BFD_RELOC_CR16_IMM8
4550ENUMX
4551  BFD_RELOC_CR16_IMM16
4552ENUMX
4553  BFD_RELOC_CR16_IMM20
4554ENUMX
4555  BFD_RELOC_CR16_IMM24
4556ENUMX
4557  BFD_RELOC_CR16_IMM32
4558ENUMX
4559  BFD_RELOC_CR16_IMM32a
4560ENUMX
4561  BFD_RELOC_CR16_DISP4
4562ENUMX
4563  BFD_RELOC_CR16_DISP8
4564ENUMX
4565  BFD_RELOC_CR16_DISP16
4566ENUMX
4567  BFD_RELOC_CR16_DISP20
4568ENUMX
4569  BFD_RELOC_CR16_DISP24
4570ENUMX
4571  BFD_RELOC_CR16_DISP24a
4572ENUMDOC
4573  NS CR16 Relocations.
4574
4575ENUM
4576  BFD_RELOC_CRX_REL4
4577ENUMX
4578  BFD_RELOC_CRX_REL8
4579ENUMX
4580  BFD_RELOC_CRX_REL8_CMP
4581ENUMX
4582  BFD_RELOC_CRX_REL16
4583ENUMX
4584  BFD_RELOC_CRX_REL24
4585ENUMX
4586  BFD_RELOC_CRX_REL32
4587ENUMX
4588  BFD_RELOC_CRX_REGREL12
4589ENUMX
4590  BFD_RELOC_CRX_REGREL22
4591ENUMX
4592  BFD_RELOC_CRX_REGREL28
4593ENUMX
4594  BFD_RELOC_CRX_REGREL32
4595ENUMX
4596  BFD_RELOC_CRX_ABS16
4597ENUMX
4598  BFD_RELOC_CRX_ABS32
4599ENUMX
4600  BFD_RELOC_CRX_NUM8
4601ENUMX
4602  BFD_RELOC_CRX_NUM16
4603ENUMX
4604  BFD_RELOC_CRX_NUM32
4605ENUMX
4606  BFD_RELOC_CRX_IMM16
4607ENUMX
4608  BFD_RELOC_CRX_IMM32
4609ENUMX
4610  BFD_RELOC_CRX_SWITCH8
4611ENUMX
4612  BFD_RELOC_CRX_SWITCH16
4613ENUMX
4614  BFD_RELOC_CRX_SWITCH32
4615ENUMDOC
4616  NS CRX Relocations.
4617
4618ENUM
4619  BFD_RELOC_CRIS_BDISP8
4620ENUMX
4621  BFD_RELOC_CRIS_UNSIGNED_5
4622ENUMX
4623  BFD_RELOC_CRIS_SIGNED_6
4624ENUMX
4625  BFD_RELOC_CRIS_UNSIGNED_6
4626ENUMX
4627  BFD_RELOC_CRIS_SIGNED_8
4628ENUMX
4629  BFD_RELOC_CRIS_UNSIGNED_8
4630ENUMX
4631  BFD_RELOC_CRIS_SIGNED_16
4632ENUMX
4633  BFD_RELOC_CRIS_UNSIGNED_16
4634ENUMX
4635  BFD_RELOC_CRIS_LAPCQ_OFFSET
4636ENUMX
4637  BFD_RELOC_CRIS_UNSIGNED_4
4638ENUMDOC
4639  These relocs are only used within the CRIS assembler.  They are not
4640  (at present) written to any object files.
4641ENUM
4642  BFD_RELOC_CRIS_COPY
4643ENUMX
4644  BFD_RELOC_CRIS_GLOB_DAT
4645ENUMX
4646  BFD_RELOC_CRIS_JUMP_SLOT
4647ENUMX
4648  BFD_RELOC_CRIS_RELATIVE
4649ENUMDOC
4650  Relocs used in ELF shared libraries for CRIS.
4651ENUM
4652  BFD_RELOC_CRIS_32_GOT
4653ENUMDOC
4654  32-bit offset to symbol-entry within GOT.
4655ENUM
4656  BFD_RELOC_CRIS_16_GOT
4657ENUMDOC
4658  16-bit offset to symbol-entry within GOT.
4659ENUM
4660  BFD_RELOC_CRIS_32_GOTPLT
4661ENUMDOC
4662  32-bit offset to symbol-entry within GOT, with PLT handling.
4663ENUM
4664  BFD_RELOC_CRIS_16_GOTPLT
4665ENUMDOC
4666  16-bit offset to symbol-entry within GOT, with PLT handling.
4667ENUM
4668  BFD_RELOC_CRIS_32_GOTREL
4669ENUMDOC
4670  32-bit offset to symbol, relative to GOT.
4671ENUM
4672  BFD_RELOC_CRIS_32_PLT_GOTREL
4673ENUMDOC
4674  32-bit offset to symbol with PLT entry, relative to GOT.
4675ENUM
4676  BFD_RELOC_CRIS_32_PLT_PCREL
4677ENUMDOC
4678  32-bit offset to symbol with PLT entry, relative to this relocation.
4679
4680ENUM
4681  BFD_RELOC_860_COPY
4682ENUMX
4683  BFD_RELOC_860_GLOB_DAT
4684ENUMX
4685  BFD_RELOC_860_JUMP_SLOT
4686ENUMX
4687  BFD_RELOC_860_RELATIVE
4688ENUMX
4689  BFD_RELOC_860_PC26
4690ENUMX
4691  BFD_RELOC_860_PLT26
4692ENUMX
4693  BFD_RELOC_860_PC16
4694ENUMX
4695  BFD_RELOC_860_LOW0
4696ENUMX
4697  BFD_RELOC_860_SPLIT0
4698ENUMX
4699  BFD_RELOC_860_LOW1
4700ENUMX
4701  BFD_RELOC_860_SPLIT1
4702ENUMX
4703  BFD_RELOC_860_LOW2
4704ENUMX
4705  BFD_RELOC_860_SPLIT2
4706ENUMX
4707  BFD_RELOC_860_LOW3
4708ENUMX
4709  BFD_RELOC_860_LOGOT0
4710ENUMX
4711  BFD_RELOC_860_SPGOT0
4712ENUMX
4713  BFD_RELOC_860_LOGOT1
4714ENUMX
4715  BFD_RELOC_860_SPGOT1
4716ENUMX
4717  BFD_RELOC_860_LOGOTOFF0
4718ENUMX
4719  BFD_RELOC_860_SPGOTOFF0
4720ENUMX
4721  BFD_RELOC_860_LOGOTOFF1
4722ENUMX
4723  BFD_RELOC_860_SPGOTOFF1
4724ENUMX
4725  BFD_RELOC_860_LOGOTOFF2
4726ENUMX
4727  BFD_RELOC_860_LOGOTOFF3
4728ENUMX
4729  BFD_RELOC_860_LOPC
4730ENUMX
4731  BFD_RELOC_860_HIGHADJ
4732ENUMX
4733  BFD_RELOC_860_HAGOT
4734ENUMX
4735  BFD_RELOC_860_HAGOTOFF
4736ENUMX
4737  BFD_RELOC_860_HAPC
4738ENUMX
4739  BFD_RELOC_860_HIGH
4740ENUMX
4741  BFD_RELOC_860_HIGOT
4742ENUMX
4743  BFD_RELOC_860_HIGOTOFF
4744ENUMDOC
4745  Intel i860 Relocations.
4746
4747ENUM
4748  BFD_RELOC_OPENRISC_ABS_26
4749ENUMX
4750  BFD_RELOC_OPENRISC_REL_26
4751ENUMDOC
4752  OpenRISC Relocations.
4753
4754ENUM
4755  BFD_RELOC_H8_DIR16A8
4756ENUMX
4757  BFD_RELOC_H8_DIR16R8
4758ENUMX
4759  BFD_RELOC_H8_DIR24A8
4760ENUMX
4761  BFD_RELOC_H8_DIR24R8
4762ENUMX
4763  BFD_RELOC_H8_DIR32A16
4764ENUMDOC
4765  H8 elf Relocations.
4766
4767ENUM
4768  BFD_RELOC_XSTORMY16_REL_12
4769ENUMX
4770  BFD_RELOC_XSTORMY16_12
4771ENUMX
4772  BFD_RELOC_XSTORMY16_24
4773ENUMX
4774  BFD_RELOC_XSTORMY16_FPTR16
4775ENUMDOC
4776  Sony Xstormy16 Relocations.
4777
4778ENUM
4779  BFD_RELOC_RELC
4780ENUMDOC
4781  Self-describing complex relocations.
4782COMMENT
4783
4784ENUM
4785  BFD_RELOC_XC16X_PAG
4786ENUMX
4787  BFD_RELOC_XC16X_POF
4788ENUMX
4789  BFD_RELOC_XC16X_SEG
4790ENUMX
4791  BFD_RELOC_XC16X_SOF
4792ENUMDOC
4793  Infineon Relocations.
4794
4795ENUM
4796  BFD_RELOC_VAX_GLOB_DAT
4797ENUMX
4798  BFD_RELOC_VAX_JMP_SLOT
4799ENUMX
4800  BFD_RELOC_VAX_RELATIVE
4801ENUMDOC
4802  Relocations used by VAX ELF.
4803
4804ENUM
4805  BFD_RELOC_MT_PC16
4806ENUMDOC
4807  Morpho MT - 16 bit immediate relocation.
4808ENUM
4809  BFD_RELOC_MT_HI16
4810ENUMDOC
4811  Morpho MT - Hi 16 bits of an address.
4812ENUM
4813  BFD_RELOC_MT_LO16
4814ENUMDOC
4815  Morpho MT - Low 16 bits of an address.
4816ENUM
4817  BFD_RELOC_MT_GNU_VTINHERIT
4818ENUMDOC
4819  Morpho MT - Used to tell the linker which vtable entries are used.
4820ENUM
4821  BFD_RELOC_MT_GNU_VTENTRY
4822ENUMDOC
4823  Morpho MT - Used to tell the linker which vtable entries are used.
4824ENUM
4825  BFD_RELOC_MT_PCINSN8
4826ENUMDOC
4827  Morpho MT - 8 bit immediate relocation.
4828
4829ENUM
4830  BFD_RELOC_MSP430_10_PCREL
4831ENUMX
4832  BFD_RELOC_MSP430_16_PCREL
4833ENUMX
4834  BFD_RELOC_MSP430_16
4835ENUMX
4836  BFD_RELOC_MSP430_16_PCREL_BYTE
4837ENUMX
4838  BFD_RELOC_MSP430_16_BYTE
4839ENUMX
4840  BFD_RELOC_MSP430_2X_PCREL
4841ENUMX
4842  BFD_RELOC_MSP430_RL_PCREL
4843ENUMDOC
4844  msp430 specific relocation codes
4845
4846ENUM
4847  BFD_RELOC_IQ2000_OFFSET_16
4848ENUMX
4849  BFD_RELOC_IQ2000_OFFSET_21
4850ENUMX
4851  BFD_RELOC_IQ2000_UHI16
4852ENUMDOC
4853  IQ2000 Relocations.
4854
4855ENUM
4856  BFD_RELOC_XTENSA_RTLD
4857ENUMDOC
4858  Special Xtensa relocation used only by PLT entries in ELF shared
4859  objects to indicate that the runtime linker should set the value
4860  to one of its own internal functions or data structures.
4861ENUM
4862  BFD_RELOC_XTENSA_GLOB_DAT
4863ENUMX
4864  BFD_RELOC_XTENSA_JMP_SLOT
4865ENUMX
4866  BFD_RELOC_XTENSA_RELATIVE
4867ENUMDOC
4868  Xtensa relocations for ELF shared objects.
4869ENUM
4870  BFD_RELOC_XTENSA_PLT
4871ENUMDOC
4872  Xtensa relocation used in ELF object files for symbols that may require
4873  PLT entries.  Otherwise, this is just a generic 32-bit relocation.
4874ENUM
4875  BFD_RELOC_XTENSA_DIFF8
4876ENUMX
4877  BFD_RELOC_XTENSA_DIFF16
4878ENUMX
4879  BFD_RELOC_XTENSA_DIFF32
4880ENUMDOC
4881  Xtensa relocations to mark the difference of two local symbols.
4882  These are only needed to support linker relaxation and can be ignored
4883  when not relaxing.  The field is set to the value of the difference
4884  assuming no relaxation.  The relocation encodes the position of the
4885  first symbol so the linker can determine whether to adjust the field
4886  value.
4887ENUM
4888  BFD_RELOC_XTENSA_SLOT0_OP
4889ENUMX
4890  BFD_RELOC_XTENSA_SLOT1_OP
4891ENUMX
4892  BFD_RELOC_XTENSA_SLOT2_OP
4893ENUMX
4894  BFD_RELOC_XTENSA_SLOT3_OP
4895ENUMX
4896  BFD_RELOC_XTENSA_SLOT4_OP
4897ENUMX
4898  BFD_RELOC_XTENSA_SLOT5_OP
4899ENUMX
4900  BFD_RELOC_XTENSA_SLOT6_OP
4901ENUMX
4902  BFD_RELOC_XTENSA_SLOT7_OP
4903ENUMX
4904  BFD_RELOC_XTENSA_SLOT8_OP
4905ENUMX
4906  BFD_RELOC_XTENSA_SLOT9_OP
4907ENUMX
4908  BFD_RELOC_XTENSA_SLOT10_OP
4909ENUMX
4910  BFD_RELOC_XTENSA_SLOT11_OP
4911ENUMX
4912  BFD_RELOC_XTENSA_SLOT12_OP
4913ENUMX
4914  BFD_RELOC_XTENSA_SLOT13_OP
4915ENUMX
4916  BFD_RELOC_XTENSA_SLOT14_OP
4917ENUMDOC
4918  Generic Xtensa relocations for instruction operands.  Only the slot
4919  number is encoded in the relocation.  The relocation applies to the
4920  last PC-relative immediate operand, or if there are no PC-relative
4921  immediates, to the last immediate operand.
4922ENUM
4923  BFD_RELOC_XTENSA_SLOT0_ALT
4924ENUMX
4925  BFD_RELOC_XTENSA_SLOT1_ALT
4926ENUMX
4927  BFD_RELOC_XTENSA_SLOT2_ALT
4928ENUMX
4929  BFD_RELOC_XTENSA_SLOT3_ALT
4930ENUMX
4931  BFD_RELOC_XTENSA_SLOT4_ALT
4932ENUMX
4933  BFD_RELOC_XTENSA_SLOT5_ALT
4934ENUMX
4935  BFD_RELOC_XTENSA_SLOT6_ALT
4936ENUMX
4937  BFD_RELOC_XTENSA_SLOT7_ALT
4938ENUMX
4939  BFD_RELOC_XTENSA_SLOT8_ALT
4940ENUMX
4941  BFD_RELOC_XTENSA_SLOT9_ALT
4942ENUMX
4943  BFD_RELOC_XTENSA_SLOT10_ALT
4944ENUMX
4945  BFD_RELOC_XTENSA_SLOT11_ALT
4946ENUMX
4947  BFD_RELOC_XTENSA_SLOT12_ALT
4948ENUMX
4949  BFD_RELOC_XTENSA_SLOT13_ALT
4950ENUMX
4951  BFD_RELOC_XTENSA_SLOT14_ALT
4952ENUMDOC
4953  Alternate Xtensa relocations.  Only the slot is encoded in the
4954  relocation.  The meaning of these relocations is opcode-specific.
4955ENUM
4956  BFD_RELOC_XTENSA_OP0
4957ENUMX
4958  BFD_RELOC_XTENSA_OP1
4959ENUMX
4960  BFD_RELOC_XTENSA_OP2
4961ENUMDOC
4962  Xtensa relocations for backward compatibility.  These have all been
4963  replaced by BFD_RELOC_XTENSA_SLOT0_OP.
4964ENUM
4965  BFD_RELOC_XTENSA_ASM_EXPAND
4966ENUMDOC
4967  Xtensa relocation to mark that the assembler expanded the
4968  instructions from an original target.  The expansion size is
4969  encoded in the reloc size.
4970ENUM
4971  BFD_RELOC_XTENSA_ASM_SIMPLIFY
4972ENUMDOC
4973  Xtensa relocation to mark that the linker should simplify
4974  assembler-expanded instructions.  This is commonly used
4975  internally by the linker after analysis of a
4976  BFD_RELOC_XTENSA_ASM_EXPAND.
4977
4978ENUM
4979  BFD_RELOC_Z80_DISP8
4980ENUMDOC
4981  8 bit signed offset in (ix+d) or (iy+d).
4982
4983ENUM
4984  BFD_RELOC_Z8K_DISP7
4985ENUMDOC
4986  DJNZ offset.
4987ENUM
4988  BFD_RELOC_Z8K_CALLR
4989ENUMDOC
4990  CALR offset.
4991ENUM
4992  BFD_RELOC_Z8K_IMM4L
4993ENUMDOC
4994  4 bit value.
4995
4996ENDSENUM
4997  BFD_RELOC_UNUSED
4998CODE_FRAGMENT
4999.
5000.typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
5001*/
5002
5003/*
5004FUNCTION
5005	bfd_reloc_type_lookup
5006	bfd_reloc_name_lookup
5007
5008SYNOPSIS
5009	reloc_howto_type *bfd_reloc_type_lookup
5010	  (bfd *abfd, bfd_reloc_code_real_type code);
5011	reloc_howto_type *bfd_reloc_name_lookup
5012	  (bfd *abfd, const char *reloc_name);
5013
5014DESCRIPTION
5015	Return a pointer to a howto structure which, when
5016	invoked, will perform the relocation @var{code} on data from the
5017	architecture noted.
5018
5019*/
5020
5021reloc_howto_type *
5022bfd_reloc_type_lookup (bfd *abfd, bfd_reloc_code_real_type code)
5023{
5024  return BFD_SEND (abfd, reloc_type_lookup, (abfd, code));
5025}
5026
5027reloc_howto_type *
5028bfd_reloc_name_lookup (bfd *abfd, const char *reloc_name)
5029{
5030  return BFD_SEND (abfd, reloc_name_lookup, (abfd, reloc_name));
5031}
5032
5033static reloc_howto_type bfd_howto_32 =
5034HOWTO (0, 00, 2, 32, FALSE, 0, complain_overflow_dont, 0, "VRT32", FALSE, 0xffffffff, 0xffffffff, TRUE);
5035
5036/*
5037INTERNAL_FUNCTION
5038	bfd_default_reloc_type_lookup
5039
5040SYNOPSIS
5041	reloc_howto_type *bfd_default_reloc_type_lookup
5042	  (bfd *abfd, bfd_reloc_code_real_type  code);
5043
5044DESCRIPTION
5045	Provides a default relocation lookup routine for any architecture.
5046
5047*/
5048
5049reloc_howto_type *
5050bfd_default_reloc_type_lookup (bfd *abfd, bfd_reloc_code_real_type code)
5051{
5052  switch (code)
5053    {
5054    case BFD_RELOC_CTOR:
5055      /* The type of reloc used in a ctor, which will be as wide as the
5056	 address - so either a 64, 32, or 16 bitter.  */
5057      switch (bfd_get_arch_info (abfd)->bits_per_address)
5058	{
5059	case 64:
5060	  BFD_FAIL ();
5061	case 32:
5062	  return &bfd_howto_32;
5063	case 16:
5064	  BFD_FAIL ();
5065	default:
5066	  BFD_FAIL ();
5067	}
5068    default:
5069      BFD_FAIL ();
5070    }
5071  return NULL;
5072}
5073
5074/*
5075FUNCTION
5076	bfd_get_reloc_code_name
5077
5078SYNOPSIS
5079	const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code);
5080
5081DESCRIPTION
5082	Provides a printable name for the supplied relocation code.
5083	Useful mainly for printing error messages.
5084*/
5085
5086const char *
5087bfd_get_reloc_code_name (bfd_reloc_code_real_type code)
5088{
5089  if (code > BFD_RELOC_UNUSED)
5090    return 0;
5091  return bfd_reloc_code_real_names[code];
5092}
5093
5094/*
5095INTERNAL_FUNCTION
5096	bfd_generic_relax_section
5097
5098SYNOPSIS
5099	bfd_boolean bfd_generic_relax_section
5100	  (bfd *abfd,
5101	   asection *section,
5102	   struct bfd_link_info *,
5103	   bfd_boolean *);
5104
5105DESCRIPTION
5106	Provides default handling for relaxing for back ends which
5107	don't do relaxing.
5108*/
5109
5110bfd_boolean
5111bfd_generic_relax_section (bfd *abfd ATTRIBUTE_UNUSED,
5112			   asection *section ATTRIBUTE_UNUSED,
5113			   struct bfd_link_info *link_info ATTRIBUTE_UNUSED,
5114			   bfd_boolean *again)
5115{
5116  *again = FALSE;
5117  return TRUE;
5118}
5119
5120/*
5121INTERNAL_FUNCTION
5122	bfd_generic_gc_sections
5123
5124SYNOPSIS
5125	bfd_boolean bfd_generic_gc_sections
5126	  (bfd *, struct bfd_link_info *);
5127
5128DESCRIPTION
5129	Provides default handling for relaxing for back ends which
5130	don't do section gc -- i.e., does nothing.
5131*/
5132
5133bfd_boolean
5134bfd_generic_gc_sections (bfd *abfd ATTRIBUTE_UNUSED,
5135			 struct bfd_link_info *info ATTRIBUTE_UNUSED)
5136{
5137  return TRUE;
5138}
5139
5140/*
5141INTERNAL_FUNCTION
5142	bfd_generic_merge_sections
5143
5144SYNOPSIS
5145	bfd_boolean bfd_generic_merge_sections
5146	  (bfd *, struct bfd_link_info *);
5147
5148DESCRIPTION
5149	Provides default handling for SEC_MERGE section merging for back ends
5150	which don't have SEC_MERGE support -- i.e., does nothing.
5151*/
5152
5153bfd_boolean
5154bfd_generic_merge_sections (bfd *abfd ATTRIBUTE_UNUSED,
5155			    struct bfd_link_info *link_info ATTRIBUTE_UNUSED)
5156{
5157  return TRUE;
5158}
5159
5160/*
5161INTERNAL_FUNCTION
5162	bfd_generic_get_relocated_section_contents
5163
5164SYNOPSIS
5165	bfd_byte *bfd_generic_get_relocated_section_contents
5166	  (bfd *abfd,
5167	   struct bfd_link_info *link_info,
5168	   struct bfd_link_order *link_order,
5169	   bfd_byte *data,
5170	   bfd_boolean relocatable,
5171	   asymbol **symbols);
5172
5173DESCRIPTION
5174	Provides default handling of relocation effort for back ends
5175	which can't be bothered to do it efficiently.
5176
5177*/
5178
5179bfd_byte *
5180bfd_generic_get_relocated_section_contents (bfd *abfd,
5181					    struct bfd_link_info *link_info,
5182					    struct bfd_link_order *link_order,
5183					    bfd_byte *data,
5184					    bfd_boolean relocatable,
5185					    asymbol **symbols)
5186{
5187  /* Get enough memory to hold the stuff.  */
5188  bfd *input_bfd = link_order->u.indirect.section->owner;
5189  asection *input_section = link_order->u.indirect.section;
5190
5191  long reloc_size = bfd_get_reloc_upper_bound (input_bfd, input_section);
5192  arelent **reloc_vector = NULL;
5193  long reloc_count;
5194  bfd_size_type sz;
5195
5196  if (reloc_size < 0)
5197    goto error_return;
5198
5199  reloc_vector = bfd_malloc (reloc_size);
5200  if (reloc_vector == NULL && reloc_size != 0)
5201    goto error_return;
5202
5203  /* Read in the section.  */
5204  sz = input_section->rawsize ? input_section->rawsize : input_section->size;
5205  if (!bfd_get_section_contents (input_bfd, input_section, data, 0, sz))
5206    goto error_return;
5207
5208  reloc_count = bfd_canonicalize_reloc (input_bfd,
5209					input_section,
5210					reloc_vector,
5211					symbols);
5212  if (reloc_count < 0)
5213    goto error_return;
5214
5215  if (reloc_count > 0)
5216    {
5217      arelent **parent;
5218      for (parent = reloc_vector; *parent != NULL; parent++)
5219	{
5220	  char *error_message = NULL;
5221	  asymbol *symbol;
5222	  bfd_reloc_status_type r;
5223
5224	  symbol = *(*parent)->sym_ptr_ptr;
5225	  if (symbol->section && elf_discarded_section (symbol->section))
5226	    {
5227	      bfd_byte *p;
5228	      static reloc_howto_type none_howto
5229		= HOWTO (0, 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL,
5230			 "unused", FALSE, 0, 0, FALSE);
5231
5232	      p = data + (*parent)->address * bfd_octets_per_byte (input_bfd);
5233	      _bfd_clear_contents ((*parent)->howto, input_bfd, p);
5234	      (*parent)->sym_ptr_ptr = bfd_abs_section.symbol_ptr_ptr;
5235	      (*parent)->addend = 0;
5236	      (*parent)->howto = &none_howto;
5237	      r = bfd_reloc_ok;
5238	    }
5239	  else
5240	    r = bfd_perform_relocation (input_bfd,
5241					*parent,
5242					data,
5243					input_section,
5244					relocatable ? abfd : NULL,
5245					&error_message);
5246
5247	  if (relocatable)
5248	    {
5249	      asection *os = input_section->output_section;
5250
5251	      /* A partial link, so keep the relocs.  */
5252	      os->orelocation[os->reloc_count] = *parent;
5253	      os->reloc_count++;
5254	    }
5255
5256	  if (r != bfd_reloc_ok)
5257	    {
5258	      switch (r)
5259		{
5260		case bfd_reloc_undefined:
5261		  if (!((*link_info->callbacks->undefined_symbol)
5262			(link_info, bfd_asymbol_name (*(*parent)->sym_ptr_ptr),
5263			 input_bfd, input_section, (*parent)->address,
5264			 TRUE)))
5265		    goto error_return;
5266		  break;
5267		case bfd_reloc_dangerous:
5268		  BFD_ASSERT (error_message != NULL);
5269		  if (!((*link_info->callbacks->reloc_dangerous)
5270			(link_info, error_message, input_bfd, input_section,
5271			 (*parent)->address)))
5272		    goto error_return;
5273		  break;
5274		case bfd_reloc_overflow:
5275		  if (!((*link_info->callbacks->reloc_overflow)
5276			(link_info, NULL,
5277			 bfd_asymbol_name (*(*parent)->sym_ptr_ptr),
5278			 (*parent)->howto->name, (*parent)->addend,
5279			 input_bfd, input_section, (*parent)->address)))
5280		    goto error_return;
5281		  break;
5282		case bfd_reloc_outofrange:
5283		default:
5284		  abort ();
5285		  break;
5286		}
5287
5288	    }
5289	}
5290    }
5291  if (reloc_vector != NULL)
5292    free (reloc_vector);
5293  return data;
5294
5295error_return:
5296  if (reloc_vector != NULL)
5297    free (reloc_vector);
5298  return NULL;
5299}
5300