bfd.info revision 1.2
1This is bfd.info, produced by makeinfo version 6.7 from bfd.texi.
2
3This file documents the BFD library.
4
5   Copyright (C) 1991-2022 Free Software Foundation, Inc.
6
7   Permission is granted to copy, distribute and/or modify this document
8under the terms of the GNU Free Documentation License, Version 1.3 or
9any later version published by the Free Software Foundation; with the
10Invariant Sections being "GNU General Public License" and "Funding Free
11Software", the Front-Cover texts being (a) (see below), and with the
12Back-Cover Texts being (b) (see below).  A copy of the license is
13included in the section entitled "GNU Free Documentation License".
14
15   (a) The FSF's Front-Cover Text is:
16
17   A GNU Manual
18
19   (b) The FSF's Back-Cover Text is:
20
21   You have freedom to copy and modify this GNU Manual, like GNU
22software.  Copies published by the Free Software Foundation raise funds
23for GNU development.
24INFO-DIR-SECTION Software development
25START-INFO-DIR-ENTRY
26* Bfd: (bfd).                   The Binary File Descriptor library.
27END-INFO-DIR-ENTRY
28
29
30File: bfd.info,  Node: Top,  Next: Overview,  Prev: (dir),  Up: (dir)
31
32This file documents the binary file descriptor library libbfd.
33
34* Menu:
35
36* Overview::			Overview of BFD
37* BFD front end::		BFD front end
38* BFD back ends::		BFD back ends
39* GNU Free Documentation License::  GNU Free Documentation License
40* BFD Index::		BFD Index
41
42
43File: bfd.info,  Node: Overview,  Next: BFD front end,  Prev: Top,  Up: Top
44
451 Introduction
46**************
47
48BFD is a package which allows applications to use the same routines to
49operate on object files whatever the object file format.  A new object
50file format can be supported simply by creating a new BFD back end and
51adding it to the library.
52
53   BFD is split into two parts: the front end, and the back ends (one
54for each object file format).
55   * The front end of BFD provides the interface to the user.  It
56     manages memory and various canonical data structures.  The front
57     end also decides which back end to use and when to call back end
58     routines.
59   * The back ends provide BFD its view of the real world.  Each back
60     end provides a set of calls which the BFD front end can use to
61     maintain its canonical form.  The back ends also may keep around
62     information for their own use, for greater efficiency.
63* Menu:
64
65* History::			History
66* How It Works::		How It Works
67* What BFD Version 2 Can Do::	What BFD Version 2 Can Do
68
69
70File: bfd.info,  Node: History,  Next: How It Works,  Prev: Overview,  Up: Overview
71
721.1 History
73===========
74
75One spur behind BFD was the desire, on the part of the GNU 960 team at
76Intel Oregon, for interoperability of applications on their COFF and
77b.out file formats.  Cygnus was providing GNU support for the team, and
78was contracted to provide the required functionality.
79
80   The name came from a conversation David Wallace was having with
81Richard Stallman about the library: RMS said that it would be quite
82hard--David said "BFD". Stallman was right, but the name stuck.
83
84   At the same time, Ready Systems wanted much the same thing, but for
85different object file formats: IEEE-695, Oasys, Srecords, a.out and 68k
86coff.
87
88   BFD was first implemented by members of Cygnus Support; Steve
89Chamberlain ('sac@cygnus.com'), John Gilmore ('gnu@cygnus.com'), K.
90Richard Pixley ('rich@cygnus.com') and David Henkel-Wallace
91('gumby@cygnus.com').
92
93
94File: bfd.info,  Node: How It Works,  Next: What BFD Version 2 Can Do,  Prev: History,  Up: Overview
95
961.2 How To Use BFD
97==================
98
99To use the library, include 'bfd.h' and link with 'libbfd.a'.
100
101   BFD provides a common interface to the parts of an object file for a
102calling application.
103
104   When an application successfully opens a target file (object,
105archive, or whatever), a pointer to an internal structure is returned.
106This pointer points to a structure called 'bfd', described in 'bfd.h'.
107Our convention is to call this pointer a BFD, and instances of it within
108code 'abfd'.  All operations on the target object file are applied as
109methods to the BFD. The mapping is defined within 'bfd.h' in a set of
110macros, all beginning with 'bfd_' to reduce namespace pollution.
111
112   For example, this sequence does what you would probably expect:
113return the number of sections in an object file attached to a BFD
114'abfd'.
115
116     #include "bfd.h"
117
118     unsigned int number_of_sections (abfd)
119     bfd *abfd;
120     {
121       return bfd_count_sections (abfd);
122     }
123
124   The abstraction used within BFD is that an object file has:
125
126   * a header,
127   * a number of sections containing raw data (*note Sections::),
128   * a set of relocations (*note Relocations::), and
129   * some symbol information (*note Symbols::).
130Also, BFDs opened for archives have the additional attribute of an index
131and contain subordinate BFDs.  This approach is fine for a.out and coff,
132but loses efficiency when applied to formats such as S-records and
133IEEE-695.
134
135
136File: bfd.info,  Node: What BFD Version 2 Can Do,  Prev: How It Works,  Up: Overview
137
1381.3 What BFD Version 2 Can Do
139=============================
140
141When an object file is opened, BFD subroutines automatically determine
142the format of the input object file.  They then build a descriptor in
143memory with pointers to routines that will be used to access elements of
144the object file's data structures.
145
146   As different information from the object files is required, BFD reads
147from different sections of the file and processes them.  For example, a
148very common operation for the linker is processing symbol tables.  Each
149BFD back end provides a routine for converting between the object file's
150representation of symbols and an internal canonical format.  When the
151linker asks for the symbol table of an object file, it calls through a
152memory pointer to the routine from the relevant BFD back end which reads
153and converts the table into a canonical form.  The linker then operates
154upon the canonical form.  When the link is finished and the linker
155writes the output file's symbol table, another BFD back end routine is
156called to take the newly created symbol table and convert it into the
157chosen output format.
158
159* Menu:
160
161* BFD information loss::	Information Loss
162* Canonical format::		The BFD	canonical object-file format
163
164
165File: bfd.info,  Node: BFD information loss,  Next: Canonical format,  Up: What BFD Version 2 Can Do
166
1671.3.1 Information Loss
168----------------------
169
170_Information can be lost during output._  The output formats supported
171by BFD do not provide identical facilities, and information which can be
172described in one form has nowhere to go in another format.  One example
173of this is alignment information in 'b.out'.  There is nowhere in an
174'a.out' format file to store alignment information on the contained
175data, so when a file is linked from 'b.out' and an 'a.out' image is
176produced, alignment information will not propagate to the output file.
177(The linker will still use the alignment information internally, so the
178link is performed correctly).
179
180   Another example is COFF section names.  COFF files may contain an
181unlimited number of sections, each one with a textual section name.  If
182the target of the link is a format which does not have many sections
183(e.g., 'a.out') or has sections without names (e.g., the Oasys format),
184the link cannot be done simply.  You can circumvent this problem by
185describing the desired input-to-output section mapping with the linker
186command language.
187
188   _Information can be lost during canonicalization._  The BFD internal
189canonical form of the external formats is not exhaustive; there are
190structures in input formats for which there is no direct representation
191internally.  This means that the BFD back ends cannot maintain all
192possible data richness through the transformation between external to
193internal and back to external formats.
194
195   This limitation is only a problem when an application reads one
196format and writes another.  Each BFD back end is responsible for
197maintaining as much data as possible, and the internal BFD canonical
198form has structures which are opaque to the BFD core, and exported only
199to the back ends.  When a file is read in one format, the canonical form
200is generated for BFD and the application.  At the same time, the back
201end saves away any information which may otherwise be lost.  If the data
202is then written back in the same format, the back end routine will be
203able to use the canonical form provided by the BFD core as well as the
204information it prepared earlier.  Since there is a great deal of
205commonality between back ends, there is no information lost when linking
206or copying big endian COFF to little endian COFF, or 'a.out' to 'b.out'.
207When a mixture of formats is linked, the information is only lost from
208the files whose format differs from the destination.
209
210
211File: bfd.info,  Node: Canonical format,  Prev: BFD information loss,  Up: What BFD Version 2 Can Do
212
2131.3.2 The BFD canonical object-file format
214------------------------------------------
215
216The greatest potential for loss of information occurs when there is the
217least overlap between the information provided by the source format,
218that stored by the canonical format, and that needed by the destination
219format.  A brief description of the canonical form may help you
220understand which kinds of data you can count on preserving across
221conversions.
222
223_files_
224     Information stored on a per-file basis includes target machine
225     architecture, particular implementation format type, a demand
226     pageable bit, and a write protected bit.  Information like Unix
227     magic numbers is not stored here--only the magic numbers' meaning,
228     so a 'ZMAGIC' file would have both the demand pageable bit and the
229     write protected text bit set.  The byte order of the target is
230     stored on a per-file basis, so that big- and little-endian object
231     files may be used with one another.
232
233_sections_
234     Each section in the input file contains the name of the section,
235     the section's original address in the object file, size and
236     alignment information, various flags, and pointers into other BFD
237     data structures.
238
239_symbols_
240     Each symbol contains a pointer to the information for the object
241     file which originally defined it, its name, its value, and various
242     flag bits.  When a BFD back end reads in a symbol table, it
243     relocates all symbols to make them relative to the base of the
244     section where they were defined.  Doing this ensures that each
245     symbol points to its containing section.  Each symbol also has a
246     varying amount of hidden private data for the BFD back end.  Since
247     the symbol points to the original file, the private data format for
248     that symbol is accessible.  'ld' can operate on a collection of
249     symbols of wildly different formats without problems.
250
251     Normal global and simple local symbols are maintained on output, so
252     an output file (no matter its format) will retain symbols pointing
253     to functions and to global, static, and common variables.  Some
254     symbol information is not worth retaining; in 'a.out', type
255     information is stored in the symbol table as long symbol names.
256     This information would be useless to most COFF debuggers; the
257     linker has command-line switches to allow users to throw it away.
258
259     There is one word of type information within the symbol, so if the
260     format supports symbol type information within symbols (for
261     example, COFF, Oasys) and the type is simple enough to fit within
262     one word (nearly everything but aggregates), the information will
263     be preserved.
264
265_relocation level_
266     Each canonical BFD relocation record contains a pointer to the
267     symbol to relocate to, the offset of the data to relocate, the
268     section the data is in, and a pointer to a relocation type
269     descriptor.  Relocation is performed by passing messages through
270     the relocation type descriptor and the symbol pointer.  Therefore,
271     relocations can be performed on output data using a relocation
272     method that is only available in one of the input formats.  For
273     instance, Oasys provides a byte relocation format.  A relocation
274     record requesting this relocation type would point indirectly to a
275     routine to perform this, so the relocation may be performed on a
276     byte being written to a 68k COFF file, even though 68k COFF has no
277     such relocation type.
278
279_line numbers_
280     Object formats can contain, for debugging purposes, some form of
281     mapping between symbols, source line numbers, and addresses in the
282     output file.  These addresses have to be relocated along with the
283     symbol information.  Each symbol with an associated list of line
284     number records points to the first record of the list.  The head of
285     a line number list consists of a pointer to the symbol, which
286     allows finding out the address of the function whose line number is
287     being described.  The rest of the list is made up of pairs: offsets
288     into the section and line numbers.  Any format which can simply
289     derive this information can pass it successfully between formats.
290
291
292File: bfd.info,  Node: BFD front end,  Next: BFD back ends,  Prev: Overview,  Up: Top
293
2942 BFD Front End
295***************
296
297* Menu:
298
299* typedef bfd::
300* Error reporting::
301* Miscellaneous::
302* Memory Usage::
303* Initialization::
304* Sections::
305* Symbols::
306* Archives::
307* Formats::
308* Relocations::
309* Core Files::
310* Targets::
311* Architectures::
312* Opening and Closing::
313* Internal::
314* File Caching::
315* Linker Functions::
316* Hash Tables::
317
318
319File: bfd.info,  Node: typedef bfd,  Next: Error reporting,  Prev: BFD front end,  Up: BFD front end
320
3212.1 'typedef bfd'
322=================
323
324A BFD has type 'bfd'; objects of this type are the cornerstone of any
325application using BFD. Using BFD consists of making references though
326the BFD and to data in the BFD.
327
328   Here is the structure that defines the type 'bfd'.  It contains the
329major data about the file and pointers to the rest of the data.
330
331
332     enum bfd_direction
333       {
334         no_direction = 0,
335         read_direction = 1,
336         write_direction = 2,
337         both_direction = 3
338       };
339
340     enum bfd_plugin_format
341       {
342         bfd_plugin_unknown = 0,
343         bfd_plugin_yes = 1,
344         bfd_plugin_no = 2
345       };
346
347     struct bfd_build_id
348       {
349         bfd_size_type size;
350         bfd_byte data[1];
351       };
352
353     struct bfd
354     {
355       /* The filename the application opened the BFD with.  */
356       const char *filename;
357
358       /* A pointer to the target jump table.  */
359       const struct bfd_target *xvec;
360
361       /* The IOSTREAM, and corresponding IO vector that provide access
362          to the file backing the BFD.  */
363       void *iostream;
364       const struct bfd_iovec *iovec;
365
366       /* The caching routines use these to maintain a
367          least-recently-used list of BFDs.  */
368       struct bfd *lru_prev, *lru_next;
369
370       /* Track current file position (or current buffer offset for
371          in-memory BFDs).  When a file is closed by the caching routines,
372          BFD retains state information on the file here.  */
373       ufile_ptr where;
374
375       /* File modified time, if mtime_set is TRUE.  */
376       long mtime;
377
378       /* A unique identifier of the BFD  */
379       unsigned int id;
380
381       /* Format_specific flags.  */
382       flagword flags;
383
384       /* Values that may appear in the flags field of a BFD.  These also
385          appear in the object_flags field of the bfd_target structure, where
386          they indicate the set of flags used by that backend (not all flags
387          are meaningful for all object file formats) (FIXME: at the moment,
388          the object_flags values have mostly just been copied from backend
389          to another, and are not necessarily correct).  */
390
391     #define BFD_NO_FLAGS                0x0
392
393       /* BFD contains relocation entries.  */
394     #define HAS_RELOC                   0x1
395
396       /* BFD is directly executable.  */
397     #define EXEC_P                      0x2
398
399       /* BFD has line number information (basically used for F_LNNO in a
400          COFF header).  */
401     #define HAS_LINENO                  0x4
402
403       /* BFD has debugging information.  */
404     #define HAS_DEBUG                  0x08
405
406       /* BFD has symbols.  */
407     #define HAS_SYMS                   0x10
408
409       /* BFD has local symbols (basically used for F_LSYMS in a COFF
410          header).  */
411     #define HAS_LOCALS                 0x20
412
413       /* BFD is a dynamic object.  */
414     #define DYNAMIC                    0x40
415
416       /* Text section is write protected (if D_PAGED is not set, this is
417          like an a.out NMAGIC file) (the linker sets this by default, but
418          clears it for -r or -N).  */
419     #define WP_TEXT                    0x80
420
421       /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
422          linker sets this by default, but clears it for -r or -n or -N).  */
423     #define D_PAGED                   0x100
424
425       /* BFD is relaxable (this means that bfd_relax_section may be able to
426          do something) (sometimes bfd_relax_section can do something even if
427          this is not set).  */
428     #define BFD_IS_RELAXABLE          0x200
429
430       /* This may be set before writing out a BFD to request using a
431          traditional format.  For example, this is used to request that when
432          writing out an a.out object the symbols not be hashed to eliminate
433          duplicates.  */
434     #define BFD_TRADITIONAL_FORMAT    0x400
435
436       /* This flag indicates that the BFD contents are actually cached
437          in memory.  If this is set, iostream points to a bfd_in_memory
438          struct.  */
439     #define BFD_IN_MEMORY             0x800
440
441       /* This BFD has been created by the linker and doesn't correspond
442          to any input file.  */
443     #define BFD_LINKER_CREATED       0x1000
444
445       /* This may be set before writing out a BFD to request that it
446          be written using values for UIDs, GIDs, timestamps, etc. that
447          will be consistent from run to run.  */
448     #define BFD_DETERMINISTIC_OUTPUT 0x2000
449
450       /* Compress sections in this BFD.  */
451     #define BFD_COMPRESS             0x4000
452
453       /* Decompress sections in this BFD.  */
454     #define BFD_DECOMPRESS           0x8000
455
456       /* BFD is a dummy, for plugins.  */
457     #define BFD_PLUGIN              0x10000
458
459       /* Compress sections in this BFD with SHF_COMPRESSED from gABI.  */
460     #define BFD_COMPRESS_GABI       0x20000
461
462       /* Convert ELF common symbol type to STT_COMMON or STT_OBJECT in this
463          BFD.  */
464     #define BFD_CONVERT_ELF_COMMON  0x40000
465
466       /* Use the ELF STT_COMMON type in this BFD.  */
467     #define BFD_USE_ELF_STT_COMMON  0x80000
468
469       /* Put pathnames into archives (non-POSIX).  */
470     #define BFD_ARCHIVE_FULL_PATH  0x100000
471
472       /* Flags bits to be saved in bfd_preserve_save.  */
473     #define BFD_FLAGS_SAVED \
474       (BFD_IN_MEMORY | BFD_COMPRESS | BFD_DECOMPRESS | BFD_LINKER_CREATED \
475        | BFD_PLUGIN | BFD_COMPRESS_GABI | BFD_CONVERT_ELF_COMMON \
476        | BFD_USE_ELF_STT_COMMON)
477
478       /* Flags bits which are for BFD use only.  */
479     #define BFD_FLAGS_FOR_BFD_USE_MASK \
480       (BFD_IN_MEMORY | BFD_COMPRESS | BFD_DECOMPRESS | BFD_LINKER_CREATED \
481        | BFD_PLUGIN | BFD_TRADITIONAL_FORMAT | BFD_DETERMINISTIC_OUTPUT \
482        | BFD_COMPRESS_GABI | BFD_CONVERT_ELF_COMMON | BFD_USE_ELF_STT_COMMON)
483
484       /* The format which belongs to the BFD. (object, core, etc.)  */
485       ENUM_BITFIELD (bfd_format) format : 3;
486
487       /* The direction with which the BFD was opened.  */
488       ENUM_BITFIELD (bfd_direction) direction : 2;
489
490       /* Is the file descriptor being cached?  That is, can it be closed as
491          needed, and re-opened when accessed later?  */
492       unsigned int cacheable : 1;
493
494       /* Marks whether there was a default target specified when the
495          BFD was opened. This is used to select which matching algorithm
496          to use to choose the back end.  */
497       unsigned int target_defaulted : 1;
498
499       /* ... and here: (``once'' means at least once).  */
500       unsigned int opened_once : 1;
501
502       /* Set if we have a locally maintained mtime value, rather than
503          getting it from the file each time.  */
504       unsigned int mtime_set : 1;
505
506       /* Flag set if symbols from this BFD should not be exported.  */
507       unsigned int no_export : 1;
508
509       /* Remember when output has begun, to stop strange things
510          from happening.  */
511       unsigned int output_has_begun : 1;
512
513       /* Have archive map.  */
514       unsigned int has_armap : 1;
515
516       /* Set if this is a thin archive.  */
517       unsigned int is_thin_archive : 1;
518
519       /* Set if this archive should not cache element positions.  */
520       unsigned int no_element_cache : 1;
521
522       /* Set if only required symbols should be added in the link hash table for
523          this object.  Used by VMS linkers.  */
524       unsigned int selective_search : 1;
525
526       /* Set if this is the linker output BFD.  */
527       unsigned int is_linker_output : 1;
528
529       /* Set if this is the linker input BFD.  */
530       unsigned int is_linker_input : 1;
531
532       /* If this is an input for a compiler plug-in library.  */
533       ENUM_BITFIELD (bfd_plugin_format) plugin_format : 2;
534
535       /* Set if this is a plugin output file.  */
536       unsigned int lto_output : 1;
537
538       /* Set if this is a slim LTO object not loaded with a compiler plugin.  */
539       unsigned int lto_slim_object : 1;
540
541       /* Do not attempt to modify this file.  Set when detecting errors
542          that BFD is not prepared to handle for objcopy/strip.  */
543       unsigned int read_only : 1;
544
545       /* Set to dummy BFD created when claimed by a compiler plug-in
546          library.  */
547       bfd *plugin_dummy_bfd;
548
549       /* The offset of this bfd in the file, typically 0 if it is not
550          contained in an archive.  */
551       ufile_ptr origin;
552
553       /* The origin in the archive of the proxy entry.  This will
554          normally be the same as origin, except for thin archives,
555          when it will contain the current offset of the proxy in the
556          thin archive rather than the offset of the bfd in its actual
557          container.  */
558       ufile_ptr proxy_origin;
559
560       /* A hash table for section names.  */
561       struct bfd_hash_table section_htab;
562
563       /* Pointer to linked list of sections.  */
564       struct bfd_section *sections;
565
566       /* The last section on the section list.  */
567       struct bfd_section *section_last;
568
569       /* The number of sections.  */
570       unsigned int section_count;
571
572       /* The archive plugin file descriptor.  */
573       int archive_plugin_fd;
574
575       /* The number of opens on the archive plugin file descriptor.  */
576       unsigned int archive_plugin_fd_open_count;
577
578       /* A field used by _bfd_generic_link_add_archive_symbols.  This will
579          be used only for archive elements.  */
580       int archive_pass;
581
582       /* The total size of memory from bfd_alloc.  */
583       bfd_size_type alloc_size;
584
585       /* Stuff only useful for object files:
586          The start address.  */
587       bfd_vma start_address;
588
589       /* Symbol table for output BFD (with symcount entries).
590          Also used by the linker to cache input BFD symbols.  */
591       struct bfd_symbol **outsymbols;
592
593       /* Used for input and output.  */
594       unsigned int symcount;
595
596       /* Used for slurped dynamic symbol tables.  */
597       unsigned int dynsymcount;
598
599       /* Pointer to structure which contains architecture information.  */
600       const struct bfd_arch_info *arch_info;
601
602       /* Cached length of file for bfd_get_size.  0 until bfd_get_size is
603          called, 1 if stat returns an error or the file size is too large to
604          return in ufile_ptr.  Both 0 and 1 should be treated as "unknown".  */
605       ufile_ptr size;
606
607       /* Stuff only useful for archives.  */
608       void *arelt_data;
609       struct bfd *my_archive;      /* The containing archive BFD.  */
610       struct bfd *archive_next;    /* The next BFD in the archive.  */
611       struct bfd *archive_head;    /* The first BFD in the archive.  */
612       struct bfd *nested_archives; /* List of nested archive in a flattened
613                                       thin archive.  */
614
615       union {
616         /* For input BFDs, a chain of BFDs involved in a link.  */
617         struct bfd *next;
618         /* For output BFD, the linker hash table.  */
619         struct bfd_link_hash_table *hash;
620       } link;
621
622       /* Used by the back end to hold private data.  */
623       union
624         {
625           struct aout_data_struct *aout_data;
626           struct artdata *aout_ar_data;
627           struct coff_tdata *coff_obj_data;
628           struct pe_tdata *pe_obj_data;
629           struct xcoff_tdata *xcoff_obj_data;
630           struct ecoff_tdata *ecoff_obj_data;
631           struct srec_data_struct *srec_data;
632           struct verilog_data_struct *verilog_data;
633           struct ihex_data_struct *ihex_data;
634           struct tekhex_data_struct *tekhex_data;
635           struct elf_obj_tdata *elf_obj_data;
636           struct mmo_data_struct *mmo_data;
637           struct sun_core_struct *sun_core_data;
638           struct sco5_core_struct *sco5_core_data;
639           struct trad_core_struct *trad_core_data;
640           struct som_data_struct *som_data;
641           struct hpux_core_struct *hpux_core_data;
642           struct hppabsd_core_struct *hppabsd_core_data;
643           struct sgi_core_struct *sgi_core_data;
644           struct lynx_core_struct *lynx_core_data;
645           struct osf_core_struct *osf_core_data;
646           struct cisco_core_struct *cisco_core_data;
647           struct versados_data_struct *versados_data;
648           struct netbsd_core_struct *netbsd_core_data;
649           struct mach_o_data_struct *mach_o_data;
650           struct mach_o_fat_data_struct *mach_o_fat_data;
651           struct plugin_data_struct *plugin_data;
652           struct bfd_pef_data_struct *pef_data;
653           struct bfd_pef_xlib_data_struct *pef_xlib_data;
654           struct bfd_sym_data_struct *sym_data;
655           void *any;
656         }
657       tdata;
658
659       /* Used by the application to hold private data.  */
660       void *usrdata;
661
662       /* Where all the allocated stuff under this BFD goes.  This is a
663          struct objalloc *, but we use void * to avoid requiring the inclusion
664          of objalloc.h.  */
665       void *memory;
666
667       /* For input BFDs, the build ID, if the object has one. */
668       const struct bfd_build_id *build_id;
669     };
670
671     static inline const char *
672     bfd_get_filename (const bfd *abfd)
673     {
674       return abfd->filename;
675     }
676
677     static inline bool
678     bfd_get_cacheable (const bfd *abfd)
679     {
680       return abfd->cacheable;
681     }
682
683     static inline enum bfd_format
684     bfd_get_format (const bfd *abfd)
685     {
686       return abfd->format;
687     }
688
689     static inline flagword
690     bfd_get_file_flags (const bfd *abfd)
691     {
692       return abfd->flags;
693     }
694
695     static inline bfd_vma
696     bfd_get_start_address (const bfd *abfd)
697     {
698       return abfd->start_address;
699     }
700
701     static inline unsigned int
702     bfd_get_symcount (const bfd *abfd)
703     {
704       return abfd->symcount;
705     }
706
707     static inline unsigned int
708     bfd_get_dynamic_symcount (const bfd *abfd)
709     {
710       return abfd->dynsymcount;
711     }
712
713     static inline struct bfd_symbol **
714     bfd_get_outsymbols (const bfd *abfd)
715     {
716       return abfd->outsymbols;
717     }
718
719     static inline unsigned int
720     bfd_count_sections (const bfd *abfd)
721     {
722       return abfd->section_count;
723     }
724
725     static inline bool
726     bfd_has_map (const bfd *abfd)
727     {
728       return abfd->has_armap;
729     }
730
731     static inline bool
732     bfd_is_thin_archive (const bfd *abfd)
733     {
734       return abfd->is_thin_archive;
735     }
736
737     static inline void *
738     bfd_usrdata (const bfd *abfd)
739     {
740       return abfd->usrdata;
741     }
742
743     /* See note beside bfd_set_section_userdata.  */
744     static inline bool
745     bfd_set_cacheable (bfd * abfd, bool val)
746     {
747       abfd->cacheable = val;
748       return true;
749     }
750
751     static inline void
752     bfd_set_thin_archive (bfd *abfd, bool val)
753     {
754       abfd->is_thin_archive = val;
755     }
756
757     static inline void
758     bfd_set_usrdata (bfd *abfd, void *val)
759     {
760       abfd->usrdata = val;
761     }
762
763     static inline asection *
764     bfd_asymbol_section (const asymbol *sy)
765     {
766       return sy->section;
767     }
768
769     static inline bfd_vma
770     bfd_asymbol_value (const asymbol *sy)
771     {
772       return sy->section->vma + sy->value;
773     }
774
775     static inline const char *
776     bfd_asymbol_name (const asymbol *sy)
777     {
778       return sy->name;
779     }
780
781     static inline struct bfd *
782     bfd_asymbol_bfd (const asymbol *sy)
783     {
784       return sy->the_bfd;
785     }
786
787     static inline void
788     bfd_set_asymbol_name (asymbol *sy, const char *name)
789     {
790       sy->name = name;
791     }
792
793     static inline bfd_size_type
794     bfd_get_section_limit_octets (const bfd *abfd, const asection *sec)
795     {
796       if (abfd->direction != write_direction && sec->rawsize != 0)
797         return sec->rawsize;
798       return sec->size;
799     }
800
801     /* Find the address one past the end of SEC.  */
802     static inline bfd_size_type
803     bfd_get_section_limit (const bfd *abfd, const asection *sec)
804     {
805       return (bfd_get_section_limit_octets (abfd, sec)
806               / bfd_octets_per_byte (abfd, sec));
807     }
808
809     /* Functions to handle insertion and deletion of a bfd's sections.  These
810        only handle the list pointers, ie. do not adjust section_count,
811        target_index etc.  */
812     static inline void
813     bfd_section_list_remove (bfd *abfd, asection *s)
814     {
815       asection *next = s->next;
816       asection *prev = s->prev;
817       if (prev)
818         prev->next = next;
819       else
820         abfd->sections = next;
821       if (next)
822         next->prev = prev;
823       else
824         abfd->section_last = prev;
825     }
826
827     static inline void
828     bfd_section_list_append (bfd *abfd, asection *s)
829     {
830       s->next = 0;
831       if (abfd->section_last)
832         {
833           s->prev = abfd->section_last;
834           abfd->section_last->next = s;
835         }
836       else
837         {
838           s->prev = 0;
839           abfd->sections = s;
840         }
841       abfd->section_last = s;
842     }
843
844     static inline void
845     bfd_section_list_prepend (bfd *abfd, asection *s)
846     {
847       s->prev = 0;
848       if (abfd->sections)
849         {
850           s->next = abfd->sections;
851           abfd->sections->prev = s;
852         }
853       else
854         {
855           s->next = 0;
856           abfd->section_last = s;
857         }
858       abfd->sections = s;
859     }
860
861     static inline void
862     bfd_section_list_insert_after (bfd *abfd, asection *a, asection *s)
863     {
864       asection *next = a->next;
865       s->next = next;
866       s->prev = a;
867       a->next = s;
868       if (next)
869         next->prev = s;
870       else
871         abfd->section_last = s;
872     }
873
874     static inline void
875     bfd_section_list_insert_before (bfd *abfd, asection *b, asection *s)
876     {
877       asection *prev = b->prev;
878       s->prev = prev;
879       s->next = b;
880       b->prev = s;
881       if (prev)
882         prev->next = s;
883       else
884         abfd->sections = s;
885     }
886
887     static inline bool
888     bfd_section_removed_from_list (const bfd *abfd, const asection *s)
889     {
890       return s->next ? s->next->prev != s : abfd->section_last != s;
891     }
892
893
894
895File: bfd.info,  Node: Error reporting,  Next: Miscellaneous,  Prev: typedef bfd,  Up: BFD front end
896
8972.2 Error reporting
898===================
899
900Most BFD functions return nonzero on success (check their individual
901documentation for precise semantics).  On an error, they call
902'bfd_set_error' to set an error condition that callers can check by
903calling 'bfd_get_error'.  If that returns 'bfd_error_system_call', then
904check 'errno'.
905
906   The easiest way to report a BFD error to the user is to use
907'bfd_perror'.
908
9092.2.1 Type 'bfd_error_type'
910---------------------------
911
912The values returned by 'bfd_get_error' are defined by the enumerated
913type 'bfd_error_type'.
914
915
916     typedef enum bfd_error
917     {
918       bfd_error_no_error = 0,
919       bfd_error_system_call,
920       bfd_error_invalid_target,
921       bfd_error_wrong_format,
922       bfd_error_wrong_object_format,
923       bfd_error_invalid_operation,
924       bfd_error_no_memory,
925       bfd_error_no_symbols,
926       bfd_error_no_armap,
927       bfd_error_no_more_archived_files,
928       bfd_error_malformed_archive,
929       bfd_error_missing_dso,
930       bfd_error_file_not_recognized,
931       bfd_error_file_ambiguously_recognized,
932       bfd_error_no_contents,
933       bfd_error_nonrepresentable_section,
934       bfd_error_no_debug_section,
935       bfd_error_bad_value,
936       bfd_error_file_truncated,
937       bfd_error_file_too_big,
938       bfd_error_sorry,
939       bfd_error_on_input,
940       bfd_error_invalid_error_code
941     }
942     bfd_error_type;
943
944
9452.2.1.1 'bfd_get_error'
946.......................
947
948*Synopsis*
949     bfd_error_type bfd_get_error (void);
950   *Description*
951Return the current BFD error condition.
952
9532.2.1.2 'bfd_set_error'
954.......................
955
956*Synopsis*
957     void bfd_set_error (bfd_error_type error_tag);
958   *Description*
959Set the BFD error condition to be ERROR_TAG.
960
961   ERROR_TAG must not be bfd_error_on_input.  Use bfd_set_input_error
962for input errors instead.
963
9642.2.1.3 'bfd_set_input_error'
965.............................
966
967*Synopsis*
968     void bfd_set_input_error (bfd *input, bfd_error_type error_tag);
969   *Description*
970Set the BFD error condition to be bfd_error_on_input.  INPUT is the
971input bfd where the error occurred, and ERROR_TAG the bfd_error_type
972error.
973
9742.2.1.4 'bfd_errmsg'
975....................
976
977*Synopsis*
978     const char *bfd_errmsg (bfd_error_type error_tag);
979   *Description*
980Return a string describing the error ERROR_TAG, or the system error if
981ERROR_TAG is 'bfd_error_system_call'.
982
9832.2.1.5 'bfd_perror'
984....................
985
986*Synopsis*
987     void bfd_perror (const char *message);
988   *Description*
989Print to the standard error stream a string describing the last BFD
990error that occurred, or the last system error if the last BFD error was
991a system call failure.  If MESSAGE is non-NULL and non-empty, the error
992string printed is preceded by MESSAGE, a colon, and a space.  It is
993followed by a newline.
994
9952.2.2 BFD error handler
996-----------------------
997
998Some BFD functions want to print messages describing the problem.  They
999call a BFD error handler function.  This function may be overridden by
1000the program.
1001
1002   The BFD error handler acts like vprintf.
1003
1004
1005     typedef void (*bfd_error_handler_type) (const char *, va_list);
1006
1007
10082.2.2.1 '_bfd_error_handler'
1009............................
1010
1011*Synopsis*
1012     void _bfd_error_handler (const char *fmt, ...) ATTRIBUTE_PRINTF_1;
1013   *Description*
1014This is the default routine to handle BFD error messages.  Like fprintf
1015(stderr, ...), but also handles some extra format specifiers.
1016
1017   %pA section name from section.  For group components, prints group
1018name too.  %pB file name from bfd.  For archive components, prints
1019archive too.
1020
1021   Beware: Only supports a maximum of 9 format arguments.
1022
10232.2.2.2 'bfd_set_error_handler'
1024...............................
1025
1026*Synopsis*
1027     bfd_error_handler_type bfd_set_error_handler (bfd_error_handler_type);
1028   *Description*
1029Set the BFD error handler function.  Returns the previous function.
1030
10312.2.2.3 'bfd_set_error_program_name'
1032....................................
1033
1034*Synopsis*
1035     void bfd_set_error_program_name (const char *);
1036   *Description*
1037Set the program name to use when printing a BFD error.  This is printed
1038before the error message followed by a colon and space.  The string must
1039not be changed after it is passed to this function.
1040
10412.2.3 BFD assert handler
1042------------------------
1043
1044If BFD finds an internal inconsistency, the bfd assert handler is called
1045with information on the BFD version, BFD source file and line.  If this
1046happens, most programs linked against BFD are expected to want to exit
1047with an error, or mark the current BFD operation as failed, so it is
1048recommended to override the default handler, which just calls
1049_bfd_error_handler and continues.
1050
1051
1052     typedef void (*bfd_assert_handler_type) (const char *bfd_formatmsg,
1053                                              const char *bfd_version,
1054                                              const char *bfd_file,
1055                                              int bfd_line);
1056
1057
10582.2.3.1 'bfd_set_assert_handler'
1059................................
1060
1061*Synopsis*
1062     bfd_assert_handler_type bfd_set_assert_handler (bfd_assert_handler_type);
1063   *Description*
1064Set the BFD assert handler function.  Returns the previous function.
1065
1066
1067File: bfd.info,  Node: Miscellaneous,  Next: Memory Usage,  Prev: Error reporting,  Up: BFD front end
1068
10692.3 Miscellaneous
1070=================
1071
10722.3.1 Miscellaneous functions
1073-----------------------------
1074
10752.3.1.1 'bfd_get_reloc_upper_bound'
1076...................................
1077
1078*Synopsis*
1079     long bfd_get_reloc_upper_bound (bfd *abfd, asection *sect);
1080   *Description*
1081Return the number of bytes required to store the relocation information
1082associated with section SECT attached to bfd ABFD.  If an error occurs,
1083return -1.
1084
10852.3.1.2 'bfd_canonicalize_reloc'
1086................................
1087
1088*Synopsis*
1089     long bfd_canonicalize_reloc
1090        (bfd *abfd, asection *sec, arelent **loc, asymbol **syms);
1091   *Description*
1092Call the back end associated with the open BFD ABFD and translate the
1093external form of the relocation information attached to SEC into the
1094internal canonical form.  Place the table into memory at LOC, which has
1095been preallocated, usually by a call to 'bfd_get_reloc_upper_bound'.
1096Returns the number of relocs, or -1 on error.
1097
1098   The SYMS table is also needed for horrible internal magic reasons.
1099
11002.3.1.3 'bfd_set_reloc'
1101.......................
1102
1103*Synopsis*
1104     void bfd_set_reloc
1105        (bfd *abfd, asection *sec, arelent **rel, unsigned int count);
1106   *Description*
1107Set the relocation pointer and count within section SEC to the values
1108REL and COUNT.  The argument ABFD is ignored.
1109     #define bfd_set_reloc(abfd, asect, location, count) \
1110            BFD_SEND (abfd, _bfd_set_reloc, (abfd, asect, location, count))
1111
11122.3.1.4 'bfd_set_file_flags'
1113............................
1114
1115*Synopsis*
1116     bool bfd_set_file_flags (bfd *abfd, flagword flags);
1117   *Description*
1118Set the flag word in the BFD ABFD to the value FLAGS.
1119
1120   Possible errors are:
1121
1122   * 'bfd_error_wrong_format' - The target bfd was not of object format.
1123   * 'bfd_error_invalid_operation' - The target bfd was open for
1124     reading.
1125   * 'bfd_error_invalid_operation' - The flag word contained a bit which
1126     was not applicable to the type of file.  E.g., an attempt was made
1127     to set the 'D_PAGED' bit on a BFD format which does not support
1128     demand paging.
1129
11302.3.1.5 'bfd_get_arch_size'
1131...........................
1132
1133*Synopsis*
1134     int bfd_get_arch_size (bfd *abfd);
1135   *Description*
1136Returns the normalized architecture address size, in bits, as determined
1137by the object file's format.  By normalized, we mean either 32 or 64.
1138For ELF, this information is included in the header.  Use
1139bfd_arch_bits_per_address for number of bits in the architecture
1140address.
1141
1142   *Returns*
1143Returns the arch size in bits if known, '-1' otherwise.
1144
11452.3.1.6 'bfd_get_sign_extend_vma'
1146.................................
1147
1148*Synopsis*
1149     int bfd_get_sign_extend_vma (bfd *abfd);
1150   *Description*
1151Indicates if the target architecture "naturally" sign extends an
1152address.  Some architectures implicitly sign extend address values when
1153they are converted to types larger than the size of an address.  For
1154instance, bfd_get_start_address() will return an address sign extended
1155to fill a bfd_vma when this is the case.
1156
1157   *Returns*
1158Returns '1' if the target architecture is known to sign extend
1159addresses, '0' if the target architecture is known to not sign extend
1160addresses, and '-1' otherwise.
1161
11622.3.1.7 'bfd_set_start_address'
1163...............................
1164
1165*Synopsis*
1166     bool bfd_set_start_address (bfd *abfd, bfd_vma vma);
1167   *Description*
1168Make VMA the entry point of output BFD ABFD.
1169
1170   *Returns*
1171Returns 'TRUE' on success, 'FALSE' otherwise.
1172
11732.3.1.8 'bfd_get_gp_size'
1174.........................
1175
1176*Synopsis*
1177     unsigned int bfd_get_gp_size (bfd *abfd);
1178   *Description*
1179Return the maximum size of objects to be optimized using the GP register
1180under MIPS ECOFF. This is typically set by the '-G' argument to the
1181compiler, assembler or linker.
1182
11832.3.1.9 'bfd_set_gp_size'
1184.........................
1185
1186*Synopsis*
1187     void bfd_set_gp_size (bfd *abfd, unsigned int i);
1188   *Description*
1189Set the maximum size of objects to be optimized using the GP register
1190under ECOFF or MIPS ELF. This is typically set by the '-G' argument to
1191the compiler, assembler or linker.
1192
11932.3.1.10 'bfd_set_gp_value'
1194...........................
1195
1196*Synopsis*
1197     void bfd_set_gp_value (bfd *abfd, bfd_vma v);
1198   *Description*
1199Allow external access to the fucntion to set the GP value.  This is
1200specifically added for gdb-compile support.
1201
12022.3.1.11 'bfd_scan_vma'
1203.......................
1204
1205*Synopsis*
1206     bfd_vma bfd_scan_vma (const char *string, const char **end, int base);
1207   *Description*
1208Convert, like 'strtoul', a numerical expression STRING into a 'bfd_vma'
1209integer, and return that integer.  (Though without as many bells and
1210whistles as 'strtoul'.)  The expression is assumed to be unsigned (i.e.,
1211positive).  If given a BASE, it is used as the base for conversion.  A
1212base of 0 causes the function to interpret the string in hex if a
1213leading "0x" or "0X" is found, otherwise in octal if a leading zero is
1214found, otherwise in decimal.
1215
1216   If the value would overflow, the maximum 'bfd_vma' value is returned.
1217
12182.3.1.12 'bfd_copy_private_header_data'
1219.......................................
1220
1221*Synopsis*
1222     bool bfd_copy_private_header_data (bfd *ibfd, bfd *obfd);
1223   *Description*
1224Copy private BFD header information from the BFD IBFD to the the BFD
1225OBFD.  This copies information that may require sections to exist, but
1226does not require symbol tables.  Return 'true' on success, 'false' on
1227error.  Possible error returns are:
1228
1229   * 'bfd_error_no_memory' - Not enough memory exists to create private
1230     data for OBFD.
1231     #define bfd_copy_private_header_data(ibfd, obfd) \
1232            BFD_SEND (obfd, _bfd_copy_private_header_data, \
1233                      (ibfd, obfd))
1234
12352.3.1.13 'bfd_copy_private_bfd_data'
1236....................................
1237
1238*Synopsis*
1239     bool bfd_copy_private_bfd_data (bfd *ibfd, bfd *obfd);
1240   *Description*
1241Copy private BFD information from the BFD IBFD to the the BFD OBFD.
1242Return 'TRUE' on success, 'FALSE' on error.  Possible error returns are:
1243
1244   * 'bfd_error_no_memory' - Not enough memory exists to create private
1245     data for OBFD.
1246     #define bfd_copy_private_bfd_data(ibfd, obfd) \
1247            BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
1248                      (ibfd, obfd))
1249
12502.3.1.14 'bfd_set_private_flags'
1251................................
1252
1253*Synopsis*
1254     bool bfd_set_private_flags (bfd *abfd, flagword flags);
1255   *Description*
1256Set private BFD flag information in the BFD ABFD.  Return 'TRUE' on
1257success, 'FALSE' on error.  Possible error returns are:
1258
1259   * 'bfd_error_no_memory' - Not enough memory exists to create private
1260     data for OBFD.
1261     #define bfd_set_private_flags(abfd, flags) \
1262            BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags))
1263
12642.3.1.15 'Other functions'
1265..........................
1266
1267*Description*
1268The following functions exist but have not yet been documented.
1269     #define bfd_sizeof_headers(abfd, info) \
1270            BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, info))
1271
1272     #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1273            BFD_SEND (abfd, _bfd_find_nearest_line, \
1274                      (abfd, syms, sec, off, file, func, line, NULL))
1275
1276     #define bfd_find_nearest_line_discriminator(abfd, sec, syms, off, file, func, \
1277                                                line, disc) \
1278            BFD_SEND (abfd, _bfd_find_nearest_line, \
1279                      (abfd, syms, sec, off, file, func, line, disc))
1280
1281     #define bfd_find_line(abfd, syms, sym, file, line) \
1282            BFD_SEND (abfd, _bfd_find_line, \
1283                      (abfd, syms, sym, file, line))
1284
1285     #define bfd_find_inliner_info(abfd, file, func, line) \
1286            BFD_SEND (abfd, _bfd_find_inliner_info, \
1287                      (abfd, file, func, line))
1288
1289     #define bfd_debug_info_start(abfd) \
1290            BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1291
1292     #define bfd_debug_info_end(abfd) \
1293            BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1294
1295     #define bfd_debug_info_accumulate(abfd, section) \
1296            BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1297
1298     #define bfd_stat_arch_elt(abfd, stat) \
1299            BFD_SEND (abfd->my_archive ? abfd->my_archive : abfd, \
1300                      _bfd_stat_arch_elt, (abfd, stat))
1301
1302     #define bfd_update_armap_timestamp(abfd) \
1303            BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
1304
1305     #define bfd_set_arch_mach(abfd, arch, mach)\
1306            BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
1307
1308     #define bfd_relax_section(abfd, section, link_info, again) \
1309            BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
1310
1311     #define bfd_gc_sections(abfd, link_info) \
1312            BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info))
1313
1314     #define bfd_lookup_section_flags(link_info, flag_info, section) \
1315            BFD_SEND (abfd, _bfd_lookup_section_flags, (link_info, flag_info, section))
1316
1317     #define bfd_merge_sections(abfd, link_info) \
1318            BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info))
1319
1320     #define bfd_is_group_section(abfd, sec) \
1321            BFD_SEND (abfd, _bfd_is_group_section, (abfd, sec))
1322
1323     #define bfd_group_name(abfd, sec) \
1324            BFD_SEND (abfd, _bfd_group_name, (abfd, sec))
1325
1326     #define bfd_discard_group(abfd, sec) \
1327            BFD_SEND (abfd, _bfd_discard_group, (abfd, sec))
1328
1329     #define bfd_link_hash_table_create(abfd) \
1330            BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
1331
1332     #define bfd_link_add_symbols(abfd, info) \
1333            BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
1334
1335     #define bfd_link_just_syms(abfd, sec, info) \
1336            BFD_SEND (abfd, _bfd_link_just_syms, (sec, info))
1337
1338     #define bfd_final_link(abfd, info) \
1339            BFD_SEND (abfd, _bfd_final_link, (abfd, info))
1340
1341     #define bfd_free_cached_info(abfd) \
1342            BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
1343
1344     #define bfd_get_dynamic_symtab_upper_bound(abfd) \
1345            BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
1346
1347     #define bfd_print_private_bfd_data(abfd, file)\
1348            BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
1349
1350     #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
1351            BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
1352
1353     #define bfd_get_synthetic_symtab(abfd, count, syms, dyncount, dynsyms, ret) \
1354            BFD_SEND (abfd, _bfd_get_synthetic_symtab, (abfd, count, syms, \
1355                                                        dyncount, dynsyms, ret))
1356
1357     #define bfd_get_dynamic_reloc_upper_bound(abfd) \
1358            BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
1359
1360     #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
1361            BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
1362
1363     extern bfd_byte *bfd_get_relocated_section_contents
1364       (bfd *, struct bfd_link_info *, struct bfd_link_order *, bfd_byte *,
1365        bool, asymbol **);
1366
1367
13682.3.1.16 'bfd_alt_mach_code'
1369............................
1370
1371*Synopsis*
1372     bool bfd_alt_mach_code (bfd *abfd, int alternative);
1373   *Description*
1374When more than one machine code number is available for the same machine
1375type, this function can be used to switch between the preferred one
1376(alternative == 0) and any others.  Currently, only ELF supports this
1377feature, with up to two alternate machine codes.
1378
13792.3.1.17 'bfd_emul_get_maxpagesize'
1380...................................
1381
1382*Synopsis*
1383     bfd_vma bfd_emul_get_maxpagesize (const char *);
1384   *Description*
1385Returns the maximum page size, in bytes, as determined by emulation.
1386
1387   *Returns*
1388Returns the maximum page size in bytes for ELF, 0 otherwise.
1389
13902.3.1.18 'bfd_emul_get_commonpagesize'
1391......................................
1392
1393*Synopsis*
1394     bfd_vma bfd_emul_get_commonpagesize (const char *);
1395   *Description*
1396Returns the common page size, in bytes, as determined by emulation.
1397
1398   *Returns*
1399Returns the common page size in bytes for ELF, 0 otherwise.
1400
14012.3.1.19 'bfd_demangle'
1402.......................
1403
1404*Synopsis*
1405     char *bfd_demangle (bfd *, const char *, int);
1406   *Description*
1407Wrapper around cplus_demangle.  Strips leading underscores and other
1408such chars that would otherwise confuse the demangler.  If passed a g++
1409v3 ABI mangled name, returns a buffer allocated with malloc holding the
1410demangled name.  Returns NULL otherwise and on memory alloc failure.
1411
14122.3.1.20 'bfd_update_compression_header'
1413........................................
1414
1415*Synopsis*
1416     void bfd_update_compression_header
1417        (bfd *abfd, bfd_byte *contents, asection *sec);
1418   *Description*
1419Set the compression header at CONTENTS of SEC in ABFD and update
1420elf_section_flags for compression.
1421
14222.3.1.21 'bfd_check_compression_header'
1423.......................................
1424
1425*Synopsis*
1426     bool bfd_check_compression_header
1427        (bfd *abfd, bfd_byte *contents, asection *sec,
1428         bfd_size_type *uncompressed_size,
1429         unsigned int *uncompressed_alignment_power);
1430   *Description*
1431Check the compression header at CONTENTS of SEC in ABFD and store the
1432uncompressed size in UNCOMPRESSED_SIZE and the uncompressed data
1433alignment in UNCOMPRESSED_ALIGNMENT_POWER if the compression header is
1434valid.
1435
1436   *Returns*
1437Return TRUE if the compression header is valid.
1438
14392.3.1.22 'bfd_get_compression_header_size'
1440..........................................
1441
1442*Synopsis*
1443     int bfd_get_compression_header_size (bfd *abfd, asection *sec);
1444   *Description*
1445Return the size of the compression header of SEC in ABFD.
1446
1447   *Returns*
1448Return the size of the compression header in bytes.
1449
14502.3.1.23 'bfd_convert_section_size'
1451...................................
1452
1453*Synopsis*
1454     bfd_size_type bfd_convert_section_size
1455        (bfd *ibfd, asection *isec, bfd *obfd, bfd_size_type size);
1456   *Description*
1457Convert the size SIZE of the section ISEC in input BFD IBFD to the
1458section size in output BFD OBFD.
1459
14602.3.1.24 'bfd_convert_section_contents'
1461.......................................
1462
1463*Synopsis*
1464     bool bfd_convert_section_contents
1465        (bfd *ibfd, asection *isec, bfd *obfd,
1466         bfd_byte **ptr, bfd_size_type *ptr_size);
1467   *Description*
1468Convert the contents, stored in *PTR, of the section ISEC in input BFD
1469IBFD to output BFD OBFD if needed.  The original buffer pointed to by
1470*PTR may be freed and *PTR is returned with memory malloc'd by this
1471function, and the new size written to PTR_SIZE.
1472
14732.3.1.25 'struct bfd_iovec'
1474...........................
1475
1476*Description*
1477The 'struct bfd_iovec' contains the internal file I/O class.  Each 'BFD'
1478has an instance of this class and all file I/O is routed through it (it
1479is assumed that the instance implements all methods listed below).
1480     struct bfd_iovec
1481     {
1482       /* To avoid problems with macros, a "b" rather than "f"
1483          prefix is prepended to each method name.  */
1484       /* Attempt to read/write NBYTES on ABFD's IOSTREAM storing/fetching
1485          bytes starting at PTR.  Return the number of bytes actually
1486          transfered (a read past end-of-file returns less than NBYTES),
1487          or -1 (setting bfd_error) if an error occurs.  */
1488       file_ptr (*bread) (struct bfd *abfd, void *ptr, file_ptr nbytes);
1489       file_ptr (*bwrite) (struct bfd *abfd, const void *ptr,
1490                           file_ptr nbytes);
1491       /* Return the current IOSTREAM file offset, or -1 (setting bfd_error
1492          if an error occurs.  */
1493       file_ptr (*btell) (struct bfd *abfd);
1494       /* For the following, on successful completion a value of 0 is returned.
1495          Otherwise, a value of -1 is returned (and bfd_error is set).  */
1496       int (*bseek) (struct bfd *abfd, file_ptr offset, int whence);
1497       int (*bclose) (struct bfd *abfd);
1498       int (*bflush) (struct bfd *abfd);
1499       int (*bstat) (struct bfd *abfd, struct stat *sb);
1500       /* Mmap a part of the files. ADDR, LEN, PROT, FLAGS and OFFSET are the usual
1501          mmap parameter, except that LEN and OFFSET do not need to be page
1502          aligned.  Returns (void *)-1 on failure, mmapped address on success.
1503          Also write in MAP_ADDR the address of the page aligned buffer and in
1504          MAP_LEN the size mapped (a page multiple).  Use unmap with MAP_ADDR and
1505          MAP_LEN to unmap.  */
1506       void *(*bmmap) (struct bfd *abfd, void *addr, bfd_size_type len,
1507                       int prot, int flags, file_ptr offset,
1508                       void **map_addr, bfd_size_type *map_len);
1509     };
1510     extern const struct bfd_iovec _bfd_memory_iovec;
1511
15122.3.1.26 'bfd_get_mtime'
1513........................
1514
1515*Synopsis*
1516     long bfd_get_mtime (bfd *abfd);
1517   *Description*
1518Return the file modification time (as read from the file system, or from
1519the archive header for archive members).
1520
15212.3.1.27 'bfd_get_size'
1522.......................
1523
1524*Synopsis*
1525     ufile_ptr bfd_get_size (bfd *abfd);
1526   *Description*
1527Return the file size (as read from file system) for the file associated
1528with BFD ABFD.
1529
1530   The initial motivation for, and use of, this routine is not so we can
1531get the exact size of the object the BFD applies to, since that might
1532not be generally possible (archive members for example).  It would be
1533ideal if someone could eventually modify it so that such results were
1534guaranteed.
1535
1536   Instead, we want to ask questions like "is this NNN byte sized object
1537I'm about to try read from file offset YYY reasonable?"  As as example
1538of where we might do this, some object formats use string tables for
1539which the first 'sizeof (long)' bytes of the table contain the size of
1540the table itself, including the size bytes.  If an application tries to
1541read what it thinks is one of these string tables, without some way to
1542validate the size, and for some reason the size is wrong (byte swapping
1543error, wrong location for the string table, etc.), the only clue is
1544likely to be a read error when it tries to read the table, or a "virtual
1545memory exhausted" error when it tries to allocate 15 bazillon bytes of
1546space for the 15 bazillon byte table it is about to read.  This function
1547at least allows us to answer the question, "is the size reasonable?".
1548
1549   A return value of zero indicates the file size is unknown.
1550
15512.3.1.28 'bfd_get_file_size'
1552............................
1553
1554*Synopsis*
1555     ufile_ptr bfd_get_file_size (bfd *abfd);
1556   *Description*
1557Return the file size (as read from file system) for the file associated
1558with BFD ABFD.  It supports both normal files and archive elements.
1559
15602.3.1.29 'bfd_mmap'
1561...................
1562
1563*Synopsis*
1564     void *bfd_mmap (bfd *abfd, void *addr, bfd_size_type len,
1565         int prot, int flags, file_ptr offset,
1566         void **map_addr, bfd_size_type *map_len);
1567   *Description*
1568Return mmap()ed region of the file, if possible and implemented.  LEN
1569and OFFSET do not need to be page aligned.  The page aligned address and
1570length are written to MAP_ADDR and MAP_LEN.
1571
1572
1573File: bfd.info,  Node: Memory Usage,  Next: Initialization,  Prev: Miscellaneous,  Up: BFD front end
1574
15752.4 Memory Usage
1576================
1577
1578BFD keeps all of its internal structures in obstacks.  There is one
1579obstack per open BFD file, into which the current state is stored.  When
1580a BFD is closed, the obstack is deleted, and so everything which has
1581been allocated by BFD for the closing file is thrown away.
1582
1583   BFD does not free anything created by an application, but pointers
1584into 'bfd' structures become invalid on a 'bfd_close'; for example,
1585after a 'bfd_close' the vector passed to 'bfd_canonicalize_symtab' is
1586still around, since it has been allocated by the application, but the
1587data that it pointed to are lost.
1588
1589   The general rule is to not close a BFD until all operations dependent
1590upon data from the BFD have been completed, or all the data from within
1591the file has been copied.  To help with the management of memory, there
1592is a function ('bfd_alloc_size') which returns the number of bytes in
1593obstacks associated with the supplied BFD. This could be used to select
1594the greediest open BFD, close it to reclaim the memory, perform some
1595operation and reopen the BFD again, to get a fresh copy of the data
1596structures.
1597
1598
1599File: bfd.info,  Node: Initialization,  Next: Sections,  Prev: Memory Usage,  Up: BFD front end
1600
16012.5 Initialization
1602==================
1603
16042.5.1 Initialization functions
1605------------------------------
1606
1607These are the functions that handle initializing a BFD.
1608
16092.5.1.1 'bfd_init'
1610..................
1611
1612*Synopsis*
1613     unsigned int bfd_init (void);
1614   *Description*
1615This routine must be called before any other BFD function to initialize
1616magical internal data structures.  Returns a magic number, which may be
1617used to check that the bfd library is configured as expected by users.
1618
1619     /* Value returned by bfd_init.  */
1620
1621     #define BFD_INIT_MAGIC (sizeof (struct bfd_section))
1622
1623
1624File: bfd.info,  Node: Sections,  Next: Symbols,  Prev: Initialization,  Up: BFD front end
1625
16262.6 Sections
1627============
1628
1629The raw data contained within a BFD is maintained through the section
1630abstraction.  A single BFD may have any number of sections.  It keeps
1631hold of them by pointing to the first; each one points to the next in
1632the list.
1633
1634   Sections are supported in BFD in 'section.c'.
1635
1636* Menu:
1637
1638* Section Input::
1639* Section Output::
1640* typedef asection::
1641* section prototypes::
1642
1643
1644File: bfd.info,  Node: Section Input,  Next: Section Output,  Prev: Sections,  Up: Sections
1645
16462.6.1 Section input
1647-------------------
1648
1649When a BFD is opened for reading, the section structures are created and
1650attached to the BFD.
1651
1652   Each section has a name which describes the section in the outside
1653world--for example, 'a.out' would contain at least three sections,
1654called '.text', '.data' and '.bss'.
1655
1656   Names need not be unique; for example a COFF file may have several
1657sections named '.data'.
1658
1659   Sometimes a BFD will contain more than the "natural" number of
1660sections.  A back end may attach other sections containing constructor
1661data, or an application may add a section (using 'bfd_make_section') to
1662the sections attached to an already open BFD. For example, the linker
1663creates an extra section 'COMMON' for each input file's BFD to hold
1664information about common storage.
1665
1666   The raw data is not necessarily read in when the section descriptor
1667is created.  Some targets may leave the data in place until a
1668'bfd_get_section_contents' call is made.  Other back ends may read in
1669all the data at once.  For example, an S-record file has to be read once
1670to determine the size of the data.
1671
1672
1673File: bfd.info,  Node: Section Output,  Next: typedef asection,  Prev: Section Input,  Up: Sections
1674
16752.6.2 Section output
1676--------------------
1677
1678To write a new object style BFD, the various sections to be written have
1679to be created.  They are attached to the BFD in the same way as input
1680sections; data is written to the sections using
1681'bfd_set_section_contents'.
1682
1683   Any program that creates or combines sections (e.g., the assembler
1684and linker) must use the 'asection' fields 'output_section' and
1685'output_offset' to indicate the file sections to which each section must
1686be written.  (If the section is being created from scratch,
1687'output_section' should probably point to the section itself and
1688'output_offset' should probably be zero.)
1689
1690   The data to be written comes from input sections attached (via
1691'output_section' pointers) to the output sections.  The output section
1692structure can be considered a filter for the input section: the output
1693section determines the vma of the output data and the name, but the
1694input section determines the offset into the output section of the data
1695to be written.
1696
1697   E.g., to create a section "O", starting at 0x100, 0x123 long,
1698containing two subsections, "A" at offset 0x0 (i.e., at vma 0x100) and
1699"B" at offset 0x20 (i.e., at vma 0x120) the 'asection' structures would
1700look like:
1701
1702        section name          "A"
1703          output_offset   0x00
1704          size            0x20
1705          output_section ----------->  section name    "O"
1706                                  |    vma             0x100
1707        section name          "B" |    size            0x123
1708          output_offset   0x20    |
1709          size            0x103   |
1710          output_section  --------|
1711
17122.6.3 Link orders
1713-----------------
1714
1715The data within a section is stored in a "link_order".  These are much
1716like the fixups in 'gas'.  The link_order abstraction allows a section
1717to grow and shrink within itself.
1718
1719   A link_order knows how big it is, and which is the next link_order
1720and where the raw data for it is; it also points to a list of
1721relocations which apply to it.
1722
1723   The link_order is used by the linker to perform relaxing on final
1724code.  The compiler creates code which is as big as necessary to make it
1725work without relaxing, and the user can select whether to relax.
1726Sometimes relaxing takes a lot of time.  The linker runs around the
1727relocations to see if any are attached to data which can be shrunk, if
1728so it does it on a link_order by link_order basis.
1729
1730
1731File: bfd.info,  Node: typedef asection,  Next: section prototypes,  Prev: Section Output,  Up: Sections
1732
17332.6.4 typedef asection
1734----------------------
1735
1736Here is the section structure:
1737
1738
1739     typedef struct bfd_section
1740     {
1741       /* The name of the section; the name isn't a copy, the pointer is
1742          the same as that passed to bfd_make_section.  */
1743       const char *name;
1744
1745       /* The next section in the list belonging to the BFD, or NULL.  */
1746       struct bfd_section *next;
1747
1748       /* The previous section in the list belonging to the BFD, or NULL.  */
1749       struct bfd_section *prev;
1750
1751       /* A unique sequence number.  */
1752       unsigned int id;
1753
1754       /* A unique section number which can be used by assembler to
1755          distinguish different sections with the same section name.  */
1756       unsigned int section_id;
1757
1758       /* Which section in the bfd; 0..n-1 as sections are created in a bfd.  */
1759       unsigned int index;
1760
1761       /* The field flags contains attributes of the section. Some
1762          flags are read in from the object file, and some are
1763          synthesized from other information.  */
1764       flagword flags;
1765
1766     #define SEC_NO_FLAGS                      0x0
1767
1768       /* Tells the OS to allocate space for this section when loading.
1769          This is clear for a section containing debug information only.  */
1770     #define SEC_ALLOC                         0x1
1771
1772       /* Tells the OS to load the section from the file when loading.
1773          This is clear for a .bss section.  */
1774     #define SEC_LOAD                          0x2
1775
1776       /* The section contains data still to be relocated, so there is
1777          some relocation information too.  */
1778     #define SEC_RELOC                         0x4
1779
1780       /* A signal to the OS that the section contains read only data.  */
1781     #define SEC_READONLY                      0x8
1782
1783       /* The section contains code only.  */
1784     #define SEC_CODE                         0x10
1785
1786       /* The section contains data only.  */
1787     #define SEC_DATA                         0x20
1788
1789       /* The section will reside in ROM.  */
1790     #define SEC_ROM                          0x40
1791
1792       /* The section contains constructor information. This section
1793          type is used by the linker to create lists of constructors and
1794          destructors used by g++. When a back end sees a symbol
1795          which should be used in a constructor list, it creates a new
1796          section for the type of name (e.g., __CTOR_LIST__), attaches
1797          the symbol to it, and builds a relocation. To build the lists
1798          of constructors, all the linker has to do is catenate all the
1799          sections called __CTOR_LIST__ and relocate the data
1800          contained within - exactly the operations it would peform on
1801          standard data.  */
1802     #define SEC_CONSTRUCTOR                  0x80
1803
1804       /* The section has contents - a data section could be
1805          SEC_ALLOC | SEC_HAS_CONTENTS; a debug section could be
1806          SEC_HAS_CONTENTS  */
1807     #define SEC_HAS_CONTENTS                0x100
1808
1809       /* An instruction to the linker to not output the section
1810          even if it has information which would normally be written.  */
1811     #define SEC_NEVER_LOAD                  0x200
1812
1813       /* The section contains thread local data.  */
1814     #define SEC_THREAD_LOCAL                0x400
1815
1816       /* The section's size is fixed.  Generic linker code will not
1817          recalculate it and it is up to whoever has set this flag to
1818          get the size right.  */
1819     #define SEC_FIXED_SIZE                  0x800
1820
1821       /* The section contains common symbols (symbols may be defined
1822          multiple times, the value of a symbol is the amount of
1823          space it requires, and the largest symbol value is the one
1824          used).  Most targets have exactly one of these (which we
1825          translate to bfd_com_section_ptr), but ECOFF has two.  */
1826     #define SEC_IS_COMMON                  0x1000
1827
1828       /* The section contains only debugging information.  For
1829          example, this is set for ELF .debug and .stab sections.
1830          strip tests this flag to see if a section can be
1831          discarded.  */
1832     #define SEC_DEBUGGING                  0x2000
1833
1834       /* The contents of this section are held in memory pointed to
1835          by the contents field.  This is checked by bfd_get_section_contents,
1836          and the data is retrieved from memory if appropriate.  */
1837     #define SEC_IN_MEMORY                  0x4000
1838
1839       /* The contents of this section are to be excluded by the
1840          linker for executable and shared objects unless those
1841          objects are to be further relocated.  */
1842     #define SEC_EXCLUDE                    0x8000
1843
1844       /* The contents of this section are to be sorted based on the sum of
1845          the symbol and addend values specified by the associated relocation
1846          entries.  Entries without associated relocation entries will be
1847          appended to the end of the section in an unspecified order.  */
1848     #define SEC_SORT_ENTRIES              0x10000
1849
1850       /* When linking, duplicate sections of the same name should be
1851          discarded, rather than being combined into a single section as
1852          is usually done.  This is similar to how common symbols are
1853          handled.  See SEC_LINK_DUPLICATES below.  */
1854     #define SEC_LINK_ONCE                 0x20000
1855
1856       /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
1857          should handle duplicate sections.  */
1858     #define SEC_LINK_DUPLICATES           0xc0000
1859
1860       /* This value for SEC_LINK_DUPLICATES means that duplicate
1861          sections with the same name should simply be discarded.  */
1862     #define SEC_LINK_DUPLICATES_DISCARD       0x0
1863
1864       /* This value for SEC_LINK_DUPLICATES means that the linker
1865          should warn if there are any duplicate sections, although
1866          it should still only link one copy.  */
1867     #define SEC_LINK_DUPLICATES_ONE_ONLY  0x40000
1868
1869       /* This value for SEC_LINK_DUPLICATES means that the linker
1870          should warn if any duplicate sections are a different size.  */
1871     #define SEC_LINK_DUPLICATES_SAME_SIZE 0x80000
1872
1873       /* This value for SEC_LINK_DUPLICATES means that the linker
1874          should warn if any duplicate sections contain different
1875          contents.  */
1876     #define SEC_LINK_DUPLICATES_SAME_CONTENTS \
1877       (SEC_LINK_DUPLICATES_ONE_ONLY | SEC_LINK_DUPLICATES_SAME_SIZE)
1878
1879       /* This section was created by the linker as part of dynamic
1880          relocation or other arcane processing.  It is skipped when
1881          going through the first-pass output, trusting that someone
1882          else up the line will take care of it later.  */
1883     #define SEC_LINKER_CREATED           0x100000
1884
1885       /* This section contains a section ID to distinguish different
1886          sections with the same section name.  */
1887     #define SEC_ASSEMBLER_SECTION_ID     0x100000
1888
1889       /* This section should not be subject to garbage collection.
1890          Also set to inform the linker that this section should not be
1891          listed in the link map as discarded.  */
1892     #define SEC_KEEP                     0x200000
1893
1894       /* This section contains "short" data, and should be placed
1895          "near" the GP.  */
1896     #define SEC_SMALL_DATA               0x400000
1897
1898       /* Attempt to merge identical entities in the section.
1899          Entity size is given in the entsize field.  */
1900     #define SEC_MERGE                    0x800000
1901
1902       /* If given with SEC_MERGE, entities to merge are zero terminated
1903          strings where entsize specifies character size instead of fixed
1904          size entries.  */
1905     #define SEC_STRINGS                 0x1000000
1906
1907       /* This section contains data about section groups.  */
1908     #define SEC_GROUP                   0x2000000
1909
1910       /* The section is a COFF shared library section.  This flag is
1911          only for the linker.  If this type of section appears in
1912          the input file, the linker must copy it to the output file
1913          without changing the vma or size.  FIXME: Although this
1914          was originally intended to be general, it really is COFF
1915          specific (and the flag was renamed to indicate this).  It
1916          might be cleaner to have some more general mechanism to
1917          allow the back end to control what the linker does with
1918          sections.  */
1919     #define SEC_COFF_SHARED_LIBRARY     0x4000000
1920
1921       /* This input section should be copied to output in reverse order
1922          as an array of pointers.  This is for ELF linker internal use
1923          only.  */
1924     #define SEC_ELF_REVERSE_COPY        0x4000000
1925
1926       /* This section contains data which may be shared with other
1927          executables or shared objects. This is for COFF only.  */
1928     #define SEC_COFF_SHARED             0x8000000
1929
1930       /* This section should be compressed.  This is for ELF linker
1931          internal use only.  */
1932     #define SEC_ELF_COMPRESS            0x8000000
1933
1934       /* When a section with this flag is being linked, then if the size of
1935          the input section is less than a page, it should not cross a page
1936          boundary.  If the size of the input section is one page or more,
1937          it should be aligned on a page boundary.  This is for TI
1938          TMS320C54X only.  */
1939     #define SEC_TIC54X_BLOCK           0x10000000
1940
1941       /* This section should be renamed.  This is for ELF linker
1942          internal use only.  */
1943     #define SEC_ELF_RENAME             0x10000000
1944
1945       /* Conditionally link this section; do not link if there are no
1946          references found to any symbol in the section.  This is for TI
1947          TMS320C54X only.  */
1948     #define SEC_TIC54X_CLINK           0x20000000
1949
1950       /* This section contains vliw code.  This is for Toshiba MeP only.  */
1951     #define SEC_MEP_VLIW               0x20000000
1952
1953       /* All symbols, sizes and relocations in this section are octets
1954          instead of bytes.  Required for DWARF debug sections as DWARF
1955          information is organized in octets, not bytes.  */
1956     #define SEC_ELF_OCTETS             0x40000000
1957
1958       /* Indicate that section has the no read flag set. This happens
1959          when memory read flag isn't set. */
1960     #define SEC_COFF_NOREAD            0x40000000
1961
1962       /* Indicate that section has the purecode flag set.  */
1963     #define SEC_ELF_PURECODE           0x80000000
1964
1965       /*  End of section flags.  */
1966
1967       /* Some internal packed boolean fields.  */
1968
1969       /* See the vma field.  */
1970       unsigned int user_set_vma : 1;
1971
1972       /* A mark flag used by some of the linker backends.  */
1973       unsigned int linker_mark : 1;
1974
1975       /* Another mark flag used by some of the linker backends.  Set for
1976          output sections that have an input section.  */
1977       unsigned int linker_has_input : 1;
1978
1979       /* Mark flag used by some linker backends for garbage collection.  */
1980       unsigned int gc_mark : 1;
1981
1982       /* Section compression status.  */
1983       unsigned int compress_status : 2;
1984     #define COMPRESS_SECTION_NONE    0
1985     #define COMPRESS_SECTION_DONE    1
1986     #define DECOMPRESS_SECTION_SIZED 2
1987
1988       /* The following flags are used by the ELF linker. */
1989
1990       /* Mark sections which have been allocated to segments.  */
1991       unsigned int segment_mark : 1;
1992
1993       /* Type of sec_info information.  */
1994       unsigned int sec_info_type:3;
1995     #define SEC_INFO_TYPE_NONE      0
1996     #define SEC_INFO_TYPE_STABS     1
1997     #define SEC_INFO_TYPE_MERGE     2
1998     #define SEC_INFO_TYPE_EH_FRAME  3
1999     #define SEC_INFO_TYPE_JUST_SYMS 4
2000     #define SEC_INFO_TYPE_TARGET    5
2001     #define SEC_INFO_TYPE_EH_FRAME_ENTRY 6
2002
2003       /* Nonzero if this section uses RELA relocations, rather than REL.  */
2004       unsigned int use_rela_p:1;
2005
2006       /* Bits used by various backends.  The generic code doesn't touch
2007          these fields.  */
2008
2009       unsigned int sec_flg0:1;
2010       unsigned int sec_flg1:1;
2011       unsigned int sec_flg2:1;
2012       unsigned int sec_flg3:1;
2013       unsigned int sec_flg4:1;
2014       unsigned int sec_flg5:1;
2015
2016       /* End of internal packed boolean fields.  */
2017
2018       /*  The virtual memory address of the section - where it will be
2019           at run time.  The symbols are relocated against this.  The
2020           user_set_vma flag is maintained by bfd; if it's not set, the
2021           backend can assign addresses (for example, in a.out, where
2022           the default address for .data is dependent on the specific
2023           target and various flags).  */
2024       bfd_vma vma;
2025
2026       /*  The load address of the section - where it would be in a
2027           rom image; really only used for writing section header
2028           information.  */
2029       bfd_vma lma;
2030
2031       /* The size of the section in *octets*, as it will be output.
2032          Contains a value even if the section has no contents (e.g., the
2033          size of .bss).  */
2034       bfd_size_type size;
2035
2036       /* For input sections, the original size on disk of the section, in
2037          octets.  This field should be set for any section whose size is
2038          changed by linker relaxation.  It is required for sections where
2039          the linker relaxation scheme doesn't cache altered section and
2040          reloc contents (stabs, eh_frame, SEC_MERGE, some coff relaxing
2041          targets), and thus the original size needs to be kept to read the
2042          section multiple times.  For output sections, rawsize holds the
2043          section size calculated on a previous linker relaxation pass.  */
2044       bfd_size_type rawsize;
2045
2046       /* The compressed size of the section in octets.  */
2047       bfd_size_type compressed_size;
2048
2049       /* If this section is going to be output, then this value is the
2050          offset in *bytes* into the output section of the first byte in the
2051          input section (byte ==> smallest addressable unit on the
2052          target).  In most cases, if this was going to start at the
2053          100th octet (8-bit quantity) in the output section, this value
2054          would be 100.  However, if the target byte size is 16 bits
2055          (bfd_octets_per_byte is "2"), this value would be 50.  */
2056       bfd_vma output_offset;
2057
2058       /* The output section through which to map on output.  */
2059       struct bfd_section *output_section;
2060
2061       /* If an input section, a pointer to a vector of relocation
2062          records for the data in this section.  */
2063       struct reloc_cache_entry *relocation;
2064
2065       /* If an output section, a pointer to a vector of pointers to
2066          relocation records for the data in this section.  */
2067       struct reloc_cache_entry **orelocation;
2068
2069       /* The number of relocation records in one of the above.  */
2070       unsigned reloc_count;
2071
2072       /* The alignment requirement of the section, as an exponent of 2 -
2073          e.g., 3 aligns to 2^3 (or 8).  */
2074       unsigned int alignment_power;
2075
2076       /* Information below is back end specific - and not always used
2077          or updated.  */
2078
2079       /* File position of section data.  */
2080       file_ptr filepos;
2081
2082       /* File position of relocation info.  */
2083       file_ptr rel_filepos;
2084
2085       /* File position of line data.  */
2086       file_ptr line_filepos;
2087
2088       /* Pointer to data for applications.  */
2089       void *userdata;
2090
2091       /* If the SEC_IN_MEMORY flag is set, this points to the actual
2092          contents.  */
2093       unsigned char *contents;
2094
2095       /* Attached line number information.  */
2096       alent *lineno;
2097
2098       /* Number of line number records.  */
2099       unsigned int lineno_count;
2100
2101       /* Entity size for merging purposes.  */
2102       unsigned int entsize;
2103
2104       /* Points to the kept section if this section is a link-once section,
2105          and is discarded.  */
2106       struct bfd_section *kept_section;
2107
2108       /* When a section is being output, this value changes as more
2109          linenumbers are written out.  */
2110       file_ptr moving_line_filepos;
2111
2112       /* What the section number is in the target world.  */
2113       int target_index;
2114
2115       void *used_by_bfd;
2116
2117       /* If this is a constructor section then here is a list of the
2118          relocations created to relocate items within it.  */
2119       struct relent_chain *constructor_chain;
2120
2121       /* The BFD which owns the section.  */
2122       bfd *owner;
2123
2124       /* A symbol which points at this section only.  */
2125       struct bfd_symbol *symbol;
2126       struct bfd_symbol **symbol_ptr_ptr;
2127
2128       /* Early in the link process, map_head and map_tail are used to build
2129          a list of input sections attached to an output section.  Later,
2130          output sections use these fields for a list of bfd_link_order
2131          structs.  The linked_to_symbol_name field is for ELF assembler
2132          internal use.  */
2133       union {
2134         struct bfd_link_order *link_order;
2135         struct bfd_section *s;
2136         const char *linked_to_symbol_name;
2137       } map_head, map_tail;
2138
2139       /* Points to the output section this section is already assigned to,
2140          if any.  This is used when support for non-contiguous memory
2141          regions is enabled.  */
2142       struct bfd_section *already_assigned;
2143
2144       /* Explicitly specified section type, if non-zero.  */
2145       unsigned int type;
2146
2147     } asection;
2148
2149     static inline const char *
2150     bfd_section_name (const asection *sec)
2151     {
2152       return sec->name;
2153     }
2154
2155     static inline bfd_size_type
2156     bfd_section_size (const asection *sec)
2157     {
2158       return sec->size;
2159     }
2160
2161     static inline bfd_vma
2162     bfd_section_vma (const asection *sec)
2163     {
2164       return sec->vma;
2165     }
2166
2167     static inline bfd_vma
2168     bfd_section_lma (const asection *sec)
2169     {
2170       return sec->lma;
2171     }
2172
2173     static inline unsigned int
2174     bfd_section_alignment (const asection *sec)
2175     {
2176       return sec->alignment_power;
2177     }
2178
2179     static inline flagword
2180     bfd_section_flags (const asection *sec)
2181     {
2182       return sec->flags;
2183     }
2184
2185     static inline void *
2186     bfd_section_userdata (const asection *sec)
2187     {
2188       return sec->userdata;
2189     }
2190     static inline bool
2191     bfd_is_com_section (const asection *sec)
2192     {
2193       return (sec->flags & SEC_IS_COMMON) != 0;
2194     }
2195
2196     /* Note: the following are provided as inline functions rather than macros
2197        because not all callers use the return value.  A macro implementation
2198        would use a comma expression, eg: "((ptr)->foo = val, TRUE)" and some
2199        compilers will complain about comma expressions that have no effect.  */
2200     static inline bool
2201     bfd_set_section_userdata (asection *sec, void *val)
2202     {
2203       sec->userdata = val;
2204       return true;
2205     }
2206
2207     static inline bool
2208     bfd_set_section_vma (asection *sec, bfd_vma val)
2209     {
2210       sec->vma = sec->lma = val;
2211       sec->user_set_vma = true;
2212       return true;
2213     }
2214
2215     static inline bool
2216     bfd_set_section_lma (asection *sec, bfd_vma val)
2217     {
2218       sec->lma = val;
2219       return true;
2220     }
2221
2222     static inline bool
2223     bfd_set_section_alignment (asection *sec, unsigned int val)
2224     {
2225       sec->alignment_power = val;
2226       return true;
2227     }
2228
2229     /* These sections are global, and are managed by BFD.  The application
2230        and target back end are not permitted to change the values in
2231        these sections.  */
2232     extern asection _bfd_std_section[4];
2233
2234     #define BFD_ABS_SECTION_NAME "*ABS*"
2235     #define BFD_UND_SECTION_NAME "*UND*"
2236     #define BFD_COM_SECTION_NAME "*COM*"
2237     #define BFD_IND_SECTION_NAME "*IND*"
2238
2239     /* Pointer to the common section.  */
2240     #define bfd_com_section_ptr (&_bfd_std_section[0])
2241     /* Pointer to the undefined section.  */
2242     #define bfd_und_section_ptr (&_bfd_std_section[1])
2243     /* Pointer to the absolute section.  */
2244     #define bfd_abs_section_ptr (&_bfd_std_section[2])
2245     /* Pointer to the indirect section.  */
2246     #define bfd_ind_section_ptr (&_bfd_std_section[3])
2247
2248     static inline bool
2249     bfd_is_und_section (const asection *sec)
2250     {
2251       return sec == bfd_und_section_ptr;
2252     }
2253
2254     static inline bool
2255     bfd_is_abs_section (const asection *sec)
2256     {
2257       return sec == bfd_abs_section_ptr;
2258     }
2259
2260     static inline bool
2261     bfd_is_ind_section (const asection *sec)
2262     {
2263       return sec == bfd_ind_section_ptr;
2264     }
2265
2266     static inline bool
2267     bfd_is_const_section (const asection *sec)
2268     {
2269       return (sec >= _bfd_std_section
2270               && sec < _bfd_std_section + (sizeof (_bfd_std_section)
2271                                            / sizeof (_bfd_std_section[0])));
2272     }
2273
2274     /* Return TRUE if input section SEC has been discarded.  */
2275     static inline bool
2276     discarded_section (const asection *sec)
2277     {
2278       return (!bfd_is_abs_section (sec)
2279               && bfd_is_abs_section (sec->output_section)
2280               && sec->sec_info_type != SEC_INFO_TYPE_MERGE
2281               && sec->sec_info_type != SEC_INFO_TYPE_JUST_SYMS);
2282     }
2283
2284     #define BFD_FAKE_SECTION(SEC, SYM, NAME, IDX, FLAGS)                   \
2285       /* name, next, prev, id,  section_id, index, flags, user_set_vma, */ \
2286       {  NAME, NULL, NULL, IDX, 0,          0,     FLAGS, 0,               \
2287                                                                            \
2288       /* linker_mark, linker_has_input, gc_mark, decompress_status,     */ \
2289          0,           0,                1,       0,                        \
2290                                                                            \
2291       /* segment_mark, sec_info_type, use_rela_p,                       */ \
2292          0,            0,             0,                                   \
2293                                                                            \
2294       /* sec_flg0, sec_flg1, sec_flg2, sec_flg3, sec_flg4, sec_flg5,    */ \
2295          0,        0,        0,        0,        0,        0,              \
2296                                                                            \
2297       /* vma, lma, size, rawsize, compressed_size,                      */ \
2298          0,   0,   0,    0,       0,                                       \
2299                                                                            \
2300       /* output_offset, output_section, relocation, orelocation,        */ \
2301          0,             &SEC,           NULL,       NULL,                  \
2302                                                                            \
2303       /* reloc_count, alignment_power, filepos, rel_filepos,            */ \
2304          0,           0,               0,       0,                         \
2305                                                                            \
2306       /* line_filepos, userdata, contents, lineno, lineno_count,        */ \
2307          0,            NULL,     NULL,     NULL,   0,                      \
2308                                                                            \
2309       /* entsize, kept_section, moving_line_filepos,                    */ \
2310          0,       NULL,         0,                                         \
2311                                                                            \
2312       /* target_index, used_by_bfd, constructor_chain, owner,           */ \
2313          0,            NULL,        NULL,              NULL,               \
2314                                                                            \
2315       /* symbol,                    symbol_ptr_ptr,                     */ \
2316          (struct bfd_symbol *) SYM, &SEC.symbol,                           \
2317                                                                            \
2318       /* map_head, map_tail, already_assigned, type                     */ \
2319          { NULL }, { NULL }, NULL,             0                           \
2320                                                                            \
2321         }
2322
2323     /* We use a macro to initialize the static asymbol structures because
2324        traditional C does not permit us to initialize a union member while
2325        gcc warns if we don't initialize it.
2326        the_bfd, name, value, attr, section [, udata]  */
2327     #ifdef __STDC__
2328     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2329       { 0, NAME, 0, BSF_SECTION_SYM, SECTION, { 0 }}
2330     #else
2331     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2332       { 0, NAME, 0, BSF_SECTION_SYM, SECTION }
2333     #endif
2334
2335
2336
2337File: bfd.info,  Node: section prototypes,  Prev: typedef asection,  Up: Sections
2338
23392.6.5 Section prototypes
2340------------------------
2341
2342These are the functions exported by the section handling part of BFD.
2343
23442.6.5.1 'bfd_section_list_clear'
2345................................
2346
2347*Synopsis*
2348     void bfd_section_list_clear (bfd *);
2349   *Description*
2350Clears the section list, and also resets the section count and hash
2351table entries.
2352
23532.6.5.2 'bfd_get_section_by_name'
2354.................................
2355
2356*Synopsis*
2357     asection *bfd_get_section_by_name (bfd *abfd, const char *name);
2358   *Description*
2359Return the most recently created section attached to ABFD named NAME.
2360Return NULL if no such section exists.
2361
23622.6.5.3 'bfd_get_next_section_by_name'
2363......................................
2364
2365*Synopsis*
2366     asection *bfd_get_next_section_by_name (bfd *ibfd, asection *sec);
2367   *Description*
2368Given SEC is a section returned by 'bfd_get_section_by_name', return the
2369next most recently created section attached to the same BFD with the
2370same name, or if no such section exists in the same BFD and IBFD is
2371non-NULL, the next section with the same name in any input BFD following
2372IBFD. Return NULL on finding no section.
2373
23742.6.5.4 'bfd_get_linker_section'
2375................................
2376
2377*Synopsis*
2378     asection *bfd_get_linker_section (bfd *abfd, const char *name);
2379   *Description*
2380Return the linker created section attached to ABFD named NAME.  Return
2381NULL if no such section exists.
2382
23832.6.5.5 'bfd_get_section_by_name_if'
2384....................................
2385
2386*Synopsis*
2387     asection *bfd_get_section_by_name_if
2388        (bfd *abfd,
2389         const char *name,
2390         bool (*func) (bfd *abfd, asection *sect, void *obj),
2391         void *obj);
2392   *Description*
2393Call the provided function FUNC for each section attached to the BFD
2394ABFD whose name matches NAME, passing OBJ as an argument.  The function
2395will be called as if by
2396
2397            func (abfd, the_section, obj);
2398
2399   It returns the first section for which FUNC returns true, otherwise
2400'NULL'.
2401
24022.6.5.6 'bfd_get_unique_section_name'
2403.....................................
2404
2405*Synopsis*
2406     char *bfd_get_unique_section_name
2407        (bfd *abfd, const char *templat, int *count);
2408   *Description*
2409Invent a section name that is unique in ABFD by tacking a dot and a
2410digit suffix onto the original TEMPLAT.  If COUNT is non-NULL, then it
2411specifies the first number tried as a suffix to generate a unique name.
2412The value pointed to by COUNT will be incremented in this case.
2413
24142.6.5.7 'bfd_make_section_old_way'
2415..................................
2416
2417*Synopsis*
2418     asection *bfd_make_section_old_way (bfd *abfd, const char *name);
2419   *Description*
2420Create a new empty section called NAME and attach it to the end of the
2421chain of sections for the BFD ABFD.  An attempt to create a section with
2422a name which is already in use returns its pointer without changing the
2423section chain.
2424
2425   It has the funny name since this is the way it used to be before it
2426was rewritten....
2427
2428   Possible errors are:
2429
2430   * 'bfd_error_invalid_operation' - If output has already started for
2431     this BFD.
2432   * 'bfd_error_no_memory' - If memory allocation fails.
2433
24342.6.5.8 'bfd_make_section_anyway_with_flags'
2435............................................
2436
2437*Synopsis*
2438     asection *bfd_make_section_anyway_with_flags
2439        (bfd *abfd, const char *name, flagword flags);
2440   *Description*
2441Create a new empty section called NAME and attach it to the end of the
2442chain of sections for ABFD.  Create a new section even if there is
2443already a section with that name.  Also set the attributes of the new
2444section to the value FLAGS.
2445
2446   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2447
2448   * 'bfd_error_invalid_operation' - If output has already started for
2449     ABFD.
2450   * 'bfd_error_no_memory' - If memory allocation fails.
2451
24522.6.5.9 'bfd_make_section_anyway'
2453.................................
2454
2455*Synopsis*
2456     asection *bfd_make_section_anyway (bfd *abfd, const char *name);
2457   *Description*
2458Create a new empty section called NAME and attach it to the end of the
2459chain of sections for ABFD.  Create a new section even if there is
2460already a section with that name.
2461
2462   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2463
2464   * 'bfd_error_invalid_operation' - If output has already started for
2465     ABFD.
2466   * 'bfd_error_no_memory' - If memory allocation fails.
2467
24682.6.5.10 'bfd_make_section_with_flags'
2469......................................
2470
2471*Synopsis*
2472     asection *bfd_make_section_with_flags
2473        (bfd *, const char *name, flagword flags);
2474   *Description*
2475Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2476bfd_set_error ()) without changing the section chain if there is already
2477a section named NAME.  Also set the attributes of the new section to the
2478value FLAGS.  If there is an error, return 'NULL' and set 'bfd_error'.
2479
24802.6.5.11 'bfd_make_section'
2481...........................
2482
2483*Synopsis*
2484     asection *bfd_make_section (bfd *, const char *name);
2485   *Description*
2486Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2487bfd_set_error ()) without changing the section chain if there is already
2488a section named NAME.  If there is an error, return 'NULL' and set
2489'bfd_error'.
2490
24912.6.5.12 'bfd_set_section_flags'
2492................................
2493
2494*Synopsis*
2495     bool bfd_set_section_flags (asection *sec, flagword flags);
2496   *Description*
2497Set the attributes of the section SEC to the value FLAGS.  Return 'TRUE'
2498on success, 'FALSE' on error.  Possible error returns are:
2499
2500   * 'bfd_error_invalid_operation' - The section cannot have one or more
2501     of the attributes requested.  For example, a .bss section in
2502     'a.out' may not have the 'SEC_HAS_CONTENTS' field set.
2503
25042.6.5.13 'bfd_rename_section'
2505.............................
2506
2507*Synopsis*
2508     void bfd_rename_section
2509        (asection *sec, const char *newname);
2510   *Description*
2511Rename section SEC to NEWNAME.
2512
25132.6.5.14 'bfd_map_over_sections'
2514................................
2515
2516*Synopsis*
2517     void bfd_map_over_sections
2518        (bfd *abfd,
2519         void (*func) (bfd *abfd, asection *sect, void *obj),
2520         void *obj);
2521   *Description*
2522Call the provided function FUNC for each section attached to the BFD
2523ABFD, passing OBJ as an argument.  The function will be called as if by
2524
2525            func (abfd, the_section, obj);
2526
2527   This is the preferred method for iterating over sections; an
2528alternative would be to use a loop:
2529
2530               asection *p;
2531               for (p = abfd->sections; p != NULL; p = p->next)
2532                  func (abfd, p, ...)
2533
25342.6.5.15 'bfd_sections_find_if'
2535...............................
2536
2537*Synopsis*
2538     asection *bfd_sections_find_if
2539        (bfd *abfd,
2540         bool (*operation) (bfd *abfd, asection *sect, void *obj),
2541         void *obj);
2542   *Description*
2543Call the provided function OPERATION for each section attached to the
2544BFD ABFD, passing OBJ as an argument.  The function will be called as if
2545by
2546
2547            operation (abfd, the_section, obj);
2548
2549   It returns the first section for which OPERATION returns true.
2550
25512.6.5.16 'bfd_set_section_size'
2552...............................
2553
2554*Synopsis*
2555     bool bfd_set_section_size (asection *sec, bfd_size_type val);
2556   *Description*
2557Set SEC to the size VAL.  If the operation is ok, then 'TRUE' is
2558returned, else 'FALSE'.
2559
2560   Possible error returns:
2561
2562   * 'bfd_error_invalid_operation' - Writing has started to the BFD, so
2563     setting the size is invalid.
2564
25652.6.5.17 'bfd_set_section_contents'
2566...................................
2567
2568*Synopsis*
2569     bool bfd_set_section_contents
2570        (bfd *abfd, asection *section, const void *data,
2571         file_ptr offset, bfd_size_type count);
2572   *Description*
2573Sets the contents of the section SECTION in BFD ABFD to the data
2574starting in memory at LOCATION.  The data is written to the output
2575section starting at offset OFFSET for COUNT octets.
2576
2577   Normally 'TRUE' is returned, but 'FALSE' is returned if there was an
2578error.  Possible error returns are:
2579
2580   * 'bfd_error_no_contents' - The output section does not have the
2581     'SEC_HAS_CONTENTS' attribute, so nothing can be written to it.
2582   * 'bfd_error_bad_value' - The section is unable to contain all of the
2583     data.
2584   * 'bfd_error_invalid_operation' - The BFD is not writeable.
2585   * and some more too.
2586   This routine is front end to the back end function
2587'_bfd_set_section_contents'.
2588
25892.6.5.18 'bfd_get_section_contents'
2590...................................
2591
2592*Synopsis*
2593     bool bfd_get_section_contents
2594        (bfd *abfd, asection *section, void *location, file_ptr offset,
2595         bfd_size_type count);
2596   *Description*
2597Read data from SECTION in BFD ABFD into memory starting at LOCATION.
2598The data is read at an offset of OFFSET from the start of the input
2599section, and is read for COUNT bytes.
2600
2601   If the contents of a constructor with the 'SEC_CONSTRUCTOR' flag set
2602are requested or if the section does not have the 'SEC_HAS_CONTENTS'
2603flag set, then the LOCATION is filled with zeroes.  If no errors occur,
2604'TRUE' is returned, else 'FALSE'.
2605
26062.6.5.19 'bfd_malloc_and_get_section'
2607.....................................
2608
2609*Synopsis*
2610     bool bfd_malloc_and_get_section
2611        (bfd *abfd, asection *section, bfd_byte **buf);
2612   *Description*
2613Read all data from SECTION in BFD ABFD into a buffer, *BUF, malloc'd by
2614this function.
2615
26162.6.5.20 'bfd_copy_private_section_data'
2617........................................
2618
2619*Synopsis*
2620     bool bfd_copy_private_section_data
2621        (bfd *ibfd, asection *isec, bfd *obfd, asection *osec);
2622   *Description*
2623Copy private section information from ISEC in the BFD IBFD to the
2624section OSEC in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on
2625error.  Possible error returns are:
2626
2627   * 'bfd_error_no_memory' - Not enough memory exists to create private
2628     data for OSEC.
2629     #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
2630            BFD_SEND (obfd, _bfd_copy_private_section_data, \
2631                      (ibfd, isection, obfd, osection))
2632
26332.6.5.21 'bfd_generic_is_group_section'
2634.......................................
2635
2636*Synopsis*
2637     bool bfd_generic_is_group_section (bfd *, const asection *sec);
2638   *Description*
2639Returns TRUE if SEC is a member of a group.
2640
26412.6.5.22 'bfd_generic_group_name'
2642.................................
2643
2644*Synopsis*
2645     const char *bfd_generic_group_name (bfd *, const asection *sec);
2646   *Description*
2647Returns group name if SEC is a member of a group.
2648
26492.6.5.23 'bfd_generic_discard_group'
2650....................................
2651
2652*Synopsis*
2653     bool bfd_generic_discard_group (bfd *abfd, asection *group);
2654   *Description*
2655Remove all members of GROUP from the output.
2656
2657
2658File: bfd.info,  Node: Symbols,  Next: Archives,  Prev: Sections,  Up: BFD front end
2659
26602.7 Symbols
2661===========
2662
2663BFD tries to maintain as much symbol information as it can when it moves
2664information from file to file.  BFD passes information to applications
2665though the 'asymbol' structure.  When the application requests the
2666symbol table, BFD reads the table in the native form and translates
2667parts of it into the internal format.  To maintain more than the
2668information passed to applications, some targets keep some information
2669"behind the scenes" in a structure only the particular back end knows
2670about.  For example, the coff back end keeps the original symbol table
2671structure as well as the canonical structure when a BFD is read in.  On
2672output, the coff back end can reconstruct the output symbol table so
2673that no information is lost, even information unique to coff which BFD
2674doesn't know or understand.  If a coff symbol table were read, but were
2675written through an a.out back end, all the coff specific information
2676would be lost.  The symbol table of a BFD is not necessarily read in
2677until a canonicalize request is made.  Then the BFD back end fills in a
2678table provided by the application with pointers to the canonical
2679information.  To output symbols, the application provides BFD with a
2680table of pointers to pointers to 'asymbol's.  This allows applications
2681like the linker to output a symbol as it was read, since the "behind the
2682scenes" information will be still available.
2683* Menu:
2684
2685* Reading Symbols::
2686* Writing Symbols::
2687* Mini Symbols::
2688* typedef asymbol::
2689* symbol handling functions::
2690
2691
2692File: bfd.info,  Node: Reading Symbols,  Next: Writing Symbols,  Prev: Symbols,  Up: Symbols
2693
26942.7.1 Reading symbols
2695---------------------
2696
2697There are two stages to reading a symbol table from a BFD: allocating
2698storage, and the actual reading process.  This is an excerpt from an
2699application which reads the symbol table:
2700
2701              long storage_needed;
2702              asymbol **symbol_table;
2703              long number_of_symbols;
2704              long i;
2705
2706              storage_needed = bfd_get_symtab_upper_bound (abfd);
2707
2708              if (storage_needed < 0)
2709                FAIL
2710
2711              if (storage_needed == 0)
2712                return;
2713
2714              symbol_table = xmalloc (storage_needed);
2715                ...
2716              number_of_symbols =
2717                 bfd_canonicalize_symtab (abfd, symbol_table);
2718
2719              if (number_of_symbols < 0)
2720                FAIL
2721
2722              for (i = 0; i < number_of_symbols; i++)
2723                process_symbol (symbol_table[i]);
2724
2725   All storage for the symbols themselves is in an objalloc connected to
2726the BFD; it is freed when the BFD is closed.
2727
2728
2729File: bfd.info,  Node: Writing Symbols,  Next: Mini Symbols,  Prev: Reading Symbols,  Up: Symbols
2730
27312.7.2 Writing symbols
2732---------------------
2733
2734Writing of a symbol table is automatic when a BFD open for writing is
2735closed.  The application attaches a vector of pointers to pointers to
2736symbols to the BFD being written, and fills in the symbol count.  The
2737close and cleanup code reads through the table provided and performs all
2738the necessary operations.  The BFD output code must always be provided
2739with an "owned" symbol: one which has come from another BFD, or one
2740which has been created using 'bfd_make_empty_symbol'.  Here is an
2741example showing the creation of a symbol table with only one element:
2742
2743            #include "sysdep.h"
2744            #include "bfd.h"
2745            int main (void)
2746            {
2747              bfd *abfd;
2748              asymbol *ptrs[2];
2749              asymbol *new;
2750
2751              abfd = bfd_openw ("foo","a.out-sunos-big");
2752              bfd_set_format (abfd, bfd_object);
2753              new = bfd_make_empty_symbol (abfd);
2754              new->name = "dummy_symbol";
2755              new->section = bfd_make_section_old_way (abfd, ".text");
2756              new->flags = BSF_GLOBAL;
2757              new->value = 0x12345;
2758
2759              ptrs[0] = new;
2760              ptrs[1] = 0;
2761
2762              bfd_set_symtab (abfd, ptrs, 1);
2763              bfd_close (abfd);
2764              return 0;
2765            }
2766
2767            ./makesym
2768            nm foo
2769            00012345 A dummy_symbol
2770
2771   Many formats cannot represent arbitrary symbol information; for
2772instance, the 'a.out' object format does not allow an arbitrary number
2773of sections.  A symbol pointing to a section which is not one of
2774'.text', '.data' or '.bss' cannot be described.
2775
2776
2777File: bfd.info,  Node: Mini Symbols,  Next: typedef asymbol,  Prev: Writing Symbols,  Up: Symbols
2778
27792.7.3 Mini Symbols
2780------------------
2781
2782Mini symbols provide read-only access to the symbol table.  They use
2783less memory space, but require more time to access.  They can be useful
2784for tools like nm or objdump, which may have to handle symbol tables of
2785extremely large executables.
2786
2787   The 'bfd_read_minisymbols' function will read the symbols into memory
2788in an internal form.  It will return a 'void *' pointer to a block of
2789memory, a symbol count, and the size of each symbol.  The pointer is
2790allocated using 'malloc', and should be freed by the caller when it is
2791no longer needed.
2792
2793   The function 'bfd_minisymbol_to_symbol' will take a pointer to a
2794minisymbol, and a pointer to a structure returned by
2795'bfd_make_empty_symbol', and return a 'asymbol' structure.  The return
2796value may or may not be the same as the value from
2797'bfd_make_empty_symbol' which was passed in.
2798
2799
2800File: bfd.info,  Node: typedef asymbol,  Next: symbol handling functions,  Prev: Mini Symbols,  Up: Symbols
2801
28022.7.4 typedef asymbol
2803---------------------
2804
2805An 'asymbol' has the form:
2806
2807
2808     typedef struct bfd_symbol
2809     {
2810       /* A pointer to the BFD which owns the symbol. This information
2811          is necessary so that a back end can work out what additional
2812          information (invisible to the application writer) is carried
2813          with the symbol.
2814
2815          This field is *almost* redundant, since you can use section->owner
2816          instead, except that some symbols point to the global sections
2817          bfd_{abs,com,und}_section.  This could be fixed by making
2818          these globals be per-bfd (or per-target-flavor).  FIXME.  */
2819       struct bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field.  */
2820
2821       /* The text of the symbol. The name is left alone, and not copied; the
2822          application may not alter it.  */
2823       const char *name;
2824
2825       /* The value of the symbol.  This really should be a union of a
2826          numeric value with a pointer, since some flags indicate that
2827          a pointer to another symbol is stored here.  */
2828       symvalue value;
2829
2830       /* Attributes of a symbol.  */
2831     #define BSF_NO_FLAGS            0
2832
2833       /* The symbol has local scope; static in C. The value
2834          is the offset into the section of the data.  */
2835     #define BSF_LOCAL               (1 << 0)
2836
2837       /* The symbol has global scope; initialized data in C. The
2838          value is the offset into the section of the data.  */
2839     #define BSF_GLOBAL              (1 << 1)
2840
2841       /* The symbol has global scope and is exported. The value is
2842          the offset into the section of the data.  */
2843     #define BSF_EXPORT              BSF_GLOBAL /* No real difference.  */
2844
2845       /* A normal C symbol would be one of:
2846          BSF_LOCAL, BSF_UNDEFINED or BSF_GLOBAL.  */
2847
2848       /* The symbol is a debugging record. The value has an arbitrary
2849          meaning, unless BSF_DEBUGGING_RELOC is also set.  */
2850     #define BSF_DEBUGGING           (1 << 2)
2851
2852       /* The symbol denotes a function entry point.  Used in ELF,
2853          perhaps others someday.  */
2854     #define BSF_FUNCTION            (1 << 3)
2855
2856       /* Used by the linker.  */
2857     #define BSF_KEEP                (1 << 5)
2858
2859       /* An ELF common symbol.  */
2860     #define BSF_ELF_COMMON          (1 << 6)
2861
2862       /* A weak global symbol, overridable without warnings by
2863          a regular global symbol of the same name.  */
2864     #define BSF_WEAK                (1 << 7)
2865
2866       /* This symbol was created to point to a section, e.g. ELF's
2867          STT_SECTION symbols.  */
2868     #define BSF_SECTION_SYM         (1 << 8)
2869
2870       /* The symbol used to be a common symbol, but now it is
2871          allocated.  */
2872     #define BSF_OLD_COMMON          (1 << 9)
2873
2874       /* In some files the type of a symbol sometimes alters its
2875          location in an output file - ie in coff a ISFCN symbol
2876          which is also C_EXT symbol appears where it was
2877          declared and not at the end of a section.  This bit is set
2878          by the target BFD part to convey this information.  */
2879     #define BSF_NOT_AT_END          (1 << 10)
2880
2881       /* Signal that the symbol is the label of constructor section.  */
2882     #define BSF_CONSTRUCTOR         (1 << 11)
2883
2884       /* Signal that the symbol is a warning symbol.  The name is a
2885          warning.  The name of the next symbol is the one to warn about;
2886          if a reference is made to a symbol with the same name as the next
2887          symbol, a warning is issued by the linker.  */
2888     #define BSF_WARNING             (1 << 12)
2889
2890       /* Signal that the symbol is indirect.  This symbol is an indirect
2891          pointer to the symbol with the same name as the next symbol.  */
2892     #define BSF_INDIRECT            (1 << 13)
2893
2894       /* BSF_FILE marks symbols that contain a file name.  This is used
2895          for ELF STT_FILE symbols.  */
2896     #define BSF_FILE                (1 << 14)
2897
2898       /* Symbol is from dynamic linking information.  */
2899     #define BSF_DYNAMIC             (1 << 15)
2900
2901       /* The symbol denotes a data object.  Used in ELF, and perhaps
2902          others someday.  */
2903     #define BSF_OBJECT              (1 << 16)
2904
2905       /* This symbol is a debugging symbol.  The value is the offset
2906          into the section of the data.  BSF_DEBUGGING should be set
2907          as well.  */
2908     #define BSF_DEBUGGING_RELOC     (1 << 17)
2909
2910       /* This symbol is thread local.  Used in ELF.  */
2911     #define BSF_THREAD_LOCAL        (1 << 18)
2912
2913       /* This symbol represents a complex relocation expression,
2914          with the expression tree serialized in the symbol name.  */
2915     #define BSF_RELC                (1 << 19)
2916
2917       /* This symbol represents a signed complex relocation expression,
2918          with the expression tree serialized in the symbol name.  */
2919     #define BSF_SRELC               (1 << 20)
2920
2921       /* This symbol was created by bfd_get_synthetic_symtab.  */
2922     #define BSF_SYNTHETIC           (1 << 21)
2923
2924       /* This symbol is an indirect code object.  Unrelated to BSF_INDIRECT.
2925          The dynamic linker will compute the value of this symbol by
2926          calling the function that it points to.  BSF_FUNCTION must
2927          also be also set.  */
2928     #define BSF_GNU_INDIRECT_FUNCTION (1 << 22)
2929       /* This symbol is a globally unique data object.  The dynamic linker
2930          will make sure that in the entire process there is just one symbol
2931          with this name and type in use.  BSF_OBJECT must also be set.  */
2932     #define BSF_GNU_UNIQUE          (1 << 23)
2933
2934       /* This section symbol should be included in the symbol table.  */
2935     #define BSF_SECTION_SYM_USED    (1 << 24)
2936
2937       flagword flags;
2938
2939       /* A pointer to the section to which this symbol is
2940          relative.  This will always be non NULL, there are special
2941          sections for undefined and absolute symbols.  */
2942       struct bfd_section *section;
2943
2944       /* Back end special data.  */
2945       union
2946         {
2947           void *p;
2948           bfd_vma i;
2949         }
2950       udata;
2951     }
2952     asymbol;
2953
2954
2955
2956File: bfd.info,  Node: symbol handling functions,  Prev: typedef asymbol,  Up: Symbols
2957
29582.7.5 Symbol handling functions
2959-------------------------------
2960
29612.7.5.1 'bfd_get_symtab_upper_bound'
2962....................................
2963
2964*Description*
2965Return the number of bytes required to store a vector of pointers to
2966'asymbols' for all the symbols in the BFD ABFD, including a terminal
2967NULL pointer.  If there are no symbols in the BFD, then return 0.  If an
2968error occurs, return -1.
2969     #define bfd_get_symtab_upper_bound(abfd) \
2970            BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
2971
2972
29732.7.5.2 'bfd_is_local_label'
2974............................
2975
2976*Synopsis*
2977     bool bfd_is_local_label (bfd *abfd, asymbol *sym);
2978   *Description*
2979Return TRUE if the given symbol SYM in the BFD ABFD is a compiler
2980generated local label, else return FALSE.
2981
29822.7.5.3 'bfd_is_local_label_name'
2983.................................
2984
2985*Synopsis*
2986     bool bfd_is_local_label_name (bfd *abfd, const char *name);
2987   *Description*
2988Return TRUE if a symbol with the name NAME in the BFD ABFD is a compiler
2989generated local label, else return FALSE. This just checks whether the
2990name has the form of a local label.
2991     #define bfd_is_local_label_name(abfd, name) \
2992            BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
2993
2994
29952.7.5.4 'bfd_is_target_special_symbol'
2996......................................
2997
2998*Synopsis*
2999     bool bfd_is_target_special_symbol (bfd *abfd, asymbol *sym);
3000   *Description*
3001Return TRUE iff a symbol SYM in the BFD ABFD is something special to the
3002particular target represented by the BFD. Such symbols should normally
3003not be mentioned to the user.
3004     #define bfd_is_target_special_symbol(abfd, sym) \
3005            BFD_SEND (abfd, _bfd_is_target_special_symbol, (abfd, sym))
3006
3007
30082.7.5.5 'bfd_canonicalize_symtab'
3009.................................
3010
3011*Description*
3012Read the symbols from the BFD ABFD, and fills in the vector LOCATION
3013with pointers to the symbols and a trailing NULL. Return the actual
3014number of symbol pointers, not including the NULL.
3015     #define bfd_canonicalize_symtab(abfd, location) \
3016            BFD_SEND (abfd, _bfd_canonicalize_symtab, (abfd, location))
3017
3018
30192.7.5.6 'bfd_set_symtab'
3020........................
3021
3022*Synopsis*
3023     bool bfd_set_symtab
3024        (bfd *abfd, asymbol **location, unsigned int count);
3025   *Description*
3026Arrange that when the output BFD ABFD is closed, the table LOCATION of
3027COUNT pointers to symbols will be written.
3028
30292.7.5.7 'bfd_print_symbol_vandf'
3030................................
3031
3032*Synopsis*
3033     void bfd_print_symbol_vandf (bfd *abfd, void *file, asymbol *symbol);
3034   *Description*
3035Print the value and flags of the SYMBOL supplied to the stream FILE.
3036
30372.7.5.8 'bfd_make_empty_symbol'
3038...............................
3039
3040*Description*
3041Create a new 'asymbol' structure for the BFD ABFD and return a pointer
3042to it.
3043
3044   This routine is necessary because each back end has private
3045information surrounding the 'asymbol'.  Building your own 'asymbol' and
3046pointing to it will not create the private information, and will cause
3047problems later on.
3048     #define bfd_make_empty_symbol(abfd) \
3049            BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
3050
3051
30522.7.5.9 '_bfd_generic_make_empty_symbol'
3053........................................
3054
3055*Synopsis*
3056     asymbol *_bfd_generic_make_empty_symbol (bfd *);
3057   *Description*
3058Create a new 'asymbol' structure for the BFD ABFD and return a pointer
3059to it.  Used by core file routines, binary back-end and anywhere else
3060where no private info is needed.
3061
30622.7.5.10 'bfd_make_debug_symbol'
3063................................
3064
3065*Description*
3066Create a new 'asymbol' structure for the BFD ABFD, to be used as a
3067debugging symbol.  Further details of its use have yet to be worked out.
3068     #define bfd_make_debug_symbol(abfd,ptr,size) \
3069            BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
3070
3071
30722.7.5.11 'bfd_decode_symclass'
3073..............................
3074
3075*Description*
3076Return a character corresponding to the symbol class of SYMBOL, or '?'
3077for an unknown class.
3078
3079   *Synopsis*
3080     int bfd_decode_symclass (asymbol *symbol);
3081
30822.7.5.12 'bfd_is_undefined_symclass'
3083....................................
3084
3085*Description*
3086Returns non-zero if the class symbol returned by bfd_decode_symclass
3087represents an undefined symbol.  Returns zero otherwise.
3088
3089   *Synopsis*
3090     bool bfd_is_undefined_symclass (int symclass);
3091
30922.7.5.13 'bfd_symbol_info'
3093..........................
3094
3095*Description*
3096Fill in the basic info about symbol that nm needs.  Additional info may
3097be added by the back-ends after calling this function.
3098
3099   *Synopsis*
3100     void bfd_symbol_info (asymbol *symbol, symbol_info *ret);
3101
31022.7.5.14 'bfd_copy_private_symbol_data'
3103.......................................
3104
3105*Synopsis*
3106     bool bfd_copy_private_symbol_data
3107        (bfd *ibfd, asymbol *isym, bfd *obfd, asymbol *osym);
3108   *Description*
3109Copy private symbol information from ISYM in the BFD IBFD to the symbol
3110OSYM in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on error.
3111Possible error returns are:
3112
3113   * 'bfd_error_no_memory' - Not enough memory exists to create private
3114     data for OSEC.
3115     #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
3116            BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
3117                      (ibfd, isymbol, obfd, osymbol))
3118
3119
3120
3121File: bfd.info,  Node: Archives,  Next: Formats,  Prev: Symbols,  Up: BFD front end
3122
31232.8 Archives
3124============
3125
3126*Description*
3127An archive (or library) is just another BFD. It has a symbol table,
3128although there's not much a user program will do with it.
3129
3130   The big difference between an archive BFD and an ordinary BFD is that
3131the archive doesn't have sections.  Instead it has a chain of BFDs that
3132are considered its contents.  These BFDs can be manipulated like any
3133other.  The BFDs contained in an archive opened for reading will all be
3134opened for reading.  You may put either input or output BFDs into an
3135archive opened for output; they will be handled correctly when the
3136archive is closed.
3137
3138   Use 'bfd_openr_next_archived_file' to step through the contents of an
3139archive opened for input.  You don't have to read the entire archive if
3140you don't want to!  Read it until you find what you want.
3141
3142   A BFD returned by 'bfd_openr_next_archived_file' can be closed
3143manually with 'bfd_close'.  If you do not close it, then a second
3144iteration through the members of an archive may return the same BFD. If
3145you close the archive BFD, then all the member BFDs will automatically
3146be closed as well.
3147
3148   Archive contents of output BFDs are chained through the
3149'archive_next' pointer in a BFD. The first one is findable through the
3150'archive_head' slot of the archive.  Set it with 'bfd_set_archive_head'
3151(q.v.).  A given BFD may be in only one open output archive at a time.
3152
3153   As expected, the BFD archive code is more general than the archive
3154code of any given environment.  BFD archives may contain files of
3155different formats (e.g., a.out and coff) and even different
3156architectures.  You may even place archives recursively into archives!
3157
3158   This can cause unexpected confusion, since some archive formats are
3159more expressive than others.  For instance, Intel COFF archives can
3160preserve long filenames; SunOS a.out archives cannot.  If you move a
3161file from the first to the second format and back again, the filename
3162may be truncated.  Likewise, different a.out environments have different
3163conventions as to how they truncate filenames, whether they preserve
3164directory names in filenames, etc.  When interoperating with native
3165tools, be sure your files are homogeneous.
3166
3167   Beware: most of these formats do not react well to the presence of
3168spaces in filenames.  We do the best we can, but can't always handle
3169this case due to restrictions in the format of archives.  Many Unix
3170utilities are braindead in regards to spaces and such in filenames
3171anyway, so this shouldn't be much of a restriction.
3172
3173   Archives are supported in BFD in 'archive.c'.
3174
31752.8.1 Archive functions
3176-----------------------
3177
31782.8.1.1 'bfd_get_next_mapent'
3179.............................
3180
3181*Synopsis*
3182     symindex bfd_get_next_mapent
3183        (bfd *abfd, symindex previous, carsym **sym);
3184   *Description*
3185Step through archive ABFD's symbol table (if it has one).  Successively
3186update SYM with the next symbol's information, returning that symbol's
3187(internal) index into the symbol table.
3188
3189   Supply 'BFD_NO_MORE_SYMBOLS' as the PREVIOUS entry to get the first
3190one; returns 'BFD_NO_MORE_SYMBOLS' when you've already got the last one.
3191
3192   A 'carsym' is a canonical archive symbol.  The only user-visible
3193element is its name, a null-terminated string.
3194
31952.8.1.2 'bfd_set_archive_head'
3196..............................
3197
3198*Synopsis*
3199     bool bfd_set_archive_head (bfd *output, bfd *new_head);
3200   *Description*
3201Set the head of the chain of BFDs contained in the archive OUTPUT to
3202NEW_HEAD.
3203
32042.8.1.3 'bfd_openr_next_archived_file'
3205......................................
3206
3207*Synopsis*
3208     bfd *bfd_openr_next_archived_file (bfd *archive, bfd *previous);
3209   *Description*
3210Provided a BFD, ARCHIVE, containing an archive and NULL, open an input
3211BFD on the first contained element and returns that.  Subsequent calls
3212should pass the archive and the previous return value to return a
3213created BFD to the next contained element.  NULL is returned when there
3214are no more.  Note - if you want to process the bfd returned by this
3215call be sure to call bfd_check_format() on it first.
3216
3217
3218File: bfd.info,  Node: Formats,  Next: Relocations,  Prev: Archives,  Up: BFD front end
3219
32202.9 File formats
3221================
3222
3223A format is a BFD concept of high level file contents type.  The formats
3224supported by BFD are:
3225
3226   * 'bfd_object'
3227   The BFD may contain data, symbols, relocations and debug info.
3228
3229   * 'bfd_archive'
3230   The BFD contains other BFDs and an optional index.
3231
3232   * 'bfd_core'
3233   The BFD contains the result of an executable core dump.
3234
32352.9.1 File format functions
3236---------------------------
3237
32382.9.1.1 'bfd_check_format'
3239..........................
3240
3241*Synopsis*
3242     bool bfd_check_format (bfd *abfd, bfd_format format);
3243   *Description*
3244Verify if the file attached to the BFD ABFD is compatible with the
3245format FORMAT (i.e., one of 'bfd_object', 'bfd_archive' or 'bfd_core').
3246
3247   If the BFD has been set to a specific target before the call, only
3248the named target and format combination is checked.  If the target has
3249not been set, or has been set to 'default', then all the known target
3250backends is interrogated to determine a match.  If the default target
3251matches, it is used.  If not, exactly one target must recognize the
3252file, or an error results.
3253
3254   The function returns 'TRUE' on success, otherwise 'FALSE' with one of
3255the following error codes:
3256
3257   * 'bfd_error_invalid_operation' - if 'format' is not one of
3258     'bfd_object', 'bfd_archive' or 'bfd_core'.
3259
3260   * 'bfd_error_system_call' - if an error occured during a read - even
3261     some file mismatches can cause bfd_error_system_calls.
3262
3263   * 'file_not_recognised' - none of the backends recognised the file
3264     format.
3265
3266   * 'bfd_error_file_ambiguously_recognized' - more than one backend
3267     recognised the file format.
3268
32692.9.1.2 'bfd_check_format_matches'
3270..................................
3271
3272*Synopsis*
3273     bool bfd_check_format_matches
3274        (bfd *abfd, bfd_format format, char ***matching);
3275   *Description*
3276Like 'bfd_check_format', except when it returns FALSE with 'bfd_errno'
3277set to 'bfd_error_file_ambiguously_recognized'.  In that case, if
3278MATCHING is not NULL, it will be filled in with a NULL-terminated list
3279of the names of the formats that matched, allocated with 'malloc'.  Then
3280the user may choose a format and try again.
3281
3282   When done with the list that MATCHING points to, the caller should
3283free it.
3284
32852.9.1.3 'bfd_set_format'
3286........................
3287
3288*Synopsis*
3289     bool bfd_set_format (bfd *abfd, bfd_format format);
3290   *Description*
3291This function sets the file format of the BFD ABFD to the format FORMAT.
3292If the target set in the BFD does not support the format requested, the
3293format is invalid, or the BFD is not open for writing, then an error
3294occurs.
3295
32962.9.1.4 'bfd_format_string'
3297...........................
3298
3299*Synopsis*
3300     const char *bfd_format_string (bfd_format format);
3301   *Description*
3302Return a pointer to a const string 'invalid', 'object', 'archive',
3303'core', or 'unknown', depending upon the value of FORMAT.
3304
3305
3306File: bfd.info,  Node: Relocations,  Next: Core Files,  Prev: Formats,  Up: BFD front end
3307
33082.10 Relocations
3309================
3310
3311BFD maintains relocations in much the same way it maintains symbols:
3312they are left alone until required, then read in en-masse and translated
3313into an internal form.  A common routine 'bfd_perform_relocation' acts
3314upon the canonical form to do the fixup.
3315
3316   Relocations are maintained on a per section basis, while symbols are
3317maintained on a per BFD basis.
3318
3319   All that a back end has to do to fit the BFD interface is to create a
3320'struct reloc_cache_entry' for each relocation in a particular section,
3321and fill in the right bits of the structures.
3322
3323* Menu:
3324
3325* typedef arelent::
3326* howto manager::
3327
3328
3329File: bfd.info,  Node: typedef arelent,  Next: howto manager,  Prev: Relocations,  Up: Relocations
3330
33312.10.1 typedef arelent
3332----------------------
3333
3334This is the structure of a relocation entry:
3335
3336
3337     typedef enum bfd_reloc_status
3338     {
3339       /* No errors detected.  Note - the value 2 is used so that it
3340          will not be mistaken for the boolean TRUE or FALSE values.  */
3341       bfd_reloc_ok = 2,
3342
3343       /* The relocation was performed, but there was an overflow.  */
3344       bfd_reloc_overflow,
3345
3346       /* The address to relocate was not within the section supplied.  */
3347       bfd_reloc_outofrange,
3348
3349       /* Used by special functions.  */
3350       bfd_reloc_continue,
3351
3352       /* Unsupported relocation size requested.  */
3353       bfd_reloc_notsupported,
3354
3355       /* Unused.  */
3356       bfd_reloc_other,
3357
3358       /* The symbol to relocate against was undefined.  */
3359       bfd_reloc_undefined,
3360
3361       /* The relocation was performed, but may not be ok.  If this type is
3362          returned, the error_message argument to bfd_perform_relocation
3363          will be set.  */
3364       bfd_reloc_dangerous
3365      }
3366      bfd_reloc_status_type;
3367
3368     typedef const struct reloc_howto_struct reloc_howto_type;
3369
3370     typedef struct reloc_cache_entry
3371     {
3372       /* A pointer into the canonical table of pointers.  */
3373       struct bfd_symbol **sym_ptr_ptr;
3374
3375       /* offset in section.  */
3376       bfd_size_type address;
3377
3378       /* addend for relocation value.  */
3379       bfd_vma addend;
3380
3381       /* Pointer to how to perform the required relocation.  */
3382       reloc_howto_type *howto;
3383
3384     }
3385     arelent;
3386
3387   *Description*
3388Here is a description of each of the fields within an 'arelent':
3389
3390   * 'sym_ptr_ptr'
3391   The symbol table pointer points to a pointer to the symbol associated
3392with the relocation request.  It is the pointer into the table returned
3393by the back end's 'canonicalize_symtab' action.  *Note Symbols::.  The
3394symbol is referenced through a pointer to a pointer so that tools like
3395the linker can fix up all the symbols of the same name by modifying only
3396one pointer.  The relocation routine looks in the symbol and uses the
3397base of the section the symbol is attached to and the value of the
3398symbol as the initial relocation offset.  If the symbol pointer is zero,
3399then the section provided is looked up.
3400
3401   * 'address'
3402   The 'address' field gives the offset in bytes from the base of the
3403section data which owns the relocation record to the first byte of
3404relocatable information.  The actual data relocated will be relative to
3405this point; for example, a relocation type which modifies the bottom two
3406bytes of a four byte word would not touch the first byte pointed to in a
3407big endian world.
3408
3409   * 'addend'
3410   The 'addend' is a value provided by the back end to be added (!)  to
3411the relocation offset.  Its interpretation is dependent upon the howto.
3412For example, on the 68k the code:
3413
3414             char foo[];
3415             main()
3416                     {
3417                     return foo[0x12345678];
3418                     }
3419
3420   Could be compiled into:
3421
3422             linkw fp,#-4
3423             moveb @#12345678,d0
3424             extbl d0
3425             unlk fp
3426             rts
3427
3428   This could create a reloc pointing to 'foo', but leave the offset in
3429the data, something like:
3430
3431     RELOCATION RECORDS FOR [.text]:
3432     offset   type      value
3433     00000006 32        _foo
3434
3435     00000000 4e56 fffc          ; linkw fp,#-4
3436     00000004 1039 1234 5678     ; moveb @#12345678,d0
3437     0000000a 49c0               ; extbl d0
3438     0000000c 4e5e               ; unlk fp
3439     0000000e 4e75               ; rts
3440
3441   Using coff and an 88k, some instructions don't have enough space in
3442them to represent the full address range, and pointers have to be loaded
3443in two parts.  So you'd get something like:
3444
3445             or.u     r13,r0,hi16(_foo+0x12345678)
3446             ld.b     r2,r13,lo16(_foo+0x12345678)
3447             jmp      r1
3448
3449   This should create two relocs, both pointing to '_foo', and with
34500x12340000 in their addend field.  The data would consist of:
3451
3452     RELOCATION RECORDS FOR [.text]:
3453     offset   type      value
3454     00000002 HVRT16    _foo+0x12340000
3455     00000006 LVRT16    _foo+0x12340000
3456
3457     00000000 5da05678           ; or.u r13,r0,0x5678
3458     00000004 1c4d5678           ; ld.b r2,r13,0x5678
3459     00000008 f400c001           ; jmp r1
3460
3461   The relocation routine digs out the value from the data, adds it to
3462the addend to get the original offset, and then adds the value of
3463'_foo'.  Note that all 32 bits have to be kept around somewhere, to cope
3464with carry from bit 15 to bit 16.
3465
3466   One further example is the sparc and the a.out format.  The sparc has
3467a similar problem to the 88k, in that some instructions don't have room
3468for an entire offset, but on the sparc the parts are created in odd
3469sized lumps.  The designers of the a.out format chose to not use the
3470data within the section for storing part of the offset; all the offset
3471is kept within the reloc.  Anything in the data should be ignored.
3472
3473             save %sp,-112,%sp
3474             sethi %hi(_foo+0x12345678),%g2
3475             ldsb [%g2+%lo(_foo+0x12345678)],%i0
3476             ret
3477             restore
3478
3479   Both relocs contain a pointer to 'foo', and the offsets contain junk.
3480
3481     RELOCATION RECORDS FOR [.text]:
3482     offset   type      value
3483     00000004 HI22      _foo+0x12345678
3484     00000008 LO10      _foo+0x12345678
3485
3486     00000000 9de3bf90     ; save %sp,-112,%sp
3487     00000004 05000000     ; sethi %hi(_foo+0),%g2
3488     00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
3489     0000000c 81c7e008     ; ret
3490     00000010 81e80000     ; restore
3491
3492   * 'howto'
3493   The 'howto' field can be imagined as a relocation instruction.  It is
3494a pointer to a structure which contains information on what to do with
3495all of the other information in the reloc record and data section.  A
3496back end would normally have a relocation instruction set and turn
3497relocations into pointers to the correct structure on input - but it
3498would be possible to create each howto field on demand.
3499
35002.10.1.1 'enum complain_overflow'
3501.................................
3502
3503Indicates what sort of overflow checking should be done when performing
3504a relocation.
3505
3506
3507     enum complain_overflow
3508     {
3509       /* Do not complain on overflow.  */
3510       complain_overflow_dont,
3511
3512       /* Complain if the value overflows when considered as a signed
3513          number one bit larger than the field.  ie. A bitfield of N bits
3514          is allowed to represent -2**n to 2**n-1.  */
3515       complain_overflow_bitfield,
3516
3517       /* Complain if the value overflows when considered as a signed
3518          number.  */
3519       complain_overflow_signed,
3520
3521       /* Complain if the value overflows when considered as an
3522          unsigned number.  */
3523       complain_overflow_unsigned
3524     };
3525
35262.10.1.2 'reloc_howto_type'
3527...........................
3528
3529The 'reloc_howto_type' is a structure which contains all the information
3530that libbfd needs to know to tie up a back end's data.
3531
3532     struct reloc_howto_struct
3533     {
3534       /* The type field has mainly a documentary use - the back end can
3535          do what it wants with it, though normally the back end's idea of
3536          an external reloc number is stored in this field.  */
3537       unsigned int type;
3538
3539       /* The size of the item to be relocated in bytes.  */
3540       unsigned int size:4;
3541
3542       /* The number of bits in the field to be relocated.  This is used
3543          when doing overflow checking.  */
3544       unsigned int bitsize:7;
3545
3546       /* The value the final relocation is shifted right by.  This drops
3547          unwanted data from the relocation.  */
3548       unsigned int rightshift:6;
3549
3550       /* The bit position of the reloc value in the destination.
3551          The relocated value is left shifted by this amount.  */
3552       unsigned int bitpos:6;
3553
3554       /* What type of overflow error should be checked for when
3555          relocating.  */
3556       ENUM_BITFIELD (complain_overflow) complain_on_overflow:2;
3557
3558       /* The relocation value should be negated before applying.  */
3559       unsigned int negate:1;
3560
3561       /* The relocation is relative to the item being relocated.  */
3562       unsigned int pc_relative:1;
3563
3564       /* Some formats record a relocation addend in the section contents
3565          rather than with the relocation.  For ELF formats this is the
3566          distinction between USE_REL and USE_RELA (though the code checks
3567          for USE_REL == 1/0).  The value of this field is TRUE if the
3568          addend is recorded with the section contents; when performing a
3569          partial link (ld -r) the section contents (the data) will be
3570          modified.  The value of this field is FALSE if addends are
3571          recorded with the relocation (in arelent.addend); when performing
3572          a partial link the relocation will be modified.
3573          All relocations for all ELF USE_RELA targets should set this field
3574          to FALSE (values of TRUE should be looked on with suspicion).
3575          However, the converse is not true: not all relocations of all ELF
3576          USE_REL targets set this field to TRUE.  Why this is so is peculiar
3577          to each particular target.  For relocs that aren't used in partial
3578          links (e.g. GOT stuff) it doesn't matter what this is set to.  */
3579       unsigned int partial_inplace:1;
3580
3581       /* When some formats create PC relative instructions, they leave
3582          the value of the pc of the place being relocated in the offset
3583          slot of the instruction, so that a PC relative relocation can
3584          be made just by adding in an ordinary offset (e.g., sun3 a.out).
3585          Some formats leave the displacement part of an instruction
3586          empty (e.g., ELF); this flag signals the fact.  */
3587       unsigned int pcrel_offset:1;
3588
3589       /* src_mask selects the part of the instruction (or data) to be used
3590          in the relocation sum.  If the target relocations don't have an
3591          addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
3592          dst_mask to extract the addend from the section contents.  If
3593          relocations do have an addend in the reloc, eg. ELF USE_RELA, this
3594          field should normally be zero.  Non-zero values for ELF USE_RELA
3595          targets should be viewed with suspicion as normally the value in
3596          the dst_mask part of the section contents should be ignored.  */
3597       bfd_vma src_mask;
3598
3599       /* dst_mask selects which parts of the instruction (or data) are
3600          replaced with a relocated value.  */
3601       bfd_vma dst_mask;
3602
3603       /* If this field is non null, then the supplied function is
3604          called rather than the normal function.  This allows really
3605          strange relocation methods to be accommodated.  */
3606       bfd_reloc_status_type (*special_function)
3607         (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
3608          bfd *, char **);
3609
3610       /* The textual name of the relocation type.  */
3611       const char *name;
3612     };
3613
3614
36152.10.1.3 'The HOWTO Macro'
3616..........................
3617
3618*Description*
3619The HOWTO macro fills in a reloc_howto_type (a typedef for const struct
3620reloc_howto_struct).
3621     #define HOWTO_RSIZE(sz) ((sz) < 0 ? -(sz) : (sz))
3622     #define HOWTO(type, right, size, bits, pcrel, left, ovf, func, name,   \
3623                   inplace, src_mask, dst_mask, pcrel_off)                  \
3624       { (unsigned) type, HOWTO_RSIZE (size), bits, right, left, ovf,       \
3625         size < 0, pcrel, inplace, pcrel_off, src_mask, dst_mask, func, name }
3626
3627   *Description*
3628This is used to fill in an empty howto entry in an array.
3629     #define EMPTY_HOWTO(C) \
3630       HOWTO ((C), 0, 1, 0, false, 0, complain_overflow_dont, NULL, \
3631              NULL, false, 0, 0, false)
3632
3633     static inline unsigned int
3634     bfd_get_reloc_size (reloc_howto_type *howto)
3635     {
3636       return howto->size;
3637     }
3638
3639
36402.10.1.4 'arelent_chain'
3641........................
3642
3643*Description*
3644How relocs are tied together in an 'asection':
3645     typedef struct relent_chain
3646     {
3647       arelent relent;
3648       struct relent_chain *next;
3649     }
3650     arelent_chain;
3651
3652
36532.10.1.5 'bfd_check_overflow'
3654.............................
3655
3656*Synopsis*
3657     bfd_reloc_status_type bfd_check_overflow
3658        (enum complain_overflow how,
3659         unsigned int bitsize,
3660         unsigned int rightshift,
3661         unsigned int addrsize,
3662         bfd_vma relocation);
3663   *Description*
3664Perform overflow checking on RELOCATION which has BITSIZE significant
3665bits and will be shifted right by RIGHTSHIFT bits, on a machine with
3666addresses containing ADDRSIZE significant bits.  The result is either of
3667'bfd_reloc_ok' or 'bfd_reloc_overflow'.
3668
36692.10.1.6 'bfd_reloc_offset_in_range'
3670....................................
3671
3672*Synopsis*
3673     bool bfd_reloc_offset_in_range
3674        (reloc_howto_type *howto,
3675         bfd *abfd,
3676         asection *section,
3677         bfd_size_type offset);
3678   *Description*
3679Returns TRUE if the reloc described by HOWTO can be applied at OFFSET
3680octets in SECTION.
3681
36822.10.1.7 'bfd_perform_relocation'
3683.................................
3684
3685*Synopsis*
3686     bfd_reloc_status_type bfd_perform_relocation
3687        (bfd *abfd,
3688         arelent *reloc_entry,
3689         void *data,
3690         asection *input_section,
3691         bfd *output_bfd,
3692         char **error_message);
3693   *Description*
3694If OUTPUT_BFD is supplied to this function, the generated image will be
3695relocatable; the relocations are copied to the output file after they
3696have been changed to reflect the new state of the world.  There are two
3697ways of reflecting the results of partial linkage in an output file: by
3698modifying the output data in place, and by modifying the relocation
3699record.  Some native formats (e.g., basic a.out and basic coff) have no
3700way of specifying an addend in the relocation type, so the addend has to
3701go in the output data.  This is no big deal since in these formats the
3702output data slot will always be big enough for the addend.  Complex
3703reloc types with addends were invented to solve just this problem.  The
3704ERROR_MESSAGE argument is set to an error message if this return
3705'bfd_reloc_dangerous'.
3706
37072.10.1.8 'bfd_install_relocation'
3708.................................
3709
3710*Synopsis*
3711     bfd_reloc_status_type bfd_install_relocation
3712        (bfd *abfd,
3713         arelent *reloc_entry,
3714         void *data, bfd_vma data_start,
3715         asection *input_section,
3716         char **error_message);
3717   *Description*
3718This looks remarkably like 'bfd_perform_relocation', except it does not
3719expect that the section contents have been filled in.  I.e., it's
3720suitable for use when creating, rather than applying a relocation.
3721
3722   For now, this function should be considered reserved for the
3723assembler.
3724
3725
3726File: bfd.info,  Node: howto manager,  Prev: typedef arelent,  Up: Relocations
3727
37282.10.2 The howto manager
3729------------------------
3730
3731When an application wants to create a relocation, but doesn't know what
3732the target machine might call it, it can find out by using this bit of
3733code.
3734
37352.10.2.1 'bfd_reloc_code_type'
3736..............................
3737
3738*Description*
3739The insides of a reloc code.  The idea is that, eventually, there will
3740be one enumerator for every type of relocation we ever do.  Pass one of
3741these values to 'bfd_reloc_type_lookup', and it'll return a howto
3742pointer.
3743
3744   This does mean that the application must determine the correct
3745enumerator value; you can't get a howto pointer from a random set of
3746attributes.
3747
3748   Here are the possible values for 'enum bfd_reloc_code_real':
3749
3750 -- : BFD_RELOC_64
3751 -- : BFD_RELOC_32
3752 -- : BFD_RELOC_26
3753 -- : BFD_RELOC_24
3754 -- : BFD_RELOC_16
3755 -- : BFD_RELOC_14
3756 -- : BFD_RELOC_8
3757     Basic absolute relocations of N bits.
3758 -- : BFD_RELOC_64_PCREL
3759 -- : BFD_RELOC_32_PCREL
3760 -- : BFD_RELOC_24_PCREL
3761 -- : BFD_RELOC_16_PCREL
3762 -- : BFD_RELOC_12_PCREL
3763 -- : BFD_RELOC_8_PCREL
3764     PC-relative relocations.  Sometimes these are relative to the
3765     address of the relocation itself; sometimes they are relative to
3766     the start of the section containing the relocation.  It depends on
3767     the specific target.
3768 -- : BFD_RELOC_32_SECREL
3769 -- : BFD_RELOC_16_SECIDX
3770     Section relative relocations.  Some targets need this for DWARF2.
3771 -- : BFD_RELOC_32_GOT_PCREL
3772 -- : BFD_RELOC_16_GOT_PCREL
3773 -- : BFD_RELOC_8_GOT_PCREL
3774 -- : BFD_RELOC_32_GOTOFF
3775 -- : BFD_RELOC_16_GOTOFF
3776 -- : BFD_RELOC_LO16_GOTOFF
3777 -- : BFD_RELOC_HI16_GOTOFF
3778 -- : BFD_RELOC_HI16_S_GOTOFF
3779 -- : BFD_RELOC_8_GOTOFF
3780 -- : BFD_RELOC_64_PLT_PCREL
3781 -- : BFD_RELOC_32_PLT_PCREL
3782 -- : BFD_RELOC_24_PLT_PCREL
3783 -- : BFD_RELOC_16_PLT_PCREL
3784 -- : BFD_RELOC_8_PLT_PCREL
3785 -- : BFD_RELOC_64_PLTOFF
3786 -- : BFD_RELOC_32_PLTOFF
3787 -- : BFD_RELOC_16_PLTOFF
3788 -- : BFD_RELOC_LO16_PLTOFF
3789 -- : BFD_RELOC_HI16_PLTOFF
3790 -- : BFD_RELOC_HI16_S_PLTOFF
3791 -- : BFD_RELOC_8_PLTOFF
3792     For ELF.
3793 -- : BFD_RELOC_SIZE32
3794 -- : BFD_RELOC_SIZE64
3795     Size relocations.
3796 -- : BFD_RELOC_68K_GLOB_DAT
3797 -- : BFD_RELOC_68K_JMP_SLOT
3798 -- : BFD_RELOC_68K_RELATIVE
3799 -- : BFD_RELOC_68K_TLS_GD32
3800 -- : BFD_RELOC_68K_TLS_GD16
3801 -- : BFD_RELOC_68K_TLS_GD8
3802 -- : BFD_RELOC_68K_TLS_LDM32
3803 -- : BFD_RELOC_68K_TLS_LDM16
3804 -- : BFD_RELOC_68K_TLS_LDM8
3805 -- : BFD_RELOC_68K_TLS_LDO32
3806 -- : BFD_RELOC_68K_TLS_LDO16
3807 -- : BFD_RELOC_68K_TLS_LDO8
3808 -- : BFD_RELOC_68K_TLS_IE32
3809 -- : BFD_RELOC_68K_TLS_IE16
3810 -- : BFD_RELOC_68K_TLS_IE8
3811 -- : BFD_RELOC_68K_TLS_LE32
3812 -- : BFD_RELOC_68K_TLS_LE16
3813 -- : BFD_RELOC_68K_TLS_LE8
3814     Relocations used by 68K ELF.
3815 -- : BFD_RELOC_VAX_GLOB_DAT
3816 -- : BFD_RELOC_VAX_GLOB_REF
3817 -- : BFD_RELOC_VAX_JMP_SLOT
3818 -- : BFD_RELOC_VAX_RELATIVE
3819     Relocations used by VAX ELF.
3820 -- : BFD_RELOC_32_BASEREL
3821 -- : BFD_RELOC_16_BASEREL
3822 -- : BFD_RELOC_LO16_BASEREL
3823 -- : BFD_RELOC_HI16_BASEREL
3824 -- : BFD_RELOC_HI16_S_BASEREL
3825 -- : BFD_RELOC_8_BASEREL
3826 -- : BFD_RELOC_RVA
3827     Linkage-table relative.
3828 -- : BFD_RELOC_8_FFnn
3829     Absolute 8-bit relocation, but used to form an address like 0xFFnn.
3830 -- : BFD_RELOC_32_PCREL_S2
3831 -- : BFD_RELOC_16_PCREL_S2
3832 -- : BFD_RELOC_23_PCREL_S2
3833     These PC-relative relocations are stored as word displacements -
3834     i.e., byte displacements shifted right two bits.  The 30-bit word
3835     displacement (<<32_PCREL_S2>> - 32 bits, shifted 2) is used on the
3836     SPARC. (SPARC tools generally refer to this as <<WDISP30>>.)  The
3837     signed 16-bit displacement is used on the MIPS, and the 23-bit
3838     displacement is used on the Alpha.
3839 -- : BFD_RELOC_HI22
3840 -- : BFD_RELOC_LO10
3841     High 22 bits and low 10 bits of 32-bit value, placed into lower
3842     bits of the target word.  These are used on the SPARC.
3843 -- : BFD_RELOC_GPREL16
3844 -- : BFD_RELOC_GPREL32
3845     For systems that allocate a Global Pointer register, these are
3846     displacements off that register.  These relocation types are
3847     handled specially, because the value the register will have is
3848     decided relatively late.
3849 -- : BFD_RELOC_NONE
3850 -- : BFD_RELOC_SPARC_WDISP22
3851 -- : BFD_RELOC_SPARC22
3852 -- : BFD_RELOC_SPARC13
3853 -- : BFD_RELOC_SPARC_GOT10
3854 -- : BFD_RELOC_SPARC_GOT13
3855 -- : BFD_RELOC_SPARC_GOT22
3856 -- : BFD_RELOC_SPARC_PC10
3857 -- : BFD_RELOC_SPARC_PC22
3858 -- : BFD_RELOC_SPARC_WPLT30
3859 -- : BFD_RELOC_SPARC_COPY
3860 -- : BFD_RELOC_SPARC_GLOB_DAT
3861 -- : BFD_RELOC_SPARC_JMP_SLOT
3862 -- : BFD_RELOC_SPARC_RELATIVE
3863 -- : BFD_RELOC_SPARC_UA16
3864 -- : BFD_RELOC_SPARC_UA32
3865 -- : BFD_RELOC_SPARC_UA64
3866 -- : BFD_RELOC_SPARC_GOTDATA_HIX22
3867 -- : BFD_RELOC_SPARC_GOTDATA_LOX10
3868 -- : BFD_RELOC_SPARC_GOTDATA_OP_HIX22
3869 -- : BFD_RELOC_SPARC_GOTDATA_OP_LOX10
3870 -- : BFD_RELOC_SPARC_GOTDATA_OP
3871 -- : BFD_RELOC_SPARC_JMP_IREL
3872 -- : BFD_RELOC_SPARC_IRELATIVE
3873     SPARC ELF relocations.  There is probably some overlap with other
3874     relocation types already defined.
3875 -- : BFD_RELOC_SPARC_BASE13
3876 -- : BFD_RELOC_SPARC_BASE22
3877     I think these are specific to SPARC a.out (e.g., Sun 4).
3878 -- : BFD_RELOC_SPARC_64
3879 -- : BFD_RELOC_SPARC_10
3880 -- : BFD_RELOC_SPARC_11
3881 -- : BFD_RELOC_SPARC_OLO10
3882 -- : BFD_RELOC_SPARC_HH22
3883 -- : BFD_RELOC_SPARC_HM10
3884 -- : BFD_RELOC_SPARC_LM22
3885 -- : BFD_RELOC_SPARC_PC_HH22
3886 -- : BFD_RELOC_SPARC_PC_HM10
3887 -- : BFD_RELOC_SPARC_PC_LM22
3888 -- : BFD_RELOC_SPARC_WDISP16
3889 -- : BFD_RELOC_SPARC_WDISP19
3890 -- : BFD_RELOC_SPARC_7
3891 -- : BFD_RELOC_SPARC_6
3892 -- : BFD_RELOC_SPARC_5
3893 -- : BFD_RELOC_SPARC_DISP64
3894 -- : BFD_RELOC_SPARC_PLT32
3895 -- : BFD_RELOC_SPARC_PLT64
3896 -- : BFD_RELOC_SPARC_HIX22
3897 -- : BFD_RELOC_SPARC_LOX10
3898 -- : BFD_RELOC_SPARC_H44
3899 -- : BFD_RELOC_SPARC_M44
3900 -- : BFD_RELOC_SPARC_L44
3901 -- : BFD_RELOC_SPARC_REGISTER
3902 -- : BFD_RELOC_SPARC_H34
3903 -- : BFD_RELOC_SPARC_SIZE32
3904 -- : BFD_RELOC_SPARC_SIZE64
3905 -- : BFD_RELOC_SPARC_WDISP10
3906     SPARC64 relocations
3907 -- : BFD_RELOC_SPARC_REV32
3908     SPARC little endian relocation
3909 -- : BFD_RELOC_SPARC_TLS_GD_HI22
3910 -- : BFD_RELOC_SPARC_TLS_GD_LO10
3911 -- : BFD_RELOC_SPARC_TLS_GD_ADD
3912 -- : BFD_RELOC_SPARC_TLS_GD_CALL
3913 -- : BFD_RELOC_SPARC_TLS_LDM_HI22
3914 -- : BFD_RELOC_SPARC_TLS_LDM_LO10
3915 -- : BFD_RELOC_SPARC_TLS_LDM_ADD
3916 -- : BFD_RELOC_SPARC_TLS_LDM_CALL
3917 -- : BFD_RELOC_SPARC_TLS_LDO_HIX22
3918 -- : BFD_RELOC_SPARC_TLS_LDO_LOX10
3919 -- : BFD_RELOC_SPARC_TLS_LDO_ADD
3920 -- : BFD_RELOC_SPARC_TLS_IE_HI22
3921 -- : BFD_RELOC_SPARC_TLS_IE_LO10
3922 -- : BFD_RELOC_SPARC_TLS_IE_LD
3923 -- : BFD_RELOC_SPARC_TLS_IE_LDX
3924 -- : BFD_RELOC_SPARC_TLS_IE_ADD
3925 -- : BFD_RELOC_SPARC_TLS_LE_HIX22
3926 -- : BFD_RELOC_SPARC_TLS_LE_LOX10
3927 -- : BFD_RELOC_SPARC_TLS_DTPMOD32
3928 -- : BFD_RELOC_SPARC_TLS_DTPMOD64
3929 -- : BFD_RELOC_SPARC_TLS_DTPOFF32
3930 -- : BFD_RELOC_SPARC_TLS_DTPOFF64
3931 -- : BFD_RELOC_SPARC_TLS_TPOFF32
3932 -- : BFD_RELOC_SPARC_TLS_TPOFF64
3933     SPARC TLS relocations
3934 -- : BFD_RELOC_SPU_IMM7
3935 -- : BFD_RELOC_SPU_IMM8
3936 -- : BFD_RELOC_SPU_IMM10
3937 -- : BFD_RELOC_SPU_IMM10W
3938 -- : BFD_RELOC_SPU_IMM16
3939 -- : BFD_RELOC_SPU_IMM16W
3940 -- : BFD_RELOC_SPU_IMM18
3941 -- : BFD_RELOC_SPU_PCREL9a
3942 -- : BFD_RELOC_SPU_PCREL9b
3943 -- : BFD_RELOC_SPU_PCREL16
3944 -- : BFD_RELOC_SPU_LO16
3945 -- : BFD_RELOC_SPU_HI16
3946 -- : BFD_RELOC_SPU_PPU32
3947 -- : BFD_RELOC_SPU_PPU64
3948 -- : BFD_RELOC_SPU_ADD_PIC
3949     SPU Relocations.
3950 -- : BFD_RELOC_ALPHA_GPDISP_HI16
3951     Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
3952     "addend" in some special way.  For GPDISP_HI16 ("gpdisp")
3953     relocations, the symbol is ignored when writing; when reading, it
3954     will be the absolute section symbol.  The addend is the
3955     displacement in bytes of the "lda" instruction from the "ldah"
3956     instruction (which is at the address of this reloc).
3957 -- : BFD_RELOC_ALPHA_GPDISP_LO16
3958     For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
3959     with GPDISP_HI16 relocs.  The addend is ignored when writing the
3960     relocations out, and is filled in with the file's GP value on
3961     reading, for convenience.
3962 -- : BFD_RELOC_ALPHA_GPDISP
3963     The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
3964     relocation except that there is no accompanying GPDISP_LO16
3965     relocation.
3966 -- : BFD_RELOC_ALPHA_LITERAL
3967 -- : BFD_RELOC_ALPHA_ELF_LITERAL
3968 -- : BFD_RELOC_ALPHA_LITUSE
3969     The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
3970     the assembler turns it into a LDQ instruction to load the address
3971     of the symbol, and then fills in a register in the real
3972     instruction.
3973
3974     The LITERAL reloc, at the LDQ instruction, refers to the .lita
3975     section symbol.  The addend is ignored when writing, but is filled
3976     in with the file's GP value on reading, for convenience, as with
3977     the GPDISP_LO16 reloc.
3978
3979     The ELF_LITERAL reloc is somewhere between 16_GOTOFF and
3980     GPDISP_LO16.  It should refer to the symbol to be referenced, as
3981     with 16_GOTOFF, but it generates output not based on the position
3982     within the .got section, but relative to the GP value chosen for
3983     the file during the final link stage.
3984
3985     The LITUSE reloc, on the instruction using the loaded address,
3986     gives information to the linker that it might be able to use to
3987     optimize away some literal section references.  The symbol is
3988     ignored (read as the absolute section symbol), and the "addend"
3989     indicates the type of instruction using the register: 1 - "memory"
3990     fmt insn 2 - byte-manipulation (byte offset reg) 3 - jsr (target of
3991     branch)
3992 -- : BFD_RELOC_ALPHA_HINT
3993     The HINT relocation indicates a value that should be filled into
3994     the "hint" field of a jmp/jsr/ret instruction, for possible branch-
3995     prediction logic which may be provided on some processors.
3996 -- : BFD_RELOC_ALPHA_LINKAGE
3997     The LINKAGE relocation outputs a linkage pair in the object file,
3998     which is filled by the linker.
3999 -- : BFD_RELOC_ALPHA_CODEADDR
4000     The CODEADDR relocation outputs a STO_CA in the object file, which
4001     is filled by the linker.
4002 -- : BFD_RELOC_ALPHA_GPREL_HI16
4003 -- : BFD_RELOC_ALPHA_GPREL_LO16
4004     The GPREL_HI/LO relocations together form a 32-bit offset from the
4005     GP register.
4006 -- : BFD_RELOC_ALPHA_BRSGP
4007     Like BFD_RELOC_23_PCREL_S2, except that the source and target must
4008     share a common GP, and the target address is adjusted for
4009     STO_ALPHA_STD_GPLOAD.
4010 -- : BFD_RELOC_ALPHA_NOP
4011     The NOP relocation outputs a NOP if the longword displacement
4012     between two procedure entry points is < 2^21.
4013 -- : BFD_RELOC_ALPHA_BSR
4014     The BSR relocation outputs a BSR if the longword displacement
4015     between two procedure entry points is < 2^21.
4016 -- : BFD_RELOC_ALPHA_LDA
4017     The LDA relocation outputs a LDA if the longword displacement
4018     between two procedure entry points is < 2^16.
4019 -- : BFD_RELOC_ALPHA_BOH
4020     The BOH relocation outputs a BSR if the longword displacement
4021     between two procedure entry points is < 2^21, or else a hint.
4022 -- : BFD_RELOC_ALPHA_TLSGD
4023 -- : BFD_RELOC_ALPHA_TLSLDM
4024 -- : BFD_RELOC_ALPHA_DTPMOD64
4025 -- : BFD_RELOC_ALPHA_GOTDTPREL16
4026 -- : BFD_RELOC_ALPHA_DTPREL64
4027 -- : BFD_RELOC_ALPHA_DTPREL_HI16
4028 -- : BFD_RELOC_ALPHA_DTPREL_LO16
4029 -- : BFD_RELOC_ALPHA_DTPREL16
4030 -- : BFD_RELOC_ALPHA_GOTTPREL16
4031 -- : BFD_RELOC_ALPHA_TPREL64
4032 -- : BFD_RELOC_ALPHA_TPREL_HI16
4033 -- : BFD_RELOC_ALPHA_TPREL_LO16
4034 -- : BFD_RELOC_ALPHA_TPREL16
4035     Alpha thread-local storage relocations.
4036 -- : BFD_RELOC_MIPS_JMP
4037 -- : BFD_RELOC_MICROMIPS_JMP
4038     The MIPS jump instruction.
4039 -- : BFD_RELOC_MIPS16_JMP
4040     The MIPS16 jump instruction.
4041 -- : BFD_RELOC_MIPS16_GPREL
4042     MIPS16 GP relative reloc.
4043 -- : BFD_RELOC_HI16
4044     High 16 bits of 32-bit value; simple reloc.
4045 -- : BFD_RELOC_HI16_S
4046     High 16 bits of 32-bit value but the low 16 bits will be sign
4047     extended and added to form the final result.  If the low 16 bits
4048     form a negative number, we need to add one to the high value to
4049     compensate for the borrow when the low bits are added.
4050 -- : BFD_RELOC_LO16
4051     Low 16 bits.
4052 -- : BFD_RELOC_HI16_PCREL
4053     High 16 bits of 32-bit pc-relative value
4054 -- : BFD_RELOC_HI16_S_PCREL
4055     High 16 bits of 32-bit pc-relative value, adjusted
4056 -- : BFD_RELOC_LO16_PCREL
4057     Low 16 bits of pc-relative value
4058 -- : BFD_RELOC_MIPS16_GOT16
4059 -- : BFD_RELOC_MIPS16_CALL16
4060     Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
4061     16-bit immediate fields
4062 -- : BFD_RELOC_MIPS16_HI16
4063     MIPS16 high 16 bits of 32-bit value.
4064 -- : BFD_RELOC_MIPS16_HI16_S
4065     MIPS16 high 16 bits of 32-bit value but the low 16 bits will be
4066     sign extended and added to form the final result.  If the low 16
4067     bits form a negative number, we need to add one to the high value
4068     to compensate for the borrow when the low bits are added.
4069 -- : BFD_RELOC_MIPS16_LO16
4070     MIPS16 low 16 bits.
4071 -- : BFD_RELOC_MIPS16_TLS_GD
4072 -- : BFD_RELOC_MIPS16_TLS_LDM
4073 -- : BFD_RELOC_MIPS16_TLS_DTPREL_HI16
4074 -- : BFD_RELOC_MIPS16_TLS_DTPREL_LO16
4075 -- : BFD_RELOC_MIPS16_TLS_GOTTPREL
4076 -- : BFD_RELOC_MIPS16_TLS_TPREL_HI16
4077 -- : BFD_RELOC_MIPS16_TLS_TPREL_LO16
4078     MIPS16 TLS relocations
4079 -- : BFD_RELOC_MIPS_LITERAL
4080 -- : BFD_RELOC_MICROMIPS_LITERAL
4081     Relocation against a MIPS literal section.
4082 -- : BFD_RELOC_MICROMIPS_7_PCREL_S1
4083 -- : BFD_RELOC_MICROMIPS_10_PCREL_S1
4084 -- : BFD_RELOC_MICROMIPS_16_PCREL_S1
4085     microMIPS PC-relative relocations.
4086 -- : BFD_RELOC_MIPS16_16_PCREL_S1
4087     MIPS16 PC-relative relocation.
4088 -- : BFD_RELOC_MIPS_21_PCREL_S2
4089 -- : BFD_RELOC_MIPS_26_PCREL_S2
4090 -- : BFD_RELOC_MIPS_18_PCREL_S3
4091 -- : BFD_RELOC_MIPS_19_PCREL_S2
4092     MIPS PC-relative relocations.
4093 -- : BFD_RELOC_MICROMIPS_GPREL16
4094 -- : BFD_RELOC_MICROMIPS_HI16
4095 -- : BFD_RELOC_MICROMIPS_HI16_S
4096 -- : BFD_RELOC_MICROMIPS_LO16
4097     microMIPS versions of generic BFD relocs.
4098 -- : BFD_RELOC_MIPS_GOT16
4099 -- : BFD_RELOC_MICROMIPS_GOT16
4100 -- : BFD_RELOC_MIPS_CALL16
4101 -- : BFD_RELOC_MICROMIPS_CALL16
4102 -- : BFD_RELOC_MIPS_GOT_HI16
4103 -- : BFD_RELOC_MICROMIPS_GOT_HI16
4104 -- : BFD_RELOC_MIPS_GOT_LO16
4105 -- : BFD_RELOC_MICROMIPS_GOT_LO16
4106 -- : BFD_RELOC_MIPS_CALL_HI16
4107 -- : BFD_RELOC_MICROMIPS_CALL_HI16
4108 -- : BFD_RELOC_MIPS_CALL_LO16
4109 -- : BFD_RELOC_MICROMIPS_CALL_LO16
4110 -- : BFD_RELOC_MIPS_SUB
4111 -- : BFD_RELOC_MICROMIPS_SUB
4112 -- : BFD_RELOC_MIPS_GOT_PAGE
4113 -- : BFD_RELOC_MICROMIPS_GOT_PAGE
4114 -- : BFD_RELOC_MIPS_GOT_OFST
4115 -- : BFD_RELOC_MICROMIPS_GOT_OFST
4116 -- : BFD_RELOC_MIPS_GOT_DISP
4117 -- : BFD_RELOC_MICROMIPS_GOT_DISP
4118 -- : BFD_RELOC_MIPS_SHIFT5
4119 -- : BFD_RELOC_MIPS_SHIFT6
4120 -- : BFD_RELOC_MIPS_INSERT_A
4121 -- : BFD_RELOC_MIPS_INSERT_B
4122 -- : BFD_RELOC_MIPS_DELETE
4123 -- : BFD_RELOC_MIPS_HIGHEST
4124 -- : BFD_RELOC_MICROMIPS_HIGHEST
4125 -- : BFD_RELOC_MIPS_HIGHER
4126 -- : BFD_RELOC_MICROMIPS_HIGHER
4127 -- : BFD_RELOC_MIPS_SCN_DISP
4128 -- : BFD_RELOC_MICROMIPS_SCN_DISP
4129 -- : BFD_RELOC_MIPS_16
4130 -- : BFD_RELOC_MIPS_RELGOT
4131 -- : BFD_RELOC_MIPS_JALR
4132 -- : BFD_RELOC_MICROMIPS_JALR
4133 -- : BFD_RELOC_MIPS_TLS_DTPMOD32
4134 -- : BFD_RELOC_MIPS_TLS_DTPREL32
4135 -- : BFD_RELOC_MIPS_TLS_DTPMOD64
4136 -- : BFD_RELOC_MIPS_TLS_DTPREL64
4137 -- : BFD_RELOC_MIPS_TLS_GD
4138 -- : BFD_RELOC_MICROMIPS_TLS_GD
4139 -- : BFD_RELOC_MIPS_TLS_LDM
4140 -- : BFD_RELOC_MICROMIPS_TLS_LDM
4141 -- : BFD_RELOC_MIPS_TLS_DTPREL_HI16
4142 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16
4143 -- : BFD_RELOC_MIPS_TLS_DTPREL_LO16
4144 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16
4145 -- : BFD_RELOC_MIPS_TLS_GOTTPREL
4146 -- : BFD_RELOC_MICROMIPS_TLS_GOTTPREL
4147 -- : BFD_RELOC_MIPS_TLS_TPREL32
4148 -- : BFD_RELOC_MIPS_TLS_TPREL64
4149 -- : BFD_RELOC_MIPS_TLS_TPREL_HI16
4150 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_HI16
4151 -- : BFD_RELOC_MIPS_TLS_TPREL_LO16
4152 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_LO16
4153 -- : BFD_RELOC_MIPS_EH
4154     MIPS ELF relocations.
4155 -- : BFD_RELOC_MIPS_COPY
4156 -- : BFD_RELOC_MIPS_JUMP_SLOT
4157     MIPS ELF relocations (VxWorks and PLT extensions).
4158 -- : BFD_RELOC_MOXIE_10_PCREL
4159     Moxie ELF relocations.
4160 -- : BFD_RELOC_FT32_10
4161 -- : BFD_RELOC_FT32_20
4162 -- : BFD_RELOC_FT32_17
4163 -- : BFD_RELOC_FT32_18
4164 -- : BFD_RELOC_FT32_RELAX
4165 -- : BFD_RELOC_FT32_SC0
4166 -- : BFD_RELOC_FT32_SC1
4167 -- : BFD_RELOC_FT32_15
4168 -- : BFD_RELOC_FT32_DIFF32
4169     FT32 ELF relocations.
4170 -- : BFD_RELOC_FRV_LABEL16
4171 -- : BFD_RELOC_FRV_LABEL24
4172 -- : BFD_RELOC_FRV_LO16
4173 -- : BFD_RELOC_FRV_HI16
4174 -- : BFD_RELOC_FRV_GPREL12
4175 -- : BFD_RELOC_FRV_GPRELU12
4176 -- : BFD_RELOC_FRV_GPREL32
4177 -- : BFD_RELOC_FRV_GPRELHI
4178 -- : BFD_RELOC_FRV_GPRELLO
4179 -- : BFD_RELOC_FRV_GOT12
4180 -- : BFD_RELOC_FRV_GOTHI
4181 -- : BFD_RELOC_FRV_GOTLO
4182 -- : BFD_RELOC_FRV_FUNCDESC
4183 -- : BFD_RELOC_FRV_FUNCDESC_GOT12
4184 -- : BFD_RELOC_FRV_FUNCDESC_GOTHI
4185 -- : BFD_RELOC_FRV_FUNCDESC_GOTLO
4186 -- : BFD_RELOC_FRV_FUNCDESC_VALUE
4187 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFF12
4188 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFHI
4189 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFLO
4190 -- : BFD_RELOC_FRV_GOTOFF12
4191 -- : BFD_RELOC_FRV_GOTOFFHI
4192 -- : BFD_RELOC_FRV_GOTOFFLO
4193 -- : BFD_RELOC_FRV_GETTLSOFF
4194 -- : BFD_RELOC_FRV_TLSDESC_VALUE
4195 -- : BFD_RELOC_FRV_GOTTLSDESC12
4196 -- : BFD_RELOC_FRV_GOTTLSDESCHI
4197 -- : BFD_RELOC_FRV_GOTTLSDESCLO
4198 -- : BFD_RELOC_FRV_TLSMOFF12
4199 -- : BFD_RELOC_FRV_TLSMOFFHI
4200 -- : BFD_RELOC_FRV_TLSMOFFLO
4201 -- : BFD_RELOC_FRV_GOTTLSOFF12
4202 -- : BFD_RELOC_FRV_GOTTLSOFFHI
4203 -- : BFD_RELOC_FRV_GOTTLSOFFLO
4204 -- : BFD_RELOC_FRV_TLSOFF
4205 -- : BFD_RELOC_FRV_TLSDESC_RELAX
4206 -- : BFD_RELOC_FRV_GETTLSOFF_RELAX
4207 -- : BFD_RELOC_FRV_TLSOFF_RELAX
4208 -- : BFD_RELOC_FRV_TLSMOFF
4209     Fujitsu Frv Relocations.
4210 -- : BFD_RELOC_MN10300_GOTOFF24
4211     This is a 24bit GOT-relative reloc for the mn10300.
4212 -- : BFD_RELOC_MN10300_GOT32
4213     This is a 32bit GOT-relative reloc for the mn10300, offset by two
4214     bytes in the instruction.
4215 -- : BFD_RELOC_MN10300_GOT24
4216     This is a 24bit GOT-relative reloc for the mn10300, offset by two
4217     bytes in the instruction.
4218 -- : BFD_RELOC_MN10300_GOT16
4219     This is a 16bit GOT-relative reloc for the mn10300, offset by two
4220     bytes in the instruction.
4221 -- : BFD_RELOC_MN10300_COPY
4222     Copy symbol at runtime.
4223 -- : BFD_RELOC_MN10300_GLOB_DAT
4224     Create GOT entry.
4225 -- : BFD_RELOC_MN10300_JMP_SLOT
4226     Create PLT entry.
4227 -- : BFD_RELOC_MN10300_RELATIVE
4228     Adjust by program base.
4229 -- : BFD_RELOC_MN10300_SYM_DIFF
4230     Together with another reloc targeted at the same location, allows
4231     for a value that is the difference of two symbols in the same
4232     section.
4233 -- : BFD_RELOC_MN10300_ALIGN
4234     The addend of this reloc is an alignment power that must be
4235     honoured at the offset's location, regardless of linker relaxation.
4236 -- : BFD_RELOC_MN10300_TLS_GD
4237 -- : BFD_RELOC_MN10300_TLS_LD
4238 -- : BFD_RELOC_MN10300_TLS_LDO
4239 -- : BFD_RELOC_MN10300_TLS_GOTIE
4240 -- : BFD_RELOC_MN10300_TLS_IE
4241 -- : BFD_RELOC_MN10300_TLS_LE
4242 -- : BFD_RELOC_MN10300_TLS_DTPMOD
4243 -- : BFD_RELOC_MN10300_TLS_DTPOFF
4244 -- : BFD_RELOC_MN10300_TLS_TPOFF
4245     Various TLS-related relocations.
4246 -- : BFD_RELOC_MN10300_32_PCREL
4247     This is a 32bit pcrel reloc for the mn10300, offset by two bytes in
4248     the instruction.
4249 -- : BFD_RELOC_MN10300_16_PCREL
4250     This is a 16bit pcrel reloc for the mn10300, offset by two bytes in
4251     the instruction.
4252 -- : BFD_RELOC_386_GOT32
4253 -- : BFD_RELOC_386_PLT32
4254 -- : BFD_RELOC_386_COPY
4255 -- : BFD_RELOC_386_GLOB_DAT
4256 -- : BFD_RELOC_386_JUMP_SLOT
4257 -- : BFD_RELOC_386_RELATIVE
4258 -- : BFD_RELOC_386_GOTOFF
4259 -- : BFD_RELOC_386_GOTPC
4260 -- : BFD_RELOC_386_TLS_TPOFF
4261 -- : BFD_RELOC_386_TLS_IE
4262 -- : BFD_RELOC_386_TLS_GOTIE
4263 -- : BFD_RELOC_386_TLS_LE
4264 -- : BFD_RELOC_386_TLS_GD
4265 -- : BFD_RELOC_386_TLS_LDM
4266 -- : BFD_RELOC_386_TLS_LDO_32
4267 -- : BFD_RELOC_386_TLS_IE_32
4268 -- : BFD_RELOC_386_TLS_LE_32
4269 -- : BFD_RELOC_386_TLS_DTPMOD32
4270 -- : BFD_RELOC_386_TLS_DTPOFF32
4271 -- : BFD_RELOC_386_TLS_TPOFF32
4272 -- : BFD_RELOC_386_TLS_GOTDESC
4273 -- : BFD_RELOC_386_TLS_DESC_CALL
4274 -- : BFD_RELOC_386_TLS_DESC
4275 -- : BFD_RELOC_386_IRELATIVE
4276 -- : BFD_RELOC_386_GOT32X
4277     i386/elf relocations
4278 -- : BFD_RELOC_X86_64_GOT32
4279 -- : BFD_RELOC_X86_64_PLT32
4280 -- : BFD_RELOC_X86_64_COPY
4281 -- : BFD_RELOC_X86_64_GLOB_DAT
4282 -- : BFD_RELOC_X86_64_JUMP_SLOT
4283 -- : BFD_RELOC_X86_64_RELATIVE
4284 -- : BFD_RELOC_X86_64_GOTPCREL
4285 -- : BFD_RELOC_X86_64_32S
4286 -- : BFD_RELOC_X86_64_DTPMOD64
4287 -- : BFD_RELOC_X86_64_DTPOFF64
4288 -- : BFD_RELOC_X86_64_TPOFF64
4289 -- : BFD_RELOC_X86_64_TLSGD
4290 -- : BFD_RELOC_X86_64_TLSLD
4291 -- : BFD_RELOC_X86_64_DTPOFF32
4292 -- : BFD_RELOC_X86_64_GOTTPOFF
4293 -- : BFD_RELOC_X86_64_TPOFF32
4294 -- : BFD_RELOC_X86_64_GOTOFF64
4295 -- : BFD_RELOC_X86_64_GOTPC32
4296 -- : BFD_RELOC_X86_64_GOT64
4297 -- : BFD_RELOC_X86_64_GOTPCREL64
4298 -- : BFD_RELOC_X86_64_GOTPC64
4299 -- : BFD_RELOC_X86_64_GOTPLT64
4300 -- : BFD_RELOC_X86_64_PLTOFF64
4301 -- : BFD_RELOC_X86_64_GOTPC32_TLSDESC
4302 -- : BFD_RELOC_X86_64_TLSDESC_CALL
4303 -- : BFD_RELOC_X86_64_TLSDESC
4304 -- : BFD_RELOC_X86_64_IRELATIVE
4305 -- : BFD_RELOC_X86_64_PC32_BND
4306 -- : BFD_RELOC_X86_64_PLT32_BND
4307 -- : BFD_RELOC_X86_64_GOTPCRELX
4308 -- : BFD_RELOC_X86_64_REX_GOTPCRELX
4309     x86-64/elf relocations
4310 -- : BFD_RELOC_NS32K_IMM_8
4311 -- : BFD_RELOC_NS32K_IMM_16
4312 -- : BFD_RELOC_NS32K_IMM_32
4313 -- : BFD_RELOC_NS32K_IMM_8_PCREL
4314 -- : BFD_RELOC_NS32K_IMM_16_PCREL
4315 -- : BFD_RELOC_NS32K_IMM_32_PCREL
4316 -- : BFD_RELOC_NS32K_DISP_8
4317 -- : BFD_RELOC_NS32K_DISP_16
4318 -- : BFD_RELOC_NS32K_DISP_32
4319 -- : BFD_RELOC_NS32K_DISP_8_PCREL
4320 -- : BFD_RELOC_NS32K_DISP_16_PCREL
4321 -- : BFD_RELOC_NS32K_DISP_32_PCREL
4322     ns32k relocations
4323 -- : BFD_RELOC_PDP11_DISP_8_PCREL
4324 -- : BFD_RELOC_PDP11_DISP_6_PCREL
4325     PDP11 relocations
4326 -- : BFD_RELOC_PJ_CODE_HI16
4327 -- : BFD_RELOC_PJ_CODE_LO16
4328 -- : BFD_RELOC_PJ_CODE_DIR16
4329 -- : BFD_RELOC_PJ_CODE_DIR32
4330 -- : BFD_RELOC_PJ_CODE_REL16
4331 -- : BFD_RELOC_PJ_CODE_REL32
4332     Picojava relocs.  Not all of these appear in object files.
4333 -- : BFD_RELOC_PPC_B26
4334 -- : BFD_RELOC_PPC_BA26
4335 -- : BFD_RELOC_PPC_TOC16
4336 -- : BFD_RELOC_PPC_TOC16_LO
4337 -- : BFD_RELOC_PPC_TOC16_HI
4338 -- : BFD_RELOC_PPC_B16
4339 -- : BFD_RELOC_PPC_B16_BRTAKEN
4340 -- : BFD_RELOC_PPC_B16_BRNTAKEN
4341 -- : BFD_RELOC_PPC_BA16
4342 -- : BFD_RELOC_PPC_BA16_BRTAKEN
4343 -- : BFD_RELOC_PPC_BA16_BRNTAKEN
4344 -- : BFD_RELOC_PPC_COPY
4345 -- : BFD_RELOC_PPC_GLOB_DAT
4346 -- : BFD_RELOC_PPC_JMP_SLOT
4347 -- : BFD_RELOC_PPC_RELATIVE
4348 -- : BFD_RELOC_PPC_LOCAL24PC
4349 -- : BFD_RELOC_PPC_EMB_NADDR32
4350 -- : BFD_RELOC_PPC_EMB_NADDR16
4351 -- : BFD_RELOC_PPC_EMB_NADDR16_LO
4352 -- : BFD_RELOC_PPC_EMB_NADDR16_HI
4353 -- : BFD_RELOC_PPC_EMB_NADDR16_HA
4354 -- : BFD_RELOC_PPC_EMB_SDAI16
4355 -- : BFD_RELOC_PPC_EMB_SDA2I16
4356 -- : BFD_RELOC_PPC_EMB_SDA2REL
4357 -- : BFD_RELOC_PPC_EMB_SDA21
4358 -- : BFD_RELOC_PPC_EMB_MRKREF
4359 -- : BFD_RELOC_PPC_EMB_RELSEC16
4360 -- : BFD_RELOC_PPC_EMB_RELST_LO
4361 -- : BFD_RELOC_PPC_EMB_RELST_HI
4362 -- : BFD_RELOC_PPC_EMB_RELST_HA
4363 -- : BFD_RELOC_PPC_EMB_BIT_FLD
4364 -- : BFD_RELOC_PPC_EMB_RELSDA
4365 -- : BFD_RELOC_PPC_VLE_REL8
4366 -- : BFD_RELOC_PPC_VLE_REL15
4367 -- : BFD_RELOC_PPC_VLE_REL24
4368 -- : BFD_RELOC_PPC_VLE_LO16A
4369 -- : BFD_RELOC_PPC_VLE_LO16D
4370 -- : BFD_RELOC_PPC_VLE_HI16A
4371 -- : BFD_RELOC_PPC_VLE_HI16D
4372 -- : BFD_RELOC_PPC_VLE_HA16A
4373 -- : BFD_RELOC_PPC_VLE_HA16D
4374 -- : BFD_RELOC_PPC_VLE_SDA21
4375 -- : BFD_RELOC_PPC_VLE_SDA21_LO
4376 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16A
4377 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16D
4378 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16A
4379 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16D
4380 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16A
4381 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16D
4382 -- : BFD_RELOC_PPC_16DX_HA
4383 -- : BFD_RELOC_PPC_REL16DX_HA
4384 -- : BFD_RELOC_PPC_NEG
4385 -- : BFD_RELOC_PPC64_HIGHER
4386 -- : BFD_RELOC_PPC64_HIGHER_S
4387 -- : BFD_RELOC_PPC64_HIGHEST
4388 -- : BFD_RELOC_PPC64_HIGHEST_S
4389 -- : BFD_RELOC_PPC64_TOC16_LO
4390 -- : BFD_RELOC_PPC64_TOC16_HI
4391 -- : BFD_RELOC_PPC64_TOC16_HA
4392 -- : BFD_RELOC_PPC64_TOC
4393 -- : BFD_RELOC_PPC64_PLTGOT16
4394 -- : BFD_RELOC_PPC64_PLTGOT16_LO
4395 -- : BFD_RELOC_PPC64_PLTGOT16_HI
4396 -- : BFD_RELOC_PPC64_PLTGOT16_HA
4397 -- : BFD_RELOC_PPC64_ADDR16_DS
4398 -- : BFD_RELOC_PPC64_ADDR16_LO_DS
4399 -- : BFD_RELOC_PPC64_GOT16_DS
4400 -- : BFD_RELOC_PPC64_GOT16_LO_DS
4401 -- : BFD_RELOC_PPC64_PLT16_LO_DS
4402 -- : BFD_RELOC_PPC64_SECTOFF_DS
4403 -- : BFD_RELOC_PPC64_SECTOFF_LO_DS
4404 -- : BFD_RELOC_PPC64_TOC16_DS
4405 -- : BFD_RELOC_PPC64_TOC16_LO_DS
4406 -- : BFD_RELOC_PPC64_PLTGOT16_DS
4407 -- : BFD_RELOC_PPC64_PLTGOT16_LO_DS
4408 -- : BFD_RELOC_PPC64_ADDR16_HIGH
4409 -- : BFD_RELOC_PPC64_ADDR16_HIGHA
4410 -- : BFD_RELOC_PPC64_REL16_HIGH
4411 -- : BFD_RELOC_PPC64_REL16_HIGHA
4412 -- : BFD_RELOC_PPC64_REL16_HIGHER
4413 -- : BFD_RELOC_PPC64_REL16_HIGHERA
4414 -- : BFD_RELOC_PPC64_REL16_HIGHEST
4415 -- : BFD_RELOC_PPC64_REL16_HIGHESTA
4416 -- : BFD_RELOC_PPC64_ADDR64_LOCAL
4417 -- : BFD_RELOC_PPC64_ENTRY
4418 -- : BFD_RELOC_PPC64_REL24_NOTOC
4419 -- : BFD_RELOC_PPC64_REL24_P9NOTOC
4420 -- : BFD_RELOC_PPC64_D34
4421 -- : BFD_RELOC_PPC64_D34_LO
4422 -- : BFD_RELOC_PPC64_D34_HI30
4423 -- : BFD_RELOC_PPC64_D34_HA30
4424 -- : BFD_RELOC_PPC64_PCREL34
4425 -- : BFD_RELOC_PPC64_GOT_PCREL34
4426 -- : BFD_RELOC_PPC64_PLT_PCREL34
4427 -- : BFD_RELOC_PPC64_ADDR16_HIGHER34
4428 -- : BFD_RELOC_PPC64_ADDR16_HIGHERA34
4429 -- : BFD_RELOC_PPC64_ADDR16_HIGHEST34
4430 -- : BFD_RELOC_PPC64_ADDR16_HIGHESTA34
4431 -- : BFD_RELOC_PPC64_REL16_HIGHER34
4432 -- : BFD_RELOC_PPC64_REL16_HIGHERA34
4433 -- : BFD_RELOC_PPC64_REL16_HIGHEST34
4434 -- : BFD_RELOC_PPC64_REL16_HIGHESTA34
4435 -- : BFD_RELOC_PPC64_D28
4436 -- : BFD_RELOC_PPC64_PCREL28
4437     Power(rs6000) and PowerPC relocations.
4438 -- : BFD_RELOC_PPC_TLS
4439 -- : BFD_RELOC_PPC_TLSGD
4440 -- : BFD_RELOC_PPC_TLSLD
4441 -- : BFD_RELOC_PPC_TLSLE
4442 -- : BFD_RELOC_PPC_TLSIE
4443 -- : BFD_RELOC_PPC_TLSM
4444 -- : BFD_RELOC_PPC_TLSML
4445 -- : BFD_RELOC_PPC_DTPMOD
4446 -- : BFD_RELOC_PPC_TPREL16
4447 -- : BFD_RELOC_PPC_TPREL16_LO
4448 -- : BFD_RELOC_PPC_TPREL16_HI
4449 -- : BFD_RELOC_PPC_TPREL16_HA
4450 -- : BFD_RELOC_PPC_TPREL
4451 -- : BFD_RELOC_PPC_DTPREL16
4452 -- : BFD_RELOC_PPC_DTPREL16_LO
4453 -- : BFD_RELOC_PPC_DTPREL16_HI
4454 -- : BFD_RELOC_PPC_DTPREL16_HA
4455 -- : BFD_RELOC_PPC_DTPREL
4456 -- : BFD_RELOC_PPC_GOT_TLSGD16
4457 -- : BFD_RELOC_PPC_GOT_TLSGD16_LO
4458 -- : BFD_RELOC_PPC_GOT_TLSGD16_HI
4459 -- : BFD_RELOC_PPC_GOT_TLSGD16_HA
4460 -- : BFD_RELOC_PPC_GOT_TLSLD16
4461 -- : BFD_RELOC_PPC_GOT_TLSLD16_LO
4462 -- : BFD_RELOC_PPC_GOT_TLSLD16_HI
4463 -- : BFD_RELOC_PPC_GOT_TLSLD16_HA
4464 -- : BFD_RELOC_PPC_GOT_TPREL16
4465 -- : BFD_RELOC_PPC_GOT_TPREL16_LO
4466 -- : BFD_RELOC_PPC_GOT_TPREL16_HI
4467 -- : BFD_RELOC_PPC_GOT_TPREL16_HA
4468 -- : BFD_RELOC_PPC_GOT_DTPREL16
4469 -- : BFD_RELOC_PPC_GOT_DTPREL16_LO
4470 -- : BFD_RELOC_PPC_GOT_DTPREL16_HI
4471 -- : BFD_RELOC_PPC_GOT_DTPREL16_HA
4472 -- : BFD_RELOC_PPC64_TLSGD
4473 -- : BFD_RELOC_PPC64_TLSLD
4474 -- : BFD_RELOC_PPC64_TLSLE
4475 -- : BFD_RELOC_PPC64_TLSIE
4476 -- : BFD_RELOC_PPC64_TLSM
4477 -- : BFD_RELOC_PPC64_TLSML
4478 -- : BFD_RELOC_PPC64_TPREL16_DS
4479 -- : BFD_RELOC_PPC64_TPREL16_LO_DS
4480 -- : BFD_RELOC_PPC64_TPREL16_HIGH
4481 -- : BFD_RELOC_PPC64_TPREL16_HIGHA
4482 -- : BFD_RELOC_PPC64_TPREL16_HIGHER
4483 -- : BFD_RELOC_PPC64_TPREL16_HIGHERA
4484 -- : BFD_RELOC_PPC64_TPREL16_HIGHEST
4485 -- : BFD_RELOC_PPC64_TPREL16_HIGHESTA
4486 -- : BFD_RELOC_PPC64_DTPREL16_DS
4487 -- : BFD_RELOC_PPC64_DTPREL16_LO_DS
4488 -- : BFD_RELOC_PPC64_DTPREL16_HIGH
4489 -- : BFD_RELOC_PPC64_DTPREL16_HIGHA
4490 -- : BFD_RELOC_PPC64_DTPREL16_HIGHER
4491 -- : BFD_RELOC_PPC64_DTPREL16_HIGHERA
4492 -- : BFD_RELOC_PPC64_DTPREL16_HIGHEST
4493 -- : BFD_RELOC_PPC64_DTPREL16_HIGHESTA
4494 -- : BFD_RELOC_PPC64_TPREL34
4495 -- : BFD_RELOC_PPC64_DTPREL34
4496 -- : BFD_RELOC_PPC64_GOT_TLSGD_PCREL34
4497 -- : BFD_RELOC_PPC64_GOT_TLSLD_PCREL34
4498 -- : BFD_RELOC_PPC64_GOT_TPREL_PCREL34
4499 -- : BFD_RELOC_PPC64_GOT_DTPREL_PCREL34
4500 -- : BFD_RELOC_PPC64_TLS_PCREL
4501     PowerPC and PowerPC64 thread-local storage relocations.
4502 -- : BFD_RELOC_I370_D12
4503     IBM 370/390 relocations
4504 -- : BFD_RELOC_CTOR
4505     The type of reloc used to build a constructor table - at the moment
4506     probably a 32 bit wide absolute relocation, but the target can
4507     choose.  It generally does map to one of the other relocation
4508     types.
4509 -- : BFD_RELOC_ARM_PCREL_BRANCH
4510     ARM 26 bit pc-relative branch.  The lowest two bits must be zero
4511     and are not stored in the instruction.
4512 -- : BFD_RELOC_ARM_PCREL_BLX
4513     ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
4514     not stored in the instruction.  The 2nd lowest bit comes from a 1
4515     bit field in the instruction.
4516 -- : BFD_RELOC_THUMB_PCREL_BLX
4517     Thumb 22 bit pc-relative branch.  The lowest bit must be zero and
4518     is not stored in the instruction.  The 2nd lowest bit comes from a
4519     1 bit field in the instruction.
4520 -- : BFD_RELOC_ARM_PCREL_CALL
4521     ARM 26-bit pc-relative branch for an unconditional BL or BLX
4522     instruction.
4523 -- : BFD_RELOC_ARM_PCREL_JUMP
4524     ARM 26-bit pc-relative branch for B or conditional BL instruction.
4525 -- : BFD_RELOC_THUMB_PCREL_BRANCH5
4526     ARM 5-bit pc-relative branch for Branch Future instructions.
4527 -- : BFD_RELOC_THUMB_PCREL_BFCSEL
4528     ARM 6-bit pc-relative branch for BFCSEL instruction.
4529 -- : BFD_RELOC_ARM_THUMB_BF17
4530     ARM 17-bit pc-relative branch for Branch Future instructions.
4531 -- : BFD_RELOC_ARM_THUMB_BF13
4532     ARM 13-bit pc-relative branch for BFCSEL instruction.
4533 -- : BFD_RELOC_ARM_THUMB_BF19
4534     ARM 19-bit pc-relative branch for Branch Future Link instruction.
4535 -- : BFD_RELOC_ARM_THUMB_LOOP12
4536     ARM 12-bit pc-relative branch for Low Overhead Loop instructions.
4537 -- : BFD_RELOC_THUMB_PCREL_BRANCH7
4538 -- : BFD_RELOC_THUMB_PCREL_BRANCH9
4539 -- : BFD_RELOC_THUMB_PCREL_BRANCH12
4540 -- : BFD_RELOC_THUMB_PCREL_BRANCH20
4541 -- : BFD_RELOC_THUMB_PCREL_BRANCH23
4542 -- : BFD_RELOC_THUMB_PCREL_BRANCH25
4543     Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.  The
4544     lowest bit must be zero and is not stored in the instruction.  Note
4545     that the corresponding ELF R_ARM_THM_JUMPnn constant has an "nn"
4546     one smaller in all cases.  Note further that BRANCH23 corresponds
4547     to R_ARM_THM_CALL.
4548 -- : BFD_RELOC_ARM_OFFSET_IMM
4549     12-bit immediate offset, used in ARM-format ldr and str
4550     instructions.
4551 -- : BFD_RELOC_ARM_THUMB_OFFSET
4552     5-bit immediate offset, used in Thumb-format ldr and str
4553     instructions.
4554 -- : BFD_RELOC_ARM_TARGET1
4555     Pc-relative or absolute relocation depending on target.  Used for
4556     entries in .init_array sections.
4557 -- : BFD_RELOC_ARM_ROSEGREL32
4558     Read-only segment base relative address.
4559 -- : BFD_RELOC_ARM_SBREL32
4560     Data segment base relative address.
4561 -- : BFD_RELOC_ARM_TARGET2
4562     This reloc is used for references to RTTI data from exception
4563     handling tables.  The actual definition depends on the target.  It
4564     may be a pc-relative or some form of GOT-indirect relocation.
4565 -- : BFD_RELOC_ARM_PREL31
4566     31-bit PC relative address.
4567 -- : BFD_RELOC_ARM_MOVW
4568 -- : BFD_RELOC_ARM_MOVT
4569 -- : BFD_RELOC_ARM_MOVW_PCREL
4570 -- : BFD_RELOC_ARM_MOVT_PCREL
4571 -- : BFD_RELOC_ARM_THUMB_MOVW
4572 -- : BFD_RELOC_ARM_THUMB_MOVT
4573 -- : BFD_RELOC_ARM_THUMB_MOVW_PCREL
4574 -- : BFD_RELOC_ARM_THUMB_MOVT_PCREL
4575     Low and High halfword relocations for MOVW and MOVT instructions.
4576 -- : BFD_RELOC_ARM_GOTFUNCDESC
4577 -- : BFD_RELOC_ARM_GOTOFFFUNCDESC
4578 -- : BFD_RELOC_ARM_FUNCDESC
4579 -- : BFD_RELOC_ARM_FUNCDESC_VALUE
4580 -- : BFD_RELOC_ARM_TLS_GD32_FDPIC
4581 -- : BFD_RELOC_ARM_TLS_LDM32_FDPIC
4582 -- : BFD_RELOC_ARM_TLS_IE32_FDPIC
4583     ARM FDPIC specific relocations.
4584 -- : BFD_RELOC_ARM_JUMP_SLOT
4585 -- : BFD_RELOC_ARM_GLOB_DAT
4586 -- : BFD_RELOC_ARM_GOT32
4587 -- : BFD_RELOC_ARM_PLT32
4588 -- : BFD_RELOC_ARM_RELATIVE
4589 -- : BFD_RELOC_ARM_GOTOFF
4590 -- : BFD_RELOC_ARM_GOTPC
4591 -- : BFD_RELOC_ARM_GOT_PREL
4592     Relocations for setting up GOTs and PLTs for shared libraries.
4593 -- : BFD_RELOC_ARM_TLS_GD32
4594 -- : BFD_RELOC_ARM_TLS_LDO32
4595 -- : BFD_RELOC_ARM_TLS_LDM32
4596 -- : BFD_RELOC_ARM_TLS_DTPOFF32
4597 -- : BFD_RELOC_ARM_TLS_DTPMOD32
4598 -- : BFD_RELOC_ARM_TLS_TPOFF32
4599 -- : BFD_RELOC_ARM_TLS_IE32
4600 -- : BFD_RELOC_ARM_TLS_LE32
4601 -- : BFD_RELOC_ARM_TLS_GOTDESC
4602 -- : BFD_RELOC_ARM_TLS_CALL
4603 -- : BFD_RELOC_ARM_THM_TLS_CALL
4604 -- : BFD_RELOC_ARM_TLS_DESCSEQ
4605 -- : BFD_RELOC_ARM_THM_TLS_DESCSEQ
4606 -- : BFD_RELOC_ARM_TLS_DESC
4607     ARM thread-local storage relocations.
4608 -- : BFD_RELOC_ARM_ALU_PC_G0_NC
4609 -- : BFD_RELOC_ARM_ALU_PC_G0
4610 -- : BFD_RELOC_ARM_ALU_PC_G1_NC
4611 -- : BFD_RELOC_ARM_ALU_PC_G1
4612 -- : BFD_RELOC_ARM_ALU_PC_G2
4613 -- : BFD_RELOC_ARM_LDR_PC_G0
4614 -- : BFD_RELOC_ARM_LDR_PC_G1
4615 -- : BFD_RELOC_ARM_LDR_PC_G2
4616 -- : BFD_RELOC_ARM_LDRS_PC_G0
4617 -- : BFD_RELOC_ARM_LDRS_PC_G1
4618 -- : BFD_RELOC_ARM_LDRS_PC_G2
4619 -- : BFD_RELOC_ARM_LDC_PC_G0
4620 -- : BFD_RELOC_ARM_LDC_PC_G1
4621 -- : BFD_RELOC_ARM_LDC_PC_G2
4622 -- : BFD_RELOC_ARM_ALU_SB_G0_NC
4623 -- : BFD_RELOC_ARM_ALU_SB_G0
4624 -- : BFD_RELOC_ARM_ALU_SB_G1_NC
4625 -- : BFD_RELOC_ARM_ALU_SB_G1
4626 -- : BFD_RELOC_ARM_ALU_SB_G2
4627 -- : BFD_RELOC_ARM_LDR_SB_G0
4628 -- : BFD_RELOC_ARM_LDR_SB_G1
4629 -- : BFD_RELOC_ARM_LDR_SB_G2
4630 -- : BFD_RELOC_ARM_LDRS_SB_G0
4631 -- : BFD_RELOC_ARM_LDRS_SB_G1
4632 -- : BFD_RELOC_ARM_LDRS_SB_G2
4633 -- : BFD_RELOC_ARM_LDC_SB_G0
4634 -- : BFD_RELOC_ARM_LDC_SB_G1
4635 -- : BFD_RELOC_ARM_LDC_SB_G2
4636     ARM group relocations.
4637 -- : BFD_RELOC_ARM_V4BX
4638     Annotation of BX instructions.
4639 -- : BFD_RELOC_ARM_IRELATIVE
4640     ARM support for STT_GNU_IFUNC.
4641 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC
4642 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC
4643 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC
4644 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC
4645     Thumb1 relocations to support execute-only code.
4646 -- : BFD_RELOC_ARM_IMMEDIATE
4647 -- : BFD_RELOC_ARM_ADRL_IMMEDIATE
4648 -- : BFD_RELOC_ARM_T32_IMMEDIATE
4649 -- : BFD_RELOC_ARM_T32_ADD_IMM
4650 -- : BFD_RELOC_ARM_T32_IMM12
4651 -- : BFD_RELOC_ARM_T32_ADD_PC12
4652 -- : BFD_RELOC_ARM_SHIFT_IMM
4653 -- : BFD_RELOC_ARM_SMC
4654 -- : BFD_RELOC_ARM_HVC
4655 -- : BFD_RELOC_ARM_SWI
4656 -- : BFD_RELOC_ARM_MULTI
4657 -- : BFD_RELOC_ARM_CP_OFF_IMM
4658 -- : BFD_RELOC_ARM_CP_OFF_IMM_S2
4659 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM
4660 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
4661 -- : BFD_RELOC_ARM_T32_VLDR_VSTR_OFF_IMM
4662 -- : BFD_RELOC_ARM_ADR_IMM
4663 -- : BFD_RELOC_ARM_LDR_IMM
4664 -- : BFD_RELOC_ARM_LITERAL
4665 -- : BFD_RELOC_ARM_IN_POOL
4666 -- : BFD_RELOC_ARM_OFFSET_IMM8
4667 -- : BFD_RELOC_ARM_T32_OFFSET_U8
4668 -- : BFD_RELOC_ARM_T32_OFFSET_IMM
4669 -- : BFD_RELOC_ARM_HWLITERAL
4670 -- : BFD_RELOC_ARM_THUMB_ADD
4671 -- : BFD_RELOC_ARM_THUMB_IMM
4672 -- : BFD_RELOC_ARM_THUMB_SHIFT
4673     These relocs are only used within the ARM assembler.  They are not
4674     (at present) written to any object files.
4675 -- : BFD_RELOC_SH_PCDISP8BY2
4676 -- : BFD_RELOC_SH_PCDISP12BY2
4677 -- : BFD_RELOC_SH_IMM3
4678 -- : BFD_RELOC_SH_IMM3U
4679 -- : BFD_RELOC_SH_DISP12
4680 -- : BFD_RELOC_SH_DISP12BY2
4681 -- : BFD_RELOC_SH_DISP12BY4
4682 -- : BFD_RELOC_SH_DISP12BY8
4683 -- : BFD_RELOC_SH_DISP20
4684 -- : BFD_RELOC_SH_DISP20BY8
4685 -- : BFD_RELOC_SH_IMM4
4686 -- : BFD_RELOC_SH_IMM4BY2
4687 -- : BFD_RELOC_SH_IMM4BY4
4688 -- : BFD_RELOC_SH_IMM8
4689 -- : BFD_RELOC_SH_IMM8BY2
4690 -- : BFD_RELOC_SH_IMM8BY4
4691 -- : BFD_RELOC_SH_PCRELIMM8BY2
4692 -- : BFD_RELOC_SH_PCRELIMM8BY4
4693 -- : BFD_RELOC_SH_SWITCH16
4694 -- : BFD_RELOC_SH_SWITCH32
4695 -- : BFD_RELOC_SH_USES
4696 -- : BFD_RELOC_SH_COUNT
4697 -- : BFD_RELOC_SH_ALIGN
4698 -- : BFD_RELOC_SH_CODE
4699 -- : BFD_RELOC_SH_DATA
4700 -- : BFD_RELOC_SH_LABEL
4701 -- : BFD_RELOC_SH_LOOP_START
4702 -- : BFD_RELOC_SH_LOOP_END
4703 -- : BFD_RELOC_SH_COPY
4704 -- : BFD_RELOC_SH_GLOB_DAT
4705 -- : BFD_RELOC_SH_JMP_SLOT
4706 -- : BFD_RELOC_SH_RELATIVE
4707 -- : BFD_RELOC_SH_GOTPC
4708 -- : BFD_RELOC_SH_GOT_LOW16
4709 -- : BFD_RELOC_SH_GOT_MEDLOW16
4710 -- : BFD_RELOC_SH_GOT_MEDHI16
4711 -- : BFD_RELOC_SH_GOT_HI16
4712 -- : BFD_RELOC_SH_GOTPLT_LOW16
4713 -- : BFD_RELOC_SH_GOTPLT_MEDLOW16
4714 -- : BFD_RELOC_SH_GOTPLT_MEDHI16
4715 -- : BFD_RELOC_SH_GOTPLT_HI16
4716 -- : BFD_RELOC_SH_PLT_LOW16
4717 -- : BFD_RELOC_SH_PLT_MEDLOW16
4718 -- : BFD_RELOC_SH_PLT_MEDHI16
4719 -- : BFD_RELOC_SH_PLT_HI16
4720 -- : BFD_RELOC_SH_GOTOFF_LOW16
4721 -- : BFD_RELOC_SH_GOTOFF_MEDLOW16
4722 -- : BFD_RELOC_SH_GOTOFF_MEDHI16
4723 -- : BFD_RELOC_SH_GOTOFF_HI16
4724 -- : BFD_RELOC_SH_GOTPC_LOW16
4725 -- : BFD_RELOC_SH_GOTPC_MEDLOW16
4726 -- : BFD_RELOC_SH_GOTPC_MEDHI16
4727 -- : BFD_RELOC_SH_GOTPC_HI16
4728 -- : BFD_RELOC_SH_COPY64
4729 -- : BFD_RELOC_SH_GLOB_DAT64
4730 -- : BFD_RELOC_SH_JMP_SLOT64
4731 -- : BFD_RELOC_SH_RELATIVE64
4732 -- : BFD_RELOC_SH_GOT10BY4
4733 -- : BFD_RELOC_SH_GOT10BY8
4734 -- : BFD_RELOC_SH_GOTPLT10BY4
4735 -- : BFD_RELOC_SH_GOTPLT10BY8
4736 -- : BFD_RELOC_SH_GOTPLT32
4737 -- : BFD_RELOC_SH_SHMEDIA_CODE
4738 -- : BFD_RELOC_SH_IMMU5
4739 -- : BFD_RELOC_SH_IMMS6
4740 -- : BFD_RELOC_SH_IMMS6BY32
4741 -- : BFD_RELOC_SH_IMMU6
4742 -- : BFD_RELOC_SH_IMMS10
4743 -- : BFD_RELOC_SH_IMMS10BY2
4744 -- : BFD_RELOC_SH_IMMS10BY4
4745 -- : BFD_RELOC_SH_IMMS10BY8
4746 -- : BFD_RELOC_SH_IMMS16
4747 -- : BFD_RELOC_SH_IMMU16
4748 -- : BFD_RELOC_SH_IMM_LOW16
4749 -- : BFD_RELOC_SH_IMM_LOW16_PCREL
4750 -- : BFD_RELOC_SH_IMM_MEDLOW16
4751 -- : BFD_RELOC_SH_IMM_MEDLOW16_PCREL
4752 -- : BFD_RELOC_SH_IMM_MEDHI16
4753 -- : BFD_RELOC_SH_IMM_MEDHI16_PCREL
4754 -- : BFD_RELOC_SH_IMM_HI16
4755 -- : BFD_RELOC_SH_IMM_HI16_PCREL
4756 -- : BFD_RELOC_SH_PT_16
4757 -- : BFD_RELOC_SH_TLS_GD_32
4758 -- : BFD_RELOC_SH_TLS_LD_32
4759 -- : BFD_RELOC_SH_TLS_LDO_32
4760 -- : BFD_RELOC_SH_TLS_IE_32
4761 -- : BFD_RELOC_SH_TLS_LE_32
4762 -- : BFD_RELOC_SH_TLS_DTPMOD32
4763 -- : BFD_RELOC_SH_TLS_DTPOFF32
4764 -- : BFD_RELOC_SH_TLS_TPOFF32
4765 -- : BFD_RELOC_SH_GOT20
4766 -- : BFD_RELOC_SH_GOTOFF20
4767 -- : BFD_RELOC_SH_GOTFUNCDESC
4768 -- : BFD_RELOC_SH_GOTFUNCDESC20
4769 -- : BFD_RELOC_SH_GOTOFFFUNCDESC
4770 -- : BFD_RELOC_SH_GOTOFFFUNCDESC20
4771 -- : BFD_RELOC_SH_FUNCDESC
4772     Renesas / SuperH SH relocs.  Not all of these appear in object
4773     files.
4774 -- : BFD_RELOC_ARC_NONE
4775 -- : BFD_RELOC_ARC_8
4776 -- : BFD_RELOC_ARC_16
4777 -- : BFD_RELOC_ARC_24
4778 -- : BFD_RELOC_ARC_32
4779 -- : BFD_RELOC_ARC_N8
4780 -- : BFD_RELOC_ARC_N16
4781 -- : BFD_RELOC_ARC_N24
4782 -- : BFD_RELOC_ARC_N32
4783 -- : BFD_RELOC_ARC_SDA
4784 -- : BFD_RELOC_ARC_SECTOFF
4785 -- : BFD_RELOC_ARC_S21H_PCREL
4786 -- : BFD_RELOC_ARC_S21W_PCREL
4787 -- : BFD_RELOC_ARC_S25H_PCREL
4788 -- : BFD_RELOC_ARC_S25W_PCREL
4789 -- : BFD_RELOC_ARC_SDA32
4790 -- : BFD_RELOC_ARC_SDA_LDST
4791 -- : BFD_RELOC_ARC_SDA_LDST1
4792 -- : BFD_RELOC_ARC_SDA_LDST2
4793 -- : BFD_RELOC_ARC_SDA16_LD
4794 -- : BFD_RELOC_ARC_SDA16_LD1
4795 -- : BFD_RELOC_ARC_SDA16_LD2
4796 -- : BFD_RELOC_ARC_S13_PCREL
4797 -- : BFD_RELOC_ARC_W
4798 -- : BFD_RELOC_ARC_32_ME
4799 -- : BFD_RELOC_ARC_32_ME_S
4800 -- : BFD_RELOC_ARC_N32_ME
4801 -- : BFD_RELOC_ARC_SECTOFF_ME
4802 -- : BFD_RELOC_ARC_SDA32_ME
4803 -- : BFD_RELOC_ARC_W_ME
4804 -- : BFD_RELOC_AC_SECTOFF_U8
4805 -- : BFD_RELOC_AC_SECTOFF_U8_1
4806 -- : BFD_RELOC_AC_SECTOFF_U8_2
4807 -- : BFD_RELOC_AC_SECTOFF_S9
4808 -- : BFD_RELOC_AC_SECTOFF_S9_1
4809 -- : BFD_RELOC_AC_SECTOFF_S9_2
4810 -- : BFD_RELOC_ARC_SECTOFF_ME_1
4811 -- : BFD_RELOC_ARC_SECTOFF_ME_2
4812 -- : BFD_RELOC_ARC_SECTOFF_1
4813 -- : BFD_RELOC_ARC_SECTOFF_2
4814 -- : BFD_RELOC_ARC_SDA_12
4815 -- : BFD_RELOC_ARC_SDA16_ST2
4816 -- : BFD_RELOC_ARC_32_PCREL
4817 -- : BFD_RELOC_ARC_PC32
4818 -- : BFD_RELOC_ARC_GOT32
4819 -- : BFD_RELOC_ARC_GOTPC32
4820 -- : BFD_RELOC_ARC_PLT32
4821 -- : BFD_RELOC_ARC_COPY
4822 -- : BFD_RELOC_ARC_GLOB_DAT
4823 -- : BFD_RELOC_ARC_JMP_SLOT
4824 -- : BFD_RELOC_ARC_RELATIVE
4825 -- : BFD_RELOC_ARC_GOTOFF
4826 -- : BFD_RELOC_ARC_GOTPC
4827 -- : BFD_RELOC_ARC_S21W_PCREL_PLT
4828 -- : BFD_RELOC_ARC_S25H_PCREL_PLT
4829 -- : BFD_RELOC_ARC_TLS_DTPMOD
4830 -- : BFD_RELOC_ARC_TLS_TPOFF
4831 -- : BFD_RELOC_ARC_TLS_GD_GOT
4832 -- : BFD_RELOC_ARC_TLS_GD_LD
4833 -- : BFD_RELOC_ARC_TLS_GD_CALL
4834 -- : BFD_RELOC_ARC_TLS_IE_GOT
4835 -- : BFD_RELOC_ARC_TLS_DTPOFF
4836 -- : BFD_RELOC_ARC_TLS_DTPOFF_S9
4837 -- : BFD_RELOC_ARC_TLS_LE_S9
4838 -- : BFD_RELOC_ARC_TLS_LE_32
4839 -- : BFD_RELOC_ARC_S25W_PCREL_PLT
4840 -- : BFD_RELOC_ARC_S21H_PCREL_PLT
4841 -- : BFD_RELOC_ARC_NPS_CMEM16
4842 -- : BFD_RELOC_ARC_JLI_SECTOFF
4843     ARC relocs.
4844 -- : BFD_RELOC_BFIN_16_IMM
4845     ADI Blackfin 16 bit immediate absolute reloc.
4846 -- : BFD_RELOC_BFIN_16_HIGH
4847     ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
4848 -- : BFD_RELOC_BFIN_4_PCREL
4849     ADI Blackfin 'a' part of LSETUP.
4850 -- : BFD_RELOC_BFIN_5_PCREL
4851     ADI Blackfin.
4852 -- : BFD_RELOC_BFIN_16_LOW
4853     ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
4854 -- : BFD_RELOC_BFIN_10_PCREL
4855     ADI Blackfin.
4856 -- : BFD_RELOC_BFIN_11_PCREL
4857     ADI Blackfin 'b' part of LSETUP.
4858 -- : BFD_RELOC_BFIN_12_PCREL_JUMP
4859     ADI Blackfin.
4860 -- : BFD_RELOC_BFIN_12_PCREL_JUMP_S
4861     ADI Blackfin Short jump, pcrel.
4862 -- : BFD_RELOC_BFIN_24_PCREL_CALL_X
4863     ADI Blackfin Call.x not implemented.
4864 -- : BFD_RELOC_BFIN_24_PCREL_JUMP_L
4865     ADI Blackfin Long Jump pcrel.
4866 -- : BFD_RELOC_BFIN_GOT17M4
4867 -- : BFD_RELOC_BFIN_GOTHI
4868 -- : BFD_RELOC_BFIN_GOTLO
4869 -- : BFD_RELOC_BFIN_FUNCDESC
4870 -- : BFD_RELOC_BFIN_FUNCDESC_GOT17M4
4871 -- : BFD_RELOC_BFIN_FUNCDESC_GOTHI
4872 -- : BFD_RELOC_BFIN_FUNCDESC_GOTLO
4873 -- : BFD_RELOC_BFIN_FUNCDESC_VALUE
4874 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
4875 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
4876 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
4877 -- : BFD_RELOC_BFIN_GOTOFF17M4
4878 -- : BFD_RELOC_BFIN_GOTOFFHI
4879 -- : BFD_RELOC_BFIN_GOTOFFLO
4880     ADI Blackfin FD-PIC relocations.
4881 -- : BFD_RELOC_BFIN_GOT
4882     ADI Blackfin GOT relocation.
4883 -- : BFD_RELOC_BFIN_PLTPC
4884     ADI Blackfin PLTPC relocation.
4885 -- : BFD_ARELOC_BFIN_PUSH
4886     ADI Blackfin arithmetic relocation.
4887 -- : BFD_ARELOC_BFIN_CONST
4888     ADI Blackfin arithmetic relocation.
4889 -- : BFD_ARELOC_BFIN_ADD
4890     ADI Blackfin arithmetic relocation.
4891 -- : BFD_ARELOC_BFIN_SUB
4892     ADI Blackfin arithmetic relocation.
4893 -- : BFD_ARELOC_BFIN_MULT
4894     ADI Blackfin arithmetic relocation.
4895 -- : BFD_ARELOC_BFIN_DIV
4896     ADI Blackfin arithmetic relocation.
4897 -- : BFD_ARELOC_BFIN_MOD
4898     ADI Blackfin arithmetic relocation.
4899 -- : BFD_ARELOC_BFIN_LSHIFT
4900     ADI Blackfin arithmetic relocation.
4901 -- : BFD_ARELOC_BFIN_RSHIFT
4902     ADI Blackfin arithmetic relocation.
4903 -- : BFD_ARELOC_BFIN_AND
4904     ADI Blackfin arithmetic relocation.
4905 -- : BFD_ARELOC_BFIN_OR
4906     ADI Blackfin arithmetic relocation.
4907 -- : BFD_ARELOC_BFIN_XOR
4908     ADI Blackfin arithmetic relocation.
4909 -- : BFD_ARELOC_BFIN_LAND
4910     ADI Blackfin arithmetic relocation.
4911 -- : BFD_ARELOC_BFIN_LOR
4912     ADI Blackfin arithmetic relocation.
4913 -- : BFD_ARELOC_BFIN_LEN
4914     ADI Blackfin arithmetic relocation.
4915 -- : BFD_ARELOC_BFIN_NEG
4916     ADI Blackfin arithmetic relocation.
4917 -- : BFD_ARELOC_BFIN_COMP
4918     ADI Blackfin arithmetic relocation.
4919 -- : BFD_ARELOC_BFIN_PAGE
4920     ADI Blackfin arithmetic relocation.
4921 -- : BFD_ARELOC_BFIN_HWPAGE
4922     ADI Blackfin arithmetic relocation.
4923 -- : BFD_ARELOC_BFIN_ADDR
4924     ADI Blackfin arithmetic relocation.
4925 -- : BFD_RELOC_D10V_10_PCREL_R
4926     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4927     bits assumed to be 0.
4928 -- : BFD_RELOC_D10V_10_PCREL_L
4929     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4930     bits assumed to be 0.  This is the same as the previous reloc
4931     except it is in the left container, i.e., shifted left 15 bits.
4932 -- : BFD_RELOC_D10V_18
4933     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4934 -- : BFD_RELOC_D10V_18_PCREL
4935     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4936 -- : BFD_RELOC_D30V_6
4937     Mitsubishi D30V relocs.  This is a 6-bit absolute reloc.
4938 -- : BFD_RELOC_D30V_9_PCREL
4939     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4940     be 0.
4941 -- : BFD_RELOC_D30V_9_PCREL_R
4942     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4943     be 0.  Same as the previous reloc but on the right side of the
4944     container.
4945 -- : BFD_RELOC_D30V_15
4946     This is a 12-bit absolute reloc with the right 3 bitsassumed to be
4947     0.
4948 -- : BFD_RELOC_D30V_15_PCREL
4949     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4950     be 0.
4951 -- : BFD_RELOC_D30V_15_PCREL_R
4952     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4953     be 0.  Same as the previous reloc but on the right side of the
4954     container.
4955 -- : BFD_RELOC_D30V_21
4956     This is an 18-bit absolute reloc with the right 3 bits assumed to
4957     be 0.
4958 -- : BFD_RELOC_D30V_21_PCREL
4959     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4960     to be 0.
4961 -- : BFD_RELOC_D30V_21_PCREL_R
4962     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4963     to be 0.  Same as the previous reloc but on the right side of the
4964     container.
4965 -- : BFD_RELOC_D30V_32
4966     This is a 32-bit absolute reloc.
4967 -- : BFD_RELOC_D30V_32_PCREL
4968     This is a 32-bit pc-relative reloc.
4969 -- : BFD_RELOC_DLX_HI16_S
4970     DLX relocs
4971 -- : BFD_RELOC_DLX_LO16
4972     DLX relocs
4973 -- : BFD_RELOC_DLX_JMP26
4974     DLX relocs
4975 -- : BFD_RELOC_M32C_HI8
4976 -- : BFD_RELOC_M32C_RL_JUMP
4977 -- : BFD_RELOC_M32C_RL_1ADDR
4978 -- : BFD_RELOC_M32C_RL_2ADDR
4979     Renesas M16C/M32C Relocations.
4980 -- : BFD_RELOC_M32R_24
4981     Renesas M32R (formerly Mitsubishi M32R) relocs.  This is a 24 bit
4982     absolute address.
4983 -- : BFD_RELOC_M32R_10_PCREL
4984     This is a 10-bit pc-relative reloc with the right 2 bits assumed to
4985     be 0.
4986 -- : BFD_RELOC_M32R_18_PCREL
4987     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4988 -- : BFD_RELOC_M32R_26_PCREL
4989     This is a 26-bit reloc with the right 2 bits assumed to be 0.
4990 -- : BFD_RELOC_M32R_HI16_ULO
4991     This is a 16-bit reloc containing the high 16 bits of an address
4992     used when the lower 16 bits are treated as unsigned.
4993 -- : BFD_RELOC_M32R_HI16_SLO
4994     This is a 16-bit reloc containing the high 16 bits of an address
4995     used when the lower 16 bits are treated as signed.
4996 -- : BFD_RELOC_M32R_LO16
4997     This is a 16-bit reloc containing the lower 16 bits of an address.
4998 -- : BFD_RELOC_M32R_SDA16
4999     This is a 16-bit reloc containing the small data area offset for
5000     use in add3, load, and store instructions.
5001 -- : BFD_RELOC_M32R_GOT24
5002 -- : BFD_RELOC_M32R_26_PLTREL
5003 -- : BFD_RELOC_M32R_COPY
5004 -- : BFD_RELOC_M32R_GLOB_DAT
5005 -- : BFD_RELOC_M32R_JMP_SLOT
5006 -- : BFD_RELOC_M32R_RELATIVE
5007 -- : BFD_RELOC_M32R_GOTOFF
5008 -- : BFD_RELOC_M32R_GOTOFF_HI_ULO
5009 -- : BFD_RELOC_M32R_GOTOFF_HI_SLO
5010 -- : BFD_RELOC_M32R_GOTOFF_LO
5011 -- : BFD_RELOC_M32R_GOTPC24
5012 -- : BFD_RELOC_M32R_GOT16_HI_ULO
5013 -- : BFD_RELOC_M32R_GOT16_HI_SLO
5014 -- : BFD_RELOC_M32R_GOT16_LO
5015 -- : BFD_RELOC_M32R_GOTPC_HI_ULO
5016 -- : BFD_RELOC_M32R_GOTPC_HI_SLO
5017 -- : BFD_RELOC_M32R_GOTPC_LO
5018     For PIC.
5019 -- : BFD_RELOC_NDS32_20
5020     NDS32 relocs.  This is a 20 bit absolute address.
5021 -- : BFD_RELOC_NDS32_9_PCREL
5022     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
5023     be 0.
5024 -- : BFD_RELOC_NDS32_WORD_9_PCREL
5025     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
5026     be 0.
5027 -- : BFD_RELOC_NDS32_15_PCREL
5028     This is an 15-bit reloc with the right 1 bit assumed to be 0.
5029 -- : BFD_RELOC_NDS32_17_PCREL
5030     This is an 17-bit reloc with the right 1 bit assumed to be 0.
5031 -- : BFD_RELOC_NDS32_25_PCREL
5032     This is a 25-bit reloc with the right 1 bit assumed to be 0.
5033 -- : BFD_RELOC_NDS32_HI20
5034     This is a 20-bit reloc containing the high 20 bits of an address
5035     used with the lower 12 bits
5036 -- : BFD_RELOC_NDS32_LO12S3
5037     This is a 12-bit reloc containing the lower 12 bits of an address
5038     then shift right by 3.  This is used with ldi,sdi...
5039 -- : BFD_RELOC_NDS32_LO12S2
5040     This is a 12-bit reloc containing the lower 12 bits of an address
5041     then shift left by 2.  This is used with lwi,swi...
5042 -- : BFD_RELOC_NDS32_LO12S1
5043     This is a 12-bit reloc containing the lower 12 bits of an address
5044     then shift left by 1.  This is used with lhi,shi...
5045 -- : BFD_RELOC_NDS32_LO12S0
5046     This is a 12-bit reloc containing the lower 12 bits of an address
5047     then shift left by 0.  This is used with lbisbi...
5048 -- : BFD_RELOC_NDS32_LO12S0_ORI
5049     This is a 12-bit reloc containing the lower 12 bits of an address
5050     then shift left by 0.  This is only used with branch relaxations
5051 -- : BFD_RELOC_NDS32_SDA15S3
5052     This is a 15-bit reloc containing the small data area 18-bit signed
5053     offset and shift left by 3 for use in ldi, sdi...
5054 -- : BFD_RELOC_NDS32_SDA15S2
5055     This is a 15-bit reloc containing the small data area 17-bit signed
5056     offset and shift left by 2 for use in lwi, swi...
5057 -- : BFD_RELOC_NDS32_SDA15S1
5058     This is a 15-bit reloc containing the small data area 16-bit signed
5059     offset and shift left by 1 for use in lhi, shi...
5060 -- : BFD_RELOC_NDS32_SDA15S0
5061     This is a 15-bit reloc containing the small data area 15-bit signed
5062     offset and shift left by 0 for use in lbi, sbi...
5063 -- : BFD_RELOC_NDS32_SDA16S3
5064     This is a 16-bit reloc containing the small data area 16-bit signed
5065     offset and shift left by 3
5066 -- : BFD_RELOC_NDS32_SDA17S2
5067     This is a 17-bit reloc containing the small data area 17-bit signed
5068     offset and shift left by 2 for use in lwi.gp, swi.gp...
5069 -- : BFD_RELOC_NDS32_SDA18S1
5070     This is a 18-bit reloc containing the small data area 18-bit signed
5071     offset and shift left by 1 for use in lhi.gp, shi.gp...
5072 -- : BFD_RELOC_NDS32_SDA19S0
5073     This is a 19-bit reloc containing the small data area 19-bit signed
5074     offset and shift left by 0 for use in lbi.gp, sbi.gp...
5075 -- : BFD_RELOC_NDS32_GOT20
5076 -- : BFD_RELOC_NDS32_9_PLTREL
5077 -- : BFD_RELOC_NDS32_25_PLTREL
5078 -- : BFD_RELOC_NDS32_COPY
5079 -- : BFD_RELOC_NDS32_GLOB_DAT
5080 -- : BFD_RELOC_NDS32_JMP_SLOT
5081 -- : BFD_RELOC_NDS32_RELATIVE
5082 -- : BFD_RELOC_NDS32_GOTOFF
5083 -- : BFD_RELOC_NDS32_GOTOFF_HI20
5084 -- : BFD_RELOC_NDS32_GOTOFF_LO12
5085 -- : BFD_RELOC_NDS32_GOTPC20
5086 -- : BFD_RELOC_NDS32_GOT_HI20
5087 -- : BFD_RELOC_NDS32_GOT_LO12
5088 -- : BFD_RELOC_NDS32_GOTPC_HI20
5089 -- : BFD_RELOC_NDS32_GOTPC_LO12
5090     for PIC
5091 -- : BFD_RELOC_NDS32_INSN16
5092 -- : BFD_RELOC_NDS32_LABEL
5093 -- : BFD_RELOC_NDS32_LONGCALL1
5094 -- : BFD_RELOC_NDS32_LONGCALL2
5095 -- : BFD_RELOC_NDS32_LONGCALL3
5096 -- : BFD_RELOC_NDS32_LONGJUMP1
5097 -- : BFD_RELOC_NDS32_LONGJUMP2
5098 -- : BFD_RELOC_NDS32_LONGJUMP3
5099 -- : BFD_RELOC_NDS32_LOADSTORE
5100 -- : BFD_RELOC_NDS32_9_FIXED
5101 -- : BFD_RELOC_NDS32_15_FIXED
5102 -- : BFD_RELOC_NDS32_17_FIXED
5103 -- : BFD_RELOC_NDS32_25_FIXED
5104 -- : BFD_RELOC_NDS32_LONGCALL4
5105 -- : BFD_RELOC_NDS32_LONGCALL5
5106 -- : BFD_RELOC_NDS32_LONGCALL6
5107 -- : BFD_RELOC_NDS32_LONGJUMP4
5108 -- : BFD_RELOC_NDS32_LONGJUMP5
5109 -- : BFD_RELOC_NDS32_LONGJUMP6
5110 -- : BFD_RELOC_NDS32_LONGJUMP7
5111     for relax
5112 -- : BFD_RELOC_NDS32_PLTREL_HI20
5113 -- : BFD_RELOC_NDS32_PLTREL_LO12
5114 -- : BFD_RELOC_NDS32_PLT_GOTREL_HI20
5115 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO12
5116     for PIC
5117 -- : BFD_RELOC_NDS32_SDA12S2_DP
5118 -- : BFD_RELOC_NDS32_SDA12S2_SP
5119 -- : BFD_RELOC_NDS32_LO12S2_DP
5120 -- : BFD_RELOC_NDS32_LO12S2_SP
5121     for floating point
5122 -- : BFD_RELOC_NDS32_DWARF2_OP1
5123 -- : BFD_RELOC_NDS32_DWARF2_OP2
5124 -- : BFD_RELOC_NDS32_DWARF2_LEB
5125     for dwarf2 debug_line.
5126 -- : BFD_RELOC_NDS32_UPDATE_TA
5127     for eliminate 16-bit instructions
5128 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO20
5129 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO15
5130 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO19
5131 -- : BFD_RELOC_NDS32_GOT_LO15
5132 -- : BFD_RELOC_NDS32_GOT_LO19
5133 -- : BFD_RELOC_NDS32_GOTOFF_LO15
5134 -- : BFD_RELOC_NDS32_GOTOFF_LO19
5135 -- : BFD_RELOC_NDS32_GOT15S2
5136 -- : BFD_RELOC_NDS32_GOT17S2
5137     for PIC object relaxation
5138 -- : BFD_RELOC_NDS32_5
5139     NDS32 relocs.  This is a 5 bit absolute address.
5140 -- : BFD_RELOC_NDS32_10_UPCREL
5141     This is a 10-bit unsigned pc-relative reloc with the right 1 bit
5142     assumed to be 0.
5143 -- : BFD_RELOC_NDS32_SDA_FP7U2_RELA
5144     If fp were omitted, fp can used as another gp.
5145 -- : BFD_RELOC_NDS32_RELAX_ENTRY
5146 -- : BFD_RELOC_NDS32_GOT_SUFF
5147 -- : BFD_RELOC_NDS32_GOTOFF_SUFF
5148 -- : BFD_RELOC_NDS32_PLT_GOT_SUFF
5149 -- : BFD_RELOC_NDS32_MULCALL_SUFF
5150 -- : BFD_RELOC_NDS32_PTR
5151 -- : BFD_RELOC_NDS32_PTR_COUNT
5152 -- : BFD_RELOC_NDS32_PTR_RESOLVED
5153 -- : BFD_RELOC_NDS32_PLTBLOCK
5154 -- : BFD_RELOC_NDS32_RELAX_REGION_BEGIN
5155 -- : BFD_RELOC_NDS32_RELAX_REGION_END
5156 -- : BFD_RELOC_NDS32_MINUEND
5157 -- : BFD_RELOC_NDS32_SUBTRAHEND
5158 -- : BFD_RELOC_NDS32_DIFF8
5159 -- : BFD_RELOC_NDS32_DIFF16
5160 -- : BFD_RELOC_NDS32_DIFF32
5161 -- : BFD_RELOC_NDS32_DIFF_ULEB128
5162 -- : BFD_RELOC_NDS32_EMPTY
5163     relaxation relative relocation types
5164 -- : BFD_RELOC_NDS32_25_ABS
5165     This is a 25 bit absolute address.
5166 -- : BFD_RELOC_NDS32_DATA
5167 -- : BFD_RELOC_NDS32_TRAN
5168 -- : BFD_RELOC_NDS32_17IFC_PCREL
5169 -- : BFD_RELOC_NDS32_10IFCU_PCREL
5170     For ex9 and ifc using.
5171 -- : BFD_RELOC_NDS32_TPOFF
5172 -- : BFD_RELOC_NDS32_GOTTPOFF
5173 -- : BFD_RELOC_NDS32_TLS_LE_HI20
5174 -- : BFD_RELOC_NDS32_TLS_LE_LO12
5175 -- : BFD_RELOC_NDS32_TLS_LE_20
5176 -- : BFD_RELOC_NDS32_TLS_LE_15S0
5177 -- : BFD_RELOC_NDS32_TLS_LE_15S1
5178 -- : BFD_RELOC_NDS32_TLS_LE_15S2
5179 -- : BFD_RELOC_NDS32_TLS_LE_ADD
5180 -- : BFD_RELOC_NDS32_TLS_LE_LS
5181 -- : BFD_RELOC_NDS32_TLS_IE_HI20
5182 -- : BFD_RELOC_NDS32_TLS_IE_LO12
5183 -- : BFD_RELOC_NDS32_TLS_IE_LO12S2
5184 -- : BFD_RELOC_NDS32_TLS_IEGP_HI20
5185 -- : BFD_RELOC_NDS32_TLS_IEGP_LO12
5186 -- : BFD_RELOC_NDS32_TLS_IEGP_LO12S2
5187 -- : BFD_RELOC_NDS32_TLS_IEGP_LW
5188 -- : BFD_RELOC_NDS32_TLS_DESC
5189 -- : BFD_RELOC_NDS32_TLS_DESC_HI20
5190 -- : BFD_RELOC_NDS32_TLS_DESC_LO12
5191 -- : BFD_RELOC_NDS32_TLS_DESC_20
5192 -- : BFD_RELOC_NDS32_TLS_DESC_SDA17S2
5193 -- : BFD_RELOC_NDS32_TLS_DESC_ADD
5194 -- : BFD_RELOC_NDS32_TLS_DESC_FUNC
5195 -- : BFD_RELOC_NDS32_TLS_DESC_CALL
5196 -- : BFD_RELOC_NDS32_TLS_DESC_MEM
5197 -- : BFD_RELOC_NDS32_REMOVE
5198 -- : BFD_RELOC_NDS32_GROUP
5199     For TLS.
5200 -- : BFD_RELOC_NDS32_LSI
5201     For floating load store relaxation.
5202 -- : BFD_RELOC_V850_9_PCREL
5203     This is a 9-bit reloc
5204 -- : BFD_RELOC_V850_22_PCREL
5205     This is a 22-bit reloc
5206 -- : BFD_RELOC_V850_SDA_16_16_OFFSET
5207     This is a 16 bit offset from the short data area pointer.
5208 -- : BFD_RELOC_V850_SDA_15_16_OFFSET
5209     This is a 16 bit offset (of which only 15 bits are used) from the
5210     short data area pointer.
5211 -- : BFD_RELOC_V850_ZDA_16_16_OFFSET
5212     This is a 16 bit offset from the zero data area pointer.
5213 -- : BFD_RELOC_V850_ZDA_15_16_OFFSET
5214     This is a 16 bit offset (of which only 15 bits are used) from the
5215     zero data area pointer.
5216 -- : BFD_RELOC_V850_TDA_6_8_OFFSET
5217     This is an 8 bit offset (of which only 6 bits are used) from the
5218     tiny data area pointer.
5219 -- : BFD_RELOC_V850_TDA_7_8_OFFSET
5220     This is an 8bit offset (of which only 7 bits are used) from the
5221     tiny data area pointer.
5222 -- : BFD_RELOC_V850_TDA_7_7_OFFSET
5223     This is a 7 bit offset from the tiny data area pointer.
5224 -- : BFD_RELOC_V850_TDA_16_16_OFFSET
5225     This is a 16 bit offset from the tiny data area pointer.
5226 -- : BFD_RELOC_V850_TDA_4_5_OFFSET
5227     This is a 5 bit offset (of which only 4 bits are used) from the
5228     tiny data area pointer.
5229 -- : BFD_RELOC_V850_TDA_4_4_OFFSET
5230     This is a 4 bit offset from the tiny data area pointer.
5231 -- : BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
5232     This is a 16 bit offset from the short data area pointer, with the
5233     bits placed non-contiguously in the instruction.
5234 -- : BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
5235     This is a 16 bit offset from the zero data area pointer, with the
5236     bits placed non-contiguously in the instruction.
5237 -- : BFD_RELOC_V850_CALLT_6_7_OFFSET
5238     This is a 6 bit offset from the call table base pointer.
5239 -- : BFD_RELOC_V850_CALLT_16_16_OFFSET
5240     This is a 16 bit offset from the call table base pointer.
5241 -- : BFD_RELOC_V850_LONGCALL
5242     Used for relaxing indirect function calls.
5243 -- : BFD_RELOC_V850_LONGJUMP
5244     Used for relaxing indirect jumps.
5245 -- : BFD_RELOC_V850_ALIGN
5246     Used to maintain alignment whilst relaxing.
5247 -- : BFD_RELOC_V850_LO16_SPLIT_OFFSET
5248     This is a variation of BFD_RELOC_LO16 that can be used in v850e
5249     ld.bu instructions.
5250 -- : BFD_RELOC_V850_16_PCREL
5251     This is a 16-bit reloc.
5252 -- : BFD_RELOC_V850_17_PCREL
5253     This is a 17-bit reloc.
5254 -- : BFD_RELOC_V850_23
5255     This is a 23-bit reloc.
5256 -- : BFD_RELOC_V850_32_PCREL
5257     This is a 32-bit reloc.
5258 -- : BFD_RELOC_V850_32_ABS
5259     This is a 32-bit reloc.
5260 -- : BFD_RELOC_V850_16_SPLIT_OFFSET
5261     This is a 16-bit reloc.
5262 -- : BFD_RELOC_V850_16_S1
5263     This is a 16-bit reloc.
5264 -- : BFD_RELOC_V850_LO16_S1
5265     Low 16 bits.  16 bit shifted by 1.
5266 -- : BFD_RELOC_V850_CALLT_15_16_OFFSET
5267     This is a 16 bit offset from the call table base pointer.
5268 -- : BFD_RELOC_V850_32_GOTPCREL
5269     DSO relocations.
5270 -- : BFD_RELOC_V850_16_GOT
5271     DSO relocations.
5272 -- : BFD_RELOC_V850_32_GOT
5273     DSO relocations.
5274 -- : BFD_RELOC_V850_22_PLT_PCREL
5275     DSO relocations.
5276 -- : BFD_RELOC_V850_32_PLT_PCREL
5277     DSO relocations.
5278 -- : BFD_RELOC_V850_COPY
5279     DSO relocations.
5280 -- : BFD_RELOC_V850_GLOB_DAT
5281     DSO relocations.
5282 -- : BFD_RELOC_V850_JMP_SLOT
5283     DSO relocations.
5284 -- : BFD_RELOC_V850_RELATIVE
5285     DSO relocations.
5286 -- : BFD_RELOC_V850_16_GOTOFF
5287     DSO relocations.
5288 -- : BFD_RELOC_V850_32_GOTOFF
5289     DSO relocations.
5290 -- : BFD_RELOC_V850_CODE
5291     start code.
5292 -- : BFD_RELOC_V850_DATA
5293     start data in text.
5294 -- : BFD_RELOC_TIC30_LDP
5295     This is a 8bit DP reloc for the tms320c30, where the most
5296     significant 8 bits of a 24 bit word are placed into the least
5297     significant 8 bits of the opcode.
5298 -- : BFD_RELOC_TIC54X_PARTLS7
5299     This is a 7bit reloc for the tms320c54x, where the least
5300     significant 7 bits of a 16 bit word are placed into the least
5301     significant 7 bits of the opcode.
5302 -- : BFD_RELOC_TIC54X_PARTMS9
5303     This is a 9bit DP reloc for the tms320c54x, where the most
5304     significant 9 bits of a 16 bit word are placed into the least
5305     significant 9 bits of the opcode.
5306 -- : BFD_RELOC_TIC54X_23
5307     This is an extended address 23-bit reloc for the tms320c54x.
5308 -- : BFD_RELOC_TIC54X_16_OF_23
5309     This is a 16-bit reloc for the tms320c54x, where the least
5310     significant 16 bits of a 23-bit extended address are placed into
5311     the opcode.
5312 -- : BFD_RELOC_TIC54X_MS7_OF_23
5313     This is a reloc for the tms320c54x, where the most significant 7
5314     bits of a 23-bit extended address are placed into the opcode.
5315 -- : BFD_RELOC_C6000_PCR_S21
5316 -- : BFD_RELOC_C6000_PCR_S12
5317 -- : BFD_RELOC_C6000_PCR_S10
5318 -- : BFD_RELOC_C6000_PCR_S7
5319 -- : BFD_RELOC_C6000_ABS_S16
5320 -- : BFD_RELOC_C6000_ABS_L16
5321 -- : BFD_RELOC_C6000_ABS_H16
5322 -- : BFD_RELOC_C6000_SBR_U15_B
5323 -- : BFD_RELOC_C6000_SBR_U15_H
5324 -- : BFD_RELOC_C6000_SBR_U15_W
5325 -- : BFD_RELOC_C6000_SBR_S16
5326 -- : BFD_RELOC_C6000_SBR_L16_B
5327 -- : BFD_RELOC_C6000_SBR_L16_H
5328 -- : BFD_RELOC_C6000_SBR_L16_W
5329 -- : BFD_RELOC_C6000_SBR_H16_B
5330 -- : BFD_RELOC_C6000_SBR_H16_H
5331 -- : BFD_RELOC_C6000_SBR_H16_W
5332 -- : BFD_RELOC_C6000_SBR_GOT_U15_W
5333 -- : BFD_RELOC_C6000_SBR_GOT_L16_W
5334 -- : BFD_RELOC_C6000_SBR_GOT_H16_W
5335 -- : BFD_RELOC_C6000_DSBT_INDEX
5336 -- : BFD_RELOC_C6000_PREL31
5337 -- : BFD_RELOC_C6000_COPY
5338 -- : BFD_RELOC_C6000_JUMP_SLOT
5339 -- : BFD_RELOC_C6000_EHTYPE
5340 -- : BFD_RELOC_C6000_PCR_H16
5341 -- : BFD_RELOC_C6000_PCR_L16
5342 -- : BFD_RELOC_C6000_ALIGN
5343 -- : BFD_RELOC_C6000_FPHEAD
5344 -- : BFD_RELOC_C6000_NOCMP
5345     TMS320C6000 relocations.
5346 -- : BFD_RELOC_FR30_48
5347     This is a 48 bit reloc for the FR30 that stores 32 bits.
5348 -- : BFD_RELOC_FR30_20
5349     This is a 32 bit reloc for the FR30 that stores 20 bits split up
5350     into two sections.
5351 -- : BFD_RELOC_FR30_6_IN_4
5352     This is a 16 bit reloc for the FR30 that stores a 6 bit word offset
5353     in 4 bits.
5354 -- : BFD_RELOC_FR30_8_IN_8
5355     This is a 16 bit reloc for the FR30 that stores an 8 bit byte
5356     offset into 8 bits.
5357 -- : BFD_RELOC_FR30_9_IN_8
5358     This is a 16 bit reloc for the FR30 that stores a 9 bit short
5359     offset into 8 bits.
5360 -- : BFD_RELOC_FR30_10_IN_8
5361     This is a 16 bit reloc for the FR30 that stores a 10 bit word
5362     offset into 8 bits.
5363 -- : BFD_RELOC_FR30_9_PCREL
5364     This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
5365     short offset into 8 bits.
5366 -- : BFD_RELOC_FR30_12_PCREL
5367     This is a 16 bit reloc for the FR30 that stores a 12 bit pc
5368     relative short offset into 11 bits.
5369 -- : BFD_RELOC_MCORE_PCREL_IMM8BY4
5370 -- : BFD_RELOC_MCORE_PCREL_IMM11BY2
5371 -- : BFD_RELOC_MCORE_PCREL_IMM4BY2
5372 -- : BFD_RELOC_MCORE_PCREL_32
5373 -- : BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
5374 -- : BFD_RELOC_MCORE_RVA
5375     Motorola Mcore relocations.
5376 -- : BFD_RELOC_MEP_8
5377 -- : BFD_RELOC_MEP_16
5378 -- : BFD_RELOC_MEP_32
5379 -- : BFD_RELOC_MEP_PCREL8A2
5380 -- : BFD_RELOC_MEP_PCREL12A2
5381 -- : BFD_RELOC_MEP_PCREL17A2
5382 -- : BFD_RELOC_MEP_PCREL24A2
5383 -- : BFD_RELOC_MEP_PCABS24A2
5384 -- : BFD_RELOC_MEP_LOW16
5385 -- : BFD_RELOC_MEP_HI16U
5386 -- : BFD_RELOC_MEP_HI16S
5387 -- : BFD_RELOC_MEP_GPREL
5388 -- : BFD_RELOC_MEP_TPREL
5389 -- : BFD_RELOC_MEP_TPREL7
5390 -- : BFD_RELOC_MEP_TPREL7A2
5391 -- : BFD_RELOC_MEP_TPREL7A4
5392 -- : BFD_RELOC_MEP_UIMM24
5393 -- : BFD_RELOC_MEP_ADDR24A4
5394 -- : BFD_RELOC_MEP_GNU_VTINHERIT
5395 -- : BFD_RELOC_MEP_GNU_VTENTRY
5396     Toshiba Media Processor Relocations.
5397 -- : BFD_RELOC_METAG_HIADDR16
5398 -- : BFD_RELOC_METAG_LOADDR16
5399 -- : BFD_RELOC_METAG_RELBRANCH
5400 -- : BFD_RELOC_METAG_GETSETOFF
5401 -- : BFD_RELOC_METAG_HIOG
5402 -- : BFD_RELOC_METAG_LOOG
5403 -- : BFD_RELOC_METAG_REL8
5404 -- : BFD_RELOC_METAG_REL16
5405 -- : BFD_RELOC_METAG_HI16_GOTOFF
5406 -- : BFD_RELOC_METAG_LO16_GOTOFF
5407 -- : BFD_RELOC_METAG_GETSET_GOTOFF
5408 -- : BFD_RELOC_METAG_GETSET_GOT
5409 -- : BFD_RELOC_METAG_HI16_GOTPC
5410 -- : BFD_RELOC_METAG_LO16_GOTPC
5411 -- : BFD_RELOC_METAG_HI16_PLT
5412 -- : BFD_RELOC_METAG_LO16_PLT
5413 -- : BFD_RELOC_METAG_RELBRANCH_PLT
5414 -- : BFD_RELOC_METAG_GOTOFF
5415 -- : BFD_RELOC_METAG_PLT
5416 -- : BFD_RELOC_METAG_COPY
5417 -- : BFD_RELOC_METAG_JMP_SLOT
5418 -- : BFD_RELOC_METAG_RELATIVE
5419 -- : BFD_RELOC_METAG_GLOB_DAT
5420 -- : BFD_RELOC_METAG_TLS_GD
5421 -- : BFD_RELOC_METAG_TLS_LDM
5422 -- : BFD_RELOC_METAG_TLS_LDO_HI16
5423 -- : BFD_RELOC_METAG_TLS_LDO_LO16
5424 -- : BFD_RELOC_METAG_TLS_LDO
5425 -- : BFD_RELOC_METAG_TLS_IE
5426 -- : BFD_RELOC_METAG_TLS_IENONPIC
5427 -- : BFD_RELOC_METAG_TLS_IENONPIC_HI16
5428 -- : BFD_RELOC_METAG_TLS_IENONPIC_LO16
5429 -- : BFD_RELOC_METAG_TLS_TPOFF
5430 -- : BFD_RELOC_METAG_TLS_DTPMOD
5431 -- : BFD_RELOC_METAG_TLS_DTPOFF
5432 -- : BFD_RELOC_METAG_TLS_LE
5433 -- : BFD_RELOC_METAG_TLS_LE_HI16
5434 -- : BFD_RELOC_METAG_TLS_LE_LO16
5435     Imagination Technologies Meta relocations.
5436 -- : BFD_RELOC_MMIX_GETA
5437 -- : BFD_RELOC_MMIX_GETA_1
5438 -- : BFD_RELOC_MMIX_GETA_2
5439 -- : BFD_RELOC_MMIX_GETA_3
5440     These are relocations for the GETA instruction.
5441 -- : BFD_RELOC_MMIX_CBRANCH
5442 -- : BFD_RELOC_MMIX_CBRANCH_J
5443 -- : BFD_RELOC_MMIX_CBRANCH_1
5444 -- : BFD_RELOC_MMIX_CBRANCH_2
5445 -- : BFD_RELOC_MMIX_CBRANCH_3
5446     These are relocations for a conditional branch instruction.
5447 -- : BFD_RELOC_MMIX_PUSHJ
5448 -- : BFD_RELOC_MMIX_PUSHJ_1
5449 -- : BFD_RELOC_MMIX_PUSHJ_2
5450 -- : BFD_RELOC_MMIX_PUSHJ_3
5451 -- : BFD_RELOC_MMIX_PUSHJ_STUBBABLE
5452     These are relocations for the PUSHJ instruction.
5453 -- : BFD_RELOC_MMIX_JMP
5454 -- : BFD_RELOC_MMIX_JMP_1
5455 -- : BFD_RELOC_MMIX_JMP_2
5456 -- : BFD_RELOC_MMIX_JMP_3
5457     These are relocations for the JMP instruction.
5458 -- : BFD_RELOC_MMIX_ADDR19
5459     This is a relocation for a relative address as in a GETA
5460     instruction or a branch.
5461 -- : BFD_RELOC_MMIX_ADDR27
5462     This is a relocation for a relative address as in a JMP
5463     instruction.
5464 -- : BFD_RELOC_MMIX_REG_OR_BYTE
5465     This is a relocation for an instruction field that may be a general
5466     register or a value 0..255.
5467 -- : BFD_RELOC_MMIX_REG
5468     This is a relocation for an instruction field that may be a general
5469     register.
5470 -- : BFD_RELOC_MMIX_BASE_PLUS_OFFSET
5471     This is a relocation for two instruction fields holding a register
5472     and an offset, the equivalent of the relocation.
5473 -- : BFD_RELOC_MMIX_LOCAL
5474     This relocation is an assertion that the expression is not
5475     allocated as a global register.  It does not modify contents.
5476 -- : BFD_RELOC_AVR_7_PCREL
5477     This is a 16 bit reloc for the AVR that stores 8 bit pc relative
5478     short offset into 7 bits.
5479 -- : BFD_RELOC_AVR_13_PCREL
5480     This is a 16 bit reloc for the AVR that stores 13 bit pc relative
5481     short offset into 12 bits.
5482 -- : BFD_RELOC_AVR_16_PM
5483     This is a 16 bit reloc for the AVR that stores 17 bit value
5484     (usually program memory address) into 16 bits.
5485 -- : BFD_RELOC_AVR_LO8_LDI
5486     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5487     data memory address) into 8 bit immediate value of LDI insn.
5488 -- : BFD_RELOC_AVR_HI8_LDI
5489     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5490     bit of data memory address) into 8 bit immediate value of LDI insn.
5491 -- : BFD_RELOC_AVR_HH8_LDI
5492     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5493     high 8 bit of program memory address) into 8 bit immediate value of
5494     LDI insn.
5495 -- : BFD_RELOC_AVR_MS8_LDI
5496     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5497     high 8 bit of 32 bit value) into 8 bit immediate value of LDI insn.
5498 -- : BFD_RELOC_AVR_LO8_LDI_NEG
5499     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5500     (usually data memory address) into 8 bit immediate value of SUBI
5501     insn.
5502 -- : BFD_RELOC_AVR_HI8_LDI_NEG
5503     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5504     (high 8 bit of data memory address) into 8 bit immediate value of
5505     SUBI insn.
5506 -- : BFD_RELOC_AVR_HH8_LDI_NEG
5507     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5508     (most high 8 bit of program memory address) into 8 bit immediate
5509     value of LDI or SUBI insn.
5510 -- : BFD_RELOC_AVR_MS8_LDI_NEG
5511     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5512     (msb of 32 bit value) into 8 bit immediate value of LDI insn.
5513 -- : BFD_RELOC_AVR_LO8_LDI_PM
5514     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5515     command address) into 8 bit immediate value of LDI insn.
5516 -- : BFD_RELOC_AVR_LO8_LDI_GS
5517     This is a 16 bit reloc for the AVR that stores 8 bit value (command
5518     address) into 8 bit immediate value of LDI insn.  If the address is
5519     beyond the 128k boundary, the linker inserts a jump stub for this
5520     reloc in the lower 128k.
5521 -- : BFD_RELOC_AVR_HI8_LDI_PM
5522     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5523     bit of command address) into 8 bit immediate value of LDI insn.
5524 -- : BFD_RELOC_AVR_HI8_LDI_GS
5525     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5526     bit of command address) into 8 bit immediate value of LDI insn.  If
5527     the address is beyond the 128k boundary, the linker inserts a jump
5528     stub for this reloc below 128k.
5529 -- : BFD_RELOC_AVR_HH8_LDI_PM
5530     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5531     high 8 bit of command address) into 8 bit immediate value of LDI
5532     insn.
5533 -- : BFD_RELOC_AVR_LO8_LDI_PM_NEG
5534     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5535     (usually command address) into 8 bit immediate value of SUBI insn.
5536 -- : BFD_RELOC_AVR_HI8_LDI_PM_NEG
5537     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5538     (high 8 bit of 16 bit command address) into 8 bit immediate value
5539     of SUBI insn.
5540 -- : BFD_RELOC_AVR_HH8_LDI_PM_NEG
5541     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5542     (high 6 bit of 22 bit command address) into 8 bit immediate value
5543     of SUBI insn.
5544 -- : BFD_RELOC_AVR_CALL
5545     This is a 32 bit reloc for the AVR that stores 23 bit value into 22
5546     bits.
5547 -- : BFD_RELOC_AVR_LDI
5548     This is a 16 bit reloc for the AVR that stores all needed bits for
5549     absolute addressing with ldi with overflow check to linktime
5550 -- : BFD_RELOC_AVR_6
5551     This is a 6 bit reloc for the AVR that stores offset for ldd/std
5552     instructions
5553 -- : BFD_RELOC_AVR_6_ADIW
5554     This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
5555     instructions
5556 -- : BFD_RELOC_AVR_8_LO
5557     This is a 8 bit reloc for the AVR that stores bits 0..7 of a symbol
5558     in .byte lo8(symbol)
5559 -- : BFD_RELOC_AVR_8_HI
5560     This is a 8 bit reloc for the AVR that stores bits 8..15 of a
5561     symbol in .byte hi8(symbol)
5562 -- : BFD_RELOC_AVR_8_HLO
5563     This is a 8 bit reloc for the AVR that stores bits 16..23 of a
5564     symbol in .byte hlo8(symbol)
5565 -- : BFD_RELOC_AVR_DIFF8
5566 -- : BFD_RELOC_AVR_DIFF16
5567 -- : BFD_RELOC_AVR_DIFF32
5568     AVR relocations to mark the difference of two local symbols.  These
5569     are only needed to support linker relaxation and can be ignored
5570     when not relaxing.  The field is set to the value of the difference
5571     assuming no relaxation.  The relocation encodes the position of the
5572     second symbol so the linker can determine whether to adjust the
5573     field value.
5574 -- : BFD_RELOC_AVR_LDS_STS_16
5575     This is a 7 bit reloc for the AVR that stores SRAM address for
5576     16bit lds and sts instructions supported only tiny core.
5577 -- : BFD_RELOC_AVR_PORT6
5578     This is a 6 bit reloc for the AVR that stores an I/O register
5579     number for the IN and OUT instructions
5580 -- : BFD_RELOC_AVR_PORT5
5581     This is a 5 bit reloc for the AVR that stores an I/O register
5582     number for the SBIC, SBIS, SBI and CBI instructions
5583 -- : BFD_RELOC_RISCV_HI20
5584 -- : BFD_RELOC_RISCV_PCREL_HI20
5585 -- : BFD_RELOC_RISCV_PCREL_LO12_I
5586 -- : BFD_RELOC_RISCV_PCREL_LO12_S
5587 -- : BFD_RELOC_RISCV_LO12_I
5588 -- : BFD_RELOC_RISCV_LO12_S
5589 -- : BFD_RELOC_RISCV_GPREL12_I
5590 -- : BFD_RELOC_RISCV_GPREL12_S
5591 -- : BFD_RELOC_RISCV_TPREL_HI20
5592 -- : BFD_RELOC_RISCV_TPREL_LO12_I
5593 -- : BFD_RELOC_RISCV_TPREL_LO12_S
5594 -- : BFD_RELOC_RISCV_TPREL_ADD
5595 -- : BFD_RELOC_RISCV_CALL
5596 -- : BFD_RELOC_RISCV_CALL_PLT
5597 -- : BFD_RELOC_RISCV_ADD8
5598 -- : BFD_RELOC_RISCV_ADD16
5599 -- : BFD_RELOC_RISCV_ADD32
5600 -- : BFD_RELOC_RISCV_ADD64
5601 -- : BFD_RELOC_RISCV_SUB8
5602 -- : BFD_RELOC_RISCV_SUB16
5603 -- : BFD_RELOC_RISCV_SUB32
5604 -- : BFD_RELOC_RISCV_SUB64
5605 -- : BFD_RELOC_RISCV_GOT_HI20
5606 -- : BFD_RELOC_RISCV_TLS_GOT_HI20
5607 -- : BFD_RELOC_RISCV_TLS_GD_HI20
5608 -- : BFD_RELOC_RISCV_JMP
5609 -- : BFD_RELOC_RISCV_TLS_DTPMOD32
5610 -- : BFD_RELOC_RISCV_TLS_DTPREL32
5611 -- : BFD_RELOC_RISCV_TLS_DTPMOD64
5612 -- : BFD_RELOC_RISCV_TLS_DTPREL64
5613 -- : BFD_RELOC_RISCV_TLS_TPREL32
5614 -- : BFD_RELOC_RISCV_TLS_TPREL64
5615 -- : BFD_RELOC_RISCV_ALIGN
5616 -- : BFD_RELOC_RISCV_RVC_BRANCH
5617 -- : BFD_RELOC_RISCV_RVC_JUMP
5618 -- : BFD_RELOC_RISCV_RVC_LUI
5619 -- : BFD_RELOC_RISCV_GPREL_I
5620 -- : BFD_RELOC_RISCV_GPREL_S
5621 -- : BFD_RELOC_RISCV_TPREL_I
5622 -- : BFD_RELOC_RISCV_TPREL_S
5623 -- : BFD_RELOC_RISCV_RELAX
5624 -- : BFD_RELOC_RISCV_CFA
5625 -- : BFD_RELOC_RISCV_SUB6
5626 -- : BFD_RELOC_RISCV_SET6
5627 -- : BFD_RELOC_RISCV_SET8
5628 -- : BFD_RELOC_RISCV_SET16
5629 -- : BFD_RELOC_RISCV_SET32
5630 -- : BFD_RELOC_RISCV_32_PCREL
5631     RISC-V relocations.
5632 -- : BFD_RELOC_RL78_NEG8
5633 -- : BFD_RELOC_RL78_NEG16
5634 -- : BFD_RELOC_RL78_NEG24
5635 -- : BFD_RELOC_RL78_NEG32
5636 -- : BFD_RELOC_RL78_16_OP
5637 -- : BFD_RELOC_RL78_24_OP
5638 -- : BFD_RELOC_RL78_32_OP
5639 -- : BFD_RELOC_RL78_8U
5640 -- : BFD_RELOC_RL78_16U
5641 -- : BFD_RELOC_RL78_24U
5642 -- : BFD_RELOC_RL78_DIR3U_PCREL
5643 -- : BFD_RELOC_RL78_DIFF
5644 -- : BFD_RELOC_RL78_GPRELB
5645 -- : BFD_RELOC_RL78_GPRELW
5646 -- : BFD_RELOC_RL78_GPRELL
5647 -- : BFD_RELOC_RL78_SYM
5648 -- : BFD_RELOC_RL78_OP_SUBTRACT
5649 -- : BFD_RELOC_RL78_OP_NEG
5650 -- : BFD_RELOC_RL78_OP_AND
5651 -- : BFD_RELOC_RL78_OP_SHRA
5652 -- : BFD_RELOC_RL78_ABS8
5653 -- : BFD_RELOC_RL78_ABS16
5654 -- : BFD_RELOC_RL78_ABS16_REV
5655 -- : BFD_RELOC_RL78_ABS32
5656 -- : BFD_RELOC_RL78_ABS32_REV
5657 -- : BFD_RELOC_RL78_ABS16U
5658 -- : BFD_RELOC_RL78_ABS16UW
5659 -- : BFD_RELOC_RL78_ABS16UL
5660 -- : BFD_RELOC_RL78_RELAX
5661 -- : BFD_RELOC_RL78_HI16
5662 -- : BFD_RELOC_RL78_HI8
5663 -- : BFD_RELOC_RL78_LO16
5664 -- : BFD_RELOC_RL78_CODE
5665 -- : BFD_RELOC_RL78_SADDR
5666     Renesas RL78 Relocations.
5667 -- : BFD_RELOC_RX_NEG8
5668 -- : BFD_RELOC_RX_NEG16
5669 -- : BFD_RELOC_RX_NEG24
5670 -- : BFD_RELOC_RX_NEG32
5671 -- : BFD_RELOC_RX_16_OP
5672 -- : BFD_RELOC_RX_24_OP
5673 -- : BFD_RELOC_RX_32_OP
5674 -- : BFD_RELOC_RX_8U
5675 -- : BFD_RELOC_RX_16U
5676 -- : BFD_RELOC_RX_24U
5677 -- : BFD_RELOC_RX_DIR3U_PCREL
5678 -- : BFD_RELOC_RX_DIFF
5679 -- : BFD_RELOC_RX_GPRELB
5680 -- : BFD_RELOC_RX_GPRELW
5681 -- : BFD_RELOC_RX_GPRELL
5682 -- : BFD_RELOC_RX_SYM
5683 -- : BFD_RELOC_RX_OP_SUBTRACT
5684 -- : BFD_RELOC_RX_OP_NEG
5685 -- : BFD_RELOC_RX_ABS8
5686 -- : BFD_RELOC_RX_ABS16
5687 -- : BFD_RELOC_RX_ABS16_REV
5688 -- : BFD_RELOC_RX_ABS32
5689 -- : BFD_RELOC_RX_ABS32_REV
5690 -- : BFD_RELOC_RX_ABS16U
5691 -- : BFD_RELOC_RX_ABS16UW
5692 -- : BFD_RELOC_RX_ABS16UL
5693 -- : BFD_RELOC_RX_RELAX
5694     Renesas RX Relocations.
5695 -- : BFD_RELOC_390_12
5696     Direct 12 bit.
5697 -- : BFD_RELOC_390_GOT12
5698     12 bit GOT offset.
5699 -- : BFD_RELOC_390_PLT32
5700     32 bit PC relative PLT address.
5701 -- : BFD_RELOC_390_COPY
5702     Copy symbol at runtime.
5703 -- : BFD_RELOC_390_GLOB_DAT
5704     Create GOT entry.
5705 -- : BFD_RELOC_390_JMP_SLOT
5706     Create PLT entry.
5707 -- : BFD_RELOC_390_RELATIVE
5708     Adjust by program base.
5709 -- : BFD_RELOC_390_GOTPC
5710     32 bit PC relative offset to GOT.
5711 -- : BFD_RELOC_390_GOT16
5712     16 bit GOT offset.
5713 -- : BFD_RELOC_390_PC12DBL
5714     PC relative 12 bit shifted by 1.
5715 -- : BFD_RELOC_390_PLT12DBL
5716     12 bit PC rel.  PLT shifted by 1.
5717 -- : BFD_RELOC_390_PC16DBL
5718     PC relative 16 bit shifted by 1.
5719 -- : BFD_RELOC_390_PLT16DBL
5720     16 bit PC rel.  PLT shifted by 1.
5721 -- : BFD_RELOC_390_PC24DBL
5722     PC relative 24 bit shifted by 1.
5723 -- : BFD_RELOC_390_PLT24DBL
5724     24 bit PC rel.  PLT shifted by 1.
5725 -- : BFD_RELOC_390_PC32DBL
5726     PC relative 32 bit shifted by 1.
5727 -- : BFD_RELOC_390_PLT32DBL
5728     32 bit PC rel.  PLT shifted by 1.
5729 -- : BFD_RELOC_390_GOTPCDBL
5730     32 bit PC rel.  GOT shifted by 1.
5731 -- : BFD_RELOC_390_GOT64
5732     64 bit GOT offset.
5733 -- : BFD_RELOC_390_PLT64
5734     64 bit PC relative PLT address.
5735 -- : BFD_RELOC_390_GOTENT
5736     32 bit rel.  offset to GOT entry.
5737 -- : BFD_RELOC_390_GOTOFF64
5738     64 bit offset to GOT.
5739 -- : BFD_RELOC_390_GOTPLT12
5740     12-bit offset to symbol-entry within GOT, with PLT handling.
5741 -- : BFD_RELOC_390_GOTPLT16
5742     16-bit offset to symbol-entry within GOT, with PLT handling.
5743 -- : BFD_RELOC_390_GOTPLT32
5744     32-bit offset to symbol-entry within GOT, with PLT handling.
5745 -- : BFD_RELOC_390_GOTPLT64
5746     64-bit offset to symbol-entry within GOT, with PLT handling.
5747 -- : BFD_RELOC_390_GOTPLTENT
5748     32-bit rel.  offset to symbol-entry within GOT, with PLT handling.
5749 -- : BFD_RELOC_390_PLTOFF16
5750     16-bit rel.  offset from the GOT to a PLT entry.
5751 -- : BFD_RELOC_390_PLTOFF32
5752     32-bit rel.  offset from the GOT to a PLT entry.
5753 -- : BFD_RELOC_390_PLTOFF64
5754     64-bit rel.  offset from the GOT to a PLT entry.
5755 -- : BFD_RELOC_390_TLS_LOAD
5756 -- : BFD_RELOC_390_TLS_GDCALL
5757 -- : BFD_RELOC_390_TLS_LDCALL
5758 -- : BFD_RELOC_390_TLS_GD32
5759 -- : BFD_RELOC_390_TLS_GD64
5760 -- : BFD_RELOC_390_TLS_GOTIE12
5761 -- : BFD_RELOC_390_TLS_GOTIE32
5762 -- : BFD_RELOC_390_TLS_GOTIE64
5763 -- : BFD_RELOC_390_TLS_LDM32
5764 -- : BFD_RELOC_390_TLS_LDM64
5765 -- : BFD_RELOC_390_TLS_IE32
5766 -- : BFD_RELOC_390_TLS_IE64
5767 -- : BFD_RELOC_390_TLS_IEENT
5768 -- : BFD_RELOC_390_TLS_LE32
5769 -- : BFD_RELOC_390_TLS_LE64
5770 -- : BFD_RELOC_390_TLS_LDO32
5771 -- : BFD_RELOC_390_TLS_LDO64
5772 -- : BFD_RELOC_390_TLS_DTPMOD
5773 -- : BFD_RELOC_390_TLS_DTPOFF
5774 -- : BFD_RELOC_390_TLS_TPOFF
5775     s390 tls relocations.
5776 -- : BFD_RELOC_390_20
5777 -- : BFD_RELOC_390_GOT20
5778 -- : BFD_RELOC_390_GOTPLT20
5779 -- : BFD_RELOC_390_TLS_GOTIE20
5780     Long displacement extension.
5781 -- : BFD_RELOC_390_IRELATIVE
5782     STT_GNU_IFUNC relocation.
5783 -- : BFD_RELOC_SCORE_GPREL15
5784     Score relocations Low 16 bit for load/store
5785 -- : BFD_RELOC_SCORE_DUMMY2
5786 -- : BFD_RELOC_SCORE_JMP
5787     This is a 24-bit reloc with the right 1 bit assumed to be 0
5788 -- : BFD_RELOC_SCORE_BRANCH
5789     This is a 19-bit reloc with the right 1 bit assumed to be 0
5790 -- : BFD_RELOC_SCORE_IMM30
5791     This is a 32-bit reloc for 48-bit instructions.
5792 -- : BFD_RELOC_SCORE_IMM32
5793     This is a 32-bit reloc for 48-bit instructions.
5794 -- : BFD_RELOC_SCORE16_JMP
5795     This is a 11-bit reloc with the right 1 bit assumed to be 0
5796 -- : BFD_RELOC_SCORE16_BRANCH
5797     This is a 8-bit reloc with the right 1 bit assumed to be 0
5798 -- : BFD_RELOC_SCORE_BCMP
5799     This is a 9-bit reloc with the right 1 bit assumed to be 0
5800 -- : BFD_RELOC_SCORE_GOT15
5801 -- : BFD_RELOC_SCORE_GOT_LO16
5802 -- : BFD_RELOC_SCORE_CALL15
5803 -- : BFD_RELOC_SCORE_DUMMY_HI16
5804     Undocumented Score relocs
5805 -- : BFD_RELOC_IP2K_FR9
5806     Scenix IP2K - 9-bit register number / data address
5807 -- : BFD_RELOC_IP2K_BANK
5808     Scenix IP2K - 4-bit register/data bank number
5809 -- : BFD_RELOC_IP2K_ADDR16CJP
5810     Scenix IP2K - low 13 bits of instruction word address
5811 -- : BFD_RELOC_IP2K_PAGE3
5812     Scenix IP2K - high 3 bits of instruction word address
5813 -- : BFD_RELOC_IP2K_LO8DATA
5814 -- : BFD_RELOC_IP2K_HI8DATA
5815 -- : BFD_RELOC_IP2K_EX8DATA
5816     Scenix IP2K - ext/low/high 8 bits of data address
5817 -- : BFD_RELOC_IP2K_LO8INSN
5818 -- : BFD_RELOC_IP2K_HI8INSN
5819     Scenix IP2K - low/high 8 bits of instruction word address
5820 -- : BFD_RELOC_IP2K_PC_SKIP
5821     Scenix IP2K - even/odd PC modifier to modify snb pcl.0
5822 -- : BFD_RELOC_IP2K_TEXT
5823     Scenix IP2K - 16 bit word address in text section.
5824 -- : BFD_RELOC_IP2K_FR_OFFSET
5825     Scenix IP2K - 7-bit sp or dp offset
5826 -- : BFD_RELOC_VPE4KMATH_DATA
5827 -- : BFD_RELOC_VPE4KMATH_INSN
5828     Scenix VPE4K coprocessor - data/insn-space addressing
5829 -- : BFD_RELOC_VTABLE_INHERIT
5830 -- : BFD_RELOC_VTABLE_ENTRY
5831     These two relocations are used by the linker to determine which of
5832     the entries in a C++ virtual function table are actually used.
5833     When the -gc-sections option is given, the linker will zero out the
5834     entries that are not used, so that the code for those functions
5835     need not be included in the output.
5836
5837     VTABLE_INHERIT is a zero-space relocation used to describe to the
5838     linker the inheritance tree of a C++ virtual function table.  The
5839     relocation's symbol should be the parent class' vtable, and the
5840     relocation should be located at the child vtable.
5841
5842     VTABLE_ENTRY is a zero-space relocation that describes the use of a
5843     virtual function table entry.  The reloc's symbol should refer to
5844     the table of the class mentioned in the code.  Off of that base, an
5845     offset describes the entry that is being used.  For Rela hosts,
5846     this offset is stored in the reloc's addend.  For Rel hosts, we are
5847     forced to put this offset in the reloc's section offset.
5848 -- : BFD_RELOC_IA64_IMM14
5849 -- : BFD_RELOC_IA64_IMM22
5850 -- : BFD_RELOC_IA64_IMM64
5851 -- : BFD_RELOC_IA64_DIR32MSB
5852 -- : BFD_RELOC_IA64_DIR32LSB
5853 -- : BFD_RELOC_IA64_DIR64MSB
5854 -- : BFD_RELOC_IA64_DIR64LSB
5855 -- : BFD_RELOC_IA64_GPREL22
5856 -- : BFD_RELOC_IA64_GPREL64I
5857 -- : BFD_RELOC_IA64_GPREL32MSB
5858 -- : BFD_RELOC_IA64_GPREL32LSB
5859 -- : BFD_RELOC_IA64_GPREL64MSB
5860 -- : BFD_RELOC_IA64_GPREL64LSB
5861 -- : BFD_RELOC_IA64_LTOFF22
5862 -- : BFD_RELOC_IA64_LTOFF64I
5863 -- : BFD_RELOC_IA64_PLTOFF22
5864 -- : BFD_RELOC_IA64_PLTOFF64I
5865 -- : BFD_RELOC_IA64_PLTOFF64MSB
5866 -- : BFD_RELOC_IA64_PLTOFF64LSB
5867 -- : BFD_RELOC_IA64_FPTR64I
5868 -- : BFD_RELOC_IA64_FPTR32MSB
5869 -- : BFD_RELOC_IA64_FPTR32LSB
5870 -- : BFD_RELOC_IA64_FPTR64MSB
5871 -- : BFD_RELOC_IA64_FPTR64LSB
5872 -- : BFD_RELOC_IA64_PCREL21B
5873 -- : BFD_RELOC_IA64_PCREL21BI
5874 -- : BFD_RELOC_IA64_PCREL21M
5875 -- : BFD_RELOC_IA64_PCREL21F
5876 -- : BFD_RELOC_IA64_PCREL22
5877 -- : BFD_RELOC_IA64_PCREL60B
5878 -- : BFD_RELOC_IA64_PCREL64I
5879 -- : BFD_RELOC_IA64_PCREL32MSB
5880 -- : BFD_RELOC_IA64_PCREL32LSB
5881 -- : BFD_RELOC_IA64_PCREL64MSB
5882 -- : BFD_RELOC_IA64_PCREL64LSB
5883 -- : BFD_RELOC_IA64_LTOFF_FPTR22
5884 -- : BFD_RELOC_IA64_LTOFF_FPTR64I
5885 -- : BFD_RELOC_IA64_LTOFF_FPTR32MSB
5886 -- : BFD_RELOC_IA64_LTOFF_FPTR32LSB
5887 -- : BFD_RELOC_IA64_LTOFF_FPTR64MSB
5888 -- : BFD_RELOC_IA64_LTOFF_FPTR64LSB
5889 -- : BFD_RELOC_IA64_SEGREL32MSB
5890 -- : BFD_RELOC_IA64_SEGREL32LSB
5891 -- : BFD_RELOC_IA64_SEGREL64MSB
5892 -- : BFD_RELOC_IA64_SEGREL64LSB
5893 -- : BFD_RELOC_IA64_SECREL32MSB
5894 -- : BFD_RELOC_IA64_SECREL32LSB
5895 -- : BFD_RELOC_IA64_SECREL64MSB
5896 -- : BFD_RELOC_IA64_SECREL64LSB
5897 -- : BFD_RELOC_IA64_REL32MSB
5898 -- : BFD_RELOC_IA64_REL32LSB
5899 -- : BFD_RELOC_IA64_REL64MSB
5900 -- : BFD_RELOC_IA64_REL64LSB
5901 -- : BFD_RELOC_IA64_LTV32MSB
5902 -- : BFD_RELOC_IA64_LTV32LSB
5903 -- : BFD_RELOC_IA64_LTV64MSB
5904 -- : BFD_RELOC_IA64_LTV64LSB
5905 -- : BFD_RELOC_IA64_IPLTMSB
5906 -- : BFD_RELOC_IA64_IPLTLSB
5907 -- : BFD_RELOC_IA64_COPY
5908 -- : BFD_RELOC_IA64_LTOFF22X
5909 -- : BFD_RELOC_IA64_LDXMOV
5910 -- : BFD_RELOC_IA64_TPREL14
5911 -- : BFD_RELOC_IA64_TPREL22
5912 -- : BFD_RELOC_IA64_TPREL64I
5913 -- : BFD_RELOC_IA64_TPREL64MSB
5914 -- : BFD_RELOC_IA64_TPREL64LSB
5915 -- : BFD_RELOC_IA64_LTOFF_TPREL22
5916 -- : BFD_RELOC_IA64_DTPMOD64MSB
5917 -- : BFD_RELOC_IA64_DTPMOD64LSB
5918 -- : BFD_RELOC_IA64_LTOFF_DTPMOD22
5919 -- : BFD_RELOC_IA64_DTPREL14
5920 -- : BFD_RELOC_IA64_DTPREL22
5921 -- : BFD_RELOC_IA64_DTPREL64I
5922 -- : BFD_RELOC_IA64_DTPREL32MSB
5923 -- : BFD_RELOC_IA64_DTPREL32LSB
5924 -- : BFD_RELOC_IA64_DTPREL64MSB
5925 -- : BFD_RELOC_IA64_DTPREL64LSB
5926 -- : BFD_RELOC_IA64_LTOFF_DTPREL22
5927     Intel IA64 Relocations.
5928 -- : BFD_RELOC_M68HC11_HI8
5929     Motorola 68HC11 reloc.  This is the 8 bit high part of an absolute
5930     address.
5931 -- : BFD_RELOC_M68HC11_LO8
5932     Motorola 68HC11 reloc.  This is the 8 bit low part of an absolute
5933     address.
5934 -- : BFD_RELOC_M68HC11_3B
5935     Motorola 68HC11 reloc.  This is the 3 bit of a value.
5936 -- : BFD_RELOC_M68HC11_RL_JUMP
5937     Motorola 68HC11 reloc.  This reloc marks the beginning of a
5938     jump/call instruction.  It is used for linker relaxation to
5939     correctly identify beginning of instruction and change some
5940     branches to use PC-relative addressing mode.
5941 -- : BFD_RELOC_M68HC11_RL_GROUP
5942     Motorola 68HC11 reloc.  This reloc marks a group of several
5943     instructions that gcc generates and for which the linker relaxation
5944     pass can modify and/or remove some of them.
5945 -- : BFD_RELOC_M68HC11_LO16
5946     Motorola 68HC11 reloc.  This is the 16-bit lower part of an
5947     address.  It is used for 'call' instruction to specify the symbol
5948     address without any special transformation (due to memory bank
5949     window).
5950 -- : BFD_RELOC_M68HC11_PAGE
5951     Motorola 68HC11 reloc.  This is a 8-bit reloc that specifies the
5952     page number of an address.  It is used by 'call' instruction to
5953     specify the page number of the symbol.
5954 -- : BFD_RELOC_M68HC11_24
5955     Motorola 68HC11 reloc.  This is a 24-bit reloc that represents the
5956     address with a 16-bit value and a 8-bit page number.  The symbol
5957     address is transformed to follow the 16K memory bank of 68HC12
5958     (seen as mapped in the window).
5959 -- : BFD_RELOC_M68HC12_5B
5960     Motorola 68HC12 reloc.  This is the 5 bits of a value.
5961 -- : BFD_RELOC_XGATE_RL_JUMP
5962     Freescale XGATE reloc.  This reloc marks the beginning of a bra/jal
5963     instruction.
5964 -- : BFD_RELOC_XGATE_RL_GROUP
5965     Freescale XGATE reloc.  This reloc marks a group of several
5966     instructions that gcc generates and for which the linker relaxation
5967     pass can modify and/or remove some of them.
5968 -- : BFD_RELOC_XGATE_LO16
5969     Freescale XGATE reloc.  This is the 16-bit lower part of an
5970     address.  It is used for the '16-bit' instructions.
5971 -- : BFD_RELOC_XGATE_GPAGE
5972     Freescale XGATE reloc.
5973 -- : BFD_RELOC_XGATE_24
5974     Freescale XGATE reloc.
5975 -- : BFD_RELOC_XGATE_PCREL_9
5976     Freescale XGATE reloc.  This is a 9-bit pc-relative reloc.
5977 -- : BFD_RELOC_XGATE_PCREL_10
5978     Freescale XGATE reloc.  This is a 10-bit pc-relative reloc.
5979 -- : BFD_RELOC_XGATE_IMM8_LO
5980     Freescale XGATE reloc.  This is the 16-bit lower part of an
5981     address.  It is used for the '16-bit' instructions.
5982 -- : BFD_RELOC_XGATE_IMM8_HI
5983     Freescale XGATE reloc.  This is the 16-bit higher part of an
5984     address.  It is used for the '16-bit' instructions.
5985 -- : BFD_RELOC_XGATE_IMM3
5986     Freescale XGATE reloc.  This is a 3-bit pc-relative reloc.
5987 -- : BFD_RELOC_XGATE_IMM4
5988     Freescale XGATE reloc.  This is a 4-bit pc-relative reloc.
5989 -- : BFD_RELOC_XGATE_IMM5
5990     Freescale XGATE reloc.  This is a 5-bit pc-relative reloc.
5991 -- : BFD_RELOC_M68HC12_9B
5992     Motorola 68HC12 reloc.  This is the 9 bits of a value.
5993 -- : BFD_RELOC_M68HC12_16B
5994     Motorola 68HC12 reloc.  This is the 16 bits of a value.
5995 -- : BFD_RELOC_M68HC12_9_PCREL
5996     Motorola 68HC12/XGATE reloc.  This is a PCREL9 branch.
5997 -- : BFD_RELOC_M68HC12_10_PCREL
5998     Motorola 68HC12/XGATE reloc.  This is a PCREL10 branch.
5999 -- : BFD_RELOC_M68HC12_LO8XG
6000     Motorola 68HC12/XGATE reloc.  This is the 8 bit low part of an
6001     absolute address and immediately precedes a matching HI8XG part.
6002 -- : BFD_RELOC_M68HC12_HI8XG
6003     Motorola 68HC12/XGATE reloc.  This is the 8 bit high part of an
6004     absolute address and immediately follows a matching LO8XG part.
6005 -- : BFD_RELOC_S12Z_15_PCREL
6006     Freescale S12Z reloc.  This is a 15 bit relative address.  If the
6007     most significant bits are all zero then it may be truncated to 8
6008     bits.
6009 -- : BFD_RELOC_CR16_NUM8
6010 -- : BFD_RELOC_CR16_NUM16
6011 -- : BFD_RELOC_CR16_NUM32
6012 -- : BFD_RELOC_CR16_NUM32a
6013 -- : BFD_RELOC_CR16_REGREL0
6014 -- : BFD_RELOC_CR16_REGREL4
6015 -- : BFD_RELOC_CR16_REGREL4a
6016 -- : BFD_RELOC_CR16_REGREL14
6017 -- : BFD_RELOC_CR16_REGREL14a
6018 -- : BFD_RELOC_CR16_REGREL16
6019 -- : BFD_RELOC_CR16_REGREL20
6020 -- : BFD_RELOC_CR16_REGREL20a
6021 -- : BFD_RELOC_CR16_ABS20
6022 -- : BFD_RELOC_CR16_ABS24
6023 -- : BFD_RELOC_CR16_IMM4
6024 -- : BFD_RELOC_CR16_IMM8
6025 -- : BFD_RELOC_CR16_IMM16
6026 -- : BFD_RELOC_CR16_IMM20
6027 -- : BFD_RELOC_CR16_IMM24
6028 -- : BFD_RELOC_CR16_IMM32
6029 -- : BFD_RELOC_CR16_IMM32a
6030 -- : BFD_RELOC_CR16_DISP4
6031 -- : BFD_RELOC_CR16_DISP8
6032 -- : BFD_RELOC_CR16_DISP16
6033 -- : BFD_RELOC_CR16_DISP20
6034 -- : BFD_RELOC_CR16_DISP24
6035 -- : BFD_RELOC_CR16_DISP24a
6036 -- : BFD_RELOC_CR16_SWITCH8
6037 -- : BFD_RELOC_CR16_SWITCH16
6038 -- : BFD_RELOC_CR16_SWITCH32
6039 -- : BFD_RELOC_CR16_GOT_REGREL20
6040 -- : BFD_RELOC_CR16_GOTC_REGREL20
6041 -- : BFD_RELOC_CR16_GLOB_DAT
6042     NS CR16 Relocations.
6043 -- : BFD_RELOC_CRX_REL4
6044 -- : BFD_RELOC_CRX_REL8
6045 -- : BFD_RELOC_CRX_REL8_CMP
6046 -- : BFD_RELOC_CRX_REL16
6047 -- : BFD_RELOC_CRX_REL24
6048 -- : BFD_RELOC_CRX_REL32
6049 -- : BFD_RELOC_CRX_REGREL12
6050 -- : BFD_RELOC_CRX_REGREL22
6051 -- : BFD_RELOC_CRX_REGREL28
6052 -- : BFD_RELOC_CRX_REGREL32
6053 -- : BFD_RELOC_CRX_ABS16
6054 -- : BFD_RELOC_CRX_ABS32
6055 -- : BFD_RELOC_CRX_NUM8
6056 -- : BFD_RELOC_CRX_NUM16
6057 -- : BFD_RELOC_CRX_NUM32
6058 -- : BFD_RELOC_CRX_IMM16
6059 -- : BFD_RELOC_CRX_IMM32
6060 -- : BFD_RELOC_CRX_SWITCH8
6061 -- : BFD_RELOC_CRX_SWITCH16
6062 -- : BFD_RELOC_CRX_SWITCH32
6063     NS CRX Relocations.
6064 -- : BFD_RELOC_CRIS_BDISP8
6065 -- : BFD_RELOC_CRIS_UNSIGNED_5
6066 -- : BFD_RELOC_CRIS_SIGNED_6
6067 -- : BFD_RELOC_CRIS_UNSIGNED_6
6068 -- : BFD_RELOC_CRIS_SIGNED_8
6069 -- : BFD_RELOC_CRIS_UNSIGNED_8
6070 -- : BFD_RELOC_CRIS_SIGNED_16
6071 -- : BFD_RELOC_CRIS_UNSIGNED_16
6072 -- : BFD_RELOC_CRIS_LAPCQ_OFFSET
6073 -- : BFD_RELOC_CRIS_UNSIGNED_4
6074     These relocs are only used within the CRIS assembler.  They are not
6075     (at present) written to any object files.
6076 -- : BFD_RELOC_CRIS_COPY
6077 -- : BFD_RELOC_CRIS_GLOB_DAT
6078 -- : BFD_RELOC_CRIS_JUMP_SLOT
6079 -- : BFD_RELOC_CRIS_RELATIVE
6080     Relocs used in ELF shared libraries for CRIS.
6081 -- : BFD_RELOC_CRIS_32_GOT
6082     32-bit offset to symbol-entry within GOT.
6083 -- : BFD_RELOC_CRIS_16_GOT
6084     16-bit offset to symbol-entry within GOT.
6085 -- : BFD_RELOC_CRIS_32_GOTPLT
6086     32-bit offset to symbol-entry within GOT, with PLT handling.
6087 -- : BFD_RELOC_CRIS_16_GOTPLT
6088     16-bit offset to symbol-entry within GOT, with PLT handling.
6089 -- : BFD_RELOC_CRIS_32_GOTREL
6090     32-bit offset to symbol, relative to GOT.
6091 -- : BFD_RELOC_CRIS_32_PLT_GOTREL
6092     32-bit offset to symbol with PLT entry, relative to GOT.
6093 -- : BFD_RELOC_CRIS_32_PLT_PCREL
6094     32-bit offset to symbol with PLT entry, relative to this
6095     relocation.
6096 -- : BFD_RELOC_CRIS_32_GOT_GD
6097 -- : BFD_RELOC_CRIS_16_GOT_GD
6098 -- : BFD_RELOC_CRIS_32_GD
6099 -- : BFD_RELOC_CRIS_DTP
6100 -- : BFD_RELOC_CRIS_32_DTPREL
6101 -- : BFD_RELOC_CRIS_16_DTPREL
6102 -- : BFD_RELOC_CRIS_32_GOT_TPREL
6103 -- : BFD_RELOC_CRIS_16_GOT_TPREL
6104 -- : BFD_RELOC_CRIS_32_TPREL
6105 -- : BFD_RELOC_CRIS_16_TPREL
6106 -- : BFD_RELOC_CRIS_DTPMOD
6107 -- : BFD_RELOC_CRIS_32_IE
6108     Relocs used in TLS code for CRIS.
6109 -- : BFD_RELOC_OR1K_REL_26
6110 -- : BFD_RELOC_OR1K_SLO16
6111 -- : BFD_RELOC_OR1K_PCREL_PG21
6112 -- : BFD_RELOC_OR1K_LO13
6113 -- : BFD_RELOC_OR1K_SLO13
6114 -- : BFD_RELOC_OR1K_GOTPC_HI16
6115 -- : BFD_RELOC_OR1K_GOTPC_LO16
6116 -- : BFD_RELOC_OR1K_GOT_AHI16
6117 -- : BFD_RELOC_OR1K_GOT16
6118 -- : BFD_RELOC_OR1K_GOT_PG21
6119 -- : BFD_RELOC_OR1K_GOT_LO13
6120 -- : BFD_RELOC_OR1K_PLT26
6121 -- : BFD_RELOC_OR1K_PLTA26
6122 -- : BFD_RELOC_OR1K_GOTOFF_SLO16
6123 -- : BFD_RELOC_OR1K_COPY
6124 -- : BFD_RELOC_OR1K_GLOB_DAT
6125 -- : BFD_RELOC_OR1K_JMP_SLOT
6126 -- : BFD_RELOC_OR1K_RELATIVE
6127 -- : BFD_RELOC_OR1K_TLS_GD_HI16
6128 -- : BFD_RELOC_OR1K_TLS_GD_LO16
6129 -- : BFD_RELOC_OR1K_TLS_GD_PG21
6130 -- : BFD_RELOC_OR1K_TLS_GD_LO13
6131 -- : BFD_RELOC_OR1K_TLS_LDM_HI16
6132 -- : BFD_RELOC_OR1K_TLS_LDM_LO16
6133 -- : BFD_RELOC_OR1K_TLS_LDM_PG21
6134 -- : BFD_RELOC_OR1K_TLS_LDM_LO13
6135 -- : BFD_RELOC_OR1K_TLS_LDO_HI16
6136 -- : BFD_RELOC_OR1K_TLS_LDO_LO16
6137 -- : BFD_RELOC_OR1K_TLS_IE_HI16
6138 -- : BFD_RELOC_OR1K_TLS_IE_AHI16
6139 -- : BFD_RELOC_OR1K_TLS_IE_LO16
6140 -- : BFD_RELOC_OR1K_TLS_IE_PG21
6141 -- : BFD_RELOC_OR1K_TLS_IE_LO13
6142 -- : BFD_RELOC_OR1K_TLS_LE_HI16
6143 -- : BFD_RELOC_OR1K_TLS_LE_AHI16
6144 -- : BFD_RELOC_OR1K_TLS_LE_LO16
6145 -- : BFD_RELOC_OR1K_TLS_LE_SLO16
6146 -- : BFD_RELOC_OR1K_TLS_TPOFF
6147 -- : BFD_RELOC_OR1K_TLS_DTPOFF
6148 -- : BFD_RELOC_OR1K_TLS_DTPMOD
6149     OpenRISC 1000 Relocations.
6150 -- : BFD_RELOC_H8_DIR16A8
6151 -- : BFD_RELOC_H8_DIR16R8
6152 -- : BFD_RELOC_H8_DIR24A8
6153 -- : BFD_RELOC_H8_DIR24R8
6154 -- : BFD_RELOC_H8_DIR32A16
6155 -- : BFD_RELOC_H8_DISP32A16
6156     H8 elf Relocations.
6157 -- : BFD_RELOC_XSTORMY16_REL_12
6158 -- : BFD_RELOC_XSTORMY16_12
6159 -- : BFD_RELOC_XSTORMY16_24
6160 -- : BFD_RELOC_XSTORMY16_FPTR16
6161     Sony Xstormy16 Relocations.
6162 -- : BFD_RELOC_RELC
6163     Self-describing complex relocations.
6164 -- : BFD_RELOC_VAX_GLOB_DAT
6165 -- : BFD_RELOC_VAX_JMP_SLOT
6166 -- : BFD_RELOC_VAX_RELATIVE
6167     Relocations used by VAX ELF.
6168 -- : BFD_RELOC_MT_PC16
6169     Morpho MT - 16 bit immediate relocation.
6170 -- : BFD_RELOC_MT_HI16
6171     Morpho MT - Hi 16 bits of an address.
6172 -- : BFD_RELOC_MT_LO16
6173     Morpho MT - Low 16 bits of an address.
6174 -- : BFD_RELOC_MT_GNU_VTINHERIT
6175     Morpho MT - Used to tell the linker which vtable entries are used.
6176 -- : BFD_RELOC_MT_GNU_VTENTRY
6177     Morpho MT - Used to tell the linker which vtable entries are used.
6178 -- : BFD_RELOC_MT_PCINSN8
6179     Morpho MT - 8 bit immediate relocation.
6180 -- : BFD_RELOC_MSP430_10_PCREL
6181 -- : BFD_RELOC_MSP430_16_PCREL
6182 -- : BFD_RELOC_MSP430_16
6183 -- : BFD_RELOC_MSP430_16_PCREL_BYTE
6184 -- : BFD_RELOC_MSP430_16_BYTE
6185 -- : BFD_RELOC_MSP430_2X_PCREL
6186 -- : BFD_RELOC_MSP430_RL_PCREL
6187 -- : BFD_RELOC_MSP430_ABS8
6188 -- : BFD_RELOC_MSP430X_PCR20_EXT_SRC
6189 -- : BFD_RELOC_MSP430X_PCR20_EXT_DST
6190 -- : BFD_RELOC_MSP430X_PCR20_EXT_ODST
6191 -- : BFD_RELOC_MSP430X_ABS20_EXT_SRC
6192 -- : BFD_RELOC_MSP430X_ABS20_EXT_DST
6193 -- : BFD_RELOC_MSP430X_ABS20_EXT_ODST
6194 -- : BFD_RELOC_MSP430X_ABS20_ADR_SRC
6195 -- : BFD_RELOC_MSP430X_ABS20_ADR_DST
6196 -- : BFD_RELOC_MSP430X_PCR16
6197 -- : BFD_RELOC_MSP430X_PCR20_CALL
6198 -- : BFD_RELOC_MSP430X_ABS16
6199 -- : BFD_RELOC_MSP430_ABS_HI16
6200 -- : BFD_RELOC_MSP430_PREL31
6201 -- : BFD_RELOC_MSP430_SYM_DIFF
6202 -- : BFD_RELOC_MSP430_SET_ULEB128
6203 -- : BFD_RELOC_MSP430_SUB_ULEB128
6204     msp430 specific relocation codes
6205 -- : BFD_RELOC_NIOS2_S16
6206 -- : BFD_RELOC_NIOS2_U16
6207 -- : BFD_RELOC_NIOS2_CALL26
6208 -- : BFD_RELOC_NIOS2_IMM5
6209 -- : BFD_RELOC_NIOS2_CACHE_OPX
6210 -- : BFD_RELOC_NIOS2_IMM6
6211 -- : BFD_RELOC_NIOS2_IMM8
6212 -- : BFD_RELOC_NIOS2_HI16
6213 -- : BFD_RELOC_NIOS2_LO16
6214 -- : BFD_RELOC_NIOS2_HIADJ16
6215 -- : BFD_RELOC_NIOS2_GPREL
6216 -- : BFD_RELOC_NIOS2_UJMP
6217 -- : BFD_RELOC_NIOS2_CJMP
6218 -- : BFD_RELOC_NIOS2_CALLR
6219 -- : BFD_RELOC_NIOS2_ALIGN
6220 -- : BFD_RELOC_NIOS2_GOT16
6221 -- : BFD_RELOC_NIOS2_CALL16
6222 -- : BFD_RELOC_NIOS2_GOTOFF_LO
6223 -- : BFD_RELOC_NIOS2_GOTOFF_HA
6224 -- : BFD_RELOC_NIOS2_PCREL_LO
6225 -- : BFD_RELOC_NIOS2_PCREL_HA
6226 -- : BFD_RELOC_NIOS2_TLS_GD16
6227 -- : BFD_RELOC_NIOS2_TLS_LDM16
6228 -- : BFD_RELOC_NIOS2_TLS_LDO16
6229 -- : BFD_RELOC_NIOS2_TLS_IE16
6230 -- : BFD_RELOC_NIOS2_TLS_LE16
6231 -- : BFD_RELOC_NIOS2_TLS_DTPMOD
6232 -- : BFD_RELOC_NIOS2_TLS_DTPREL
6233 -- : BFD_RELOC_NIOS2_TLS_TPREL
6234 -- : BFD_RELOC_NIOS2_COPY
6235 -- : BFD_RELOC_NIOS2_GLOB_DAT
6236 -- : BFD_RELOC_NIOS2_JUMP_SLOT
6237 -- : BFD_RELOC_NIOS2_RELATIVE
6238 -- : BFD_RELOC_NIOS2_GOTOFF
6239 -- : BFD_RELOC_NIOS2_CALL26_NOAT
6240 -- : BFD_RELOC_NIOS2_GOT_LO
6241 -- : BFD_RELOC_NIOS2_GOT_HA
6242 -- : BFD_RELOC_NIOS2_CALL_LO
6243 -- : BFD_RELOC_NIOS2_CALL_HA
6244 -- : BFD_RELOC_NIOS2_R2_S12
6245 -- : BFD_RELOC_NIOS2_R2_I10_1_PCREL
6246 -- : BFD_RELOC_NIOS2_R2_T1I7_1_PCREL
6247 -- : BFD_RELOC_NIOS2_R2_T1I7_2
6248 -- : BFD_RELOC_NIOS2_R2_T2I4
6249 -- : BFD_RELOC_NIOS2_R2_T2I4_1
6250 -- : BFD_RELOC_NIOS2_R2_T2I4_2
6251 -- : BFD_RELOC_NIOS2_R2_X1I7_2
6252 -- : BFD_RELOC_NIOS2_R2_X2L5
6253 -- : BFD_RELOC_NIOS2_R2_F1I5_2
6254 -- : BFD_RELOC_NIOS2_R2_L5I4X1
6255 -- : BFD_RELOC_NIOS2_R2_T1X1I6
6256 -- : BFD_RELOC_NIOS2_R2_T1X1I6_2
6257     Relocations used by the Altera Nios II core.
6258 -- : BFD_RELOC_PRU_U16
6259     PRU LDI 16-bit unsigned data-memory relocation.
6260 -- : BFD_RELOC_PRU_U16_PMEMIMM
6261     PRU LDI 16-bit unsigned instruction-memory relocation.
6262 -- : BFD_RELOC_PRU_LDI32
6263     PRU relocation for two consecutive LDI load instructions that load
6264     a 32 bit value into a register.  If the higher bits are all zero,
6265     then the second instruction may be relaxed.
6266 -- : BFD_RELOC_PRU_S10_PCREL
6267     PRU QBBx 10-bit signed PC-relative relocation.
6268 -- : BFD_RELOC_PRU_U8_PCREL
6269     PRU 8-bit unsigned relocation used for the LOOP instruction.
6270 -- : BFD_RELOC_PRU_32_PMEM
6271 -- : BFD_RELOC_PRU_16_PMEM
6272     PRU Program Memory relocations.  Used to convert from byte
6273     addressing to 32-bit word addressing.
6274 -- : BFD_RELOC_PRU_GNU_DIFF8
6275 -- : BFD_RELOC_PRU_GNU_DIFF16
6276 -- : BFD_RELOC_PRU_GNU_DIFF32
6277 -- : BFD_RELOC_PRU_GNU_DIFF16_PMEM
6278 -- : BFD_RELOC_PRU_GNU_DIFF32_PMEM
6279     PRU relocations to mark the difference of two local symbols.  These
6280     are only needed to support linker relaxation and can be ignored
6281     when not relaxing.  The field is set to the value of the difference
6282     assuming no relaxation.  The relocation encodes the position of the
6283     second symbol so the linker can determine whether to adjust the
6284     field value.  The PMEM variants encode the word difference, instead
6285     of byte difference between symbols.
6286 -- : BFD_RELOC_IQ2000_OFFSET_16
6287 -- : BFD_RELOC_IQ2000_OFFSET_21
6288 -- : BFD_RELOC_IQ2000_UHI16
6289     IQ2000 Relocations.
6290 -- : BFD_RELOC_XTENSA_RTLD
6291     Special Xtensa relocation used only by PLT entries in ELF shared
6292     objects to indicate that the runtime linker should set the value to
6293     one of its own internal functions or data structures.
6294 -- : BFD_RELOC_XTENSA_GLOB_DAT
6295 -- : BFD_RELOC_XTENSA_JMP_SLOT
6296 -- : BFD_RELOC_XTENSA_RELATIVE
6297     Xtensa relocations for ELF shared objects.
6298 -- : BFD_RELOC_XTENSA_PLT
6299     Xtensa relocation used in ELF object files for symbols that may
6300     require PLT entries.  Otherwise, this is just a generic 32-bit
6301     relocation.
6302 -- : BFD_RELOC_XTENSA_DIFF8
6303 -- : BFD_RELOC_XTENSA_DIFF16
6304 -- : BFD_RELOC_XTENSA_DIFF32
6305     Xtensa relocations for backward compatibility.  These have been
6306     replaced by BFD_RELOC_XTENSA_PDIFF and BFD_RELOC_XTENSA_NDIFF.
6307     Xtensa relocations to mark the difference of two local symbols.
6308     These are only needed to support linker relaxation and can be
6309     ignored when not relaxing.  The field is set to the value of the
6310     difference assuming no relaxation.  The relocation encodes the
6311     position of the first symbol so the linker can determine whether to
6312     adjust the field value.
6313 -- : BFD_RELOC_XTENSA_SLOT0_OP
6314 -- : BFD_RELOC_XTENSA_SLOT1_OP
6315 -- : BFD_RELOC_XTENSA_SLOT2_OP
6316 -- : BFD_RELOC_XTENSA_SLOT3_OP
6317 -- : BFD_RELOC_XTENSA_SLOT4_OP
6318 -- : BFD_RELOC_XTENSA_SLOT5_OP
6319 -- : BFD_RELOC_XTENSA_SLOT6_OP
6320 -- : BFD_RELOC_XTENSA_SLOT7_OP
6321 -- : BFD_RELOC_XTENSA_SLOT8_OP
6322 -- : BFD_RELOC_XTENSA_SLOT9_OP
6323 -- : BFD_RELOC_XTENSA_SLOT10_OP
6324 -- : BFD_RELOC_XTENSA_SLOT11_OP
6325 -- : BFD_RELOC_XTENSA_SLOT12_OP
6326 -- : BFD_RELOC_XTENSA_SLOT13_OP
6327 -- : BFD_RELOC_XTENSA_SLOT14_OP
6328     Generic Xtensa relocations for instruction operands.  Only the slot
6329     number is encoded in the relocation.  The relocation applies to the
6330     last PC-relative immediate operand, or if there are no PC-relative
6331     immediates, to the last immediate operand.
6332 -- : BFD_RELOC_XTENSA_SLOT0_ALT
6333 -- : BFD_RELOC_XTENSA_SLOT1_ALT
6334 -- : BFD_RELOC_XTENSA_SLOT2_ALT
6335 -- : BFD_RELOC_XTENSA_SLOT3_ALT
6336 -- : BFD_RELOC_XTENSA_SLOT4_ALT
6337 -- : BFD_RELOC_XTENSA_SLOT5_ALT
6338 -- : BFD_RELOC_XTENSA_SLOT6_ALT
6339 -- : BFD_RELOC_XTENSA_SLOT7_ALT
6340 -- : BFD_RELOC_XTENSA_SLOT8_ALT
6341 -- : BFD_RELOC_XTENSA_SLOT9_ALT
6342 -- : BFD_RELOC_XTENSA_SLOT10_ALT
6343 -- : BFD_RELOC_XTENSA_SLOT11_ALT
6344 -- : BFD_RELOC_XTENSA_SLOT12_ALT
6345 -- : BFD_RELOC_XTENSA_SLOT13_ALT
6346 -- : BFD_RELOC_XTENSA_SLOT14_ALT
6347     Alternate Xtensa relocations.  Only the slot is encoded in the
6348     relocation.  The meaning of these relocations is opcode-specific.
6349 -- : BFD_RELOC_XTENSA_OP0
6350 -- : BFD_RELOC_XTENSA_OP1
6351 -- : BFD_RELOC_XTENSA_OP2
6352     Xtensa relocations for backward compatibility.  These have all been
6353     replaced by BFD_RELOC_XTENSA_SLOT0_OP.
6354 -- : BFD_RELOC_XTENSA_ASM_EXPAND
6355     Xtensa relocation to mark that the assembler expanded the
6356     instructions from an original target.  The expansion size is
6357     encoded in the reloc size.
6358 -- : BFD_RELOC_XTENSA_ASM_SIMPLIFY
6359     Xtensa relocation to mark that the linker should simplify
6360     assembler-expanded instructions.  This is commonly used internally
6361     by the linker after analysis of a BFD_RELOC_XTENSA_ASM_EXPAND.
6362 -- : BFD_RELOC_XTENSA_TLSDESC_FN
6363 -- : BFD_RELOC_XTENSA_TLSDESC_ARG
6364 -- : BFD_RELOC_XTENSA_TLS_DTPOFF
6365 -- : BFD_RELOC_XTENSA_TLS_TPOFF
6366 -- : BFD_RELOC_XTENSA_TLS_FUNC
6367 -- : BFD_RELOC_XTENSA_TLS_ARG
6368 -- : BFD_RELOC_XTENSA_TLS_CALL
6369     Xtensa TLS relocations.
6370 -- : BFD_RELOC_XTENSA_PDIFF8
6371 -- : BFD_RELOC_XTENSA_PDIFF16
6372 -- : BFD_RELOC_XTENSA_PDIFF32
6373 -- : BFD_RELOC_XTENSA_NDIFF8
6374 -- : BFD_RELOC_XTENSA_NDIFF16
6375 -- : BFD_RELOC_XTENSA_NDIFF32
6376     Xtensa relocations to mark the difference of two local symbols.
6377     These are only needed to support linker relaxation and can be
6378     ignored when not relaxing.  The field is set to the value of the
6379     difference assuming no relaxation.  The relocation encodes the
6380     position of the subtracted symbol so the linker can determine
6381     whether to adjust the field value.  PDIFF relocations are used for
6382     positive differences, NDIFF relocations are used for negative
6383     differences.  The difference value is treated as unsigned with
6384     these relocation types, giving full 8/16 value ranges.
6385 -- : BFD_RELOC_Z80_DISP8
6386     8 bit signed offset in (ix+d) or (iy+d).
6387 -- : BFD_RELOC_Z80_BYTE0
6388     First 8 bits of multibyte (32, 24 or 16 bit) value.
6389 -- : BFD_RELOC_Z80_BYTE1
6390     Second 8 bits of multibyte (32, 24 or 16 bit) value.
6391 -- : BFD_RELOC_Z80_BYTE2
6392     Third 8 bits of multibyte (32 or 24 bit) value.
6393 -- : BFD_RELOC_Z80_BYTE3
6394     Fourth 8 bits of multibyte (32 bit) value.
6395 -- : BFD_RELOC_Z80_WORD0
6396     Lowest 16 bits of multibyte (32 or 24 bit) value.
6397 -- : BFD_RELOC_Z80_WORD1
6398     Highest 16 bits of multibyte (32 or 24 bit) value.
6399 -- : BFD_RELOC_Z80_16_BE
6400     Like BFD_RELOC_16 but big-endian.
6401 -- : BFD_RELOC_Z8K_DISP7
6402     DJNZ offset.
6403 -- : BFD_RELOC_Z8K_CALLR
6404     CALR offset.
6405 -- : BFD_RELOC_Z8K_IMM4L
6406     4 bit value.
6407 -- : BFD_RELOC_LM32_CALL
6408 -- : BFD_RELOC_LM32_BRANCH
6409 -- : BFD_RELOC_LM32_16_GOT
6410 -- : BFD_RELOC_LM32_GOTOFF_HI16
6411 -- : BFD_RELOC_LM32_GOTOFF_LO16
6412 -- : BFD_RELOC_LM32_COPY
6413 -- : BFD_RELOC_LM32_GLOB_DAT
6414 -- : BFD_RELOC_LM32_JMP_SLOT
6415 -- : BFD_RELOC_LM32_RELATIVE
6416     Lattice Mico32 relocations.
6417 -- : BFD_RELOC_MACH_O_SECTDIFF
6418     Difference between two section addreses.  Must be followed by a
6419     BFD_RELOC_MACH_O_PAIR.
6420 -- : BFD_RELOC_MACH_O_LOCAL_SECTDIFF
6421     Like BFD_RELOC_MACH_O_SECTDIFF but with a local symbol.
6422 -- : BFD_RELOC_MACH_O_PAIR
6423     Pair of relocation.  Contains the first symbol.
6424 -- : BFD_RELOC_MACH_O_SUBTRACTOR32
6425     Symbol will be substracted.  Must be followed by a BFD_RELOC_32.
6426 -- : BFD_RELOC_MACH_O_SUBTRACTOR64
6427     Symbol will be substracted.  Must be followed by a BFD_RELOC_64.
6428 -- : BFD_RELOC_MACH_O_X86_64_BRANCH32
6429 -- : BFD_RELOC_MACH_O_X86_64_BRANCH8
6430     PCREL relocations.  They are marked as branch to create PLT entry
6431     if required.
6432 -- : BFD_RELOC_MACH_O_X86_64_GOT
6433     Used when referencing a GOT entry.
6434 -- : BFD_RELOC_MACH_O_X86_64_GOT_LOAD
6435     Used when loading a GOT entry with movq.  It is specially marked so
6436     that the linker could optimize the movq to a leaq if possible.
6437 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_1
6438     Same as BFD_RELOC_32_PCREL but with an implicit -1 addend.
6439 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_2
6440     Same as BFD_RELOC_32_PCREL but with an implicit -2 addend.
6441 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_4
6442     Same as BFD_RELOC_32_PCREL but with an implicit -4 addend.
6443 -- : BFD_RELOC_MACH_O_X86_64_TLV
6444     Used when referencing a TLV entry.
6445 -- : BFD_RELOC_MACH_O_ARM64_ADDEND
6446     Addend for PAGE or PAGEOFF.
6447 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21
6448     Relative offset to page of GOT slot.
6449 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12
6450     Relative offset within page of GOT slot.
6451 -- : BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT
6452     Address of a GOT entry.
6453 -- : BFD_RELOC_MICROBLAZE_32_LO
6454     This is a 32 bit reloc for the microblaze that stores the low 16
6455     bits of a value
6456 -- : BFD_RELOC_MICROBLAZE_32_LO_PCREL
6457     This is a 32 bit pc-relative reloc for the microblaze that stores
6458     the low 16 bits of a value
6459 -- : BFD_RELOC_MICROBLAZE_32_ROSDA
6460     This is a 32 bit reloc for the microblaze that stores a value
6461     relative to the read-only small data area anchor
6462 -- : BFD_RELOC_MICROBLAZE_32_RWSDA
6463     This is a 32 bit reloc for the microblaze that stores a value
6464     relative to the read-write small data area anchor
6465 -- : BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM
6466     This is a 32 bit reloc for the microblaze to handle expressions of
6467     the form "Symbol Op Symbol"
6468 -- : BFD_RELOC_MICROBLAZE_64_NONE
6469     This is a 64 bit reloc that stores the 32 bit pc relative value in
6470     two words (with an imm instruction).  No relocation is done here -
6471     only used for relaxing
6472 -- : BFD_RELOC_MICROBLAZE_64_GOTPC
6473     This is a 64 bit reloc that stores the 32 bit pc relative value in
6474     two words (with an imm instruction).  The relocation is PC-relative
6475     GOT offset
6476 -- : BFD_RELOC_MICROBLAZE_64_GOT
6477     This is a 64 bit reloc that stores the 32 bit pc relative value in
6478     two words (with an imm instruction).  The relocation is GOT offset
6479 -- : BFD_RELOC_MICROBLAZE_64_PLT
6480     This is a 64 bit reloc that stores the 32 bit pc relative value in
6481     two words (with an imm instruction).  The relocation is PC-relative
6482     offset into PLT
6483 -- : BFD_RELOC_MICROBLAZE_64_GOTOFF
6484     This is a 64 bit reloc that stores the 32 bit GOT relative value in
6485     two words (with an imm instruction).  The relocation is relative
6486     offset from _GLOBAL_OFFSET_TABLE_
6487 -- : BFD_RELOC_MICROBLAZE_32_GOTOFF
6488     This is a 32 bit reloc that stores the 32 bit GOT relative value in
6489     a word.  The relocation is relative offset from
6490 -- : BFD_RELOC_MICROBLAZE_COPY
6491     This is used to tell the dynamic linker to copy the value out of
6492     the dynamic object into the runtime process image.
6493 -- : BFD_RELOC_MICROBLAZE_64_TLS
6494     Unused Reloc
6495 -- : BFD_RELOC_MICROBLAZE_64_TLSGD
6496     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6497     the GOT TLS GD info entry in two words (with an imm instruction).
6498     The relocation is GOT offset.
6499 -- : BFD_RELOC_MICROBLAZE_64_TLSLD
6500     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6501     the GOT TLS LD info entry in two words (with an imm instruction).
6502     The relocation is GOT offset.
6503 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPMOD
6504     This is a 32 bit reloc that stores the Module ID to GOT(n).
6505 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPREL
6506     This is a 32 bit reloc that stores TLS offset to GOT(n+1).
6507 -- : BFD_RELOC_MICROBLAZE_64_TLSDTPREL
6508     This is a 32 bit reloc for storing TLS offset to two words (uses
6509     imm instruction)
6510 -- : BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL
6511     This is a 64 bit reloc that stores 32-bit thread pointer relative
6512     offset to two words (uses imm instruction).
6513 -- : BFD_RELOC_MICROBLAZE_64_TLSTPREL
6514     This is a 64 bit reloc that stores 32-bit thread pointer relative
6515     offset to two words (uses imm instruction).
6516 -- : BFD_RELOC_MICROBLAZE_64_TEXTPCREL
6517     This is a 64 bit reloc that stores the 32 bit pc relative value in
6518     two words (with an imm instruction).  The relocation is PC-relative
6519     offset from start of TEXT.
6520 -- : BFD_RELOC_MICROBLAZE_64_TEXTREL
6521     This is a 64 bit reloc that stores the 32 bit offset value in two
6522     words (with an imm instruction).  The relocation is relative offset
6523     from start of TEXT.
6524 -- : BFD_RELOC_AARCH64_RELOC_START
6525     AArch64 pseudo relocation code to mark the start of the AArch64
6526     relocation enumerators.  N.B. the order of the enumerators is
6527     important as several tables in the AArch64 bfd backend are indexed
6528     by these enumerators; make sure they are all synced.
6529 -- : BFD_RELOC_AARCH64_NULL
6530     Deprecated AArch64 null relocation code.
6531 -- : BFD_RELOC_AARCH64_NONE
6532     AArch64 null relocation code.
6533 -- : BFD_RELOC_AARCH64_64
6534 -- : BFD_RELOC_AARCH64_32
6535 -- : BFD_RELOC_AARCH64_16
6536     Basic absolute relocations of N bits.  These are equivalent to
6537     BFD_RELOC_N and they were added to assist the indexing of the howto
6538     table.
6539 -- : BFD_RELOC_AARCH64_64_PCREL
6540 -- : BFD_RELOC_AARCH64_32_PCREL
6541 -- : BFD_RELOC_AARCH64_16_PCREL
6542     PC-relative relocations.  These are equivalent to BFD_RELOC_N_PCREL
6543     and they were added to assist the indexing of the howto table.
6544 -- : BFD_RELOC_AARCH64_MOVW_G0
6545     AArch64 MOV[NZK] instruction with most significant bits 0 to 15 of
6546     an unsigned address/value.
6547 -- : BFD_RELOC_AARCH64_MOVW_G0_NC
6548     AArch64 MOV[NZK] instruction with less significant bits 0 to 15 of
6549     an address/value.  No overflow checking.
6550 -- : BFD_RELOC_AARCH64_MOVW_G1
6551     AArch64 MOV[NZK] instruction with most significant bits 16 to 31 of
6552     an unsigned address/value.
6553 -- : BFD_RELOC_AARCH64_MOVW_G1_NC
6554     AArch64 MOV[NZK] instruction with less significant bits 16 to 31 of
6555     an address/value.  No overflow checking.
6556 -- : BFD_RELOC_AARCH64_MOVW_G2
6557     AArch64 MOV[NZK] instruction with most significant bits 32 to 47 of
6558     an unsigned address/value.
6559 -- : BFD_RELOC_AARCH64_MOVW_G2_NC
6560     AArch64 MOV[NZK] instruction with less significant bits 32 to 47 of
6561     an address/value.  No overflow checking.
6562 -- : BFD_RELOC_AARCH64_MOVW_G3
6563     AArch64 MOV[NZK] instruction with most signficant bits 48 to 64 of
6564     a signed or unsigned address/value.
6565 -- : BFD_RELOC_AARCH64_MOVW_G0_S
6566     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6567     signed value.  Changes instruction to MOVZ or MOVN depending on the
6568     value's sign.
6569 -- : BFD_RELOC_AARCH64_MOVW_G1_S
6570     AArch64 MOV[NZ] instruction with most significant bits 16 to 31 of
6571     a signed value.  Changes instruction to MOVZ or MOVN depending on
6572     the value's sign.
6573 -- : BFD_RELOC_AARCH64_MOVW_G2_S
6574     AArch64 MOV[NZ] instruction with most significant bits 32 to 47 of
6575     a signed value.  Changes instruction to MOVZ or MOVN depending on
6576     the value's sign.
6577 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0
6578     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6579     signed value.  Changes instruction to MOVZ or MOVN depending on the
6580     value's sign.
6581 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0_NC
6582     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6583     signed value.  Changes instruction to MOVZ or MOVN depending on the
6584     value's sign.
6585 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1
6586     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6587     signed value.
6588 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1_NC
6589     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6590     signed value.
6591 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2
6592     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6593     signed value.
6594 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2_NC
6595     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6596     signed value.
6597 -- : BFD_RELOC_AARCH64_MOVW_PREL_G3
6598     AArch64 MOVK instruction with most significant bits 47 to 63 of a
6599     signed value.
6600 -- : BFD_RELOC_AARCH64_LD_LO19_PCREL
6601     AArch64 Load Literal instruction, holding a 19 bit pc-relative word
6602     offset.  The lowest two bits must be zero and are not stored in the
6603     instruction, giving a 21 bit signed byte offset.
6604 -- : BFD_RELOC_AARCH64_ADR_LO21_PCREL
6605     AArch64 ADR instruction, holding a simple 21 bit pc-relative byte
6606     offset.
6607 -- : BFD_RELOC_AARCH64_ADR_HI21_PCREL
6608     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6609     offset, giving a 4KB aligned page base address.
6610 -- : BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL
6611     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6612     offset, giving a 4KB aligned page base address, but with no
6613     overflow checking.
6614 -- : BFD_RELOC_AARCH64_ADD_LO12
6615     AArch64 ADD immediate instruction, holding bits 0 to 11 of the
6616     address.  Used in conjunction with
6617     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6618 -- : BFD_RELOC_AARCH64_LDST8_LO12
6619     AArch64 8-bit load/store instruction, holding bits 0 to 11 of the
6620     address.  Used in conjunction with
6621     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6622 -- : BFD_RELOC_AARCH64_TSTBR14
6623     AArch64 14 bit pc-relative test bit and branch.  The lowest two
6624     bits must be zero and are not stored in the instruction, giving a
6625     16 bit signed byte offset.
6626 -- : BFD_RELOC_AARCH64_BRANCH19
6627     AArch64 19 bit pc-relative conditional branch and compare & branch.
6628     The lowest two bits must be zero and are not stored in the
6629     instruction, giving a 21 bit signed byte offset.
6630 -- : BFD_RELOC_AARCH64_JUMP26
6631     AArch64 26 bit pc-relative unconditional branch.  The lowest two
6632     bits must be zero and are not stored in the instruction, giving a
6633     28 bit signed byte offset.
6634 -- : BFD_RELOC_AARCH64_CALL26
6635     AArch64 26 bit pc-relative unconditional branch and link.  The
6636     lowest two bits must be zero and are not stored in the instruction,
6637     giving a 28 bit signed byte offset.
6638 -- : BFD_RELOC_AARCH64_LDST16_LO12
6639     AArch64 16-bit load/store instruction, holding bits 0 to 11 of the
6640     address.  Used in conjunction with
6641     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6642 -- : BFD_RELOC_AARCH64_LDST32_LO12
6643     AArch64 32-bit load/store instruction, holding bits 0 to 11 of the
6644     address.  Used in conjunction with
6645     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6646 -- : BFD_RELOC_AARCH64_LDST64_LO12
6647     AArch64 64-bit load/store instruction, holding bits 0 to 11 of the
6648     address.  Used in conjunction with
6649     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6650 -- : BFD_RELOC_AARCH64_LDST128_LO12
6651     AArch64 128-bit load/store instruction, holding bits 0 to 11 of the
6652     address.  Used in conjunction with
6653     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6654 -- : BFD_RELOC_AARCH64_GOT_LD_PREL19
6655     AArch64 Load Literal instruction, holding a 19 bit PC relative word
6656     offset of the global offset table entry for a symbol.  The lowest
6657     two bits must be zero and are not stored in the instruction, giving
6658     a 21 bit signed byte offset.  This relocation type requires signed
6659     overflow checking.
6660 -- : BFD_RELOC_AARCH64_ADR_GOT_PAGE
6661     Get to the page base of the global offset table entry for a symbol
6662     as part of an ADRP instruction using a 21 bit PC relative
6663     value.Used in conjunction with BFD_RELOC_AARCH64_LD64_GOT_LO12_NC.
6664 -- : BFD_RELOC_AARCH64_LD64_GOT_LO12_NC
6665     Unsigned 12 bit byte offset for 64 bit load/store from the page of
6666     the GOT entry for this symbol.  Used in conjunction with
6667     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in LP64 ABI only.
6668 -- : BFD_RELOC_AARCH64_LD32_GOT_LO12_NC
6669     Unsigned 12 bit byte offset for 32 bit load/store from the page of
6670     the GOT entry for this symbol.  Used in conjunction with
6671     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in ILP32 ABI only.
6672 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC
6673     Unsigned 16 bit byte offset for 64 bit load/store from the GOT
6674     entry for this symbol.  Valid in LP64 ABI only.
6675 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G1
6676     Unsigned 16 bit byte higher offset for 64 bit load/store from the
6677     GOT entry for this symbol.  Valid in LP64 ABI only.
6678 -- : BFD_RELOC_AARCH64_LD64_GOTOFF_LO15
6679     Unsigned 15 bit byte offset for 64 bit load/store from the page of
6680     the GOT entry for this symbol.  Valid in LP64 ABI only.
6681 -- : BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14
6682     Scaled 14 bit byte offset to the page base of the global offset
6683     table.
6684 -- : BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15
6685     Scaled 15 bit byte offset to the page base of the global offset
6686     table.
6687 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21
6688     Get to the page base of the global offset table entry for a symbols
6689     tls_index structure as part of an adrp instruction using a 21 bit
6690     PC relative value.  Used in conjunction with
6691     BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC.
6692 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PREL21
6693     AArch64 TLS General Dynamic
6694 -- : BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC
6695     Unsigned 12 bit byte offset to global offset table entry for a
6696     symbols tls_index structure.  Used in conjunction with
6697     BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21.
6698 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC
6699     AArch64 TLS General Dynamic relocation.
6700 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G1
6701     AArch64 TLS General Dynamic relocation.
6702 -- : BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21
6703     AArch64 TLS INITIAL EXEC relocation.
6704 -- : BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC
6705     AArch64 TLS INITIAL EXEC relocation.
6706 -- : BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC
6707     AArch64 TLS INITIAL EXEC relocation.
6708 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19
6709     AArch64 TLS INITIAL EXEC relocation.
6710 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC
6711     AArch64 TLS INITIAL EXEC relocation.
6712 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1
6713     AArch64 TLS INITIAL EXEC relocation.
6714 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12
6715     bit[23:12] of byte offset to module TLS base address.
6716 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12
6717     Unsigned 12 bit byte offset to module TLS base address.
6718 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC
6719     No overflow check version of
6720     BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12.
6721 -- : BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC
6722     Unsigned 12 bit byte offset to global offset table entry for a
6723     symbols tls_index structure.  Used in conjunction with
6724     BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21.
6725 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21
6726     GOT entry page address for AArch64 TLS Local Dynamic, used with
6727     ADRP instruction.
6728 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PREL21
6729     GOT entry address for AArch64 TLS Local Dynamic, used with ADR
6730     instruction.
6731 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12
6732     bit[11:1] of byte offset to module TLS base address, encoded in
6733     ldst instructions.
6734 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC
6735     Similar as BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12, but no
6736     overflow check.
6737 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12
6738     bit[11:2] of byte offset to module TLS base address, encoded in
6739     ldst instructions.
6740 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC
6741     Similar as BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12, but no
6742     overflow check.
6743 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12
6744     bit[11:3] of byte offset to module TLS base address, encoded in
6745     ldst instructions.
6746 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC
6747     Similar as BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12, but no
6748     overflow check.
6749 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12
6750     bit[11:0] of byte offset to module TLS base address, encoded in
6751     ldst instructions.
6752 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC
6753     Similar as BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12, but no
6754     overflow check.
6755 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6756     bit[15:0] of byte offset to module TLS base address.
6757 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC
6758     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6759 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6760     bit[31:16] of byte offset to module TLS base address.
6761 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC
6762     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6763 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2
6764     bit[47:32] of byte offset to module TLS base address.
6765 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2
6766     AArch64 TLS LOCAL EXEC relocation.
6767 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1
6768     AArch64 TLS LOCAL EXEC relocation.
6769 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC
6770     AArch64 TLS LOCAL EXEC relocation.
6771 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0
6772     AArch64 TLS LOCAL EXEC relocation.
6773 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC
6774     AArch64 TLS LOCAL EXEC relocation.
6775 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12
6776     AArch64 TLS LOCAL EXEC relocation.
6777 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12
6778     AArch64 TLS LOCAL EXEC relocation.
6779 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC
6780     AArch64 TLS LOCAL EXEC relocation.
6781 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12
6782     bit[11:1] of byte offset to module TLS base address, encoded in
6783     ldst instructions.
6784 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC
6785     Similar as BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12, but no
6786     overflow check.
6787 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12
6788     bit[11:2] of byte offset to module TLS base address, encoded in
6789     ldst instructions.
6790 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC
6791     Similar as BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12, but no
6792     overflow check.
6793 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12
6794     bit[11:3] of byte offset to module TLS base address, encoded in
6795     ldst instructions.
6796 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC
6797     Similar as BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12, but no
6798     overflow check.
6799 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12
6800     bit[11:0] of byte offset to module TLS base address, encoded in
6801     ldst instructions.
6802 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC
6803     Similar as BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12, but no
6804     overflow check.
6805 -- : BFD_RELOC_AARCH64_TLSDESC_LD_PREL19
6806     AArch64 TLS DESC relocation.
6807 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21
6808     AArch64 TLS DESC relocation.
6809 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21
6810     AArch64 TLS DESC relocation.
6811 -- : BFD_RELOC_AARCH64_TLSDESC_LD64_LO12
6812     AArch64 TLS DESC relocation.
6813 -- : BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC
6814     AArch64 TLS DESC relocation.
6815 -- : BFD_RELOC_AARCH64_TLSDESC_ADD_LO12
6816     AArch64 TLS DESC relocation.
6817 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G1
6818     AArch64 TLS DESC relocation.
6819 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC
6820     AArch64 TLS DESC relocation.
6821 -- : BFD_RELOC_AARCH64_TLSDESC_LDR
6822     AArch64 TLS DESC relocation.
6823 -- : BFD_RELOC_AARCH64_TLSDESC_ADD
6824     AArch64 TLS DESC relocation.
6825 -- : BFD_RELOC_AARCH64_TLSDESC_CALL
6826     AArch64 TLS DESC relocation.
6827 -- : BFD_RELOC_AARCH64_COPY
6828     AArch64 TLS relocation.
6829 -- : BFD_RELOC_AARCH64_GLOB_DAT
6830     AArch64 TLS relocation.
6831 -- : BFD_RELOC_AARCH64_JUMP_SLOT
6832     AArch64 TLS relocation.
6833 -- : BFD_RELOC_AARCH64_RELATIVE
6834     AArch64 TLS relocation.
6835 -- : BFD_RELOC_AARCH64_TLS_DTPMOD
6836     AArch64 TLS relocation.
6837 -- : BFD_RELOC_AARCH64_TLS_DTPREL
6838     AArch64 TLS relocation.
6839 -- : BFD_RELOC_AARCH64_TLS_TPREL
6840     AArch64 TLS relocation.
6841 -- : BFD_RELOC_AARCH64_TLSDESC
6842     AArch64 TLS relocation.
6843 -- : BFD_RELOC_AARCH64_IRELATIVE
6844     AArch64 support for STT_GNU_IFUNC.
6845 -- : BFD_RELOC_AARCH64_RELOC_END
6846     AArch64 pseudo relocation code to mark the end of the AArch64
6847     relocation enumerators that have direct mapping to ELF reloc codes.
6848     There are a few more enumerators after this one; those are mainly
6849     used by the AArch64 assembler for the internal fixup or to select
6850     one of the above enumerators.
6851 -- : BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP
6852     AArch64 pseudo relocation code to be used internally by the AArch64
6853     assembler and not (currently) written to any object files.
6854 -- : BFD_RELOC_AARCH64_LDST_LO12
6855     AArch64 unspecified load/store instruction, holding bits 0 to 11 of
6856     the address.  Used in conjunction with
6857     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6858 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12
6859     AArch64 pseudo relocation code for TLS local dynamic mode.  It's to
6860     be used internally by the AArch64 assembler and not (currently)
6861     written to any object files.
6862 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC
6863     Similar as BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12, but no
6864     overflow check.
6865 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12
6866     AArch64 pseudo relocation code for TLS local exec mode.  It's to be
6867     used internally by the AArch64 assembler and not (currently)
6868     written to any object files.
6869 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC
6870     Similar as BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12, but no overflow
6871     check.
6872 -- : BFD_RELOC_AARCH64_LD_GOT_LO12_NC
6873     AArch64 pseudo relocation code to be used internally by the AArch64
6874     assembler and not (currently) written to any object files.
6875 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC
6876     AArch64 pseudo relocation code to be used internally by the AArch64
6877     assembler and not (currently) written to any object files.
6878 -- : BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC
6879     AArch64 pseudo relocation code to be used internally by the AArch64
6880     assembler and not (currently) written to any object files.
6881 -- : BFD_RELOC_TILEPRO_COPY
6882 -- : BFD_RELOC_TILEPRO_GLOB_DAT
6883 -- : BFD_RELOC_TILEPRO_JMP_SLOT
6884 -- : BFD_RELOC_TILEPRO_RELATIVE
6885 -- : BFD_RELOC_TILEPRO_BROFF_X1
6886 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1
6887 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT
6888 -- : BFD_RELOC_TILEPRO_IMM8_X0
6889 -- : BFD_RELOC_TILEPRO_IMM8_Y0
6890 -- : BFD_RELOC_TILEPRO_IMM8_X1
6891 -- : BFD_RELOC_TILEPRO_IMM8_Y1
6892 -- : BFD_RELOC_TILEPRO_DEST_IMM8_X1
6893 -- : BFD_RELOC_TILEPRO_MT_IMM15_X1
6894 -- : BFD_RELOC_TILEPRO_MF_IMM15_X1
6895 -- : BFD_RELOC_TILEPRO_IMM16_X0
6896 -- : BFD_RELOC_TILEPRO_IMM16_X1
6897 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO
6898 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO
6899 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI
6900 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI
6901 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA
6902 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA
6903 -- : BFD_RELOC_TILEPRO_IMM16_X0_PCREL
6904 -- : BFD_RELOC_TILEPRO_IMM16_X1_PCREL
6905 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL
6906 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL
6907 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL
6908 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL
6909 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL
6910 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL
6911 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT
6912 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT
6913 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO
6914 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO
6915 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI
6916 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI
6917 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA
6918 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA
6919 -- : BFD_RELOC_TILEPRO_MMSTART_X0
6920 -- : BFD_RELOC_TILEPRO_MMEND_X0
6921 -- : BFD_RELOC_TILEPRO_MMSTART_X1
6922 -- : BFD_RELOC_TILEPRO_MMEND_X1
6923 -- : BFD_RELOC_TILEPRO_SHAMT_X0
6924 -- : BFD_RELOC_TILEPRO_SHAMT_X1
6925 -- : BFD_RELOC_TILEPRO_SHAMT_Y0
6926 -- : BFD_RELOC_TILEPRO_SHAMT_Y1
6927 -- : BFD_RELOC_TILEPRO_TLS_GD_CALL
6928 -- : BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD
6929 -- : BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD
6930 -- : BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD
6931 -- : BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD
6932 -- : BFD_RELOC_TILEPRO_TLS_IE_LOAD
6933 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD
6934 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD
6935 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO
6936 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO
6937 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI
6938 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI
6939 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA
6940 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA
6941 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE
6942 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE
6943 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO
6944 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO
6945 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI
6946 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI
6947 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA
6948 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA
6949 -- : BFD_RELOC_TILEPRO_TLS_DTPMOD32
6950 -- : BFD_RELOC_TILEPRO_TLS_DTPOFF32
6951 -- : BFD_RELOC_TILEPRO_TLS_TPOFF32
6952 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE
6953 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE
6954 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO
6955 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO
6956 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI
6957 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI
6958 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA
6959 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA
6960     Tilera TILEPro Relocations.
6961 -- : BFD_RELOC_TILEGX_HW0
6962 -- : BFD_RELOC_TILEGX_HW1
6963 -- : BFD_RELOC_TILEGX_HW2
6964 -- : BFD_RELOC_TILEGX_HW3
6965 -- : BFD_RELOC_TILEGX_HW0_LAST
6966 -- : BFD_RELOC_TILEGX_HW1_LAST
6967 -- : BFD_RELOC_TILEGX_HW2_LAST
6968 -- : BFD_RELOC_TILEGX_COPY
6969 -- : BFD_RELOC_TILEGX_GLOB_DAT
6970 -- : BFD_RELOC_TILEGX_JMP_SLOT
6971 -- : BFD_RELOC_TILEGX_RELATIVE
6972 -- : BFD_RELOC_TILEGX_BROFF_X1
6973 -- : BFD_RELOC_TILEGX_JUMPOFF_X1
6974 -- : BFD_RELOC_TILEGX_JUMPOFF_X1_PLT
6975 -- : BFD_RELOC_TILEGX_IMM8_X0
6976 -- : BFD_RELOC_TILEGX_IMM8_Y0
6977 -- : BFD_RELOC_TILEGX_IMM8_X1
6978 -- : BFD_RELOC_TILEGX_IMM8_Y1
6979 -- : BFD_RELOC_TILEGX_DEST_IMM8_X1
6980 -- : BFD_RELOC_TILEGX_MT_IMM14_X1
6981 -- : BFD_RELOC_TILEGX_MF_IMM14_X1
6982 -- : BFD_RELOC_TILEGX_MMSTART_X0
6983 -- : BFD_RELOC_TILEGX_MMEND_X0
6984 -- : BFD_RELOC_TILEGX_SHAMT_X0
6985 -- : BFD_RELOC_TILEGX_SHAMT_X1
6986 -- : BFD_RELOC_TILEGX_SHAMT_Y0
6987 -- : BFD_RELOC_TILEGX_SHAMT_Y1
6988 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0
6989 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0
6990 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1
6991 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1
6992 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2
6993 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2
6994 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3
6995 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3
6996 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST
6997 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST
6998 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST
6999 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST
7000 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST
7001 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST
7002 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL
7003 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL
7004 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL
7005 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL
7006 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL
7007 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL
7008 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL
7009 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL
7010 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL
7011 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL
7012 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL
7013 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL
7014 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL
7015 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL
7016 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT
7017 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT
7018 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL
7019 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL
7020 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL
7021 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL
7022 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL
7023 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL
7024 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT
7025 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT
7026 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT
7027 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT
7028 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL
7029 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL
7030 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD
7031 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD
7032 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE
7033 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE
7034 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE
7035 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE
7036 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE
7037 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE
7038 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD
7039 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD
7040 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD
7041 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD
7042 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE
7043 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE
7044 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL
7045 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL
7046 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL
7047 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL
7048 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL
7049 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL
7050 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE
7051 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE
7052 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE
7053 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE
7054 -- : BFD_RELOC_TILEGX_TLS_DTPMOD64
7055 -- : BFD_RELOC_TILEGX_TLS_DTPOFF64
7056 -- : BFD_RELOC_TILEGX_TLS_TPOFF64
7057 -- : BFD_RELOC_TILEGX_TLS_DTPMOD32
7058 -- : BFD_RELOC_TILEGX_TLS_DTPOFF32
7059 -- : BFD_RELOC_TILEGX_TLS_TPOFF32
7060 -- : BFD_RELOC_TILEGX_TLS_GD_CALL
7061 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD
7062 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD
7063 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD
7064 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD
7065 -- : BFD_RELOC_TILEGX_TLS_IE_LOAD
7066 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD
7067 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD
7068 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD
7069 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD
7070     Tilera TILE-Gx Relocations.
7071 -- : BFD_RELOC_BPF_64
7072 -- : BFD_RELOC_BPF_32
7073 -- : BFD_RELOC_BPF_16
7074 -- : BFD_RELOC_BPF_DISP16
7075 -- : BFD_RELOC_BPF_DISP32
7076     Linux eBPF relocations.
7077 -- : BFD_RELOC_EPIPHANY_SIMM8
7078     Adapteva EPIPHANY - 8 bit signed pc-relative displacement
7079 -- : BFD_RELOC_EPIPHANY_SIMM24
7080     Adapteva EPIPHANY - 24 bit signed pc-relative displacement
7081 -- : BFD_RELOC_EPIPHANY_HIGH
7082     Adapteva EPIPHANY - 16 most-significant bits of absolute address
7083 -- : BFD_RELOC_EPIPHANY_LOW
7084     Adapteva EPIPHANY - 16 least-significant bits of absolute address
7085 -- : BFD_RELOC_EPIPHANY_SIMM11
7086     Adapteva EPIPHANY - 11 bit signed number - add/sub immediate
7087 -- : BFD_RELOC_EPIPHANY_IMM11
7088     Adapteva EPIPHANY - 11 bit sign-magnitude number (ld/st
7089     displacement)
7090 -- : BFD_RELOC_EPIPHANY_IMM8
7091     Adapteva EPIPHANY - 8 bit immediate for 16 bit mov instruction.
7092 -- : BFD_RELOC_VISIUM_HI16
7093 -- : BFD_RELOC_VISIUM_LO16
7094 -- : BFD_RELOC_VISIUM_IM16
7095 -- : BFD_RELOC_VISIUM_REL16
7096 -- : BFD_RELOC_VISIUM_HI16_PCREL
7097 -- : BFD_RELOC_VISIUM_LO16_PCREL
7098 -- : BFD_RELOC_VISIUM_IM16_PCREL
7099     Visium Relocations.
7100 -- : BFD_RELOC_WASM32_LEB128
7101 -- : BFD_RELOC_WASM32_LEB128_GOT
7102 -- : BFD_RELOC_WASM32_LEB128_GOT_CODE
7103 -- : BFD_RELOC_WASM32_LEB128_PLT
7104 -- : BFD_RELOC_WASM32_PLT_INDEX
7105 -- : BFD_RELOC_WASM32_ABS32_CODE
7106 -- : BFD_RELOC_WASM32_COPY
7107 -- : BFD_RELOC_WASM32_CODE_POINTER
7108 -- : BFD_RELOC_WASM32_INDEX
7109 -- : BFD_RELOC_WASM32_PLT_SIG
7110     WebAssembly relocations.
7111 -- : BFD_RELOC_CKCORE_NONE
7112 -- : BFD_RELOC_CKCORE_ADDR32
7113 -- : BFD_RELOC_CKCORE_PCREL_IMM8BY4
7114 -- : BFD_RELOC_CKCORE_PCREL_IMM11BY2
7115 -- : BFD_RELOC_CKCORE_PCREL_IMM4BY2
7116 -- : BFD_RELOC_CKCORE_PCREL32
7117 -- : BFD_RELOC_CKCORE_PCREL_JSR_IMM11BY2
7118 -- : BFD_RELOC_CKCORE_GNU_VTINHERIT
7119 -- : BFD_RELOC_CKCORE_GNU_VTENTRY
7120 -- : BFD_RELOC_CKCORE_RELATIVE
7121 -- : BFD_RELOC_CKCORE_COPY
7122 -- : BFD_RELOC_CKCORE_GLOB_DAT
7123 -- : BFD_RELOC_CKCORE_JUMP_SLOT
7124 -- : BFD_RELOC_CKCORE_GOTOFF
7125 -- : BFD_RELOC_CKCORE_GOTPC
7126 -- : BFD_RELOC_CKCORE_GOT32
7127 -- : BFD_RELOC_CKCORE_PLT32
7128 -- : BFD_RELOC_CKCORE_ADDRGOT
7129 -- : BFD_RELOC_CKCORE_ADDRPLT
7130 -- : BFD_RELOC_CKCORE_PCREL_IMM26BY2
7131 -- : BFD_RELOC_CKCORE_PCREL_IMM16BY2
7132 -- : BFD_RELOC_CKCORE_PCREL_IMM16BY4
7133 -- : BFD_RELOC_CKCORE_PCREL_IMM10BY2
7134 -- : BFD_RELOC_CKCORE_PCREL_IMM10BY4
7135 -- : BFD_RELOC_CKCORE_ADDR_HI16
7136 -- : BFD_RELOC_CKCORE_ADDR_LO16
7137 -- : BFD_RELOC_CKCORE_GOTPC_HI16
7138 -- : BFD_RELOC_CKCORE_GOTPC_LO16
7139 -- : BFD_RELOC_CKCORE_GOTOFF_HI16
7140 -- : BFD_RELOC_CKCORE_GOTOFF_LO16
7141 -- : BFD_RELOC_CKCORE_GOT12
7142 -- : BFD_RELOC_CKCORE_GOT_HI16
7143 -- : BFD_RELOC_CKCORE_GOT_LO16
7144 -- : BFD_RELOC_CKCORE_PLT12
7145 -- : BFD_RELOC_CKCORE_PLT_HI16
7146 -- : BFD_RELOC_CKCORE_PLT_LO16
7147 -- : BFD_RELOC_CKCORE_ADDRGOT_HI16
7148 -- : BFD_RELOC_CKCORE_ADDRGOT_LO16
7149 -- : BFD_RELOC_CKCORE_ADDRPLT_HI16
7150 -- : BFD_RELOC_CKCORE_ADDRPLT_LO16
7151 -- : BFD_RELOC_CKCORE_PCREL_JSR_IMM26BY2
7152 -- : BFD_RELOC_CKCORE_TOFFSET_LO16
7153 -- : BFD_RELOC_CKCORE_DOFFSET_LO16
7154 -- : BFD_RELOC_CKCORE_PCREL_IMM18BY2
7155 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18
7156 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18BY2
7157 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18BY4
7158 -- : BFD_RELOC_CKCORE_GOTOFF_IMM18
7159 -- : BFD_RELOC_CKCORE_GOT_IMM18BY4
7160 -- : BFD_RELOC_CKCORE_PLT_IMM18BY4
7161 -- : BFD_RELOC_CKCORE_PCREL_IMM7BY4
7162 -- : BFD_RELOC_CKCORE_TLS_LE32
7163 -- : BFD_RELOC_CKCORE_TLS_IE32
7164 -- : BFD_RELOC_CKCORE_TLS_GD32
7165 -- : BFD_RELOC_CKCORE_TLS_LDM32
7166 -- : BFD_RELOC_CKCORE_TLS_LDO32
7167 -- : BFD_RELOC_CKCORE_TLS_DTPMOD32
7168 -- : BFD_RELOC_CKCORE_TLS_DTPOFF32
7169 -- : BFD_RELOC_CKCORE_TLS_TPOFF32
7170 -- : BFD_RELOC_CKCORE_PCREL_FLRW_IMM8BY4
7171 -- : BFD_RELOC_CKCORE_NOJSRI
7172 -- : BFD_RELOC_CKCORE_CALLGRAPH
7173 -- : BFD_RELOC_CKCORE_IRELATIVE
7174 -- : BFD_RELOC_CKCORE_PCREL_BLOOP_IMM4BY4
7175 -- : BFD_RELOC_CKCORE_PCREL_BLOOP_IMM12BY4
7176     C-SKY relocations.
7177 -- : BFD_RELOC_S12Z_OPR
7178     S12Z relocations.
7179 -- : BFD_RELOC_LARCH_TLS_DTPMOD32
7180 -- : BFD_RELOC_LARCH_TLS_DTPREL32
7181 -- : BFD_RELOC_LARCH_TLS_DTPMOD64
7182 -- : BFD_RELOC_LARCH_TLS_DTPREL64
7183 -- : BFD_RELOC_LARCH_TLS_TPREL32
7184 -- : BFD_RELOC_LARCH_TLS_TPREL64
7185 -- : BFD_RELOC_LARCH_MARK_LA
7186 -- : BFD_RELOC_LARCH_MARK_PCREL
7187 -- : BFD_RELOC_LARCH_SOP_PUSH_PCREL
7188 -- : BFD_RELOC_LARCH_SOP_PUSH_ABSOLUTE
7189 -- : BFD_RELOC_LARCH_SOP_PUSH_DUP
7190 -- : BFD_RELOC_LARCH_SOP_PUSH_GPREL
7191 -- : BFD_RELOC_LARCH_SOP_PUSH_TLS_TPREL
7192 -- : BFD_RELOC_LARCH_SOP_PUSH_TLS_GOT
7193 -- : BFD_RELOC_LARCH_SOP_PUSH_TLS_GD
7194 -- : BFD_RELOC_LARCH_SOP_PUSH_PLT_PCREL
7195 -- : BFD_RELOC_LARCH_SOP_ASSERT
7196 -- : BFD_RELOC_LARCH_SOP_NOT
7197 -- : BFD_RELOC_LARCH_SOP_SUB
7198 -- : BFD_RELOC_LARCH_SOP_SL
7199 -- : BFD_RELOC_LARCH_SOP_SR
7200 -- : BFD_RELOC_LARCH_SOP_ADD
7201 -- : BFD_RELOC_LARCH_SOP_AND
7202 -- : BFD_RELOC_LARCH_SOP_IF_ELSE
7203 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_5
7204 -- : BFD_RELOC_LARCH_SOP_POP_32_U_10_12
7205 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_12
7206 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_16
7207 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_16_S2
7208 -- : BFD_RELOC_LARCH_SOP_POP_32_S_5_20
7209 -- : BFD_RELOC_LARCH_SOP_POP_32_S_0_5_10_16_S2
7210 -- : BFD_RELOC_LARCH_SOP_POP_32_S_0_10_10_16_S2
7211 -- : BFD_RELOC_LARCH_SOP_POP_32_U
7212 -- : BFD_RELOC_LARCH_ADD8
7213 -- : BFD_RELOC_LARCH_ADD16
7214 -- : BFD_RELOC_LARCH_ADD24
7215 -- : BFD_RELOC_LARCH_ADD32
7216 -- : BFD_RELOC_LARCH_ADD64
7217 -- : BFD_RELOC_LARCH_SUB8
7218 -- : BFD_RELOC_LARCH_SUB16
7219 -- : BFD_RELOC_LARCH_SUB24
7220 -- : BFD_RELOC_LARCH_SUB32
7221 -- : BFD_RELOC_LARCH_SUB64
7222     LARCH relocations.
7223
7224
7225     typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
7226
72272.10.2.2 'bfd_reloc_type_lookup'
7228................................
7229
7230*Synopsis*
7231     reloc_howto_type *bfd_reloc_type_lookup
7232        (bfd *abfd, bfd_reloc_code_real_type code);
7233     reloc_howto_type *bfd_reloc_name_lookup
7234        (bfd *abfd, const char *reloc_name);
7235   *Description*
7236Return a pointer to a howto structure which, when invoked, will perform
7237the relocation CODE on data from the architecture noted.
7238
72392.10.2.3 'bfd_default_reloc_type_lookup'
7240........................................
7241
7242*Synopsis*
7243     reloc_howto_type *bfd_default_reloc_type_lookup
7244        (bfd *abfd, bfd_reloc_code_real_type  code);
7245   *Description*
7246Provides a default relocation lookup routine for any architecture.
7247
72482.10.2.4 'bfd_get_reloc_code_name'
7249..................................
7250
7251*Synopsis*
7252     const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code);
7253   *Description*
7254Provides a printable name for the supplied relocation code.  Useful
7255mainly for printing error messages.
7256
72572.10.2.5 'bfd_generic_relax_section'
7258....................................
7259
7260*Synopsis*
7261     bool bfd_generic_relax_section
7262        (bfd *abfd,
7263         asection *section,
7264         struct bfd_link_info *,
7265         bool *);
7266   *Description*
7267Provides default handling for relaxing for back ends which don't do
7268relaxing.
7269
72702.10.2.6 'bfd_generic_gc_sections'
7271..................................
7272
7273*Synopsis*
7274     bool bfd_generic_gc_sections
7275        (bfd *, struct bfd_link_info *);
7276   *Description*
7277Provides default handling for relaxing for back ends which don't do
7278section gc - i.e., does nothing.
7279
72802.10.2.7 'bfd_generic_lookup_section_flags'
7281...........................................
7282
7283*Synopsis*
7284     bool bfd_generic_lookup_section_flags
7285        (struct bfd_link_info *, struct flag_info *, asection *);
7286   *Description*
7287Provides default handling for section flags lookup - i.e., does nothing.
7288Returns FALSE if the section should be omitted, otherwise TRUE.
7289
72902.10.2.8 'bfd_generic_merge_sections'
7291.....................................
7292
7293*Synopsis*
7294     bool bfd_generic_merge_sections
7295        (bfd *, struct bfd_link_info *);
7296   *Description*
7297Provides default handling for SEC_MERGE section merging for back ends
7298which don't have SEC_MERGE support - i.e., does nothing.
7299
73002.10.2.9 'bfd_generic_get_relocated_section_contents'
7301.....................................................
7302
7303*Synopsis*
7304     bfd_byte *bfd_generic_get_relocated_section_contents
7305        (bfd *abfd,
7306         struct bfd_link_info *link_info,
7307         struct bfd_link_order *link_order,
7308         bfd_byte *data,
7309         bool relocatable,
7310         asymbol **symbols);
7311   *Description*
7312Provides default handling of relocation effort for back ends which can't
7313be bothered to do it efficiently.
7314
73152.10.2.10 '_bfd_generic_set_reloc'
7316..................................
7317
7318*Synopsis*
7319     void _bfd_generic_set_reloc
7320        (bfd *abfd,
7321         sec_ptr section,
7322         arelent **relptr,
7323         unsigned int count);
7324   *Description*
7325Installs a new set of internal relocations in SECTION.
7326
73272.10.2.11 '_bfd_unrecognized_reloc'
7328...................................
7329
7330*Synopsis*
7331     bool _bfd_unrecognized_reloc
7332        (bfd * abfd,
7333         sec_ptr section,
7334         unsigned int r_type);
7335   *Description*
7336Reports an unrecognized reloc.  Written as a function in order to reduce
7337code duplication.  Returns FALSE so that it can be called from a return
7338statement.
7339
7340
7341File: bfd.info,  Node: Core Files,  Next: Targets,  Prev: Relocations,  Up: BFD front end
7342
73432.11 Core files
7344===============
7345
73462.11.1 Core file functions
7347--------------------------
7348
7349*Description*
7350These are functions pertaining to core files.
7351
73522.11.1.1 'bfd_core_file_failing_command'
7353........................................
7354
7355*Synopsis*
7356     const char *bfd_core_file_failing_command (bfd *abfd);
7357   *Description*
7358Return a read-only string explaining which program was running when it
7359failed and produced the core file ABFD.
7360
73612.11.1.2 'bfd_core_file_failing_signal'
7362.......................................
7363
7364*Synopsis*
7365     int bfd_core_file_failing_signal (bfd *abfd);
7366   *Description*
7367Returns the signal number which caused the core dump which generated the
7368file the BFD ABFD is attached to.
7369
73702.11.1.3 'bfd_core_file_pid'
7371............................
7372
7373*Synopsis*
7374     int bfd_core_file_pid (bfd *abfd);
7375   *Description*
7376Returns the PID of the process the core dump the BFD ABFD is attached to
7377was generated from.
7378
73792.11.1.4 'core_file_matches_executable_p'
7380.........................................
7381
7382*Synopsis*
7383     bool core_file_matches_executable_p
7384        (bfd *core_bfd, bfd *exec_bfd);
7385   *Description*
7386Return 'TRUE' if the core file attached to CORE_BFD was generated by a
7387run of the executable file attached to EXEC_BFD, 'FALSE' otherwise.
7388
73892.11.1.5 'generic_core_file_matches_executable_p'
7390.................................................
7391
7392*Synopsis*
7393     bool generic_core_file_matches_executable_p
7394        (bfd *core_bfd, bfd *exec_bfd);
7395   *Description*
7396Return TRUE if the core file attached to CORE_BFD was generated by a run
7397of the executable file attached to EXEC_BFD.  The match is based on
7398executable basenames only.
7399
7400   Note: When not able to determine the core file failing command or the
7401executable name, we still return TRUE even though we're not sure that
7402core file and executable match.  This is to avoid generating a false
7403warning in situations where we really don't know whether they match or
7404not.
7405
7406
7407File: bfd.info,  Node: Targets,  Next: Architectures,  Prev: Core Files,  Up: BFD front end
7408
74092.12 Targets
7410============
7411
7412*Description*
7413Each port of BFD to a different machine requires the creation of a
7414target back end.  All the back end provides to the root part of BFD is a
7415structure containing pointers to functions which perform certain low
7416level operations on files.  BFD translates the applications's requests
7417through a pointer into calls to the back end routines.
7418
7419   When a file is opened with 'bfd_openr', its format and target are
7420unknown.  BFD uses various mechanisms to determine how to interpret the
7421file.  The operations performed are:
7422
7423   * Create a BFD by calling the internal routine '_bfd_new_bfd', then
7424     call 'bfd_find_target' with the target string supplied to
7425     'bfd_openr' and the new BFD pointer.
7426
7427   * If a null target string was provided to 'bfd_find_target', look up
7428     the environment variable 'GNUTARGET' and use that as the target
7429     string.
7430
7431   * If the target string is still 'NULL', or the target string is
7432     'default', then use the first item in the target vector as the
7433     target type, and set 'target_defaulted' in the BFD to cause
7434     'bfd_check_format' to loop through all the targets.  *Note
7435     bfd_target::.  *Note Formats::.
7436
7437   * Otherwise, inspect the elements in the target vector one by one,
7438     until a match on target name is found.  When found, use it.
7439
7440   * Otherwise return the error 'bfd_error_invalid_target' to
7441     'bfd_openr'.
7442
7443   * 'bfd_openr' attempts to open the file using 'bfd_open_file', and
7444     returns the BFD.
7445   Once the BFD has been opened and the target selected, the file format
7446may be determined.  This is done by calling 'bfd_check_format' on the
7447BFD with a suggested format.  If 'target_defaulted' has been set, each
7448possible target type is tried to see if it recognizes the specified
7449format.  'bfd_check_format' returns 'TRUE' when the caller guesses
7450right.
7451* Menu:
7452
7453* bfd_target::
7454
7455
7456File: bfd.info,  Node: bfd_target,  Prev: Targets,  Up: Targets
7457
74582.12.1 bfd_target
7459-----------------
7460
7461*Description*
7462This structure contains everything that BFD knows about a target.  It
7463includes things like its byte order, name, and which routines to call to
7464do various operations.
7465
7466   Every BFD points to a target structure with its 'xvec' member.
7467
7468   The macros below are used to dispatch to functions through the
7469'bfd_target' vector.  They are used in a number of macros further down
7470in 'bfd.h', and are also used when calling various routines by hand
7471inside the BFD implementation.  The ARGLIST argument must be
7472parenthesized; it contains all the arguments to the called function.
7473
7474   They make the documentation (more) unpleasant to read, so if someone
7475wants to fix this and not break the above, please do.
7476     #define BFD_SEND(bfd, message, arglist) \
7477       ((*((bfd)->xvec->message)) arglist)
7478
7479     #ifdef DEBUG_BFD_SEND
7480     #undef BFD_SEND
7481     #define BFD_SEND(bfd, message, arglist) \
7482       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7483         ((*((bfd)->xvec->message)) arglist) : \
7484         (bfd_assert (__FILE__,__LINE__), NULL))
7485     #endif
7486   For operations which index on the BFD format:
7487     #define BFD_SEND_FMT(bfd, message, arglist) \
7488       (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
7489
7490     #ifdef DEBUG_BFD_SEND
7491     #undef BFD_SEND_FMT
7492     #define BFD_SEND_FMT(bfd, message, arglist) \
7493       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7494        (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
7495        (bfd_assert (__FILE__,__LINE__), NULL))
7496     #endif
7497
7498     /* Defined to TRUE if unused section symbol should be kept.  */
7499     #ifndef TARGET_KEEP_UNUSED_SECTION_SYMBOLS
7500     #define TARGET_KEEP_UNUSED_SECTION_SYMBOLS true
7501     #endif
7502
7503   This is the structure which defines the type of BFD this is.  The
7504'xvec' member of the struct 'bfd' itself points here.  Each module that
7505implements access to a different target under BFD, defines one of these.
7506
7507   FIXME, these names should be rationalised with the names of the entry
7508points which call them.  Too bad we can't have one macro to define them
7509both!
7510     enum bfd_flavour
7511     {
7512       /* N.B. Update bfd_flavour_name if you change this.  */
7513       bfd_target_unknown_flavour,
7514       bfd_target_aout_flavour,
7515       bfd_target_coff_flavour,
7516       bfd_target_ecoff_flavour,
7517       bfd_target_xcoff_flavour,
7518       bfd_target_elf_flavour,
7519       bfd_target_tekhex_flavour,
7520       bfd_target_srec_flavour,
7521       bfd_target_verilog_flavour,
7522       bfd_target_ihex_flavour,
7523       bfd_target_som_flavour,
7524       bfd_target_os9k_flavour,
7525       bfd_target_versados_flavour,
7526       bfd_target_msdos_flavour,
7527       bfd_target_ovax_flavour,
7528       bfd_target_evax_flavour,
7529       bfd_target_mmo_flavour,
7530       bfd_target_mach_o_flavour,
7531       bfd_target_pef_flavour,
7532       bfd_target_pef_xlib_flavour,
7533       bfd_target_sym_flavour
7534     };
7535
7536     enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
7537
7538     /* Forward declaration.  */
7539     typedef struct bfd_link_info _bfd_link_info;
7540
7541     /* Forward declaration.  */
7542     typedef struct flag_info flag_info;
7543
7544     typedef void (*bfd_cleanup) (bfd *);
7545
7546     typedef struct bfd_target
7547     {
7548       /* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  */
7549       const char *name;
7550
7551      /* The "flavour" of a back end is a general indication about
7552         the contents of a file.  */
7553       enum bfd_flavour flavour;
7554
7555       /* The order of bytes within the data area of a file.  */
7556       enum bfd_endian byteorder;
7557
7558      /* The order of bytes within the header parts of a file.  */
7559       enum bfd_endian header_byteorder;
7560
7561       /* A mask of all the flags which an executable may have set -
7562          from the set BFD_NO_FLAGS, HAS_RELOC, ...D_PAGED.  */
7563       flagword object_flags;
7564
7565      /* A mask of all the flags which a section may have set - from
7566         the set SEC_NO_FLAGS, SEC_ALLOC, ...SET_NEVER_LOAD.  */
7567       flagword section_flags;
7568
7569      /* The character normally found at the front of a symbol.
7570         (if any), perhaps `_'.  */
7571       char symbol_leading_char;
7572
7573      /* The pad character for file names within an archive header.  */
7574       char ar_pad_char;
7575
7576       /* The maximum number of characters in an archive header.  */
7577       unsigned char ar_max_namelen;
7578
7579       /* How well this target matches, used to select between various
7580          possible targets when more than one target matches.  */
7581       unsigned char match_priority;
7582
7583      /* TRUE if unused section symbols should be kept.  */
7584       bool keep_unused_section_symbols;
7585
7586       /* Entries for byte swapping for data. These are different from the
7587          other entry points, since they don't take a BFD as the first argument.
7588          Certain other handlers could do the same.  */
7589       uint64_t       (*bfd_getx64) (const void *);
7590       int64_t        (*bfd_getx_signed_64) (const void *);
7591       void           (*bfd_putx64) (uint64_t, void *);
7592       bfd_vma        (*bfd_getx32) (const void *);
7593       bfd_signed_vma (*bfd_getx_signed_32) (const void *);
7594       void           (*bfd_putx32) (bfd_vma, void *);
7595       bfd_vma        (*bfd_getx16) (const void *);
7596       bfd_signed_vma (*bfd_getx_signed_16) (const void *);
7597       void           (*bfd_putx16) (bfd_vma, void *);
7598
7599       /* Byte swapping for the headers.  */
7600       uint64_t       (*bfd_h_getx64) (const void *);
7601       int64_t        (*bfd_h_getx_signed_64) (const void *);
7602       void           (*bfd_h_putx64) (uint64_t, void *);
7603       bfd_vma        (*bfd_h_getx32) (const void *);
7604       bfd_signed_vma (*bfd_h_getx_signed_32) (const void *);
7605       void           (*bfd_h_putx32) (bfd_vma, void *);
7606       bfd_vma        (*bfd_h_getx16) (const void *);
7607       bfd_signed_vma (*bfd_h_getx_signed_16) (const void *);
7608       void           (*bfd_h_putx16) (bfd_vma, void *);
7609
7610       /* Format dependent routines: these are vectors of entry points
7611          within the target vector structure, one for each format to check.  */
7612
7613       /* Check the format of a file being read.  Return a bfd_cleanup on
7614          success or zero on failure.  */
7615       bfd_cleanup (*_bfd_check_format[bfd_type_end]) (bfd *);
7616
7617       /* Set the format of a file being written.  */
7618       bool (*_bfd_set_format[bfd_type_end]) (bfd *);
7619
7620       /* Write cached information into a file being written, at bfd_close.  */
7621       bool (*_bfd_write_contents[bfd_type_end]) (bfd *);
7622
7623   The general target vector.  These vectors are initialized using the
7624BFD_JUMP_TABLE macros.
7625
7626       /* Generic entry points.  */
7627     #define BFD_JUMP_TABLE_GENERIC(NAME) \
7628       NAME##_close_and_cleanup, \
7629       NAME##_bfd_free_cached_info, \
7630       NAME##_new_section_hook, \
7631       NAME##_get_section_contents, \
7632       NAME##_get_section_contents_in_window
7633
7634       /* Called when the BFD is being closed to do any necessary cleanup.  */
7635       bool (*_close_and_cleanup) (bfd *);
7636       /* Ask the BFD to free all cached information.  */
7637       bool (*_bfd_free_cached_info) (bfd *);
7638       /* Called when a new section is created.  */
7639       bool (*_new_section_hook) (bfd *, sec_ptr);
7640       /* Read the contents of a section.  */
7641       bool (*_bfd_get_section_contents) (bfd *, sec_ptr, void *, file_ptr,
7642                                          bfd_size_type);
7643       bool (*_bfd_get_section_contents_in_window) (bfd *, sec_ptr, bfd_window *,
7644                                                    file_ptr, bfd_size_type);
7645
7646       /* Entry points to copy private data.  */
7647     #define BFD_JUMP_TABLE_COPY(NAME) \
7648       NAME##_bfd_copy_private_bfd_data, \
7649       NAME##_bfd_merge_private_bfd_data, \
7650       _bfd_generic_init_private_section_data, \
7651       NAME##_bfd_copy_private_section_data, \
7652       NAME##_bfd_copy_private_symbol_data, \
7653       NAME##_bfd_copy_private_header_data, \
7654       NAME##_bfd_set_private_flags, \
7655       NAME##_bfd_print_private_bfd_data
7656
7657       /* Called to copy BFD general private data from one object file
7658          to another.  */
7659       bool (*_bfd_copy_private_bfd_data) (bfd *, bfd *);
7660       /* Called to merge BFD general private data from one object file
7661          to a common output file when linking.  */
7662       bool (*_bfd_merge_private_bfd_data) (bfd *, struct bfd_link_info *);
7663       /* Called to initialize BFD private section data from one object file
7664          to another.  */
7665     #define bfd_init_private_section_data(ibfd, isec, obfd, osec, link_info) \
7666            BFD_SEND (obfd, _bfd_init_private_section_data, \
7667                      (ibfd, isec, obfd, osec, link_info))
7668       bool (*_bfd_init_private_section_data) (bfd *, sec_ptr, bfd *, sec_ptr,
7669                                               struct bfd_link_info *);
7670       /* Called to copy BFD private section data from one object file
7671          to another.  */
7672       bool (*_bfd_copy_private_section_data) (bfd *, sec_ptr, bfd *, sec_ptr);
7673       /* Called to copy BFD private symbol data from one symbol
7674          to another.  */
7675       bool (*_bfd_copy_private_symbol_data) (bfd *, asymbol *,
7676                                              bfd *, asymbol *);
7677       /* Called to copy BFD private header data from one object file
7678          to another.  */
7679       bool (*_bfd_copy_private_header_data) (bfd *, bfd *);
7680       /* Called to set private backend flags.  */
7681       bool (*_bfd_set_private_flags) (bfd *, flagword);
7682
7683       /* Called to print private BFD data.  */
7684       bool (*_bfd_print_private_bfd_data) (bfd *, void *);
7685
7686       /* Core file entry points.  */
7687     #define BFD_JUMP_TABLE_CORE(NAME) \
7688       NAME##_core_file_failing_command, \
7689       NAME##_core_file_failing_signal, \
7690       NAME##_core_file_matches_executable_p, \
7691       NAME##_core_file_pid
7692
7693       char *(*_core_file_failing_command) (bfd *);
7694       int   (*_core_file_failing_signal) (bfd *);
7695       bool  (*_core_file_matches_executable_p) (bfd *, bfd *);
7696       int   (*_core_file_pid) (bfd *);
7697
7698       /* Archive entry points.  */
7699     #define BFD_JUMP_TABLE_ARCHIVE(NAME) \
7700       NAME##_slurp_armap, \
7701       NAME##_slurp_extended_name_table, \
7702       NAME##_construct_extended_name_table, \
7703       NAME##_truncate_arname, \
7704       NAME##_write_armap, \
7705       NAME##_read_ar_hdr, \
7706       NAME##_write_ar_hdr, \
7707       NAME##_openr_next_archived_file, \
7708       NAME##_get_elt_at_index, \
7709       NAME##_generic_stat_arch_elt, \
7710       NAME##_update_armap_timestamp
7711
7712       bool (*_bfd_slurp_armap) (bfd *);
7713       bool (*_bfd_slurp_extended_name_table) (bfd *);
7714       bool (*_bfd_construct_extended_name_table) (bfd *, char **,
7715                                                   bfd_size_type *,
7716                                                   const char **);
7717       void (*_bfd_truncate_arname) (bfd *, const char *, char *);
7718       bool (*write_armap) (bfd *, unsigned, struct orl *, unsigned, int);
7719       void *(*_bfd_read_ar_hdr_fn) (bfd *);
7720       bool (*_bfd_write_ar_hdr_fn) (bfd *, bfd *);
7721       bfd *(*openr_next_archived_file) (bfd *, bfd *);
7722     #define bfd_get_elt_at_index(b,i) \
7723            BFD_SEND (b, _bfd_get_elt_at_index, (b,i))
7724       bfd *(*_bfd_get_elt_at_index) (bfd *, symindex);
7725       int  (*_bfd_stat_arch_elt) (bfd *, struct stat *);
7726       bool (*_bfd_update_armap_timestamp) (bfd *);
7727
7728       /* Entry points used for symbols.  */
7729     #define BFD_JUMP_TABLE_SYMBOLS(NAME) \
7730       NAME##_get_symtab_upper_bound, \
7731       NAME##_canonicalize_symtab, \
7732       NAME##_make_empty_symbol, \
7733       NAME##_print_symbol, \
7734       NAME##_get_symbol_info, \
7735       NAME##_get_symbol_version_string, \
7736       NAME##_bfd_is_local_label_name, \
7737       NAME##_bfd_is_target_special_symbol, \
7738       NAME##_get_lineno, \
7739       NAME##_find_nearest_line, \
7740       NAME##_find_line, \
7741       NAME##_find_inliner_info, \
7742       NAME##_bfd_make_debug_symbol, \
7743       NAME##_read_minisymbols, \
7744       NAME##_minisymbol_to_symbol
7745
7746       long (*_bfd_get_symtab_upper_bound) (bfd *);
7747       long (*_bfd_canonicalize_symtab) (bfd *, struct bfd_symbol **);
7748       struct bfd_symbol *
7749            (*_bfd_make_empty_symbol) (bfd *);
7750       void (*_bfd_print_symbol) (bfd *, void *, struct bfd_symbol *,
7751                                  bfd_print_symbol_type);
7752     #define bfd_print_symbol(b,p,s,e) \
7753            BFD_SEND (b, _bfd_print_symbol, (b,p,s,e))
7754       void  (*_bfd_get_symbol_info) (bfd *, struct bfd_symbol *, symbol_info *);
7755     #define bfd_get_symbol_info(b,p,e) \
7756            BFD_SEND (b, _bfd_get_symbol_info, (b,p,e))
7757       const char *
7758            (*_bfd_get_symbol_version_string) (bfd *, struct bfd_symbol *,
7759                                               bool, bool *);
7760     #define bfd_get_symbol_version_string(b,s,p,h) \
7761            BFD_SEND (b, _bfd_get_symbol_version_string, (b,s,p,h))
7762       bool (*_bfd_is_local_label_name) (bfd *, const char *);
7763       bool (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
7764       alent *
7765            (*_get_lineno) (bfd *, struct bfd_symbol *);
7766       bool (*_bfd_find_nearest_line) (bfd *, struct bfd_symbol **,
7767                                       struct bfd_section *, bfd_vma,
7768                                       const char **, const char **,
7769                                       unsigned int *, unsigned int *);
7770       bool (*_bfd_find_line) (bfd *, struct bfd_symbol **,
7771                               struct bfd_symbol *, const char **,
7772                               unsigned int *);
7773       bool (*_bfd_find_inliner_info)
7774         (bfd *, const char **, const char **, unsigned int *);
7775      /* Back-door to allow format-aware applications to create debug symbols
7776         while using BFD for everything else.  Currently used by the assembler
7777         when creating COFF files.  */
7778       asymbol *
7779            (*_bfd_make_debug_symbol) (bfd *, void *, unsigned long size);
7780     #define bfd_read_minisymbols(b, d, m, s) \
7781            BFD_SEND (b, _read_minisymbols, (b, d, m, s))
7782       long (*_read_minisymbols) (bfd *, bool, void **, unsigned int *);
7783     #define bfd_minisymbol_to_symbol(b, d, m, f) \
7784            BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
7785       asymbol *
7786            (*_minisymbol_to_symbol) (bfd *, bool, const void *, asymbol *);
7787
7788       /* Routines for relocs.  */
7789     #define BFD_JUMP_TABLE_RELOCS(NAME) \
7790       NAME##_get_reloc_upper_bound, \
7791       NAME##_canonicalize_reloc, \
7792       NAME##_set_reloc, \
7793       NAME##_bfd_reloc_type_lookup, \
7794       NAME##_bfd_reloc_name_lookup
7795
7796       long (*_get_reloc_upper_bound) (bfd *, sec_ptr);
7797       long (*_bfd_canonicalize_reloc) (bfd *, sec_ptr, arelent **,
7798                                        struct bfd_symbol **);
7799       void (*_bfd_set_reloc) (bfd *, sec_ptr, arelent **, unsigned int);
7800       /* See documentation on reloc types.  */
7801       reloc_howto_type *
7802            (*reloc_type_lookup) (bfd *, bfd_reloc_code_real_type);
7803       reloc_howto_type *
7804            (*reloc_name_lookup) (bfd *, const char *);
7805
7806       /* Routines used when writing an object file.  */
7807     #define BFD_JUMP_TABLE_WRITE(NAME) \
7808       NAME##_set_arch_mach, \
7809       NAME##_set_section_contents
7810
7811       bool (*_bfd_set_arch_mach) (bfd *, enum bfd_architecture,
7812                                          unsigned long);
7813       bool (*_bfd_set_section_contents) (bfd *, sec_ptr, const void *,
7814                                          file_ptr, bfd_size_type);
7815
7816       /* Routines used by the linker.  */
7817     #define BFD_JUMP_TABLE_LINK(NAME) \
7818       NAME##_sizeof_headers, \
7819       NAME##_bfd_get_relocated_section_contents, \
7820       NAME##_bfd_relax_section, \
7821       NAME##_bfd_link_hash_table_create, \
7822       NAME##_bfd_link_add_symbols, \
7823       NAME##_bfd_link_just_syms, \
7824       NAME##_bfd_copy_link_hash_symbol_type, \
7825       NAME##_bfd_final_link, \
7826       NAME##_bfd_link_split_section, \
7827       NAME##_bfd_link_check_relocs, \
7828       NAME##_bfd_gc_sections, \
7829       NAME##_bfd_lookup_section_flags, \
7830       NAME##_bfd_merge_sections, \
7831       NAME##_bfd_is_group_section, \
7832       NAME##_bfd_group_name, \
7833       NAME##_bfd_discard_group, \
7834       NAME##_section_already_linked, \
7835       NAME##_bfd_define_common_symbol, \
7836       NAME##_bfd_link_hide_symbol, \
7837       NAME##_bfd_define_start_stop
7838
7839       int  (*_bfd_sizeof_headers) (bfd *, struct bfd_link_info *);
7840       bfd_byte *
7841            (*_bfd_get_relocated_section_contents) (bfd *,
7842                                                    struct bfd_link_info *,
7843                                                    struct bfd_link_order *,
7844                                                    bfd_byte *, bool,
7845                                                    struct bfd_symbol **);
7846
7847       bool (*_bfd_relax_section) (bfd *, struct bfd_section *,
7848                                   struct bfd_link_info *, bool *);
7849
7850       /* Create a hash table for the linker.  Different backends store
7851          different information in this table.  */
7852       struct bfd_link_hash_table *
7853            (*_bfd_link_hash_table_create) (bfd *);
7854
7855       /* Add symbols from this object file into the hash table.  */
7856       bool (*_bfd_link_add_symbols) (bfd *, struct bfd_link_info *);
7857
7858       /* Indicate that we are only retrieving symbol values from this section.  */
7859       void (*_bfd_link_just_syms) (asection *, struct bfd_link_info *);
7860
7861       /* Copy the symbol type and other attributes for a linker script
7862          assignment of one symbol to another.  */
7863     #define bfd_copy_link_hash_symbol_type(b, t, f) \
7864            BFD_SEND (b, _bfd_copy_link_hash_symbol_type, (b, t, f))
7865       void (*_bfd_copy_link_hash_symbol_type) (bfd *,
7866                                                struct bfd_link_hash_entry *,
7867                                                struct bfd_link_hash_entry *);
7868
7869       /* Do a link based on the link_order structures attached to each
7870          section of the BFD.  */
7871       bool (*_bfd_final_link) (bfd *, struct bfd_link_info *);
7872
7873       /* Should this section be split up into smaller pieces during linking.  */
7874       bool (*_bfd_link_split_section) (bfd *, struct bfd_section *);
7875
7876       /* Check the relocations in the bfd for validity.  */
7877       bool (* _bfd_link_check_relocs)(bfd *, struct bfd_link_info *);
7878
7879       /* Remove sections that are not referenced from the output.  */
7880       bool (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
7881
7882       /* Sets the bitmask of allowed and disallowed section flags.  */
7883       bool (*_bfd_lookup_section_flags) (struct bfd_link_info *,
7884                                          struct flag_info *, asection *);
7885
7886       /* Attempt to merge SEC_MERGE sections.  */
7887       bool (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
7888
7889       /* Is this section a member of a group?  */
7890       bool (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
7891
7892       /* The group name, if section is a member of a group.  */
7893       const char *(*_bfd_group_name) (bfd *, const struct bfd_section *);
7894
7895       /* Discard members of a group.  */
7896       bool (*_bfd_discard_group) (bfd *, struct bfd_section *);
7897
7898       /* Check if SEC has been already linked during a reloceatable or
7899          final link.  */
7900       bool (*_section_already_linked) (bfd *, asection *,
7901                                        struct bfd_link_info *);
7902
7903       /* Define a common symbol.  */
7904       bool (*_bfd_define_common_symbol) (bfd *, struct bfd_link_info *,
7905                                          struct bfd_link_hash_entry *);
7906
7907       /* Hide a symbol.  */
7908       void (*_bfd_link_hide_symbol) (bfd *, struct bfd_link_info *,
7909                                      struct bfd_link_hash_entry *);
7910
7911       /* Define a __start, __stop, .startof. or .sizeof. symbol.  */
7912       struct bfd_link_hash_entry *
7913            (*_bfd_define_start_stop) (struct bfd_link_info *, const char *,
7914                                       asection *);
7915
7916       /* Routines to handle dynamic symbols and relocs.  */
7917     #define BFD_JUMP_TABLE_DYNAMIC(NAME) \
7918       NAME##_get_dynamic_symtab_upper_bound, \
7919       NAME##_canonicalize_dynamic_symtab, \
7920       NAME##_get_synthetic_symtab, \
7921       NAME##_get_dynamic_reloc_upper_bound, \
7922       NAME##_canonicalize_dynamic_reloc
7923
7924       /* Get the amount of memory required to hold the dynamic symbols.  */
7925       long (*_bfd_get_dynamic_symtab_upper_bound) (bfd *);
7926       /* Read in the dynamic symbols.  */
7927       long (*_bfd_canonicalize_dynamic_symtab) (bfd *, struct bfd_symbol **);
7928       /* Create synthetized symbols.  */
7929       long (*_bfd_get_synthetic_symtab) (bfd *, long, struct bfd_symbol **,
7930                                          long, struct bfd_symbol **,
7931                                          struct bfd_symbol **);
7932       /* Get the amount of memory required to hold the dynamic relocs.  */
7933       long (*_bfd_get_dynamic_reloc_upper_bound) (bfd *);
7934       /* Read in the dynamic relocs.  */
7935       long (*_bfd_canonicalize_dynamic_reloc) (bfd *, arelent **,
7936                                                struct bfd_symbol **);
7937
7938   A pointer to an alternative bfd_target in case the current one is not
7939satisfactory.  This can happen when the target cpu supports both big and
7940little endian code, and target chosen by the linker has the wrong
7941endianness.  The function open_output() in ld/ldlang.c uses this field
7942to find an alternative output format that is suitable.
7943       /* Opposite endian version of this target.  */
7944       const struct bfd_target *alternative_target;
7945
7946       /* Data for use by back-end routines, which isn't
7947          generic enough to belong in this structure.  */
7948       const void *backend_data;
7949
7950     } bfd_target;
7951
7952     static inline const char *
7953     bfd_get_target (const bfd *abfd)
7954     {
7955       return abfd->xvec->name;
7956     }
7957
7958     static inline enum bfd_flavour
7959     bfd_get_flavour (const bfd *abfd)
7960     {
7961       return abfd->xvec->flavour;
7962     }
7963
7964     static inline flagword
7965     bfd_applicable_file_flags (const bfd *abfd)
7966     {
7967       return abfd->xvec->object_flags;
7968     }
7969
7970     static inline bool
7971     bfd_family_coff (const bfd *abfd)
7972     {
7973       return (bfd_get_flavour (abfd) == bfd_target_coff_flavour
7974               || bfd_get_flavour (abfd) == bfd_target_xcoff_flavour);
7975     }
7976
7977     static inline bool
7978     bfd_big_endian (const bfd *abfd)
7979     {
7980       return abfd->xvec->byteorder == BFD_ENDIAN_BIG;
7981     }
7982     static inline bool
7983     bfd_little_endian (const bfd *abfd)
7984     {
7985       return abfd->xvec->byteorder == BFD_ENDIAN_LITTLE;
7986     }
7987
7988     static inline bool
7989     bfd_header_big_endian (const bfd *abfd)
7990     {
7991       return abfd->xvec->header_byteorder == BFD_ENDIAN_BIG;
7992     }
7993
7994     static inline bool
7995     bfd_header_little_endian (const bfd *abfd)
7996     {
7997       return abfd->xvec->header_byteorder == BFD_ENDIAN_LITTLE;
7998     }
7999
8000     static inline flagword
8001     bfd_applicable_section_flags (const bfd *abfd)
8002     {
8003       return abfd->xvec->section_flags;
8004     }
8005
8006     static inline char
8007     bfd_get_symbol_leading_char (const bfd *abfd)
8008     {
8009       return abfd->xvec->symbol_leading_char;
8010     }
8011
8012     static inline enum bfd_flavour
8013     bfd_asymbol_flavour (const asymbol *sy)
8014     {
8015       if ((sy->flags & BSF_SYNTHETIC) != 0)
8016         return bfd_target_unknown_flavour;
8017       return sy->the_bfd->xvec->flavour;
8018     }
8019
8020     static inline bool
8021     bfd_keep_unused_section_symbols (const bfd *abfd)
8022     {
8023       return abfd->xvec->keep_unused_section_symbols;
8024     }
8025
8026
80272.12.1.1 'bfd_set_default_target'
8028.................................
8029
8030*Synopsis*
8031     bool bfd_set_default_target (const char *name);
8032   *Description*
8033Set the default target vector to use when recognizing a BFD. This takes
8034the name of the target, which may be a BFD target name or a
8035configuration triplet.
8036
80372.12.1.2 'bfd_find_target'
8038..........................
8039
8040*Synopsis*
8041     const bfd_target *bfd_find_target (const char *target_name, bfd *abfd);
8042   *Description*
8043Return a pointer to the transfer vector for the object target named
8044TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
8045environment variable 'GNUTARGET'; if that is null or not defined, then
8046choose the first entry in the target list.  Passing in the string
8047"default" or setting the environment variable to "default" will cause
8048the first entry in the target list to be returned, and
8049"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
8050causes 'bfd_check_format' to loop over all the targets to find the one
8051that matches the file being read.
8052
80532.12.1.3 'bfd_get_target_info'
8054..............................
8055
8056*Synopsis*
8057     const bfd_target *bfd_get_target_info (const char *target_name,
8058         bfd *abfd,
8059         bool *is_bigendian,
8060         int *underscoring,
8061         const char **def_target_arch);
8062   *Description*
8063Return a pointer to the transfer vector for the object target named
8064TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
8065environment variable 'GNUTARGET'; if that is null or not defined, then
8066choose the first entry in the target list.  Passing in the string
8067"default" or setting the environment variable to "default" will cause
8068the first entry in the target list to be returned, and
8069"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
8070causes 'bfd_check_format' to loop over all the targets to find the one
8071that matches the file being read.  If IS_BIGENDIAN is not 'NULL', then
8072set this value to target's endian mode.  True for big-endian, FALSE for
8073little-endian or for invalid target.  If UNDERSCORING is not 'NULL',
8074then set this value to target's underscoring mode.  Zero for
8075none-underscoring, -1 for invalid target, else the value of target
8076vector's symbol underscoring.  If DEF_TARGET_ARCH is not 'NULL', then
8077set it to the architecture string specified by the target_name.
8078
80792.12.1.4 'bfd_target_list'
8080..........................
8081
8082*Synopsis*
8083     const char ** bfd_target_list (void);
8084   *Description*
8085Return a freshly malloced NULL-terminated vector of the names of all the
8086valid BFD targets.  Do not modify the names.
8087
80882.12.1.5 'bfd_iterate_over_targets'
8089...................................
8090
8091*Synopsis*
8092     const bfd_target *bfd_iterate_over_targets
8093        (int (*func) (const bfd_target *, void *),
8094         void *data);
8095   *Description*
8096Call FUNC for each target in the list of BFD target vectors, passing
8097DATA to FUNC.  Stop iterating if FUNC returns a non-zero result, and
8098return that target vector.  Return NULL if FUNC always returns zero.
8099
81002.12.1.6 'bfd_flavour_name'
8101...........................
8102
8103*Synopsis*
8104     const char *bfd_flavour_name (enum bfd_flavour flavour);
8105   *Description*
8106Return the string form of FLAVOUR.
8107
8108
8109File: bfd.info,  Node: Architectures,  Next: Opening and Closing,  Prev: Targets,  Up: BFD front end
8110
81112.13 Architectures
8112==================
8113
8114BFD keeps one atom in a BFD describing the architecture of the data
8115attached to the BFD: a pointer to a 'bfd_arch_info_type'.
8116
8117   Pointers to structures can be requested independently of a BFD so
8118that an architecture's information can be interrogated without access to
8119an open BFD.
8120
8121   The architecture information is provided by each architecture
8122package.  The set of default architectures is selected by the macro
8123'SELECT_ARCHITECTURES'.  This is normally set up in the
8124'config/TARGET.mt' file of your choice.  If the name is not defined,
8125then all the architectures supported are included.
8126
8127   When BFD starts up, all the architectures are called with an
8128initialize method.  It is up to the architecture back end to insert as
8129many items into the list of architectures as it wants to; generally this
8130would be one for each machine and one for the default case (an item with
8131a machine field of 0).
8132
8133   BFD's idea of an architecture is implemented in 'archures.c'.
8134
81352.13.1 bfd_architecture
8136-----------------------
8137
8138*Description*
8139This enum gives the object file's CPU architecture, in a global
8140sense--i.e., what processor family does it belong to?  Another field
8141indicates which processor within the family is in use.  The machine
8142gives a number which distinguishes different versions of the
8143architecture, containing, for example, 68020 for Motorola 68020.
8144     enum bfd_architecture
8145     {
8146       bfd_arch_unknown,   /* File arch not known.  */
8147       bfd_arch_obscure,   /* Arch known, not one of these.  */
8148       bfd_arch_m68k,      /* Motorola 68xxx.  */
8149     #define bfd_mach_m68000                1
8150     #define bfd_mach_m68008                2
8151     #define bfd_mach_m68010                3
8152     #define bfd_mach_m68020                4
8153     #define bfd_mach_m68030                5
8154     #define bfd_mach_m68040                6
8155     #define bfd_mach_m68060                7
8156     #define bfd_mach_cpu32                 8
8157     #define bfd_mach_fido                  9
8158     #define bfd_mach_mcf_isa_a_nodiv       10
8159     #define bfd_mach_mcf_isa_a             11
8160     #define bfd_mach_mcf_isa_a_mac         12
8161     #define bfd_mach_mcf_isa_a_emac        13
8162     #define bfd_mach_mcf_isa_aplus         14
8163     #define bfd_mach_mcf_isa_aplus_mac     15
8164     #define bfd_mach_mcf_isa_aplus_emac    16
8165     #define bfd_mach_mcf_isa_b_nousp       17
8166     #define bfd_mach_mcf_isa_b_nousp_mac   18
8167     #define bfd_mach_mcf_isa_b_nousp_emac  19
8168     #define bfd_mach_mcf_isa_b             20
8169     #define bfd_mach_mcf_isa_b_mac         21
8170     #define bfd_mach_mcf_isa_b_emac        22
8171     #define bfd_mach_mcf_isa_b_float       23
8172     #define bfd_mach_mcf_isa_b_float_mac   24
8173     #define bfd_mach_mcf_isa_b_float_emac  25
8174     #define bfd_mach_mcf_isa_c             26
8175     #define bfd_mach_mcf_isa_c_mac         27
8176     #define bfd_mach_mcf_isa_c_emac        28
8177     #define bfd_mach_mcf_isa_c_nodiv       29
8178     #define bfd_mach_mcf_isa_c_nodiv_mac   30
8179     #define bfd_mach_mcf_isa_c_nodiv_emac  31
8180       bfd_arch_vax,       /* DEC Vax.  */
8181
8182       bfd_arch_or1k,      /* OpenRISC 1000.  */
8183     #define bfd_mach_or1k          1
8184     #define bfd_mach_or1knd        2
8185
8186       bfd_arch_sparc,     /* SPARC.  */
8187     #define bfd_mach_sparc                 1
8188     /* The difference between v8plus and v9 is that v9 is a true 64 bit env.  */
8189     #define bfd_mach_sparc_sparclet        2
8190     #define bfd_mach_sparc_sparclite       3
8191     #define bfd_mach_sparc_v8plus          4
8192     #define bfd_mach_sparc_v8plusa         5 /* with ultrasparc add'ns.  */
8193     #define bfd_mach_sparc_sparclite_le    6
8194     #define bfd_mach_sparc_v9              7
8195     #define bfd_mach_sparc_v9a             8 /* with ultrasparc add'ns.  */
8196     #define bfd_mach_sparc_v8plusb         9 /* with cheetah add'ns.  */
8197     #define bfd_mach_sparc_v9b             10 /* with cheetah add'ns.  */
8198     #define bfd_mach_sparc_v8plusc         11 /* with UA2005 and T1 add'ns.  */
8199     #define bfd_mach_sparc_v9c             12 /* with UA2005 and T1 add'ns.  */
8200     #define bfd_mach_sparc_v8plusd         13 /* with UA2007 and T3 add'ns.  */
8201     #define bfd_mach_sparc_v9d             14 /* with UA2007 and T3 add'ns.  */
8202     #define bfd_mach_sparc_v8pluse         15 /* with OSA2001 and T4 add'ns (no IMA).  */
8203     #define bfd_mach_sparc_v9e             16 /* with OSA2001 and T4 add'ns (no IMA).  */
8204     #define bfd_mach_sparc_v8plusv         17 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
8205     #define bfd_mach_sparc_v9v             18 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
8206     #define bfd_mach_sparc_v8plusm         19 /* with OSA2015 and M7 add'ns.  */
8207     #define bfd_mach_sparc_v9m             20 /* with OSA2015 and M7 add'ns.  */
8208     #define bfd_mach_sparc_v8plusm8        21 /* with OSA2017 and M8 add'ns.  */
8209     #define bfd_mach_sparc_v9m8            22 /* with OSA2017 and M8 add'ns.  */
8210     /* Nonzero if MACH has the v9 instruction set.  */
8211     #define bfd_mach_sparc_v9_p(mach) \
8212       ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9m8 \
8213        && (mach) != bfd_mach_sparc_sparclite_le)
8214     /* Nonzero if MACH is a 64 bit sparc architecture.  */
8215     #define bfd_mach_sparc_64bit_p(mach) \
8216       ((mach) >= bfd_mach_sparc_v9 \
8217        && (mach) != bfd_mach_sparc_v8plusb \
8218        && (mach) != bfd_mach_sparc_v8plusc \
8219        && (mach) != bfd_mach_sparc_v8plusd \
8220        && (mach) != bfd_mach_sparc_v8pluse \
8221        && (mach) != bfd_mach_sparc_v8plusv \
8222        && (mach) != bfd_mach_sparc_v8plusm \
8223        && (mach) != bfd_mach_sparc_v8plusm8)
8224       bfd_arch_spu,       /* PowerPC SPU.  */
8225     #define bfd_mach_spu           256
8226       bfd_arch_mips,      /* MIPS Rxxxx.  */
8227     #define bfd_mach_mips3000              3000
8228     #define bfd_mach_mips3900              3900
8229     #define bfd_mach_mips4000              4000
8230     #define bfd_mach_mips4010              4010
8231     #define bfd_mach_mips4100              4100
8232     #define bfd_mach_mips4111              4111
8233     #define bfd_mach_mips4120              4120
8234     #define bfd_mach_mips4300              4300
8235     #define bfd_mach_mips4400              4400
8236     #define bfd_mach_mips4600              4600
8237     #define bfd_mach_mips4650              4650
8238     #define bfd_mach_mips5000              5000
8239     #define bfd_mach_mips5400              5400
8240     #define bfd_mach_mips5500              5500
8241     #define bfd_mach_mips5900              5900
8242     #define bfd_mach_mips6000              6000
8243     #define bfd_mach_mips7000              7000
8244     #define bfd_mach_mips8000              8000
8245     #define bfd_mach_mips9000              9000
8246     #define bfd_mach_mips10000             10000
8247     #define bfd_mach_mips12000             12000
8248     #define bfd_mach_mips14000             14000
8249     #define bfd_mach_mips16000             16000
8250     #define bfd_mach_mips16                16
8251     #define bfd_mach_mips5                 5
8252     #define bfd_mach_mips_loongson_2e      3001
8253     #define bfd_mach_mips_loongson_2f      3002
8254     #define bfd_mach_mips_gs464            3003
8255     #define bfd_mach_mips_gs464e           3004
8256     #define bfd_mach_mips_gs264e           3005
8257     #define bfd_mach_mips_sb1              12310201 /* octal 'SB', 01.  */
8258     #define bfd_mach_mips_octeon           6501
8259     #define bfd_mach_mips_octeonp          6601
8260     #define bfd_mach_mips_octeon2          6502
8261     #define bfd_mach_mips_octeon3          6503
8262     #define bfd_mach_mips_xlr              887682   /* decimal 'XLR'.  */
8263     #define bfd_mach_mips_interaptiv_mr2   736550   /* decimal 'IA2'.  */
8264     #define bfd_mach_mipsisa32             32
8265     #define bfd_mach_mipsisa32r2           33
8266     #define bfd_mach_mipsisa32r3           34
8267     #define bfd_mach_mipsisa32r5           36
8268     #define bfd_mach_mipsisa32r6           37
8269     #define bfd_mach_mipsisa64             64
8270     #define bfd_mach_mipsisa64r2           65
8271     #define bfd_mach_mipsisa64r3           66
8272     #define bfd_mach_mipsisa64r5           68
8273     #define bfd_mach_mipsisa64r6           69
8274     #define bfd_mach_mips_micromips        96
8275       bfd_arch_i386,      /* Intel 386.  */
8276     #define bfd_mach_i386_intel_syntax     (1 << 0)
8277     #define bfd_mach_i386_i8086            (1 << 1)
8278     #define bfd_mach_i386_i386             (1 << 2)
8279     #define bfd_mach_x86_64                (1 << 3)
8280     #define bfd_mach_x64_32                (1 << 4)
8281     #define bfd_mach_i386_i386_intel_syntax (bfd_mach_i386_i386 | bfd_mach_i386_intel_syntax)
8282     #define bfd_mach_x86_64_intel_syntax   (bfd_mach_x86_64 | bfd_mach_i386_intel_syntax)
8283     #define bfd_mach_x64_32_intel_syntax   (bfd_mach_x64_32 | bfd_mach_i386_intel_syntax)
8284       bfd_arch_iamcu,     /* Intel MCU.  */
8285     #define bfd_mach_iamcu                 (1 << 8)
8286     #define bfd_mach_i386_iamcu            (bfd_mach_i386_i386 | bfd_mach_iamcu)
8287     #define bfd_mach_i386_iamcu_intel_syntax (bfd_mach_i386_iamcu | bfd_mach_i386_intel_syntax)
8288       bfd_arch_romp,      /* IBM ROMP PC/RT.  */
8289       bfd_arch_convex,    /* Convex.  */
8290       bfd_arch_m98k,      /* Motorola 98xxx.  */
8291       bfd_arch_pyramid,   /* Pyramid Technology.  */
8292       bfd_arch_h8300,     /* Renesas H8/300 (formerly Hitachi H8/300).  */
8293     #define bfd_mach_h8300         1
8294     #define bfd_mach_h8300h        2
8295     #define bfd_mach_h8300s        3
8296     #define bfd_mach_h8300hn       4
8297     #define bfd_mach_h8300sn       5
8298     #define bfd_mach_h8300sx       6
8299     #define bfd_mach_h8300sxn      7
8300       bfd_arch_pdp11,     /* DEC PDP-11.  */
8301       bfd_arch_powerpc,   /* PowerPC.  */
8302     #define bfd_mach_ppc           32
8303     #define bfd_mach_ppc64         64
8304     #define bfd_mach_ppc_403       403
8305     #define bfd_mach_ppc_403gc     4030
8306     #define bfd_mach_ppc_405       405
8307     #define bfd_mach_ppc_505       505
8308     #define bfd_mach_ppc_601       601
8309     #define bfd_mach_ppc_602       602
8310     #define bfd_mach_ppc_603       603
8311     #define bfd_mach_ppc_ec603e    6031
8312     #define bfd_mach_ppc_604       604
8313     #define bfd_mach_ppc_620       620
8314     #define bfd_mach_ppc_630       630
8315     #define bfd_mach_ppc_750       750
8316     #define bfd_mach_ppc_860       860
8317     #define bfd_mach_ppc_a35       35
8318     #define bfd_mach_ppc_rs64ii    642
8319     #define bfd_mach_ppc_rs64iii   643
8320     #define bfd_mach_ppc_7400      7400
8321     #define bfd_mach_ppc_e500      500
8322     #define bfd_mach_ppc_e500mc    5001
8323     #define bfd_mach_ppc_e500mc64  5005
8324     #define bfd_mach_ppc_e5500     5006
8325     #define bfd_mach_ppc_e6500     5007
8326     #define bfd_mach_ppc_titan     83
8327     #define bfd_mach_ppc_vle       84
8328       bfd_arch_rs6000,    /* IBM RS/6000.  */
8329     #define bfd_mach_rs6k          6000
8330     #define bfd_mach_rs6k_rs1      6001
8331     #define bfd_mach_rs6k_rsc      6003
8332     #define bfd_mach_rs6k_rs2      6002
8333       bfd_arch_hppa,      /* HP PA RISC.  */
8334     #define bfd_mach_hppa10        10
8335     #define bfd_mach_hppa11        11
8336     #define bfd_mach_hppa20        20
8337     #define bfd_mach_hppa20w       25
8338       bfd_arch_d10v,      /* Mitsubishi D10V.  */
8339     #define bfd_mach_d10v          1
8340     #define bfd_mach_d10v_ts2      2
8341     #define bfd_mach_d10v_ts3      3
8342       bfd_arch_d30v,      /* Mitsubishi D30V.  */
8343       bfd_arch_dlx,       /* DLX.  */
8344       bfd_arch_m68hc11,   /* Motorola 68HC11.  */
8345       bfd_arch_m68hc12,   /* Motorola 68HC12.  */
8346     #define bfd_mach_m6812_default 0
8347     #define bfd_mach_m6812         1
8348     #define bfd_mach_m6812s        2
8349       bfd_arch_m9s12x,    /* Freescale S12X.  */
8350       bfd_arch_m9s12xg,   /* Freescale XGATE.  */
8351       bfd_arch_s12z,    /* Freescale S12Z.  */
8352     #define bfd_mach_s12z_default 0
8353       bfd_arch_z8k,       /* Zilog Z8000.  */
8354     #define bfd_mach_z8001         1
8355     #define bfd_mach_z8002         2
8356       bfd_arch_sh,        /* Renesas / SuperH SH (formerly Hitachi SH).  */
8357     #define bfd_mach_sh                            1
8358     #define bfd_mach_sh2                           0x20
8359     #define bfd_mach_sh_dsp                        0x2d
8360     #define bfd_mach_sh2a                          0x2a
8361     #define bfd_mach_sh2a_nofpu                    0x2b
8362     #define bfd_mach_sh2a_nofpu_or_sh4_nommu_nofpu 0x2a1
8363     #define bfd_mach_sh2a_nofpu_or_sh3_nommu       0x2a2
8364     #define bfd_mach_sh2a_or_sh4                   0x2a3
8365     #define bfd_mach_sh2a_or_sh3e                  0x2a4
8366     #define bfd_mach_sh2e                          0x2e
8367     #define bfd_mach_sh3                           0x30
8368     #define bfd_mach_sh3_nommu                     0x31
8369     #define bfd_mach_sh3_dsp                       0x3d
8370     #define bfd_mach_sh3e                          0x3e
8371     #define bfd_mach_sh4                           0x40
8372     #define bfd_mach_sh4_nofpu                     0x41
8373     #define bfd_mach_sh4_nommu_nofpu               0x42
8374     #define bfd_mach_sh4a                          0x4a
8375     #define bfd_mach_sh4a_nofpu                    0x4b
8376     #define bfd_mach_sh4al_dsp                     0x4d
8377       bfd_arch_alpha,     /* Dec Alpha.  */
8378     #define bfd_mach_alpha_ev4     0x10
8379     #define bfd_mach_alpha_ev5     0x20
8380     #define bfd_mach_alpha_ev6     0x30
8381       bfd_arch_arm,       /* Advanced Risc Machines ARM.  */
8382     #define bfd_mach_arm_unknown   0
8383     #define bfd_mach_arm_2         1
8384     #define bfd_mach_arm_2a        2
8385     #define bfd_mach_arm_3         3
8386     #define bfd_mach_arm_3M        4
8387     #define bfd_mach_arm_4         5
8388     #define bfd_mach_arm_4T        6
8389     #define bfd_mach_arm_5         7
8390     #define bfd_mach_arm_5T        8
8391     #define bfd_mach_arm_5TE       9
8392     #define bfd_mach_arm_XScale    10
8393     #define bfd_mach_arm_ep9312    11
8394     #define bfd_mach_arm_iWMMXt    12
8395     #define bfd_mach_arm_iWMMXt2   13
8396     #define bfd_mach_arm_5TEJ      14
8397     #define bfd_mach_arm_6         15
8398     #define bfd_mach_arm_6KZ       16
8399     #define bfd_mach_arm_6T2       17
8400     #define bfd_mach_arm_6K        18
8401     #define bfd_mach_arm_7         19
8402     #define bfd_mach_arm_6M        20
8403     #define bfd_mach_arm_6SM       21
8404     #define bfd_mach_arm_7EM       22
8405     #define bfd_mach_arm_8         23
8406     #define bfd_mach_arm_8R        24
8407     #define bfd_mach_arm_8M_BASE   25
8408     #define bfd_mach_arm_8M_MAIN   26
8409     #define bfd_mach_arm_8_1M_MAIN 27
8410     #define bfd_mach_arm_9         28
8411       bfd_arch_nds32,     /* Andes NDS32.  */
8412     #define bfd_mach_n1            1
8413     #define bfd_mach_n1h           2
8414     #define bfd_mach_n1h_v2        3
8415     #define bfd_mach_n1h_v3        4
8416     #define bfd_mach_n1h_v3m       5
8417       bfd_arch_ns32k,     /* National Semiconductors ns32000.  */
8418       bfd_arch_tic30,     /* Texas Instruments TMS320C30.  */
8419       bfd_arch_tic4x,     /* Texas Instruments TMS320C3X/4X.  */
8420     #define bfd_mach_tic3x         30
8421     #define bfd_mach_tic4x         40
8422       bfd_arch_tic54x,    /* Texas Instruments TMS320C54X.  */
8423       bfd_arch_tic6x,     /* Texas Instruments TMS320C6X.  */
8424       bfd_arch_v850,      /* NEC V850.  */
8425       bfd_arch_v850_rh850,/* NEC V850 (using RH850 ABI).  */
8426     #define bfd_mach_v850          1
8427     #define bfd_mach_v850e         'E'
8428     #define bfd_mach_v850e1        '1'
8429     #define bfd_mach_v850e2        0x4532
8430     #define bfd_mach_v850e2v3      0x45325633
8431     #define bfd_mach_v850e3v5      0x45335635 /* ('E'|'3'|'V'|'5').  */
8432       bfd_arch_arc,       /* ARC Cores.  */
8433     #define bfd_mach_arc_a4        0
8434     #define bfd_mach_arc_a5        1
8435     #define bfd_mach_arc_arc600    2
8436     #define bfd_mach_arc_arc601    4
8437     #define bfd_mach_arc_arc700    3
8438     #define bfd_mach_arc_arcv2     5
8439      bfd_arch_m32c,       /* Renesas M16C/M32C.  */
8440     #define bfd_mach_m16c          0x75
8441     #define bfd_mach_m32c          0x78
8442       bfd_arch_m32r,      /* Renesas M32R (formerly Mitsubishi M32R/D).  */
8443     #define bfd_mach_m32r          1 /* For backwards compatibility.  */
8444     #define bfd_mach_m32rx         'x'
8445     #define bfd_mach_m32r2         '2'
8446       bfd_arch_mn10200,   /* Matsushita MN10200.  */
8447       bfd_arch_mn10300,   /* Matsushita MN10300.  */
8448     #define bfd_mach_mn10300       300
8449     #define bfd_mach_am33          330
8450     #define bfd_mach_am33_2        332
8451       bfd_arch_fr30,
8452     #define bfd_mach_fr30          0x46523330
8453       bfd_arch_frv,
8454     #define bfd_mach_frv           1
8455     #define bfd_mach_frvsimple     2
8456     #define bfd_mach_fr300         300
8457     #define bfd_mach_fr400         400
8458     #define bfd_mach_fr450         450
8459     #define bfd_mach_frvtomcat     499     /* fr500 prototype.  */
8460     #define bfd_mach_fr500         500
8461     #define bfd_mach_fr550         550
8462       bfd_arch_moxie,     /* The moxie processor.  */
8463     #define bfd_mach_moxie         1
8464       bfd_arch_ft32,      /* The ft32 processor.  */
8465     #define bfd_mach_ft32          1
8466     #define bfd_mach_ft32b         2
8467       bfd_arch_mcore,
8468       bfd_arch_mep,
8469     #define bfd_mach_mep           1
8470     #define bfd_mach_mep_h1        0x6831
8471     #define bfd_mach_mep_c5        0x6335
8472       bfd_arch_metag,
8473     #define bfd_mach_metag         1
8474       bfd_arch_ia64,      /* HP/Intel ia64.  */
8475     #define bfd_mach_ia64_elf64    64
8476     #define bfd_mach_ia64_elf32    32
8477       bfd_arch_ip2k,      /* Ubicom IP2K microcontrollers. */
8478     #define bfd_mach_ip2022        1
8479     #define bfd_mach_ip2022ext     2
8480      bfd_arch_iq2000,     /* Vitesse IQ2000.  */
8481     #define bfd_mach_iq2000        1
8482     #define bfd_mach_iq10          2
8483       bfd_arch_bpf,       /* Linux eBPF.  */
8484     #define bfd_mach_bpf           1
8485     #define bfd_mach_xbpf          2
8486       bfd_arch_epiphany,  /* Adapteva EPIPHANY.  */
8487     #define bfd_mach_epiphany16    1
8488     #define bfd_mach_epiphany32    2
8489       bfd_arch_mt,
8490     #define bfd_mach_ms1           1
8491     #define bfd_mach_mrisc2        2
8492     #define bfd_mach_ms2           3
8493       bfd_arch_pj,
8494       bfd_arch_avr,       /* Atmel AVR microcontrollers.  */
8495     #define bfd_mach_avr1          1
8496     #define bfd_mach_avr2          2
8497     #define bfd_mach_avr25         25
8498     #define bfd_mach_avr3          3
8499     #define bfd_mach_avr31         31
8500     #define bfd_mach_avr35         35
8501     #define bfd_mach_avr4          4
8502     #define bfd_mach_avr5          5
8503     #define bfd_mach_avr51         51
8504     #define bfd_mach_avr6          6
8505     #define bfd_mach_avrtiny       100
8506     #define bfd_mach_avrxmega1     101
8507     #define bfd_mach_avrxmega2     102
8508     #define bfd_mach_avrxmega3     103
8509     #define bfd_mach_avrxmega4     104
8510     #define bfd_mach_avrxmega5     105
8511     #define bfd_mach_avrxmega6     106
8512     #define bfd_mach_avrxmega7     107
8513       bfd_arch_bfin,      /* ADI Blackfin.  */
8514     #define bfd_mach_bfin          1
8515       bfd_arch_cr16,      /* National Semiconductor CompactRISC (ie CR16).  */
8516     #define bfd_mach_cr16          1
8517       bfd_arch_crx,       /*  National Semiconductor CRX.  */
8518     #define bfd_mach_crx           1
8519       bfd_arch_cris,      /* Axis CRIS.  */
8520     #define bfd_mach_cris_v0_v10   255
8521     #define bfd_mach_cris_v32      32
8522     #define bfd_mach_cris_v10_v32  1032
8523       bfd_arch_riscv,
8524     #define bfd_mach_riscv32       132
8525     #define bfd_mach_riscv64       164
8526       bfd_arch_rl78,
8527     #define bfd_mach_rl78          0x75
8528       bfd_arch_rx,        /* Renesas RX.  */
8529     #define bfd_mach_rx            0x75
8530     #define bfd_mach_rx_v2         0x76
8531     #define bfd_mach_rx_v3         0x77
8532       bfd_arch_s390,      /* IBM s390.  */
8533     #define bfd_mach_s390_31       31
8534     #define bfd_mach_s390_64       64
8535       bfd_arch_score,     /* Sunplus score.  */
8536     #define bfd_mach_score3        3
8537     #define bfd_mach_score7        7
8538       bfd_arch_mmix,      /* Donald Knuth's educational processor.  */
8539       bfd_arch_xstormy16,
8540     #define bfd_mach_xstormy16     1
8541       bfd_arch_msp430,    /* Texas Instruments MSP430 architecture.  */
8542     #define bfd_mach_msp11         11
8543     #define bfd_mach_msp110        110
8544     #define bfd_mach_msp12         12
8545     #define bfd_mach_msp13         13
8546     #define bfd_mach_msp14         14
8547     #define bfd_mach_msp15         15
8548     #define bfd_mach_msp16         16
8549     #define bfd_mach_msp20         20
8550     #define bfd_mach_msp21         21
8551     #define bfd_mach_msp22         22
8552     #define bfd_mach_msp23         23
8553     #define bfd_mach_msp24         24
8554     #define bfd_mach_msp26         26
8555     #define bfd_mach_msp31         31
8556     #define bfd_mach_msp32         32
8557     #define bfd_mach_msp33         33
8558     #define bfd_mach_msp41         41
8559     #define bfd_mach_msp42         42
8560     #define bfd_mach_msp43         43
8561     #define bfd_mach_msp44         44
8562     #define bfd_mach_msp430x       45
8563     #define bfd_mach_msp46         46
8564     #define bfd_mach_msp47         47
8565     #define bfd_mach_msp54         54
8566       bfd_arch_xgate,     /* Freescale XGATE.  */
8567     #define bfd_mach_xgate         1
8568       bfd_arch_xtensa,    /* Tensilica's Xtensa cores.  */
8569     #define bfd_mach_xtensa        1
8570       bfd_arch_z80,
8571     /* Zilog Z80 without undocumented opcodes.  */
8572     #define bfd_mach_z80strict     1
8573     /* Zilog Z180: successor with additional instructions, but without
8574      halves of ix and iy.  */
8575     #define bfd_mach_z180          2
8576     /* Zilog Z80 with ixl, ixh, iyl, and iyh.  */
8577     #define bfd_mach_z80           3
8578     /* Zilog eZ80 (successor of Z80 & Z180) in Z80 (16-bit address) mode.  */
8579     #define bfd_mach_ez80_z80      4
8580     /* Zilog eZ80 (successor of Z80 & Z180) in ADL (24-bit address) mode.  */
8581     #define bfd_mach_ez80_adl      5
8582     /* Z80N */
8583     #define bfd_mach_z80n          6
8584     /* Zilog Z80 with all undocumented instructions.  */
8585     #define bfd_mach_z80full       7
8586     /* GameBoy Z80 (reduced instruction set).  */
8587     #define bfd_mach_gbz80         8
8588     /* ASCII R800: successor with multiplication.  */
8589     #define bfd_mach_r800          11
8590       bfd_arch_lm32,      /* Lattice Mico32.  */
8591     #define bfd_mach_lm32          1
8592       bfd_arch_microblaze,/* Xilinx MicroBlaze.  */
8593       bfd_arch_tilepro,   /* Tilera TILEPro.  */
8594       bfd_arch_tilegx,    /* Tilera TILE-Gx.  */
8595     #define bfd_mach_tilepro       1
8596     #define bfd_mach_tilegx        1
8597     #define bfd_mach_tilegx32      2
8598       bfd_arch_aarch64,   /* AArch64.  */
8599     #define bfd_mach_aarch64 0
8600     #define bfd_mach_aarch64_8R    1
8601     #define bfd_mach_aarch64_ilp32 32
8602       bfd_arch_nios2,     /* Nios II.  */
8603     #define bfd_mach_nios2         0
8604     #define bfd_mach_nios2r1       1
8605     #define bfd_mach_nios2r2       2
8606       bfd_arch_visium,    /* Visium.  */
8607     #define bfd_mach_visium        1
8608       bfd_arch_wasm32,    /* WebAssembly.  */
8609     #define bfd_mach_wasm32        1
8610       bfd_arch_pru,       /* PRU.  */
8611     #define bfd_mach_pru           0
8612       bfd_arch_nfp,       /* Netronome Flow Processor */
8613     #define bfd_mach_nfp3200       0x3200
8614     #define bfd_mach_nfp6000       0x6000
8615       bfd_arch_csky,      /* C-SKY.  */
8616     #define bfd_mach_ck_unknown    0
8617     #define bfd_mach_ck510         1
8618     #define bfd_mach_ck610         2
8619     #define bfd_mach_ck801         3
8620     #define bfd_mach_ck802         4
8621     #define bfd_mach_ck803         5
8622     #define bfd_mach_ck807         6
8623     #define bfd_mach_ck810         7
8624     #define bfd_mach_ck860         8
8625       bfd_arch_loongarch,       /* LoongArch */
8626     #define bfd_mach_loongarch32   1
8627     #define bfd_mach_loongarch64   2
8628       bfd_arch_amdgcn,     /* AMDGCN */
8629     #define bfd_mach_amdgcn_unknown 0x000
8630     #define bfd_mach_amdgcn_gfx900  0x02c
8631     #define bfd_mach_amdgcn_gfx904  0x02e
8632     #define bfd_mach_amdgcn_gfx906  0x02f
8633     #define bfd_mach_amdgcn_gfx908  0x030
8634     #define bfd_mach_amdgcn_gfx90a  0x03f
8635     #define bfd_mach_amdgcn_gfx1010 0x033
8636     #define bfd_mach_amdgcn_gfx1011 0x034
8637     #define bfd_mach_amdgcn_gfx1012 0x035
8638     #define bfd_mach_amdgcn_gfx1030 0x036
8639     #define bfd_mach_amdgcn_gfx1031 0x037
8640     #define bfd_mach_amdgcn_gfx1032 0x038
8641       bfd_arch_last
8642       };
8643
86442.13.2 bfd_arch_info
8645--------------------
8646
8647*Description*
8648This structure contains information on architectures for use within BFD.
8649
8650     typedef struct bfd_arch_info
8651     {
8652       int bits_per_word;
8653       int bits_per_address;
8654       int bits_per_byte;
8655       enum bfd_architecture arch;
8656       unsigned long mach;
8657       const char *arch_name;
8658       const char *printable_name;
8659       unsigned int section_align_power;
8660       /* TRUE if this is the default machine for the architecture.
8661          The default arch should be the first entry for an arch so that
8662          all the entries for that arch can be accessed via next.  */
8663       bool the_default;
8664       const struct bfd_arch_info * (*compatible) (const struct bfd_arch_info *,
8665                                                   const struct bfd_arch_info *);
8666
8667       bool (*scan) (const struct bfd_arch_info *, const char *);
8668
8669       /* Allocate via bfd_malloc and return a fill buffer of size COUNT.  If
8670          IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8671          TRUE, the buffer contains code.  */
8672       void *(*fill) (bfd_size_type count, bool is_bigendian, bool code);
8673
8674       const struct bfd_arch_info *next;
8675
8676       /* On some architectures the offset for a relocation can point into
8677          the middle of an instruction.  This field specifies the maximum
8678          offset such a relocation can have (in octets).  This affects the
8679          behaviour of the disassembler, since a value greater than zero
8680          means that it may need to disassemble an instruction twice, once
8681          to get its length and then a second time to display it.  If the
8682          value is negative then this has to be done for every single
8683          instruction, regardless of the offset of the reloc.  */
8684       signed int max_reloc_offset_into_insn;
8685     }
8686     bfd_arch_info_type;
8687
8688
86892.13.2.1 'bfd_printable_name'
8690.............................
8691
8692*Synopsis*
8693     const char *bfd_printable_name (bfd *abfd);
8694   *Description*
8695Return a printable string representing the architecture and machine from
8696the pointer to the architecture info structure.
8697
86982.13.2.2 'bfd_scan_arch'
8699........................
8700
8701*Synopsis*
8702     const bfd_arch_info_type *bfd_scan_arch (const char *string);
8703   *Description*
8704Figure out if BFD supports any cpu which could be described with the
8705name STRING.  Return a pointer to an 'arch_info' structure if a machine
8706is found, otherwise NULL.
8707
87082.13.2.3 'bfd_arch_list'
8709........................
8710
8711*Synopsis*
8712     const char **bfd_arch_list (void);
8713   *Description*
8714Return a freshly malloced NULL-terminated vector of the names of all the
8715valid BFD architectures.  Do not modify the names.
8716
87172.13.2.4 'bfd_arch_get_compatible'
8718..................................
8719
8720*Synopsis*
8721     const bfd_arch_info_type *bfd_arch_get_compatible
8722        (const bfd *abfd, const bfd *bbfd, bool accept_unknowns);
8723   *Description*
8724Determine whether two BFDs' architectures and machine types are
8725compatible.  Calculates the lowest common denominator between the two
8726architectures and machine types implied by the BFDs and returns a
8727pointer to an 'arch_info' structure describing the compatible machine.
8728
87292.13.2.5 'bfd_default_arch_struct'
8730..................................
8731
8732*Description*
8733The 'bfd_default_arch_struct' is an item of 'bfd_arch_info_type' which
8734has been initialized to a fairly generic state.  A BFD starts life by
8735pointing to this structure, until the correct back end has determined
8736the real architecture of the file.
8737     extern const bfd_arch_info_type bfd_default_arch_struct;
8738
87392.13.2.6 'bfd_set_arch_info'
8740............................
8741
8742*Synopsis*
8743     void bfd_set_arch_info (bfd *abfd, const bfd_arch_info_type *arg);
8744   *Description*
8745Set the architecture info of ABFD to ARG.
8746
87472.13.2.7 'bfd_default_set_arch_mach'
8748....................................
8749
8750*Synopsis*
8751     bool bfd_default_set_arch_mach
8752        (bfd *abfd, enum bfd_architecture arch, unsigned long mach);
8753   *Description*
8754Set the architecture and machine type in BFD ABFD to ARCH and MACH.
8755Find the correct pointer to a structure and insert it into the
8756'arch_info' pointer.
8757
87582.13.2.8 'bfd_get_arch'
8759.......................
8760
8761*Synopsis*
8762     enum bfd_architecture bfd_get_arch (const bfd *abfd);
8763   *Description*
8764Return the enumerated type which describes the BFD ABFD's architecture.
8765
87662.13.2.9 'bfd_get_mach'
8767.......................
8768
8769*Synopsis*
8770     unsigned long bfd_get_mach (const bfd *abfd);
8771   *Description*
8772Return the long type which describes the BFD ABFD's machine.
8773
87742.13.2.10 'bfd_arch_bits_per_byte'
8775..................................
8776
8777*Synopsis*
8778     unsigned int bfd_arch_bits_per_byte (const bfd *abfd);
8779   *Description*
8780Return the number of bits in one of the BFD ABFD's architecture's bytes.
8781
87822.13.2.11 'bfd_arch_bits_per_address'
8783.....................................
8784
8785*Synopsis*
8786     unsigned int bfd_arch_bits_per_address (const bfd *abfd);
8787   *Description*
8788Return the number of bits in one of the BFD ABFD's architecture's
8789addresses.
8790
87912.13.2.12 'bfd_default_compatible'
8792..................................
8793
8794*Synopsis*
8795     const bfd_arch_info_type *bfd_default_compatible
8796        (const bfd_arch_info_type *a, const bfd_arch_info_type *b);
8797   *Description*
8798The default function for testing for compatibility.
8799
88002.13.2.13 'bfd_default_scan'
8801............................
8802
8803*Synopsis*
8804     bool bfd_default_scan
8805        (const struct bfd_arch_info *info, const char *string);
8806   *Description*
8807The default function for working out whether this is an architecture hit
8808and a machine hit.
8809
88102.13.2.14 'bfd_get_arch_info'
8811.............................
8812
8813*Synopsis*
8814     const bfd_arch_info_type *bfd_get_arch_info (bfd *abfd);
8815   *Description*
8816Return the architecture info struct in ABFD.
8817
88182.13.2.15 'bfd_lookup_arch'
8819...........................
8820
8821*Synopsis*
8822     const bfd_arch_info_type *bfd_lookup_arch
8823        (enum bfd_architecture arch, unsigned long machine);
8824   *Description*
8825Look for the architecture info structure which matches the arguments
8826ARCH and MACHINE.  A machine of 0 matches the machine/architecture
8827structure which marks itself as the default.
8828
88292.13.2.16 'bfd_printable_arch_mach'
8830...................................
8831
8832*Synopsis*
8833     const char *bfd_printable_arch_mach
8834        (enum bfd_architecture arch, unsigned long machine);
8835   *Description*
8836Return a printable string representing the architecture and machine
8837type.
8838
8839   This routine is depreciated.
8840
88412.13.2.17 'bfd_octets_per_byte'
8842...............................
8843
8844*Synopsis*
8845     unsigned int bfd_octets_per_byte (const bfd *abfd,
8846         const asection *sec);
8847   *Description*
8848Return the number of octets (8-bit quantities) per target byte (minimum
8849addressable unit).  In most cases, this will be one, but some DSP
8850targets have 16, 32, or even 48 bits per byte.
8851
88522.13.2.18 'bfd_arch_mach_octets_per_byte'
8853.........................................
8854
8855*Synopsis*
8856     unsigned int bfd_arch_mach_octets_per_byte
8857        (enum bfd_architecture arch, unsigned long machine);
8858   *Description*
8859See bfd_octets_per_byte.
8860
8861   This routine is provided for those cases where a bfd * is not
8862available
8863
88642.13.2.19 'bfd_arch_default_fill'
8865.................................
8866
8867*Synopsis*
8868     void *bfd_arch_default_fill (bfd_size_type count,
8869         bool is_bigendian,
8870         bool code);
8871   *Description*
8872Allocate via bfd_malloc and return a fill buffer of size COUNT. If
8873IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8874TRUE, the buffer contains code.
8875
8876
8877File: bfd.info,  Node: Opening and Closing,  Next: Internal,  Prev: Architectures,  Up: BFD front end
8878
8879     /* Set to N to open the next N BFDs using an alternate id space.  */
8880     extern unsigned int bfd_use_reserved_id;
8881
88822.14 Opening and closing BFDs
8883=============================
8884
88852.14.1 Functions for opening and closing
8886----------------------------------------
8887
88882.14.1.1 'bfd_fopen'
8889....................
8890
8891*Synopsis*
8892     bfd *bfd_fopen (const char *filename, const char *target,
8893         const char *mode, int fd);
8894   *Description*
8895Open the file FILENAME with the target TARGET.  Return a pointer to the
8896created BFD. If FD is not -1, then 'fdopen' is used to open the file;
8897otherwise, 'fopen' is used.  MODE is passed directly to 'fopen' or
8898'fdopen'.
8899
8900   Calls 'bfd_find_target', so TARGET is interpreted as by that
8901function.
8902
8903   The new BFD is marked as cacheable iff FD is -1.
8904
8905   If 'NULL' is returned then an error has occured.  Possible errors are
8906'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8907error.
8908
8909   On error, FD is always closed.
8910
8911   A copy of the FILENAME argument is stored in the newly created BFD.
8912It can be accessed via the bfd_get_filename() macro.
8913
89142.14.1.2 'bfd_openr'
8915....................
8916
8917*Synopsis*
8918     bfd *bfd_openr (const char *filename, const char *target);
8919   *Description*
8920Open the file FILENAME (using 'fopen') with the target TARGET.  Return a
8921pointer to the created BFD.
8922
8923   Calls 'bfd_find_target', so TARGET is interpreted as by that
8924function.
8925
8926   If 'NULL' is returned then an error has occured.  Possible errors are
8927'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8928error.
8929
8930   A copy of the FILENAME argument is stored in the newly created BFD.
8931It can be accessed via the bfd_get_filename() macro.
8932
89332.14.1.3 'bfd_fdopenr'
8934......................
8935
8936*Synopsis*
8937     bfd *bfd_fdopenr (const char *filename, const char *target, int fd);
8938   *Description*
8939'bfd_fdopenr' is to 'bfd_fopenr' much like 'fdopen' is to 'fopen'.  It
8940opens a BFD on a file already described by the FD supplied.
8941
8942   When the file is later 'bfd_close'd, the file descriptor will be
8943closed.  If the caller desires that this file descriptor be cached by
8944BFD (opened as needed, closed as needed to free descriptors for other
8945opens), with the supplied FD used as an initial file descriptor (but
8946subject to closure at any time), call bfd_set_cacheable(bfd, 1) on the
8947returned BFD. The default is to assume no caching; the file descriptor
8948will remain open until 'bfd_close', and will not be affected by BFD
8949operations on other files.
8950
8951   Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
8952and 'bfd_error_system_call'.
8953
8954   On error, FD is closed.
8955
8956   A copy of the FILENAME argument is stored in the newly created BFD.
8957It can be accessed via the bfd_get_filename() macro.
8958
89592.14.1.4 'bfd_fdopenw'
8960......................
8961
8962*Synopsis*
8963     bfd *bfd_fdopenw (const char *filename, const char *target, int fd);
8964   *Description*
8965'bfd_fdopenw' is exactly like 'bfd_fdopenr' with the exception that the
8966resulting BFD is suitable for output.
8967
89682.14.1.5 'bfd_openstreamr'
8969..........................
8970
8971*Synopsis*
8972     bfd *bfd_openstreamr (const char * filename, const char * target,
8973         void * stream);
8974   *Description*
8975Open a BFD for read access on an existing stdio stream.  When the BFD is
8976passed to 'bfd_close', the stream will be closed.
8977
8978   A copy of the FILENAME argument is stored in the newly created BFD.
8979It can be accessed via the bfd_get_filename() macro.
8980
89812.14.1.6 'bfd_openr_iovec'
8982..........................
8983
8984*Synopsis*
8985     bfd *bfd_openr_iovec (const char *filename, const char *target,
8986         void *(*open_func) (struct bfd *nbfd,
8987         void *open_closure),
8988         void *open_closure,
8989         file_ptr (*pread_func) (struct bfd *nbfd,
8990         void *stream,
8991         void *buf,
8992         file_ptr nbytes,
8993         file_ptr offset),
8994         int (*close_func) (struct bfd *nbfd,
8995         void *stream),
8996         int (*stat_func) (struct bfd *abfd,
8997         void *stream,
8998         struct stat *sb));
8999   *Description*
9000Create and return a BFD backed by a read-only STREAM.  The STREAM is
9001created using OPEN_FUNC, accessed using PREAD_FUNC and destroyed using
9002CLOSE_FUNC.
9003
9004   Calls 'bfd_find_target', so TARGET is interpreted as by that
9005function.
9006
9007   Calls OPEN_FUNC (which can call 'bfd_zalloc' and 'bfd_get_filename')
9008to obtain the read-only stream backing the BFD. OPEN_FUNC either
9009succeeds returning the non-'NULL' STREAM, or fails returning 'NULL'
9010(setting 'bfd_error').
9011
9012   Calls PREAD_FUNC to request NBYTES of data from STREAM starting at
9013OFFSET (e.g., via a call to 'bfd_read').  PREAD_FUNC either succeeds
9014returning the number of bytes read (which can be less than NBYTES when
9015end-of-file), or fails returning -1 (setting 'bfd_error').
9016
9017   Calls CLOSE_FUNC when the BFD is later closed using 'bfd_close'.
9018CLOSE_FUNC either succeeds returning 0, or fails returning -1 (setting
9019'bfd_error').
9020
9021   Calls STAT_FUNC to fill in a stat structure for bfd_stat,
9022bfd_get_size, and bfd_get_mtime calls.  STAT_FUNC returns 0 on success,
9023or returns -1 on failure (setting 'bfd_error').
9024
9025   If 'bfd_openr_iovec' returns 'NULL' then an error has occurred.
9026Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
9027and 'bfd_error_system_call'.
9028
9029   A copy of the FILENAME argument is stored in the newly created BFD.
9030It can be accessed via the bfd_get_filename() macro.
9031
90322.14.1.7 'bfd_openw'
9033....................
9034
9035*Synopsis*
9036     bfd *bfd_openw (const char *filename, const char *target);
9037   *Description*
9038Create a BFD, associated with file FILENAME, using the file format
9039TARGET, and return a pointer to it.
9040
9041   Possible errors are 'bfd_error_system_call', 'bfd_error_no_memory',
9042'bfd_error_invalid_target'.
9043
9044   A copy of the FILENAME argument is stored in the newly created BFD.
9045It can be accessed via the bfd_get_filename() macro.
9046
90472.14.1.8 'bfd_close'
9048....................
9049
9050*Synopsis*
9051     bool bfd_close (bfd *abfd);
9052   *Description*
9053Close a BFD. If the BFD was open for writing, then pending operations
9054are completed and the file written out and closed.  If the created file
9055is executable, then 'chmod' is called to mark it as such.
9056
9057   All memory attached to the BFD is released.
9058
9059   The file descriptor associated with the BFD is closed (even if it was
9060passed in to BFD by 'bfd_fdopenr').
9061
9062   *Returns*
9063'TRUE' is returned if all is ok, otherwise 'FALSE'.
9064
90652.14.1.9 'bfd_close_all_done'
9066.............................
9067
9068*Synopsis*
9069     bool bfd_close_all_done (bfd *);
9070   *Description*
9071Close a BFD. Differs from 'bfd_close' since it does not complete any
9072pending operations.  This routine would be used if the application had
9073just used BFD for swapping and didn't want to use any of the writing
9074code.
9075
9076   If the created file is executable, then 'chmod' is called to mark it
9077as such.
9078
9079   All memory attached to the BFD is released.
9080
9081   *Returns*
9082'TRUE' is returned if all is ok, otherwise 'FALSE'.
9083
90842.14.1.10 'bfd_create'
9085......................
9086
9087*Synopsis*
9088     bfd *bfd_create (const char *filename, bfd *templ);
9089   *Description*
9090Create a new BFD in the manner of 'bfd_openw', but without opening a
9091file.  The new BFD takes the target from the target used by TEMPL.  The
9092format is always set to 'bfd_object'.
9093
9094   A copy of the FILENAME argument is stored in the newly created BFD.
9095It can be accessed via the bfd_get_filename() macro.
9096
90972.14.1.11 'bfd_make_writable'
9098.............................
9099
9100*Synopsis*
9101     bool bfd_make_writable (bfd *abfd);
9102   *Description*
9103Takes a BFD as created by 'bfd_create' and converts it into one like as
9104returned by 'bfd_openw'.  It does this by converting the BFD to
9105BFD_IN_MEMORY. It's assumed that you will call 'bfd_make_readable' on
9106this bfd later.
9107
9108   *Returns*
9109'TRUE' is returned if all is ok, otherwise 'FALSE'.
9110
91112.14.1.12 'bfd_make_readable'
9112.............................
9113
9114*Synopsis*
9115     bool bfd_make_readable (bfd *abfd);
9116   *Description*
9117Takes a BFD as created by 'bfd_create' and 'bfd_make_writable' and
9118converts it into one like as returned by 'bfd_openr'.  It does this by
9119writing the contents out to the memory buffer, then reversing the
9120direction.
9121
9122   *Returns*
9123'TRUE' is returned if all is ok, otherwise 'FALSE'.
9124
91252.14.1.13 'bfd_alloc'
9126.....................
9127
9128*Synopsis*
9129     void *bfd_alloc (bfd *abfd, bfd_size_type wanted);
9130   *Description*
9131Allocate a block of WANTED bytes of memory attached to 'abfd' and return
9132a pointer to it.
9133
91342.14.1.14 'bfd_zalloc'
9135......................
9136
9137*Synopsis*
9138     void *bfd_zalloc (bfd *abfd, bfd_size_type wanted);
9139   *Description*
9140Allocate a block of WANTED bytes of zeroed memory attached to 'abfd' and
9141return a pointer to it.
9142
91432.14.1.15 'bfd_calc_gnu_debuglink_crc32'
9144........................................
9145
9146*Synopsis*
9147     unsigned long bfd_calc_gnu_debuglink_crc32
9148        (unsigned long crc, const unsigned char *buf, bfd_size_type len);
9149   *Description*
9150Computes a CRC value as used in the .gnu_debuglink section.  Advances
9151the previously computed CRC value by computing and adding in the crc32
9152for LEN bytes of BUF.
9153
9154   *Returns*
9155Return the updated CRC32 value.
9156
91572.14.1.16 'bfd_get_debug_link_info_1'
9158.....................................
9159
9160*Synopsis*
9161     char *bfd_get_debug_link_info_1 (bfd *abfd, void *crc32_out);
9162   *Description*
9163Extracts the filename and CRC32 value for any separate debug information
9164file associated with ABFD.
9165
9166   The CRC32_OUT parameter is an untyped pointer because this routine is
9167used as a 'get_func_type' function, but it is expected to be an unsigned
9168long pointer.
9169
9170   *Returns*
9171The filename of the associated debug information file, or NULL if there
9172is no such file.  If the filename was found then the contents of
9173CRC32_OUT are updated to hold the corresponding CRC32 value for the
9174file.
9175
9176   The returned filename is allocated with 'malloc'; freeing it is the
9177responsibility of the caller.
9178
91792.14.1.17 'bfd_get_debug_link_info'
9180...................................
9181
9182*Synopsis*
9183     char *bfd_get_debug_link_info (bfd *abfd, unsigned long *crc32_out);
9184   *Description*
9185Extracts the filename and CRC32 value for any separate debug information
9186file associated with ABFD.
9187
9188   *Returns*
9189The filename of the associated debug information file, or NULL if there
9190is no such file.  If the filename was found then the contents of
9191CRC32_OUT are updated to hold the corresponding CRC32 value for the
9192file.
9193
9194   The returned filename is allocated with 'malloc'; freeing it is the
9195responsibility of the caller.
9196
91972.14.1.18 'bfd_get_alt_debug_link_info'
9198.......................................
9199
9200*Synopsis*
9201     char *bfd_get_alt_debug_link_info (bfd * abfd,
9202         bfd_size_type *buildid_len,
9203         bfd_byte **buildid_out);
9204   *Description*
9205Fetch the filename and BuildID value for any alternate debuginfo
9206associated with ABFD.  Return NULL if no such info found, otherwise
9207return filename and update BUILDID_LEN and BUILDID_OUT.  The returned
9208filename and build_id are allocated with 'malloc'; freeing them is the
9209responsibility of the caller.
9210
92112.14.1.19 'separate_debug_file_exists'
9212......................................
9213
9214*Synopsis*
9215     bool separate_debug_file_exists
9216        (char *name, void *crc32_p);
9217   *Description*
9218Checks to see if NAME is a file and if its contents match CRC32, which
9219is a pointer to an 'unsigned long' containing a CRC32.
9220
9221   The CRC32_P parameter is an untyped pointer because this routine is
9222used as a 'check_func_type' function.
9223
92242.14.1.20 'separate_alt_debug_file_exists'
9225..........................................
9226
9227*Synopsis*
9228     bool separate_alt_debug_file_exists
9229        (char *name, void *unused);
9230   *Description*
9231Checks to see if NAME is a file.
9232
92332.14.1.21 'find_separate_debug_file'
9234....................................
9235
9236*Synopsis*
9237     char *find_separate_debug_file
9238        (bfd *abfd, const char *dir, bool include_dirs,
9239         get_func_type get, check_func_type check, void *data);
9240   *Description*
9241Searches for a debug information file corresponding to ABFD.
9242
9243   The name of the separate debug info file is returned by the GET
9244function.  This function scans various fixed locations in the
9245filesystem, including the file tree rooted at DIR.  If the INCLUDE_DIRS
9246parameter is true then the directory components of ABFD's filename will
9247be included in the searched locations.
9248
9249   DATA is passed unmodified to the GET and CHECK functions.  It is
9250generally used to implement build-id-like matching in the callback
9251functions.
9252
9253   *Returns*
9254Returns the filename of the first file to be found which receives a TRUE
9255result from the CHECK function.  Returns NULL if no valid file could be
9256found.
9257
92582.14.1.22 'bfd_follow_gnu_debuglink'
9259....................................
9260
9261*Synopsis*
9262     char *bfd_follow_gnu_debuglink (bfd *abfd, const char *dir);
9263   *Description*
9264Takes a BFD and searches it for a .gnu_debuglink section.  If this
9265section is found, it examines the section for the name and checksum of a
9266'.debug' file containing auxiliary debugging information.  It then
9267searches the filesystem for this .debug file in some standard locations,
9268including the directory tree rooted at DIR, and if found returns the
9269full filename.
9270
9271   If DIR is NULL, the search will take place starting at the current
9272directory.
9273
9274   *Returns*
9275'NULL' on any errors or failure to locate the .debug file, otherwise a
9276pointer to a heap-allocated string containing the filename.  The caller
9277is responsible for freeing this string.
9278
92792.14.1.23 'bfd_follow_gnu_debugaltlink'
9280.......................................
9281
9282*Synopsis*
9283     char *bfd_follow_gnu_debugaltlink (bfd *abfd, const char *dir);
9284   *Description*
9285Takes a BFD and searches it for a .gnu_debugaltlink section.  If this
9286section is found, it examines the section for the name of a file
9287containing auxiliary debugging information.  It then searches the
9288filesystem for this file in a set of standard locations, including the
9289directory tree rooted at DIR, and if found returns the full filename.
9290
9291   If DIR is NULL, the search will take place starting at the current
9292directory.
9293
9294   *Returns*
9295'NULL' on any errors or failure to locate the debug file, otherwise a
9296pointer to a heap-allocated string containing the filename.  The caller
9297is responsible for freeing this string.
9298
92992.14.1.24 'bfd_create_gnu_debuglink_section'
9300............................................
9301
9302*Synopsis*
9303     struct bfd_section *bfd_create_gnu_debuglink_section
9304        (bfd *abfd, const char *filename);
9305   *Description*
9306Takes a BFD and adds a .gnu_debuglink section to it.  The section is
9307sized to be big enough to contain a link to the specified FILENAME.
9308
9309   *Returns*
9310A pointer to the new section is returned if all is ok.  Otherwise 'NULL'
9311is returned and bfd_error is set.
9312
93132.14.1.25 'bfd_fill_in_gnu_debuglink_section'
9314.............................................
9315
9316*Synopsis*
9317     bool bfd_fill_in_gnu_debuglink_section
9318        (bfd *abfd, struct bfd_section *sect, const char *filename);
9319   *Description*
9320Takes a BFD and containing a .gnu_debuglink section SECT and fills in
9321the contents of the section to contain a link to the specified FILENAME.
9322The filename should be relative to the current directory.
9323
9324   *Returns*
9325'TRUE' is returned if all is ok.  Otherwise 'FALSE' is returned and
9326bfd_error is set.
9327
93282.14.1.26 'get_build_id'
9329........................
9330
9331*Synopsis*
9332     struct bfd_build_id * get_build_id (bfd *abfd);
9333   *Description*
9334Finds the build-id associated with ABFD.  If the build-id is extracted
9335from the note section then a build-id structure is built for it, using
9336memory allocated to ABFD, and this is then attached to the ABFD.
9337
9338   *Returns*
9339Returns a pointer to the build-id structure if a build-id could be
9340found.  If no build-id is found NULL is returned and error code is set.
9341
93422.14.1.27 'get_build_id_name'
9343.............................
9344
9345*Synopsis*
9346     char * get_build_id_name (bfd *abfd, void *build_id_out_p)
9347   *Description*
9348Searches ABFD for a build-id, and then constructs a pathname from it.
9349The path is computed as .build-id/NN/NN+NN.debug where NNNN+NN is the
9350build-id value as a hexadecimal string.
9351
9352   *Returns*
9353Returns the constructed filename or NULL upon error.  It is the caller's
9354responsibility to free the memory used to hold the filename.  If a
9355filename is returned then the BUILD_ID_OUT_P parameter (which points to
9356a 'struct bfd_build_id' pointer) is set to a pointer to the build_id
9357structure.
9358
93592.14.1.28 'check_build_id_file'
9360...............................
9361
9362*Synopsis*
9363     bool check_build_id_file (char *name, void *buildid_p);
9364   *Description*
9365Checks to see if NAME is a readable file and if its build-id matches
9366BUILDID.
9367
9368   *Returns*
9369Returns TRUE if the file exists, is readable, and contains a build-id
9370which matches the build-id pointed at by BUILD_ID_P (which is really a
9371'struct bfd_build_id **').
9372
93732.14.1.29 'bfd_follow_build_id_debuglink'
9374.........................................
9375
9376*Synopsis*
9377     char *bfd_follow_build_id_debuglink (bfd *abfd, const char *dir);
9378   *Description*
9379Takes ABFD and searches it for a .note.gnu.build-id section.  If this
9380section is found, it extracts the value of the NT_GNU_BUILD_ID note,
9381which should be a hexadecimal value NNNN+NN (for 32+ hex digits).  It
9382then searches the filesystem for a file named .BUILD-ID/NN/NN+NN.DEBUG
9383in a set of standard locations, including the directory tree rooted at
9384DIR.  The filename of the first matching file to be found is returned.
9385A matching file should contain a .note.gnu.build-id section with the
9386same NNNN+NN note as ABFD, although this check is currently not
9387implemented.
9388
9389   If DIR is NULL, the search will take place starting at the current
9390directory.
9391
9392   *Returns*
9393'NULL' on any errors or failure to locate the debug file, otherwise a
9394pointer to a heap-allocated string containing the filename.  The caller
9395is responsible for freeing this string.
9396
93972.14.1.30 'bfd_set_filename'
9398............................
9399
9400*Synopsis*
9401     const char *bfd_set_filename (bfd *abfd, const char *filename);
9402   *Description*
9403Set the filename of ABFD, copying the FILENAME parameter to bfd_alloc'd
9404memory owned by ABFD.  Returns a pointer the newly allocated name, or
9405NULL if the allocation failed.
9406
9407
9408File: bfd.info,  Node: Internal,  Next: File Caching,  Prev: Opening and Closing,  Up: BFD front end
9409
9410
9411File: bfd.info,  Node: File Caching,  Next: Linker Functions,  Prev: Internal,  Up: BFD front end
9412
94132.15 File caching
9414=================
9415
9416The file caching mechanism is embedded within BFD and allows the
9417application to open as many BFDs as it wants without regard to the
9418underlying operating system's file descriptor limit (often as low as 20
9419open files).  The module in 'cache.c' maintains a least recently used
9420list of 'bfd_cache_max_open' files, and exports the name
9421'bfd_cache_lookup', which runs around and makes sure that the required
9422BFD is open.  If not, then it chooses a file to close, closes it and
9423opens the one wanted, returning its file handle.
9424
94252.15.1 Caching functions
9426------------------------
9427
94282.15.1.1 'bfd_cache_init'
9429.........................
9430
9431*Synopsis*
9432     bool bfd_cache_init (bfd *abfd);
9433   *Description*
9434Add a newly opened BFD to the cache.
9435
94362.15.1.2 'bfd_cache_close'
9437..........................
9438
9439*Synopsis*
9440     bool bfd_cache_close (bfd *abfd);
9441   *Description*
9442Remove the BFD ABFD from the cache.  If the attached file is open, then
9443close it too.
9444
9445   *Returns*
9446'FALSE' is returned if closing the file fails, 'TRUE' is returned if all
9447is well.
9448
94492.15.1.3 'bfd_cache_close_all'
9450..............................
9451
9452*Synopsis*
9453     bool bfd_cache_close_all (void);
9454   *Description*
9455Remove all BFDs from the cache.  If the attached file is open, then
9456close it too.
9457
9458   *Returns*
9459'FALSE' is returned if closing one of the file fails, 'TRUE' is returned
9460if all is well.
9461
94622.15.1.4 'bfd_open_file'
9463........................
9464
9465*Synopsis*
9466     FILE* bfd_open_file (bfd *abfd);
9467   *Description*
9468Call the OS to open a file for ABFD.  Return the 'FILE *' (possibly
9469'NULL') that results from this operation.  Set up the BFD so that future
9470accesses know the file is open.  If the 'FILE *' returned is 'NULL',
9471then it won't have been put in the cache, so it won't have to be removed
9472from it.
9473
9474
9475File: bfd.info,  Node: Linker Functions,  Next: Hash Tables,  Prev: File Caching,  Up: BFD front end
9476
94772.16 Linker Functions
9478=====================
9479
9480The linker uses three special entry points in the BFD target vector.  It
9481is not necessary to write special routines for these entry points when
9482creating a new BFD back end, since generic versions are provided.
9483However, writing them can speed up linking and make it use significantly
9484less runtime memory.
9485
9486   The first routine creates a hash table used by the other routines.
9487The second routine adds the symbols from an object file to the hash
9488table.  The third routine takes all the object files and links them
9489together to create the output file.  These routines are designed so that
9490the linker proper does not need to know anything about the symbols in
9491the object files that it is linking.  The linker merely arranges the
9492sections as directed by the linker script and lets BFD handle the
9493details of symbols and relocs.
9494
9495   The second routine and third routines are passed a pointer to a
9496'struct bfd_link_info' structure (defined in 'bfdlink.h') which holds
9497information relevant to the link, including the linker hash table (which
9498was created by the first routine) and a set of callback functions to the
9499linker proper.
9500
9501   The generic linker routines are in 'linker.c', and use the header
9502file 'genlink.h'.  As of this writing, the only back ends which have
9503implemented versions of these routines are a.out (in 'aoutx.h') and
9504ECOFF (in 'ecoff.c').  The a.out routines are used as examples
9505throughout this section.
9506
9507* Menu:
9508
9509* Creating a Linker Hash Table::
9510* Adding Symbols to the Hash Table::
9511* Performing the Final Link::
9512
9513
9514File: bfd.info,  Node: Creating a Linker Hash Table,  Next: Adding Symbols to the Hash Table,  Prev: Linker Functions,  Up: Linker Functions
9515
95162.16.1 Creating a linker hash table
9517-----------------------------------
9518
9519The linker routines must create a hash table, which must be derived from
9520'struct bfd_link_hash_table' described in 'bfdlink.c'.  *Note Hash
9521Tables::, for information on how to create a derived hash table.  This
9522entry point is called using the target vector of the linker output file.
9523
9524   The '_bfd_link_hash_table_create' entry point must allocate and
9525initialize an instance of the desired hash table.  If the back end does
9526not require any additional information to be stored with the entries in
9527the hash table, the entry point may simply create a 'struct
9528bfd_link_hash_table'.  Most likely, however, some additional information
9529will be needed.
9530
9531   For example, with each entry in the hash table the a.out linker keeps
9532the index the symbol has in the final output file (this index number is
9533used so that when doing a relocatable link the symbol index used in the
9534output file can be quickly filled in when copying over a reloc).  The
9535a.out linker code defines the required structures and functions for a
9536hash table derived from 'struct bfd_link_hash_table'.  The a.out linker
9537hash table is created by the function
9538'NAME(aout,link_hash_table_create)'; it simply allocates space for the
9539hash table, initializes it, and returns a pointer to it.
9540
9541   When writing the linker routines for a new back end, you will
9542generally not know exactly which fields will be required until you have
9543finished.  You should simply create a new hash table which defines no
9544additional fields, and then simply add fields as they become necessary.
9545
9546
9547File: bfd.info,  Node: Adding Symbols to the Hash Table,  Next: Performing the Final Link,  Prev: Creating a Linker Hash Table,  Up: Linker Functions
9548
95492.16.2 Adding symbols to the hash table
9550---------------------------------------
9551
9552The linker proper will call the '_bfd_link_add_symbols' entry point for
9553each object file or archive which is to be linked (typically these are
9554the files named on the command line, but some may also come from the
9555linker script).  The entry point is responsible for examining the file.
9556For an object file, BFD must add any relevant symbol information to the
9557hash table.  For an archive, BFD must determine which elements of the
9558archive should be used and adding them to the link.
9559
9560   The a.out version of this entry point is
9561'NAME(aout,link_add_symbols)'.
9562
9563* Menu:
9564
9565* Differing file formats::
9566* Adding symbols from an object file::
9567* Adding symbols from an archive::
9568
9569
9570File: bfd.info,  Node: Differing file formats,  Next: Adding symbols from an object file,  Prev: Adding Symbols to the Hash Table,  Up: Adding Symbols to the Hash Table
9571
95722.16.2.1 Differing file formats
9573...............................
9574
9575Normally all the files involved in a link will be of the same format,
9576but it is also possible to link together different format object files,
9577and the back end must support that.  The '_bfd_link_add_symbols' entry
9578point is called via the target vector of the file to be added.  This has
9579an important consequence: the function may not assume that the hash
9580table is the type created by the corresponding
9581'_bfd_link_hash_table_create' vector.  All the '_bfd_link_add_symbols'
9582function can assume about the hash table is that it is derived from
9583'struct bfd_link_hash_table'.
9584
9585   Sometimes the '_bfd_link_add_symbols' function must store some
9586information in the hash table entry to be used by the '_bfd_final_link'
9587function.  In such a case the output bfd xvec must be checked to make
9588sure that the hash table was created by an object file of the same
9589format.
9590
9591   The '_bfd_final_link' routine must be prepared to handle a hash entry
9592without any extra information added by the '_bfd_link_add_symbols'
9593function.  A hash entry without extra information will also occur when
9594the linker script directs the linker to create a symbol.  Note that,
9595regardless of how a hash table entry is added, all the fields will be
9596initialized to some sort of null value by the hash table entry
9597initialization function.
9598
9599   See 'ecoff_link_add_externals' for an example of how to check the
9600output bfd before saving information (in this case, the ECOFF external
9601symbol debugging information) in a hash table entry.
9602
9603
9604File: bfd.info,  Node: Adding symbols from an object file,  Next: Adding symbols from an archive,  Prev: Differing file formats,  Up: Adding Symbols to the Hash Table
9605
96062.16.2.2 Adding symbols from an object file
9607...........................................
9608
9609When the '_bfd_link_add_symbols' routine is passed an object file, it
9610must add all externally visible symbols in that object file to the hash
9611table.  The actual work of adding the symbol to the hash table is
9612normally handled by the function '_bfd_generic_link_add_one_symbol'.
9613The '_bfd_link_add_symbols' routine is responsible for reading all the
9614symbols from the object file and passing the correct information to
9615'_bfd_generic_link_add_one_symbol'.
9616
9617   The '_bfd_link_add_symbols' routine should not use
9618'bfd_canonicalize_symtab' to read the symbols.  The point of providing
9619this routine is to avoid the overhead of converting the symbols into
9620generic 'asymbol' structures.
9621
9622   '_bfd_generic_link_add_one_symbol' handles the details of combining
9623common symbols, warning about multiple definitions, and so forth.  It
9624takes arguments which describe the symbol to add, notably symbol flags,
9625a section, and an offset.  The symbol flags include such things as
9626'BSF_WEAK' or 'BSF_INDIRECT'.  The section is a section in the object
9627file, or something like 'bfd_und_section_ptr' for an undefined symbol or
9628'bfd_com_section_ptr' for a common symbol.
9629
9630   If the '_bfd_final_link' routine is also going to need to read the
9631symbol information, the '_bfd_link_add_symbols' routine should save it
9632somewhere attached to the object file BFD. However, the information
9633should only be saved if the 'keep_memory' field of the 'info' argument
9634is TRUE, so that the '-no-keep-memory' linker switch is effective.
9635
9636   The a.out function which adds symbols from an object file is
9637'aout_link_add_object_symbols', and most of the interesting work is in
9638'aout_link_add_symbols'.  The latter saves pointers to the hash tables
9639entries created by '_bfd_generic_link_add_one_symbol' indexed by symbol
9640number, so that the '_bfd_final_link' routine does not have to call the
9641hash table lookup routine to locate the entry.
9642
9643
9644File: bfd.info,  Node: Adding symbols from an archive,  Prev: Adding symbols from an object file,  Up: Adding Symbols to the Hash Table
9645
96462.16.2.3 Adding symbols from an archive
9647.......................................
9648
9649When the '_bfd_link_add_symbols' routine is passed an archive, it must
9650look through the symbols defined by the archive and decide which
9651elements of the archive should be included in the link.  For each such
9652element it must call the 'add_archive_element' linker callback, and it
9653must add the symbols from the object file to the linker hash table.
9654(The callback may in fact indicate that a replacement BFD should be
9655used, in which case the symbols from that BFD should be added to the
9656linker hash table instead.)
9657
9658   In most cases the work of looking through the symbols in the archive
9659should be done by the '_bfd_generic_link_add_archive_symbols' function.
9660'_bfd_generic_link_add_archive_symbols' is passed a function to call to
9661make the final decision about adding an archive element to the link and
9662to do the actual work of adding the symbols to the linker hash table.
9663If the element is to be included, the 'add_archive_element' linker
9664callback routine must be called with the element as an argument, and the
9665element's symbols must be added to the linker hash table just as though
9666the element had itself been passed to the '_bfd_link_add_symbols'
9667function.
9668
9669   When the a.out '_bfd_link_add_symbols' function receives an archive,
9670it calls '_bfd_generic_link_add_archive_symbols' passing
9671'aout_link_check_archive_element' as the function argument.
9672'aout_link_check_archive_element' calls 'aout_link_check_ar_symbols'.
9673If the latter decides to add the element (an element is only added if it
9674provides a real, non-common, definition for a previously undefined or
9675common symbol) it calls the 'add_archive_element' callback and then
9676'aout_link_check_archive_element' calls 'aout_link_add_symbols' to
9677actually add the symbols to the linker hash table - possibly those of a
9678substitute BFD, if the 'add_archive_element' callback avails itself of
9679that option.
9680
9681   The ECOFF back end is unusual in that it does not normally call
9682'_bfd_generic_link_add_archive_symbols', because ECOFF archives already
9683contain a hash table of symbols.  The ECOFF back end searches the
9684archive itself to avoid the overhead of creating a new hash table.
9685
9686
9687File: bfd.info,  Node: Performing the Final Link,  Prev: Adding Symbols to the Hash Table,  Up: Linker Functions
9688
96892.16.3 Performing the final link
9690--------------------------------
9691
9692When all the input files have been processed, the linker calls the
9693'_bfd_final_link' entry point of the output BFD. This routine is
9694responsible for producing the final output file, which has several
9695aspects.  It must relocate the contents of the input sections and copy
9696the data into the output sections.  It must build an output symbol table
9697including any local symbols from the input files and the global symbols
9698from the hash table.  When producing relocatable output, it must modify
9699the input relocs and write them into the output file.  There may also be
9700object format dependent work to be done.
9701
9702   The linker will also call the 'write_object_contents' entry point
9703when the BFD is closed.  The two entry points must work together in
9704order to produce the correct output file.
9705
9706   The details of how this works are inevitably dependent upon the
9707specific object file format.  The a.out '_bfd_final_link' routine is
9708'NAME(aout,final_link)'.
9709
9710* Menu:
9711
9712* Information provided by the linker::
9713* Relocating the section contents::
9714* Writing the symbol table::
9715
9716
9717File: bfd.info,  Node: Information provided by the linker,  Next: Relocating the section contents,  Prev: Performing the Final Link,  Up: Performing the Final Link
9718
97192.16.3.1 Information provided by the linker
9720...........................................
9721
9722Before the linker calls the '_bfd_final_link' entry point, it sets up
9723some data structures for the function to use.
9724
9725   The 'input_bfds' field of the 'bfd_link_info' structure will point to
9726a list of all the input files included in the link.  These files are
9727linked through the 'link.next' field of the 'bfd' structure.
9728
9729   Each section in the output file will have a list of 'link_order'
9730structures attached to the 'map_head.link_order' field (the 'link_order'
9731structure is defined in 'bfdlink.h').  These structures describe how to
9732create the contents of the output section in terms of the contents of
9733various input sections, fill constants, and, eventually, other types of
9734information.  They also describe relocs that must be created by the BFD
9735backend, but do not correspond to any input file; this is used to
9736support -Ur, which builds constructors while generating a relocatable
9737object file.
9738
9739
9740File: bfd.info,  Node: Relocating the section contents,  Next: Writing the symbol table,  Prev: Information provided by the linker,  Up: Performing the Final Link
9741
97422.16.3.2 Relocating the section contents
9743........................................
9744
9745The '_bfd_final_link' function should look through the 'link_order'
9746structures attached to each section of the output file.  Each
9747'link_order' structure should either be handled specially, or it should
9748be passed to the function '_bfd_default_link_order' which will do the
9749right thing ('_bfd_default_link_order' is defined in 'linker.c').
9750
9751   For efficiency, a 'link_order' of type 'bfd_indirect_link_order'
9752whose associated section belongs to a BFD of the same format as the
9753output BFD must be handled specially.  This type of 'link_order'
9754describes part of an output section in terms of a section belonging to
9755one of the input files.  The '_bfd_final_link' function should read the
9756contents of the section and any associated relocs, apply the relocs to
9757the section contents, and write out the modified section contents.  If
9758performing a relocatable link, the relocs themselves must also be
9759modified and written out.
9760
9761   The functions '_bfd_relocate_contents' and '_bfd_final_link_relocate'
9762provide some general support for performing the actual relocations,
9763notably overflow checking.  Their arguments include information about
9764the symbol the relocation is against and a 'reloc_howto_type' argument
9765which describes the relocation to perform.  These functions are defined
9766in 'reloc.c'.
9767
9768   The a.out function which handles reading, relocating, and writing
9769section contents is 'aout_link_input_section'.  The actual relocation is
9770done in 'aout_link_input_section_std' and 'aout_link_input_section_ext'.
9771
9772
9773File: bfd.info,  Node: Writing the symbol table,  Prev: Relocating the section contents,  Up: Performing the Final Link
9774
97752.16.3.3 Writing the symbol table
9776.................................
9777
9778The '_bfd_final_link' function must gather all the symbols in the input
9779files and write them out.  It must also write out all the symbols in the
9780global hash table.  This must be controlled by the 'strip' and 'discard'
9781fields of the 'bfd_link_info' structure.
9782
9783   The local symbols of the input files will not have been entered into
9784the linker hash table.  The '_bfd_final_link' routine must consider each
9785input file and include the symbols in the output file.  It may be
9786convenient to do this when looking through the 'link_order' structures,
9787or it may be done by stepping through the 'input_bfds' list.
9788
9789   The '_bfd_final_link' routine must also traverse the global hash
9790table to gather all the externally visible symbols.  It is possible that
9791most of the externally visible symbols may be written out when
9792considering the symbols of each input file, but it is still necessary to
9793traverse the hash table since the linker script may have defined some
9794symbols that are not in any of the input files.
9795
9796   The 'strip' field of the 'bfd_link_info' structure controls which
9797symbols are written out.  The possible values are listed in 'bfdlink.h'.
9798If the value is 'strip_some', then the 'keep_hash' field of the
9799'bfd_link_info' structure is a hash table of symbols to keep; each
9800symbol should be looked up in this hash table, and only symbols which
9801are present should be included in the output file.
9802
9803   If the 'strip' field of the 'bfd_link_info' structure permits local
9804symbols to be written out, the 'discard' field is used to further
9805controls which local symbols are included in the output file.  If the
9806value is 'discard_l', then all local symbols which begin with a certain
9807prefix are discarded; this is controlled by the
9808'bfd_is_local_label_name' entry point.
9809
9810   The a.out backend handles symbols by calling
9811'aout_link_write_symbols' on each input BFD and then traversing the
9812global hash table with the function 'aout_link_write_other_symbol'.  It
9813builds a string table while writing out the symbols, which is written to
9814the output file at the end of 'NAME(aout,final_link)'.
9815
98162.16.3.4 'bfd_link_split_section'
9817.................................
9818
9819*Synopsis*
9820     bool bfd_link_split_section (bfd *abfd, asection *sec);
9821   *Description*
9822Return nonzero if SEC should be split during a reloceatable or final
9823link.
9824     #define bfd_link_split_section(abfd, sec) \
9825            BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
9826
9827
98282.16.3.5 'bfd_section_already_linked'
9829.....................................
9830
9831*Synopsis*
9832     bool bfd_section_already_linked (bfd *abfd,
9833         asection *sec,
9834         struct bfd_link_info *info);
9835   *Description*
9836Check if DATA has been already linked during a reloceatable or final
9837link.  Return TRUE if it has.
9838     #define bfd_section_already_linked(abfd, sec, info) \
9839            BFD_SEND (abfd, _section_already_linked, (abfd, sec, info))
9840
9841
98422.16.3.6 'bfd_generic_define_common_symbol'
9843...........................................
9844
9845*Synopsis*
9846     bool bfd_generic_define_common_symbol
9847        (bfd *output_bfd, struct bfd_link_info *info,
9848         struct bfd_link_hash_entry *h);
9849   *Description*
9850Convert common symbol H into a defined symbol.  Return TRUE on success
9851and FALSE on failure.
9852     #define bfd_define_common_symbol(output_bfd, info, h) \
9853            BFD_SEND (output_bfd, _bfd_define_common_symbol, (output_bfd, info, h))
9854
9855
98562.16.3.7 '_bfd_generic_link_hide_symbol'
9857........................................
9858
9859*Synopsis*
9860     void _bfd_generic_link_hide_symbol
9861        (bfd *output_bfd, struct bfd_link_info *info,
9862         struct bfd_link_hash_entry *h);
9863   *Description*
9864Hide symbol H.  This is an internal function.  It should not be called
9865from outside the BFD library.
9866     #define bfd_link_hide_symbol(output_bfd, info, h) \
9867            BFD_SEND (output_bfd, _bfd_link_hide_symbol, (output_bfd, info, h))
9868
9869
98702.16.3.8 'bfd_generic_define_start_stop'
9871........................................
9872
9873*Synopsis*
9874     struct bfd_link_hash_entry *bfd_generic_define_start_stop
9875        (struct bfd_link_info *info,
9876         const char *symbol, asection *sec);
9877   *Description*
9878Define a __start, __stop, .startof.  or .sizeof.  symbol.  Return the
9879symbol or NULL if no such undefined symbol exists.
9880     #define bfd_define_start_stop(output_bfd, info, symbol, sec) \
9881            BFD_SEND (output_bfd, _bfd_define_start_stop, (info, symbol, sec))
9882
9883
98842.16.3.9 'bfd_find_version_for_sym'
9885...................................
9886
9887*Synopsis*
9888     struct bfd_elf_version_tree * bfd_find_version_for_sym
9889        (struct bfd_elf_version_tree *verdefs,
9890         const char *sym_name, bool *hide);
9891   *Description*
9892Search an elf version script tree for symbol versioning info and export
9893/ don't-export status for a given symbol.  Return non-NULL on success
9894and NULL on failure; also sets the output 'hide' boolean parameter.
9895
98962.16.3.10 'bfd_hide_sym_by_version'
9897...................................
9898
9899*Synopsis*
9900     bool bfd_hide_sym_by_version
9901        (struct bfd_elf_version_tree *verdefs, const char *sym_name);
9902   *Description*
9903Search an elf version script tree for symbol versioning info for a given
9904symbol.  Return TRUE if the symbol is hidden.
9905
99062.16.3.11 'bfd_link_check_relocs'
9907.................................
9908
9909*Synopsis*
9910     bool bfd_link_check_relocs
9911        (bfd *abfd, struct bfd_link_info *info);
9912   *Description*
9913Checks the relocs in ABFD for validity.  Does not execute the relocs.
9914Return TRUE if everything is OK, FALSE otherwise.  This is the external
9915entry point to this code.
9916
99172.16.3.12 '_bfd_generic_link_check_relocs'
9918..........................................
9919
9920*Synopsis*
9921     bool _bfd_generic_link_check_relocs
9922        (bfd *abfd, struct bfd_link_info *info);
9923   *Description*
9924Stub function for targets that do not implement reloc checking.  Return
9925TRUE. This is an internal function.  It should not be called from
9926outside the BFD library.
9927
99282.16.3.13 'bfd_merge_private_bfd_data'
9929......................................
9930
9931*Synopsis*
9932     bool bfd_merge_private_bfd_data
9933        (bfd *ibfd, struct bfd_link_info *info);
9934   *Description*
9935Merge private BFD information from the BFD IBFD to the the output file
9936BFD when linking.  Return 'TRUE' on success, 'FALSE' on error.  Possible
9937error returns are:
9938
9939   * 'bfd_error_no_memory' - Not enough memory exists to create private
9940     data for OBFD.
9941     #define bfd_merge_private_bfd_data(ibfd, info) \
9942            BFD_SEND ((info)->output_bfd, _bfd_merge_private_bfd_data, \
9943                      (ibfd, info))
9944
99452.16.3.14 '_bfd_generic_verify_endian_match'
9946............................................
9947
9948*Synopsis*
9949     bool _bfd_generic_verify_endian_match
9950        (bfd *ibfd, struct bfd_link_info *info);
9951   *Description*
9952Can be used from / for bfd_merge_private_bfd_data to check that
9953endianness matches between input and output file.  Returns TRUE for a
9954match, otherwise returns FALSE and emits an error.
9955
9956
9957File: bfd.info,  Node: Hash Tables,  Prev: Linker Functions,  Up: BFD front end
9958
99592.17 Hash Tables
9960================
9961
9962BFD provides a simple set of hash table functions.  Routines are
9963provided to initialize a hash table, to free a hash table, to look up a
9964string in a hash table and optionally create an entry for it, and to
9965traverse a hash table.  There is currently no routine to delete an
9966string from a hash table.
9967
9968   The basic hash table does not permit any data to be stored with a
9969string.  However, a hash table is designed to present a base class from
9970which other types of hash tables may be derived.  These derived types
9971may store additional information with the string.  Hash tables were
9972implemented in this way, rather than simply providing a data pointer in
9973a hash table entry, because they were designed for use by the linker
9974back ends.  The linker may create thousands of hash table entries, and
9975the overhead of allocating private data and storing and following
9976pointers becomes noticeable.
9977
9978   The basic hash table code is in 'hash.c'.
9979
9980* Menu:
9981
9982* Creating and Freeing a Hash Table::
9983* Looking Up or Entering a String::
9984* Traversing a Hash Table::
9985* Deriving a New Hash Table Type::
9986
9987
9988File: bfd.info,  Node: Creating and Freeing a Hash Table,  Next: Looking Up or Entering a String,  Prev: Hash Tables,  Up: Hash Tables
9989
99902.17.1 Creating and freeing a hash table
9991----------------------------------------
9992
9993To create a hash table, create an instance of a 'struct bfd_hash_table'
9994(defined in 'bfd.h') and call 'bfd_hash_table_init' (if you know
9995approximately how many entries you will need, the function
9996'bfd_hash_table_init_n', which takes a SIZE argument, may be used).
9997'bfd_hash_table_init' returns 'FALSE' if some sort of error occurs.
9998
9999   The function 'bfd_hash_table_init' take as an argument a function to
10000use to create new entries.  For a basic hash table, use the function
10001'bfd_hash_newfunc'.  *Note Deriving a New Hash Table Type::, for why you
10002would want to use a different value for this argument.
10003
10004   'bfd_hash_table_init' will create an objalloc which will be used to
10005allocate new entries.  You may allocate memory on this objalloc using
10006'bfd_hash_allocate'.
10007
10008   Use 'bfd_hash_table_free' to free up all the memory that has been
10009allocated for a hash table.  This will not free up the 'struct
10010bfd_hash_table' itself, which you must provide.
10011
10012   Use 'bfd_hash_set_default_size' to set the default size of hash table
10013to use.
10014
10015
10016File: bfd.info,  Node: Looking Up or Entering a String,  Next: Traversing a Hash Table,  Prev: Creating and Freeing a Hash Table,  Up: Hash Tables
10017
100182.17.2 Looking up or entering a string
10019--------------------------------------
10020
10021The function 'bfd_hash_lookup' is used both to look up a string in the
10022hash table and to create a new entry.
10023
10024   If the CREATE argument is 'FALSE', 'bfd_hash_lookup' will look up a
10025string.  If the string is found, it will returns a pointer to a 'struct
10026bfd_hash_entry'.  If the string is not found in the table
10027'bfd_hash_lookup' will return 'NULL'.  You should not modify any of the
10028fields in the returns 'struct bfd_hash_entry'.
10029
10030   If the CREATE argument is 'TRUE', the string will be entered into the
10031hash table if it is not already there.  Either way a pointer to a
10032'struct bfd_hash_entry' will be returned, either to the existing
10033structure or to a newly created one.  In this case, a 'NULL' return
10034means that an error occurred.
10035
10036   If the CREATE argument is 'TRUE', and a new entry is created, the
10037COPY argument is used to decide whether to copy the string onto the hash
10038table objalloc or not.  If COPY is passed as 'FALSE', you must be
10039careful not to deallocate or modify the string as long as the hash table
10040exists.
10041
10042
10043File: bfd.info,  Node: Traversing a Hash Table,  Next: Deriving a New Hash Table Type,  Prev: Looking Up or Entering a String,  Up: Hash Tables
10044
100452.17.3 Traversing a hash table
10046------------------------------
10047
10048The function 'bfd_hash_traverse' may be used to traverse a hash table,
10049calling a function on each element.  The traversal is done in a random
10050order.
10051
10052   'bfd_hash_traverse' takes as arguments a function and a generic 'void
10053*' pointer.  The function is called with a hash table entry (a 'struct
10054bfd_hash_entry *') and the generic pointer passed to
10055'bfd_hash_traverse'.  The function must return a 'boolean' value, which
10056indicates whether to continue traversing the hash table.  If the
10057function returns 'FALSE', 'bfd_hash_traverse' will stop the traversal
10058and return immediately.
10059
10060
10061File: bfd.info,  Node: Deriving a New Hash Table Type,  Prev: Traversing a Hash Table,  Up: Hash Tables
10062
100632.17.4 Deriving a new hash table type
10064-------------------------------------
10065
10066Many uses of hash tables want to store additional information which each
10067entry in the hash table.  Some also find it convenient to store
10068additional information with the hash table itself.  This may be done
10069using a derived hash table.
10070
10071   Since C is not an object oriented language, creating a derived hash
10072table requires sticking together some boilerplate routines with a few
10073differences specific to the type of hash table you want to create.
10074
10075   An example of a derived hash table is the linker hash table.  The
10076structures for this are defined in 'bfdlink.h'.  The functions are in
10077'linker.c'.
10078
10079   You may also derive a hash table from an already derived hash table.
10080For example, the a.out linker backend code uses a hash table derived
10081from the linker hash table.
10082
10083* Menu:
10084
10085* Define the Derived Structures::
10086* Write the Derived Creation Routine::
10087* Write Other Derived Routines::
10088
10089
10090File: bfd.info,  Node: Define the Derived Structures,  Next: Write the Derived Creation Routine,  Prev: Deriving a New Hash Table Type,  Up: Deriving a New Hash Table Type
10091
100922.17.4.1 Define the derived structures
10093......................................
10094
10095You must define a structure for an entry in the hash table, and a
10096structure for the hash table itself.
10097
10098   The first field in the structure for an entry in the hash table must
10099be of the type used for an entry in the hash table you are deriving
10100from.  If you are deriving from a basic hash table this is 'struct
10101bfd_hash_entry', which is defined in 'bfd.h'.  The first field in the
10102structure for the hash table itself must be of the type of the hash
10103table you are deriving from itself.  If you are deriving from a basic
10104hash table, this is 'struct bfd_hash_table'.
10105
10106   For example, the linker hash table defines 'struct
10107bfd_link_hash_entry' (in 'bfdlink.h').  The first field, 'root', is of
10108type 'struct bfd_hash_entry'.  Similarly, the first field in 'struct
10109bfd_link_hash_table', 'table', is of type 'struct bfd_hash_table'.
10110
10111
10112File: bfd.info,  Node: Write the Derived Creation Routine,  Next: Write Other Derived Routines,  Prev: Define the Derived Structures,  Up: Deriving a New Hash Table Type
10113
101142.17.4.2 Write the derived creation routine
10115...........................................
10116
10117You must write a routine which will create and initialize an entry in
10118the hash table.  This routine is passed as the function argument to
10119'bfd_hash_table_init'.
10120
10121   In order to permit other hash tables to be derived from the hash
10122table you are creating, this routine must be written in a standard way.
10123
10124   The first argument to the creation routine is a pointer to a hash
10125table entry.  This may be 'NULL', in which case the routine should
10126allocate the right amount of space.  Otherwise the space has already
10127been allocated by a hash table type derived from this one.
10128
10129   After allocating space, the creation routine must call the creation
10130routine of the hash table type it is derived from, passing in a pointer
10131to the space it just allocated.  This will initialize any fields used by
10132the base hash table.
10133
10134   Finally the creation routine must initialize any local fields for the
10135new hash table type.
10136
10137   Here is a boilerplate example of a creation routine.  FUNCTION_NAME
10138is the name of the routine.  ENTRY_TYPE is the type of an entry in the
10139hash table you are creating.  BASE_NEWFUNC is the name of the creation
10140routine of the hash table type your hash table is derived from.
10141
10142     struct bfd_hash_entry *
10143     FUNCTION_NAME (struct bfd_hash_entry *entry,
10144                          struct bfd_hash_table *table,
10145                          const char *string)
10146     {
10147       struct ENTRY_TYPE *ret = (ENTRY_TYPE *) entry;
10148
10149      /* Allocate the structure if it has not already been allocated by a
10150         derived class.  */
10151       if (ret == NULL)
10152         {
10153           ret = bfd_hash_allocate (table, sizeof (* ret));
10154           if (ret == NULL)
10155             return NULL;
10156         }
10157
10158      /* Call the allocation method of the base class.  */
10159       ret = ((ENTRY_TYPE *)
10160              BASE_NEWFUNC ((struct bfd_hash_entry *) ret, table, string));
10161
10162      /* Initialize the local fields here.  */
10163
10164       return (struct bfd_hash_entry *) ret;
10165     }
10166   *Description*
10167The creation routine for the linker hash table, which is in 'linker.c',
10168looks just like this example.  FUNCTION_NAME is
10169'_bfd_link_hash_newfunc'.  ENTRY_TYPE is 'struct bfd_link_hash_entry'.
10170BASE_NEWFUNC is 'bfd_hash_newfunc', the creation routine for a basic
10171hash table.
10172
10173   '_bfd_link_hash_newfunc' also initializes the local fields in a
10174linker hash table entry: 'type', 'written' and 'next'.
10175
10176
10177File: bfd.info,  Node: Write Other Derived Routines,  Prev: Write the Derived Creation Routine,  Up: Deriving a New Hash Table Type
10178
101792.17.4.3 Write other derived routines
10180.....................................
10181
10182You will want to write other routines for your new hash table, as well.
10183
10184   You will want an initialization routine which calls the
10185initialization routine of the hash table you are deriving from and
10186initializes any other local fields.  For the linker hash table, this is
10187'_bfd_link_hash_table_init' in 'linker.c'.
10188
10189   You will want a lookup routine which calls the lookup routine of the
10190hash table you are deriving from and casts the result.  The linker hash
10191table uses 'bfd_link_hash_lookup' in 'linker.c' (this actually takes an
10192additional argument which it uses to decide how to return the looked up
10193value).
10194
10195   You may want a traversal routine.  This should just call the
10196traversal routine of the hash table you are deriving from with
10197appropriate casts.  The linker hash table uses 'bfd_link_hash_traverse'
10198in 'linker.c'.
10199
10200   These routines may simply be defined as macros.  For example, the
10201a.out backend linker hash table, which is derived from the linker hash
10202table, uses macros for the lookup and traversal routines.  These are
10203'aout_link_hash_lookup' and 'aout_link_hash_traverse' in aoutx.h.
10204
10205
10206File: bfd.info,  Node: BFD back ends,  Next: GNU Free Documentation License,  Prev: BFD front end,  Up: Top
10207
102083 BFD back ends
10209***************
10210
10211* Menu:
10212
10213* What to Put Where::
10214* aout ::	a.out backends
10215* coff ::	coff backends
10216* elf  ::	elf backends
10217* mmo  ::	mmo backend
10218
10219
10220File: bfd.info,  Node: What to Put Where,  Next: aout,  Prev: BFD back ends,  Up: BFD back ends
10221
102223.1 What to Put Where
10223=====================
10224
10225All of BFD lives in one directory.
10226
10227
10228File: bfd.info,  Node: aout,  Next: coff,  Prev: What to Put Where,  Up: BFD back ends
10229
102303.2 a.out backends
10231==================
10232
10233*Description*
10234BFD supports a number of different flavours of a.out format, though the
10235major differences are only the sizes of the structures on disk, and the
10236shape of the relocation information.
10237
10238   The support is split into a basic support file 'aoutx.h' and other
10239files which derive functions from the base.  One derivation file is
10240'aoutf1.h' (for a.out flavour 1), and adds to the basic a.out functions
10241support for sun3, sun4, and 386 a.out files, to create a target jump
10242vector for a specific target.
10243
10244   This information is further split out into more specific files for
10245each machine, including 'sunos.c' for sun3 and sun4, and 'demo64.c' for
10246a demonstration of a 64 bit a.out format.
10247
10248   The base file 'aoutx.h' defines general mechanisms for reading and
10249writing records to and from disk and various other methods which BFD
10250requires.  It is included by 'aout32.c' and 'aout64.c' to form the names
10251'aout_32_swap_exec_header_in', 'aout_64_swap_exec_header_in', etc.
10252
10253   As an example, this is what goes on to make the back end for a sun4,
10254from 'aout32.c':
10255
10256            #define ARCH_SIZE 32
10257            #include "aoutx.h"
10258
10259   Which exports names:
10260
10261            ...
10262            aout_32_canonicalize_reloc
10263            aout_32_find_nearest_line
10264            aout_32_get_lineno
10265            aout_32_get_reloc_upper_bound
10266            ...
10267
10268   from 'sunos.c':
10269
10270            #define TARGET_NAME "a.out-sunos-big"
10271            #define VECNAME    sparc_aout_sunos_be_vec
10272            #include "aoutf1.h"
10273
10274   requires all the names from 'aout32.c', and produces the jump vector
10275
10276            sparc_aout_sunos_be_vec
10277
10278   The file 'host-aout.c' is a special case.  It is for a large set of
10279hosts that use "more or less standard" a.out files, and for which
10280cross-debugging is not interesting.  It uses the standard 32-bit a.out
10281support routines, but determines the file offsets and addresses of the
10282text, data, and BSS sections, the machine architecture and machine type,
10283and the entry point address, in a host-dependent manner.  Once these
10284values have been determined, generic code is used to handle the object
10285file.
10286
10287   When porting it to run on a new system, you must supply:
10288
10289             HOST_PAGE_SIZE
10290             HOST_SEGMENT_SIZE
10291             HOST_MACHINE_ARCH       (optional)
10292             HOST_MACHINE_MACHINE    (optional)
10293             HOST_TEXT_START_ADDR
10294             HOST_STACK_END_ADDR
10295
10296   in the file '../include/sys/h-XXX.h' (for your host).  These values,
10297plus the structures and macros defined in 'a.out.h' on your host system,
10298will produce a BFD target that will access ordinary a.out files on your
10299host.  To configure a new machine to use 'host-aout.c', specify:
10300
10301            TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec
10302            TDEPFILES= host-aout.o trad-core.o
10303
10304   in the 'config/XXX.mt' file, and modify 'configure.ac' to use the
10305'XXX.mt' file (by setting "'bfd_target=XXX'") when your configuration is
10306selected.
10307
103083.2.1 Relocations
10309-----------------
10310
10311*Description*
10312The file 'aoutx.h' provides for both the _standard_ and _extended_ forms
10313of a.out relocation records.
10314
10315   The standard records contain only an address, a symbol index, and a
10316type field.  The extended records also have a full integer for an
10317addend.
10318
103193.2.2 Internal entry points
10320---------------------------
10321
10322*Description*
10323'aoutx.h' exports several routines for accessing the contents of an
10324a.out file, which are gathered and exported in turn by various format
10325specific files (eg sunos.c).
10326
103273.2.2.1 'aout_SIZE_swap_exec_header_in'
10328.......................................
10329
10330*Synopsis*
10331     void aout_SIZE_swap_exec_header_in,
10332        (bfd *abfd,
10333         struct external_exec *bytes,
10334         struct internal_exec *execp);
10335   *Description*
10336Swap the information in an executable header RAW_BYTES taken from a raw
10337byte stream memory image into the internal exec header structure EXECP.
10338
103393.2.2.2 'aout_SIZE_swap_exec_header_out'
10340........................................
10341
10342*Synopsis*
10343     void aout_SIZE_swap_exec_header_out
10344        (bfd *abfd,
10345         struct internal_exec *execp,
10346         struct external_exec *raw_bytes);
10347   *Description*
10348Swap the information in an internal exec header structure EXECP into the
10349buffer RAW_BYTES ready for writing to disk.
10350
103513.2.2.3 'aout_SIZE_some_aout_object_p'
10352......................................
10353
10354*Synopsis*
10355     const bfd_target *aout_SIZE_some_aout_object_p
10356        (bfd *abfd,
10357         struct internal_exec *execp,
10358         const bfd_target *(*callback_to_real_object_p) (bfd *));
10359   *Description*
10360Some a.out variant thinks that the file open in ABFD checking is an
10361a.out file.  Do some more checking, and set up for access if it really
10362is.  Call back to the calling environment's "finish up" function just
10363before returning, to handle any last-minute setup.
10364
103653.2.2.4 'aout_SIZE_mkobject'
10366............................
10367
10368*Synopsis*
10369     bool aout_SIZE_mkobject, (bfd *abfd);
10370   *Description*
10371Initialize BFD ABFD for use with a.out files.
10372
103733.2.2.5 'aout_SIZE_machine_type'
10374................................
10375
10376*Synopsis*
10377     enum machine_type  aout_SIZE_machine_type
10378        (enum bfd_architecture arch,
10379         unsigned long machine,
10380         bool *unknown);
10381   *Description*
10382Keep track of machine architecture and machine type for a.out's.  Return
10383the 'machine_type' for a particular architecture and machine, or
10384'M_UNKNOWN' if that exact architecture and machine can't be represented
10385in a.out format.
10386
10387   If the architecture is understood, machine type 0 (default) is always
10388understood.
10389
103903.2.2.6 'aout_SIZE_set_arch_mach'
10391.................................
10392
10393*Synopsis*
10394     bool aout_SIZE_set_arch_mach,
10395        (bfd *,
10396         enum bfd_architecture arch,
10397         unsigned long machine);
10398   *Description*
10399Set the architecture and the machine of the BFD ABFD to the values ARCH
10400and MACHINE.  Verify that ABFD's format can support the architecture
10401required.
10402
104033.2.2.7 'aout_SIZE_new_section_hook'
10404....................................
10405
10406*Synopsis*
10407     bool aout_SIZE_new_section_hook,
10408        (bfd *abfd,
10409         asection *newsect);
10410   *Description*
10411Called by the BFD in response to a 'bfd_make_section' request.
10412
10413
10414File: bfd.info,  Node: coff,  Next: elf,  Prev: aout,  Up: BFD back ends
10415
104163.3 coff backends
10417=================
10418
10419BFD supports a number of different flavours of coff format.  The major
10420differences between formats are the sizes and alignments of fields in
10421structures on disk, and the occasional extra field.
10422
10423   Coff in all its varieties is implemented with a few common files and
10424a number of implementation specific files.  For example, the i386 coff
10425format is implemented in the file 'coff-i386.c'.  This file '#include's
10426'coff/i386.h' which defines the external structure of the coff format
10427for the i386, and 'coff/internal.h' which defines the internal
10428structure.  'coff-i386.c' also defines the relocations used by the i386
10429coff format *Note Relocations::.
10430
104313.3.1 Porting to a new version of coff
10432--------------------------------------
10433
10434The recommended method is to select from the existing implementations
10435the version of coff which is most like the one you want to use.  For
10436example, we'll say that i386 coff is the one you select, and that your
10437coff flavour is called foo.  Copy 'i386coff.c' to 'foocoff.c', copy
10438'../include/coff/i386.h' to '../include/coff/foo.h', and add the lines
10439to 'targets.c' and 'Makefile.in' so that your new back end is used.
10440Alter the shapes of the structures in '../include/coff/foo.h' so that
10441they match what you need.  You will probably also have to add '#ifdef's
10442to the code in 'coff/internal.h' and 'coffcode.h' if your version of
10443coff is too wild.
10444
10445   You can verify that your new BFD backend works quite simply by
10446building 'objdump' from the 'binutils' directory, and making sure that
10447its version of what's going on and your host system's idea (assuming it
10448has the pretty standard coff dump utility, usually called 'att-dump' or
10449just 'dump') are the same.  Then clean up your code, and send what
10450you've done to Cygnus.  Then your stuff will be in the next release, and
10451you won't have to keep integrating it.
10452
104533.3.2 How the coff backend works
10454--------------------------------
10455
104563.3.2.1 File layout
10457...................
10458
10459The Coff backend is split into generic routines that are applicable to
10460any Coff target and routines that are specific to a particular target.
10461The target-specific routines are further split into ones which are
10462basically the same for all Coff targets except that they use the
10463external symbol format or use different values for certain constants.
10464
10465   The generic routines are in 'coffgen.c'.  These routines work for any
10466Coff target.  They use some hooks into the target specific code; the
10467hooks are in a 'bfd_coff_backend_data' structure, one of which exists
10468for each target.
10469
10470   The essentially similar target-specific routines are in 'coffcode.h'.
10471This header file includes executable C code.  The various Coff targets
10472first include the appropriate Coff header file, make any special defines
10473that are needed, and then include 'coffcode.h'.
10474
10475   Some of the Coff targets then also have additional routines in the
10476target source file itself.
10477
104783.3.2.2 Coff long section names
10479...............................
10480
10481In the standard Coff object format, section names are limited to the
10482eight bytes available in the 's_name' field of the 'SCNHDR' section
10483header structure.  The format requires the field to be NUL-padded, but
10484not necessarily NUL-terminated, so the longest section names permitted
10485are a full eight characters.
10486
10487   The Microsoft PE variants of the Coff object file format add an
10488extension to support the use of long section names.  This extension is
10489defined in section 4 of the Microsoft PE/COFF specification (rev 8.1).
10490If a section name is too long to fit into the section header's 's_name'
10491field, it is instead placed into the string table, and the 's_name'
10492field is filled with a slash ("/") followed by the ASCII decimal
10493representation of the offset of the full name relative to the string
10494table base.
10495
10496   Note that this implies that the extension can only be used in object
10497files, as executables do not contain a string table.  The standard
10498specifies that long section names from objects emitted into executable
10499images are to be truncated.
10500
10501   However, as a GNU extension, BFD can generate executable images that
10502contain a string table and long section names.  This would appear to be
10503technically valid, as the standard only says that Coff debugging
10504information is deprecated, not forbidden, and in practice it works,
10505although some tools that parse PE files expecting the MS standard format
10506may become confused; 'PEview' is one known example.
10507
10508   The functionality is supported in BFD by code implemented under the
10509control of the macro 'COFF_LONG_SECTION_NAMES'.  If not defined, the
10510format does not support long section names in any way.  If defined, it
10511is used to initialise a flag, '_bfd_coff_long_section_names', and a hook
10512function pointer, '_bfd_coff_set_long_section_names', in the Coff
10513backend data structure.  The flag controls the generation of long
10514section names in output BFDs at runtime; if it is false, as it will be
10515by default when generating an executable image, long section names are
10516truncated; if true, the long section names extension is employed.  The
10517hook points to a function that allows the value of the flag to be
10518altered at runtime, on formats that support long section names at all;
10519on other formats it points to a stub that returns an error indication.
10520
10521   With input BFDs, the flag is set according to whether any long
10522section names are detected while reading the section headers.  For a
10523completely new BFD, the flag is set to the default for the target
10524format.  This information can be used by a client of the BFD library
10525when deciding what output format to generate, and means that a BFD that
10526is opened for read and subsequently converted to a writeable BFD and
10527modified in-place will retain whatever format it had on input.
10528
10529   If 'COFF_LONG_SECTION_NAMES' is simply defined (blank), or is defined
10530to the value "1", then long section names are enabled by default; if it
10531is defined to the value zero, they are disabled by default (but still
10532accepted in input BFDs).  The header 'coffcode.h' defines a macro,
10533'COFF_DEFAULT_LONG_SECTION_NAMES', which is used in the backends to
10534initialise the backend data structure fields appropriately; see the
10535comments for further detail.
10536
105373.3.2.3 Bit twiddling
10538.....................
10539
10540Each flavour of coff supported in BFD has its own header file describing
10541the external layout of the structures.  There is also an internal
10542description of the coff layout, in 'coff/internal.h'.  A major function
10543of the coff backend is swapping the bytes and twiddling the bits to
10544translate the external form of the structures into the normal internal
10545form.  This is all performed in the 'bfd_swap'_thing_direction routines.
10546Some elements are different sizes between different versions of coff; it
10547is the duty of the coff version specific include file to override the
10548definitions of various packing routines in 'coffcode.h'.  E.g., the size
10549of line number entry in coff is sometimes 16 bits, and sometimes 32
10550bits.  '#define'ing 'PUT_LNSZ_LNNO' and 'GET_LNSZ_LNNO' will select the
10551correct one.  No doubt, some day someone will find a version of coff
10552which has a varying field size not catered to at the moment.  To port
10553BFD, that person will have to add more '#defines'.  Three of the bit
10554twiddling routines are exported to 'gdb'; 'coff_swap_aux_in',
10555'coff_swap_sym_in' and 'coff_swap_lineno_in'.  'GDB' reads the symbol
10556table on its own, but uses BFD to fix things up.  More of the bit
10557twiddlers are exported for 'gas'; 'coff_swap_aux_out',
10558'coff_swap_sym_out', 'coff_swap_lineno_out', 'coff_swap_reloc_out',
10559'coff_swap_filehdr_out', 'coff_swap_aouthdr_out',
10560'coff_swap_scnhdr_out'.  'Gas' currently keeps track of all the symbol
10561table and reloc drudgery itself, thereby saving the internal BFD
10562overhead, but uses BFD to swap things on the way out, making cross ports
10563much safer.  Doing so also allows BFD (and thus the linker) to use the
10564same header files as 'gas', which makes one avenue to disaster
10565disappear.
10566
105673.3.2.4 Symbol reading
10568......................
10569
10570The simple canonical form for symbols used by BFD is not rich enough to
10571keep all the information available in a coff symbol table.  The back end
10572gets around this problem by keeping the original symbol table around,
10573"behind the scenes".
10574
10575   When a symbol table is requested (through a call to
10576'bfd_canonicalize_symtab'), a request gets through to
10577'coff_get_normalized_symtab'.  This reads the symbol table from the coff
10578file and swaps all the structures inside into the internal form.  It
10579also fixes up all the pointers in the table (represented in the file by
10580offsets from the first symbol in the table) into physical pointers to
10581elements in the new internal table.  This involves some work since the
10582meanings of fields change depending upon context: a field that is a
10583pointer to another structure in the symbol table at one moment may be
10584the size in bytes of a structure at the next.  Another pass is made over
10585the table.  All symbols which mark file names ('C_FILE' symbols) are
10586modified so that the internal string points to the value in the auxent
10587(the real filename) rather than the normal text associated with the
10588symbol ('".file"').
10589
10590   At this time the symbol names are moved around.  Coff stores all
10591symbols less than nine characters long physically within the symbol
10592table; longer strings are kept at the end of the file in the string
10593table.  This pass moves all strings into memory and replaces them with
10594pointers to the strings.
10595
10596   The symbol table is massaged once again, this time to create the
10597canonical table used by the BFD application.  Each symbol is inspected
10598in turn, and a decision made (using the 'sclass' field) about the
10599various flags to set in the 'asymbol'.  *Note Symbols::.  The generated
10600canonical table shares strings with the hidden internal symbol table.
10601
10602   Any linenumbers are read from the coff file too, and attached to the
10603symbols which own the functions the linenumbers belong to.
10604
106053.3.2.5 Symbol writing
10606......................
10607
10608Writing a symbol to a coff file which didn't come from a coff file will
10609lose any debugging information.  The 'asymbol' structure remembers the
10610BFD from which the symbol was taken, and on output the back end makes
10611sure that the same destination target as source target is present.
10612
10613   When the symbols have come from a coff file then all the debugging
10614information is preserved.
10615
10616   Symbol tables are provided for writing to the back end in a vector of
10617pointers to pointers.  This allows applications like the linker to
10618accumulate and output large symbol tables without having to do too much
10619byte copying.
10620
10621   This function runs through the provided symbol table and patches each
10622symbol marked as a file place holder ('C_FILE') to point to the next
10623file place holder in the list.  It also marks each 'offset' field in the
10624list with the offset from the first symbol of the current symbol.
10625
10626   Another function of this procedure is to turn the canonical value
10627form of BFD into the form used by coff.  Internally, BFD expects symbol
10628values to be offsets from a section base; so a symbol physically at
106290x120, but in a section starting at 0x100, would have the value 0x20.
10630Coff expects symbols to contain their final value, so symbols have their
10631values changed at this point to reflect their sum with their owning
10632section.  This transformation uses the 'output_section' field of the
10633'asymbol''s 'asection' *Note Sections::.
10634
10635   * 'coff_mangle_symbols'
10636   This routine runs though the provided symbol table and uses the
10637offsets generated by the previous pass and the pointers generated when
10638the symbol table was read in to create the structured hierarchy required
10639by coff.  It changes each pointer to a symbol into the index into the
10640symbol table of the asymbol.
10641
10642   * 'coff_write_symbols'
10643   This routine runs through the symbol table and patches up the symbols
10644from their internal form into the coff way, calls the bit twiddlers, and
10645writes out the table to the file.
10646
106473.3.2.6 'coff_symbol_type'
10648..........................
10649
10650*Description*
10651The hidden information for an 'asymbol' is described in a
10652'combined_entry_type':
10653
10654
10655     typedef struct coff_ptr_struct
10656     {
10657       /* Remembers the offset from the first symbol in the file for
10658          this symbol. Generated by coff_renumber_symbols.  */
10659       unsigned int offset;
10660
10661       /* Should the value of this symbol be renumbered.  Used for
10662          XCOFF C_BSTAT symbols.  Set by coff_slurp_symbol_table.  */
10663       unsigned int fix_value : 1;
10664
10665       /* Should the tag field of this symbol be renumbered.
10666          Created by coff_pointerize_aux.  */
10667       unsigned int fix_tag : 1;
10668
10669       /* Should the endidx field of this symbol be renumbered.
10670          Created by coff_pointerize_aux.  */
10671       unsigned int fix_end : 1;
10672
10673       /* Should the x_csect.x_scnlen field be renumbered.
10674          Created by coff_pointerize_aux.  */
10675       unsigned int fix_scnlen : 1;
10676
10677       /* Fix up an XCOFF C_BINCL/C_EINCL symbol.  The value is the
10678          index into the line number entries.  Set by coff_slurp_symbol_table.  */
10679       unsigned int fix_line : 1;
10680
10681       /* The container for the symbol structure as read and translated
10682          from the file.  */
10683       union
10684       {
10685         union internal_auxent auxent;
10686         struct internal_syment syment;
10687       } u;
10688
10689      /* Selector for the union above.  */
10690      bool is_sym;
10691
10692      /* An extra pointer which can used by format based on COFF (like XCOFF)
10693         to provide extra information to their backend.  */
10694      void *extrap;
10695     } combined_entry_type;
10696
10697
10698     /* Each canonical asymbol really looks like this: */
10699
10700     typedef struct coff_symbol_struct
10701     {
10702       /* The actual symbol which the rest of BFD works with */
10703       asymbol symbol;
10704
10705       /* A pointer to the hidden information for this symbol */
10706       combined_entry_type *native;
10707
10708       /* A pointer to the linenumber information for this symbol */
10709       struct lineno_cache_entry *lineno;
10710
10711       /* Have the line numbers been relocated yet ? */
10712       bool done_lineno;
10713     } coff_symbol_type;
10714
107153.3.2.7 'bfd_coff_backend_data'
10716...............................
10717
10718     /* COFF symbol classifications.  */
10719
10720     enum coff_symbol_classification
10721     {
10722       /* Global symbol.  */
10723       COFF_SYMBOL_GLOBAL,
10724       /* Common symbol.  */
10725       COFF_SYMBOL_COMMON,
10726       /* Undefined symbol.  */
10727       COFF_SYMBOL_UNDEFINED,
10728       /* Local symbol.  */
10729       COFF_SYMBOL_LOCAL,
10730       /* PE section symbol.  */
10731       COFF_SYMBOL_PE_SECTION
10732     };
10733
10734     typedef asection * (*coff_gc_mark_hook_fn)
10735       (asection *, struct bfd_link_info *, struct internal_reloc *,
10736        struct coff_link_hash_entry *, struct internal_syment *);
10737
10738   Special entry points for gdb to swap in coff symbol table parts:
10739     typedef struct
10740     {
10741       void (*_bfd_coff_swap_aux_in)
10742         (bfd *, void *, int, int, int, int, void *);
10743
10744       void (*_bfd_coff_swap_sym_in)
10745         (bfd *, void *, void *);
10746
10747       void (*_bfd_coff_swap_lineno_in)
10748         (bfd *, void *, void *);
10749
10750       unsigned int (*_bfd_coff_swap_aux_out)
10751         (bfd *, void *, int, int, int, int, void *);
10752
10753       unsigned int (*_bfd_coff_swap_sym_out)
10754         (bfd *, void *, void *);
10755
10756       unsigned int (*_bfd_coff_swap_lineno_out)
10757         (bfd *, void *, void *);
10758
10759       unsigned int (*_bfd_coff_swap_reloc_out)
10760         (bfd *, void *, void *);
10761
10762       unsigned int (*_bfd_coff_swap_filehdr_out)
10763         (bfd *, void *, void *);
10764
10765       unsigned int (*_bfd_coff_swap_aouthdr_out)
10766         (bfd *, void *, void *);
10767
10768       unsigned int (*_bfd_coff_swap_scnhdr_out)
10769         (bfd *, void *, void *);
10770
10771       unsigned int _bfd_filhsz;
10772       unsigned int _bfd_aoutsz;
10773       unsigned int _bfd_scnhsz;
10774       unsigned int _bfd_symesz;
10775       unsigned int _bfd_auxesz;
10776       unsigned int _bfd_relsz;
10777       unsigned int _bfd_linesz;
10778       unsigned int _bfd_filnmlen;
10779       bool _bfd_coff_long_filenames;
10780
10781       bool _bfd_coff_long_section_names;
10782       bool (*_bfd_coff_set_long_section_names)
10783         (bfd *, int);
10784
10785       unsigned int _bfd_coff_default_section_alignment_power;
10786       bool _bfd_coff_force_symnames_in_strings;
10787       unsigned int _bfd_coff_debug_string_prefix_length;
10788       unsigned int _bfd_coff_max_nscns;
10789
10790       void (*_bfd_coff_swap_filehdr_in)
10791         (bfd *, void *, void *);
10792
10793       void (*_bfd_coff_swap_aouthdr_in)
10794         (bfd *, void *, void *);
10795
10796       void (*_bfd_coff_swap_scnhdr_in)
10797         (bfd *, void *, void *);
10798
10799       void (*_bfd_coff_swap_reloc_in)
10800         (bfd *abfd, void *, void *);
10801
10802       bool (*_bfd_coff_bad_format_hook)
10803         (bfd *, void *);
10804
10805       bool (*_bfd_coff_set_arch_mach_hook)
10806         (bfd *, void *);
10807
10808       void * (*_bfd_coff_mkobject_hook)
10809         (bfd *, void *, void *);
10810
10811       bool (*_bfd_styp_to_sec_flags_hook)
10812         (bfd *, void *, const char *, asection *, flagword *);
10813
10814       void (*_bfd_set_alignment_hook)
10815         (bfd *, asection *, void *);
10816
10817       bool (*_bfd_coff_slurp_symbol_table)
10818         (bfd *);
10819
10820       bool (*_bfd_coff_symname_in_debug)
10821         (bfd *, struct internal_syment *);
10822
10823       bool (*_bfd_coff_pointerize_aux_hook)
10824         (bfd *, combined_entry_type *, combined_entry_type *,
10825          unsigned int, combined_entry_type *);
10826
10827       bool (*_bfd_coff_print_aux)
10828         (bfd *, FILE *, combined_entry_type *, combined_entry_type *,
10829          combined_entry_type *, unsigned int);
10830
10831       void (*_bfd_coff_reloc16_extra_cases)
10832         (bfd *, struct bfd_link_info *, struct bfd_link_order *, arelent *,
10833          bfd_byte *, unsigned int *, unsigned int *);
10834
10835       int (*_bfd_coff_reloc16_estimate)
10836         (bfd *, asection *, arelent *, unsigned int,
10837          struct bfd_link_info *);
10838
10839       enum coff_symbol_classification (*_bfd_coff_classify_symbol)
10840         (bfd *, struct internal_syment *);
10841
10842       bool (*_bfd_coff_compute_section_file_positions)
10843         (bfd *);
10844
10845       bool (*_bfd_coff_start_final_link)
10846         (bfd *, struct bfd_link_info *);
10847
10848       bool (*_bfd_coff_relocate_section)
10849         (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
10850          struct internal_reloc *, struct internal_syment *, asection **);
10851
10852       reloc_howto_type *(*_bfd_coff_rtype_to_howto)
10853         (bfd *, asection *, struct internal_reloc *,
10854          struct coff_link_hash_entry *, struct internal_syment *, bfd_vma *);
10855
10856       bool (*_bfd_coff_adjust_symndx)
10857         (bfd *, struct bfd_link_info *, bfd *, asection *,
10858          struct internal_reloc *, bool *);
10859
10860       bool (*_bfd_coff_link_add_one_symbol)
10861         (struct bfd_link_info *, bfd *, const char *, flagword,
10862          asection *, bfd_vma, const char *, bool, bool,
10863          struct bfd_link_hash_entry **);
10864
10865       bool (*_bfd_coff_link_output_has_begun)
10866         (bfd *, struct coff_final_link_info *);
10867
10868       bool (*_bfd_coff_final_link_postscript)
10869         (bfd *, struct coff_final_link_info *);
10870
10871       bool (*_bfd_coff_print_pdata)
10872         (bfd *, void *);
10873
10874     } bfd_coff_backend_data;
10875
10876     #define coff_backend_info(abfd) \
10877       ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
10878
10879     #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
10880       ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
10881
10882     #define bfd_coff_swap_sym_in(a,e,i) \
10883       ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
10884
10885     #define bfd_coff_swap_lineno_in(a,e,i) \
10886       ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
10887
10888     #define bfd_coff_swap_reloc_out(abfd, i, o) \
10889       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
10890
10891     #define bfd_coff_swap_lineno_out(abfd, i, o) \
10892       ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
10893
10894     #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
10895       ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
10896
10897     #define bfd_coff_swap_sym_out(abfd, i,o) \
10898       ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
10899
10900     #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
10901       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
10902
10903     #define bfd_coff_swap_filehdr_out(abfd, i,o) \
10904       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
10905
10906     #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
10907       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
10908
10909     #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
10910     #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
10911     #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
10912     #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
10913     #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
10914     #define bfd_coff_relsz(abfd)  (coff_backend_info (abfd)->_bfd_relsz)
10915     #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
10916     #define bfd_coff_filnmlen(abfd) (coff_backend_info (abfd)->_bfd_filnmlen)
10917     #define bfd_coff_long_filenames(abfd) \
10918       (coff_backend_info (abfd)->_bfd_coff_long_filenames)
10919     #define bfd_coff_long_section_names(abfd) \
10920       (coff_backend_info (abfd)->_bfd_coff_long_section_names)
10921     #define bfd_coff_set_long_section_names(abfd, enable) \
10922       ((coff_backend_info (abfd)->_bfd_coff_set_long_section_names) (abfd, enable))
10923     #define bfd_coff_default_section_alignment_power(abfd) \
10924       (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power)
10925     #define bfd_coff_max_nscns(abfd) \
10926       (coff_backend_info (abfd)->_bfd_coff_max_nscns)
10927
10928     #define bfd_coff_swap_filehdr_in(abfd, i,o) \
10929       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
10930
10931     #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
10932       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
10933
10934     #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
10935       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
10936
10937     #define bfd_coff_swap_reloc_in(abfd, i, o) \
10938       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
10939
10940     #define bfd_coff_bad_format_hook(abfd, filehdr) \
10941       ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
10942
10943     #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
10944       ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
10945     #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
10946       ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook)\
10947        (abfd, filehdr, aouthdr))
10948
10949     #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name, section, flags_ptr)\
10950       ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook)\
10951        (abfd, scnhdr, name, section, flags_ptr))
10952
10953     #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
10954       ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
10955
10956     #define bfd_coff_slurp_symbol_table(abfd)\
10957       ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
10958
10959     #define bfd_coff_symname_in_debug(abfd, sym)\
10960       ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
10961
10962     #define bfd_coff_force_symnames_in_strings(abfd)\
10963       (coff_backend_info (abfd)->_bfd_coff_force_symnames_in_strings)
10964
10965     #define bfd_coff_debug_string_prefix_length(abfd)\
10966       (coff_backend_info (abfd)->_bfd_coff_debug_string_prefix_length)
10967
10968     #define bfd_coff_print_aux(abfd, file, base, symbol, aux, indaux)\
10969       ((coff_backend_info (abfd)->_bfd_coff_print_aux)\
10970        (abfd, file, base, symbol, aux, indaux))
10971
10972     #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order,\
10973                                          reloc, data, src_ptr, dst_ptr)\
10974       ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
10975        (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
10976
10977     #define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
10978       ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
10979        (abfd, section, reloc, shrink, link_info))
10980
10981     #define bfd_coff_classify_symbol(abfd, sym)\
10982       ((coff_backend_info (abfd)->_bfd_coff_classify_symbol)\
10983        (abfd, sym))
10984
10985     #define bfd_coff_compute_section_file_positions(abfd)\
10986       ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
10987        (abfd))
10988
10989     #define bfd_coff_start_final_link(obfd, info)\
10990       ((coff_backend_info (obfd)->_bfd_coff_start_final_link)\
10991        (obfd, info))
10992     #define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
10993       ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
10994        (obfd, info, ibfd, o, con, rel, isyms, secs))
10995     #define bfd_coff_rtype_to_howto(abfd, sec, rel, h, sym, addendp)\
10996       ((coff_backend_info (abfd)->_bfd_coff_rtype_to_howto)\
10997        (abfd, sec, rel, h, sym, addendp))
10998     #define bfd_coff_adjust_symndx(obfd, info, ibfd, sec, rel, adjustedp)\
10999       ((coff_backend_info (abfd)->_bfd_coff_adjust_symndx)\
11000        (obfd, info, ibfd, sec, rel, adjustedp))
11001     #define bfd_coff_link_add_one_symbol(info, abfd, name, flags, section,\
11002                                          value, string, cp, coll, hashp)\
11003       ((coff_backend_info (abfd)->_bfd_coff_link_add_one_symbol)\
11004        (info, abfd, name, flags, section, value, string, cp, coll, hashp))
11005
11006     #define bfd_coff_link_output_has_begun(a,p) \
11007       ((coff_backend_info (a)->_bfd_coff_link_output_has_begun) (a, p))
11008     #define bfd_coff_final_link_postscript(a,p) \
11009       ((coff_backend_info (a)->_bfd_coff_final_link_postscript) (a, p))
11010
11011     #define bfd_coff_have_print_pdata(a) \
11012       (coff_backend_info (a)->_bfd_coff_print_pdata)
11013     #define bfd_coff_print_pdata(a,p) \
11014       ((coff_backend_info (a)->_bfd_coff_print_pdata) (a, p))
11015
11016     /* Macro: Returns true if the bfd is a PE executable as opposed to a
11017        PE object file.  */
11018     #define bfd_pei_p(abfd) \
11019       (startswith ((abfd)->xvec->name, "pei-"))
11020
110213.3.2.8 Writing relocations
11022...........................
11023
11024To write relocations, the back end steps though the canonical relocation
11025table and create an 'internal_reloc'.  The symbol index to use is
11026removed from the 'offset' field in the symbol table supplied.  The
11027address comes directly from the sum of the section base address and the
11028relocation offset; the type is dug directly from the howto field.  Then
11029the 'internal_reloc' is swapped into the shape of an 'external_reloc'
11030and written out to disk.
11031
110323.3.2.9 Reading linenumbers
11033...........................
11034
11035Creating the linenumber table is done by reading in the entire coff
11036linenumber table, and creating another table for internal use.
11037
11038   A coff linenumber table is structured so that each function is marked
11039as having a line number of 0.  Each line within the function is an
11040offset from the first line in the function.  The base of the line number
11041information for the table is stored in the symbol associated with the
11042function.
11043
11044   Note: The PE format uses line number 0 for a flag indicating a new
11045source file.
11046
11047   The information is copied from the external to the internal table,
11048and each symbol which marks a function is marked by pointing its...
11049
11050   How does this work ?
11051
110523.3.2.10 Reading relocations
11053............................
11054
11055Coff relocations are easily transformed into the internal BFD form
11056('arelent').
11057
11058   Reading a coff relocation table is done in the following stages:
11059
11060   * Read the entire coff relocation table into memory.
11061
11062   * Process each relocation in turn; first swap it from the external to
11063     the internal form.
11064
11065   * Turn the symbol referenced in the relocation's symbol index into a
11066     pointer into the canonical symbol table.  This table is the same as
11067     the one returned by a call to 'bfd_canonicalize_symtab'.  The back
11068     end will call that routine and save the result if a
11069     canonicalization hasn't been done.
11070
11071   * The reloc index is turned into a pointer to a howto structure, in a
11072     back end specific way.  For instance, the 386 uses the 'r_type' to
11073     directly produce an index into a howto table vector.
11074
11075
11076File: bfd.info,  Node: elf,  Next: mmo,  Prev: coff,  Up: BFD back ends
11077
110783.4 ELF backends
11079================
11080
11081BFD support for ELF formats is being worked on.  Currently, the best
11082supported back ends are for sparc and i386 (running svr4 or Solaris 2).
11083
11084   Documentation of the internals of the support code still needs to be
11085written.  The code is changing quickly enough that we haven't bothered
11086yet.
11087
11088
11089File: bfd.info,  Node: mmo,  Prev: elf,  Up: BFD back ends
11090
110913.5 mmo backend
11092===============
11093
11094The mmo object format is used exclusively together with Professor Donald
11095E. Knuth's educational 64-bit processor MMIX. The simulator 'mmix' which
11096is available at <http://mmix.cs.hm.edu/src/index.html> understands this
11097format.  That package also includes a combined assembler and linker
11098called 'mmixal'.  The mmo format has no advantages feature-wise compared
11099to e.g.  ELF. It is a simple non-relocatable object format with no
11100support for archives or debugging information, except for symbol value
11101information and line numbers (which is not yet implemented in BFD). See
11102<http://mmix.cs.hm.edu/> for more information about MMIX. The ELF format
11103is used for intermediate object files in the BFD implementation.
11104
11105* Menu:
11106
11107* File layout::
11108* Symbol-table::
11109* mmo section mapping::
11110
11111
11112File: bfd.info,  Node: File layout,  Next: Symbol-table,  Prev: mmo,  Up: mmo
11113
111143.5.1 File layout
11115-----------------
11116
11117The mmo file contents is not partitioned into named sections as with
11118e.g. ELF. Memory areas is formed by specifying the location of the data
11119that follows.  Only the memory area '0x0000...00' to '0x01ff...ff' is
11120executable, so it is used for code (and constants) and the area
11121'0x2000...00' to '0x20ff...ff' is used for writable data.  *Note mmo
11122section mapping::.
11123
11124   There is provision for specifying "special data" of 65536 different
11125types.  We use type 80 (decimal), arbitrarily chosen the same as the ELF
11126'e_machine' number for MMIX, filling it with section information
11127normally found in ELF objects.  *Note mmo section mapping::.
11128
11129   Contents is entered as 32-bit words, xor:ed over previous contents,
11130always zero-initialized.  A word that starts with the byte '0x98' forms
11131a command called a 'lopcode', where the next byte distinguished between
11132the thirteen lopcodes.  The two remaining bytes, called the 'Y' and 'Z'
11133fields, or the 'YZ' field (a 16-bit big-endian number), are used for
11134various purposes different for each lopcode.  As documented in
11135<http://mmix.cs.hm.edu/doc/mmixal.pdf>, the lopcodes are:
11136
11137'lop_quote'
11138     0x98000001.  The next word is contents, regardless of whether it
11139     starts with 0x98 or not.
11140
11141'lop_loc'
11142     0x9801YYZZ, where 'Z' is 1 or 2.  This is a location directive,
11143     setting the location for the next data to the next 32-bit word (for
11144     Z = 1) or 64-bit word (for Z = 2), plus Y * 2^56.  Normally 'Y' is
11145     0 for the text segment and 2 for the data segment.  Beware that the
11146     low bits of non- tetrabyte-aligned values are silently discarded
11147     when being automatically incremented and when storing contents (in
11148     contrast to e.g.  its use as current location when followed by
11149     lop_fixo et al before the next possibly-quoted tetrabyte contents).
11150
11151'lop_skip'
11152     0x9802YYZZ. Increase the current location by 'YZ' bytes.
11153
11154'lop_fixo'
11155     0x9803YYZZ, where 'Z' is 1 or 2.  Store the current location as 64
11156     bits into the location pointed to by the next 32-bit (Z = 1) or
11157     64-bit (Z = 2) word, plus Y * 2^56.
11158
11159'lop_fixr'
11160     0x9804YYZZ. 'YZ' is stored into the current location plus 2 - 4 *
11161     YZ.
11162
11163'lop_fixrx'
11164     0x980500ZZ. 'Z' is 16 or 24.  A value 'L' derived from the
11165     following 32-bit word are used in a manner similar to 'YZ' in
11166     lop_fixr: it is xor:ed into the current location minus 4 * L. The
11167     first byte of the word is 0 or 1.  If it is 1, then L = (LOWEST 24
11168     BITS OF WORD) - 2^Z, if 0, then L = (LOWEST 24 BITS OF WORD).
11169
11170'lop_file'
11171     0x9806YYZZ. 'Y' is the file number, 'Z' is count of 32-bit words.
11172     Set the file number to 'Y' and the line counter to 0.  The next Z *
11173     4 bytes contain the file name, padded with zeros if the count is
11174     not a multiple of four.  The same 'Y' may occur multiple times, but
11175     'Z' must be 0 for all but the first occurrence.
11176
11177'lop_line'
11178     0x9807YYZZ. 'YZ' is the line number.  Together with lop_file, it
11179     forms the source location for the next 32-bit word.  Note that for
11180     each non-lopcode 32-bit word, line numbers are assumed incremented
11181     by one.
11182
11183'lop_spec'
11184     0x9808YYZZ. 'YZ' is the type number.  Data until the next lopcode
11185     other than lop_quote forms special data of type 'YZ'.  *Note mmo
11186     section mapping::.
11187
11188     Other types than 80, (or type 80 with a content that does not
11189     parse) is stored in sections named '.MMIX.spec_data.N' where N is
11190     the 'YZ'-type.  The flags for such a sections say not to allocate
11191     or load the data.  The vma is 0.  Contents of multiple occurrences
11192     of special data N is concatenated to the data of the previous
11193     lop_spec Ns.  The location in data or code at which the lop_spec
11194     occurred is lost.
11195
11196'lop_pre'
11197     0x980901ZZ. The first lopcode in a file.  The 'Z' field forms the
11198     length of header information in 32-bit words, where the first word
11199     tells the time in seconds since '00:00:00 GMT Jan 1 1970'.
11200
11201'lop_post'
11202     0x980a00ZZ. Z > 32.  This lopcode follows after all
11203     content-generating lopcodes in a program.  The 'Z' field denotes
11204     the value of 'rG' at the beginning of the program.  The following
11205     256 - Z big-endian 64-bit words are loaded into global registers
11206     '$G' ... '$255'.
11207
11208'lop_stab'
11209     0x980b0000.  The next-to-last lopcode in a program.  Must follow
11210     immediately after the lop_post lopcode and its data.  After this
11211     lopcode follows all symbols in a compressed format (*note
11212     Symbol-table::).
11213
11214'lop_end'
11215     0x980cYYZZ. The last lopcode in a program.  It must follow the
11216     lop_stab lopcode and its data.  The 'YZ' field contains the number
11217     of 32-bit words of symbol table information after the preceding
11218     lop_stab lopcode.
11219
11220   Note that the lopcode "fixups"; 'lop_fixr', 'lop_fixrx' and
11221'lop_fixo' are not generated by BFD, but are handled.  They are
11222generated by 'mmixal'.
11223
11224   This trivial one-label, one-instruction file:
11225
11226      :Main TRAP 1,2,3
11227
11228   can be represented this way in mmo:
11229
11230      0x98090101 - lop_pre, one 32-bit word with timestamp.
11231      <timestamp>
11232      0x98010002 - lop_loc, text segment, using a 64-bit address.
11233                   Note that mmixal does not emit this for the file above.
11234      0x00000000 - Address, high 32 bits.
11235      0x00000000 - Address, low 32 bits.
11236      0x98060002 - lop_file, 2 32-bit words for file-name.
11237      0x74657374 - "test"
11238      0x2e730000 - ".s\0\0"
11239      0x98070001 - lop_line, line 1.
11240      0x00010203 - TRAP 1,2,3
11241      0x980a00ff - lop_post, setting $255 to 0.
11242      0x00000000
11243      0x00000000
11244      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
11245      0x203a4040   *Note Symbol-table::.
11246      0x10404020
11247      0x4d206120
11248      0x69016e00
11249      0x81000000
11250      0x980c0005 - lop_end; symbol table contained five 32-bit words.
11251
11252
11253File: bfd.info,  Node: Symbol-table,  Next: mmo section mapping,  Prev: File layout,  Up: mmo
11254
112553.5.2 Symbol table format
11256-------------------------
11257
11258From mmixal.w (or really, the generated mmixal.tex) in the MMIXware
11259package which also contains the 'mmix' simulator: "Symbols are stored
11260and retrieved by means of a 'ternary search trie', following ideas of
11261Bentley and Sedgewick.  (See ACM-SIAM Symp. on Discrete Algorithms '8'
11262(1997), 360-369; R.Sedgewick, 'Algorithms in C' (Reading, Mass.
11263Addison-Wesley, 1998), '15.4'.)  Each trie node stores a character, and
11264there are branches to subtries for the cases where a given character is
11265less than, equal to, or greater than the character in the trie.  There
11266also is a pointer to a symbol table entry if a symbol ends at the
11267current node."
11268
11269   So it's a tree encoded as a stream of bytes.  The stream of bytes
11270acts on a single virtual global symbol, adding and removing characters
11271and signalling complete symbol points.  Here, we read the stream and
11272create symbols at the completion points.
11273
11274   First, there's a control byte 'm'.  If any of the listed bits in 'm'
11275is nonzero, we execute what stands at the right, in the listed order:
11276
11277      (MMO3_LEFT)
11278      0x40 - Traverse left trie.
11279             (Read a new command byte and recurse.)
11280
11281      (MMO3_SYMBITS)
11282      0x2f - Read the next byte as a character and store it in the
11283             current character position; increment character position.
11284             Test the bits of m:
11285
11286             (MMO3_WCHAR)
11287             0x80 - The character is 16-bit (so read another byte,
11288                    merge into current character.
11289
11290             (MMO3_TYPEBITS)
11291             0xf  - We have a complete symbol; parse the type, value
11292                    and serial number and do what should be done
11293                    with a symbol.  The type and length information
11294                    is in j = (m & 0xf).
11295
11296                    (MMO3_REGQUAL_BITS)
11297                    j == 0xf: A register variable.  The following
11298                              byte tells which register.
11299                    j <= 8:   An absolute symbol.  Read j bytes as the
11300                              big-endian number the symbol equals.
11301                              A j = 2 with two zero bytes denotes an
11302                              unknown symbol.
11303                    j > 8:    As with j <= 8, but add (0x20 << 56)
11304                              to the value in the following j - 8
11305                              bytes.
11306
11307                    Then comes the serial number, as a variant of
11308                    uleb128, but better named ubeb128:
11309                    Read bytes and shift the previous value left 7
11310                    (multiply by 128).  Add in the new byte, repeat
11311                    until a byte has bit 7 set.  The serial number
11312                    is the computed value minus 128.
11313
11314             (MMO3_MIDDLE)
11315             0x20 - Traverse middle trie.  (Read a new command byte
11316                    and recurse.)  Decrement character position.
11317
11318      (MMO3_RIGHT)
11319      0x10 - Traverse right trie.  (Read a new command byte and
11320             recurse.)
11321
11322   Let's look again at the 'lop_stab' for the trivial file (*note File
11323layout::).
11324
11325      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
11326      0x203a4040
11327      0x10404020
11328      0x4d206120
11329      0x69016e00
11330      0x81000000
11331
11332   This forms the trivial trie (note that the path between ":" and "M"
11333is redundant):
11334
11335      203a     ":"
11336      40       /
11337      40      /
11338      10      \
11339      40      /
11340      40     /
11341      204d  "M"
11342      2061  "a"
11343      2069  "i"
11344      016e  "n" is the last character in a full symbol, and
11345            with a value represented in one byte.
11346      00    The value is 0.
11347      81    The serial number is 1.
11348
11349
11350File: bfd.info,  Node: mmo section mapping,  Prev: Symbol-table,  Up: mmo
11351
113523.5.3 mmo section mapping
11353-------------------------
11354
11355The implementation in BFD uses special data type 80 (decimal) to
11356encapsulate and describe named sections, containing e.g. debug
11357information.  If needed, any datum in the encapsulation will be quoted
11358using lop_quote.  First comes a 32-bit word holding the number of 32-bit
11359words containing the zero-terminated zero-padded segment name.  After
11360the name there's a 32-bit word holding flags describing the section
11361type.  Then comes a 64-bit big-endian word with the section length (in
11362bytes), then another with the section start address.  Depending on the
11363type of section, the contents might follow, zero-padded to 32-bit
11364boundary.  For a loadable section (such as data or code), the contents
11365might follow at some later point, not necessarily immediately, as a
11366lop_loc with the same start address as in the section description,
11367followed by the contents.  This in effect forms a descriptor that must
11368be emitted before the actual contents.  Sections described this way must
11369not overlap.
11370
11371   For areas that don't have such descriptors, synthetic sections are
11372formed by BFD. Consecutive contents in the two memory areas
11373'0x0000...00' to '0x01ff...ff' and '0x2000...00' to '0x20ff...ff' are
11374entered in sections named '.text' and '.data' respectively.  If an area
11375is not otherwise described, but would together with a neighboring lower
11376area be less than '0x40000000' bytes long, it is joined with the lower
11377area and the gap is zero-filled.  For other cases, a new section is
11378formed, named '.MMIX.sec.N'.  Here, N is a number, a running count
11379through the mmo file, starting at 0.
11380
11381   A loadable section specified as:
11382
11383      .section secname,"ax"
11384      TETRA 1,2,3,4,-1,-2009
11385      BYTE 80
11386
11387   and linked to address '0x4', is represented by the sequence:
11388
11389      0x98080050 - lop_spec 80
11390      0x00000002 - two 32-bit words for the section name
11391      0x7365636e - "secn"
11392      0x616d6500 - "ame\0"
11393      0x00000033 - flags CODE, READONLY, LOAD, ALLOC
11394      0x00000000 - high 32 bits of section length
11395      0x0000001c - section length is 28 bytes; 6 * 4 + 1 + alignment to 32 bits
11396      0x00000000 - high 32 bits of section address
11397      0x00000004 - section address is 4
11398      0x98010002 - 64 bits with address of following data
11399      0x00000000 - high 32 bits of address
11400      0x00000004 - low 32 bits: data starts at address 4
11401      0x00000001 - 1
11402      0x00000002 - 2
11403      0x00000003 - 3
11404      0x00000004 - 4
11405      0xffffffff - -1
11406      0xfffff827 - -2009
11407      0x50000000 - 80 as a byte, padded with zeros.
11408
11409   Note that the lop_spec wrapping does not include the section
11410contents.  Compare this to a non-loaded section specified as:
11411
11412      .section thirdsec
11413      TETRA 200001,100002
11414      BYTE 38,40
11415
11416   This, when linked to address '0x200000000000001c', is represented by:
11417
11418      0x98080050 - lop_spec 80
11419      0x00000002 - two 32-bit words for the section name
11420      0x7365636e - "thir"
11421      0x616d6500 - "dsec"
11422      0x00000010 - flag READONLY
11423      0x00000000 - high 32 bits of section length
11424      0x0000000c - section length is 12 bytes; 2 * 4 + 2 + alignment to 32 bits
11425      0x20000000 - high 32 bits of address
11426      0x0000001c - low 32 bits of address 0x200000000000001c
11427      0x00030d41 - 200001
11428      0x000186a2 - 100002
11429      0x26280000 - 38, 40 as bytes, padded with zeros
11430
11431   For the latter example, the section contents must not be loaded in
11432memory, and is therefore specified as part of the special data.  The
11433address is usually unimportant but might provide information for e.g.
11434the DWARF 2 debugging format.
11435
11436
11437File: bfd.info,  Node: GNU Free Documentation License,  Next: BFD Index,  Prev: BFD back ends,  Up: Top
11438
11439                     Version 1.3, 3 November 2008
11440
11441     Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
11442     <http://fsf.org/>
11443
11444     Everyone is permitted to copy and distribute verbatim copies
11445     of this license document, but changing it is not allowed.
11446
11447  0. PREAMBLE
11448
11449     The purpose of this License is to make a manual, textbook, or other
11450     functional and useful document "free" in the sense of freedom: to
11451     assure everyone the effective freedom to copy and redistribute it,
11452     with or without modifying it, either commercially or
11453     noncommercially.  Secondarily, this License preserves for the
11454     author and publisher a way to get credit for their work, while not
11455     being considered responsible for modifications made by others.
11456
11457     This License is a kind of "copyleft", which means that derivative
11458     works of the document must themselves be free in the same sense.
11459     It complements the GNU General Public License, which is a copyleft
11460     license designed for free software.
11461
11462     We have designed this License in order to use it for manuals for
11463     free software, because free software needs free documentation: a
11464     free program should come with manuals providing the same freedoms
11465     that the software does.  But this License is not limited to
11466     software manuals; it can be used for any textual work, regardless
11467     of subject matter or whether it is published as a printed book.  We
11468     recommend this License principally for works whose purpose is
11469     instruction or reference.
11470
11471  1. APPLICABILITY AND DEFINITIONS
11472
11473     This License applies to any manual or other work, in any medium,
11474     that contains a notice placed by the copyright holder saying it can
11475     be distributed under the terms of this License.  Such a notice
11476     grants a world-wide, royalty-free license, unlimited in duration,
11477     to use that work under the conditions stated herein.  The
11478     "Document", below, refers to any such manual or work.  Any member
11479     of the public is a licensee, and is addressed as "you".  You accept
11480     the license if you copy, modify or distribute the work in a way
11481     requiring permission under copyright law.
11482
11483     A "Modified Version" of the Document means any work containing the
11484     Document or a portion of it, either copied verbatim, or with
11485     modifications and/or translated into another language.
11486
11487     A "Secondary Section" is a named appendix or a front-matter section
11488     of the Document that deals exclusively with the relationship of the
11489     publishers or authors of the Document to the Document's overall
11490     subject (or to related matters) and contains nothing that could
11491     fall directly within that overall subject.  (Thus, if the Document
11492     is in part a textbook of mathematics, a Secondary Section may not
11493     explain any mathematics.)  The relationship could be a matter of
11494     historical connection with the subject or with related matters, or
11495     of legal, commercial, philosophical, ethical or political position
11496     regarding them.
11497
11498     The "Invariant Sections" are certain Secondary Sections whose
11499     titles are designated, as being those of Invariant Sections, in the
11500     notice that says that the Document is released under this License.
11501     If a section does not fit the above definition of Secondary then it
11502     is not allowed to be designated as Invariant.  The Document may
11503     contain zero Invariant Sections.  If the Document does not identify
11504     any Invariant Sections then there are none.
11505
11506     The "Cover Texts" are certain short passages of text that are
11507     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
11508     that says that the Document is released under this License.  A
11509     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
11510     be at most 25 words.
11511
11512     A "Transparent" copy of the Document means a machine-readable copy,
11513     represented in a format whose specification is available to the
11514     general public, that is suitable for revising the document
11515     straightforwardly with generic text editors or (for images composed
11516     of pixels) generic paint programs or (for drawings) some widely
11517     available drawing editor, and that is suitable for input to text
11518     formatters or for automatic translation to a variety of formats
11519     suitable for input to text formatters.  A copy made in an otherwise
11520     Transparent file format whose markup, or absence of markup, has
11521     been arranged to thwart or discourage subsequent modification by
11522     readers is not Transparent.  An image format is not Transparent if
11523     used for any substantial amount of text.  A copy that is not
11524     "Transparent" is called "Opaque".
11525
11526     Examples of suitable formats for Transparent copies include plain
11527     ASCII without markup, Texinfo input format, LaTeX input format,
11528     SGML or XML using a publicly available DTD, and standard-conforming
11529     simple HTML, PostScript or PDF designed for human modification.
11530     Examples of transparent image formats include PNG, XCF and JPG.
11531     Opaque formats include proprietary formats that can be read and
11532     edited only by proprietary word processors, SGML or XML for which
11533     the DTD and/or processing tools are not generally available, and
11534     the machine-generated HTML, PostScript or PDF produced by some word
11535     processors for output purposes only.
11536
11537     The "Title Page" means, for a printed book, the title page itself,
11538     plus such following pages as are needed to hold, legibly, the
11539     material this License requires to appear in the title page.  For
11540     works in formats which do not have any title page as such, "Title
11541     Page" means the text near the most prominent appearance of the
11542     work's title, preceding the beginning of the body of the text.
11543
11544     The "publisher" means any person or entity that distributes copies
11545     of the Document to the public.
11546
11547     A section "Entitled XYZ" means a named subunit of the Document
11548     whose title either is precisely XYZ or contains XYZ in parentheses
11549     following text that translates XYZ in another language.  (Here XYZ
11550     stands for a specific section name mentioned below, such as
11551     "Acknowledgements", "Dedications", "Endorsements", or "History".)
11552     To "Preserve the Title" of such a section when you modify the
11553     Document means that it remains a section "Entitled XYZ" according
11554     to this definition.
11555
11556     The Document may include Warranty Disclaimers next to the notice
11557     which states that this License applies to the Document.  These
11558     Warranty Disclaimers are considered to be included by reference in
11559     this License, but only as regards disclaiming warranties: any other
11560     implication that these Warranty Disclaimers may have is void and
11561     has no effect on the meaning of this License.
11562
11563  2. VERBATIM COPYING
11564
11565     You may copy and distribute the Document in any medium, either
11566     commercially or noncommercially, provided that this License, the
11567     copyright notices, and the license notice saying this License
11568     applies to the Document are reproduced in all copies, and that you
11569     add no other conditions whatsoever to those of this License.  You
11570     may not use technical measures to obstruct or control the reading
11571     or further copying of the copies you make or distribute.  However,
11572     you may accept compensation in exchange for copies.  If you
11573     distribute a large enough number of copies you must also follow the
11574     conditions in section 3.
11575
11576     You may also lend copies, under the same conditions stated above,
11577     and you may publicly display copies.
11578
11579  3. COPYING IN QUANTITY
11580
11581     If you publish printed copies (or copies in media that commonly
11582     have printed covers) of the Document, numbering more than 100, and
11583     the Document's license notice requires Cover Texts, you must
11584     enclose the copies in covers that carry, clearly and legibly, all
11585     these Cover Texts: Front-Cover Texts on the front cover, and
11586     Back-Cover Texts on the back cover.  Both covers must also clearly
11587     and legibly identify you as the publisher of these copies.  The
11588     front cover must present the full title with all words of the title
11589     equally prominent and visible.  You may add other material on the
11590     covers in addition.  Copying with changes limited to the covers, as
11591     long as they preserve the title of the Document and satisfy these
11592     conditions, can be treated as verbatim copying in other respects.
11593
11594     If the required texts for either cover are too voluminous to fit
11595     legibly, you should put the first ones listed (as many as fit
11596     reasonably) on the actual cover, and continue the rest onto
11597     adjacent pages.
11598
11599     If you publish or distribute Opaque copies of the Document
11600     numbering more than 100, you must either include a machine-readable
11601     Transparent copy along with each Opaque copy, or state in or with
11602     each Opaque copy a computer-network location from which the general
11603     network-using public has access to download using public-standard
11604     network protocols a complete Transparent copy of the Document, free
11605     of added material.  If you use the latter option, you must take
11606     reasonably prudent steps, when you begin distribution of Opaque
11607     copies in quantity, to ensure that this Transparent copy will
11608     remain thus accessible at the stated location until at least one
11609     year after the last time you distribute an Opaque copy (directly or
11610     through your agents or retailers) of that edition to the public.
11611
11612     It is requested, but not required, that you contact the authors of
11613     the Document well before redistributing any large number of copies,
11614     to give them a chance to provide you with an updated version of the
11615     Document.
11616
11617  4. MODIFICATIONS
11618
11619     You may copy and distribute a Modified Version of the Document
11620     under the conditions of sections 2 and 3 above, provided that you
11621     release the Modified Version under precisely this License, with the
11622     Modified Version filling the role of the Document, thus licensing
11623     distribution and modification of the Modified Version to whoever
11624     possesses a copy of it.  In addition, you must do these things in
11625     the Modified Version:
11626
11627       A. Use in the Title Page (and on the covers, if any) a title
11628          distinct from that of the Document, and from those of previous
11629          versions (which should, if there were any, be listed in the
11630          History section of the Document).  You may use the same title
11631          as a previous version if the original publisher of that
11632          version gives permission.
11633
11634       B. List on the Title Page, as authors, one or more persons or
11635          entities responsible for authorship of the modifications in
11636          the Modified Version, together with at least five of the
11637          principal authors of the Document (all of its principal
11638          authors, if it has fewer than five), unless they release you
11639          from this requirement.
11640
11641       C. State on the Title page the name of the publisher of the
11642          Modified Version, as the publisher.
11643
11644       D. Preserve all the copyright notices of the Document.
11645
11646       E. Add an appropriate copyright notice for your modifications
11647          adjacent to the other copyright notices.
11648
11649       F. Include, immediately after the copyright notices, a license
11650          notice giving the public permission to use the Modified
11651          Version under the terms of this License, in the form shown in
11652          the Addendum below.
11653
11654       G. Preserve in that license notice the full lists of Invariant
11655          Sections and required Cover Texts given in the Document's
11656          license notice.
11657
11658       H. Include an unaltered copy of this License.
11659
11660       I. Preserve the section Entitled "History", Preserve its Title,
11661          and add to it an item stating at least the title, year, new
11662          authors, and publisher of the Modified Version as given on the
11663          Title Page.  If there is no section Entitled "History" in the
11664          Document, create one stating the title, year, authors, and
11665          publisher of the Document as given on its Title Page, then add
11666          an item describing the Modified Version as stated in the
11667          previous sentence.
11668
11669       J. Preserve the network location, if any, given in the Document
11670          for public access to a Transparent copy of the Document, and
11671          likewise the network locations given in the Document for
11672          previous versions it was based on.  These may be placed in the
11673          "History" section.  You may omit a network location for a work
11674          that was published at least four years before the Document
11675          itself, or if the original publisher of the version it refers
11676          to gives permission.
11677
11678       K. For any section Entitled "Acknowledgements" or "Dedications",
11679          Preserve the Title of the section, and preserve in the section
11680          all the substance and tone of each of the contributor
11681          acknowledgements and/or dedications given therein.
11682
11683       L. Preserve all the Invariant Sections of the Document, unaltered
11684          in their text and in their titles.  Section numbers or the
11685          equivalent are not considered part of the section titles.
11686
11687       M. Delete any section Entitled "Endorsements".  Such a section
11688          may not be included in the Modified Version.
11689
11690       N. Do not retitle any existing section to be Entitled
11691          "Endorsements" or to conflict in title with any Invariant
11692          Section.
11693
11694       O. Preserve any Warranty Disclaimers.
11695
11696     If the Modified Version includes new front-matter sections or
11697     appendices that qualify as Secondary Sections and contain no
11698     material copied from the Document, you may at your option designate
11699     some or all of these sections as invariant.  To do this, add their
11700     titles to the list of Invariant Sections in the Modified Version's
11701     license notice.  These titles must be distinct from any other
11702     section titles.
11703
11704     You may add a section Entitled "Endorsements", provided it contains
11705     nothing but endorsements of your Modified Version by various
11706     parties--for example, statements of peer review or that the text
11707     has been approved by an organization as the authoritative
11708     definition of a standard.
11709
11710     You may add a passage of up to five words as a Front-Cover Text,
11711     and a passage of up to 25 words as a Back-Cover Text, to the end of
11712     the list of Cover Texts in the Modified Version.  Only one passage
11713     of Front-Cover Text and one of Back-Cover Text may be added by (or
11714     through arrangements made by) any one entity.  If the Document
11715     already includes a cover text for the same cover, previously added
11716     by you or by arrangement made by the same entity you are acting on
11717     behalf of, you may not add another; but you may replace the old
11718     one, on explicit permission from the previous publisher that added
11719     the old one.
11720
11721     The author(s) and publisher(s) of the Document do not by this
11722     License give permission to use their names for publicity for or to
11723     assert or imply endorsement of any Modified Version.
11724
11725  5. COMBINING DOCUMENTS
11726
11727     You may combine the Document with other documents released under
11728     this License, under the terms defined in section 4 above for
11729     modified versions, provided that you include in the combination all
11730     of the Invariant Sections of all of the original documents,
11731     unmodified, and list them all as Invariant Sections of your
11732     combined work in its license notice, and that you preserve all
11733     their Warranty Disclaimers.
11734
11735     The combined work need only contain one copy of this License, and
11736     multiple identical Invariant Sections may be replaced with a single
11737     copy.  If there are multiple Invariant Sections with the same name
11738     but different contents, make the title of each such section unique
11739     by adding at the end of it, in parentheses, the name of the
11740     original author or publisher of that section if known, or else a
11741     unique number.  Make the same adjustment to the section titles in
11742     the list of Invariant Sections in the license notice of the
11743     combined work.
11744
11745     In the combination, you must combine any sections Entitled
11746     "History" in the various original documents, forming one section
11747     Entitled "History"; likewise combine any sections Entitled
11748     "Acknowledgements", and any sections Entitled "Dedications".  You
11749     must delete all sections Entitled "Endorsements."
11750
11751  6. COLLECTIONS OF DOCUMENTS
11752
11753     You may make a collection consisting of the Document and other
11754     documents released under this License, and replace the individual
11755     copies of this License in the various documents with a single copy
11756     that is included in the collection, provided that you follow the
11757     rules of this License for verbatim copying of each of the documents
11758     in all other respects.
11759
11760     You may extract a single document from such a collection, and
11761     distribute it individually under this License, provided you insert
11762     a copy of this License into the extracted document, and follow this
11763     License in all other respects regarding verbatim copying of that
11764     document.
11765
11766  7. AGGREGATION WITH INDEPENDENT WORKS
11767
11768     A compilation of the Document or its derivatives with other
11769     separate and independent documents or works, in or on a volume of a
11770     storage or distribution medium, is called an "aggregate" if the
11771     copyright resulting from the compilation is not used to limit the
11772     legal rights of the compilation's users beyond what the individual
11773     works permit.  When the Document is included in an aggregate, this
11774     License does not apply to the other works in the aggregate which
11775     are not themselves derivative works of the Document.
11776
11777     If the Cover Text requirement of section 3 is applicable to these
11778     copies of the Document, then if the Document is less than one half
11779     of the entire aggregate, the Document's Cover Texts may be placed
11780     on covers that bracket the Document within the aggregate, or the
11781     electronic equivalent of covers if the Document is in electronic
11782     form.  Otherwise they must appear on printed covers that bracket
11783     the whole aggregate.
11784
11785  8. TRANSLATION
11786
11787     Translation is considered a kind of modification, so you may
11788     distribute translations of the Document under the terms of section
11789     4.  Replacing Invariant Sections with translations requires special
11790     permission from their copyright holders, but you may include
11791     translations of some or all Invariant Sections in addition to the
11792     original versions of these Invariant Sections.  You may include a
11793     translation of this License, and all the license notices in the
11794     Document, and any Warranty Disclaimers, provided that you also
11795     include the original English version of this License and the
11796     original versions of those notices and disclaimers.  In case of a
11797     disagreement between the translation and the original version of
11798     this License or a notice or disclaimer, the original version will
11799     prevail.
11800
11801     If a section in the Document is Entitled "Acknowledgements",
11802     "Dedications", or "History", the requirement (section 4) to
11803     Preserve its Title (section 1) will typically require changing the
11804     actual title.
11805
11806  9. TERMINATION
11807
11808     You may not copy, modify, sublicense, or distribute the Document
11809     except as expressly provided under this License.  Any attempt
11810     otherwise to copy, modify, sublicense, or distribute it is void,
11811     and will automatically terminate your rights under this License.
11812
11813     However, if you cease all violation of this License, then your
11814     license from a particular copyright holder is reinstated (a)
11815     provisionally, unless and until the copyright holder explicitly and
11816     finally terminates your license, and (b) permanently, if the
11817     copyright holder fails to notify you of the violation by some
11818     reasonable means prior to 60 days after the cessation.
11819
11820     Moreover, your license from a particular copyright holder is
11821     reinstated permanently if the copyright holder notifies you of the
11822     violation by some reasonable means, this is the first time you have
11823     received notice of violation of this License (for any work) from
11824     that copyright holder, and you cure the violation prior to 30 days
11825     after your receipt of the notice.
11826
11827     Termination of your rights under this section does not terminate
11828     the licenses of parties who have received copies or rights from you
11829     under this License.  If your rights have been terminated and not
11830     permanently reinstated, receipt of a copy of some or all of the
11831     same material does not give you any rights to use it.
11832
11833  10. FUTURE REVISIONS OF THIS LICENSE
11834
11835     The Free Software Foundation may publish new, revised versions of
11836     the GNU Free Documentation License from time to time.  Such new
11837     versions will be similar in spirit to the present version, but may
11838     differ in detail to address new problems or concerns.  See
11839     <http://www.gnu.org/copyleft/>.
11840
11841     Each version of the License is given a distinguishing version
11842     number.  If the Document specifies that a particular numbered
11843     version of this License "or any later version" applies to it, you
11844     have the option of following the terms and conditions either of
11845     that specified version or of any later version that has been
11846     published (not as a draft) by the Free Software Foundation.  If the
11847     Document does not specify a version number of this License, you may
11848     choose any version ever published (not as a draft) by the Free
11849     Software Foundation.  If the Document specifies that a proxy can
11850     decide which future versions of this License can be used, that
11851     proxy's public statement of acceptance of a version permanently
11852     authorizes you to choose that version for the Document.
11853
11854  11. RELICENSING
11855
11856     "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
11857     World Wide Web server that publishes copyrightable works and also
11858     provides prominent facilities for anybody to edit those works.  A
11859     public wiki that anybody can edit is an example of such a server.
11860     A "Massive Multiauthor Collaboration" (or "MMC") contained in the
11861     site means any set of copyrightable works thus published on the MMC
11862     site.
11863
11864     "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
11865     license published by Creative Commons Corporation, a not-for-profit
11866     corporation with a principal place of business in San Francisco,
11867     California, as well as future copyleft versions of that license
11868     published by that same organization.
11869
11870     "Incorporate" means to publish or republish a Document, in whole or
11871     in part, as part of another Document.
11872
11873     An MMC is "eligible for relicensing" if it is licensed under this
11874     License, and if all works that were first published under this
11875     License somewhere other than this MMC, and subsequently
11876     incorporated in whole or in part into the MMC, (1) had no cover
11877     texts or invariant sections, and (2) were thus incorporated prior
11878     to November 1, 2008.
11879
11880     The operator of an MMC Site may republish an MMC contained in the
11881     site under CC-BY-SA on the same site at any time before August 1,
11882     2009, provided the MMC is eligible for relicensing.
11883
11884ADDENDUM: How to use this License for your documents
11885====================================================
11886
11887To use this License in a document you have written, include a copy of
11888the License in the document and put the following copyright and license
11889notices just after the title page:
11890
11891       Copyright (C)  YEAR  YOUR NAME.
11892       Permission is granted to copy, distribute and/or modify this document
11893       under the terms of the GNU Free Documentation License, Version 1.3
11894       or any later version published by the Free Software Foundation;
11895       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
11896       Texts.  A copy of the license is included in the section entitled ``GNU
11897       Free Documentation License''.
11898
11899   If you have Invariant Sections, Front-Cover Texts and Back-Cover
11900Texts, replace the "with...Texts."  line with this:
11901
11902         with the Invariant Sections being LIST THEIR TITLES, with
11903         the Front-Cover Texts being LIST, and with the Back-Cover Texts
11904         being LIST.
11905
11906   If you have Invariant Sections without Cover Texts, or some other
11907combination of the three, merge those two alternatives to suit the
11908situation.
11909
11910   If your document contains nontrivial examples of program code, we
11911recommend releasing these examples in parallel under your choice of free
11912software license, such as the GNU General Public License, to permit
11913their use in free software.
11914
11915
11916File: bfd.info,  Node: BFD Index,  Prev: GNU Free Documentation License,  Up: Top
11917
11918BFD Index
11919*********
11920
11921[index]
11922* Menu:
11923
11924* _bfd_error_handler:                    Error reporting.    (line  112)
11925* _bfd_final_link_relocate:              Relocating the section contents.
11926                                                             (line   22)
11927* _bfd_generic_link_add_archive_symbols: Adding symbols from an archive.
11928                                                             (line   15)
11929* _bfd_generic_link_add_one_symbol:      Adding symbols from an object file.
11930                                                             (line   19)
11931* _bfd_generic_link_check_relocs:        Writing the symbol table.
11932                                                             (line  144)
11933* _bfd_generic_link_hide_symbol:         Writing the symbol table.
11934                                                             (line   83)
11935* _bfd_generic_make_empty_symbol:        symbol handling functions.
11936                                                             (line   96)
11937* _bfd_generic_set_reloc:                howto manager.      (line 3589)
11938* _bfd_generic_verify_endian_match:      Writing the symbol table.
11939                                                             (line  172)
11940* _bfd_link_add_symbols in target vector: Adding Symbols to the Hash Table.
11941                                                             (line    6)
11942* _bfd_link_final_link in target vector: Performing the Final Link.
11943                                                             (line    6)
11944* _bfd_link_hash_table_create in target vector: Creating a Linker Hash Table.
11945                                                             (line    6)
11946* _bfd_relocate_contents:                Relocating the section contents.
11947                                                             (line   22)
11948* _bfd_unrecognized_reloc:               howto manager.      (line 3601)
11949* aout_SIZE_machine_type:                aout.               (line  145)
11950* aout_SIZE_mkobject:                    aout.               (line  137)
11951* aout_SIZE_new_section_hook:            aout.               (line  175)
11952* aout_SIZE_set_arch_mach:               aout.               (line  162)
11953* aout_SIZE_some_aout_object_p:          aout.               (line  123)
11954* aout_SIZE_swap_exec_header_in:         aout.               (line   99)
11955* aout_SIZE_swap_exec_header_out:        aout.               (line  111)
11956* arelent_chain:                         typedef arelent.    (line  311)
11957* BFD:                                   Overview.           (line    6)
11958* BFD canonical format:                  Canonical format.   (line   11)
11959* bfd_alloc:                             Opening and Closing.
11960                                                             (line  248)
11961* bfd_alt_mach_code:                     Miscellaneous.      (line  301)
11962* bfd_arch_bits_per_address:             Architectures.      (line  673)
11963* bfd_arch_bits_per_byte:                Architectures.      (line  665)
11964* bfd_arch_default_fill:                 Architectures.      (line  755)
11965* bfd_arch_get_compatible:               Architectures.      (line  608)
11966* bfd_arch_list:                         Architectures.      (line  599)
11967* bfd_arch_mach_octets_per_byte:         Architectures.      (line  743)
11968* BFD_ARELOC_BFIN_ADD:                   howto manager.      (line 1164)
11969* BFD_ARELOC_BFIN_ADDR:                  howto manager.      (line 1198)
11970* BFD_ARELOC_BFIN_AND:                   howto manager.      (line 1178)
11971* BFD_ARELOC_BFIN_COMP:                  howto manager.      (line 1192)
11972* BFD_ARELOC_BFIN_CONST:                 howto manager.      (line 1162)
11973* BFD_ARELOC_BFIN_DIV:                   howto manager.      (line 1170)
11974* BFD_ARELOC_BFIN_HWPAGE:                howto manager.      (line 1196)
11975* BFD_ARELOC_BFIN_LAND:                  howto manager.      (line 1184)
11976* BFD_ARELOC_BFIN_LEN:                   howto manager.      (line 1188)
11977* BFD_ARELOC_BFIN_LOR:                   howto manager.      (line 1186)
11978* BFD_ARELOC_BFIN_LSHIFT:                howto manager.      (line 1174)
11979* BFD_ARELOC_BFIN_MOD:                   howto manager.      (line 1172)
11980* BFD_ARELOC_BFIN_MULT:                  howto manager.      (line 1168)
11981* BFD_ARELOC_BFIN_NEG:                   howto manager.      (line 1190)
11982* BFD_ARELOC_BFIN_OR:                    howto manager.      (line 1180)
11983* BFD_ARELOC_BFIN_PAGE:                  howto manager.      (line 1194)
11984* BFD_ARELOC_BFIN_PUSH:                  howto manager.      (line 1160)
11985* BFD_ARELOC_BFIN_RSHIFT:                howto manager.      (line 1176)
11986* BFD_ARELOC_BFIN_SUB:                   howto manager.      (line 1166)
11987* BFD_ARELOC_BFIN_XOR:                   howto manager.      (line 1182)
11988* bfd_cache_close:                       File Caching.       (line   25)
11989* bfd_cache_close_all:                   File Caching.       (line   38)
11990* bfd_cache_init:                        File Caching.       (line   17)
11991* bfd_calc_gnu_debuglink_crc32:          Opening and Closing.
11992                                                             (line  266)
11993* bfd_canonicalize_reloc:                Miscellaneous.      (line   18)
11994* bfd_canonicalize_symtab:               symbol handling functions.
11995                                                             (line   52)
11996* bfd_check_compression_header:          Miscellaneous.      (line  355)
11997* bfd_check_format:                      Formats.            (line   20)
11998* bfd_check_format_matches:              Formats.            (line   51)
11999* bfd_check_overflow:                    typedef arelent.    (line  324)
12000* bfd_close:                             Opening and Closing.
12001                                                             (line  170)
12002* bfd_close_all_done:                    Opening and Closing.
12003                                                             (line  188)
12004* bfd_coff_backend_data:                 coff.               (line  300)
12005* bfd_convert_section_contents:          Miscellaneous.      (line  393)
12006* bfd_convert_section_size:              Miscellaneous.      (line  383)
12007* bfd_copy_private_bfd_data:             Miscellaneous.      (line  168)
12008* bfd_copy_private_header_data:          Miscellaneous.      (line  151)
12009* bfd_copy_private_section_data:         section prototypes. (line  279)
12010* bfd_copy_private_symbol_data:          symbol handling functions.
12011                                                             (line  145)
12012* bfd_core_file_failing_command:         Core Files.         (line   11)
12013* bfd_core_file_failing_signal:          Core Files.         (line   20)
12014* bfd_core_file_pid:                     Core Files.         (line   29)
12015* bfd_create:                            Opening and Closing.
12016                                                             (line  207)
12017* bfd_create_gnu_debuglink_section:      Opening and Closing.
12018                                                             (line  422)
12019* bfd_decode_symclass:                   symbol handling functions.
12020                                                             (line  116)
12021* bfd_default_arch_struct:               Architectures.      (line  620)
12022* bfd_default_compatible:                Architectures.      (line  682)
12023* bfd_default_reloc_type_lookup:         howto manager.      (line 3513)
12024* bfd_default_scan:                      Architectures.      (line  691)
12025* bfd_default_set_arch_mach:             Architectures.      (line  638)
12026* bfd_demangle:                          Miscellaneous.      (line  334)
12027* bfd_emul_get_commonpagesize:           Miscellaneous.      (line  323)
12028* bfd_emul_get_maxpagesize:              Miscellaneous.      (line  312)
12029* bfd_errmsg:                            Error reporting.    (line   79)
12030* bfd_fdopenr:                           Opening and Closing.
12031                                                             (line   56)
12032* bfd_fdopenw:                           Opening and Closing.
12033                                                             (line   82)
12034* bfd_fill_in_gnu_debuglink_section:     Opening and Closing.
12035                                                             (line  436)
12036* bfd_find_target:                       bfd_target.         (line  581)
12037* bfd_find_version_for_sym:              Writing the symbol table.
12038                                                             (line  111)
12039* bfd_flavour_name:                      bfd_target.         (line  644)
12040* bfd_follow_build_id_debuglink:         Opening and Closing.
12041                                                             (line  496)
12042* bfd_follow_gnu_debugaltlink:           Opening and Closing.
12043                                                             (line  402)
12044* bfd_follow_gnu_debuglink:              Opening and Closing.
12045                                                             (line  381)
12046* bfd_fopen:                             Opening and Closing.
12047                                                             (line   11)
12048* bfd_format_string:                     Formats.            (line   78)
12049* bfd_generic_define_common_symbol:      Writing the symbol table.
12050                                                             (line   69)
12051* bfd_generic_define_start_stop:         Writing the symbol table.
12052                                                             (line   97)
12053* bfd_generic_discard_group:             section prototypes. (line  312)
12054* bfd_generic_gc_sections:               howto manager.      (line 3544)
12055* bfd_generic_get_relocated_section_contents: howto manager. (line 3574)
12056* bfd_generic_group_name:                section prototypes. (line  304)
12057* bfd_generic_is_group_section:          section prototypes. (line  296)
12058* bfd_generic_lookup_section_flags:      howto manager.      (line 3554)
12059* bfd_generic_merge_sections:            howto manager.      (line 3564)
12060* bfd_generic_relax_section:             howto manager.      (line 3531)
12061* bfd_get_alt_debug_link_info:           Opening and Closing.
12062                                                             (line  320)
12063* bfd_get_arch:                          Architectures.      (line  649)
12064* bfd_get_arch_info:                     Architectures.      (line  701)
12065* bfd_get_arch_size:                     Miscellaneous.      (line   63)
12066* bfd_get_compression_header_size:       Miscellaneous.      (line  372)
12067* bfd_get_debug_link_info:               Opening and Closing.
12068                                                             (line  302)
12069* bfd_get_debug_link_info_1:             Opening and Closing.
12070                                                             (line  280)
12071* bfd_get_error:                         Error reporting.    (line   49)
12072* bfd_get_file_size:                     Miscellaneous.      (line  484)
12073* bfd_get_gp_size:                       Miscellaneous.      (line  106)
12074* bfd_get_linker_section:                section prototypes. (line   37)
12075* bfd_get_mach:                          Architectures.      (line  657)
12076* bfd_get_mtime:                         Miscellaneous.      (line  445)
12077* bfd_get_next_mapent:                   Archives.           (line   57)
12078* bfd_get_next_section_by_name:          section prototypes. (line   25)
12079* bfd_get_reloc_code_name:               howto manager.      (line 3522)
12080* bfd_get_reloc_upper_bound:             Miscellaneous.      (line    8)
12081* bfd_get_section_by_name:               section prototypes. (line   16)
12082* bfd_get_section_by_name_if:            section prototypes. (line   46)
12083* bfd_get_section_contents:              section prototypes. (line  252)
12084* bfd_get_sign_extend_vma:               Miscellaneous.      (line   78)
12085* bfd_get_size:                          Miscellaneous.      (line  454)
12086* bfd_get_symtab_upper_bound:            symbol handling functions.
12087                                                             (line    5)
12088* bfd_get_target_info:                   bfd_target.         (line  597)
12089* bfd_get_unique_section_name:           section prototypes. (line   65)
12090* bfd_hash_allocate:                     Creating and Freeing a Hash Table.
12091                                                             (line   17)
12092* bfd_hash_lookup:                       Looking Up or Entering a String.
12093                                                             (line    6)
12094* bfd_hash_newfunc:                      Creating and Freeing a Hash Table.
12095                                                             (line   12)
12096* bfd_hash_set_default_size:             Creating and Freeing a Hash Table.
12097                                                             (line   25)
12098* bfd_hash_table_free:                   Creating and Freeing a Hash Table.
12099                                                             (line   21)
12100* bfd_hash_table_init:                   Creating and Freeing a Hash Table.
12101                                                             (line    6)
12102* bfd_hash_table_init_n:                 Creating and Freeing a Hash Table.
12103                                                             (line    6)
12104* bfd_hash_traverse:                     Traversing a Hash Table.
12105                                                             (line    6)
12106* bfd_hide_sym_by_version:               Writing the symbol table.
12107                                                             (line  123)
12108* bfd_init:                              Initialization.     (line   10)
12109* bfd_install_relocation:                typedef arelent.    (line  378)
12110* bfd_is_local_label:                    symbol handling functions.
12111                                                             (line   17)
12112* bfd_is_local_label_name:               symbol handling functions.
12113                                                             (line   26)
12114* bfd_is_target_special_symbol:          symbol handling functions.
12115                                                             (line   39)
12116* bfd_is_undefined_symclass:             symbol handling functions.
12117                                                             (line  125)
12118* bfd_iterate_over_targets:              bfd_target.         (line  632)
12119* bfd_link_check_relocs:                 Writing the symbol table.
12120                                                             (line  133)
12121* bfd_link_split_section:                Writing the symbol table.
12122                                                             (line   43)
12123* bfd_lookup_arch:                       Architectures.      (line  709)
12124* bfd_make_debug_symbol:                 symbol handling functions.
12125                                                             (line  106)
12126* bfd_make_empty_symbol:                 symbol handling functions.
12127                                                             (line   81)
12128* bfd_make_readable:                     Opening and Closing.
12129                                                             (line  234)
12130* bfd_make_section:                      section prototypes. (line  143)
12131* bfd_make_section_anyway:               section prototypes. (line  115)
12132* bfd_make_section_anyway_with_flags:    section prototypes. (line   97)
12133* bfd_make_section_old_way:              section prototypes. (line   77)
12134* bfd_make_section_with_flags:           section prototypes. (line  131)
12135* bfd_make_writable:                     Opening and Closing.
12136                                                             (line  220)
12137* bfd_malloc_and_get_section:            section prototypes. (line  269)
12138* bfd_map_over_sections:                 section prototypes. (line  176)
12139* bfd_merge_private_bfd_data:            Writing the symbol table.
12140                                                             (line  155)
12141* bfd_mmap:                              Miscellaneous.      (line  493)
12142* bfd_octets_per_byte:                   Architectures.      (line  732)
12143* bfd_openr:                             Opening and Closing.
12144                                                             (line   37)
12145* bfd_openr_iovec:                       Opening and Closing.
12146                                                             (line  104)
12147* bfd_openr_next_archived_file:          Archives.           (line   83)
12148* bfd_openstreamr:                       Opening and Closing.
12149                                                             (line   91)
12150* bfd_openw:                             Opening and Closing.
12151                                                             (line  155)
12152* bfd_open_file:                         File Caching.       (line   51)
12153* bfd_perform_relocation:                typedef arelent.    (line  353)
12154* bfd_perror:                            Error reporting.    (line   88)
12155* bfd_printable_arch_mach:               Architectures.      (line  720)
12156* bfd_printable_name:                    Architectures.      (line  580)
12157* bfd_print_symbol_vandf:                symbol handling functions.
12158                                                             (line   73)
12159* BFD_RELOC_12_PCREL:                    howto manager.      (line   37)
12160* BFD_RELOC_14:                          howto manager.      (line   30)
12161* BFD_RELOC_16:                          howto manager.      (line   29)
12162* BFD_RELOC_16_BASEREL:                  howto manager.      (line   96)
12163* BFD_RELOC_16_GOTOFF:                   howto manager.      (line   50)
12164* BFD_RELOC_16_GOT_PCREL:                howto manager.      (line   47)
12165* BFD_RELOC_16_PCREL:                    howto manager.      (line   36)
12166* BFD_RELOC_16_PCREL_S2:                 howto manager.      (line  106)
12167* BFD_RELOC_16_PLTOFF:                   howto manager.      (line   62)
12168* BFD_RELOC_16_PLT_PCREL:                howto manager.      (line   58)
12169* BFD_RELOC_16_SECIDX:                   howto manager.      (line   44)
12170* BFD_RELOC_23_PCREL_S2:                 howto manager.      (line  107)
12171* BFD_RELOC_24:                          howto manager.      (line   28)
12172* BFD_RELOC_24_PCREL:                    howto manager.      (line   35)
12173* BFD_RELOC_24_PLT_PCREL:                howto manager.      (line   57)
12174* BFD_RELOC_26:                          howto manager.      (line   27)
12175* BFD_RELOC_32:                          howto manager.      (line   26)
12176* BFD_RELOC_32_BASEREL:                  howto manager.      (line   95)
12177* BFD_RELOC_32_GOTOFF:                   howto manager.      (line   49)
12178* BFD_RELOC_32_GOT_PCREL:                howto manager.      (line   46)
12179* BFD_RELOC_32_PCREL:                    howto manager.      (line   34)
12180* BFD_RELOC_32_PCREL_S2:                 howto manager.      (line  105)
12181* BFD_RELOC_32_PLTOFF:                   howto manager.      (line   61)
12182* BFD_RELOC_32_PLT_PCREL:                howto manager.      (line   56)
12183* BFD_RELOC_32_SECREL:                   howto manager.      (line   43)
12184* BFD_RELOC_386_COPY:                    howto manager.      (line  529)
12185* BFD_RELOC_386_GLOB_DAT:                howto manager.      (line  530)
12186* BFD_RELOC_386_GOT32:                   howto manager.      (line  527)
12187* BFD_RELOC_386_GOT32X:                  howto manager.      (line  551)
12188* BFD_RELOC_386_GOTOFF:                  howto manager.      (line  533)
12189* BFD_RELOC_386_GOTPC:                   howto manager.      (line  534)
12190* BFD_RELOC_386_IRELATIVE:               howto manager.      (line  550)
12191* BFD_RELOC_386_JUMP_SLOT:               howto manager.      (line  531)
12192* BFD_RELOC_386_PLT32:                   howto manager.      (line  528)
12193* BFD_RELOC_386_RELATIVE:                howto manager.      (line  532)
12194* BFD_RELOC_386_TLS_DESC:                howto manager.      (line  549)
12195* BFD_RELOC_386_TLS_DESC_CALL:           howto manager.      (line  548)
12196* BFD_RELOC_386_TLS_DTPMOD32:            howto manager.      (line  544)
12197* BFD_RELOC_386_TLS_DTPOFF32:            howto manager.      (line  545)
12198* BFD_RELOC_386_TLS_GD:                  howto manager.      (line  539)
12199* BFD_RELOC_386_TLS_GOTDESC:             howto manager.      (line  547)
12200* BFD_RELOC_386_TLS_GOTIE:               howto manager.      (line  537)
12201* BFD_RELOC_386_TLS_IE:                  howto manager.      (line  536)
12202* BFD_RELOC_386_TLS_IE_32:               howto manager.      (line  542)
12203* BFD_RELOC_386_TLS_LDM:                 howto manager.      (line  540)
12204* BFD_RELOC_386_TLS_LDO_32:              howto manager.      (line  541)
12205* BFD_RELOC_386_TLS_LE:                  howto manager.      (line  538)
12206* BFD_RELOC_386_TLS_LE_32:               howto manager.      (line  543)
12207* BFD_RELOC_386_TLS_TPOFF:               howto manager.      (line  535)
12208* BFD_RELOC_386_TLS_TPOFF32:             howto manager.      (line  546)
12209* BFD_RELOC_390_12:                      howto manager.      (line 1970)
12210* BFD_RELOC_390_20:                      howto manager.      (line 2051)
12211* BFD_RELOC_390_COPY:                    howto manager.      (line 1976)
12212* BFD_RELOC_390_GLOB_DAT:                howto manager.      (line 1978)
12213* BFD_RELOC_390_GOT12:                   howto manager.      (line 1972)
12214* BFD_RELOC_390_GOT16:                   howto manager.      (line 1986)
12215* BFD_RELOC_390_GOT20:                   howto manager.      (line 2052)
12216* BFD_RELOC_390_GOT64:                   howto manager.      (line 2006)
12217* BFD_RELOC_390_GOTENT:                  howto manager.      (line 2010)
12218* BFD_RELOC_390_GOTOFF64:                howto manager.      (line 2012)
12219* BFD_RELOC_390_GOTPC:                   howto manager.      (line 1984)
12220* BFD_RELOC_390_GOTPCDBL:                howto manager.      (line 2004)
12221* BFD_RELOC_390_GOTPLT12:                howto manager.      (line 2014)
12222* BFD_RELOC_390_GOTPLT16:                howto manager.      (line 2016)
12223* BFD_RELOC_390_GOTPLT20:                howto manager.      (line 2053)
12224* BFD_RELOC_390_GOTPLT32:                howto manager.      (line 2018)
12225* BFD_RELOC_390_GOTPLT64:                howto manager.      (line 2020)
12226* BFD_RELOC_390_GOTPLTENT:               howto manager.      (line 2022)
12227* BFD_RELOC_390_IRELATIVE:               howto manager.      (line 2056)
12228* BFD_RELOC_390_JMP_SLOT:                howto manager.      (line 1980)
12229* BFD_RELOC_390_PC12DBL:                 howto manager.      (line 1988)
12230* BFD_RELOC_390_PC16DBL:                 howto manager.      (line 1992)
12231* BFD_RELOC_390_PC24DBL:                 howto manager.      (line 1996)
12232* BFD_RELOC_390_PC32DBL:                 howto manager.      (line 2000)
12233* BFD_RELOC_390_PLT12DBL:                howto manager.      (line 1990)
12234* BFD_RELOC_390_PLT16DBL:                howto manager.      (line 1994)
12235* BFD_RELOC_390_PLT24DBL:                howto manager.      (line 1998)
12236* BFD_RELOC_390_PLT32:                   howto manager.      (line 1974)
12237* BFD_RELOC_390_PLT32DBL:                howto manager.      (line 2002)
12238* BFD_RELOC_390_PLT64:                   howto manager.      (line 2008)
12239* BFD_RELOC_390_PLTOFF16:                howto manager.      (line 2024)
12240* BFD_RELOC_390_PLTOFF32:                howto manager.      (line 2026)
12241* BFD_RELOC_390_PLTOFF64:                howto manager.      (line 2028)
12242* BFD_RELOC_390_RELATIVE:                howto manager.      (line 1982)
12243* BFD_RELOC_390_TLS_DTPMOD:              howto manager.      (line 2047)
12244* BFD_RELOC_390_TLS_DTPOFF:              howto manager.      (line 2048)
12245* BFD_RELOC_390_TLS_GD32:                howto manager.      (line 2033)
12246* BFD_RELOC_390_TLS_GD64:                howto manager.      (line 2034)
12247* BFD_RELOC_390_TLS_GDCALL:              howto manager.      (line 2031)
12248* BFD_RELOC_390_TLS_GOTIE12:             howto manager.      (line 2035)
12249* BFD_RELOC_390_TLS_GOTIE20:             howto manager.      (line 2054)
12250* BFD_RELOC_390_TLS_GOTIE32:             howto manager.      (line 2036)
12251* BFD_RELOC_390_TLS_GOTIE64:             howto manager.      (line 2037)
12252* BFD_RELOC_390_TLS_IE32:                howto manager.      (line 2040)
12253* BFD_RELOC_390_TLS_IE64:                howto manager.      (line 2041)
12254* BFD_RELOC_390_TLS_IEENT:               howto manager.      (line 2042)
12255* BFD_RELOC_390_TLS_LDCALL:              howto manager.      (line 2032)
12256* BFD_RELOC_390_TLS_LDM32:               howto manager.      (line 2038)
12257* BFD_RELOC_390_TLS_LDM64:               howto manager.      (line 2039)
12258* BFD_RELOC_390_TLS_LDO32:               howto manager.      (line 2045)
12259* BFD_RELOC_390_TLS_LDO64:               howto manager.      (line 2046)
12260* BFD_RELOC_390_TLS_LE32:                howto manager.      (line 2043)
12261* BFD_RELOC_390_TLS_LE64:                howto manager.      (line 2044)
12262* BFD_RELOC_390_TLS_LOAD:                howto manager.      (line 2030)
12263* BFD_RELOC_390_TLS_TPOFF:               howto manager.      (line 2049)
12264* BFD_RELOC_64:                          howto manager.      (line   25)
12265* BFD_RELOC_64_PCREL:                    howto manager.      (line   33)
12266* BFD_RELOC_64_PLTOFF:                   howto manager.      (line   60)
12267* BFD_RELOC_64_PLT_PCREL:                howto manager.      (line   55)
12268* BFD_RELOC_68K_GLOB_DAT:                howto manager.      (line   71)
12269* BFD_RELOC_68K_JMP_SLOT:                howto manager.      (line   72)
12270* BFD_RELOC_68K_RELATIVE:                howto manager.      (line   73)
12271* BFD_RELOC_68K_TLS_GD16:                howto manager.      (line   75)
12272* BFD_RELOC_68K_TLS_GD32:                howto manager.      (line   74)
12273* BFD_RELOC_68K_TLS_GD8:                 howto manager.      (line   76)
12274* BFD_RELOC_68K_TLS_IE16:                howto manager.      (line   84)
12275* BFD_RELOC_68K_TLS_IE32:                howto manager.      (line   83)
12276* BFD_RELOC_68K_TLS_IE8:                 howto manager.      (line   85)
12277* BFD_RELOC_68K_TLS_LDM16:               howto manager.      (line   78)
12278* BFD_RELOC_68K_TLS_LDM32:               howto manager.      (line   77)
12279* BFD_RELOC_68K_TLS_LDM8:                howto manager.      (line   79)
12280* BFD_RELOC_68K_TLS_LDO16:               howto manager.      (line   81)
12281* BFD_RELOC_68K_TLS_LDO32:               howto manager.      (line   80)
12282* BFD_RELOC_68K_TLS_LDO8:                howto manager.      (line   82)
12283* BFD_RELOC_68K_TLS_LE16:                howto manager.      (line   87)
12284* BFD_RELOC_68K_TLS_LE32:                howto manager.      (line   86)
12285* BFD_RELOC_68K_TLS_LE8:                 howto manager.      (line   88)
12286* BFD_RELOC_8:                           howto manager.      (line   31)
12287* BFD_RELOC_8_BASEREL:                   howto manager.      (line  100)
12288* BFD_RELOC_8_FFnn:                      howto manager.      (line  103)
12289* BFD_RELOC_8_GOTOFF:                    howto manager.      (line   54)
12290* BFD_RELOC_8_GOT_PCREL:                 howto manager.      (line   48)
12291* BFD_RELOC_8_PCREL:                     howto manager.      (line   38)
12292* BFD_RELOC_8_PLTOFF:                    howto manager.      (line   66)
12293* BFD_RELOC_8_PLT_PCREL:                 howto manager.      (line   59)
12294* BFD_RELOC_AARCH64_16:                  howto manager.      (line 2810)
12295* BFD_RELOC_AARCH64_16_PCREL:            howto manager.      (line 2816)
12296* BFD_RELOC_AARCH64_32:                  howto manager.      (line 2809)
12297* BFD_RELOC_AARCH64_32_PCREL:            howto manager.      (line 2815)
12298* BFD_RELOC_AARCH64_64:                  howto manager.      (line 2808)
12299* BFD_RELOC_AARCH64_64_PCREL:            howto manager.      (line 2814)
12300* BFD_RELOC_AARCH64_ADD_LO12:            howto manager.      (line 2889)
12301* BFD_RELOC_AARCH64_ADR_GOT_PAGE:        howto manager.      (line 2935)
12302* BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL:   howto manager.      (line 2885)
12303* BFD_RELOC_AARCH64_ADR_HI21_PCREL:      howto manager.      (line 2882)
12304* BFD_RELOC_AARCH64_ADR_LO21_PCREL:      howto manager.      (line 2879)
12305* BFD_RELOC_AARCH64_BRANCH19:            howto manager.      (line 2901)
12306* BFD_RELOC_AARCH64_CALL26:              howto manager.      (line 2909)
12307* BFD_RELOC_AARCH64_COPY:                howto manager.      (line 3102)
12308* BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP:  howto manager.      (line 3126)
12309* BFD_RELOC_AARCH64_GLOB_DAT:            howto manager.      (line 3104)
12310* BFD_RELOC_AARCH64_GOT_LD_PREL19:       howto manager.      (line 2929)
12311* BFD_RELOC_AARCH64_IRELATIVE:           howto manager.      (line 3118)
12312* BFD_RELOC_AARCH64_JUMP26:              howto manager.      (line 2905)
12313* BFD_RELOC_AARCH64_JUMP_SLOT:           howto manager.      (line 3106)
12314* BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14:   howto manager.      (line 2956)
12315* BFD_RELOC_AARCH64_LD32_GOT_LO12_NC:    howto manager.      (line 2943)
12316* BFD_RELOC_AARCH64_LD64_GOTOFF_LO15:    howto manager.      (line 2953)
12317* BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15:   howto manager.      (line 2959)
12318* BFD_RELOC_AARCH64_LD64_GOT_LO12_NC:    howto manager.      (line 2939)
12319* BFD_RELOC_AARCH64_LDST128_LO12:        howto manager.      (line 2925)
12320* BFD_RELOC_AARCH64_LDST16_LO12:         howto manager.      (line 2913)
12321* BFD_RELOC_AARCH64_LDST32_LO12:         howto manager.      (line 2917)
12322* BFD_RELOC_AARCH64_LDST64_LO12:         howto manager.      (line 2921)
12323* BFD_RELOC_AARCH64_LDST8_LO12:          howto manager.      (line 2893)
12324* BFD_RELOC_AARCH64_LDST_LO12:           howto manager.      (line 3129)
12325* BFD_RELOC_AARCH64_LD_GOT_LO12_NC:      howto manager.      (line 3147)
12326* BFD_RELOC_AARCH64_LD_LO19_PCREL:       howto manager.      (line 2875)
12327* BFD_RELOC_AARCH64_MOVW_G0:             howto manager.      (line 2819)
12328* BFD_RELOC_AARCH64_MOVW_G0_NC:          howto manager.      (line 2822)
12329* BFD_RELOC_AARCH64_MOVW_G0_S:           howto manager.      (line 2840)
12330* BFD_RELOC_AARCH64_MOVW_G1:             howto manager.      (line 2825)
12331* BFD_RELOC_AARCH64_MOVW_G1_NC:          howto manager.      (line 2828)
12332* BFD_RELOC_AARCH64_MOVW_G1_S:           howto manager.      (line 2844)
12333* BFD_RELOC_AARCH64_MOVW_G2:             howto manager.      (line 2831)
12334* BFD_RELOC_AARCH64_MOVW_G2_NC:          howto manager.      (line 2834)
12335* BFD_RELOC_AARCH64_MOVW_G2_S:           howto manager.      (line 2848)
12336* BFD_RELOC_AARCH64_MOVW_G3:             howto manager.      (line 2837)
12337* BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC:   howto manager.      (line 2947)
12338* BFD_RELOC_AARCH64_MOVW_GOTOFF_G1:      howto manager.      (line 2950)
12339* BFD_RELOC_AARCH64_MOVW_PREL_G0:        howto manager.      (line 2852)
12340* BFD_RELOC_AARCH64_MOVW_PREL_G0_NC:     howto manager.      (line 2856)
12341* BFD_RELOC_AARCH64_MOVW_PREL_G1:        howto manager.      (line 2860)
12342* BFD_RELOC_AARCH64_MOVW_PREL_G1_NC:     howto manager.      (line 2863)
12343* BFD_RELOC_AARCH64_MOVW_PREL_G2:        howto manager.      (line 2866)
12344* BFD_RELOC_AARCH64_MOVW_PREL_G2_NC:     howto manager.      (line 2869)
12345* BFD_RELOC_AARCH64_MOVW_PREL_G3:        howto manager.      (line 2872)
12346* BFD_RELOC_AARCH64_NONE:                howto manager.      (line 2806)
12347* BFD_RELOC_AARCH64_NULL:                howto manager.      (line 2804)
12348* BFD_RELOC_AARCH64_RELATIVE:            howto manager.      (line 3108)
12349* BFD_RELOC_AARCH64_RELOC_END:           howto manager.      (line 3120)
12350* BFD_RELOC_AARCH64_RELOC_START:         howto manager.      (line 2799)
12351* BFD_RELOC_AARCH64_TLSDESC:             howto manager.      (line 3116)
12352* BFD_RELOC_AARCH64_TLSDESC_ADD:         howto manager.      (line 3098)
12353* BFD_RELOC_AARCH64_TLSDESC_ADD_LO12:    howto manager.      (line 3090)
12354* BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21:  howto manager.      (line 3084)
12355* BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21:  howto manager.      (line 3082)
12356* BFD_RELOC_AARCH64_TLSDESC_CALL:        howto manager.      (line 3100)
12357* BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC: howto manager.     (line 3088)
12358* BFD_RELOC_AARCH64_TLSDESC_LD64_LO12:   howto manager.      (line 3086)
12359* BFD_RELOC_AARCH64_TLSDESC_LDR:         howto manager.      (line 3096)
12360* BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC:  howto manager.      (line 3153)
12361* BFD_RELOC_AARCH64_TLSDESC_LD_PREL19:   howto manager.      (line 3080)
12362* BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC:   howto manager.      (line 3094)
12363* BFD_RELOC_AARCH64_TLSDESC_OFF_G1:      howto manager.      (line 3092)
12364* BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC:   howto manager.      (line 2969)
12365* BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21:    howto manager.      (line 2962)
12366* BFD_RELOC_AARCH64_TLSGD_ADR_PREL21:    howto manager.      (line 2967)
12367* BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC:    howto manager.      (line 2973)
12368* BFD_RELOC_AARCH64_TLSGD_MOVW_G1:       howto manager.      (line 2975)
12369* BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21: howto manager.
12370                                                             (line 2977)
12371* BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC: howto manager.
12372                                                             (line 2981)
12373* BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC: howto manager.
12374                                                             (line 2979)
12375* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC: howto manager.
12376                                                             (line 3150)
12377* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19: howto manager. (line 2983)
12378* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC: howto manager.
12379                                                             (line 2985)
12380* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1: howto manager.   (line 2987)
12381* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12: howto manager.    (line 2989)
12382* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12: howto manager.    (line 2991)
12383* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC: howto manager. (line 2993)
12384* BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC:   howto manager.      (line 2996)
12385* BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21:    howto manager.      (line 3000)
12386* BFD_RELOC_AARCH64_TLSLD_ADR_PREL21:    howto manager.      (line 3003)
12387* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12: howto manager. (line 3006)
12388* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC: howto manager.
12389                                                             (line 3009)
12390* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12: howto manager. (line 3012)
12391* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC: howto manager.
12392                                                             (line 3015)
12393* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12: howto manager. (line 3018)
12394* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC: howto manager.
12395                                                             (line 3021)
12396* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12: howto manager.  (line 3024)
12397* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC: howto manager.
12398                                                             (line 3027)
12399* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12: howto manager.   (line 3133)
12400* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC: howto manager.
12401                                                             (line 3137)
12402* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0: howto manager.     (line 3030)
12403* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC: howto manager.  (line 3032)
12404* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1: howto manager.     (line 3034)
12405* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC: howto manager.  (line 3036)
12406* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2: howto manager.     (line 3038)
12407* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12: howto manager.     (line 3050)
12408* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12: howto manager.     (line 3052)
12409* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC: howto manager.  (line 3054)
12410* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12: howto manager.  (line 3056)
12411* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC: howto manager.
12412                                                             (line 3059)
12413* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12: howto manager.  (line 3062)
12414* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC: howto manager.
12415                                                             (line 3065)
12416* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12: howto manager.  (line 3068)
12417* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC: howto manager.
12418                                                             (line 3071)
12419* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12: howto manager.   (line 3074)
12420* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC: howto manager.
12421                                                             (line 3077)
12422* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12: howto manager.    (line 3140)
12423* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC: howto manager. (line 3144)
12424* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0: howto manager.      (line 3046)
12425* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC: howto manager.   (line 3048)
12426* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1: howto manager.      (line 3042)
12427* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC: howto manager.   (line 3044)
12428* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2: howto manager.      (line 3040)
12429* BFD_RELOC_AARCH64_TLS_DTPMOD:          howto manager.      (line 3110)
12430* BFD_RELOC_AARCH64_TLS_DTPREL:          howto manager.      (line 3112)
12431* BFD_RELOC_AARCH64_TLS_TPREL:           howto manager.      (line 3114)
12432* BFD_RELOC_AARCH64_TSTBR14:             howto manager.      (line 2897)
12433* BFD_RELOC_AC_SECTOFF_S9:               howto manager.      (line 1082)
12434* BFD_RELOC_AC_SECTOFF_S9_1:             howto manager.      (line 1083)
12435* BFD_RELOC_AC_SECTOFF_S9_2:             howto manager.      (line 1084)
12436* BFD_RELOC_AC_SECTOFF_U8:               howto manager.      (line 1079)
12437* BFD_RELOC_AC_SECTOFF_U8_1:             howto manager.      (line 1080)
12438* BFD_RELOC_AC_SECTOFF_U8_2:             howto manager.      (line 1081)
12439* BFD_RELOC_ALPHA_BOH:                   howto manager.      (line  294)
12440* BFD_RELOC_ALPHA_BRSGP:                 howto manager.      (line  281)
12441* BFD_RELOC_ALPHA_BSR:                   howto manager.      (line  288)
12442* BFD_RELOC_ALPHA_CODEADDR:              howto manager.      (line  274)
12443* BFD_RELOC_ALPHA_DTPMOD64:              howto manager.      (line  299)
12444* BFD_RELOC_ALPHA_DTPREL16:              howto manager.      (line  304)
12445* BFD_RELOC_ALPHA_DTPREL64:              howto manager.      (line  301)
12446* BFD_RELOC_ALPHA_DTPREL_HI16:           howto manager.      (line  302)
12447* BFD_RELOC_ALPHA_DTPREL_LO16:           howto manager.      (line  303)
12448* BFD_RELOC_ALPHA_ELF_LITERAL:           howto manager.      (line  242)
12449* BFD_RELOC_ALPHA_GOTDTPREL16:           howto manager.      (line  300)
12450* BFD_RELOC_ALPHA_GOTTPREL16:            howto manager.      (line  305)
12451* BFD_RELOC_ALPHA_GPDISP:                howto manager.      (line  237)
12452* BFD_RELOC_ALPHA_GPDISP_HI16:           howto manager.      (line  225)
12453* BFD_RELOC_ALPHA_GPDISP_LO16:           howto manager.      (line  232)
12454* BFD_RELOC_ALPHA_GPREL_HI16:            howto manager.      (line  277)
12455* BFD_RELOC_ALPHA_GPREL_LO16:            howto manager.      (line  278)
12456* BFD_RELOC_ALPHA_HINT:                  howto manager.      (line  267)
12457* BFD_RELOC_ALPHA_LDA:                   howto manager.      (line  291)
12458* BFD_RELOC_ALPHA_LINKAGE:               howto manager.      (line  271)
12459* BFD_RELOC_ALPHA_LITERAL:               howto manager.      (line  241)
12460* BFD_RELOC_ALPHA_LITUSE:                howto manager.      (line  243)
12461* BFD_RELOC_ALPHA_NOP:                   howto manager.      (line  285)
12462* BFD_RELOC_ALPHA_TLSGD:                 howto manager.      (line  297)
12463* BFD_RELOC_ALPHA_TLSLDM:                howto manager.      (line  298)
12464* BFD_RELOC_ALPHA_TPREL16:               howto manager.      (line  309)
12465* BFD_RELOC_ALPHA_TPREL64:               howto manager.      (line  306)
12466* BFD_RELOC_ALPHA_TPREL_HI16:            howto manager.      (line  307)
12467* BFD_RELOC_ALPHA_TPREL_LO16:            howto manager.      (line  308)
12468* BFD_RELOC_ARC_16:                      howto manager.      (line 1051)
12469* BFD_RELOC_ARC_24:                      howto manager.      (line 1052)
12470* BFD_RELOC_ARC_32:                      howto manager.      (line 1053)
12471* BFD_RELOC_ARC_32_ME:                   howto manager.      (line 1073)
12472* BFD_RELOC_ARC_32_ME_S:                 howto manager.      (line 1074)
12473* BFD_RELOC_ARC_32_PCREL:                howto manager.      (line 1091)
12474* BFD_RELOC_ARC_8:                       howto manager.      (line 1050)
12475* BFD_RELOC_ARC_COPY:                    howto manager.      (line 1096)
12476* BFD_RELOC_ARC_GLOB_DAT:                howto manager.      (line 1097)
12477* BFD_RELOC_ARC_GOT32:                   howto manager.      (line 1093)
12478* BFD_RELOC_ARC_GOTOFF:                  howto manager.      (line 1100)
12479* BFD_RELOC_ARC_GOTPC:                   howto manager.      (line 1101)
12480* BFD_RELOC_ARC_GOTPC32:                 howto manager.      (line 1094)
12481* BFD_RELOC_ARC_JLI_SECTOFF:             howto manager.      (line 1117)
12482* BFD_RELOC_ARC_JMP_SLOT:                howto manager.      (line 1098)
12483* BFD_RELOC_ARC_N16:                     howto manager.      (line 1055)
12484* BFD_RELOC_ARC_N24:                     howto manager.      (line 1056)
12485* BFD_RELOC_ARC_N32:                     howto manager.      (line 1057)
12486* BFD_RELOC_ARC_N32_ME:                  howto manager.      (line 1075)
12487* BFD_RELOC_ARC_N8:                      howto manager.      (line 1054)
12488* BFD_RELOC_ARC_NONE:                    howto manager.      (line 1049)
12489* BFD_RELOC_ARC_NPS_CMEM16:              howto manager.      (line 1116)
12490* BFD_RELOC_ARC_PC32:                    howto manager.      (line 1092)
12491* BFD_RELOC_ARC_PLT32:                   howto manager.      (line 1095)
12492* BFD_RELOC_ARC_RELATIVE:                howto manager.      (line 1099)
12493* BFD_RELOC_ARC_S13_PCREL:               howto manager.      (line 1071)
12494* BFD_RELOC_ARC_S21H_PCREL:              howto manager.      (line 1060)
12495* BFD_RELOC_ARC_S21H_PCREL_PLT:          howto manager.      (line 1115)
12496* BFD_RELOC_ARC_S21W_PCREL:              howto manager.      (line 1061)
12497* BFD_RELOC_ARC_S21W_PCREL_PLT:          howto manager.      (line 1102)
12498* BFD_RELOC_ARC_S25H_PCREL:              howto manager.      (line 1062)
12499* BFD_RELOC_ARC_S25H_PCREL_PLT:          howto manager.      (line 1103)
12500* BFD_RELOC_ARC_S25W_PCREL:              howto manager.      (line 1063)
12501* BFD_RELOC_ARC_S25W_PCREL_PLT:          howto manager.      (line 1114)
12502* BFD_RELOC_ARC_SDA:                     howto manager.      (line 1058)
12503* BFD_RELOC_ARC_SDA16_LD:                howto manager.      (line 1068)
12504* BFD_RELOC_ARC_SDA16_LD1:               howto manager.      (line 1069)
12505* BFD_RELOC_ARC_SDA16_LD2:               howto manager.      (line 1070)
12506* BFD_RELOC_ARC_SDA16_ST2:               howto manager.      (line 1090)
12507* BFD_RELOC_ARC_SDA32:                   howto manager.      (line 1064)
12508* BFD_RELOC_ARC_SDA32_ME:                howto manager.      (line 1077)
12509* BFD_RELOC_ARC_SDA_12:                  howto manager.      (line 1089)
12510* BFD_RELOC_ARC_SDA_LDST:                howto manager.      (line 1065)
12511* BFD_RELOC_ARC_SDA_LDST1:               howto manager.      (line 1066)
12512* BFD_RELOC_ARC_SDA_LDST2:               howto manager.      (line 1067)
12513* BFD_RELOC_ARC_SECTOFF:                 howto manager.      (line 1059)
12514* BFD_RELOC_ARC_SECTOFF_1:               howto manager.      (line 1087)
12515* BFD_RELOC_ARC_SECTOFF_2:               howto manager.      (line 1088)
12516* BFD_RELOC_ARC_SECTOFF_ME:              howto manager.      (line 1076)
12517* BFD_RELOC_ARC_SECTOFF_ME_1:            howto manager.      (line 1085)
12518* BFD_RELOC_ARC_SECTOFF_ME_2:            howto manager.      (line 1086)
12519* BFD_RELOC_ARC_TLS_DTPMOD:              howto manager.      (line 1104)
12520* BFD_RELOC_ARC_TLS_DTPOFF:              howto manager.      (line 1110)
12521* BFD_RELOC_ARC_TLS_DTPOFF_S9:           howto manager.      (line 1111)
12522* BFD_RELOC_ARC_TLS_GD_CALL:             howto manager.      (line 1108)
12523* BFD_RELOC_ARC_TLS_GD_GOT:              howto manager.      (line 1106)
12524* BFD_RELOC_ARC_TLS_GD_LD:               howto manager.      (line 1107)
12525* BFD_RELOC_ARC_TLS_IE_GOT:              howto manager.      (line 1109)
12526* BFD_RELOC_ARC_TLS_LE_32:               howto manager.      (line 1113)
12527* BFD_RELOC_ARC_TLS_LE_S9:               howto manager.      (line 1112)
12528* BFD_RELOC_ARC_TLS_TPOFF:               howto manager.      (line 1105)
12529* BFD_RELOC_ARC_W:                       howto manager.      (line 1072)
12530* BFD_RELOC_ARC_W_ME:                    howto manager.      (line 1078)
12531* BFD_RELOC_ARM_ADRL_IMMEDIATE:          howto manager.      (line  922)
12532* BFD_RELOC_ARM_ADR_IMM:                 howto manager.      (line  937)
12533* BFD_RELOC_ARM_ALU_PC_G0:               howto manager.      (line  884)
12534* BFD_RELOC_ARM_ALU_PC_G0_NC:            howto manager.      (line  883)
12535* BFD_RELOC_ARM_ALU_PC_G1:               howto manager.      (line  886)
12536* BFD_RELOC_ARM_ALU_PC_G1_NC:            howto manager.      (line  885)
12537* BFD_RELOC_ARM_ALU_PC_G2:               howto manager.      (line  887)
12538* BFD_RELOC_ARM_ALU_SB_G0:               howto manager.      (line  898)
12539* BFD_RELOC_ARM_ALU_SB_G0_NC:            howto manager.      (line  897)
12540* BFD_RELOC_ARM_ALU_SB_G1:               howto manager.      (line  900)
12541* BFD_RELOC_ARM_ALU_SB_G1_NC:            howto manager.      (line  899)
12542* BFD_RELOC_ARM_ALU_SB_G2:               howto manager.      (line  901)
12543* BFD_RELOC_ARM_CP_OFF_IMM:              howto manager.      (line  932)
12544* BFD_RELOC_ARM_CP_OFF_IMM_S2:           howto manager.      (line  933)
12545* BFD_RELOC_ARM_FUNCDESC:                howto manager.      (line  853)
12546* BFD_RELOC_ARM_FUNCDESC_VALUE:          howto manager.      (line  854)
12547* BFD_RELOC_ARM_GLOB_DAT:                howto manager.      (line  860)
12548* BFD_RELOC_ARM_GOT32:                   howto manager.      (line  861)
12549* BFD_RELOC_ARM_GOTFUNCDESC:             howto manager.      (line  851)
12550* BFD_RELOC_ARM_GOTOFF:                  howto manager.      (line  864)
12551* BFD_RELOC_ARM_GOTOFFFUNCDESC:          howto manager.      (line  852)
12552* BFD_RELOC_ARM_GOTPC:                   howto manager.      (line  865)
12553* BFD_RELOC_ARM_GOT_PREL:                howto manager.      (line  866)
12554* BFD_RELOC_ARM_HVC:                     howto manager.      (line  929)
12555* BFD_RELOC_ARM_HWLITERAL:               howto manager.      (line  944)
12556* BFD_RELOC_ARM_IMMEDIATE:               howto manager.      (line  921)
12557* BFD_RELOC_ARM_IN_POOL:                 howto manager.      (line  940)
12558* BFD_RELOC_ARM_IRELATIVE:               howto manager.      (line  914)
12559* BFD_RELOC_ARM_JUMP_SLOT:               howto manager.      (line  859)
12560* BFD_RELOC_ARM_LDC_PC_G0:               howto manager.      (line  894)
12561* BFD_RELOC_ARM_LDC_PC_G1:               howto manager.      (line  895)
12562* BFD_RELOC_ARM_LDC_PC_G2:               howto manager.      (line  896)
12563* BFD_RELOC_ARM_LDC_SB_G0:               howto manager.      (line  908)
12564* BFD_RELOC_ARM_LDC_SB_G1:               howto manager.      (line  909)
12565* BFD_RELOC_ARM_LDC_SB_G2:               howto manager.      (line  910)
12566* BFD_RELOC_ARM_LDRS_PC_G0:              howto manager.      (line  891)
12567* BFD_RELOC_ARM_LDRS_PC_G1:              howto manager.      (line  892)
12568* BFD_RELOC_ARM_LDRS_PC_G2:              howto manager.      (line  893)
12569* BFD_RELOC_ARM_LDRS_SB_G0:              howto manager.      (line  905)
12570* BFD_RELOC_ARM_LDRS_SB_G1:              howto manager.      (line  906)
12571* BFD_RELOC_ARM_LDRS_SB_G2:              howto manager.      (line  907)
12572* BFD_RELOC_ARM_LDR_IMM:                 howto manager.      (line  938)
12573* BFD_RELOC_ARM_LDR_PC_G0:               howto manager.      (line  888)
12574* BFD_RELOC_ARM_LDR_PC_G1:               howto manager.      (line  889)
12575* BFD_RELOC_ARM_LDR_PC_G2:               howto manager.      (line  890)
12576* BFD_RELOC_ARM_LDR_SB_G0:               howto manager.      (line  902)
12577* BFD_RELOC_ARM_LDR_SB_G1:               howto manager.      (line  903)
12578* BFD_RELOC_ARM_LDR_SB_G2:               howto manager.      (line  904)
12579* BFD_RELOC_ARM_LITERAL:                 howto manager.      (line  939)
12580* BFD_RELOC_ARM_MOVT:                    howto manager.      (line  843)
12581* BFD_RELOC_ARM_MOVT_PCREL:              howto manager.      (line  845)
12582* BFD_RELOC_ARM_MOVW:                    howto manager.      (line  842)
12583* BFD_RELOC_ARM_MOVW_PCREL:              howto manager.      (line  844)
12584* BFD_RELOC_ARM_MULTI:                   howto manager.      (line  931)
12585* BFD_RELOC_ARM_OFFSET_IMM:              howto manager.      (line  823)
12586* BFD_RELOC_ARM_OFFSET_IMM8:             howto manager.      (line  941)
12587* BFD_RELOC_ARM_PCREL_BLX:               howto manager.      (line  787)
12588* BFD_RELOC_ARM_PCREL_BRANCH:            howto manager.      (line  784)
12589* BFD_RELOC_ARM_PCREL_CALL:              howto manager.      (line  795)
12590* BFD_RELOC_ARM_PCREL_JUMP:              howto manager.      (line  798)
12591* BFD_RELOC_ARM_PLT32:                   howto manager.      (line  862)
12592* BFD_RELOC_ARM_PREL31:                  howto manager.      (line  840)
12593* BFD_RELOC_ARM_RELATIVE:                howto manager.      (line  863)
12594* BFD_RELOC_ARM_ROSEGREL32:              howto manager.      (line  832)
12595* BFD_RELOC_ARM_SBREL32:                 howto manager.      (line  834)
12596* BFD_RELOC_ARM_SHIFT_IMM:               howto manager.      (line  927)
12597* BFD_RELOC_ARM_SMC:                     howto manager.      (line  928)
12598* BFD_RELOC_ARM_SWI:                     howto manager.      (line  930)
12599* BFD_RELOC_ARM_T32_ADD_IMM:             howto manager.      (line  924)
12600* BFD_RELOC_ARM_T32_ADD_PC12:            howto manager.      (line  926)
12601* BFD_RELOC_ARM_T32_CP_OFF_IMM:          howto manager.      (line  934)
12602* BFD_RELOC_ARM_T32_CP_OFF_IMM_S2:       howto manager.      (line  935)
12603* BFD_RELOC_ARM_T32_IMM12:               howto manager.      (line  925)
12604* BFD_RELOC_ARM_T32_IMMEDIATE:           howto manager.      (line  923)
12605* BFD_RELOC_ARM_T32_OFFSET_IMM:          howto manager.      (line  943)
12606* BFD_RELOC_ARM_T32_OFFSET_U8:           howto manager.      (line  942)
12607* BFD_RELOC_ARM_T32_VLDR_VSTR_OFF_IMM:   howto manager.      (line  936)
12608* BFD_RELOC_ARM_TARGET1:                 howto manager.      (line  829)
12609* BFD_RELOC_ARM_TARGET2:                 howto manager.      (line  836)
12610* BFD_RELOC_ARM_THM_TLS_CALL:            howto manager.      (line  878)
12611* BFD_RELOC_ARM_THM_TLS_DESCSEQ:         howto manager.      (line  880)
12612* BFD_RELOC_ARM_THUMB_ADD:               howto manager.      (line  945)
12613* BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC:     howto manager.      (line  916)
12614* BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC:     howto manager.      (line  917)
12615* BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC:     howto manager.      (line  918)
12616* BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC:     howto manager.      (line  919)
12617* BFD_RELOC_ARM_THUMB_BF13:              howto manager.      (line  806)
12618* BFD_RELOC_ARM_THUMB_BF17:              howto manager.      (line  804)
12619* BFD_RELOC_ARM_THUMB_BF19:              howto manager.      (line  808)
12620* BFD_RELOC_ARM_THUMB_IMM:               howto manager.      (line  946)
12621* BFD_RELOC_ARM_THUMB_LOOP12:            howto manager.      (line  810)
12622* BFD_RELOC_ARM_THUMB_MOVT:              howto manager.      (line  847)
12623* BFD_RELOC_ARM_THUMB_MOVT_PCREL:        howto manager.      (line  849)
12624* BFD_RELOC_ARM_THUMB_MOVW:              howto manager.      (line  846)
12625* BFD_RELOC_ARM_THUMB_MOVW_PCREL:        howto manager.      (line  848)
12626* BFD_RELOC_ARM_THUMB_OFFSET:            howto manager.      (line  826)
12627* BFD_RELOC_ARM_THUMB_SHIFT:             howto manager.      (line  947)
12628* BFD_RELOC_ARM_TLS_CALL:                howto manager.      (line  877)
12629* BFD_RELOC_ARM_TLS_DESC:                howto manager.      (line  881)
12630* BFD_RELOC_ARM_TLS_DESCSEQ:             howto manager.      (line  879)
12631* BFD_RELOC_ARM_TLS_DTPMOD32:            howto manager.      (line  872)
12632* BFD_RELOC_ARM_TLS_DTPOFF32:            howto manager.      (line  871)
12633* BFD_RELOC_ARM_TLS_GD32:                howto manager.      (line  868)
12634* BFD_RELOC_ARM_TLS_GD32_FDPIC:          howto manager.      (line  855)
12635* BFD_RELOC_ARM_TLS_GOTDESC:             howto manager.      (line  876)
12636* BFD_RELOC_ARM_TLS_IE32:                howto manager.      (line  874)
12637* BFD_RELOC_ARM_TLS_IE32_FDPIC:          howto manager.      (line  857)
12638* BFD_RELOC_ARM_TLS_LDM32:               howto manager.      (line  870)
12639* BFD_RELOC_ARM_TLS_LDM32_FDPIC:         howto manager.      (line  856)
12640* BFD_RELOC_ARM_TLS_LDO32:               howto manager.      (line  869)
12641* BFD_RELOC_ARM_TLS_LE32:                howto manager.      (line  875)
12642* BFD_RELOC_ARM_TLS_TPOFF32:             howto manager.      (line  873)
12643* BFD_RELOC_ARM_V4BX:                    howto manager.      (line  912)
12644* BFD_RELOC_AVR_13_PCREL:                howto manager.      (line 1754)
12645* BFD_RELOC_AVR_16_PM:                   howto manager.      (line 1757)
12646* BFD_RELOC_AVR_6:                       howto manager.      (line 1825)
12647* BFD_RELOC_AVR_6_ADIW:                  howto manager.      (line 1828)
12648* BFD_RELOC_AVR_7_PCREL:                 howto manager.      (line 1751)
12649* BFD_RELOC_AVR_8_HI:                    howto manager.      (line 1834)
12650* BFD_RELOC_AVR_8_HLO:                   howto manager.      (line 1837)
12651* BFD_RELOC_AVR_8_LO:                    howto manager.      (line 1831)
12652* BFD_RELOC_AVR_CALL:                    howto manager.      (line 1819)
12653* BFD_RELOC_AVR_DIFF16:                  howto manager.      (line 1841)
12654* BFD_RELOC_AVR_DIFF32:                  howto manager.      (line 1842)
12655* BFD_RELOC_AVR_DIFF8:                   howto manager.      (line 1840)
12656* BFD_RELOC_AVR_HH8_LDI:                 howto manager.      (line 1766)
12657* BFD_RELOC_AVR_HH8_LDI_NEG:             howto manager.      (line 1781)
12658* BFD_RELOC_AVR_HH8_LDI_PM:              howto manager.      (line 1804)
12659* BFD_RELOC_AVR_HH8_LDI_PM_NEG:          howto manager.      (line 1815)
12660* BFD_RELOC_AVR_HI8_LDI:                 howto manager.      (line 1763)
12661* BFD_RELOC_AVR_HI8_LDI_GS:              howto manager.      (line 1799)
12662* BFD_RELOC_AVR_HI8_LDI_NEG:             howto manager.      (line 1777)
12663* BFD_RELOC_AVR_HI8_LDI_PM:              howto manager.      (line 1796)
12664* BFD_RELOC_AVR_HI8_LDI_PM_NEG:          howto manager.      (line 1811)
12665* BFD_RELOC_AVR_LDI:                     howto manager.      (line 1822)
12666* BFD_RELOC_AVR_LDS_STS_16:              howto manager.      (line 1849)
12667* BFD_RELOC_AVR_LO8_LDI:                 howto manager.      (line 1760)
12668* BFD_RELOC_AVR_LO8_LDI_GS:              howto manager.      (line 1791)
12669* BFD_RELOC_AVR_LO8_LDI_NEG:             howto manager.      (line 1773)
12670* BFD_RELOC_AVR_LO8_LDI_PM:              howto manager.      (line 1788)
12671* BFD_RELOC_AVR_LO8_LDI_PM_NEG:          howto manager.      (line 1808)
12672* BFD_RELOC_AVR_MS8_LDI:                 howto manager.      (line 1770)
12673* BFD_RELOC_AVR_MS8_LDI_NEG:             howto manager.      (line 1785)
12674* BFD_RELOC_AVR_PORT5:                   howto manager.      (line 1855)
12675* BFD_RELOC_AVR_PORT6:                   howto manager.      (line 1852)
12676* BFD_RELOC_BFIN_10_PCREL:               howto manager.      (line 1129)
12677* BFD_RELOC_BFIN_11_PCREL:               howto manager.      (line 1131)
12678* BFD_RELOC_BFIN_12_PCREL_JUMP:          howto manager.      (line 1133)
12679* BFD_RELOC_BFIN_12_PCREL_JUMP_S:        howto manager.      (line 1135)
12680* BFD_RELOC_BFIN_16_HIGH:                howto manager.      (line 1121)
12681* BFD_RELOC_BFIN_16_IMM:                 howto manager.      (line 1119)
12682* BFD_RELOC_BFIN_16_LOW:                 howto manager.      (line 1127)
12683* BFD_RELOC_BFIN_24_PCREL_CALL_X:        howto manager.      (line 1137)
12684* BFD_RELOC_BFIN_24_PCREL_JUMP_L:        howto manager.      (line 1139)
12685* BFD_RELOC_BFIN_4_PCREL:                howto manager.      (line 1123)
12686* BFD_RELOC_BFIN_5_PCREL:                howto manager.      (line 1125)
12687* BFD_RELOC_BFIN_FUNCDESC:               howto manager.      (line 1144)
12688* BFD_RELOC_BFIN_FUNCDESC_GOT17M4:       howto manager.      (line 1145)
12689* BFD_RELOC_BFIN_FUNCDESC_GOTHI:         howto manager.      (line 1146)
12690* BFD_RELOC_BFIN_FUNCDESC_GOTLO:         howto manager.      (line 1147)
12691* BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4:    howto manager.      (line 1149)
12692* BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI:      howto manager.      (line 1150)
12693* BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO:      howto manager.      (line 1151)
12694* BFD_RELOC_BFIN_FUNCDESC_VALUE:         howto manager.      (line 1148)
12695* BFD_RELOC_BFIN_GOT:                    howto manager.      (line 1156)
12696* BFD_RELOC_BFIN_GOT17M4:                howto manager.      (line 1141)
12697* BFD_RELOC_BFIN_GOTHI:                  howto manager.      (line 1142)
12698* BFD_RELOC_BFIN_GOTLO:                  howto manager.      (line 1143)
12699* BFD_RELOC_BFIN_GOTOFF17M4:             howto manager.      (line 1152)
12700* BFD_RELOC_BFIN_GOTOFFHI:               howto manager.      (line 1153)
12701* BFD_RELOC_BFIN_GOTOFFLO:               howto manager.      (line 1154)
12702* BFD_RELOC_BFIN_PLTPC:                  howto manager.      (line 1158)
12703* BFD_RELOC_BPF_16:                      howto manager.      (line 3348)
12704* BFD_RELOC_BPF_32:                      howto manager.      (line 3347)
12705* BFD_RELOC_BPF_64:                      howto manager.      (line 3346)
12706* BFD_RELOC_BPF_DISP16:                  howto manager.      (line 3349)
12707* BFD_RELOC_BPF_DISP32:                  howto manager.      (line 3350)
12708* BFD_RELOC_C6000_ABS_H16:               howto manager.      (line 1596)
12709* BFD_RELOC_C6000_ABS_L16:               howto manager.      (line 1595)
12710* BFD_RELOC_C6000_ABS_S16:               howto manager.      (line 1594)
12711* BFD_RELOC_C6000_ALIGN:                 howto manager.      (line 1617)
12712* BFD_RELOC_C6000_COPY:                  howto manager.      (line 1612)
12713* BFD_RELOC_C6000_DSBT_INDEX:            howto manager.      (line 1610)
12714* BFD_RELOC_C6000_EHTYPE:                howto manager.      (line 1614)
12715* BFD_RELOC_C6000_FPHEAD:                howto manager.      (line 1618)
12716* BFD_RELOC_C6000_JUMP_SLOT:             howto manager.      (line 1613)
12717* BFD_RELOC_C6000_NOCMP:                 howto manager.      (line 1619)
12718* BFD_RELOC_C6000_PCR_H16:               howto manager.      (line 1615)
12719* BFD_RELOC_C6000_PCR_L16:               howto manager.      (line 1616)
12720* BFD_RELOC_C6000_PCR_S10:               howto manager.      (line 1592)
12721* BFD_RELOC_C6000_PCR_S12:               howto manager.      (line 1591)
12722* BFD_RELOC_C6000_PCR_S21:               howto manager.      (line 1590)
12723* BFD_RELOC_C6000_PCR_S7:                howto manager.      (line 1593)
12724* BFD_RELOC_C6000_PREL31:                howto manager.      (line 1611)
12725* BFD_RELOC_C6000_SBR_GOT_H16_W:         howto manager.      (line 1609)
12726* BFD_RELOC_C6000_SBR_GOT_L16_W:         howto manager.      (line 1608)
12727* BFD_RELOC_C6000_SBR_GOT_U15_W:         howto manager.      (line 1607)
12728* BFD_RELOC_C6000_SBR_H16_B:             howto manager.      (line 1604)
12729* BFD_RELOC_C6000_SBR_H16_H:             howto manager.      (line 1605)
12730* BFD_RELOC_C6000_SBR_H16_W:             howto manager.      (line 1606)
12731* BFD_RELOC_C6000_SBR_L16_B:             howto manager.      (line 1601)
12732* BFD_RELOC_C6000_SBR_L16_H:             howto manager.      (line 1602)
12733* BFD_RELOC_C6000_SBR_L16_W:             howto manager.      (line 1603)
12734* BFD_RELOC_C6000_SBR_S16:               howto manager.      (line 1600)
12735* BFD_RELOC_C6000_SBR_U15_B:             howto manager.      (line 1597)
12736* BFD_RELOC_C6000_SBR_U15_H:             howto manager.      (line 1598)
12737* BFD_RELOC_C6000_SBR_U15_W:             howto manager.      (line 1599)
12738* BFD_RELOC_CKCORE_ADDR32:               howto manager.      (line 3387)
12739* BFD_RELOC_CKCORE_ADDRGOT:              howto manager.      (line 3403)
12740* BFD_RELOC_CKCORE_ADDRGOT_HI16:         howto manager.      (line 3422)
12741* BFD_RELOC_CKCORE_ADDRGOT_LO16:         howto manager.      (line 3423)
12742* BFD_RELOC_CKCORE_ADDRPLT:              howto manager.      (line 3404)
12743* BFD_RELOC_CKCORE_ADDRPLT_HI16:         howto manager.      (line 3424)
12744* BFD_RELOC_CKCORE_ADDRPLT_LO16:         howto manager.      (line 3425)
12745* BFD_RELOC_CKCORE_ADDR_HI16:            howto manager.      (line 3410)
12746* BFD_RELOC_CKCORE_ADDR_LO16:            howto manager.      (line 3411)
12747* BFD_RELOC_CKCORE_CALLGRAPH:            howto manager.      (line 3447)
12748* BFD_RELOC_CKCORE_COPY:                 howto manager.      (line 3396)
12749* BFD_RELOC_CKCORE_DOFFSET_IMM18:        howto manager.      (line 3430)
12750* BFD_RELOC_CKCORE_DOFFSET_IMM18BY2:     howto manager.      (line 3431)
12751* BFD_RELOC_CKCORE_DOFFSET_IMM18BY4:     howto manager.      (line 3432)
12752* BFD_RELOC_CKCORE_DOFFSET_LO16:         howto manager.      (line 3428)
12753* BFD_RELOC_CKCORE_GLOB_DAT:             howto manager.      (line 3397)
12754* BFD_RELOC_CKCORE_GNU_VTENTRY:          howto manager.      (line 3394)
12755* BFD_RELOC_CKCORE_GNU_VTINHERIT:        howto manager.      (line 3393)
12756* BFD_RELOC_CKCORE_GOT12:                howto manager.      (line 3416)
12757* BFD_RELOC_CKCORE_GOT32:                howto manager.      (line 3401)
12758* BFD_RELOC_CKCORE_GOTOFF:               howto manager.      (line 3399)
12759* BFD_RELOC_CKCORE_GOTOFF_HI16:          howto manager.      (line 3414)
12760* BFD_RELOC_CKCORE_GOTOFF_IMM18:         howto manager.      (line 3433)
12761* BFD_RELOC_CKCORE_GOTOFF_LO16:          howto manager.      (line 3415)
12762* BFD_RELOC_CKCORE_GOTPC:                howto manager.      (line 3400)
12763* BFD_RELOC_CKCORE_GOTPC_HI16:           howto manager.      (line 3412)
12764* BFD_RELOC_CKCORE_GOTPC_LO16:           howto manager.      (line 3413)
12765* BFD_RELOC_CKCORE_GOT_HI16:             howto manager.      (line 3417)
12766* BFD_RELOC_CKCORE_GOT_IMM18BY4:         howto manager.      (line 3434)
12767* BFD_RELOC_CKCORE_GOT_LO16:             howto manager.      (line 3418)
12768* BFD_RELOC_CKCORE_IRELATIVE:            howto manager.      (line 3448)
12769* BFD_RELOC_CKCORE_JUMP_SLOT:            howto manager.      (line 3398)
12770* BFD_RELOC_CKCORE_NOJSRI:               howto manager.      (line 3446)
12771* BFD_RELOC_CKCORE_NONE:                 howto manager.      (line 3386)
12772* BFD_RELOC_CKCORE_PCREL32:              howto manager.      (line 3391)
12773* BFD_RELOC_CKCORE_PCREL_BLOOP_IMM12BY4: howto manager.      (line 3450)
12774* BFD_RELOC_CKCORE_PCREL_BLOOP_IMM4BY4:  howto manager.      (line 3449)
12775* BFD_RELOC_CKCORE_PCREL_FLRW_IMM8BY4:   howto manager.      (line 3445)
12776* BFD_RELOC_CKCORE_PCREL_IMM10BY2:       howto manager.      (line 3408)
12777* BFD_RELOC_CKCORE_PCREL_IMM10BY4:       howto manager.      (line 3409)
12778* BFD_RELOC_CKCORE_PCREL_IMM11BY2:       howto manager.      (line 3389)
12779* BFD_RELOC_CKCORE_PCREL_IMM16BY2:       howto manager.      (line 3406)
12780* BFD_RELOC_CKCORE_PCREL_IMM16BY4:       howto manager.      (line 3407)
12781* BFD_RELOC_CKCORE_PCREL_IMM18BY2:       howto manager.      (line 3429)
12782* BFD_RELOC_CKCORE_PCREL_IMM26BY2:       howto manager.      (line 3405)
12783* BFD_RELOC_CKCORE_PCREL_IMM4BY2:        howto manager.      (line 3390)
12784* BFD_RELOC_CKCORE_PCREL_IMM7BY4:        howto manager.      (line 3436)
12785* BFD_RELOC_CKCORE_PCREL_IMM8BY4:        howto manager.      (line 3388)
12786* BFD_RELOC_CKCORE_PCREL_JSR_IMM11BY2:   howto manager.      (line 3392)
12787* BFD_RELOC_CKCORE_PCREL_JSR_IMM26BY2:   howto manager.      (line 3426)
12788* BFD_RELOC_CKCORE_PLT12:                howto manager.      (line 3419)
12789* BFD_RELOC_CKCORE_PLT32:                howto manager.      (line 3402)
12790* BFD_RELOC_CKCORE_PLT_HI16:             howto manager.      (line 3420)
12791* BFD_RELOC_CKCORE_PLT_IMM18BY4:         howto manager.      (line 3435)
12792* BFD_RELOC_CKCORE_PLT_LO16:             howto manager.      (line 3421)
12793* BFD_RELOC_CKCORE_RELATIVE:             howto manager.      (line 3395)
12794* BFD_RELOC_CKCORE_TLS_DTPMOD32:         howto manager.      (line 3442)
12795* BFD_RELOC_CKCORE_TLS_DTPOFF32:         howto manager.      (line 3443)
12796* BFD_RELOC_CKCORE_TLS_GD32:             howto manager.      (line 3439)
12797* BFD_RELOC_CKCORE_TLS_IE32:             howto manager.      (line 3438)
12798* BFD_RELOC_CKCORE_TLS_LDM32:            howto manager.      (line 3440)
12799* BFD_RELOC_CKCORE_TLS_LDO32:            howto manager.      (line 3441)
12800* BFD_RELOC_CKCORE_TLS_LE32:             howto manager.      (line 3437)
12801* BFD_RELOC_CKCORE_TLS_TPOFF32:          howto manager.      (line 3444)
12802* BFD_RELOC_CKCORE_TOFFSET_LO16:         howto manager.      (line 3427)
12803* bfd_reloc_code_type:                   howto manager.      (line    9)
12804* BFD_RELOC_CR16_ABS20:                  howto manager.      (line 2296)
12805* BFD_RELOC_CR16_ABS24:                  howto manager.      (line 2297)
12806* BFD_RELOC_CR16_DISP16:                 howto manager.      (line 2307)
12807* BFD_RELOC_CR16_DISP20:                 howto manager.      (line 2308)
12808* BFD_RELOC_CR16_DISP24:                 howto manager.      (line 2309)
12809* BFD_RELOC_CR16_DISP24a:                howto manager.      (line 2310)
12810* BFD_RELOC_CR16_DISP4:                  howto manager.      (line 2305)
12811* BFD_RELOC_CR16_DISP8:                  howto manager.      (line 2306)
12812* BFD_RELOC_CR16_GLOB_DAT:               howto manager.      (line 2316)
12813* BFD_RELOC_CR16_GOTC_REGREL20:          howto manager.      (line 2315)
12814* BFD_RELOC_CR16_GOT_REGREL20:           howto manager.      (line 2314)
12815* BFD_RELOC_CR16_IMM16:                  howto manager.      (line 2300)
12816* BFD_RELOC_CR16_IMM20:                  howto manager.      (line 2301)
12817* BFD_RELOC_CR16_IMM24:                  howto manager.      (line 2302)
12818* BFD_RELOC_CR16_IMM32:                  howto manager.      (line 2303)
12819* BFD_RELOC_CR16_IMM32a:                 howto manager.      (line 2304)
12820* BFD_RELOC_CR16_IMM4:                   howto manager.      (line 2298)
12821* BFD_RELOC_CR16_IMM8:                   howto manager.      (line 2299)
12822* BFD_RELOC_CR16_NUM16:                  howto manager.      (line 2285)
12823* BFD_RELOC_CR16_NUM32:                  howto manager.      (line 2286)
12824* BFD_RELOC_CR16_NUM32a:                 howto manager.      (line 2287)
12825* BFD_RELOC_CR16_NUM8:                   howto manager.      (line 2284)
12826* BFD_RELOC_CR16_REGREL0:                howto manager.      (line 2288)
12827* BFD_RELOC_CR16_REGREL14:               howto manager.      (line 2291)
12828* BFD_RELOC_CR16_REGREL14a:              howto manager.      (line 2292)
12829* BFD_RELOC_CR16_REGREL16:               howto manager.      (line 2293)
12830* BFD_RELOC_CR16_REGREL20:               howto manager.      (line 2294)
12831* BFD_RELOC_CR16_REGREL20a:              howto manager.      (line 2295)
12832* BFD_RELOC_CR16_REGREL4:                howto manager.      (line 2289)
12833* BFD_RELOC_CR16_REGREL4a:               howto manager.      (line 2290)
12834* BFD_RELOC_CR16_SWITCH16:               howto manager.      (line 2312)
12835* BFD_RELOC_CR16_SWITCH32:               howto manager.      (line 2313)
12836* BFD_RELOC_CR16_SWITCH8:                howto manager.      (line 2311)
12837* BFD_RELOC_CRIS_16_DTPREL:              howto manager.      (line 2376)
12838* BFD_RELOC_CRIS_16_GOT:                 howto manager.      (line 2358)
12839* BFD_RELOC_CRIS_16_GOTPLT:              howto manager.      (line 2362)
12840* BFD_RELOC_CRIS_16_GOT_GD:              howto manager.      (line 2372)
12841* BFD_RELOC_CRIS_16_GOT_TPREL:           howto manager.      (line 2378)
12842* BFD_RELOC_CRIS_16_TPREL:               howto manager.      (line 2380)
12843* BFD_RELOC_CRIS_32_DTPREL:              howto manager.      (line 2375)
12844* BFD_RELOC_CRIS_32_GD:                  howto manager.      (line 2373)
12845* BFD_RELOC_CRIS_32_GOT:                 howto manager.      (line 2356)
12846* BFD_RELOC_CRIS_32_GOTPLT:              howto manager.      (line 2360)
12847* BFD_RELOC_CRIS_32_GOTREL:              howto manager.      (line 2364)
12848* BFD_RELOC_CRIS_32_GOT_GD:              howto manager.      (line 2371)
12849* BFD_RELOC_CRIS_32_GOT_TPREL:           howto manager.      (line 2377)
12850* BFD_RELOC_CRIS_32_IE:                  howto manager.      (line 2382)
12851* BFD_RELOC_CRIS_32_PLT_GOTREL:          howto manager.      (line 2366)
12852* BFD_RELOC_CRIS_32_PLT_PCREL:           howto manager.      (line 2368)
12853* BFD_RELOC_CRIS_32_TPREL:               howto manager.      (line 2379)
12854* BFD_RELOC_CRIS_BDISP8:                 howto manager.      (line 2339)
12855* BFD_RELOC_CRIS_COPY:                   howto manager.      (line 2351)
12856* BFD_RELOC_CRIS_DTP:                    howto manager.      (line 2374)
12857* BFD_RELOC_CRIS_DTPMOD:                 howto manager.      (line 2381)
12858* BFD_RELOC_CRIS_GLOB_DAT:               howto manager.      (line 2352)
12859* BFD_RELOC_CRIS_JUMP_SLOT:              howto manager.      (line 2353)
12860* BFD_RELOC_CRIS_LAPCQ_OFFSET:           howto manager.      (line 2347)
12861* BFD_RELOC_CRIS_RELATIVE:               howto manager.      (line 2354)
12862* BFD_RELOC_CRIS_SIGNED_16:              howto manager.      (line 2345)
12863* BFD_RELOC_CRIS_SIGNED_6:               howto manager.      (line 2341)
12864* BFD_RELOC_CRIS_SIGNED_8:               howto manager.      (line 2343)
12865* BFD_RELOC_CRIS_UNSIGNED_16:            howto manager.      (line 2346)
12866* BFD_RELOC_CRIS_UNSIGNED_4:             howto manager.      (line 2348)
12867* BFD_RELOC_CRIS_UNSIGNED_5:             howto manager.      (line 2340)
12868* BFD_RELOC_CRIS_UNSIGNED_6:             howto manager.      (line 2342)
12869* BFD_RELOC_CRIS_UNSIGNED_8:             howto manager.      (line 2344)
12870* BFD_RELOC_CRX_ABS16:                   howto manager.      (line 2328)
12871* BFD_RELOC_CRX_ABS32:                   howto manager.      (line 2329)
12872* BFD_RELOC_CRX_IMM16:                   howto manager.      (line 2333)
12873* BFD_RELOC_CRX_IMM32:                   howto manager.      (line 2334)
12874* BFD_RELOC_CRX_NUM16:                   howto manager.      (line 2331)
12875* BFD_RELOC_CRX_NUM32:                   howto manager.      (line 2332)
12876* BFD_RELOC_CRX_NUM8:                    howto manager.      (line 2330)
12877* BFD_RELOC_CRX_REGREL12:                howto manager.      (line 2324)
12878* BFD_RELOC_CRX_REGREL22:                howto manager.      (line 2325)
12879* BFD_RELOC_CRX_REGREL28:                howto manager.      (line 2326)
12880* BFD_RELOC_CRX_REGREL32:                howto manager.      (line 2327)
12881* BFD_RELOC_CRX_REL16:                   howto manager.      (line 2321)
12882* BFD_RELOC_CRX_REL24:                   howto manager.      (line 2322)
12883* BFD_RELOC_CRX_REL32:                   howto manager.      (line 2323)
12884* BFD_RELOC_CRX_REL4:                    howto manager.      (line 2318)
12885* BFD_RELOC_CRX_REL8:                    howto manager.      (line 2319)
12886* BFD_RELOC_CRX_REL8_CMP:                howto manager.      (line 2320)
12887* BFD_RELOC_CRX_SWITCH16:                howto manager.      (line 2336)
12888* BFD_RELOC_CRX_SWITCH32:                howto manager.      (line 2337)
12889* BFD_RELOC_CRX_SWITCH8:                 howto manager.      (line 2335)
12890* BFD_RELOC_CTOR:                        howto manager.      (line  779)
12891* BFD_RELOC_D10V_10_PCREL_L:             howto manager.      (line 1203)
12892* BFD_RELOC_D10V_10_PCREL_R:             howto manager.      (line 1200)
12893* BFD_RELOC_D10V_18:                     howto manager.      (line 1207)
12894* BFD_RELOC_D10V_18_PCREL:               howto manager.      (line 1209)
12895* BFD_RELOC_D30V_15:                     howto manager.      (line 1220)
12896* BFD_RELOC_D30V_15_PCREL:               howto manager.      (line 1223)
12897* BFD_RELOC_D30V_15_PCREL_R:             howto manager.      (line 1226)
12898* BFD_RELOC_D30V_21:                     howto manager.      (line 1230)
12899* BFD_RELOC_D30V_21_PCREL:               howto manager.      (line 1233)
12900* BFD_RELOC_D30V_21_PCREL_R:             howto manager.      (line 1236)
12901* BFD_RELOC_D30V_32:                     howto manager.      (line 1240)
12902* BFD_RELOC_D30V_32_PCREL:               howto manager.      (line 1242)
12903* BFD_RELOC_D30V_6:                      howto manager.      (line 1211)
12904* BFD_RELOC_D30V_9_PCREL:                howto manager.      (line 1213)
12905* BFD_RELOC_D30V_9_PCREL_R:              howto manager.      (line 1216)
12906* BFD_RELOC_DLX_HI16_S:                  howto manager.      (line 1244)
12907* BFD_RELOC_DLX_JMP26:                   howto manager.      (line 1248)
12908* BFD_RELOC_DLX_LO16:                    howto manager.      (line 1246)
12909* BFD_RELOC_EPIPHANY_HIGH:               howto manager.      (line 3356)
12910* BFD_RELOC_EPIPHANY_IMM11:              howto manager.      (line 3362)
12911* BFD_RELOC_EPIPHANY_IMM8:               howto manager.      (line 3365)
12912* BFD_RELOC_EPIPHANY_LOW:                howto manager.      (line 3358)
12913* BFD_RELOC_EPIPHANY_SIMM11:             howto manager.      (line 3360)
12914* BFD_RELOC_EPIPHANY_SIMM24:             howto manager.      (line 3354)
12915* BFD_RELOC_EPIPHANY_SIMM8:              howto manager.      (line 3352)
12916* BFD_RELOC_FR30_10_IN_8:                howto manager.      (line 1635)
12917* BFD_RELOC_FR30_12_PCREL:               howto manager.      (line 1641)
12918* BFD_RELOC_FR30_20:                     howto manager.      (line 1623)
12919* BFD_RELOC_FR30_48:                     howto manager.      (line 1621)
12920* BFD_RELOC_FR30_6_IN_4:                 howto manager.      (line 1626)
12921* BFD_RELOC_FR30_8_IN_8:                 howto manager.      (line 1629)
12922* BFD_RELOC_FR30_9_IN_8:                 howto manager.      (line 1632)
12923* BFD_RELOC_FR30_9_PCREL:                howto manager.      (line 1638)
12924* BFD_RELOC_FRV_FUNCDESC:                howto manager.      (line  457)
12925* BFD_RELOC_FRV_FUNCDESC_GOT12:          howto manager.      (line  458)
12926* BFD_RELOC_FRV_FUNCDESC_GOTHI:          howto manager.      (line  459)
12927* BFD_RELOC_FRV_FUNCDESC_GOTLO:          howto manager.      (line  460)
12928* BFD_RELOC_FRV_FUNCDESC_GOTOFF12:       howto manager.      (line  462)
12929* BFD_RELOC_FRV_FUNCDESC_GOTOFFHI:       howto manager.      (line  463)
12930* BFD_RELOC_FRV_FUNCDESC_GOTOFFLO:       howto manager.      (line  464)
12931* BFD_RELOC_FRV_FUNCDESC_VALUE:          howto manager.      (line  461)
12932* BFD_RELOC_FRV_GETTLSOFF:               howto manager.      (line  468)
12933* BFD_RELOC_FRV_GETTLSOFF_RELAX:         howto manager.      (line  481)
12934* BFD_RELOC_FRV_GOT12:                   howto manager.      (line  454)
12935* BFD_RELOC_FRV_GOTHI:                   howto manager.      (line  455)
12936* BFD_RELOC_FRV_GOTLO:                   howto manager.      (line  456)
12937* BFD_RELOC_FRV_GOTOFF12:                howto manager.      (line  465)
12938* BFD_RELOC_FRV_GOTOFFHI:                howto manager.      (line  466)
12939* BFD_RELOC_FRV_GOTOFFLO:                howto manager.      (line  467)
12940* BFD_RELOC_FRV_GOTTLSDESC12:            howto manager.      (line  470)
12941* BFD_RELOC_FRV_GOTTLSDESCHI:            howto manager.      (line  471)
12942* BFD_RELOC_FRV_GOTTLSDESCLO:            howto manager.      (line  472)
12943* BFD_RELOC_FRV_GOTTLSOFF12:             howto manager.      (line  476)
12944* BFD_RELOC_FRV_GOTTLSOFFHI:             howto manager.      (line  477)
12945* BFD_RELOC_FRV_GOTTLSOFFLO:             howto manager.      (line  478)
12946* BFD_RELOC_FRV_GPREL12:                 howto manager.      (line  449)
12947* BFD_RELOC_FRV_GPREL32:                 howto manager.      (line  451)
12948* BFD_RELOC_FRV_GPRELHI:                 howto manager.      (line  452)
12949* BFD_RELOC_FRV_GPRELLO:                 howto manager.      (line  453)
12950* BFD_RELOC_FRV_GPRELU12:                howto manager.      (line  450)
12951* BFD_RELOC_FRV_HI16:                    howto manager.      (line  448)
12952* BFD_RELOC_FRV_LABEL16:                 howto manager.      (line  445)
12953* BFD_RELOC_FRV_LABEL24:                 howto manager.      (line  446)
12954* BFD_RELOC_FRV_LO16:                    howto manager.      (line  447)
12955* BFD_RELOC_FRV_TLSDESC_RELAX:           howto manager.      (line  480)
12956* BFD_RELOC_FRV_TLSDESC_VALUE:           howto manager.      (line  469)
12957* BFD_RELOC_FRV_TLSMOFF:                 howto manager.      (line  483)
12958* BFD_RELOC_FRV_TLSMOFF12:               howto manager.      (line  473)
12959* BFD_RELOC_FRV_TLSMOFFHI:               howto manager.      (line  474)
12960* BFD_RELOC_FRV_TLSMOFFLO:               howto manager.      (line  475)
12961* BFD_RELOC_FRV_TLSOFF:                  howto manager.      (line  479)
12962* BFD_RELOC_FRV_TLSOFF_RELAX:            howto manager.      (line  482)
12963* BFD_RELOC_FT32_10:                     howto manager.      (line  435)
12964* BFD_RELOC_FT32_15:                     howto manager.      (line  442)
12965* BFD_RELOC_FT32_17:                     howto manager.      (line  437)
12966* BFD_RELOC_FT32_18:                     howto manager.      (line  438)
12967* BFD_RELOC_FT32_20:                     howto manager.      (line  436)
12968* BFD_RELOC_FT32_DIFF32:                 howto manager.      (line  443)
12969* BFD_RELOC_FT32_RELAX:                  howto manager.      (line  439)
12970* BFD_RELOC_FT32_SC0:                    howto manager.      (line  440)
12971* BFD_RELOC_FT32_SC1:                    howto manager.      (line  441)
12972* BFD_RELOC_GPREL16:                     howto manager.      (line  118)
12973* BFD_RELOC_GPREL32:                     howto manager.      (line  119)
12974* BFD_RELOC_H8_DIR16A8:                  howto manager.      (line 2425)
12975* BFD_RELOC_H8_DIR16R8:                  howto manager.      (line 2426)
12976* BFD_RELOC_H8_DIR24A8:                  howto manager.      (line 2427)
12977* BFD_RELOC_H8_DIR24R8:                  howto manager.      (line 2428)
12978* BFD_RELOC_H8_DIR32A16:                 howto manager.      (line 2429)
12979* BFD_RELOC_H8_DISP32A16:                howto manager.      (line 2430)
12980* BFD_RELOC_HI16:                        howto manager.      (line  318)
12981* BFD_RELOC_HI16_BASEREL:                howto manager.      (line   98)
12982* BFD_RELOC_HI16_GOTOFF:                 howto manager.      (line   52)
12983* BFD_RELOC_HI16_PCREL:                  howto manager.      (line  327)
12984* BFD_RELOC_HI16_PLTOFF:                 howto manager.      (line   64)
12985* BFD_RELOC_HI16_S:                      howto manager.      (line  320)
12986* BFD_RELOC_HI16_S_BASEREL:              howto manager.      (line   99)
12987* BFD_RELOC_HI16_S_GOTOFF:               howto manager.      (line   53)
12988* BFD_RELOC_HI16_S_PCREL:                howto manager.      (line  329)
12989* BFD_RELOC_HI16_S_PLTOFF:               howto manager.      (line   65)
12990* BFD_RELOC_HI22:                        howto manager.      (line  114)
12991* BFD_RELOC_I370_D12:                    howto manager.      (line  777)
12992* BFD_RELOC_IA64_COPY:                   howto manager.      (line 2182)
12993* BFD_RELOC_IA64_DIR32LSB:               howto manager.      (line 2127)
12994* BFD_RELOC_IA64_DIR32MSB:               howto manager.      (line 2126)
12995* BFD_RELOC_IA64_DIR64LSB:               howto manager.      (line 2129)
12996* BFD_RELOC_IA64_DIR64MSB:               howto manager.      (line 2128)
12997* BFD_RELOC_IA64_DTPMOD64LSB:            howto manager.      (line 2192)
12998* BFD_RELOC_IA64_DTPMOD64MSB:            howto manager.      (line 2191)
12999* BFD_RELOC_IA64_DTPREL14:               howto manager.      (line 2194)
13000* BFD_RELOC_IA64_DTPREL22:               howto manager.      (line 2195)
13001* BFD_RELOC_IA64_DTPREL32LSB:            howto manager.      (line 2198)
13002* BFD_RELOC_IA64_DTPREL32MSB:            howto manager.      (line 2197)
13003* BFD_RELOC_IA64_DTPREL64I:              howto manager.      (line 2196)
13004* BFD_RELOC_IA64_DTPREL64LSB:            howto manager.      (line 2200)
13005* BFD_RELOC_IA64_DTPREL64MSB:            howto manager.      (line 2199)
13006* BFD_RELOC_IA64_FPTR32LSB:              howto manager.      (line 2144)
13007* BFD_RELOC_IA64_FPTR32MSB:              howto manager.      (line 2143)
13008* BFD_RELOC_IA64_FPTR64I:                howto manager.      (line 2142)
13009* BFD_RELOC_IA64_FPTR64LSB:              howto manager.      (line 2146)
13010* BFD_RELOC_IA64_FPTR64MSB:              howto manager.      (line 2145)
13011* BFD_RELOC_IA64_GPREL22:                howto manager.      (line 2130)
13012* BFD_RELOC_IA64_GPREL32LSB:             howto manager.      (line 2133)
13013* BFD_RELOC_IA64_GPREL32MSB:             howto manager.      (line 2132)
13014* BFD_RELOC_IA64_GPREL64I:               howto manager.      (line 2131)
13015* BFD_RELOC_IA64_GPREL64LSB:             howto manager.      (line 2135)
13016* BFD_RELOC_IA64_GPREL64MSB:             howto manager.      (line 2134)
13017* BFD_RELOC_IA64_IMM14:                  howto manager.      (line 2123)
13018* BFD_RELOC_IA64_IMM22:                  howto manager.      (line 2124)
13019* BFD_RELOC_IA64_IMM64:                  howto manager.      (line 2125)
13020* BFD_RELOC_IA64_IPLTLSB:                howto manager.      (line 2181)
13021* BFD_RELOC_IA64_IPLTMSB:                howto manager.      (line 2180)
13022* BFD_RELOC_IA64_LDXMOV:                 howto manager.      (line 2184)
13023* BFD_RELOC_IA64_LTOFF22:                howto manager.      (line 2136)
13024* BFD_RELOC_IA64_LTOFF22X:               howto manager.      (line 2183)
13025* BFD_RELOC_IA64_LTOFF64I:               howto manager.      (line 2137)
13026* BFD_RELOC_IA64_LTOFF_DTPMOD22:         howto manager.      (line 2193)
13027* BFD_RELOC_IA64_LTOFF_DTPREL22:         howto manager.      (line 2201)
13028* BFD_RELOC_IA64_LTOFF_FPTR22:           howto manager.      (line 2158)
13029* BFD_RELOC_IA64_LTOFF_FPTR32LSB:        howto manager.      (line 2161)
13030* BFD_RELOC_IA64_LTOFF_FPTR32MSB:        howto manager.      (line 2160)
13031* BFD_RELOC_IA64_LTOFF_FPTR64I:          howto manager.      (line 2159)
13032* BFD_RELOC_IA64_LTOFF_FPTR64LSB:        howto manager.      (line 2163)
13033* BFD_RELOC_IA64_LTOFF_FPTR64MSB:        howto manager.      (line 2162)
13034* BFD_RELOC_IA64_LTOFF_TPREL22:          howto manager.      (line 2190)
13035* BFD_RELOC_IA64_LTV32LSB:               howto manager.      (line 2177)
13036* BFD_RELOC_IA64_LTV32MSB:               howto manager.      (line 2176)
13037* BFD_RELOC_IA64_LTV64LSB:               howto manager.      (line 2179)
13038* BFD_RELOC_IA64_LTV64MSB:               howto manager.      (line 2178)
13039* BFD_RELOC_IA64_PCREL21B:               howto manager.      (line 2147)
13040* BFD_RELOC_IA64_PCREL21BI:              howto manager.      (line 2148)
13041* BFD_RELOC_IA64_PCREL21F:               howto manager.      (line 2150)
13042* BFD_RELOC_IA64_PCREL21M:               howto manager.      (line 2149)
13043* BFD_RELOC_IA64_PCREL22:                howto manager.      (line 2151)
13044* BFD_RELOC_IA64_PCREL32LSB:             howto manager.      (line 2155)
13045* BFD_RELOC_IA64_PCREL32MSB:             howto manager.      (line 2154)
13046* BFD_RELOC_IA64_PCREL60B:               howto manager.      (line 2152)
13047* BFD_RELOC_IA64_PCREL64I:               howto manager.      (line 2153)
13048* BFD_RELOC_IA64_PCREL64LSB:             howto manager.      (line 2157)
13049* BFD_RELOC_IA64_PCREL64MSB:             howto manager.      (line 2156)
13050* BFD_RELOC_IA64_PLTOFF22:               howto manager.      (line 2138)
13051* BFD_RELOC_IA64_PLTOFF64I:              howto manager.      (line 2139)
13052* BFD_RELOC_IA64_PLTOFF64LSB:            howto manager.      (line 2141)
13053* BFD_RELOC_IA64_PLTOFF64MSB:            howto manager.      (line 2140)
13054* BFD_RELOC_IA64_REL32LSB:               howto manager.      (line 2173)
13055* BFD_RELOC_IA64_REL32MSB:               howto manager.      (line 2172)
13056* BFD_RELOC_IA64_REL64LSB:               howto manager.      (line 2175)
13057* BFD_RELOC_IA64_REL64MSB:               howto manager.      (line 2174)
13058* BFD_RELOC_IA64_SECREL32LSB:            howto manager.      (line 2169)
13059* BFD_RELOC_IA64_SECREL32MSB:            howto manager.      (line 2168)
13060* BFD_RELOC_IA64_SECREL64LSB:            howto manager.      (line 2171)
13061* BFD_RELOC_IA64_SECREL64MSB:            howto manager.      (line 2170)
13062* BFD_RELOC_IA64_SEGREL32LSB:            howto manager.      (line 2165)
13063* BFD_RELOC_IA64_SEGREL32MSB:            howto manager.      (line 2164)
13064* BFD_RELOC_IA64_SEGREL64LSB:            howto manager.      (line 2167)
13065* BFD_RELOC_IA64_SEGREL64MSB:            howto manager.      (line 2166)
13066* BFD_RELOC_IA64_TPREL14:                howto manager.      (line 2185)
13067* BFD_RELOC_IA64_TPREL22:                howto manager.      (line 2186)
13068* BFD_RELOC_IA64_TPREL64I:               howto manager.      (line 2187)
13069* BFD_RELOC_IA64_TPREL64LSB:             howto manager.      (line 2189)
13070* BFD_RELOC_IA64_TPREL64MSB:             howto manager.      (line 2188)
13071* BFD_RELOC_IP2K_ADDR16CJP:              howto manager.      (line 2084)
13072* BFD_RELOC_IP2K_BANK:                   howto manager.      (line 2082)
13073* BFD_RELOC_IP2K_EX8DATA:                howto manager.      (line 2090)
13074* BFD_RELOC_IP2K_FR9:                    howto manager.      (line 2080)
13075* BFD_RELOC_IP2K_FR_OFFSET:              howto manager.      (line 2099)
13076* BFD_RELOC_IP2K_HI8DATA:                howto manager.      (line 2089)
13077* BFD_RELOC_IP2K_HI8INSN:                howto manager.      (line 2093)
13078* BFD_RELOC_IP2K_LO8DATA:                howto manager.      (line 2088)
13079* BFD_RELOC_IP2K_LO8INSN:                howto manager.      (line 2092)
13080* BFD_RELOC_IP2K_PAGE3:                  howto manager.      (line 2086)
13081* BFD_RELOC_IP2K_PC_SKIP:                howto manager.      (line 2095)
13082* BFD_RELOC_IP2K_TEXT:                   howto manager.      (line 2097)
13083* BFD_RELOC_IQ2000_OFFSET_16:            howto manager.      (line 2561)
13084* BFD_RELOC_IQ2000_OFFSET_21:            howto manager.      (line 2562)
13085* BFD_RELOC_IQ2000_UHI16:                howto manager.      (line 2563)
13086* BFD_RELOC_LARCH_ADD16:                 howto manager.      (line 3488)
13087* BFD_RELOC_LARCH_ADD24:                 howto manager.      (line 3489)
13088* BFD_RELOC_LARCH_ADD32:                 howto manager.      (line 3490)
13089* BFD_RELOC_LARCH_ADD64:                 howto manager.      (line 3491)
13090* BFD_RELOC_LARCH_ADD8:                  howto manager.      (line 3487)
13091* BFD_RELOC_LARCH_MARK_LA:               howto manager.      (line 3460)
13092* BFD_RELOC_LARCH_MARK_PCREL:            howto manager.      (line 3461)
13093* BFD_RELOC_LARCH_SOP_ADD:               howto manager.      (line 3475)
13094* BFD_RELOC_LARCH_SOP_AND:               howto manager.      (line 3476)
13095* BFD_RELOC_LARCH_SOP_ASSERT:            howto manager.      (line 3470)
13096* BFD_RELOC_LARCH_SOP_IF_ELSE:           howto manager.      (line 3477)
13097* BFD_RELOC_LARCH_SOP_NOT:               howto manager.      (line 3471)
13098* BFD_RELOC_LARCH_SOP_POP_32_S_0_10_10_16_S2: howto manager. (line 3485)
13099* BFD_RELOC_LARCH_SOP_POP_32_S_0_5_10_16_S2: howto manager.  (line 3484)
13100* BFD_RELOC_LARCH_SOP_POP_32_S_10_12:    howto manager.      (line 3480)
13101* BFD_RELOC_LARCH_SOP_POP_32_S_10_16:    howto manager.      (line 3481)
13102* BFD_RELOC_LARCH_SOP_POP_32_S_10_16_S2: howto manager.      (line 3482)
13103* BFD_RELOC_LARCH_SOP_POP_32_S_10_5:     howto manager.      (line 3478)
13104* BFD_RELOC_LARCH_SOP_POP_32_S_5_20:     howto manager.      (line 3483)
13105* BFD_RELOC_LARCH_SOP_POP_32_U:          howto manager.      (line 3486)
13106* BFD_RELOC_LARCH_SOP_POP_32_U_10_12:    howto manager.      (line 3479)
13107* BFD_RELOC_LARCH_SOP_PUSH_ABSOLUTE:     howto manager.      (line 3463)
13108* BFD_RELOC_LARCH_SOP_PUSH_DUP:          howto manager.      (line 3464)
13109* BFD_RELOC_LARCH_SOP_PUSH_GPREL:        howto manager.      (line 3465)
13110* BFD_RELOC_LARCH_SOP_PUSH_PCREL:        howto manager.      (line 3462)
13111* BFD_RELOC_LARCH_SOP_PUSH_PLT_PCREL:    howto manager.      (line 3469)
13112* BFD_RELOC_LARCH_SOP_PUSH_TLS_GD:       howto manager.      (line 3468)
13113* BFD_RELOC_LARCH_SOP_PUSH_TLS_GOT:      howto manager.      (line 3467)
13114* BFD_RELOC_LARCH_SOP_PUSH_TLS_TPREL:    howto manager.      (line 3466)
13115* BFD_RELOC_LARCH_SOP_SL:                howto manager.      (line 3473)
13116* BFD_RELOC_LARCH_SOP_SR:                howto manager.      (line 3474)
13117* BFD_RELOC_LARCH_SOP_SUB:               howto manager.      (line 3472)
13118* BFD_RELOC_LARCH_SUB16:                 howto manager.      (line 3493)
13119* BFD_RELOC_LARCH_SUB24:                 howto manager.      (line 3494)
13120* BFD_RELOC_LARCH_SUB32:                 howto manager.      (line 3495)
13121* BFD_RELOC_LARCH_SUB64:                 howto manager.      (line 3496)
13122* BFD_RELOC_LARCH_SUB8:                  howto manager.      (line 3492)
13123* BFD_RELOC_LARCH_TLS_DTPMOD32:          howto manager.      (line 3454)
13124* BFD_RELOC_LARCH_TLS_DTPMOD64:          howto manager.      (line 3456)
13125* BFD_RELOC_LARCH_TLS_DTPREL32:          howto manager.      (line 3455)
13126* BFD_RELOC_LARCH_TLS_DTPREL64:          howto manager.      (line 3457)
13127* BFD_RELOC_LARCH_TLS_TPREL32:           howto manager.      (line 3458)
13128* BFD_RELOC_LARCH_TLS_TPREL64:           howto manager.      (line 3459)
13129* BFD_RELOC_LM32_16_GOT:                 howto manager.      (line 2684)
13130* BFD_RELOC_LM32_BRANCH:                 howto manager.      (line 2683)
13131* BFD_RELOC_LM32_CALL:                   howto manager.      (line 2682)
13132* BFD_RELOC_LM32_COPY:                   howto manager.      (line 2687)
13133* BFD_RELOC_LM32_GLOB_DAT:               howto manager.      (line 2688)
13134* BFD_RELOC_LM32_GOTOFF_HI16:            howto manager.      (line 2685)
13135* BFD_RELOC_LM32_GOTOFF_LO16:            howto manager.      (line 2686)
13136* BFD_RELOC_LM32_JMP_SLOT:               howto manager.      (line 2689)
13137* BFD_RELOC_LM32_RELATIVE:               howto manager.      (line 2690)
13138* BFD_RELOC_LO10:                        howto manager.      (line  115)
13139* BFD_RELOC_LO16:                        howto manager.      (line  325)
13140* BFD_RELOC_LO16_BASEREL:                howto manager.      (line   97)
13141* BFD_RELOC_LO16_GOTOFF:                 howto manager.      (line   51)
13142* BFD_RELOC_LO16_PCREL:                  howto manager.      (line  331)
13143* BFD_RELOC_LO16_PLTOFF:                 howto manager.      (line   63)
13144* BFD_RELOC_M32C_HI8:                    howto manager.      (line 1250)
13145* BFD_RELOC_M32C_RL_1ADDR:               howto manager.      (line 1252)
13146* BFD_RELOC_M32C_RL_2ADDR:               howto manager.      (line 1253)
13147* BFD_RELOC_M32C_RL_JUMP:                howto manager.      (line 1251)
13148* BFD_RELOC_M32R_10_PCREL:               howto manager.      (line 1258)
13149* BFD_RELOC_M32R_18_PCREL:               howto manager.      (line 1261)
13150* BFD_RELOC_M32R_24:                     howto manager.      (line 1255)
13151* BFD_RELOC_M32R_26_PCREL:               howto manager.      (line 1263)
13152* BFD_RELOC_M32R_26_PLTREL:              howto manager.      (line 1277)
13153* BFD_RELOC_M32R_COPY:                   howto manager.      (line 1278)
13154* BFD_RELOC_M32R_GLOB_DAT:               howto manager.      (line 1279)
13155* BFD_RELOC_M32R_GOT16_HI_SLO:           howto manager.      (line 1288)
13156* BFD_RELOC_M32R_GOT16_HI_ULO:           howto manager.      (line 1287)
13157* BFD_RELOC_M32R_GOT16_LO:               howto manager.      (line 1289)
13158* BFD_RELOC_M32R_GOT24:                  howto manager.      (line 1276)
13159* BFD_RELOC_M32R_GOTOFF:                 howto manager.      (line 1282)
13160* BFD_RELOC_M32R_GOTOFF_HI_SLO:          howto manager.      (line 1284)
13161* BFD_RELOC_M32R_GOTOFF_HI_ULO:          howto manager.      (line 1283)
13162* BFD_RELOC_M32R_GOTOFF_LO:              howto manager.      (line 1285)
13163* BFD_RELOC_M32R_GOTPC24:                howto manager.      (line 1286)
13164* BFD_RELOC_M32R_GOTPC_HI_SLO:           howto manager.      (line 1291)
13165* BFD_RELOC_M32R_GOTPC_HI_ULO:           howto manager.      (line 1290)
13166* BFD_RELOC_M32R_GOTPC_LO:               howto manager.      (line 1292)
13167* BFD_RELOC_M32R_HI16_SLO:               howto manager.      (line 1268)
13168* BFD_RELOC_M32R_HI16_ULO:               howto manager.      (line 1265)
13169* BFD_RELOC_M32R_JMP_SLOT:               howto manager.      (line 1280)
13170* BFD_RELOC_M32R_LO16:                   howto manager.      (line 1271)
13171* BFD_RELOC_M32R_RELATIVE:               howto manager.      (line 1281)
13172* BFD_RELOC_M32R_SDA16:                  howto manager.      (line 1273)
13173* BFD_RELOC_M68HC11_24:                  howto manager.      (line 2229)
13174* BFD_RELOC_M68HC11_3B:                  howto manager.      (line 2209)
13175* BFD_RELOC_M68HC11_HI8:                 howto manager.      (line 2203)
13176* BFD_RELOC_M68HC11_LO16:                howto manager.      (line 2220)
13177* BFD_RELOC_M68HC11_LO8:                 howto manager.      (line 2206)
13178* BFD_RELOC_M68HC11_PAGE:                howto manager.      (line 2225)
13179* BFD_RELOC_M68HC11_RL_GROUP:            howto manager.      (line 2216)
13180* BFD_RELOC_M68HC11_RL_JUMP:             howto manager.      (line 2211)
13181* BFD_RELOC_M68HC12_10_PCREL:            howto manager.      (line 2272)
13182* BFD_RELOC_M68HC12_16B:                 howto manager.      (line 2268)
13183* BFD_RELOC_M68HC12_5B:                  howto manager.      (line 2234)
13184* BFD_RELOC_M68HC12_9B:                  howto manager.      (line 2266)
13185* BFD_RELOC_M68HC12_9_PCREL:             howto manager.      (line 2270)
13186* BFD_RELOC_M68HC12_HI8XG:               howto manager.      (line 2277)
13187* BFD_RELOC_M68HC12_LO8XG:               howto manager.      (line 2274)
13188* BFD_RELOC_MACH_O_ARM64_ADDEND:         howto manager.      (line 2720)
13189* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21: howto manager.     (line 2722)
13190* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12: howto manager.  (line 2724)
13191* BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT: howto manager.      (line 2726)
13192* BFD_RELOC_MACH_O_LOCAL_SECTDIFF:       howto manager.      (line 2695)
13193* BFD_RELOC_MACH_O_PAIR:                 howto manager.      (line 2697)
13194* BFD_RELOC_MACH_O_SECTDIFF:             howto manager.      (line 2692)
13195* BFD_RELOC_MACH_O_SUBTRACTOR32:         howto manager.      (line 2699)
13196* BFD_RELOC_MACH_O_SUBTRACTOR64:         howto manager.      (line 2701)
13197* BFD_RELOC_MACH_O_X86_64_BRANCH32:      howto manager.      (line 2703)
13198* BFD_RELOC_MACH_O_X86_64_BRANCH8:       howto manager.      (line 2704)
13199* BFD_RELOC_MACH_O_X86_64_GOT:           howto manager.      (line 2707)
13200* BFD_RELOC_MACH_O_X86_64_GOT_LOAD:      howto manager.      (line 2709)
13201* BFD_RELOC_MACH_O_X86_64_PCREL32_1:     howto manager.      (line 2712)
13202* BFD_RELOC_MACH_O_X86_64_PCREL32_2:     howto manager.      (line 2714)
13203* BFD_RELOC_MACH_O_X86_64_PCREL32_4:     howto manager.      (line 2716)
13204* BFD_RELOC_MACH_O_X86_64_TLV:           howto manager.      (line 2718)
13205* BFD_RELOC_MCORE_PCREL_32:              howto manager.      (line 1647)
13206* BFD_RELOC_MCORE_PCREL_IMM11BY2:        howto manager.      (line 1645)
13207* BFD_RELOC_MCORE_PCREL_IMM4BY2:         howto manager.      (line 1646)
13208* BFD_RELOC_MCORE_PCREL_IMM8BY4:         howto manager.      (line 1644)
13209* BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2:    howto manager.      (line 1648)
13210* BFD_RELOC_MCORE_RVA:                   howto manager.      (line 1649)
13211* BFD_RELOC_MEP_16:                      howto manager.      (line 1652)
13212* BFD_RELOC_MEP_32:                      howto manager.      (line 1653)
13213* BFD_RELOC_MEP_8:                       howto manager.      (line 1651)
13214* BFD_RELOC_MEP_ADDR24A4:                howto manager.      (line 1668)
13215* BFD_RELOC_MEP_GNU_VTENTRY:             howto manager.      (line 1670)
13216* BFD_RELOC_MEP_GNU_VTINHERIT:           howto manager.      (line 1669)
13217* BFD_RELOC_MEP_GPREL:                   howto manager.      (line 1662)
13218* BFD_RELOC_MEP_HI16S:                   howto manager.      (line 1661)
13219* BFD_RELOC_MEP_HI16U:                   howto manager.      (line 1660)
13220* BFD_RELOC_MEP_LOW16:                   howto manager.      (line 1659)
13221* BFD_RELOC_MEP_PCABS24A2:               howto manager.      (line 1658)
13222* BFD_RELOC_MEP_PCREL12A2:               howto manager.      (line 1655)
13223* BFD_RELOC_MEP_PCREL17A2:               howto manager.      (line 1656)
13224* BFD_RELOC_MEP_PCREL24A2:               howto manager.      (line 1657)
13225* BFD_RELOC_MEP_PCREL8A2:                howto manager.      (line 1654)
13226* BFD_RELOC_MEP_TPREL:                   howto manager.      (line 1663)
13227* BFD_RELOC_MEP_TPREL7:                  howto manager.      (line 1664)
13228* BFD_RELOC_MEP_TPREL7A2:                howto manager.      (line 1665)
13229* BFD_RELOC_MEP_TPREL7A4:                howto manager.      (line 1666)
13230* BFD_RELOC_MEP_UIMM24:                  howto manager.      (line 1667)
13231* BFD_RELOC_METAG_COPY:                  howto manager.      (line 1691)
13232* BFD_RELOC_METAG_GETSETOFF:             howto manager.      (line 1675)
13233* BFD_RELOC_METAG_GETSET_GOT:            howto manager.      (line 1683)
13234* BFD_RELOC_METAG_GETSET_GOTOFF:         howto manager.      (line 1682)
13235* BFD_RELOC_METAG_GLOB_DAT:              howto manager.      (line 1694)
13236* BFD_RELOC_METAG_GOTOFF:                howto manager.      (line 1689)
13237* BFD_RELOC_METAG_HI16_GOTOFF:           howto manager.      (line 1680)
13238* BFD_RELOC_METAG_HI16_GOTPC:            howto manager.      (line 1684)
13239* BFD_RELOC_METAG_HI16_PLT:              howto manager.      (line 1686)
13240* BFD_RELOC_METAG_HIADDR16:              howto manager.      (line 1672)
13241* BFD_RELOC_METAG_HIOG:                  howto manager.      (line 1676)
13242* BFD_RELOC_METAG_JMP_SLOT:              howto manager.      (line 1692)
13243* BFD_RELOC_METAG_LO16_GOTOFF:           howto manager.      (line 1681)
13244* BFD_RELOC_METAG_LO16_GOTPC:            howto manager.      (line 1685)
13245* BFD_RELOC_METAG_LO16_PLT:              howto manager.      (line 1687)
13246* BFD_RELOC_METAG_LOADDR16:              howto manager.      (line 1673)
13247* BFD_RELOC_METAG_LOOG:                  howto manager.      (line 1677)
13248* BFD_RELOC_METAG_PLT:                   howto manager.      (line 1690)
13249* BFD_RELOC_METAG_REL16:                 howto manager.      (line 1679)
13250* BFD_RELOC_METAG_REL8:                  howto manager.      (line 1678)
13251* BFD_RELOC_METAG_RELATIVE:              howto manager.      (line 1693)
13252* BFD_RELOC_METAG_RELBRANCH:             howto manager.      (line 1674)
13253* BFD_RELOC_METAG_RELBRANCH_PLT:         howto manager.      (line 1688)
13254* BFD_RELOC_METAG_TLS_DTPMOD:            howto manager.      (line 1705)
13255* BFD_RELOC_METAG_TLS_DTPOFF:            howto manager.      (line 1706)
13256* BFD_RELOC_METAG_TLS_GD:                howto manager.      (line 1695)
13257* BFD_RELOC_METAG_TLS_IE:                howto manager.      (line 1700)
13258* BFD_RELOC_METAG_TLS_IENONPIC:          howto manager.      (line 1701)
13259* BFD_RELOC_METAG_TLS_IENONPIC_HI16:     howto manager.      (line 1702)
13260* BFD_RELOC_METAG_TLS_IENONPIC_LO16:     howto manager.      (line 1703)
13261* BFD_RELOC_METAG_TLS_LDM:               howto manager.      (line 1696)
13262* BFD_RELOC_METAG_TLS_LDO:               howto manager.      (line 1699)
13263* BFD_RELOC_METAG_TLS_LDO_HI16:          howto manager.      (line 1697)
13264* BFD_RELOC_METAG_TLS_LDO_LO16:          howto manager.      (line 1698)
13265* BFD_RELOC_METAG_TLS_LE:                howto manager.      (line 1707)
13266* BFD_RELOC_METAG_TLS_LE_HI16:           howto manager.      (line 1708)
13267* BFD_RELOC_METAG_TLS_LE_LO16:           howto manager.      (line 1709)
13268* BFD_RELOC_METAG_TLS_TPOFF:             howto manager.      (line 1704)
13269* BFD_RELOC_MICROBLAZE_32_GOTOFF:        howto manager.      (line 2762)
13270* BFD_RELOC_MICROBLAZE_32_LO:            howto manager.      (line 2728)
13271* BFD_RELOC_MICROBLAZE_32_LO_PCREL:      howto manager.      (line 2731)
13272* BFD_RELOC_MICROBLAZE_32_ROSDA:         howto manager.      (line 2734)
13273* BFD_RELOC_MICROBLAZE_32_RWSDA:         howto manager.      (line 2737)
13274* BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM:    howto manager.      (line 2740)
13275* BFD_RELOC_MICROBLAZE_32_TLSDTPMOD:     howto manager.      (line 2778)
13276* BFD_RELOC_MICROBLAZE_32_TLSDTPREL:     howto manager.      (line 2780)
13277* BFD_RELOC_MICROBLAZE_64_GOT:           howto manager.      (line 2751)
13278* BFD_RELOC_MICROBLAZE_64_GOTOFF:        howto manager.      (line 2758)
13279* BFD_RELOC_MICROBLAZE_64_GOTPC:         howto manager.      (line 2747)
13280* BFD_RELOC_MICROBLAZE_64_NONE:          howto manager.      (line 2743)
13281* BFD_RELOC_MICROBLAZE_64_PLT:           howto manager.      (line 2754)
13282* BFD_RELOC_MICROBLAZE_64_TEXTPCREL:     howto manager.      (line 2791)
13283* BFD_RELOC_MICROBLAZE_64_TEXTREL:       howto manager.      (line 2795)
13284* BFD_RELOC_MICROBLAZE_64_TLS:           howto manager.      (line 2768)
13285* BFD_RELOC_MICROBLAZE_64_TLSDTPREL:     howto manager.      (line 2782)
13286* BFD_RELOC_MICROBLAZE_64_TLSGD:         howto manager.      (line 2770)
13287* BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL:   howto manager.      (line 2785)
13288* BFD_RELOC_MICROBLAZE_64_TLSLD:         howto manager.      (line 2774)
13289* BFD_RELOC_MICROBLAZE_64_TLSTPREL:      howto manager.      (line 2788)
13290* BFD_RELOC_MICROBLAZE_COPY:             howto manager.      (line 2765)
13291* BFD_RELOC_MICROMIPS_10_PCREL_S1:       howto manager.      (line  358)
13292* BFD_RELOC_MICROMIPS_16_PCREL_S1:       howto manager.      (line  359)
13293* BFD_RELOC_MICROMIPS_7_PCREL_S1:        howto manager.      (line  357)
13294* BFD_RELOC_MICROMIPS_CALL16:            howto manager.      (line  376)
13295* BFD_RELOC_MICROMIPS_CALL_HI16:         howto manager.      (line  382)
13296* BFD_RELOC_MICROMIPS_CALL_LO16:         howto manager.      (line  384)
13297* BFD_RELOC_MICROMIPS_GOT16:             howto manager.      (line  374)
13298* BFD_RELOC_MICROMIPS_GOT_DISP:          howto manager.      (line  392)
13299* BFD_RELOC_MICROMIPS_GOT_HI16:          howto manager.      (line  378)
13300* BFD_RELOC_MICROMIPS_GOT_LO16:          howto manager.      (line  380)
13301* BFD_RELOC_MICROMIPS_GOT_OFST:          howto manager.      (line  390)
13302* BFD_RELOC_MICROMIPS_GOT_PAGE:          howto manager.      (line  388)
13303* BFD_RELOC_MICROMIPS_GPREL16:           howto manager.      (line  368)
13304* BFD_RELOC_MICROMIPS_HI16:              howto manager.      (line  369)
13305* BFD_RELOC_MICROMIPS_HI16_S:            howto manager.      (line  370)
13306* BFD_RELOC_MICROMIPS_HIGHER:            howto manager.      (line  401)
13307* BFD_RELOC_MICROMIPS_HIGHEST:           howto manager.      (line  399)
13308* BFD_RELOC_MICROMIPS_JALR:              howto manager.      (line  407)
13309* BFD_RELOC_MICROMIPS_JMP:               howto manager.      (line  312)
13310* BFD_RELOC_MICROMIPS_LITERAL:           howto manager.      (line  355)
13311* BFD_RELOC_MICROMIPS_LO16:              howto manager.      (line  371)
13312* BFD_RELOC_MICROMIPS_SCN_DISP:          howto manager.      (line  403)
13313* BFD_RELOC_MICROMIPS_SUB:               howto manager.      (line  386)
13314* BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16:   howto manager.      (line  417)
13315* BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16:   howto manager.      (line  419)
13316* BFD_RELOC_MICROMIPS_TLS_GD:            howto manager.      (line  413)
13317* BFD_RELOC_MICROMIPS_TLS_GOTTPREL:      howto manager.      (line  421)
13318* BFD_RELOC_MICROMIPS_TLS_LDM:           howto manager.      (line  415)
13319* BFD_RELOC_MICROMIPS_TLS_TPREL_HI16:    howto manager.      (line  425)
13320* BFD_RELOC_MICROMIPS_TLS_TPREL_LO16:    howto manager.      (line  427)
13321* BFD_RELOC_MIPS16_16_PCREL_S1:          howto manager.      (line  361)
13322* BFD_RELOC_MIPS16_CALL16:               howto manager.      (line  334)
13323* BFD_RELOC_MIPS16_GOT16:                howto manager.      (line  333)
13324* BFD_RELOC_MIPS16_GPREL:                howto manager.      (line  316)
13325* BFD_RELOC_MIPS16_HI16:                 howto manager.      (line  337)
13326* BFD_RELOC_MIPS16_HI16_S:               howto manager.      (line  339)
13327* BFD_RELOC_MIPS16_JMP:                  howto manager.      (line  314)
13328* BFD_RELOC_MIPS16_LO16:                 howto manager.      (line  344)
13329* BFD_RELOC_MIPS16_TLS_DTPREL_HI16:      howto manager.      (line  348)
13330* BFD_RELOC_MIPS16_TLS_DTPREL_LO16:      howto manager.      (line  349)
13331* BFD_RELOC_MIPS16_TLS_GD:               howto manager.      (line  346)
13332* BFD_RELOC_MIPS16_TLS_GOTTPREL:         howto manager.      (line  350)
13333* BFD_RELOC_MIPS16_TLS_LDM:              howto manager.      (line  347)
13334* BFD_RELOC_MIPS16_TLS_TPREL_HI16:       howto manager.      (line  351)
13335* BFD_RELOC_MIPS16_TLS_TPREL_LO16:       howto manager.      (line  352)
13336* BFD_RELOC_MIPS_16:                     howto manager.      (line  404)
13337* BFD_RELOC_MIPS_18_PCREL_S3:            howto manager.      (line  365)
13338* BFD_RELOC_MIPS_19_PCREL_S2:            howto manager.      (line  366)
13339* BFD_RELOC_MIPS_21_PCREL_S2:            howto manager.      (line  363)
13340* BFD_RELOC_MIPS_26_PCREL_S2:            howto manager.      (line  364)
13341* BFD_RELOC_MIPS_CALL16:                 howto manager.      (line  375)
13342* BFD_RELOC_MIPS_CALL_HI16:              howto manager.      (line  381)
13343* BFD_RELOC_MIPS_CALL_LO16:              howto manager.      (line  383)
13344* BFD_RELOC_MIPS_COPY:                   howto manager.      (line  430)
13345* BFD_RELOC_MIPS_DELETE:                 howto manager.      (line  397)
13346* BFD_RELOC_MIPS_EH:                     howto manager.      (line  428)
13347* BFD_RELOC_MIPS_GOT16:                  howto manager.      (line  373)
13348* BFD_RELOC_MIPS_GOT_DISP:               howto manager.      (line  391)
13349* BFD_RELOC_MIPS_GOT_HI16:               howto manager.      (line  377)
13350* BFD_RELOC_MIPS_GOT_LO16:               howto manager.      (line  379)
13351* BFD_RELOC_MIPS_GOT_OFST:               howto manager.      (line  389)
13352* BFD_RELOC_MIPS_GOT_PAGE:               howto manager.      (line  387)
13353* BFD_RELOC_MIPS_HIGHER:                 howto manager.      (line  400)
13354* BFD_RELOC_MIPS_HIGHEST:                howto manager.      (line  398)
13355* BFD_RELOC_MIPS_INSERT_A:               howto manager.      (line  395)
13356* BFD_RELOC_MIPS_INSERT_B:               howto manager.      (line  396)
13357* BFD_RELOC_MIPS_JALR:                   howto manager.      (line  406)
13358* BFD_RELOC_MIPS_JMP:                    howto manager.      (line  311)
13359* BFD_RELOC_MIPS_JUMP_SLOT:              howto manager.      (line  431)
13360* BFD_RELOC_MIPS_LITERAL:                howto manager.      (line  354)
13361* BFD_RELOC_MIPS_RELGOT:                 howto manager.      (line  405)
13362* BFD_RELOC_MIPS_SCN_DISP:               howto manager.      (line  402)
13363* BFD_RELOC_MIPS_SHIFT5:                 howto manager.      (line  393)
13364* BFD_RELOC_MIPS_SHIFT6:                 howto manager.      (line  394)
13365* BFD_RELOC_MIPS_SUB:                    howto manager.      (line  385)
13366* BFD_RELOC_MIPS_TLS_DTPMOD32:           howto manager.      (line  408)
13367* BFD_RELOC_MIPS_TLS_DTPMOD64:           howto manager.      (line  410)
13368* BFD_RELOC_MIPS_TLS_DTPREL32:           howto manager.      (line  409)
13369* BFD_RELOC_MIPS_TLS_DTPREL64:           howto manager.      (line  411)
13370* BFD_RELOC_MIPS_TLS_DTPREL_HI16:        howto manager.      (line  416)
13371* BFD_RELOC_MIPS_TLS_DTPREL_LO16:        howto manager.      (line  418)
13372* BFD_RELOC_MIPS_TLS_GD:                 howto manager.      (line  412)
13373* BFD_RELOC_MIPS_TLS_GOTTPREL:           howto manager.      (line  420)
13374* BFD_RELOC_MIPS_TLS_LDM:                howto manager.      (line  414)
13375* BFD_RELOC_MIPS_TLS_TPREL32:            howto manager.      (line  422)
13376* BFD_RELOC_MIPS_TLS_TPREL64:            howto manager.      (line  423)
13377* BFD_RELOC_MIPS_TLS_TPREL_HI16:         howto manager.      (line  424)
13378* BFD_RELOC_MIPS_TLS_TPREL_LO16:         howto manager.      (line  426)
13379* BFD_RELOC_MMIX_ADDR19:                 howto manager.      (line 1733)
13380* BFD_RELOC_MMIX_ADDR27:                 howto manager.      (line 1736)
13381* BFD_RELOC_MMIX_BASE_PLUS_OFFSET:       howto manager.      (line 1745)
13382* BFD_RELOC_MMIX_CBRANCH:                howto manager.      (line 1716)
13383* BFD_RELOC_MMIX_CBRANCH_1:              howto manager.      (line 1718)
13384* BFD_RELOC_MMIX_CBRANCH_2:              howto manager.      (line 1719)
13385* BFD_RELOC_MMIX_CBRANCH_3:              howto manager.      (line 1720)
13386* BFD_RELOC_MMIX_CBRANCH_J:              howto manager.      (line 1717)
13387* BFD_RELOC_MMIX_GETA:                   howto manager.      (line 1711)
13388* BFD_RELOC_MMIX_GETA_1:                 howto manager.      (line 1712)
13389* BFD_RELOC_MMIX_GETA_2:                 howto manager.      (line 1713)
13390* BFD_RELOC_MMIX_GETA_3:                 howto manager.      (line 1714)
13391* BFD_RELOC_MMIX_JMP:                    howto manager.      (line 1728)
13392* BFD_RELOC_MMIX_JMP_1:                  howto manager.      (line 1729)
13393* BFD_RELOC_MMIX_JMP_2:                  howto manager.      (line 1730)
13394* BFD_RELOC_MMIX_JMP_3:                  howto manager.      (line 1731)
13395* BFD_RELOC_MMIX_LOCAL:                  howto manager.      (line 1748)
13396* BFD_RELOC_MMIX_PUSHJ:                  howto manager.      (line 1722)
13397* BFD_RELOC_MMIX_PUSHJ_1:                howto manager.      (line 1723)
13398* BFD_RELOC_MMIX_PUSHJ_2:                howto manager.      (line 1724)
13399* BFD_RELOC_MMIX_PUSHJ_3:                howto manager.      (line 1725)
13400* BFD_RELOC_MMIX_PUSHJ_STUBBABLE:        howto manager.      (line 1726)
13401* BFD_RELOC_MMIX_REG:                    howto manager.      (line 1742)
13402* BFD_RELOC_MMIX_REG_OR_BYTE:            howto manager.      (line 1739)
13403* BFD_RELOC_MN10300_16_PCREL:            howto manager.      (line  524)
13404* BFD_RELOC_MN10300_32_PCREL:            howto manager.      (line  521)
13405* BFD_RELOC_MN10300_ALIGN:               howto manager.      (line  508)
13406* BFD_RELOC_MN10300_COPY:                howto manager.      (line  496)
13407* BFD_RELOC_MN10300_GLOB_DAT:            howto manager.      (line  498)
13408* BFD_RELOC_MN10300_GOT16:               howto manager.      (line  493)
13409* BFD_RELOC_MN10300_GOT24:               howto manager.      (line  490)
13410* BFD_RELOC_MN10300_GOT32:               howto manager.      (line  487)
13411* BFD_RELOC_MN10300_GOTOFF24:            howto manager.      (line  485)
13412* BFD_RELOC_MN10300_JMP_SLOT:            howto manager.      (line  500)
13413* BFD_RELOC_MN10300_RELATIVE:            howto manager.      (line  502)
13414* BFD_RELOC_MN10300_SYM_DIFF:            howto manager.      (line  504)
13415* BFD_RELOC_MN10300_TLS_DTPMOD:          howto manager.      (line  517)
13416* BFD_RELOC_MN10300_TLS_DTPOFF:          howto manager.      (line  518)
13417* BFD_RELOC_MN10300_TLS_GD:              howto manager.      (line  511)
13418* BFD_RELOC_MN10300_TLS_GOTIE:           howto manager.      (line  514)
13419* BFD_RELOC_MN10300_TLS_IE:              howto manager.      (line  515)
13420* BFD_RELOC_MN10300_TLS_LD:              howto manager.      (line  512)
13421* BFD_RELOC_MN10300_TLS_LDO:             howto manager.      (line  513)
13422* BFD_RELOC_MN10300_TLS_LE:              howto manager.      (line  516)
13423* BFD_RELOC_MN10300_TLS_TPOFF:           howto manager.      (line  519)
13424* BFD_RELOC_MOXIE_10_PCREL:              howto manager.      (line  433)
13425* BFD_RELOC_MSP430X_ABS16:               howto manager.      (line 2473)
13426* BFD_RELOC_MSP430X_ABS20_ADR_DST:       howto manager.      (line 2470)
13427* BFD_RELOC_MSP430X_ABS20_ADR_SRC:       howto manager.      (line 2469)
13428* BFD_RELOC_MSP430X_ABS20_EXT_DST:       howto manager.      (line 2467)
13429* BFD_RELOC_MSP430X_ABS20_EXT_ODST:      howto manager.      (line 2468)
13430* BFD_RELOC_MSP430X_ABS20_EXT_SRC:       howto manager.      (line 2466)
13431* BFD_RELOC_MSP430X_PCR16:               howto manager.      (line 2471)
13432* BFD_RELOC_MSP430X_PCR20_CALL:          howto manager.      (line 2472)
13433* BFD_RELOC_MSP430X_PCR20_EXT_DST:       howto manager.      (line 2464)
13434* BFD_RELOC_MSP430X_PCR20_EXT_ODST:      howto manager.      (line 2465)
13435* BFD_RELOC_MSP430X_PCR20_EXT_SRC:       howto manager.      (line 2463)
13436* BFD_RELOC_MSP430_10_PCREL:             howto manager.      (line 2455)
13437* BFD_RELOC_MSP430_16:                   howto manager.      (line 2457)
13438* BFD_RELOC_MSP430_16_BYTE:              howto manager.      (line 2459)
13439* BFD_RELOC_MSP430_16_PCREL:             howto manager.      (line 2456)
13440* BFD_RELOC_MSP430_16_PCREL_BYTE:        howto manager.      (line 2458)
13441* BFD_RELOC_MSP430_2X_PCREL:             howto manager.      (line 2460)
13442* BFD_RELOC_MSP430_ABS8:                 howto manager.      (line 2462)
13443* BFD_RELOC_MSP430_ABS_HI16:             howto manager.      (line 2474)
13444* BFD_RELOC_MSP430_PREL31:               howto manager.      (line 2475)
13445* BFD_RELOC_MSP430_RL_PCREL:             howto manager.      (line 2461)
13446* BFD_RELOC_MSP430_SET_ULEB128:          howto manager.      (line 2477)
13447* BFD_RELOC_MSP430_SUB_ULEB128:          howto manager.      (line 2478)
13448* BFD_RELOC_MSP430_SYM_DIFF:             howto manager.      (line 2476)
13449* BFD_RELOC_MT_GNU_VTENTRY:              howto manager.      (line 2451)
13450* BFD_RELOC_MT_GNU_VTINHERIT:            howto manager.      (line 2449)
13451* BFD_RELOC_MT_HI16:                     howto manager.      (line 2445)
13452* BFD_RELOC_MT_LO16:                     howto manager.      (line 2447)
13453* BFD_RELOC_MT_PC16:                     howto manager.      (line 2443)
13454* BFD_RELOC_MT_PCINSN8:                  howto manager.      (line 2453)
13455* BFD_RELOC_NDS32_10IFCU_PCREL:          howto manager.      (line 1444)
13456* BFD_RELOC_NDS32_10_UPCREL:             howto manager.      (line 1415)
13457* BFD_RELOC_NDS32_15_FIXED:              howto manager.      (line 1376)
13458* BFD_RELOC_NDS32_15_PCREL:              howto manager.      (line 1302)
13459* BFD_RELOC_NDS32_17IFC_PCREL:           howto manager.      (line 1443)
13460* BFD_RELOC_NDS32_17_FIXED:              howto manager.      (line 1377)
13461* BFD_RELOC_NDS32_17_PCREL:              howto manager.      (line 1304)
13462* BFD_RELOC_NDS32_20:                    howto manager.      (line 1294)
13463* BFD_RELOC_NDS32_25_ABS:                howto manager.      (line 1439)
13464* BFD_RELOC_NDS32_25_FIXED:              howto manager.      (line 1378)
13465* BFD_RELOC_NDS32_25_PCREL:              howto manager.      (line 1306)
13466* BFD_RELOC_NDS32_25_PLTREL:             howto manager.      (line 1352)
13467* BFD_RELOC_NDS32_5:                     howto manager.      (line 1413)
13468* BFD_RELOC_NDS32_9_FIXED:               howto manager.      (line 1375)
13469* BFD_RELOC_NDS32_9_PCREL:               howto manager.      (line 1296)
13470* BFD_RELOC_NDS32_9_PLTREL:              howto manager.      (line 1351)
13471* BFD_RELOC_NDS32_COPY:                  howto manager.      (line 1353)
13472* BFD_RELOC_NDS32_DATA:                  howto manager.      (line 1441)
13473* BFD_RELOC_NDS32_DIFF16:                howto manager.      (line 1434)
13474* BFD_RELOC_NDS32_DIFF32:                howto manager.      (line 1435)
13475* BFD_RELOC_NDS32_DIFF8:                 howto manager.      (line 1433)
13476* BFD_RELOC_NDS32_DIFF_ULEB128:          howto manager.      (line 1436)
13477* BFD_RELOC_NDS32_DWARF2_LEB:            howto manager.      (line 1399)
13478* BFD_RELOC_NDS32_DWARF2_OP1:            howto manager.      (line 1397)
13479* BFD_RELOC_NDS32_DWARF2_OP2:            howto manager.      (line 1398)
13480* BFD_RELOC_NDS32_EMPTY:                 howto manager.      (line 1437)
13481* BFD_RELOC_NDS32_GLOB_DAT:              howto manager.      (line 1354)
13482* BFD_RELOC_NDS32_GOT15S2:               howto manager.      (line 1410)
13483* BFD_RELOC_NDS32_GOT17S2:               howto manager.      (line 1411)
13484* BFD_RELOC_NDS32_GOT20:                 howto manager.      (line 1350)
13485* BFD_RELOC_NDS32_GOTOFF:                howto manager.      (line 1357)
13486* BFD_RELOC_NDS32_GOTOFF_HI20:           howto manager.      (line 1358)
13487* BFD_RELOC_NDS32_GOTOFF_LO12:           howto manager.      (line 1359)
13488* BFD_RELOC_NDS32_GOTOFF_LO15:           howto manager.      (line 1408)
13489* BFD_RELOC_NDS32_GOTOFF_LO19:           howto manager.      (line 1409)
13490* BFD_RELOC_NDS32_GOTOFF_SUFF:           howto manager.      (line 1422)
13491* BFD_RELOC_NDS32_GOTPC20:               howto manager.      (line 1360)
13492* BFD_RELOC_NDS32_GOTPC_HI20:            howto manager.      (line 1363)
13493* BFD_RELOC_NDS32_GOTPC_LO12:            howto manager.      (line 1364)
13494* BFD_RELOC_NDS32_GOTTPOFF:              howto manager.      (line 1447)
13495* BFD_RELOC_NDS32_GOT_HI20:              howto manager.      (line 1361)
13496* BFD_RELOC_NDS32_GOT_LO12:              howto manager.      (line 1362)
13497* BFD_RELOC_NDS32_GOT_LO15:              howto manager.      (line 1406)
13498* BFD_RELOC_NDS32_GOT_LO19:              howto manager.      (line 1407)
13499* BFD_RELOC_NDS32_GOT_SUFF:              howto manager.      (line 1421)
13500* BFD_RELOC_NDS32_GROUP:                 howto manager.      (line 1473)
13501* BFD_RELOC_NDS32_HI20:                  howto manager.      (line 1308)
13502* BFD_RELOC_NDS32_INSN16:                howto manager.      (line 1366)
13503* BFD_RELOC_NDS32_JMP_SLOT:              howto manager.      (line 1355)
13504* BFD_RELOC_NDS32_LABEL:                 howto manager.      (line 1367)
13505* BFD_RELOC_NDS32_LO12S0:                howto manager.      (line 1320)
13506* BFD_RELOC_NDS32_LO12S0_ORI:            howto manager.      (line 1323)
13507* BFD_RELOC_NDS32_LO12S1:                howto manager.      (line 1317)
13508* BFD_RELOC_NDS32_LO12S2:                howto manager.      (line 1314)
13509* BFD_RELOC_NDS32_LO12S2_DP:             howto manager.      (line 1394)
13510* BFD_RELOC_NDS32_LO12S2_SP:             howto manager.      (line 1395)
13511* BFD_RELOC_NDS32_LO12S3:                howto manager.      (line 1311)
13512* BFD_RELOC_NDS32_LOADSTORE:             howto manager.      (line 1374)
13513* BFD_RELOC_NDS32_LONGCALL1:             howto manager.      (line 1368)
13514* BFD_RELOC_NDS32_LONGCALL2:             howto manager.      (line 1369)
13515* BFD_RELOC_NDS32_LONGCALL3:             howto manager.      (line 1370)
13516* BFD_RELOC_NDS32_LONGCALL4:             howto manager.      (line 1379)
13517* BFD_RELOC_NDS32_LONGCALL5:             howto manager.      (line 1380)
13518* BFD_RELOC_NDS32_LONGCALL6:             howto manager.      (line 1381)
13519* BFD_RELOC_NDS32_LONGJUMP1:             howto manager.      (line 1371)
13520* BFD_RELOC_NDS32_LONGJUMP2:             howto manager.      (line 1372)
13521* BFD_RELOC_NDS32_LONGJUMP3:             howto manager.      (line 1373)
13522* BFD_RELOC_NDS32_LONGJUMP4:             howto manager.      (line 1382)
13523* BFD_RELOC_NDS32_LONGJUMP5:             howto manager.      (line 1383)
13524* BFD_RELOC_NDS32_LONGJUMP6:             howto manager.      (line 1384)
13525* BFD_RELOC_NDS32_LONGJUMP7:             howto manager.      (line 1385)
13526* BFD_RELOC_NDS32_LSI:                   howto manager.      (line 1475)
13527* BFD_RELOC_NDS32_MINUEND:               howto manager.      (line 1431)
13528* BFD_RELOC_NDS32_MULCALL_SUFF:          howto manager.      (line 1424)
13529* BFD_RELOC_NDS32_PLTBLOCK:              howto manager.      (line 1428)
13530* BFD_RELOC_NDS32_PLTREL_HI20:           howto manager.      (line 1387)
13531* BFD_RELOC_NDS32_PLTREL_LO12:           howto manager.      (line 1388)
13532* BFD_RELOC_NDS32_PLT_GOTREL_HI20:       howto manager.      (line 1389)
13533* BFD_RELOC_NDS32_PLT_GOTREL_LO12:       howto manager.      (line 1390)
13534* BFD_RELOC_NDS32_PLT_GOTREL_LO15:       howto manager.      (line 1404)
13535* BFD_RELOC_NDS32_PLT_GOTREL_LO19:       howto manager.      (line 1405)
13536* BFD_RELOC_NDS32_PLT_GOTREL_LO20:       howto manager.      (line 1403)
13537* BFD_RELOC_NDS32_PLT_GOT_SUFF:          howto manager.      (line 1423)
13538* BFD_RELOC_NDS32_PTR:                   howto manager.      (line 1425)
13539* BFD_RELOC_NDS32_PTR_COUNT:             howto manager.      (line 1426)
13540* BFD_RELOC_NDS32_PTR_RESOLVED:          howto manager.      (line 1427)
13541* BFD_RELOC_NDS32_RELATIVE:              howto manager.      (line 1356)
13542* BFD_RELOC_NDS32_RELAX_ENTRY:           howto manager.      (line 1420)
13543* BFD_RELOC_NDS32_RELAX_REGION_BEGIN:    howto manager.      (line 1429)
13544* BFD_RELOC_NDS32_RELAX_REGION_END:      howto manager.      (line 1430)
13545* BFD_RELOC_NDS32_REMOVE:                howto manager.      (line 1472)
13546* BFD_RELOC_NDS32_SDA12S2_DP:            howto manager.      (line 1392)
13547* BFD_RELOC_NDS32_SDA12S2_SP:            howto manager.      (line 1393)
13548* BFD_RELOC_NDS32_SDA15S0:               howto manager.      (line 1335)
13549* BFD_RELOC_NDS32_SDA15S1:               howto manager.      (line 1332)
13550* BFD_RELOC_NDS32_SDA15S2:               howto manager.      (line 1329)
13551* BFD_RELOC_NDS32_SDA15S3:               howto manager.      (line 1326)
13552* BFD_RELOC_NDS32_SDA16S3:               howto manager.      (line 1338)
13553* BFD_RELOC_NDS32_SDA17S2:               howto manager.      (line 1341)
13554* BFD_RELOC_NDS32_SDA18S1:               howto manager.      (line 1344)
13555* BFD_RELOC_NDS32_SDA19S0:               howto manager.      (line 1347)
13556* BFD_RELOC_NDS32_SDA_FP7U2_RELA:        howto manager.      (line 1418)
13557* BFD_RELOC_NDS32_SUBTRAHEND:            howto manager.      (line 1432)
13558* BFD_RELOC_NDS32_TLS_DESC:              howto manager.      (line 1463)
13559* BFD_RELOC_NDS32_TLS_DESC_20:           howto manager.      (line 1466)
13560* BFD_RELOC_NDS32_TLS_DESC_ADD:          howto manager.      (line 1468)
13561* BFD_RELOC_NDS32_TLS_DESC_CALL:         howto manager.      (line 1470)
13562* BFD_RELOC_NDS32_TLS_DESC_FUNC:         howto manager.      (line 1469)
13563* BFD_RELOC_NDS32_TLS_DESC_HI20:         howto manager.      (line 1464)
13564* BFD_RELOC_NDS32_TLS_DESC_LO12:         howto manager.      (line 1465)
13565* BFD_RELOC_NDS32_TLS_DESC_MEM:          howto manager.      (line 1471)
13566* BFD_RELOC_NDS32_TLS_DESC_SDA17S2:      howto manager.      (line 1467)
13567* BFD_RELOC_NDS32_TLS_IEGP_HI20:         howto manager.      (line 1459)
13568* BFD_RELOC_NDS32_TLS_IEGP_LO12:         howto manager.      (line 1460)
13569* BFD_RELOC_NDS32_TLS_IEGP_LO12S2:       howto manager.      (line 1461)
13570* BFD_RELOC_NDS32_TLS_IEGP_LW:           howto manager.      (line 1462)
13571* BFD_RELOC_NDS32_TLS_IE_HI20:           howto manager.      (line 1456)
13572* BFD_RELOC_NDS32_TLS_IE_LO12:           howto manager.      (line 1457)
13573* BFD_RELOC_NDS32_TLS_IE_LO12S2:         howto manager.      (line 1458)
13574* BFD_RELOC_NDS32_TLS_LE_15S0:           howto manager.      (line 1451)
13575* BFD_RELOC_NDS32_TLS_LE_15S1:           howto manager.      (line 1452)
13576* BFD_RELOC_NDS32_TLS_LE_15S2:           howto manager.      (line 1453)
13577* BFD_RELOC_NDS32_TLS_LE_20:             howto manager.      (line 1450)
13578* BFD_RELOC_NDS32_TLS_LE_ADD:            howto manager.      (line 1454)
13579* BFD_RELOC_NDS32_TLS_LE_HI20:           howto manager.      (line 1448)
13580* BFD_RELOC_NDS32_TLS_LE_LO12:           howto manager.      (line 1449)
13581* BFD_RELOC_NDS32_TLS_LE_LS:             howto manager.      (line 1455)
13582* BFD_RELOC_NDS32_TPOFF:                 howto manager.      (line 1446)
13583* BFD_RELOC_NDS32_TRAN:                  howto manager.      (line 1442)
13584* BFD_RELOC_NDS32_UPDATE_TA:             howto manager.      (line 1401)
13585* BFD_RELOC_NDS32_WORD_9_PCREL:          howto manager.      (line 1299)
13586* BFD_RELOC_NIOS2_ALIGN:                 howto manager.      (line 2494)
13587* BFD_RELOC_NIOS2_CACHE_OPX:             howto manager.      (line 2484)
13588* BFD_RELOC_NIOS2_CALL16:                howto manager.      (line 2496)
13589* BFD_RELOC_NIOS2_CALL26:                howto manager.      (line 2482)
13590* BFD_RELOC_NIOS2_CALL26_NOAT:           howto manager.      (line 2514)
13591* BFD_RELOC_NIOS2_CALLR:                 howto manager.      (line 2493)
13592* BFD_RELOC_NIOS2_CALL_HA:               howto manager.      (line 2518)
13593* BFD_RELOC_NIOS2_CALL_LO:               howto manager.      (line 2517)
13594* BFD_RELOC_NIOS2_CJMP:                  howto manager.      (line 2492)
13595* BFD_RELOC_NIOS2_COPY:                  howto manager.      (line 2509)
13596* BFD_RELOC_NIOS2_GLOB_DAT:              howto manager.      (line 2510)
13597* BFD_RELOC_NIOS2_GOT16:                 howto manager.      (line 2495)
13598* BFD_RELOC_NIOS2_GOTOFF:                howto manager.      (line 2513)
13599* BFD_RELOC_NIOS2_GOTOFF_HA:             howto manager.      (line 2498)
13600* BFD_RELOC_NIOS2_GOTOFF_LO:             howto manager.      (line 2497)
13601* BFD_RELOC_NIOS2_GOT_HA:                howto manager.      (line 2516)
13602* BFD_RELOC_NIOS2_GOT_LO:                howto manager.      (line 2515)
13603* BFD_RELOC_NIOS2_GPREL:                 howto manager.      (line 2490)
13604* BFD_RELOC_NIOS2_HI16:                  howto manager.      (line 2487)
13605* BFD_RELOC_NIOS2_HIADJ16:               howto manager.      (line 2489)
13606* BFD_RELOC_NIOS2_IMM5:                  howto manager.      (line 2483)
13607* BFD_RELOC_NIOS2_IMM6:                  howto manager.      (line 2485)
13608* BFD_RELOC_NIOS2_IMM8:                  howto manager.      (line 2486)
13609* BFD_RELOC_NIOS2_JUMP_SLOT:             howto manager.      (line 2511)
13610* BFD_RELOC_NIOS2_LO16:                  howto manager.      (line 2488)
13611* BFD_RELOC_NIOS2_PCREL_HA:              howto manager.      (line 2500)
13612* BFD_RELOC_NIOS2_PCREL_LO:              howto manager.      (line 2499)
13613* BFD_RELOC_NIOS2_R2_F1I5_2:             howto manager.      (line 2528)
13614* BFD_RELOC_NIOS2_R2_I10_1_PCREL:        howto manager.      (line 2520)
13615* BFD_RELOC_NIOS2_R2_L5I4X1:             howto manager.      (line 2529)
13616* BFD_RELOC_NIOS2_R2_S12:                howto manager.      (line 2519)
13617* BFD_RELOC_NIOS2_R2_T1I7_1_PCREL:       howto manager.      (line 2521)
13618* BFD_RELOC_NIOS2_R2_T1I7_2:             howto manager.      (line 2522)
13619* BFD_RELOC_NIOS2_R2_T1X1I6:             howto manager.      (line 2530)
13620* BFD_RELOC_NIOS2_R2_T1X1I6_2:           howto manager.      (line 2531)
13621* BFD_RELOC_NIOS2_R2_T2I4:               howto manager.      (line 2523)
13622* BFD_RELOC_NIOS2_R2_T2I4_1:             howto manager.      (line 2524)
13623* BFD_RELOC_NIOS2_R2_T2I4_2:             howto manager.      (line 2525)
13624* BFD_RELOC_NIOS2_R2_X1I7_2:             howto manager.      (line 2526)
13625* BFD_RELOC_NIOS2_R2_X2L5:               howto manager.      (line 2527)
13626* BFD_RELOC_NIOS2_RELATIVE:              howto manager.      (line 2512)
13627* BFD_RELOC_NIOS2_S16:                   howto manager.      (line 2480)
13628* BFD_RELOC_NIOS2_TLS_DTPMOD:            howto manager.      (line 2506)
13629* BFD_RELOC_NIOS2_TLS_DTPREL:            howto manager.      (line 2507)
13630* BFD_RELOC_NIOS2_TLS_GD16:              howto manager.      (line 2501)
13631* BFD_RELOC_NIOS2_TLS_IE16:              howto manager.      (line 2504)
13632* BFD_RELOC_NIOS2_TLS_LDM16:             howto manager.      (line 2502)
13633* BFD_RELOC_NIOS2_TLS_LDO16:             howto manager.      (line 2503)
13634* BFD_RELOC_NIOS2_TLS_LE16:              howto manager.      (line 2505)
13635* BFD_RELOC_NIOS2_TLS_TPREL:             howto manager.      (line 2508)
13636* BFD_RELOC_NIOS2_U16:                   howto manager.      (line 2481)
13637* BFD_RELOC_NIOS2_UJMP:                  howto manager.      (line 2491)
13638* BFD_RELOC_NONE:                        howto manager.      (line  124)
13639* BFD_RELOC_NS32K_DISP_16:               howto manager.      (line  592)
13640* BFD_RELOC_NS32K_DISP_16_PCREL:         howto manager.      (line  595)
13641* BFD_RELOC_NS32K_DISP_32:               howto manager.      (line  593)
13642* BFD_RELOC_NS32K_DISP_32_PCREL:         howto manager.      (line  596)
13643* BFD_RELOC_NS32K_DISP_8:                howto manager.      (line  591)
13644* BFD_RELOC_NS32K_DISP_8_PCREL:          howto manager.      (line  594)
13645* BFD_RELOC_NS32K_IMM_16:                howto manager.      (line  586)
13646* BFD_RELOC_NS32K_IMM_16_PCREL:          howto manager.      (line  589)
13647* BFD_RELOC_NS32K_IMM_32:                howto manager.      (line  587)
13648* BFD_RELOC_NS32K_IMM_32_PCREL:          howto manager.      (line  590)
13649* BFD_RELOC_NS32K_IMM_8:                 howto manager.      (line  585)
13650* BFD_RELOC_NS32K_IMM_8_PCREL:           howto manager.      (line  588)
13651* bfd_reloc_offset_in_range:             typedef arelent.    (line  340)
13652* BFD_RELOC_OR1K_COPY:                   howto manager.      (line 2398)
13653* BFD_RELOC_OR1K_GLOB_DAT:               howto manager.      (line 2399)
13654* BFD_RELOC_OR1K_GOT16:                  howto manager.      (line 2392)
13655* BFD_RELOC_OR1K_GOTOFF_SLO16:           howto manager.      (line 2397)
13656* BFD_RELOC_OR1K_GOTPC_HI16:             howto manager.      (line 2389)
13657* BFD_RELOC_OR1K_GOTPC_LO16:             howto manager.      (line 2390)
13658* BFD_RELOC_OR1K_GOT_AHI16:              howto manager.      (line 2391)
13659* BFD_RELOC_OR1K_GOT_LO13:               howto manager.      (line 2394)
13660* BFD_RELOC_OR1K_GOT_PG21:               howto manager.      (line 2393)
13661* BFD_RELOC_OR1K_JMP_SLOT:               howto manager.      (line 2400)
13662* BFD_RELOC_OR1K_LO13:                   howto manager.      (line 2387)
13663* BFD_RELOC_OR1K_PCREL_PG21:             howto manager.      (line 2386)
13664* BFD_RELOC_OR1K_PLT26:                  howto manager.      (line 2395)
13665* BFD_RELOC_OR1K_PLTA26:                 howto manager.      (line 2396)
13666* BFD_RELOC_OR1K_RELATIVE:               howto manager.      (line 2401)
13667* BFD_RELOC_OR1K_REL_26:                 howto manager.      (line 2384)
13668* BFD_RELOC_OR1K_SLO13:                  howto manager.      (line 2388)
13669* BFD_RELOC_OR1K_SLO16:                  howto manager.      (line 2385)
13670* BFD_RELOC_OR1K_TLS_DTPMOD:             howto manager.      (line 2423)
13671* BFD_RELOC_OR1K_TLS_DTPOFF:             howto manager.      (line 2422)
13672* BFD_RELOC_OR1K_TLS_GD_HI16:            howto manager.      (line 2402)
13673* BFD_RELOC_OR1K_TLS_GD_LO13:            howto manager.      (line 2405)
13674* BFD_RELOC_OR1K_TLS_GD_LO16:            howto manager.      (line 2403)
13675* BFD_RELOC_OR1K_TLS_GD_PG21:            howto manager.      (line 2404)
13676* BFD_RELOC_OR1K_TLS_IE_AHI16:           howto manager.      (line 2413)
13677* BFD_RELOC_OR1K_TLS_IE_HI16:            howto manager.      (line 2412)
13678* BFD_RELOC_OR1K_TLS_IE_LO13:            howto manager.      (line 2416)
13679* BFD_RELOC_OR1K_TLS_IE_LO16:            howto manager.      (line 2414)
13680* BFD_RELOC_OR1K_TLS_IE_PG21:            howto manager.      (line 2415)
13681* BFD_RELOC_OR1K_TLS_LDM_HI16:           howto manager.      (line 2406)
13682* BFD_RELOC_OR1K_TLS_LDM_LO13:           howto manager.      (line 2409)
13683* BFD_RELOC_OR1K_TLS_LDM_LO16:           howto manager.      (line 2407)
13684* BFD_RELOC_OR1K_TLS_LDM_PG21:           howto manager.      (line 2408)
13685* BFD_RELOC_OR1K_TLS_LDO_HI16:           howto manager.      (line 2410)
13686* BFD_RELOC_OR1K_TLS_LDO_LO16:           howto manager.      (line 2411)
13687* BFD_RELOC_OR1K_TLS_LE_AHI16:           howto manager.      (line 2418)
13688* BFD_RELOC_OR1K_TLS_LE_HI16:            howto manager.      (line 2417)
13689* BFD_RELOC_OR1K_TLS_LE_LO16:            howto manager.      (line 2419)
13690* BFD_RELOC_OR1K_TLS_LE_SLO16:           howto manager.      (line 2420)
13691* BFD_RELOC_OR1K_TLS_TPOFF:              howto manager.      (line 2421)
13692* BFD_RELOC_PDP11_DISP_6_PCREL:          howto manager.      (line  599)
13693* BFD_RELOC_PDP11_DISP_8_PCREL:          howto manager.      (line  598)
13694* BFD_RELOC_PJ_CODE_DIR16:               howto manager.      (line  603)
13695* BFD_RELOC_PJ_CODE_DIR32:               howto manager.      (line  604)
13696* BFD_RELOC_PJ_CODE_HI16:                howto manager.      (line  601)
13697* BFD_RELOC_PJ_CODE_LO16:                howto manager.      (line  602)
13698* BFD_RELOC_PJ_CODE_REL16:               howto manager.      (line  605)
13699* BFD_RELOC_PJ_CODE_REL32:               howto manager.      (line  606)
13700* BFD_RELOC_PPC64_ADDR16_DS:             howto manager.      (line  672)
13701* BFD_RELOC_PPC64_ADDR16_HIGH:           howto manager.      (line  683)
13702* BFD_RELOC_PPC64_ADDR16_HIGHA:          howto manager.      (line  684)
13703* BFD_RELOC_PPC64_ADDR16_HIGHER34:       howto manager.      (line  702)
13704* BFD_RELOC_PPC64_ADDR16_HIGHERA34:      howto manager.      (line  703)
13705* BFD_RELOC_PPC64_ADDR16_HIGHEST34:      howto manager.      (line  704)
13706* BFD_RELOC_PPC64_ADDR16_HIGHESTA34:     howto manager.      (line  705)
13707* BFD_RELOC_PPC64_ADDR16_LO_DS:          howto manager.      (line  673)
13708* BFD_RELOC_PPC64_ADDR64_LOCAL:          howto manager.      (line  691)
13709* BFD_RELOC_PPC64_D28:                   howto manager.      (line  710)
13710* BFD_RELOC_PPC64_D34:                   howto manager.      (line  695)
13711* BFD_RELOC_PPC64_D34_HA30:              howto manager.      (line  698)
13712* BFD_RELOC_PPC64_D34_HI30:              howto manager.      (line  697)
13713* BFD_RELOC_PPC64_D34_LO:                howto manager.      (line  696)
13714* BFD_RELOC_PPC64_DTPREL16_DS:           howto manager.      (line  761)
13715* BFD_RELOC_PPC64_DTPREL16_HIGH:         howto manager.      (line  763)
13716* BFD_RELOC_PPC64_DTPREL16_HIGHA:        howto manager.      (line  764)
13717* BFD_RELOC_PPC64_DTPREL16_HIGHER:       howto manager.      (line  765)
13718* BFD_RELOC_PPC64_DTPREL16_HIGHERA:      howto manager.      (line  766)
13719* BFD_RELOC_PPC64_DTPREL16_HIGHEST:      howto manager.      (line  767)
13720* BFD_RELOC_PPC64_DTPREL16_HIGHESTA:     howto manager.      (line  768)
13721* BFD_RELOC_PPC64_DTPREL16_LO_DS:        howto manager.      (line  762)
13722* BFD_RELOC_PPC64_DTPREL34:              howto manager.      (line  770)
13723* BFD_RELOC_PPC64_ENTRY:                 howto manager.      (line  692)
13724* BFD_RELOC_PPC64_GOT16_DS:              howto manager.      (line  674)
13725* BFD_RELOC_PPC64_GOT16_LO_DS:           howto manager.      (line  675)
13726* BFD_RELOC_PPC64_GOT_DTPREL_PCREL34:    howto manager.      (line  774)
13727* BFD_RELOC_PPC64_GOT_PCREL34:           howto manager.      (line  700)
13728* BFD_RELOC_PPC64_GOT_TLSGD_PCREL34:     howto manager.      (line  771)
13729* BFD_RELOC_PPC64_GOT_TLSLD_PCREL34:     howto manager.      (line  772)
13730* BFD_RELOC_PPC64_GOT_TPREL_PCREL34:     howto manager.      (line  773)
13731* BFD_RELOC_PPC64_HIGHER:                howto manager.      (line  660)
13732* BFD_RELOC_PPC64_HIGHER_S:              howto manager.      (line  661)
13733* BFD_RELOC_PPC64_HIGHEST:               howto manager.      (line  662)
13734* BFD_RELOC_PPC64_HIGHEST_S:             howto manager.      (line  663)
13735* BFD_RELOC_PPC64_PCREL28:               howto manager.      (line  711)
13736* BFD_RELOC_PPC64_PCREL34:               howto manager.      (line  699)
13737* BFD_RELOC_PPC64_PLT16_LO_DS:           howto manager.      (line  676)
13738* BFD_RELOC_PPC64_PLTGOT16:              howto manager.      (line  668)
13739* BFD_RELOC_PPC64_PLTGOT16_DS:           howto manager.      (line  681)
13740* BFD_RELOC_PPC64_PLTGOT16_HA:           howto manager.      (line  671)
13741* BFD_RELOC_PPC64_PLTGOT16_HI:           howto manager.      (line  670)
13742* BFD_RELOC_PPC64_PLTGOT16_LO:           howto manager.      (line  669)
13743* BFD_RELOC_PPC64_PLTGOT16_LO_DS:        howto manager.      (line  682)
13744* BFD_RELOC_PPC64_PLT_PCREL34:           howto manager.      (line  701)
13745* BFD_RELOC_PPC64_REL16_HIGH:            howto manager.      (line  685)
13746* BFD_RELOC_PPC64_REL16_HIGHA:           howto manager.      (line  686)
13747* BFD_RELOC_PPC64_REL16_HIGHER:          howto manager.      (line  687)
13748* BFD_RELOC_PPC64_REL16_HIGHER34:        howto manager.      (line  706)
13749* BFD_RELOC_PPC64_REL16_HIGHERA:         howto manager.      (line  688)
13750* BFD_RELOC_PPC64_REL16_HIGHERA34:       howto manager.      (line  707)
13751* BFD_RELOC_PPC64_REL16_HIGHEST:         howto manager.      (line  689)
13752* BFD_RELOC_PPC64_REL16_HIGHEST34:       howto manager.      (line  708)
13753* BFD_RELOC_PPC64_REL16_HIGHESTA:        howto manager.      (line  690)
13754* BFD_RELOC_PPC64_REL16_HIGHESTA34:      howto manager.      (line  709)
13755* BFD_RELOC_PPC64_REL24_NOTOC:           howto manager.      (line  693)
13756* BFD_RELOC_PPC64_REL24_P9NOTOC:         howto manager.      (line  694)
13757* BFD_RELOC_PPC64_SECTOFF_DS:            howto manager.      (line  677)
13758* BFD_RELOC_PPC64_SECTOFF_LO_DS:         howto manager.      (line  678)
13759* BFD_RELOC_PPC64_TLSGD:                 howto manager.      (line  747)
13760* BFD_RELOC_PPC64_TLSIE:                 howto manager.      (line  750)
13761* BFD_RELOC_PPC64_TLSLD:                 howto manager.      (line  748)
13762* BFD_RELOC_PPC64_TLSLE:                 howto manager.      (line  749)
13763* BFD_RELOC_PPC64_TLSM:                  howto manager.      (line  751)
13764* BFD_RELOC_PPC64_TLSML:                 howto manager.      (line  752)
13765* BFD_RELOC_PPC64_TLS_PCREL:             howto manager.      (line  775)
13766* BFD_RELOC_PPC64_TOC:                   howto manager.      (line  667)
13767* BFD_RELOC_PPC64_TOC16_DS:              howto manager.      (line  679)
13768* BFD_RELOC_PPC64_TOC16_HA:              howto manager.      (line  666)
13769* BFD_RELOC_PPC64_TOC16_HI:              howto manager.      (line  665)
13770* BFD_RELOC_PPC64_TOC16_LO:              howto manager.      (line  664)
13771* BFD_RELOC_PPC64_TOC16_LO_DS:           howto manager.      (line  680)
13772* BFD_RELOC_PPC64_TPREL16_DS:            howto manager.      (line  753)
13773* BFD_RELOC_PPC64_TPREL16_HIGH:          howto manager.      (line  755)
13774* BFD_RELOC_PPC64_TPREL16_HIGHA:         howto manager.      (line  756)
13775* BFD_RELOC_PPC64_TPREL16_HIGHER:        howto manager.      (line  757)
13776* BFD_RELOC_PPC64_TPREL16_HIGHERA:       howto manager.      (line  758)
13777* BFD_RELOC_PPC64_TPREL16_HIGHEST:       howto manager.      (line  759)
13778* BFD_RELOC_PPC64_TPREL16_HIGHESTA:      howto manager.      (line  760)
13779* BFD_RELOC_PPC64_TPREL16_LO_DS:         howto manager.      (line  754)
13780* BFD_RELOC_PPC64_TPREL34:               howto manager.      (line  769)
13781* BFD_RELOC_PPC_16DX_HA:                 howto manager.      (line  657)
13782* BFD_RELOC_PPC_B16:                     howto manager.      (line  613)
13783* BFD_RELOC_PPC_B16_BRNTAKEN:            howto manager.      (line  615)
13784* BFD_RELOC_PPC_B16_BRTAKEN:             howto manager.      (line  614)
13785* BFD_RELOC_PPC_B26:                     howto manager.      (line  608)
13786* BFD_RELOC_PPC_BA16:                    howto manager.      (line  616)
13787* BFD_RELOC_PPC_BA16_BRNTAKEN:           howto manager.      (line  618)
13788* BFD_RELOC_PPC_BA16_BRTAKEN:            howto manager.      (line  617)
13789* BFD_RELOC_PPC_BA26:                    howto manager.      (line  609)
13790* BFD_RELOC_PPC_COPY:                    howto manager.      (line  619)
13791* BFD_RELOC_PPC_DTPMOD:                  howto manager.      (line  720)
13792* BFD_RELOC_PPC_DTPREL:                  howto manager.      (line  730)
13793* BFD_RELOC_PPC_DTPREL16:                howto manager.      (line  726)
13794* BFD_RELOC_PPC_DTPREL16_HA:             howto manager.      (line  729)
13795* BFD_RELOC_PPC_DTPREL16_HI:             howto manager.      (line  728)
13796* BFD_RELOC_PPC_DTPREL16_LO:             howto manager.      (line  727)
13797* BFD_RELOC_PPC_EMB_BIT_FLD:             howto manager.      (line  638)
13798* BFD_RELOC_PPC_EMB_MRKREF:              howto manager.      (line  633)
13799* BFD_RELOC_PPC_EMB_NADDR16:             howto manager.      (line  625)
13800* BFD_RELOC_PPC_EMB_NADDR16_HA:          howto manager.      (line  628)
13801* BFD_RELOC_PPC_EMB_NADDR16_HI:          howto manager.      (line  627)
13802* BFD_RELOC_PPC_EMB_NADDR16_LO:          howto manager.      (line  626)
13803* BFD_RELOC_PPC_EMB_NADDR32:             howto manager.      (line  624)
13804* BFD_RELOC_PPC_EMB_RELSDA:              howto manager.      (line  639)
13805* BFD_RELOC_PPC_EMB_RELSEC16:            howto manager.      (line  634)
13806* BFD_RELOC_PPC_EMB_RELST_HA:            howto manager.      (line  637)
13807* BFD_RELOC_PPC_EMB_RELST_HI:            howto manager.      (line  636)
13808* BFD_RELOC_PPC_EMB_RELST_LO:            howto manager.      (line  635)
13809* BFD_RELOC_PPC_EMB_SDA21:               howto manager.      (line  632)
13810* BFD_RELOC_PPC_EMB_SDA2I16:             howto manager.      (line  630)
13811* BFD_RELOC_PPC_EMB_SDA2REL:             howto manager.      (line  631)
13812* BFD_RELOC_PPC_EMB_SDAI16:              howto manager.      (line  629)
13813* BFD_RELOC_PPC_GLOB_DAT:                howto manager.      (line  620)
13814* BFD_RELOC_PPC_GOT_DTPREL16:            howto manager.      (line  743)
13815* BFD_RELOC_PPC_GOT_DTPREL16_HA:         howto manager.      (line  746)
13816* BFD_RELOC_PPC_GOT_DTPREL16_HI:         howto manager.      (line  745)
13817* BFD_RELOC_PPC_GOT_DTPREL16_LO:         howto manager.      (line  744)
13818* BFD_RELOC_PPC_GOT_TLSGD16:             howto manager.      (line  731)
13819* BFD_RELOC_PPC_GOT_TLSGD16_HA:          howto manager.      (line  734)
13820* BFD_RELOC_PPC_GOT_TLSGD16_HI:          howto manager.      (line  733)
13821* BFD_RELOC_PPC_GOT_TLSGD16_LO:          howto manager.      (line  732)
13822* BFD_RELOC_PPC_GOT_TLSLD16:             howto manager.      (line  735)
13823* BFD_RELOC_PPC_GOT_TLSLD16_HA:          howto manager.      (line  738)
13824* BFD_RELOC_PPC_GOT_TLSLD16_HI:          howto manager.      (line  737)
13825* BFD_RELOC_PPC_GOT_TLSLD16_LO:          howto manager.      (line  736)
13826* BFD_RELOC_PPC_GOT_TPREL16:             howto manager.      (line  739)
13827* BFD_RELOC_PPC_GOT_TPREL16_HA:          howto manager.      (line  742)
13828* BFD_RELOC_PPC_GOT_TPREL16_HI:          howto manager.      (line  741)
13829* BFD_RELOC_PPC_GOT_TPREL16_LO:          howto manager.      (line  740)
13830* BFD_RELOC_PPC_JMP_SLOT:                howto manager.      (line  621)
13831* BFD_RELOC_PPC_LOCAL24PC:               howto manager.      (line  623)
13832* BFD_RELOC_PPC_NEG:                     howto manager.      (line  659)
13833* BFD_RELOC_PPC_REL16DX_HA:              howto manager.      (line  658)
13834* BFD_RELOC_PPC_RELATIVE:                howto manager.      (line  622)
13835* BFD_RELOC_PPC_TLS:                     howto manager.      (line  713)
13836* BFD_RELOC_PPC_TLSGD:                   howto manager.      (line  714)
13837* BFD_RELOC_PPC_TLSIE:                   howto manager.      (line  717)
13838* BFD_RELOC_PPC_TLSLD:                   howto manager.      (line  715)
13839* BFD_RELOC_PPC_TLSLE:                   howto manager.      (line  716)
13840* BFD_RELOC_PPC_TLSM:                    howto manager.      (line  718)
13841* BFD_RELOC_PPC_TLSML:                   howto manager.      (line  719)
13842* BFD_RELOC_PPC_TOC16:                   howto manager.      (line  610)
13843* BFD_RELOC_PPC_TOC16_HI:                howto manager.      (line  612)
13844* BFD_RELOC_PPC_TOC16_LO:                howto manager.      (line  611)
13845* BFD_RELOC_PPC_TPREL:                   howto manager.      (line  725)
13846* BFD_RELOC_PPC_TPREL16:                 howto manager.      (line  721)
13847* BFD_RELOC_PPC_TPREL16_HA:              howto manager.      (line  724)
13848* BFD_RELOC_PPC_TPREL16_HI:              howto manager.      (line  723)
13849* BFD_RELOC_PPC_TPREL16_LO:              howto manager.      (line  722)
13850* BFD_RELOC_PPC_VLE_HA16A:               howto manager.      (line  647)
13851* BFD_RELOC_PPC_VLE_HA16D:               howto manager.      (line  648)
13852* BFD_RELOC_PPC_VLE_HI16A:               howto manager.      (line  645)
13853* BFD_RELOC_PPC_VLE_HI16D:               howto manager.      (line  646)
13854* BFD_RELOC_PPC_VLE_LO16A:               howto manager.      (line  643)
13855* BFD_RELOC_PPC_VLE_LO16D:               howto manager.      (line  644)
13856* BFD_RELOC_PPC_VLE_REL15:               howto manager.      (line  641)
13857* BFD_RELOC_PPC_VLE_REL24:               howto manager.      (line  642)
13858* BFD_RELOC_PPC_VLE_REL8:                howto manager.      (line  640)
13859* BFD_RELOC_PPC_VLE_SDA21:               howto manager.      (line  649)
13860* BFD_RELOC_PPC_VLE_SDA21_LO:            howto manager.      (line  650)
13861* BFD_RELOC_PPC_VLE_SDAREL_HA16A:        howto manager.      (line  655)
13862* BFD_RELOC_PPC_VLE_SDAREL_HA16D:        howto manager.      (line  656)
13863* BFD_RELOC_PPC_VLE_SDAREL_HI16A:        howto manager.      (line  653)
13864* BFD_RELOC_PPC_VLE_SDAREL_HI16D:        howto manager.      (line  654)
13865* BFD_RELOC_PPC_VLE_SDAREL_LO16A:        howto manager.      (line  651)
13866* BFD_RELOC_PPC_VLE_SDAREL_LO16D:        howto manager.      (line  652)
13867* BFD_RELOC_PRU_16_PMEM:                 howto manager.      (line 2546)
13868* BFD_RELOC_PRU_32_PMEM:                 howto manager.      (line 2545)
13869* BFD_RELOC_PRU_GNU_DIFF16:              howto manager.      (line 2550)
13870* BFD_RELOC_PRU_GNU_DIFF16_PMEM:         howto manager.      (line 2552)
13871* BFD_RELOC_PRU_GNU_DIFF32:              howto manager.      (line 2551)
13872* BFD_RELOC_PRU_GNU_DIFF32_PMEM:         howto manager.      (line 2553)
13873* BFD_RELOC_PRU_GNU_DIFF8:               howto manager.      (line 2549)
13874* BFD_RELOC_PRU_LDI32:                   howto manager.      (line 2537)
13875* BFD_RELOC_PRU_S10_PCREL:               howto manager.      (line 2541)
13876* BFD_RELOC_PRU_U16:                     howto manager.      (line 2533)
13877* BFD_RELOC_PRU_U16_PMEMIMM:             howto manager.      (line 2535)
13878* BFD_RELOC_PRU_U8_PCREL:                howto manager.      (line 2543)
13879* BFD_RELOC_RELC:                        howto manager.      (line 2437)
13880* BFD_RELOC_RISCV_32_PCREL:              howto manager.      (line 1905)
13881* BFD_RELOC_RISCV_ADD16:                 howto manager.      (line 1873)
13882* BFD_RELOC_RISCV_ADD32:                 howto manager.      (line 1874)
13883* BFD_RELOC_RISCV_ADD64:                 howto manager.      (line 1875)
13884* BFD_RELOC_RISCV_ADD8:                  howto manager.      (line 1872)
13885* BFD_RELOC_RISCV_ALIGN:                 howto manager.      (line 1890)
13886* BFD_RELOC_RISCV_CALL:                  howto manager.      (line 1870)
13887* BFD_RELOC_RISCV_CALL_PLT:              howto manager.      (line 1871)
13888* BFD_RELOC_RISCV_CFA:                   howto manager.      (line 1899)
13889* BFD_RELOC_RISCV_GOT_HI20:              howto manager.      (line 1880)
13890* BFD_RELOC_RISCV_GPREL12_I:             howto manager.      (line 1864)
13891* BFD_RELOC_RISCV_GPREL12_S:             howto manager.      (line 1865)
13892* BFD_RELOC_RISCV_GPREL_I:               howto manager.      (line 1894)
13893* BFD_RELOC_RISCV_GPREL_S:               howto manager.      (line 1895)
13894* BFD_RELOC_RISCV_HI20:                  howto manager.      (line 1858)
13895* BFD_RELOC_RISCV_JMP:                   howto manager.      (line 1883)
13896* BFD_RELOC_RISCV_LO12_I:                howto manager.      (line 1862)
13897* BFD_RELOC_RISCV_LO12_S:                howto manager.      (line 1863)
13898* BFD_RELOC_RISCV_PCREL_HI20:            howto manager.      (line 1859)
13899* BFD_RELOC_RISCV_PCREL_LO12_I:          howto manager.      (line 1860)
13900* BFD_RELOC_RISCV_PCREL_LO12_S:          howto manager.      (line 1861)
13901* BFD_RELOC_RISCV_RELAX:                 howto manager.      (line 1898)
13902* BFD_RELOC_RISCV_RVC_BRANCH:            howto manager.      (line 1891)
13903* BFD_RELOC_RISCV_RVC_JUMP:              howto manager.      (line 1892)
13904* BFD_RELOC_RISCV_RVC_LUI:               howto manager.      (line 1893)
13905* BFD_RELOC_RISCV_SET16:                 howto manager.      (line 1903)
13906* BFD_RELOC_RISCV_SET32:                 howto manager.      (line 1904)
13907* BFD_RELOC_RISCV_SET6:                  howto manager.      (line 1901)
13908* BFD_RELOC_RISCV_SET8:                  howto manager.      (line 1902)
13909* BFD_RELOC_RISCV_SUB16:                 howto manager.      (line 1877)
13910* BFD_RELOC_RISCV_SUB32:                 howto manager.      (line 1878)
13911* BFD_RELOC_RISCV_SUB6:                  howto manager.      (line 1900)
13912* BFD_RELOC_RISCV_SUB64:                 howto manager.      (line 1879)
13913* BFD_RELOC_RISCV_SUB8:                  howto manager.      (line 1876)
13914* BFD_RELOC_RISCV_TLS_DTPMOD32:          howto manager.      (line 1884)
13915* BFD_RELOC_RISCV_TLS_DTPMOD64:          howto manager.      (line 1886)
13916* BFD_RELOC_RISCV_TLS_DTPREL32:          howto manager.      (line 1885)
13917* BFD_RELOC_RISCV_TLS_DTPREL64:          howto manager.      (line 1887)
13918* BFD_RELOC_RISCV_TLS_GD_HI20:           howto manager.      (line 1882)
13919* BFD_RELOC_RISCV_TLS_GOT_HI20:          howto manager.      (line 1881)
13920* BFD_RELOC_RISCV_TLS_TPREL32:           howto manager.      (line 1888)
13921* BFD_RELOC_RISCV_TLS_TPREL64:           howto manager.      (line 1889)
13922* BFD_RELOC_RISCV_TPREL_ADD:             howto manager.      (line 1869)
13923* BFD_RELOC_RISCV_TPREL_HI20:            howto manager.      (line 1866)
13924* BFD_RELOC_RISCV_TPREL_I:               howto manager.      (line 1896)
13925* BFD_RELOC_RISCV_TPREL_LO12_I:          howto manager.      (line 1867)
13926* BFD_RELOC_RISCV_TPREL_LO12_S:          howto manager.      (line 1868)
13927* BFD_RELOC_RISCV_TPREL_S:               howto manager.      (line 1897)
13928* BFD_RELOC_RL78_16U:                    howto manager.      (line 1915)
13929* BFD_RELOC_RL78_16_OP:                  howto manager.      (line 1911)
13930* BFD_RELOC_RL78_24U:                    howto manager.      (line 1916)
13931* BFD_RELOC_RL78_24_OP:                  howto manager.      (line 1912)
13932* BFD_RELOC_RL78_32_OP:                  howto manager.      (line 1913)
13933* BFD_RELOC_RL78_8U:                     howto manager.      (line 1914)
13934* BFD_RELOC_RL78_ABS16:                  howto manager.      (line 1928)
13935* BFD_RELOC_RL78_ABS16U:                 howto manager.      (line 1932)
13936* BFD_RELOC_RL78_ABS16UL:                howto manager.      (line 1934)
13937* BFD_RELOC_RL78_ABS16UW:                howto manager.      (line 1933)
13938* BFD_RELOC_RL78_ABS16_REV:              howto manager.      (line 1929)
13939* BFD_RELOC_RL78_ABS32:                  howto manager.      (line 1930)
13940* BFD_RELOC_RL78_ABS32_REV:              howto manager.      (line 1931)
13941* BFD_RELOC_RL78_ABS8:                   howto manager.      (line 1927)
13942* BFD_RELOC_RL78_CODE:                   howto manager.      (line 1939)
13943* BFD_RELOC_RL78_DIFF:                   howto manager.      (line 1918)
13944* BFD_RELOC_RL78_DIR3U_PCREL:            howto manager.      (line 1917)
13945* BFD_RELOC_RL78_GPRELB:                 howto manager.      (line 1919)
13946* BFD_RELOC_RL78_GPRELL:                 howto manager.      (line 1921)
13947* BFD_RELOC_RL78_GPRELW:                 howto manager.      (line 1920)
13948* BFD_RELOC_RL78_HI16:                   howto manager.      (line 1936)
13949* BFD_RELOC_RL78_HI8:                    howto manager.      (line 1937)
13950* BFD_RELOC_RL78_LO16:                   howto manager.      (line 1938)
13951* BFD_RELOC_RL78_NEG16:                  howto manager.      (line 1908)
13952* BFD_RELOC_RL78_NEG24:                  howto manager.      (line 1909)
13953* BFD_RELOC_RL78_NEG32:                  howto manager.      (line 1910)
13954* BFD_RELOC_RL78_NEG8:                   howto manager.      (line 1907)
13955* BFD_RELOC_RL78_OP_AND:                 howto manager.      (line 1925)
13956* BFD_RELOC_RL78_OP_NEG:                 howto manager.      (line 1924)
13957* BFD_RELOC_RL78_OP_SHRA:                howto manager.      (line 1926)
13958* BFD_RELOC_RL78_OP_SUBTRACT:            howto manager.      (line 1923)
13959* BFD_RELOC_RL78_RELAX:                  howto manager.      (line 1935)
13960* BFD_RELOC_RL78_SADDR:                  howto manager.      (line 1940)
13961* BFD_RELOC_RL78_SYM:                    howto manager.      (line 1922)
13962* BFD_RELOC_RVA:                         howto manager.      (line  101)
13963* BFD_RELOC_RX_16U:                      howto manager.      (line 1950)
13964* BFD_RELOC_RX_16_OP:                    howto manager.      (line 1946)
13965* BFD_RELOC_RX_24U:                      howto manager.      (line 1951)
13966* BFD_RELOC_RX_24_OP:                    howto manager.      (line 1947)
13967* BFD_RELOC_RX_32_OP:                    howto manager.      (line 1948)
13968* BFD_RELOC_RX_8U:                       howto manager.      (line 1949)
13969* BFD_RELOC_RX_ABS16:                    howto manager.      (line 1961)
13970* BFD_RELOC_RX_ABS16U:                   howto manager.      (line 1965)
13971* BFD_RELOC_RX_ABS16UL:                  howto manager.      (line 1967)
13972* BFD_RELOC_RX_ABS16UW:                  howto manager.      (line 1966)
13973* BFD_RELOC_RX_ABS16_REV:                howto manager.      (line 1962)
13974* BFD_RELOC_RX_ABS32:                    howto manager.      (line 1963)
13975* BFD_RELOC_RX_ABS32_REV:                howto manager.      (line 1964)
13976* BFD_RELOC_RX_ABS8:                     howto manager.      (line 1960)
13977* BFD_RELOC_RX_DIFF:                     howto manager.      (line 1953)
13978* BFD_RELOC_RX_DIR3U_PCREL:              howto manager.      (line 1952)
13979* BFD_RELOC_RX_GPRELB:                   howto manager.      (line 1954)
13980* BFD_RELOC_RX_GPRELL:                   howto manager.      (line 1956)
13981* BFD_RELOC_RX_GPRELW:                   howto manager.      (line 1955)
13982* BFD_RELOC_RX_NEG16:                    howto manager.      (line 1943)
13983* BFD_RELOC_RX_NEG24:                    howto manager.      (line 1944)
13984* BFD_RELOC_RX_NEG32:                    howto manager.      (line 1945)
13985* BFD_RELOC_RX_NEG8:                     howto manager.      (line 1942)
13986* BFD_RELOC_RX_OP_NEG:                   howto manager.      (line 1959)
13987* BFD_RELOC_RX_OP_SUBTRACT:              howto manager.      (line 1958)
13988* BFD_RELOC_RX_RELAX:                    howto manager.      (line 1968)
13989* BFD_RELOC_RX_SYM:                      howto manager.      (line 1957)
13990* BFD_RELOC_S12Z_15_PCREL:               howto manager.      (line 2280)
13991* BFD_RELOC_S12Z_OPR:                    howto manager.      (line 3452)
13992* BFD_RELOC_SCORE16_BRANCH:              howto manager.      (line 2071)
13993* BFD_RELOC_SCORE16_JMP:                 howto manager.      (line 2069)
13994* BFD_RELOC_SCORE_BCMP:                  howto manager.      (line 2073)
13995* BFD_RELOC_SCORE_BRANCH:                howto manager.      (line 2063)
13996* BFD_RELOC_SCORE_CALL15:                howto manager.      (line 2077)
13997* BFD_RELOC_SCORE_DUMMY2:                howto manager.      (line 2060)
13998* BFD_RELOC_SCORE_DUMMY_HI16:            howto manager.      (line 2078)
13999* BFD_RELOC_SCORE_GOT15:                 howto manager.      (line 2075)
14000* BFD_RELOC_SCORE_GOT_LO16:              howto manager.      (line 2076)
14001* BFD_RELOC_SCORE_GPREL15:               howto manager.      (line 2058)
14002* BFD_RELOC_SCORE_IMM30:                 howto manager.      (line 2065)
14003* BFD_RELOC_SCORE_IMM32:                 howto manager.      (line 2067)
14004* BFD_RELOC_SCORE_JMP:                   howto manager.      (line 2061)
14005* BFD_RELOC_SH_ALIGN:                    howto manager.      (line  972)
14006* BFD_RELOC_SH_CODE:                     howto manager.      (line  973)
14007* BFD_RELOC_SH_COPY:                     howto manager.      (line  978)
14008* BFD_RELOC_SH_COPY64:                   howto manager.      (line 1003)
14009* BFD_RELOC_SH_COUNT:                    howto manager.      (line  971)
14010* BFD_RELOC_SH_DATA:                     howto manager.      (line  974)
14011* BFD_RELOC_SH_DISP12:                   howto manager.      (line  954)
14012* BFD_RELOC_SH_DISP12BY2:                howto manager.      (line  955)
14013* BFD_RELOC_SH_DISP12BY4:                howto manager.      (line  956)
14014* BFD_RELOC_SH_DISP12BY8:                howto manager.      (line  957)
14015* BFD_RELOC_SH_DISP20:                   howto manager.      (line  958)
14016* BFD_RELOC_SH_DISP20BY8:                howto manager.      (line  959)
14017* BFD_RELOC_SH_FUNCDESC:                 howto manager.      (line 1046)
14018* BFD_RELOC_SH_GLOB_DAT:                 howto manager.      (line  979)
14019* BFD_RELOC_SH_GLOB_DAT64:               howto manager.      (line 1004)
14020* BFD_RELOC_SH_GOT10BY4:                 howto manager.      (line 1007)
14021* BFD_RELOC_SH_GOT10BY8:                 howto manager.      (line 1008)
14022* BFD_RELOC_SH_GOT20:                    howto manager.      (line 1040)
14023* BFD_RELOC_SH_GOTFUNCDESC:              howto manager.      (line 1042)
14024* BFD_RELOC_SH_GOTFUNCDESC20:            howto manager.      (line 1043)
14025* BFD_RELOC_SH_GOTOFF20:                 howto manager.      (line 1041)
14026* BFD_RELOC_SH_GOTOFFFUNCDESC:           howto manager.      (line 1044)
14027* BFD_RELOC_SH_GOTOFFFUNCDESC20:         howto manager.      (line 1045)
14028* BFD_RELOC_SH_GOTOFF_HI16:              howto manager.      (line  998)
14029* BFD_RELOC_SH_GOTOFF_LOW16:             howto manager.      (line  995)
14030* BFD_RELOC_SH_GOTOFF_MEDHI16:           howto manager.      (line  997)
14031* BFD_RELOC_SH_GOTOFF_MEDLOW16:          howto manager.      (line  996)
14032* BFD_RELOC_SH_GOTPC:                    howto manager.      (line  982)
14033* BFD_RELOC_SH_GOTPC_HI16:               howto manager.      (line 1002)
14034* BFD_RELOC_SH_GOTPC_LOW16:              howto manager.      (line  999)
14035* BFD_RELOC_SH_GOTPC_MEDHI16:            howto manager.      (line 1001)
14036* BFD_RELOC_SH_GOTPC_MEDLOW16:           howto manager.      (line 1000)
14037* BFD_RELOC_SH_GOTPLT10BY4:              howto manager.      (line 1009)
14038* BFD_RELOC_SH_GOTPLT10BY8:              howto manager.      (line 1010)
14039* BFD_RELOC_SH_GOTPLT32:                 howto manager.      (line 1011)
14040* BFD_RELOC_SH_GOTPLT_HI16:              howto manager.      (line  990)
14041* BFD_RELOC_SH_GOTPLT_LOW16:             howto manager.      (line  987)
14042* BFD_RELOC_SH_GOTPLT_MEDHI16:           howto manager.      (line  989)
14043* BFD_RELOC_SH_GOTPLT_MEDLOW16:          howto manager.      (line  988)
14044* BFD_RELOC_SH_GOT_HI16:                 howto manager.      (line  986)
14045* BFD_RELOC_SH_GOT_LOW16:                howto manager.      (line  983)
14046* BFD_RELOC_SH_GOT_MEDHI16:              howto manager.      (line  985)
14047* BFD_RELOC_SH_GOT_MEDLOW16:             howto manager.      (line  984)
14048* BFD_RELOC_SH_IMM3:                     howto manager.      (line  952)
14049* BFD_RELOC_SH_IMM3U:                    howto manager.      (line  953)
14050* BFD_RELOC_SH_IMM4:                     howto manager.      (line  960)
14051* BFD_RELOC_SH_IMM4BY2:                  howto manager.      (line  961)
14052* BFD_RELOC_SH_IMM4BY4:                  howto manager.      (line  962)
14053* BFD_RELOC_SH_IMM8:                     howto manager.      (line  963)
14054* BFD_RELOC_SH_IMM8BY2:                  howto manager.      (line  964)
14055* BFD_RELOC_SH_IMM8BY4:                  howto manager.      (line  965)
14056* BFD_RELOC_SH_IMMS10:                   howto manager.      (line 1017)
14057* BFD_RELOC_SH_IMMS10BY2:                howto manager.      (line 1018)
14058* BFD_RELOC_SH_IMMS10BY4:                howto manager.      (line 1019)
14059* BFD_RELOC_SH_IMMS10BY8:                howto manager.      (line 1020)
14060* BFD_RELOC_SH_IMMS16:                   howto manager.      (line 1021)
14061* BFD_RELOC_SH_IMMS6:                    howto manager.      (line 1014)
14062* BFD_RELOC_SH_IMMS6BY32:                howto manager.      (line 1015)
14063* BFD_RELOC_SH_IMMU16:                   howto manager.      (line 1022)
14064* BFD_RELOC_SH_IMMU5:                    howto manager.      (line 1013)
14065* BFD_RELOC_SH_IMMU6:                    howto manager.      (line 1016)
14066* BFD_RELOC_SH_IMM_HI16:                 howto manager.      (line 1029)
14067* BFD_RELOC_SH_IMM_HI16_PCREL:           howto manager.      (line 1030)
14068* BFD_RELOC_SH_IMM_LOW16:                howto manager.      (line 1023)
14069* BFD_RELOC_SH_IMM_LOW16_PCREL:          howto manager.      (line 1024)
14070* BFD_RELOC_SH_IMM_MEDHI16:              howto manager.      (line 1027)
14071* BFD_RELOC_SH_IMM_MEDHI16_PCREL:        howto manager.      (line 1028)
14072* BFD_RELOC_SH_IMM_MEDLOW16:             howto manager.      (line 1025)
14073* BFD_RELOC_SH_IMM_MEDLOW16_PCREL:       howto manager.      (line 1026)
14074* BFD_RELOC_SH_JMP_SLOT:                 howto manager.      (line  980)
14075* BFD_RELOC_SH_JMP_SLOT64:               howto manager.      (line 1005)
14076* BFD_RELOC_SH_LABEL:                    howto manager.      (line  975)
14077* BFD_RELOC_SH_LOOP_END:                 howto manager.      (line  977)
14078* BFD_RELOC_SH_LOOP_START:               howto manager.      (line  976)
14079* BFD_RELOC_SH_PCDISP12BY2:              howto manager.      (line  951)
14080* BFD_RELOC_SH_PCDISP8BY2:               howto manager.      (line  950)
14081* BFD_RELOC_SH_PCRELIMM8BY2:             howto manager.      (line  966)
14082* BFD_RELOC_SH_PCRELIMM8BY4:             howto manager.      (line  967)
14083* BFD_RELOC_SH_PLT_HI16:                 howto manager.      (line  994)
14084* BFD_RELOC_SH_PLT_LOW16:                howto manager.      (line  991)
14085* BFD_RELOC_SH_PLT_MEDHI16:              howto manager.      (line  993)
14086* BFD_RELOC_SH_PLT_MEDLOW16:             howto manager.      (line  992)
14087* BFD_RELOC_SH_PT_16:                    howto manager.      (line 1031)
14088* BFD_RELOC_SH_RELATIVE:                 howto manager.      (line  981)
14089* BFD_RELOC_SH_RELATIVE64:               howto manager.      (line 1006)
14090* BFD_RELOC_SH_SHMEDIA_CODE:             howto manager.      (line 1012)
14091* BFD_RELOC_SH_SWITCH16:                 howto manager.      (line  968)
14092* BFD_RELOC_SH_SWITCH32:                 howto manager.      (line  969)
14093* BFD_RELOC_SH_TLS_DTPMOD32:             howto manager.      (line 1037)
14094* BFD_RELOC_SH_TLS_DTPOFF32:             howto manager.      (line 1038)
14095* BFD_RELOC_SH_TLS_GD_32:                howto manager.      (line 1032)
14096* BFD_RELOC_SH_TLS_IE_32:                howto manager.      (line 1035)
14097* BFD_RELOC_SH_TLS_LDO_32:               howto manager.      (line 1034)
14098* BFD_RELOC_SH_TLS_LD_32:                howto manager.      (line 1033)
14099* BFD_RELOC_SH_TLS_LE_32:                howto manager.      (line 1036)
14100* BFD_RELOC_SH_TLS_TPOFF32:              howto manager.      (line 1039)
14101* BFD_RELOC_SH_USES:                     howto manager.      (line  970)
14102* BFD_RELOC_SIZE32:                      howto manager.      (line   68)
14103* BFD_RELOC_SIZE64:                      howto manager.      (line   69)
14104* BFD_RELOC_SPARC13:                     howto manager.      (line  127)
14105* BFD_RELOC_SPARC22:                     howto manager.      (line  126)
14106* BFD_RELOC_SPARC_10:                    howto manager.      (line  154)
14107* BFD_RELOC_SPARC_11:                    howto manager.      (line  155)
14108* BFD_RELOC_SPARC_5:                     howto manager.      (line  167)
14109* BFD_RELOC_SPARC_6:                     howto manager.      (line  166)
14110* BFD_RELOC_SPARC_64:                    howto manager.      (line  153)
14111* BFD_RELOC_SPARC_7:                     howto manager.      (line  165)
14112* BFD_RELOC_SPARC_BASE13:                howto manager.      (line  150)
14113* BFD_RELOC_SPARC_BASE22:                howto manager.      (line  151)
14114* BFD_RELOC_SPARC_COPY:                  howto manager.      (line  134)
14115* BFD_RELOC_SPARC_DISP64:                howto manager.      (line  168)
14116* BFD_RELOC_SPARC_GLOB_DAT:              howto manager.      (line  135)
14117* BFD_RELOC_SPARC_GOT10:                 howto manager.      (line  128)
14118* BFD_RELOC_SPARC_GOT13:                 howto manager.      (line  129)
14119* BFD_RELOC_SPARC_GOT22:                 howto manager.      (line  130)
14120* BFD_RELOC_SPARC_GOTDATA_HIX22:         howto manager.      (line  141)
14121* BFD_RELOC_SPARC_GOTDATA_LOX10:         howto manager.      (line  142)
14122* BFD_RELOC_SPARC_GOTDATA_OP:            howto manager.      (line  145)
14123* BFD_RELOC_SPARC_GOTDATA_OP_HIX22:      howto manager.      (line  143)
14124* BFD_RELOC_SPARC_GOTDATA_OP_LOX10:      howto manager.      (line  144)
14125* BFD_RELOC_SPARC_H34:                   howto manager.      (line  177)
14126* BFD_RELOC_SPARC_H44:                   howto manager.      (line  173)
14127* BFD_RELOC_SPARC_HH22:                  howto manager.      (line  157)
14128* BFD_RELOC_SPARC_HIX22:                 howto manager.      (line  171)
14129* BFD_RELOC_SPARC_HM10:                  howto manager.      (line  158)
14130* BFD_RELOC_SPARC_IRELATIVE:             howto manager.      (line  147)
14131* BFD_RELOC_SPARC_JMP_IREL:              howto manager.      (line  146)
14132* BFD_RELOC_SPARC_JMP_SLOT:              howto manager.      (line  136)
14133* BFD_RELOC_SPARC_L44:                   howto manager.      (line  175)
14134* BFD_RELOC_SPARC_LM22:                  howto manager.      (line  159)
14135* BFD_RELOC_SPARC_LOX10:                 howto manager.      (line  172)
14136* BFD_RELOC_SPARC_M44:                   howto manager.      (line  174)
14137* BFD_RELOC_SPARC_OLO10:                 howto manager.      (line  156)
14138* BFD_RELOC_SPARC_PC10:                  howto manager.      (line  131)
14139* BFD_RELOC_SPARC_PC22:                  howto manager.      (line  132)
14140* BFD_RELOC_SPARC_PC_HH22:               howto manager.      (line  160)
14141* BFD_RELOC_SPARC_PC_HM10:               howto manager.      (line  161)
14142* BFD_RELOC_SPARC_PC_LM22:               howto manager.      (line  162)
14143* BFD_RELOC_SPARC_PLT32:                 howto manager.      (line  169)
14144* BFD_RELOC_SPARC_PLT64:                 howto manager.      (line  170)
14145* BFD_RELOC_SPARC_REGISTER:              howto manager.      (line  176)
14146* BFD_RELOC_SPARC_RELATIVE:              howto manager.      (line  137)
14147* BFD_RELOC_SPARC_REV32:                 howto manager.      (line  182)
14148* BFD_RELOC_SPARC_SIZE32:                howto manager.      (line  178)
14149* BFD_RELOC_SPARC_SIZE64:                howto manager.      (line  179)
14150* BFD_RELOC_SPARC_TLS_DTPMOD32:          howto manager.      (line  202)
14151* BFD_RELOC_SPARC_TLS_DTPMOD64:          howto manager.      (line  203)
14152* BFD_RELOC_SPARC_TLS_DTPOFF32:          howto manager.      (line  204)
14153* BFD_RELOC_SPARC_TLS_DTPOFF64:          howto manager.      (line  205)
14154* BFD_RELOC_SPARC_TLS_GD_ADD:            howto manager.      (line  186)
14155* BFD_RELOC_SPARC_TLS_GD_CALL:           howto manager.      (line  187)
14156* BFD_RELOC_SPARC_TLS_GD_HI22:           howto manager.      (line  184)
14157* BFD_RELOC_SPARC_TLS_GD_LO10:           howto manager.      (line  185)
14158* BFD_RELOC_SPARC_TLS_IE_ADD:            howto manager.      (line  199)
14159* BFD_RELOC_SPARC_TLS_IE_HI22:           howto manager.      (line  195)
14160* BFD_RELOC_SPARC_TLS_IE_LD:             howto manager.      (line  197)
14161* BFD_RELOC_SPARC_TLS_IE_LDX:            howto manager.      (line  198)
14162* BFD_RELOC_SPARC_TLS_IE_LO10:           howto manager.      (line  196)
14163* BFD_RELOC_SPARC_TLS_LDM_ADD:           howto manager.      (line  190)
14164* BFD_RELOC_SPARC_TLS_LDM_CALL:          howto manager.      (line  191)
14165* BFD_RELOC_SPARC_TLS_LDM_HI22:          howto manager.      (line  188)
14166* BFD_RELOC_SPARC_TLS_LDM_LO10:          howto manager.      (line  189)
14167* BFD_RELOC_SPARC_TLS_LDO_ADD:           howto manager.      (line  194)
14168* BFD_RELOC_SPARC_TLS_LDO_HIX22:         howto manager.      (line  192)
14169* BFD_RELOC_SPARC_TLS_LDO_LOX10:         howto manager.      (line  193)
14170* BFD_RELOC_SPARC_TLS_LE_HIX22:          howto manager.      (line  200)
14171* BFD_RELOC_SPARC_TLS_LE_LOX10:          howto manager.      (line  201)
14172* BFD_RELOC_SPARC_TLS_TPOFF32:           howto manager.      (line  206)
14173* BFD_RELOC_SPARC_TLS_TPOFF64:           howto manager.      (line  207)
14174* BFD_RELOC_SPARC_UA16:                  howto manager.      (line  138)
14175* BFD_RELOC_SPARC_UA32:                  howto manager.      (line  139)
14176* BFD_RELOC_SPARC_UA64:                  howto manager.      (line  140)
14177* BFD_RELOC_SPARC_WDISP10:               howto manager.      (line  180)
14178* BFD_RELOC_SPARC_WDISP16:               howto manager.      (line  163)
14179* BFD_RELOC_SPARC_WDISP19:               howto manager.      (line  164)
14180* BFD_RELOC_SPARC_WDISP22:               howto manager.      (line  125)
14181* BFD_RELOC_SPARC_WPLT30:                howto manager.      (line  133)
14182* BFD_RELOC_SPU_ADD_PIC:                 howto manager.      (line  223)
14183* BFD_RELOC_SPU_HI16:                    howto manager.      (line  220)
14184* BFD_RELOC_SPU_IMM10:                   howto manager.      (line  211)
14185* BFD_RELOC_SPU_IMM10W:                  howto manager.      (line  212)
14186* BFD_RELOC_SPU_IMM16:                   howto manager.      (line  213)
14187* BFD_RELOC_SPU_IMM16W:                  howto manager.      (line  214)
14188* BFD_RELOC_SPU_IMM18:                   howto manager.      (line  215)
14189* BFD_RELOC_SPU_IMM7:                    howto manager.      (line  209)
14190* BFD_RELOC_SPU_IMM8:                    howto manager.      (line  210)
14191* BFD_RELOC_SPU_LO16:                    howto manager.      (line  219)
14192* BFD_RELOC_SPU_PCREL16:                 howto manager.      (line  218)
14193* BFD_RELOC_SPU_PCREL9a:                 howto manager.      (line  216)
14194* BFD_RELOC_SPU_PCREL9b:                 howto manager.      (line  217)
14195* BFD_RELOC_SPU_PPU32:                   howto manager.      (line  221)
14196* BFD_RELOC_SPU_PPU64:                   howto manager.      (line  222)
14197* BFD_RELOC_THUMB_PCREL_BFCSEL:          howto manager.      (line  802)
14198* BFD_RELOC_THUMB_PCREL_BLX:             howto manager.      (line  791)
14199* BFD_RELOC_THUMB_PCREL_BRANCH12:        howto manager.      (line  814)
14200* BFD_RELOC_THUMB_PCREL_BRANCH20:        howto manager.      (line  815)
14201* BFD_RELOC_THUMB_PCREL_BRANCH23:        howto manager.      (line  816)
14202* BFD_RELOC_THUMB_PCREL_BRANCH25:        howto manager.      (line  817)
14203* BFD_RELOC_THUMB_PCREL_BRANCH5:         howto manager.      (line  800)
14204* BFD_RELOC_THUMB_PCREL_BRANCH7:         howto manager.      (line  812)
14205* BFD_RELOC_THUMB_PCREL_BRANCH9:         howto manager.      (line  813)
14206* BFD_RELOC_TIC30_LDP:                   howto manager.      (line 1569)
14207* BFD_RELOC_TIC54X_16_OF_23:             howto manager.      (line 1583)
14208* BFD_RELOC_TIC54X_23:                   howto manager.      (line 1581)
14209* BFD_RELOC_TIC54X_MS7_OF_23:            howto manager.      (line 1587)
14210* BFD_RELOC_TIC54X_PARTLS7:              howto manager.      (line 1573)
14211* BFD_RELOC_TIC54X_PARTMS9:              howto manager.      (line 1577)
14212* BFD_RELOC_TILEGX_BROFF_X1:             howto manager.      (line 3247)
14213* BFD_RELOC_TILEGX_COPY:                 howto manager.      (line 3243)
14214* BFD_RELOC_TILEGX_DEST_IMM8_X1:         howto manager.      (line 3254)
14215* BFD_RELOC_TILEGX_GLOB_DAT:             howto manager.      (line 3244)
14216* BFD_RELOC_TILEGX_HW0:                  howto manager.      (line 3236)
14217* BFD_RELOC_TILEGX_HW0_LAST:             howto manager.      (line 3240)
14218* BFD_RELOC_TILEGX_HW1:                  howto manager.      (line 3237)
14219* BFD_RELOC_TILEGX_HW1_LAST:             howto manager.      (line 3241)
14220* BFD_RELOC_TILEGX_HW2:                  howto manager.      (line 3238)
14221* BFD_RELOC_TILEGX_HW2_LAST:             howto manager.      (line 3242)
14222* BFD_RELOC_TILEGX_HW3:                  howto manager.      (line 3239)
14223* BFD_RELOC_TILEGX_IMM16_X0_HW0:         howto manager.      (line 3263)
14224* BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT:     howto manager.      (line 3291)
14225* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST:    howto manager.      (line 3271)
14226* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT: howto manager.     (line 3299)
14227* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL: howto manager.   (line 3285)
14228* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL: howto manager.
14229                                                             (line 3319)
14230* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD: howto manager.  (line 3313)
14231* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE: howto manager.  (line 3325)
14232* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE: howto manager.  (line 3309)
14233* BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL:   howto manager.      (line 3277)
14234* BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL: howto manager.    (line 3293)
14235* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD:  howto manager.      (line 3305)
14236* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE:  howto manager.      (line 3317)
14237* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE:  howto manager.      (line 3307)
14238* BFD_RELOC_TILEGX_IMM16_X0_HW1:         howto manager.      (line 3265)
14239* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST:    howto manager.      (line 3273)
14240* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT: howto manager.     (line 3301)
14241* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL: howto manager.   (line 3287)
14242* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL: howto manager.
14243                                                             (line 3321)
14244* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD: howto manager.  (line 3315)
14245* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE: howto manager.  (line 3327)
14246* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE: howto manager.  (line 3311)
14247* BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL:   howto manager.      (line 3279)
14248* BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL: howto manager.    (line 3295)
14249* BFD_RELOC_TILEGX_IMM16_X0_HW2:         howto manager.      (line 3267)
14250* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST:    howto manager.      (line 3275)
14251* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL: howto manager.   (line 3289)
14252* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL: howto manager.
14253                                                             (line 3323)
14254* BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL:   howto manager.      (line 3281)
14255* BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL: howto manager.    (line 3297)
14256* BFD_RELOC_TILEGX_IMM16_X0_HW3:         howto manager.      (line 3269)
14257* BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL:   howto manager.      (line 3283)
14258* BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL: howto manager.    (line 3303)
14259* BFD_RELOC_TILEGX_IMM16_X1_HW0:         howto manager.      (line 3264)
14260* BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT:     howto manager.      (line 3292)
14261* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST:    howto manager.      (line 3272)
14262* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT: howto manager.     (line 3300)
14263* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL: howto manager.   (line 3286)
14264* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL: howto manager.
14265                                                             (line 3320)
14266* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD: howto manager.  (line 3314)
14267* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE: howto manager.  (line 3326)
14268* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE: howto manager.  (line 3310)
14269* BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL:   howto manager.      (line 3278)
14270* BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL: howto manager.    (line 3294)
14271* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD:  howto manager.      (line 3306)
14272* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE:  howto manager.      (line 3318)
14273* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE:  howto manager.      (line 3308)
14274* BFD_RELOC_TILEGX_IMM16_X1_HW1:         howto manager.      (line 3266)
14275* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST:    howto manager.      (line 3274)
14276* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT: howto manager.     (line 3302)
14277* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL: howto manager.   (line 3288)
14278* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL: howto manager.
14279                                                             (line 3322)
14280* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD: howto manager.  (line 3316)
14281* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE: howto manager.  (line 3328)
14282* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE: howto manager.  (line 3312)
14283* BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL:   howto manager.      (line 3280)
14284* BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL: howto manager.    (line 3296)
14285* BFD_RELOC_TILEGX_IMM16_X1_HW2:         howto manager.      (line 3268)
14286* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST:    howto manager.      (line 3276)
14287* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL: howto manager.   (line 3290)
14288* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL: howto manager.
14289                                                             (line 3324)
14290* BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL:   howto manager.      (line 3282)
14291* BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL: howto manager.    (line 3298)
14292* BFD_RELOC_TILEGX_IMM16_X1_HW3:         howto manager.      (line 3270)
14293* BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL:   howto manager.      (line 3284)
14294* BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL: howto manager.    (line 3304)
14295* BFD_RELOC_TILEGX_IMM8_X0:              howto manager.      (line 3250)
14296* BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD:      howto manager.      (line 3341)
14297* BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD:   howto manager.      (line 3336)
14298* BFD_RELOC_TILEGX_IMM8_X1:              howto manager.      (line 3252)
14299* BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD:      howto manager.      (line 3342)
14300* BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD:   howto manager.      (line 3337)
14301* BFD_RELOC_TILEGX_IMM8_Y0:              howto manager.      (line 3251)
14302* BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD:      howto manager.      (line 3343)
14303* BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD:   howto manager.      (line 3338)
14304* BFD_RELOC_TILEGX_IMM8_Y1:              howto manager.      (line 3253)
14305* BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD:      howto manager.      (line 3344)
14306* BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD:   howto manager.      (line 3339)
14307* BFD_RELOC_TILEGX_JMP_SLOT:             howto manager.      (line 3245)
14308* BFD_RELOC_TILEGX_JUMPOFF_X1:           howto manager.      (line 3248)
14309* BFD_RELOC_TILEGX_JUMPOFF_X1_PLT:       howto manager.      (line 3249)
14310* BFD_RELOC_TILEGX_MF_IMM14_X1:          howto manager.      (line 3256)
14311* BFD_RELOC_TILEGX_MMEND_X0:             howto manager.      (line 3258)
14312* BFD_RELOC_TILEGX_MMSTART_X0:           howto manager.      (line 3257)
14313* BFD_RELOC_TILEGX_MT_IMM14_X1:          howto manager.      (line 3255)
14314* BFD_RELOC_TILEGX_RELATIVE:             howto manager.      (line 3246)
14315* BFD_RELOC_TILEGX_SHAMT_X0:             howto manager.      (line 3259)
14316* BFD_RELOC_TILEGX_SHAMT_X1:             howto manager.      (line 3260)
14317* BFD_RELOC_TILEGX_SHAMT_Y0:             howto manager.      (line 3261)
14318* BFD_RELOC_TILEGX_SHAMT_Y1:             howto manager.      (line 3262)
14319* BFD_RELOC_TILEGX_TLS_DTPMOD32:         howto manager.      (line 3332)
14320* BFD_RELOC_TILEGX_TLS_DTPMOD64:         howto manager.      (line 3329)
14321* BFD_RELOC_TILEGX_TLS_DTPOFF32:         howto manager.      (line 3333)
14322* BFD_RELOC_TILEGX_TLS_DTPOFF64:         howto manager.      (line 3330)
14323* BFD_RELOC_TILEGX_TLS_GD_CALL:          howto manager.      (line 3335)
14324* BFD_RELOC_TILEGX_TLS_IE_LOAD:          howto manager.      (line 3340)
14325* BFD_RELOC_TILEGX_TLS_TPOFF32:          howto manager.      (line 3334)
14326* BFD_RELOC_TILEGX_TLS_TPOFF64:          howto manager.      (line 3331)
14327* BFD_RELOC_TILEPRO_BROFF_X1:            howto manager.      (line 3160)
14328* BFD_RELOC_TILEPRO_COPY:                howto manager.      (line 3156)
14329* BFD_RELOC_TILEPRO_DEST_IMM8_X1:        howto manager.      (line 3167)
14330* BFD_RELOC_TILEPRO_GLOB_DAT:            howto manager.      (line 3157)
14331* BFD_RELOC_TILEPRO_IMM16_X0:            howto manager.      (line 3170)
14332* BFD_RELOC_TILEPRO_IMM16_X0_GOT:        howto manager.      (line 3186)
14333* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA:     howto manager.      (line 3192)
14334* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI:     howto manager.      (line 3190)
14335* BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO:     howto manager.      (line 3188)
14336* BFD_RELOC_TILEPRO_IMM16_X0_HA:         howto manager.      (line 3176)
14337* BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL:   howto manager.      (line 3184)
14338* BFD_RELOC_TILEPRO_IMM16_X0_HI:         howto manager.      (line 3174)
14339* BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL:   howto manager.      (line 3182)
14340* BFD_RELOC_TILEPRO_IMM16_X0_LO:         howto manager.      (line 3172)
14341* BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL:   howto manager.      (line 3180)
14342* BFD_RELOC_TILEPRO_IMM16_X0_PCREL:      howto manager.      (line 3178)
14343* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD:     howto manager.      (line 3208)
14344* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA:  howto manager.      (line 3214)
14345* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI:  howto manager.      (line 3212)
14346* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO:  howto manager.      (line 3210)
14347* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE:     howto manager.      (line 3216)
14348* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA:  howto manager.      (line 3222)
14349* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI:  howto manager.      (line 3220)
14350* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO:  howto manager.      (line 3218)
14351* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE:     howto manager.      (line 3227)
14352* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA:  howto manager.      (line 3233)
14353* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI:  howto manager.      (line 3231)
14354* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO:  howto manager.      (line 3229)
14355* BFD_RELOC_TILEPRO_IMM16_X1:            howto manager.      (line 3171)
14356* BFD_RELOC_TILEPRO_IMM16_X1_GOT:        howto manager.      (line 3187)
14357* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA:     howto manager.      (line 3193)
14358* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI:     howto manager.      (line 3191)
14359* BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO:     howto manager.      (line 3189)
14360* BFD_RELOC_TILEPRO_IMM16_X1_HA:         howto manager.      (line 3177)
14361* BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL:   howto manager.      (line 3185)
14362* BFD_RELOC_TILEPRO_IMM16_X1_HI:         howto manager.      (line 3175)
14363* BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL:   howto manager.      (line 3183)
14364* BFD_RELOC_TILEPRO_IMM16_X1_LO:         howto manager.      (line 3173)
14365* BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL:   howto manager.      (line 3181)
14366* BFD_RELOC_TILEPRO_IMM16_X1_PCREL:      howto manager.      (line 3179)
14367* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD:     howto manager.      (line 3209)
14368* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA:  howto manager.      (line 3215)
14369* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI:  howto manager.      (line 3213)
14370* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO:  howto manager.      (line 3211)
14371* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE:     howto manager.      (line 3217)
14372* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA:  howto manager.      (line 3223)
14373* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI:  howto manager.      (line 3221)
14374* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO:  howto manager.      (line 3219)
14375* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE:     howto manager.      (line 3228)
14376* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA:  howto manager.      (line 3234)
14377* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI:  howto manager.      (line 3232)
14378* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO:  howto manager.      (line 3230)
14379* BFD_RELOC_TILEPRO_IMM8_X0:             howto manager.      (line 3163)
14380* BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD:  howto manager.      (line 3203)
14381* BFD_RELOC_TILEPRO_IMM8_X1:             howto manager.      (line 3165)
14382* BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD:  howto manager.      (line 3204)
14383* BFD_RELOC_TILEPRO_IMM8_Y0:             howto manager.      (line 3164)
14384* BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD:  howto manager.      (line 3205)
14385* BFD_RELOC_TILEPRO_IMM8_Y1:             howto manager.      (line 3166)
14386* BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD:  howto manager.      (line 3206)
14387* BFD_RELOC_TILEPRO_JMP_SLOT:            howto manager.      (line 3158)
14388* BFD_RELOC_TILEPRO_JOFFLONG_X1:         howto manager.      (line 3161)
14389* BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT:     howto manager.      (line 3162)
14390* BFD_RELOC_TILEPRO_MF_IMM15_X1:         howto manager.      (line 3169)
14391* BFD_RELOC_TILEPRO_MMEND_X0:            howto manager.      (line 3195)
14392* BFD_RELOC_TILEPRO_MMEND_X1:            howto manager.      (line 3197)
14393* BFD_RELOC_TILEPRO_MMSTART_X0:          howto manager.      (line 3194)
14394* BFD_RELOC_TILEPRO_MMSTART_X1:          howto manager.      (line 3196)
14395* BFD_RELOC_TILEPRO_MT_IMM15_X1:         howto manager.      (line 3168)
14396* BFD_RELOC_TILEPRO_RELATIVE:            howto manager.      (line 3159)
14397* BFD_RELOC_TILEPRO_SHAMT_X0:            howto manager.      (line 3198)
14398* BFD_RELOC_TILEPRO_SHAMT_X1:            howto manager.      (line 3199)
14399* BFD_RELOC_TILEPRO_SHAMT_Y0:            howto manager.      (line 3200)
14400* BFD_RELOC_TILEPRO_SHAMT_Y1:            howto manager.      (line 3201)
14401* BFD_RELOC_TILEPRO_TLS_DTPMOD32:        howto manager.      (line 3224)
14402* BFD_RELOC_TILEPRO_TLS_DTPOFF32:        howto manager.      (line 3225)
14403* BFD_RELOC_TILEPRO_TLS_GD_CALL:         howto manager.      (line 3202)
14404* BFD_RELOC_TILEPRO_TLS_IE_LOAD:         howto manager.      (line 3207)
14405* BFD_RELOC_TILEPRO_TLS_TPOFF32:         howto manager.      (line 3226)
14406* bfd_reloc_type_lookup:                 howto manager.      (line 3500)
14407* BFD_RELOC_V850_16_GOT:                 howto manager.      (line 1545)
14408* BFD_RELOC_V850_16_GOTOFF:              howto manager.      (line 1561)
14409* BFD_RELOC_V850_16_PCREL:               howto manager.      (line 1525)
14410* BFD_RELOC_V850_16_S1:                  howto manager.      (line 1537)
14411* BFD_RELOC_V850_16_SPLIT_OFFSET:        howto manager.      (line 1535)
14412* BFD_RELOC_V850_17_PCREL:               howto manager.      (line 1527)
14413* BFD_RELOC_V850_22_PCREL:               howto manager.      (line 1479)
14414* BFD_RELOC_V850_22_PLT_PCREL:           howto manager.      (line 1549)
14415* BFD_RELOC_V850_23:                     howto manager.      (line 1529)
14416* BFD_RELOC_V850_32_ABS:                 howto manager.      (line 1533)
14417* BFD_RELOC_V850_32_GOT:                 howto manager.      (line 1547)
14418* BFD_RELOC_V850_32_GOTOFF:              howto manager.      (line 1563)
14419* BFD_RELOC_V850_32_GOTPCREL:            howto manager.      (line 1543)
14420* BFD_RELOC_V850_32_PCREL:               howto manager.      (line 1531)
14421* BFD_RELOC_V850_32_PLT_PCREL:           howto manager.      (line 1551)
14422* BFD_RELOC_V850_9_PCREL:                howto manager.      (line 1477)
14423* BFD_RELOC_V850_ALIGN:                  howto manager.      (line 1520)
14424* BFD_RELOC_V850_CALLT_15_16_OFFSET:     howto manager.      (line 1541)
14425* BFD_RELOC_V850_CALLT_16_16_OFFSET:     howto manager.      (line 1514)
14426* BFD_RELOC_V850_CALLT_6_7_OFFSET:       howto manager.      (line 1512)
14427* BFD_RELOC_V850_CODE:                   howto manager.      (line 1565)
14428* BFD_RELOC_V850_COPY:                   howto manager.      (line 1553)
14429* BFD_RELOC_V850_DATA:                   howto manager.      (line 1567)
14430* BFD_RELOC_V850_GLOB_DAT:               howto manager.      (line 1555)
14431* BFD_RELOC_V850_JMP_SLOT:               howto manager.      (line 1557)
14432* BFD_RELOC_V850_LO16_S1:                howto manager.      (line 1539)
14433* BFD_RELOC_V850_LO16_SPLIT_OFFSET:      howto manager.      (line 1522)
14434* BFD_RELOC_V850_LONGCALL:               howto manager.      (line 1516)
14435* BFD_RELOC_V850_LONGJUMP:               howto manager.      (line 1518)
14436* BFD_RELOC_V850_RELATIVE:               howto manager.      (line 1559)
14437* BFD_RELOC_V850_SDA_15_16_OFFSET:       howto manager.      (line 1483)
14438* BFD_RELOC_V850_SDA_16_16_OFFSET:       howto manager.      (line 1481)
14439* BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET: howto manager.      (line 1506)
14440* BFD_RELOC_V850_TDA_16_16_OFFSET:       howto manager.      (line 1499)
14441* BFD_RELOC_V850_TDA_4_4_OFFSET:         howto manager.      (line 1504)
14442* BFD_RELOC_V850_TDA_4_5_OFFSET:         howto manager.      (line 1501)
14443* BFD_RELOC_V850_TDA_6_8_OFFSET:         howto manager.      (line 1491)
14444* BFD_RELOC_V850_TDA_7_7_OFFSET:         howto manager.      (line 1497)
14445* BFD_RELOC_V850_TDA_7_8_OFFSET:         howto manager.      (line 1494)
14446* BFD_RELOC_V850_ZDA_15_16_OFFSET:       howto manager.      (line 1488)
14447* BFD_RELOC_V850_ZDA_16_16_OFFSET:       howto manager.      (line 1486)
14448* BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET: howto manager.      (line 1509)
14449* BFD_RELOC_VAX_GLOB_DAT:                howto manager.      (line   90)
14450* BFD_RELOC_VAX_GLOB_DAT <1>:            howto manager.      (line 2439)
14451* BFD_RELOC_VAX_GLOB_REF:                howto manager.      (line   91)
14452* BFD_RELOC_VAX_JMP_SLOT:                howto manager.      (line   92)
14453* BFD_RELOC_VAX_JMP_SLOT <1>:            howto manager.      (line 2440)
14454* BFD_RELOC_VAX_RELATIVE:                howto manager.      (line   93)
14455* BFD_RELOC_VAX_RELATIVE <1>:            howto manager.      (line 2441)
14456* BFD_RELOC_VISIUM_HI16:                 howto manager.      (line 3367)
14457* BFD_RELOC_VISIUM_HI16_PCREL:           howto manager.      (line 3371)
14458* BFD_RELOC_VISIUM_IM16:                 howto manager.      (line 3369)
14459* BFD_RELOC_VISIUM_IM16_PCREL:           howto manager.      (line 3373)
14460* BFD_RELOC_VISIUM_LO16:                 howto manager.      (line 3368)
14461* BFD_RELOC_VISIUM_LO16_PCREL:           howto manager.      (line 3372)
14462* BFD_RELOC_VISIUM_REL16:                howto manager.      (line 3370)
14463* BFD_RELOC_VPE4KMATH_DATA:              howto manager.      (line 2101)
14464* BFD_RELOC_VPE4KMATH_INSN:              howto manager.      (line 2102)
14465* BFD_RELOC_VTABLE_ENTRY:                howto manager.      (line 2105)
14466* BFD_RELOC_VTABLE_INHERIT:              howto manager.      (line 2104)
14467* BFD_RELOC_WASM32_ABS32_CODE:           howto manager.      (line 3380)
14468* BFD_RELOC_WASM32_CODE_POINTER:         howto manager.      (line 3382)
14469* BFD_RELOC_WASM32_COPY:                 howto manager.      (line 3381)
14470* BFD_RELOC_WASM32_INDEX:                howto manager.      (line 3383)
14471* BFD_RELOC_WASM32_LEB128:               howto manager.      (line 3375)
14472* BFD_RELOC_WASM32_LEB128_GOT:           howto manager.      (line 3376)
14473* BFD_RELOC_WASM32_LEB128_GOT_CODE:      howto manager.      (line 3377)
14474* BFD_RELOC_WASM32_LEB128_PLT:           howto manager.      (line 3378)
14475* BFD_RELOC_WASM32_PLT_INDEX:            howto manager.      (line 3379)
14476* BFD_RELOC_WASM32_PLT_SIG:              howto manager.      (line 3384)
14477* BFD_RELOC_X86_64_32S:                  howto manager.      (line  560)
14478* BFD_RELOC_X86_64_COPY:                 howto manager.      (line  555)
14479* BFD_RELOC_X86_64_DTPMOD64:             howto manager.      (line  561)
14480* BFD_RELOC_X86_64_DTPOFF32:             howto manager.      (line  566)
14481* BFD_RELOC_X86_64_DTPOFF64:             howto manager.      (line  562)
14482* BFD_RELOC_X86_64_GLOB_DAT:             howto manager.      (line  556)
14483* BFD_RELOC_X86_64_GOT32:                howto manager.      (line  553)
14484* BFD_RELOC_X86_64_GOT64:                howto manager.      (line  571)
14485* BFD_RELOC_X86_64_GOTOFF64:             howto manager.      (line  569)
14486* BFD_RELOC_X86_64_GOTPC32:              howto manager.      (line  570)
14487* BFD_RELOC_X86_64_GOTPC32_TLSDESC:      howto manager.      (line  576)
14488* BFD_RELOC_X86_64_GOTPC64:              howto manager.      (line  573)
14489* BFD_RELOC_X86_64_GOTPCREL:             howto manager.      (line  559)
14490* BFD_RELOC_X86_64_GOTPCREL64:           howto manager.      (line  572)
14491* BFD_RELOC_X86_64_GOTPCRELX:            howto manager.      (line  582)
14492* BFD_RELOC_X86_64_GOTPLT64:             howto manager.      (line  574)
14493* BFD_RELOC_X86_64_GOTTPOFF:             howto manager.      (line  567)
14494* BFD_RELOC_X86_64_IRELATIVE:            howto manager.      (line  579)
14495* BFD_RELOC_X86_64_JUMP_SLOT:            howto manager.      (line  557)
14496* BFD_RELOC_X86_64_PC32_BND:             howto manager.      (line  580)
14497* BFD_RELOC_X86_64_PLT32:                howto manager.      (line  554)
14498* BFD_RELOC_X86_64_PLT32_BND:            howto manager.      (line  581)
14499* BFD_RELOC_X86_64_PLTOFF64:             howto manager.      (line  575)
14500* BFD_RELOC_X86_64_RELATIVE:             howto manager.      (line  558)
14501* BFD_RELOC_X86_64_REX_GOTPCRELX:        howto manager.      (line  583)
14502* BFD_RELOC_X86_64_TLSDESC:              howto manager.      (line  578)
14503* BFD_RELOC_X86_64_TLSDESC_CALL:         howto manager.      (line  577)
14504* BFD_RELOC_X86_64_TLSGD:                howto manager.      (line  564)
14505* BFD_RELOC_X86_64_TLSLD:                howto manager.      (line  565)
14506* BFD_RELOC_X86_64_TPOFF32:              howto manager.      (line  568)
14507* BFD_RELOC_X86_64_TPOFF64:              howto manager.      (line  563)
14508* BFD_RELOC_XGATE_24:                    howto manager.      (line 2248)
14509* BFD_RELOC_XGATE_GPAGE:                 howto manager.      (line 2246)
14510* BFD_RELOC_XGATE_IMM3:                  howto manager.      (line 2260)
14511* BFD_RELOC_XGATE_IMM4:                  howto manager.      (line 2262)
14512* BFD_RELOC_XGATE_IMM5:                  howto manager.      (line 2264)
14513* BFD_RELOC_XGATE_IMM8_HI:               howto manager.      (line 2257)
14514* BFD_RELOC_XGATE_IMM8_LO:               howto manager.      (line 2254)
14515* BFD_RELOC_XGATE_LO16:                  howto manager.      (line 2243)
14516* BFD_RELOC_XGATE_PCREL_10:              howto manager.      (line 2252)
14517* BFD_RELOC_XGATE_PCREL_9:               howto manager.      (line 2250)
14518* BFD_RELOC_XGATE_RL_GROUP:              howto manager.      (line 2239)
14519* BFD_RELOC_XGATE_RL_JUMP:               howto manager.      (line 2236)
14520* BFD_RELOC_XSTORMY16_12:                howto manager.      (line 2433)
14521* BFD_RELOC_XSTORMY16_24:                howto manager.      (line 2434)
14522* BFD_RELOC_XSTORMY16_FPTR16:            howto manager.      (line 2435)
14523* BFD_RELOC_XSTORMY16_REL_12:            howto manager.      (line 2432)
14524* BFD_RELOC_XTENSA_ASM_EXPAND:           howto manager.      (line 2629)
14525* BFD_RELOC_XTENSA_ASM_SIMPLIFY:         howto manager.      (line 2633)
14526* BFD_RELOC_XTENSA_DIFF16:               howto manager.      (line 2578)
14527* BFD_RELOC_XTENSA_DIFF32:               howto manager.      (line 2579)
14528* BFD_RELOC_XTENSA_DIFF8:                howto manager.      (line 2577)
14529* BFD_RELOC_XTENSA_GLOB_DAT:             howto manager.      (line 2569)
14530* BFD_RELOC_XTENSA_JMP_SLOT:             howto manager.      (line 2570)
14531* BFD_RELOC_XTENSA_NDIFF16:              howto manager.      (line 2649)
14532* BFD_RELOC_XTENSA_NDIFF32:              howto manager.      (line 2650)
14533* BFD_RELOC_XTENSA_NDIFF8:               howto manager.      (line 2648)
14534* BFD_RELOC_XTENSA_OP0:                  howto manager.      (line 2624)
14535* BFD_RELOC_XTENSA_OP1:                  howto manager.      (line 2625)
14536* BFD_RELOC_XTENSA_OP2:                  howto manager.      (line 2626)
14537* BFD_RELOC_XTENSA_PDIFF16:              howto manager.      (line 2646)
14538* BFD_RELOC_XTENSA_PDIFF32:              howto manager.      (line 2647)
14539* BFD_RELOC_XTENSA_PDIFF8:               howto manager.      (line 2645)
14540* BFD_RELOC_XTENSA_PLT:                  howto manager.      (line 2573)
14541* BFD_RELOC_XTENSA_RELATIVE:             howto manager.      (line 2571)
14542* BFD_RELOC_XTENSA_RTLD:                 howto manager.      (line 2565)
14543* BFD_RELOC_XTENSA_SLOT0_ALT:            howto manager.      (line 2607)
14544* BFD_RELOC_XTENSA_SLOT0_OP:             howto manager.      (line 2588)
14545* BFD_RELOC_XTENSA_SLOT10_ALT:           howto manager.      (line 2617)
14546* BFD_RELOC_XTENSA_SLOT10_OP:            howto manager.      (line 2598)
14547* BFD_RELOC_XTENSA_SLOT11_ALT:           howto manager.      (line 2618)
14548* BFD_RELOC_XTENSA_SLOT11_OP:            howto manager.      (line 2599)
14549* BFD_RELOC_XTENSA_SLOT12_ALT:           howto manager.      (line 2619)
14550* BFD_RELOC_XTENSA_SLOT12_OP:            howto manager.      (line 2600)
14551* BFD_RELOC_XTENSA_SLOT13_ALT:           howto manager.      (line 2620)
14552* BFD_RELOC_XTENSA_SLOT13_OP:            howto manager.      (line 2601)
14553* BFD_RELOC_XTENSA_SLOT14_ALT:           howto manager.      (line 2621)
14554* BFD_RELOC_XTENSA_SLOT14_OP:            howto manager.      (line 2602)
14555* BFD_RELOC_XTENSA_SLOT1_ALT:            howto manager.      (line 2608)
14556* BFD_RELOC_XTENSA_SLOT1_OP:             howto manager.      (line 2589)
14557* BFD_RELOC_XTENSA_SLOT2_ALT:            howto manager.      (line 2609)
14558* BFD_RELOC_XTENSA_SLOT2_OP:             howto manager.      (line 2590)
14559* BFD_RELOC_XTENSA_SLOT3_ALT:            howto manager.      (line 2610)
14560* BFD_RELOC_XTENSA_SLOT3_OP:             howto manager.      (line 2591)
14561* BFD_RELOC_XTENSA_SLOT4_ALT:            howto manager.      (line 2611)
14562* BFD_RELOC_XTENSA_SLOT4_OP:             howto manager.      (line 2592)
14563* BFD_RELOC_XTENSA_SLOT5_ALT:            howto manager.      (line 2612)
14564* BFD_RELOC_XTENSA_SLOT5_OP:             howto manager.      (line 2593)
14565* BFD_RELOC_XTENSA_SLOT6_ALT:            howto manager.      (line 2613)
14566* BFD_RELOC_XTENSA_SLOT6_OP:             howto manager.      (line 2594)
14567* BFD_RELOC_XTENSA_SLOT7_ALT:            howto manager.      (line 2614)
14568* BFD_RELOC_XTENSA_SLOT7_OP:             howto manager.      (line 2595)
14569* BFD_RELOC_XTENSA_SLOT8_ALT:            howto manager.      (line 2615)
14570* BFD_RELOC_XTENSA_SLOT8_OP:             howto manager.      (line 2596)
14571* BFD_RELOC_XTENSA_SLOT9_ALT:            howto manager.      (line 2616)
14572* BFD_RELOC_XTENSA_SLOT9_OP:             howto manager.      (line 2597)
14573* BFD_RELOC_XTENSA_TLSDESC_ARG:          howto manager.      (line 2638)
14574* BFD_RELOC_XTENSA_TLSDESC_FN:           howto manager.      (line 2637)
14575* BFD_RELOC_XTENSA_TLS_ARG:              howto manager.      (line 2642)
14576* BFD_RELOC_XTENSA_TLS_CALL:             howto manager.      (line 2643)
14577* BFD_RELOC_XTENSA_TLS_DTPOFF:           howto manager.      (line 2639)
14578* BFD_RELOC_XTENSA_TLS_FUNC:             howto manager.      (line 2641)
14579* BFD_RELOC_XTENSA_TLS_TPOFF:            howto manager.      (line 2640)
14580* BFD_RELOC_Z80_16_BE:                   howto manager.      (line 2674)
14581* BFD_RELOC_Z80_BYTE0:                   howto manager.      (line 2662)
14582* BFD_RELOC_Z80_BYTE1:                   howto manager.      (line 2664)
14583* BFD_RELOC_Z80_BYTE2:                   howto manager.      (line 2666)
14584* BFD_RELOC_Z80_BYTE3:                   howto manager.      (line 2668)
14585* BFD_RELOC_Z80_DISP8:                   howto manager.      (line 2660)
14586* BFD_RELOC_Z80_WORD0:                   howto manager.      (line 2670)
14587* BFD_RELOC_Z80_WORD1:                   howto manager.      (line 2672)
14588* BFD_RELOC_Z8K_CALLR:                   howto manager.      (line 2678)
14589* BFD_RELOC_Z8K_DISP7:                   howto manager.      (line 2676)
14590* BFD_RELOC_Z8K_IMM4L:                   howto manager.      (line 2680)
14591* bfd_rename_section:                    section prototypes. (line  167)
14592* bfd_scan_arch:                         Architectures.      (line  589)
14593* bfd_scan_vma:                          Miscellaneous.      (line  135)
14594* bfd_sections_find_if:                  section prototypes. (line  197)
14595* bfd_section_already_linked:            Writing the symbol table.
14596                                                             (line   55)
14597* bfd_section_list_clear:                section prototypes. (line    7)
14598* bfd_set_archive_head:                  Archives.           (line   74)
14599* bfd_set_arch_info:                     Architectures.      (line  630)
14600* bfd_set_assert_handler:                Error reporting.    (line  162)
14601* bfd_set_default_target:                bfd_target.         (line  571)
14602* bfd_set_error:                         Error reporting.    (line   58)
14603* bfd_set_error_handler:                 Error reporting.    (line  128)
14604* bfd_set_error_program_name:            Error reporting.    (line  136)
14605* bfd_set_filename:                      Opening and Closing.
14606                                                             (line  520)
14607* bfd_set_file_flags:                    Miscellaneous.      (line   45)
14608* bfd_set_format:                        Formats.            (line   67)
14609* bfd_set_gp_size:                       Miscellaneous.      (line  116)
14610* bfd_set_gp_value:                      Miscellaneous.      (line  126)
14611* bfd_set_input_error:                   Error reporting.    (line   69)
14612* bfd_set_private_flags:                 Miscellaneous.      (line  183)
14613* bfd_set_reloc:                         Miscellaneous.      (line   33)
14614* bfd_set_section_contents:              section prototypes. (line  228)
14615* bfd_set_section_flags:                 section prototypes. (line  154)
14616* bfd_set_section_size:                  section prototypes. (line  214)
14617* bfd_set_start_address:                 Miscellaneous.      (line   95)
14618* bfd_set_symtab:                        symbol handling functions.
14619                                                             (line   63)
14620* bfd_symbol_info:                       symbol handling functions.
14621                                                             (line  135)
14622* bfd_target_list:                       bfd_target.         (line  623)
14623* bfd_update_compression_header:         Miscellaneous.      (line  345)
14624* bfd_zalloc:                            Opening and Closing.
14625                                                             (line  257)
14626* check_build_id_file:                   Opening and Closing.
14627                                                             (line  482)
14628* coff_symbol_type:                      coff.               (line  233)
14629* core_file_matches_executable_p:        Core Files.         (line   38)
14630* find_separate_debug_file:              Opening and Closing.
14631                                                             (line  356)
14632* generic_core_file_matches_executable_p: Core Files.        (line   48)
14633* get_build_id:                          Opening and Closing.
14634                                                             (line  451)
14635* get_build_id_name:                     Opening and Closing.
14636                                                             (line  465)
14637* Hash tables:                           Hash Tables.        (line    6)
14638* internal object-file format:           Canonical format.   (line   11)
14639* Linker:                                Linker Functions.   (line    6)
14640* Other functions:                       Miscellaneous.      (line  197)
14641* separate_alt_debug_file_exists:        Opening and Closing.
14642                                                             (line  347)
14643* separate_debug_file_exists:            Opening and Closing.
14644                                                             (line  334)
14645* struct bfd_iovec:                      Miscellaneous.      (line  406)
14646* target vector (_bfd_final_link):       Performing the Final Link.
14647                                                             (line    6)
14648* target vector (_bfd_link_add_symbols): Adding Symbols to the Hash Table.
14649                                                             (line    6)
14650* target vector (_bfd_link_hash_table_create): Creating a Linker Hash Table.
14651                                                             (line    6)
14652* The HOWTO Macro:                       typedef arelent.    (line  285)
14653* what is it?:                           Overview.           (line    6)
14654
14655
14656
14657Tag Table:
14658Node: Top1051
14659Node: Overview1387
14660Node: History2445
14661Node: How It Works3390
14662Node: What BFD Version 2 Can Do4927
14663Node: BFD information loss6244
14664Node: Canonical format8785
14665Node: BFD front end13128
14666Node: typedef bfd13552
14667Node: Error reporting31599
14668Node: Miscellaneous36850
14669Node: Memory Usage55755
14670Node: Initialization56986
14671Node: Sections57662
14672Node: Section Input58145
14673Node: Section Output59339
14674Node: typedef asection61826
14675Node: section prototypes86300
14676Node: Symbols96974
14677Node: Reading Symbols98577
14678Node: Writing Symbols99685
14679Node: Mini Symbols101429
14680Node: typedef asymbol102403
14681Node: symbol handling functions108610
14682Node: Archives113943
14683Node: Formats118073
14684Node: Relocations121003
14685Node: typedef arelent121730
14686Node: howto manager136439
14687Node: Core Files271998
14688Node: Targets274022
14689Node: bfd_target275997
14690Node: Architectures302750
14691Node: Opening and Closing334609
14692Node: Internal352777
14693Node: File Caching352881
14694Node: Linker Functions354778
14695Node: Creating a Linker Hash Table356452
14696Node: Adding Symbols to the Hash Table358191
14697Node: Differing file formats359091
14698Node: Adding symbols from an object file360816
14699Node: Adding symbols from an archive362966
14700Node: Performing the Final Link365312
14701Node: Information provided by the linker366553
14702Node: Relocating the section contents367707
14703Node: Writing the symbol table369459
14704Node: Hash Tables376550
14705Node: Creating and Freeing a Hash Table377748
14706Node: Looking Up or Entering a String378998
14707Node: Traversing a Hash Table380251
14708Node: Deriving a New Hash Table Type381040
14709Node: Define the Derived Structures382106
14710Node: Write the Derived Creation Routine383187
14711Node: Write Other Derived Routines385812
14712Node: BFD back ends387127
14713Node: What to Put Where387397
14714Node: aout387577
14715Node: coff393831
14716Node: elf421971
14717Node: mmo422372
14718Node: File layout423242
14719Node: Symbol-table429155
14720Node: mmo section mapping432918
14721Node: GNU Free Documentation License436572
14722Node: BFD Index461636
14723
14724End Tag Table
14725
14726
14727Local Variables:
14728coding: utf-8
14729End:
14730