1This is bfd.info, produced by makeinfo version 5.1 from bfd.texi.
2
3This file documents the BFD library.
4
5   Copyright (C) 1991-2021 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       /* A field used by _bfd_generic_link_add_archive_symbols.  This will
573          be used only for archive elements.  */
574       int archive_pass;
575
576       /* Stuff only useful for object files:
577          The start address.  */
578       bfd_vma start_address;
579
580       /* Symbol table for output BFD (with symcount entries).
581          Also used by the linker to cache input BFD symbols.  */
582       struct bfd_symbol **outsymbols;
583
584       /* Used for input and output.  */
585       unsigned int symcount;
586
587       /* Used for slurped dynamic symbol tables.  */
588       unsigned int dynsymcount;
589
590       /* Pointer to structure which contains architecture information.  */
591       const struct bfd_arch_info *arch_info;
592
593       /* Cached length of file for bfd_get_size.  0 until bfd_get_size is
594          called, 1 if stat returns an error or the file size is too large to
595          return in ufile_ptr.  Both 0 and 1 should be treated as "unknown".  */
596       ufile_ptr size;
597
598       /* Stuff only useful for archives.  */
599       void *arelt_data;
600       struct bfd *my_archive;      /* The containing archive BFD.  */
601       struct bfd *archive_next;    /* The next BFD in the archive.  */
602       struct bfd *archive_head;    /* The first BFD in the archive.  */
603       struct bfd *nested_archives; /* List of nested archive in a flattened
604                                       thin archive.  */
605
606       union {
607         /* For input BFDs, a chain of BFDs involved in a link.  */
608         struct bfd *next;
609         /* For output BFD, the linker hash table.  */
610         struct bfd_link_hash_table *hash;
611       } link;
612
613       /* Used by the back end to hold private data.  */
614       union
615         {
616           struct aout_data_struct *aout_data;
617           struct artdata *aout_ar_data;
618           struct coff_tdata *coff_obj_data;
619           struct pe_tdata *pe_obj_data;
620           struct xcoff_tdata *xcoff_obj_data;
621           struct ecoff_tdata *ecoff_obj_data;
622           struct srec_data_struct *srec_data;
623           struct verilog_data_struct *verilog_data;
624           struct ihex_data_struct *ihex_data;
625           struct tekhex_data_struct *tekhex_data;
626           struct elf_obj_tdata *elf_obj_data;
627           struct mmo_data_struct *mmo_data;
628           struct sun_core_struct *sun_core_data;
629           struct sco5_core_struct *sco5_core_data;
630           struct trad_core_struct *trad_core_data;
631           struct som_data_struct *som_data;
632           struct hpux_core_struct *hpux_core_data;
633           struct hppabsd_core_struct *hppabsd_core_data;
634           struct sgi_core_struct *sgi_core_data;
635           struct lynx_core_struct *lynx_core_data;
636           struct osf_core_struct *osf_core_data;
637           struct cisco_core_struct *cisco_core_data;
638           struct versados_data_struct *versados_data;
639           struct netbsd_core_struct *netbsd_core_data;
640           struct mach_o_data_struct *mach_o_data;
641           struct mach_o_fat_data_struct *mach_o_fat_data;
642           struct plugin_data_struct *plugin_data;
643           struct bfd_pef_data_struct *pef_data;
644           struct bfd_pef_xlib_data_struct *pef_xlib_data;
645           struct bfd_sym_data_struct *sym_data;
646           void *any;
647         }
648       tdata;
649
650       /* Used by the application to hold private data.  */
651       void *usrdata;
652
653       /* Where all the allocated stuff under this BFD goes.  This is a
654          struct objalloc *, but we use void * to avoid requiring the inclusion
655          of objalloc.h.  */
656       void *memory;
657
658       /* For input BFDs, the build ID, if the object has one. */
659       const struct bfd_build_id *build_id;
660     };
661
662     static inline const char *
663     bfd_get_filename (const bfd *abfd)
664     {
665       return abfd->filename;
666     }
667
668     static inline bfd_boolean
669     bfd_get_cacheable (const bfd *abfd)
670     {
671       return abfd->cacheable;
672     }
673
674     static inline enum bfd_format
675     bfd_get_format (const bfd *abfd)
676     {
677       return abfd->format;
678     }
679
680     static inline flagword
681     bfd_get_file_flags (const bfd *abfd)
682     {
683       return abfd->flags;
684     }
685
686     static inline bfd_vma
687     bfd_get_start_address (const bfd *abfd)
688     {
689       return abfd->start_address;
690     }
691
692     static inline unsigned int
693     bfd_get_symcount (const bfd *abfd)
694     {
695       return abfd->symcount;
696     }
697
698     static inline unsigned int
699     bfd_get_dynamic_symcount (const bfd *abfd)
700     {
701       return abfd->dynsymcount;
702     }
703
704     static inline struct bfd_symbol **
705     bfd_get_outsymbols (const bfd *abfd)
706     {
707       return abfd->outsymbols;
708     }
709
710     static inline unsigned int
711     bfd_count_sections (const bfd *abfd)
712     {
713       return abfd->section_count;
714     }
715
716     static inline bfd_boolean
717     bfd_has_map (const bfd *abfd)
718     {
719       return abfd->has_armap;
720     }
721
722     static inline bfd_boolean
723     bfd_is_thin_archive (const bfd *abfd)
724     {
725       return abfd->is_thin_archive;
726     }
727
728     static inline void *
729     bfd_usrdata (const bfd *abfd)
730     {
731       return abfd->usrdata;
732     }
733
734     /* See note beside bfd_set_section_userdata.  */
735     static inline bfd_boolean
736     bfd_set_cacheable (bfd * abfd, bfd_boolean val)
737     {
738       abfd->cacheable = val;
739       return TRUE;
740     }
741
742     static inline void
743     bfd_set_thin_archive (bfd *abfd, bfd_boolean val)
744     {
745       abfd->is_thin_archive = val;
746     }
747
748     static inline void
749     bfd_set_usrdata (bfd *abfd, void *val)
750     {
751       abfd->usrdata = val;
752     }
753
754     static inline asection *
755     bfd_asymbol_section (const asymbol *sy)
756     {
757       return sy->section;
758     }
759
760     static inline bfd_vma
761     bfd_asymbol_value (const asymbol *sy)
762     {
763       return sy->section->vma + sy->value;
764     }
765
766     static inline const char *
767     bfd_asymbol_name (const asymbol *sy)
768     {
769       return sy->name;
770     }
771
772     static inline struct bfd *
773     bfd_asymbol_bfd (const asymbol *sy)
774     {
775       return sy->the_bfd;
776     }
777
778     static inline void
779     bfd_set_asymbol_name (asymbol *sy, const char *name)
780     {
781       sy->name = name;
782     }
783
784     static inline bfd_size_type
785     bfd_get_section_limit_octets (const bfd *abfd, const asection *sec)
786     {
787       if (abfd->direction != write_direction && sec->rawsize != 0)
788         return sec->rawsize;
789       return sec->size;
790     }
791
792     /* Find the address one past the end of SEC.  */
793     static inline bfd_size_type
794     bfd_get_section_limit (const bfd *abfd, const asection *sec)
795     {
796       return (bfd_get_section_limit_octets (abfd, sec)
797               / bfd_octets_per_byte (abfd, sec));
798     }
799
800     /* Functions to handle insertion and deletion of a bfd's sections.  These
801        only handle the list pointers, ie. do not adjust section_count,
802        target_index etc.  */
803     static inline void
804     bfd_section_list_remove (bfd *abfd, asection *s)
805     {
806       asection *next = s->next;
807       asection *prev = s->prev;
808       if (prev)
809         prev->next = next;
810       else
811         abfd->sections = next;
812       if (next)
813         next->prev = prev;
814       else
815         abfd->section_last = prev;
816     }
817
818     static inline void
819     bfd_section_list_append (bfd *abfd, asection *s)
820     {
821       s->next = 0;
822       if (abfd->section_last)
823         {
824           s->prev = abfd->section_last;
825           abfd->section_last->next = s;
826         }
827       else
828         {
829           s->prev = 0;
830           abfd->sections = s;
831         }
832       abfd->section_last = s;
833     }
834
835     static inline void
836     bfd_section_list_prepend (bfd *abfd, asection *s)
837     {
838       s->prev = 0;
839       if (abfd->sections)
840         {
841           s->next = abfd->sections;
842           abfd->sections->prev = s;
843         }
844       else
845         {
846           s->next = 0;
847           abfd->section_last = s;
848         }
849       abfd->sections = s;
850     }
851
852     static inline void
853     bfd_section_list_insert_after (bfd *abfd, asection *a, asection *s)
854     {
855       asection *next = a->next;
856       s->next = next;
857       s->prev = a;
858       a->next = s;
859       if (next)
860         next->prev = s;
861       else
862         abfd->section_last = s;
863     }
864
865     static inline void
866     bfd_section_list_insert_before (bfd *abfd, asection *b, asection *s)
867     {
868       asection *prev = b->prev;
869       s->prev = prev;
870       s->next = b;
871       b->prev = s;
872       if (prev)
873         prev->next = s;
874       else
875         abfd->sections = s;
876     }
877
878     static inline bfd_boolean
879     bfd_section_removed_from_list (const bfd *abfd, const asection *s)
880     {
881       return s->next ? s->next->prev != s : abfd->section_last != s;
882     }
883
884
885File: bfd.info,  Node: Error reporting,  Next: Miscellaneous,  Prev: typedef bfd,  Up: BFD front end
886
8872.2 Error reporting
888===================
889
890Most BFD functions return nonzero on success (check their individual
891documentation for precise semantics).  On an error, they call
892'bfd_set_error' to set an error condition that callers can check by
893calling 'bfd_get_error'.  If that returns 'bfd_error_system_call', then
894check 'errno'.
895
896   The easiest way to report a BFD error to the user is to use
897'bfd_perror'.
898
8992.2.1 Type 'bfd_error_type'
900---------------------------
901
902The values returned by 'bfd_get_error' are defined by the enumerated
903type 'bfd_error_type'.
904
905
906     typedef enum bfd_error
907     {
908       bfd_error_no_error = 0,
909       bfd_error_system_call,
910       bfd_error_invalid_target,
911       bfd_error_wrong_format,
912       bfd_error_wrong_object_format,
913       bfd_error_invalid_operation,
914       bfd_error_no_memory,
915       bfd_error_no_symbols,
916       bfd_error_no_armap,
917       bfd_error_no_more_archived_files,
918       bfd_error_malformed_archive,
919       bfd_error_missing_dso,
920       bfd_error_file_not_recognized,
921       bfd_error_file_ambiguously_recognized,
922       bfd_error_no_contents,
923       bfd_error_nonrepresentable_section,
924       bfd_error_no_debug_section,
925       bfd_error_bad_value,
926       bfd_error_file_truncated,
927       bfd_error_file_too_big,
928       bfd_error_sorry,
929       bfd_error_on_input,
930       bfd_error_invalid_error_code
931     }
932     bfd_error_type;
933
9342.2.1.1 'bfd_get_error'
935.......................
936
937*Synopsis*
938     bfd_error_type bfd_get_error (void);
939   *Description*
940Return the current BFD error condition.
941
9422.2.1.2 'bfd_set_error'
943.......................
944
945*Synopsis*
946     void bfd_set_error (bfd_error_type error_tag);
947   *Description*
948Set the BFD error condition to be ERROR_TAG.
949
950   ERROR_TAG must not be bfd_error_on_input.  Use bfd_set_input_error
951for input errors instead.
952
9532.2.1.3 'bfd_set_input_error'
954.............................
955
956*Synopsis*
957     void bfd_set_input_error (bfd *input, bfd_error_type error_tag);
958   *Description*
959Set the BFD error condition to be bfd_error_on_input.  INPUT is the
960input bfd where the error occurred, and ERROR_TAG the bfd_error_type
961error.
962
9632.2.1.4 'bfd_errmsg'
964....................
965
966*Synopsis*
967     const char *bfd_errmsg (bfd_error_type error_tag);
968   *Description*
969Return a string describing the error ERROR_TAG, or the system error if
970ERROR_TAG is 'bfd_error_system_call'.
971
9722.2.1.5 'bfd_perror'
973....................
974
975*Synopsis*
976     void bfd_perror (const char *message);
977   *Description*
978Print to the standard error stream a string describing the last BFD
979error that occurred, or the last system error if the last BFD error was
980a system call failure.  If MESSAGE is non-NULL and non-empty, the error
981string printed is preceded by MESSAGE, a colon, and a space.  It is
982followed by a newline.
983
9842.2.2 BFD error handler
985-----------------------
986
987Some BFD functions want to print messages describing the problem.  They
988call a BFD error handler function.  This function may be overridden by
989the program.
990
991   The BFD error handler acts like vprintf.
992
993
994     typedef void (*bfd_error_handler_type) (const char *, va_list);
995
9962.2.2.1 '_bfd_error_handler'
997............................
998
999*Synopsis*
1000     void _bfd_error_handler (const char *fmt, ...) ATTRIBUTE_PRINTF_1;
1001   *Description*
1002This is the default routine to handle BFD error messages.  Like fprintf
1003(stderr, ...), but also handles some extra format specifiers.
1004
1005   %pA section name from section.  For group components, prints group
1006name too.  %pB file name from bfd.  For archive components, prints
1007archive too.
1008
1009   Beware: Only supports a maximum of 9 format arguments.
1010
10112.2.2.2 'bfd_set_error_handler'
1012...............................
1013
1014*Synopsis*
1015     bfd_error_handler_type bfd_set_error_handler (bfd_error_handler_type);
1016   *Description*
1017Set the BFD error handler function.  Returns the previous function.
1018
10192.2.2.3 'bfd_set_error_program_name'
1020....................................
1021
1022*Synopsis*
1023     void bfd_set_error_program_name (const char *);
1024   *Description*
1025Set the program name to use when printing a BFD error.  This is printed
1026before the error message followed by a colon and space.  The string must
1027not be changed after it is passed to this function.
1028
10292.2.3 BFD assert handler
1030------------------------
1031
1032If BFD finds an internal inconsistency, the bfd assert handler is called
1033with information on the BFD version, BFD source file and line.  If this
1034happens, most programs linked against BFD are expected to want to exit
1035with an error, or mark the current BFD operation as failed, so it is
1036recommended to override the default handler, which just calls
1037_bfd_error_handler and continues.
1038
1039
1040     typedef void (*bfd_assert_handler_type) (const char *bfd_formatmsg,
1041                                              const char *bfd_version,
1042                                              const char *bfd_file,
1043                                              int bfd_line);
1044
10452.2.3.1 'bfd_set_assert_handler'
1046................................
1047
1048*Synopsis*
1049     bfd_assert_handler_type bfd_set_assert_handler (bfd_assert_handler_type);
1050   *Description*
1051Set the BFD assert handler function.  Returns the previous function.
1052
1053
1054File: bfd.info,  Node: Miscellaneous,  Next: Memory Usage,  Prev: Error reporting,  Up: BFD front end
1055
10562.3 Miscellaneous
1057=================
1058
10592.3.1 Miscellaneous functions
1060-----------------------------
1061
10622.3.1.1 'bfd_get_reloc_upper_bound'
1063...................................
1064
1065*Synopsis*
1066     long bfd_get_reloc_upper_bound (bfd *abfd, asection *sect);
1067   *Description*
1068Return the number of bytes required to store the relocation information
1069associated with section SECT attached to bfd ABFD.  If an error occurs,
1070return -1.
1071
10722.3.1.2 'bfd_canonicalize_reloc'
1073................................
1074
1075*Synopsis*
1076     long bfd_canonicalize_reloc
1077        (bfd *abfd, asection *sec, arelent **loc, asymbol **syms);
1078   *Description*
1079Call the back end associated with the open BFD ABFD and translate the
1080external form of the relocation information attached to SEC into the
1081internal canonical form.  Place the table into memory at LOC, which has
1082been preallocated, usually by a call to 'bfd_get_reloc_upper_bound'.
1083Returns the number of relocs, or -1 on error.
1084
1085   The SYMS table is also needed for horrible internal magic reasons.
1086
10872.3.1.3 'bfd_set_reloc'
1088.......................
1089
1090*Synopsis*
1091     void bfd_set_reloc
1092        (bfd *abfd, asection *sec, arelent **rel, unsigned int count);
1093   *Description*
1094Set the relocation pointer and count within section SEC to the values
1095REL and COUNT.  The argument ABFD is ignored.
1096     #define bfd_set_reloc(abfd, asect, location, count) \
1097            BFD_SEND (abfd, _bfd_set_reloc, (abfd, asect, location, count))
1098
10992.3.1.4 'bfd_set_file_flags'
1100............................
1101
1102*Synopsis*
1103     bfd_boolean bfd_set_file_flags (bfd *abfd, flagword flags);
1104   *Description*
1105Set the flag word in the BFD ABFD to the value FLAGS.
1106
1107   Possible errors are:
1108
1109   * 'bfd_error_wrong_format' - The target bfd was not of object format.
1110   * 'bfd_error_invalid_operation' - The target bfd was open for
1111     reading.
1112   * 'bfd_error_invalid_operation' - The flag word contained a bit which
1113     was not applicable to the type of file.  E.g., an attempt was made
1114     to set the 'D_PAGED' bit on a BFD format which does not support
1115     demand paging.
1116
11172.3.1.5 'bfd_get_arch_size'
1118...........................
1119
1120*Synopsis*
1121     int bfd_get_arch_size (bfd *abfd);
1122   *Description*
1123Returns the normalized architecture address size, in bits, as determined
1124by the object file's format.  By normalized, we mean either 32 or 64.
1125For ELF, this information is included in the header.  Use
1126bfd_arch_bits_per_address for number of bits in the architecture
1127address.
1128
1129   *Returns*
1130Returns the arch size in bits if known, '-1' otherwise.
1131
11322.3.1.6 'bfd_get_sign_extend_vma'
1133.................................
1134
1135*Synopsis*
1136     int bfd_get_sign_extend_vma (bfd *abfd);
1137   *Description*
1138Indicates if the target architecture "naturally" sign extends an
1139address.  Some architectures implicitly sign extend address values when
1140they are converted to types larger than the size of an address.  For
1141instance, bfd_get_start_address() will return an address sign extended
1142to fill a bfd_vma when this is the case.
1143
1144   *Returns*
1145Returns '1' if the target architecture is known to sign extend
1146addresses, '0' if the target architecture is known to not sign extend
1147addresses, and '-1' otherwise.
1148
11492.3.1.7 'bfd_set_start_address'
1150...............................
1151
1152*Synopsis*
1153     bfd_boolean bfd_set_start_address (bfd *abfd, bfd_vma vma);
1154   *Description*
1155Make VMA the entry point of output BFD ABFD.
1156
1157   *Returns*
1158Returns 'TRUE' on success, 'FALSE' otherwise.
1159
11602.3.1.8 'bfd_get_gp_size'
1161.........................
1162
1163*Synopsis*
1164     unsigned int bfd_get_gp_size (bfd *abfd);
1165   *Description*
1166Return the maximum size of objects to be optimized using the GP register
1167under MIPS ECOFF. This is typically set by the '-G' argument to the
1168compiler, assembler or linker.
1169
11702.3.1.9 'bfd_set_gp_size'
1171.........................
1172
1173*Synopsis*
1174     void bfd_set_gp_size (bfd *abfd, unsigned int i);
1175   *Description*
1176Set the maximum size of objects to be optimized using the GP register
1177under ECOFF or MIPS ELF. This is typically set by the '-G' argument to
1178the compiler, assembler or linker.
1179
11802.3.1.10 'bfd_scan_vma'
1181.......................
1182
1183*Synopsis*
1184     bfd_vma bfd_scan_vma (const char *string, const char **end, int base);
1185   *Description*
1186Convert, like 'strtoul', a numerical expression STRING into a 'bfd_vma'
1187integer, and return that integer.  (Though without as many bells and
1188whistles as 'strtoul'.)  The expression is assumed to be unsigned (i.e.,
1189positive).  If given a BASE, it is used as the base for conversion.  A
1190base of 0 causes the function to interpret the string in hex if a
1191leading "0x" or "0X" is found, otherwise in octal if a leading zero is
1192found, otherwise in decimal.
1193
1194   If the value would overflow, the maximum 'bfd_vma' value is returned.
1195
11962.3.1.11 'bfd_copy_private_header_data'
1197.......................................
1198
1199*Synopsis*
1200     bfd_boolean bfd_copy_private_header_data (bfd *ibfd, bfd *obfd);
1201   *Description*
1202Copy private BFD header information from the BFD IBFD to the the BFD
1203OBFD.  This copies information that may require sections to exist, but
1204does not require symbol tables.  Return 'true' on success, 'false' on
1205error.  Possible error returns are:
1206
1207   * 'bfd_error_no_memory' - Not enough memory exists to create private
1208     data for OBFD.
1209     #define bfd_copy_private_header_data(ibfd, obfd) \
1210            BFD_SEND (obfd, _bfd_copy_private_header_data, \
1211                      (ibfd, obfd))
1212
12132.3.1.12 'bfd_copy_private_bfd_data'
1214....................................
1215
1216*Synopsis*
1217     bfd_boolean bfd_copy_private_bfd_data (bfd *ibfd, bfd *obfd);
1218   *Description*
1219Copy private BFD information from the BFD IBFD to the the BFD OBFD.
1220Return 'TRUE' on success, 'FALSE' on error.  Possible error returns are:
1221
1222   * 'bfd_error_no_memory' - Not enough memory exists to create private
1223     data for OBFD.
1224     #define bfd_copy_private_bfd_data(ibfd, obfd) \
1225            BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
1226                      (ibfd, obfd))
1227
12282.3.1.13 'bfd_set_private_flags'
1229................................
1230
1231*Synopsis*
1232     bfd_boolean bfd_set_private_flags (bfd *abfd, flagword flags);
1233   *Description*
1234Set private BFD flag information in the BFD ABFD.  Return 'TRUE' on
1235success, 'FALSE' on error.  Possible error returns are:
1236
1237   * 'bfd_error_no_memory' - Not enough memory exists to create private
1238     data for OBFD.
1239     #define bfd_set_private_flags(abfd, flags) \
1240            BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags))
1241
12422.3.1.14 'Other functions'
1243..........................
1244
1245*Description*
1246The following functions exist but have not yet been documented.
1247     #define bfd_sizeof_headers(abfd, info) \
1248            BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, info))
1249
1250     #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1251            BFD_SEND (abfd, _bfd_find_nearest_line, \
1252                      (abfd, syms, sec, off, file, func, line, NULL))
1253
1254     #define bfd_find_nearest_line_discriminator(abfd, sec, syms, off, file, func, \
1255                                                line, disc) \
1256            BFD_SEND (abfd, _bfd_find_nearest_line, \
1257                      (abfd, syms, sec, off, file, func, line, disc))
1258
1259     #define bfd_find_line(abfd, syms, sym, file, line) \
1260            BFD_SEND (abfd, _bfd_find_line, \
1261                      (abfd, syms, sym, file, line))
1262
1263     #define bfd_find_inliner_info(abfd, file, func, line) \
1264            BFD_SEND (abfd, _bfd_find_inliner_info, \
1265                      (abfd, file, func, line))
1266
1267     #define bfd_debug_info_start(abfd) \
1268            BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1269
1270     #define bfd_debug_info_end(abfd) \
1271            BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1272
1273     #define bfd_debug_info_accumulate(abfd, section) \
1274            BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1275
1276     #define bfd_stat_arch_elt(abfd, stat) \
1277            BFD_SEND (abfd->my_archive ? abfd->my_archive : abfd, \
1278                      _bfd_stat_arch_elt, (abfd, stat))
1279
1280     #define bfd_update_armap_timestamp(abfd) \
1281            BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
1282
1283     #define bfd_set_arch_mach(abfd, arch, mach)\
1284            BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
1285
1286     #define bfd_relax_section(abfd, section, link_info, again) \
1287            BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
1288
1289     #define bfd_gc_sections(abfd, link_info) \
1290            BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info))
1291
1292     #define bfd_lookup_section_flags(link_info, flag_info, section) \
1293            BFD_SEND (abfd, _bfd_lookup_section_flags, (link_info, flag_info, section))
1294
1295     #define bfd_merge_sections(abfd, link_info) \
1296            BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info))
1297
1298     #define bfd_is_group_section(abfd, sec) \
1299            BFD_SEND (abfd, _bfd_is_group_section, (abfd, sec))
1300
1301     #define bfd_group_name(abfd, sec) \
1302            BFD_SEND (abfd, _bfd_group_name, (abfd, sec))
1303
1304     #define bfd_discard_group(abfd, sec) \
1305            BFD_SEND (abfd, _bfd_discard_group, (abfd, sec))
1306
1307     #define bfd_link_hash_table_create(abfd) \
1308            BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
1309
1310     #define bfd_link_add_symbols(abfd, info) \
1311            BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
1312
1313     #define bfd_link_just_syms(abfd, sec, info) \
1314            BFD_SEND (abfd, _bfd_link_just_syms, (sec, info))
1315
1316     #define bfd_final_link(abfd, info) \
1317            BFD_SEND (abfd, _bfd_final_link, (abfd, info))
1318
1319     #define bfd_free_cached_info(abfd) \
1320            BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
1321
1322     #define bfd_get_dynamic_symtab_upper_bound(abfd) \
1323            BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
1324
1325     #define bfd_print_private_bfd_data(abfd, file)\
1326            BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
1327
1328     #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
1329            BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
1330
1331     #define bfd_get_synthetic_symtab(abfd, count, syms, dyncount, dynsyms, ret) \
1332            BFD_SEND (abfd, _bfd_get_synthetic_symtab, (abfd, count, syms, \
1333                                                        dyncount, dynsyms, ret))
1334
1335     #define bfd_get_dynamic_reloc_upper_bound(abfd) \
1336            BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
1337
1338     #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
1339            BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
1340
1341     extern bfd_byte *bfd_get_relocated_section_contents
1342       (bfd *, struct bfd_link_info *, struct bfd_link_order *, bfd_byte *,
1343        bfd_boolean, asymbol **);
1344
13452.3.1.15 'bfd_alt_mach_code'
1346............................
1347
1348*Synopsis*
1349     bfd_boolean bfd_alt_mach_code (bfd *abfd, int alternative);
1350   *Description*
1351When more than one machine code number is available for the same machine
1352type, this function can be used to switch between the preferred one
1353(alternative == 0) and any others.  Currently, only ELF supports this
1354feature, with up to two alternate machine codes.
1355
13562.3.1.16 'bfd_emul_get_maxpagesize'
1357...................................
1358
1359*Synopsis*
1360     bfd_vma bfd_emul_get_maxpagesize (const char *);
1361   *Description*
1362Returns the maximum page size, in bytes, as determined by emulation.
1363
1364   *Returns*
1365Returns the maximum page size in bytes for ELF, 0 otherwise.
1366
13672.3.1.17 'bfd_emul_get_commonpagesize'
1368......................................
1369
1370*Synopsis*
1371     bfd_vma bfd_emul_get_commonpagesize (const char *, bfd_boolean);
1372   *Description*
1373Returns the common page size, in bytes, as determined by emulation.
1374
1375   *Returns*
1376Returns the common page size in bytes for ELF, 0 otherwise.
1377
13782.3.1.18 'bfd_demangle'
1379.......................
1380
1381*Synopsis*
1382     char *bfd_demangle (bfd *, const char *, int);
1383   *Description*
1384Wrapper around cplus_demangle.  Strips leading underscores and other
1385such chars that would otherwise confuse the demangler.  If passed a g++
1386v3 ABI mangled name, returns a buffer allocated with malloc holding the
1387demangled name.  Returns NULL otherwise and on memory alloc failure.
1388
13892.3.1.19 'bfd_update_compression_header'
1390........................................
1391
1392*Synopsis*
1393     void bfd_update_compression_header
1394        (bfd *abfd, bfd_byte *contents, asection *sec);
1395   *Description*
1396Set the compression header at CONTENTS of SEC in ABFD and update
1397elf_section_flags for compression.
1398
13992.3.1.20 'bfd_check_compression_header'
1400.......................................
1401
1402*Synopsis*
1403     bfd_boolean bfd_check_compression_header
1404        (bfd *abfd, bfd_byte *contents, asection *sec,
1405         bfd_size_type *uncompressed_size,
1406         unsigned int *uncompressed_alignment_power);
1407   *Description*
1408Check the compression header at CONTENTS of SEC in ABFD and store the
1409uncompressed size in UNCOMPRESSED_SIZE and the uncompressed data
1410alignment in UNCOMPRESSED_ALIGNMENT_POWER if the compression header is
1411valid.
1412
1413   *Returns*
1414Return TRUE if the compression header is valid.
1415
14162.3.1.21 'bfd_get_compression_header_size'
1417..........................................
1418
1419*Synopsis*
1420     int bfd_get_compression_header_size (bfd *abfd, asection *sec);
1421   *Description*
1422Return the size of the compression header of SEC in ABFD.
1423
1424   *Returns*
1425Return the size of the compression header in bytes.
1426
14272.3.1.22 'bfd_convert_section_size'
1428...................................
1429
1430*Synopsis*
1431     bfd_size_type bfd_convert_section_size
1432        (bfd *ibfd, asection *isec, bfd *obfd, bfd_size_type size);
1433   *Description*
1434Convert the size SIZE of the section ISEC in input BFD IBFD to the
1435section size in output BFD OBFD.
1436
14372.3.1.23 'bfd_convert_section_contents'
1438.......................................
1439
1440*Synopsis*
1441     bfd_boolean bfd_convert_section_contents
1442        (bfd *ibfd, asection *isec, bfd *obfd,
1443         bfd_byte **ptr, bfd_size_type *ptr_size);
1444   *Description*
1445Convert the contents, stored in *PTR, of the section ISEC in input BFD
1446IBFD to output BFD OBFD if needed.  The original buffer pointed to by
1447*PTR may be freed and *PTR is returned with memory malloc'd by this
1448function, and the new size written to PTR_SIZE.
1449
14502.3.1.24 'struct bfd_iovec'
1451...........................
1452
1453*Description*
1454The 'struct bfd_iovec' contains the internal file I/O class.  Each 'BFD'
1455has an instance of this class and all file I/O is routed through it (it
1456is assumed that the instance implements all methods listed below).
1457     struct bfd_iovec
1458     {
1459       /* To avoid problems with macros, a "b" rather than "f"
1460          prefix is prepended to each method name.  */
1461       /* Attempt to read/write NBYTES on ABFD's IOSTREAM storing/fetching
1462          bytes starting at PTR.  Return the number of bytes actually
1463          transfered (a read past end-of-file returns less than NBYTES),
1464          or -1 (setting bfd_error) if an error occurs.  */
1465       file_ptr (*bread) (struct bfd *abfd, void *ptr, file_ptr nbytes);
1466       file_ptr (*bwrite) (struct bfd *abfd, const void *ptr,
1467                           file_ptr nbytes);
1468       /* Return the current IOSTREAM file offset, or -1 (setting bfd_error
1469          if an error occurs.  */
1470       file_ptr (*btell) (struct bfd *abfd);
1471       /* For the following, on successful completion a value of 0 is returned.
1472          Otherwise, a value of -1 is returned (and bfd_error is set).  */
1473       int (*bseek) (struct bfd *abfd, file_ptr offset, int whence);
1474       int (*bclose) (struct bfd *abfd);
1475       int (*bflush) (struct bfd *abfd);
1476       int (*bstat) (struct bfd *abfd, struct stat *sb);
1477       /* Mmap a part of the files. ADDR, LEN, PROT, FLAGS and OFFSET are the usual
1478          mmap parameter, except that LEN and OFFSET do not need to be page
1479          aligned.  Returns (void *)-1 on failure, mmapped address on success.
1480          Also write in MAP_ADDR the address of the page aligned buffer and in
1481          MAP_LEN the size mapped (a page multiple).  Use unmap with MAP_ADDR and
1482          MAP_LEN to unmap.  */
1483       void *(*bmmap) (struct bfd *abfd, void *addr, bfd_size_type len,
1484                       int prot, int flags, file_ptr offset,
1485                       void **map_addr, bfd_size_type *map_len);
1486     };
1487     extern const struct bfd_iovec _bfd_memory_iovec;
1488
14892.3.1.25 'bfd_get_mtime'
1490........................
1491
1492*Synopsis*
1493     long bfd_get_mtime (bfd *abfd);
1494   *Description*
1495Return the file modification time (as read from the file system, or from
1496the archive header for archive members).
1497
14982.3.1.26 'bfd_get_size'
1499.......................
1500
1501*Synopsis*
1502     ufile_ptr bfd_get_size (bfd *abfd);
1503   *Description*
1504Return the file size (as read from file system) for the file associated
1505with BFD ABFD.
1506
1507   The initial motivation for, and use of, this routine is not so we can
1508get the exact size of the object the BFD applies to, since that might
1509not be generally possible (archive members for example).  It would be
1510ideal if someone could eventually modify it so that such results were
1511guaranteed.
1512
1513   Instead, we want to ask questions like "is this NNN byte sized object
1514I'm about to try read from file offset YYY reasonable?"  As as example
1515of where we might do this, some object formats use string tables for
1516which the first 'sizeof (long)' bytes of the table contain the size of
1517the table itself, including the size bytes.  If an application tries to
1518read what it thinks is one of these string tables, without some way to
1519validate the size, and for some reason the size is wrong (byte swapping
1520error, wrong location for the string table, etc.), the only clue is
1521likely to be a read error when it tries to read the table, or a "virtual
1522memory exhausted" error when it tries to allocate 15 bazillon bytes of
1523space for the 15 bazillon byte table it is about to read.  This function
1524at least allows us to answer the question, "is the size reasonable?".
1525
1526   A return value of zero indicates the file size is unknown.
1527
15282.3.1.27 'bfd_get_file_size'
1529............................
1530
1531*Synopsis*
1532     ufile_ptr bfd_get_file_size (bfd *abfd);
1533   *Description*
1534Return the file size (as read from file system) for the file associated
1535with BFD ABFD.  It supports both normal files and archive elements.
1536
15372.3.1.28 'bfd_mmap'
1538...................
1539
1540*Synopsis*
1541     void *bfd_mmap (bfd *abfd, void *addr, bfd_size_type len,
1542         int prot, int flags, file_ptr offset,
1543         void **map_addr, bfd_size_type *map_len);
1544   *Description*
1545Return mmap()ed region of the file, if possible and implemented.  LEN
1546and OFFSET do not need to be page aligned.  The page aligned address and
1547length are written to MAP_ADDR and MAP_LEN.
1548
1549
1550File: bfd.info,  Node: Memory Usage,  Next: Initialization,  Prev: Miscellaneous,  Up: BFD front end
1551
15522.4 Memory Usage
1553================
1554
1555BFD keeps all of its internal structures in obstacks.  There is one
1556obstack per open BFD file, into which the current state is stored.  When
1557a BFD is closed, the obstack is deleted, and so everything which has
1558been allocated by BFD for the closing file is thrown away.
1559
1560   BFD does not free anything created by an application, but pointers
1561into 'bfd' structures become invalid on a 'bfd_close'; for example,
1562after a 'bfd_close' the vector passed to 'bfd_canonicalize_symtab' is
1563still around, since it has been allocated by the application, but the
1564data that it pointed to are lost.
1565
1566   The general rule is to not close a BFD until all operations dependent
1567upon data from the BFD have been completed, or all the data from within
1568the file has been copied.  To help with the management of memory, there
1569is a function ('bfd_alloc_size') which returns the number of bytes in
1570obstacks associated with the supplied BFD. This could be used to select
1571the greediest open BFD, close it to reclaim the memory, perform some
1572operation and reopen the BFD again, to get a fresh copy of the data
1573structures.
1574
1575
1576File: bfd.info,  Node: Initialization,  Next: Sections,  Prev: Memory Usage,  Up: BFD front end
1577
15782.5 Initialization
1579==================
1580
15812.5.1 Initialization functions
1582------------------------------
1583
1584These are the functions that handle initializing a BFD.
1585
15862.5.1.1 'bfd_init'
1587..................
1588
1589*Synopsis*
1590     unsigned int bfd_init (void);
1591   *Description*
1592This routine must be called before any other BFD function to initialize
1593magical internal data structures.  Returns a magic number, which may be
1594used to check that the bfd library is configured as expected by users.
1595
1596     /* Value returned by bfd_init.  */
1597
1598     #define BFD_INIT_MAGIC (sizeof (struct bfd_section))
1599
1600
1601File: bfd.info,  Node: Sections,  Next: Symbols,  Prev: Initialization,  Up: BFD front end
1602
16032.6 Sections
1604============
1605
1606The raw data contained within a BFD is maintained through the section
1607abstraction.  A single BFD may have any number of sections.  It keeps
1608hold of them by pointing to the first; each one points to the next in
1609the list.
1610
1611   Sections are supported in BFD in 'section.c'.
1612
1613* Menu:
1614
1615* Section Input::
1616* Section Output::
1617* typedef asection::
1618* section prototypes::
1619
1620
1621File: bfd.info,  Node: Section Input,  Next: Section Output,  Prev: Sections,  Up: Sections
1622
16232.6.1 Section input
1624-------------------
1625
1626When a BFD is opened for reading, the section structures are created and
1627attached to the BFD.
1628
1629   Each section has a name which describes the section in the outside
1630world--for example, 'a.out' would contain at least three sections,
1631called '.text', '.data' and '.bss'.
1632
1633   Names need not be unique; for example a COFF file may have several
1634sections named '.data'.
1635
1636   Sometimes a BFD will contain more than the "natural" number of
1637sections.  A back end may attach other sections containing constructor
1638data, or an application may add a section (using 'bfd_make_section') to
1639the sections attached to an already open BFD. For example, the linker
1640creates an extra section 'COMMON' for each input file's BFD to hold
1641information about common storage.
1642
1643   The raw data is not necessarily read in when the section descriptor
1644is created.  Some targets may leave the data in place until a
1645'bfd_get_section_contents' call is made.  Other back ends may read in
1646all the data at once.  For example, an S-record file has to be read once
1647to determine the size of the data.
1648
1649
1650File: bfd.info,  Node: Section Output,  Next: typedef asection,  Prev: Section Input,  Up: Sections
1651
16522.6.2 Section output
1653--------------------
1654
1655To write a new object style BFD, the various sections to be written have
1656to be created.  They are attached to the BFD in the same way as input
1657sections; data is written to the sections using
1658'bfd_set_section_contents'.
1659
1660   Any program that creates or combines sections (e.g., the assembler
1661and linker) must use the 'asection' fields 'output_section' and
1662'output_offset' to indicate the file sections to which each section must
1663be written.  (If the section is being created from scratch,
1664'output_section' should probably point to the section itself and
1665'output_offset' should probably be zero.)
1666
1667   The data to be written comes from input sections attached (via
1668'output_section' pointers) to the output sections.  The output section
1669structure can be considered a filter for the input section: the output
1670section determines the vma of the output data and the name, but the
1671input section determines the offset into the output section of the data
1672to be written.
1673
1674   E.g., to create a section "O", starting at 0x100, 0x123 long,
1675containing two subsections, "A" at offset 0x0 (i.e., at vma 0x100) and
1676"B" at offset 0x20 (i.e., at vma 0x120) the 'asection' structures would
1677look like:
1678
1679        section name          "A"
1680          output_offset   0x00
1681          size            0x20
1682          output_section ----------->  section name    "O"
1683                                  |    vma             0x100
1684        section name          "B" |    size            0x123
1685          output_offset   0x20    |
1686          size            0x103   |
1687          output_section  --------|
1688
16892.6.3 Link orders
1690-----------------
1691
1692The data within a section is stored in a "link_order".  These are much
1693like the fixups in 'gas'.  The link_order abstraction allows a section
1694to grow and shrink within itself.
1695
1696   A link_order knows how big it is, and which is the next link_order
1697and where the raw data for it is; it also points to a list of
1698relocations which apply to it.
1699
1700   The link_order is used by the linker to perform relaxing on final
1701code.  The compiler creates code which is as big as necessary to make it
1702work without relaxing, and the user can select whether to relax.
1703Sometimes relaxing takes a lot of time.  The linker runs around the
1704relocations to see if any are attached to data which can be shrunk, if
1705so it does it on a link_order by link_order basis.
1706
1707
1708File: bfd.info,  Node: typedef asection,  Next: section prototypes,  Prev: Section Output,  Up: Sections
1709
17102.6.4 typedef asection
1711----------------------
1712
1713Here is the section structure:
1714
1715
1716     typedef struct bfd_section
1717     {
1718       /* The name of the section; the name isn't a copy, the pointer is
1719          the same as that passed to bfd_make_section.  */
1720       const char *name;
1721
1722       /* A unique sequence number.  */
1723       unsigned int id;
1724
1725       /* A unique section number which can be used by assembler to
1726          distinguish different sections with the same section name.  */
1727       unsigned int section_id;
1728
1729       /* Which section in the bfd; 0..n-1 as sections are created in a bfd.  */
1730       unsigned int index;
1731
1732       /* The next section in the list belonging to the BFD, or NULL.  */
1733       struct bfd_section *next;
1734
1735       /* The previous section in the list belonging to the BFD, or NULL.  */
1736       struct bfd_section *prev;
1737
1738       /* The field flags contains attributes of the section. Some
1739          flags are read in from the object file, and some are
1740          synthesized from other information.  */
1741       flagword flags;
1742
1743     #define SEC_NO_FLAGS                      0x0
1744
1745       /* Tells the OS to allocate space for this section when loading.
1746          This is clear for a section containing debug information only.  */
1747     #define SEC_ALLOC                         0x1
1748
1749       /* Tells the OS to load the section from the file when loading.
1750          This is clear for a .bss section.  */
1751     #define SEC_LOAD                          0x2
1752
1753       /* The section contains data still to be relocated, so there is
1754          some relocation information too.  */
1755     #define SEC_RELOC                         0x4
1756
1757       /* A signal to the OS that the section contains read only data.  */
1758     #define SEC_READONLY                      0x8
1759
1760       /* The section contains code only.  */
1761     #define SEC_CODE                         0x10
1762
1763       /* The section contains data only.  */
1764     #define SEC_DATA                         0x20
1765
1766       /* The section will reside in ROM.  */
1767     #define SEC_ROM                          0x40
1768
1769       /* The section contains constructor information. This section
1770          type is used by the linker to create lists of constructors and
1771          destructors used by g++. When a back end sees a symbol
1772          which should be used in a constructor list, it creates a new
1773          section for the type of name (e.g., __CTOR_LIST__), attaches
1774          the symbol to it, and builds a relocation. To build the lists
1775          of constructors, all the linker has to do is catenate all the
1776          sections called __CTOR_LIST__ and relocate the data
1777          contained within - exactly the operations it would peform on
1778          standard data.  */
1779     #define SEC_CONSTRUCTOR                  0x80
1780
1781       /* The section has contents - a data section could be
1782          SEC_ALLOC | SEC_HAS_CONTENTS; a debug section could be
1783          SEC_HAS_CONTENTS  */
1784     #define SEC_HAS_CONTENTS                0x100
1785
1786       /* An instruction to the linker to not output the section
1787          even if it has information which would normally be written.  */
1788     #define SEC_NEVER_LOAD                  0x200
1789
1790       /* The section contains thread local data.  */
1791     #define SEC_THREAD_LOCAL                0x400
1792
1793       /* The section's size is fixed.  Generic linker code will not
1794          recalculate it and it is up to whoever has set this flag to
1795          get the size right.  */
1796     #define SEC_FIXED_SIZE                  0x800
1797
1798       /* The section contains common symbols (symbols may be defined
1799          multiple times, the value of a symbol is the amount of
1800          space it requires, and the largest symbol value is the one
1801          used).  Most targets have exactly one of these (which we
1802          translate to bfd_com_section_ptr), but ECOFF has two.  */
1803     #define SEC_IS_COMMON                  0x1000
1804
1805       /* The section contains only debugging information.  For
1806          example, this is set for ELF .debug and .stab sections.
1807          strip tests this flag to see if a section can be
1808          discarded.  */
1809     #define SEC_DEBUGGING                  0x2000
1810
1811       /* The contents of this section are held in memory pointed to
1812          by the contents field.  This is checked by bfd_get_section_contents,
1813          and the data is retrieved from memory if appropriate.  */
1814     #define SEC_IN_MEMORY                  0x4000
1815
1816       /* The contents of this section are to be excluded by the
1817          linker for executable and shared objects unless those
1818          objects are to be further relocated.  */
1819     #define SEC_EXCLUDE                    0x8000
1820
1821       /* The contents of this section are to be sorted based on the sum of
1822          the symbol and addend values specified by the associated relocation
1823          entries.  Entries without associated relocation entries will be
1824          appended to the end of the section in an unspecified order.  */
1825     #define SEC_SORT_ENTRIES              0x10000
1826
1827       /* When linking, duplicate sections of the same name should be
1828          discarded, rather than being combined into a single section as
1829          is usually done.  This is similar to how common symbols are
1830          handled.  See SEC_LINK_DUPLICATES below.  */
1831     #define SEC_LINK_ONCE                 0x20000
1832
1833       /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
1834          should handle duplicate sections.  */
1835     #define SEC_LINK_DUPLICATES           0xc0000
1836
1837       /* This value for SEC_LINK_DUPLICATES means that duplicate
1838          sections with the same name should simply be discarded.  */
1839     #define SEC_LINK_DUPLICATES_DISCARD       0x0
1840
1841       /* This value for SEC_LINK_DUPLICATES means that the linker
1842          should warn if there are any duplicate sections, although
1843          it should still only link one copy.  */
1844     #define SEC_LINK_DUPLICATES_ONE_ONLY  0x40000
1845
1846       /* This value for SEC_LINK_DUPLICATES means that the linker
1847          should warn if any duplicate sections are a different size.  */
1848     #define SEC_LINK_DUPLICATES_SAME_SIZE 0x80000
1849
1850       /* This value for SEC_LINK_DUPLICATES means that the linker
1851          should warn if any duplicate sections contain different
1852          contents.  */
1853     #define SEC_LINK_DUPLICATES_SAME_CONTENTS \
1854       (SEC_LINK_DUPLICATES_ONE_ONLY | SEC_LINK_DUPLICATES_SAME_SIZE)
1855
1856       /* This section was created by the linker as part of dynamic
1857          relocation or other arcane processing.  It is skipped when
1858          going through the first-pass output, trusting that someone
1859          else up the line will take care of it later.  */
1860     #define SEC_LINKER_CREATED           0x100000
1861
1862       /* This section contains a section ID to distinguish different
1863          sections with the same section name.  */
1864     #define SEC_ASSEMBLER_SECTION_ID     0x100000
1865
1866       /* This section should not be subject to garbage collection.
1867          Also set to inform the linker that this section should not be
1868          listed in the link map as discarded.  */
1869     #define SEC_KEEP                     0x200000
1870
1871       /* This section contains "short" data, and should be placed
1872          "near" the GP.  */
1873     #define SEC_SMALL_DATA               0x400000
1874
1875       /* Attempt to merge identical entities in the section.
1876          Entity size is given in the entsize field.  */
1877     #define SEC_MERGE                    0x800000
1878
1879       /* If given with SEC_MERGE, entities to merge are zero terminated
1880          strings where entsize specifies character size instead of fixed
1881          size entries.  */
1882     #define SEC_STRINGS                 0x1000000
1883
1884       /* This section contains data about section groups.  */
1885     #define SEC_GROUP                   0x2000000
1886
1887       /* The section is a COFF shared library section.  This flag is
1888          only for the linker.  If this type of section appears in
1889          the input file, the linker must copy it to the output file
1890          without changing the vma or size.  FIXME: Although this
1891          was originally intended to be general, it really is COFF
1892          specific (and the flag was renamed to indicate this).  It
1893          might be cleaner to have some more general mechanism to
1894          allow the back end to control what the linker does with
1895          sections.  */
1896     #define SEC_COFF_SHARED_LIBRARY     0x4000000
1897
1898       /* This input section should be copied to output in reverse order
1899          as an array of pointers.  This is for ELF linker internal use
1900          only.  */
1901     #define SEC_ELF_REVERSE_COPY        0x4000000
1902
1903       /* This section contains data which may be shared with other
1904          executables or shared objects. This is for COFF only.  */
1905     #define SEC_COFF_SHARED             0x8000000
1906
1907       /* This section should be compressed.  This is for ELF linker
1908          internal use only.  */
1909     #define SEC_ELF_COMPRESS            0x8000000
1910
1911       /* When a section with this flag is being linked, then if the size of
1912          the input section is less than a page, it should not cross a page
1913          boundary.  If the size of the input section is one page or more,
1914          it should be aligned on a page boundary.  This is for TI
1915          TMS320C54X only.  */
1916     #define SEC_TIC54X_BLOCK           0x10000000
1917
1918       /* This section should be renamed.  This is for ELF linker
1919          internal use only.  */
1920     #define SEC_ELF_RENAME             0x10000000
1921
1922       /* Conditionally link this section; do not link if there are no
1923          references found to any symbol in the section.  This is for TI
1924          TMS320C54X only.  */
1925     #define SEC_TIC54X_CLINK           0x20000000
1926
1927       /* This section contains vliw code.  This is for Toshiba MeP only.  */
1928     #define SEC_MEP_VLIW               0x20000000
1929
1930       /* All symbols, sizes and relocations in this section are octets
1931          instead of bytes.  Required for DWARF debug sections as DWARF
1932          information is organized in octets, not bytes.  */
1933     #define SEC_ELF_OCTETS             0x40000000
1934
1935       /* Indicate that section has the no read flag set. This happens
1936          when memory read flag isn't set. */
1937     #define SEC_COFF_NOREAD            0x40000000
1938
1939       /* Indicate that section has the purecode flag set.  */
1940     #define SEC_ELF_PURECODE           0x80000000
1941
1942       /*  End of section flags.  */
1943
1944       /* Some internal packed boolean fields.  */
1945
1946       /* See the vma field.  */
1947       unsigned int user_set_vma : 1;
1948
1949       /* A mark flag used by some of the linker backends.  */
1950       unsigned int linker_mark : 1;
1951
1952       /* Another mark flag used by some of the linker backends.  Set for
1953          output sections that have an input section.  */
1954       unsigned int linker_has_input : 1;
1955
1956       /* Mark flag used by some linker backends for garbage collection.  */
1957       unsigned int gc_mark : 1;
1958
1959       /* Section compression status.  */
1960       unsigned int compress_status : 2;
1961     #define COMPRESS_SECTION_NONE    0
1962     #define COMPRESS_SECTION_DONE    1
1963     #define DECOMPRESS_SECTION_SIZED 2
1964
1965       /* The following flags are used by the ELF linker. */
1966
1967       /* Mark sections which have been allocated to segments.  */
1968       unsigned int segment_mark : 1;
1969
1970       /* Type of sec_info information.  */
1971       unsigned int sec_info_type:3;
1972     #define SEC_INFO_TYPE_NONE      0
1973     #define SEC_INFO_TYPE_STABS     1
1974     #define SEC_INFO_TYPE_MERGE     2
1975     #define SEC_INFO_TYPE_EH_FRAME  3
1976     #define SEC_INFO_TYPE_JUST_SYMS 4
1977     #define SEC_INFO_TYPE_TARGET    5
1978     #define SEC_INFO_TYPE_EH_FRAME_ENTRY 6
1979
1980       /* Nonzero if this section uses RELA relocations, rather than REL.  */
1981       unsigned int use_rela_p:1;
1982
1983       /* Bits used by various backends.  The generic code doesn't touch
1984          these fields.  */
1985
1986       unsigned int sec_flg0:1;
1987       unsigned int sec_flg1:1;
1988       unsigned int sec_flg2:1;
1989       unsigned int sec_flg3:1;
1990       unsigned int sec_flg4:1;
1991       unsigned int sec_flg5:1;
1992
1993       /* End of internal packed boolean fields.  */
1994
1995       /*  The virtual memory address of the section - where it will be
1996           at run time.  The symbols are relocated against this.  The
1997           user_set_vma flag is maintained by bfd; if it's not set, the
1998           backend can assign addresses (for example, in a.out, where
1999           the default address for .data is dependent on the specific
2000           target and various flags).  */
2001       bfd_vma vma;
2002
2003       /*  The load address of the section - where it would be in a
2004           rom image; really only used for writing section header
2005           information.  */
2006       bfd_vma lma;
2007
2008       /* The size of the section in *octets*, as it will be output.
2009          Contains a value even if the section has no contents (e.g., the
2010          size of .bss).  */
2011       bfd_size_type size;
2012
2013       /* For input sections, the original size on disk of the section, in
2014          octets.  This field should be set for any section whose size is
2015          changed by linker relaxation.  It is required for sections where
2016          the linker relaxation scheme doesn't cache altered section and
2017          reloc contents (stabs, eh_frame, SEC_MERGE, some coff relaxing
2018          targets), and thus the original size needs to be kept to read the
2019          section multiple times.  For output sections, rawsize holds the
2020          section size calculated on a previous linker relaxation pass.  */
2021       bfd_size_type rawsize;
2022
2023       /* The compressed size of the section in octets.  */
2024       bfd_size_type compressed_size;
2025
2026       /* Relaxation table. */
2027       struct relax_table *relax;
2028
2029       /* Count of used relaxation table entries. */
2030       int relax_count;
2031
2032
2033       /* If this section is going to be output, then this value is the
2034          offset in *bytes* into the output section of the first byte in the
2035          input section (byte ==> smallest addressable unit on the
2036          target).  In most cases, if this was going to start at the
2037          100th octet (8-bit quantity) in the output section, this value
2038          would be 100.  However, if the target byte size is 16 bits
2039          (bfd_octets_per_byte is "2"), this value would be 50.  */
2040       bfd_vma output_offset;
2041
2042       /* The output section through which to map on output.  */
2043       struct bfd_section *output_section;
2044
2045       /* The alignment requirement of the section, as an exponent of 2 -
2046          e.g., 3 aligns to 2^3 (or 8).  */
2047       unsigned int alignment_power;
2048
2049       /* If an input section, a pointer to a vector of relocation
2050          records for the data in this section.  */
2051       struct reloc_cache_entry *relocation;
2052
2053       /* If an output section, a pointer to a vector of pointers to
2054          relocation records for the data in this section.  */
2055       struct reloc_cache_entry **orelocation;
2056
2057       /* The number of relocation records in one of the above.  */
2058       unsigned reloc_count;
2059
2060       /* Information below is back end specific - and not always used
2061          or updated.  */
2062
2063       /* File position of section data.  */
2064       file_ptr filepos;
2065
2066       /* File position of relocation info.  */
2067       file_ptr rel_filepos;
2068
2069       /* File position of line data.  */
2070       file_ptr line_filepos;
2071
2072       /* Pointer to data for applications.  */
2073       void *userdata;
2074
2075       /* If the SEC_IN_MEMORY flag is set, this points to the actual
2076          contents.  */
2077       unsigned char *contents;
2078
2079       /* Attached line number information.  */
2080       alent *lineno;
2081
2082       /* Number of line number records.  */
2083       unsigned int lineno_count;
2084
2085       /* Entity size for merging purposes.  */
2086       unsigned int entsize;
2087
2088       /* Points to the kept section if this section is a link-once section,
2089          and is discarded.  */
2090       struct bfd_section *kept_section;
2091
2092       /* When a section is being output, this value changes as more
2093          linenumbers are written out.  */
2094       file_ptr moving_line_filepos;
2095
2096       /* What the section number is in the target world.  */
2097       int target_index;
2098
2099       void *used_by_bfd;
2100
2101       /* If this is a constructor section then here is a list of the
2102          relocations created to relocate items within it.  */
2103       struct relent_chain *constructor_chain;
2104
2105       /* The BFD which owns the section.  */
2106       bfd *owner;
2107
2108       /* A symbol which points at this section only.  */
2109       struct bfd_symbol *symbol;
2110       struct bfd_symbol **symbol_ptr_ptr;
2111
2112       /* The matching section name pattern in linker script.  */
2113       const char *pattern;
2114
2115       /* Early in the link process, map_head and map_tail are used to build
2116          a list of input sections attached to an output section.  Later,
2117          output sections use these fields for a list of bfd_link_order
2118          structs.  The linked_to_symbol_name field is for ELF assembler
2119          internal use.  */
2120       union {
2121         struct bfd_link_order *link_order;
2122         struct bfd_section *s;
2123         const char *linked_to_symbol_name;
2124       } map_head, map_tail;
2125      /* Points to the output section this section is already assigned to, if any.
2126         This is used when support for non-contiguous memory regions is enabled.  */
2127      struct bfd_section *already_assigned;
2128
2129     } asection;
2130
2131     /* Relax table contains information about instructions which can
2132        be removed by relaxation -- replacing a long address with a
2133        short address.  */
2134     struct relax_table {
2135       /* Address where bytes may be deleted. */
2136       bfd_vma addr;
2137
2138       /* Number of bytes to be deleted.  */
2139       int size;
2140     };
2141
2142     static inline const char *
2143     bfd_section_name (const asection *sec)
2144     {
2145       return sec->name;
2146     }
2147
2148     static inline bfd_size_type
2149     bfd_section_size (const asection *sec)
2150     {
2151       return sec->size;
2152     }
2153
2154     static inline bfd_vma
2155     bfd_section_vma (const asection *sec)
2156     {
2157       return sec->vma;
2158     }
2159
2160     static inline bfd_vma
2161     bfd_section_lma (const asection *sec)
2162     {
2163       return sec->lma;
2164     }
2165
2166     static inline unsigned int
2167     bfd_section_alignment (const asection *sec)
2168     {
2169       return sec->alignment_power;
2170     }
2171
2172     static inline flagword
2173     bfd_section_flags (const asection *sec)
2174     {
2175       return sec->flags;
2176     }
2177
2178     static inline void *
2179     bfd_section_userdata (const asection *sec)
2180     {
2181       return sec->userdata;
2182     }
2183     static inline bfd_boolean
2184     bfd_is_com_section (const asection *sec)
2185     {
2186       return (sec->flags & SEC_IS_COMMON) != 0;
2187     }
2188
2189     /* Note: the following are provided as inline functions rather than macros
2190        because not all callers use the return value.  A macro implementation
2191        would use a comma expression, eg: "((ptr)->foo = val, TRUE)" and some
2192        compilers will complain about comma expressions that have no effect.  */
2193     static inline bfd_boolean
2194     bfd_set_section_userdata (asection *sec, void *val)
2195     {
2196       sec->userdata = val;
2197       return TRUE;
2198     }
2199
2200     static inline bfd_boolean
2201     bfd_set_section_vma (asection *sec, bfd_vma val)
2202     {
2203       sec->vma = sec->lma = val;
2204       sec->user_set_vma = TRUE;
2205       return TRUE;
2206     }
2207
2208     static inline bfd_boolean
2209     bfd_set_section_lma (asection *sec, bfd_vma val)
2210     {
2211       sec->lma = val;
2212       return TRUE;
2213     }
2214
2215     static inline bfd_boolean
2216     bfd_set_section_alignment (asection *sec, unsigned int val)
2217     {
2218       sec->alignment_power = val;
2219       return TRUE;
2220     }
2221
2222     /* These sections are global, and are managed by BFD.  The application
2223        and target back end are not permitted to change the values in
2224        these sections.  */
2225     extern asection _bfd_std_section[4];
2226
2227     #define BFD_ABS_SECTION_NAME "*ABS*"
2228     #define BFD_UND_SECTION_NAME "*UND*"
2229     #define BFD_COM_SECTION_NAME "*COM*"
2230     #define BFD_IND_SECTION_NAME "*IND*"
2231
2232     /* Pointer to the common section.  */
2233     #define bfd_com_section_ptr (&_bfd_std_section[0])
2234     /* Pointer to the undefined section.  */
2235     #define bfd_und_section_ptr (&_bfd_std_section[1])
2236     /* Pointer to the absolute section.  */
2237     #define bfd_abs_section_ptr (&_bfd_std_section[2])
2238     /* Pointer to the indirect section.  */
2239     #define bfd_ind_section_ptr (&_bfd_std_section[3])
2240
2241     static inline bfd_boolean
2242     bfd_is_und_section (const asection *sec)
2243     {
2244       return sec == bfd_und_section_ptr;
2245     }
2246
2247     static inline bfd_boolean
2248     bfd_is_abs_section (const asection *sec)
2249     {
2250       return sec == bfd_abs_section_ptr;
2251     }
2252
2253     static inline bfd_boolean
2254     bfd_is_ind_section (const asection *sec)
2255     {
2256       return sec == bfd_ind_section_ptr;
2257     }
2258
2259     static inline bfd_boolean
2260     bfd_is_const_section (const asection *sec)
2261     {
2262       return (sec >= _bfd_std_section
2263               && sec < _bfd_std_section + (sizeof (_bfd_std_section)
2264                                            / sizeof (_bfd_std_section[0])));
2265     }
2266
2267     /* Return TRUE if input section SEC has been discarded.  */
2268     static inline bfd_boolean
2269     discarded_section (const asection *sec)
2270     {
2271       return (!bfd_is_abs_section (sec)
2272               && bfd_is_abs_section (sec->output_section)
2273               && sec->sec_info_type != SEC_INFO_TYPE_MERGE
2274               && sec->sec_info_type != SEC_INFO_TYPE_JUST_SYMS);
2275     }
2276
2277     #define BFD_FAKE_SECTION(SEC, SYM, NAME, IDX, FLAGS)                   \
2278       /* name, id,  section_id, index, next, prev, flags, user_set_vma, */ \
2279       {  NAME, IDX, 0,          0,     NULL, NULL, FLAGS, 0,               \
2280                                                                            \
2281       /* linker_mark, linker_has_input, gc_mark, decompress_status,     */ \
2282          0,           0,                1,       0,                        \
2283                                                                            \
2284       /* segment_mark, sec_info_type, use_rela_p,                       */ \
2285          0,            0,             0,                                   \
2286                                                                            \
2287       /* sec_flg0, sec_flg1, sec_flg2, sec_flg3, sec_flg4, sec_flg5,    */ \
2288          0,        0,        0,        0,        0,        0,              \
2289                                                                            \
2290       /* vma, lma, size, rawsize, compressed_size, relax, relax_count,  */ \
2291          0,   0,   0,    0,       0,               0,     0,               \
2292                                                                            \
2293       /* output_offset, output_section, alignment_power,                */ \
2294          0,             &SEC,           0,                                 \
2295                                                                            \
2296       /* relocation, orelocation, reloc_count, filepos, rel_filepos,    */ \
2297          NULL,       NULL,        0,           0,       0,                 \
2298                                                                            \
2299       /* line_filepos, userdata, contents, lineno, lineno_count,        */ \
2300          0,            NULL,     NULL,     NULL,   0,                      \
2301                                                                            \
2302       /* entsize, kept_section, moving_line_filepos,                    */ \
2303          0,       NULL,         0,                                         \
2304                                                                            \
2305       /* target_index, used_by_bfd, constructor_chain, owner,           */ \
2306          0,            NULL,        NULL,              NULL,               \
2307                                                                            \
2308       /* symbol,                    symbol_ptr_ptr, pattern,            */ \
2309          (struct bfd_symbol *) SYM, &SEC.symbol,    NULL,                  \
2310                                                                            \
2311       /* map_head, map_tail, already_assigned                           */ \
2312          { NULL }, { NULL }, NULL                                          \
2313                                                                            \
2314         }
2315
2316     /* We use a macro to initialize the static asymbol structures because
2317        traditional C does not permit us to initialize a union member while
2318        gcc warns if we don't initialize it.
2319        the_bfd, name, value, attr, section [, udata]  */
2320     #ifdef __STDC__
2321     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2322       { 0, NAME, 0, BSF_SECTION_SYM, SECTION, { 0 }}
2323     #else
2324     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2325       { 0, NAME, 0, BSF_SECTION_SYM, SECTION }
2326     #endif
2327
2328
2329File: bfd.info,  Node: section prototypes,  Prev: typedef asection,  Up: Sections
2330
23312.6.5 Section prototypes
2332------------------------
2333
2334These are the functions exported by the section handling part of BFD.
2335
23362.6.5.1 'bfd_section_list_clear'
2337................................
2338
2339*Synopsis*
2340     void bfd_section_list_clear (bfd *);
2341   *Description*
2342Clears the section list, and also resets the section count and hash
2343table entries.
2344
23452.6.5.2 'bfd_get_section_by_name'
2346.................................
2347
2348*Synopsis*
2349     asection *bfd_get_section_by_name (bfd *abfd, const char *name);
2350   *Description*
2351Return the most recently created section attached to ABFD named NAME.
2352Return NULL if no such section exists.
2353
23542.6.5.3 'bfd_get_next_section_by_name'
2355......................................
2356
2357*Synopsis*
2358     asection *bfd_get_next_section_by_name (bfd *ibfd, asection *sec);
2359   *Description*
2360Given SEC is a section returned by 'bfd_get_section_by_name', return the
2361next most recently created section attached to the same BFD with the
2362same name, or if no such section exists in the same BFD and IBFD is
2363non-NULL, the next section with the same name in any input BFD following
2364IBFD. Return NULL on finding no section.
2365
23662.6.5.4 'bfd_get_linker_section'
2367................................
2368
2369*Synopsis*
2370     asection *bfd_get_linker_section (bfd *abfd, const char *name);
2371   *Description*
2372Return the linker created section attached to ABFD named NAME.  Return
2373NULL if no such section exists.
2374
23752.6.5.5 'bfd_get_section_by_name_if'
2376....................................
2377
2378*Synopsis*
2379     asection *bfd_get_section_by_name_if
2380        (bfd *abfd,
2381         const char *name,
2382         bfd_boolean (*func) (bfd *abfd, asection *sect, void *obj),
2383         void *obj);
2384   *Description*
2385Call the provided function FUNC for each section attached to the BFD
2386ABFD whose name matches NAME, passing OBJ as an argument.  The function
2387will be called as if by
2388
2389            func (abfd, the_section, obj);
2390
2391   It returns the first section for which FUNC returns true, otherwise
2392'NULL'.
2393
23942.6.5.6 'bfd_get_unique_section_name'
2395.....................................
2396
2397*Synopsis*
2398     char *bfd_get_unique_section_name
2399        (bfd *abfd, const char *templat, int *count);
2400   *Description*
2401Invent a section name that is unique in ABFD by tacking a dot and a
2402digit suffix onto the original TEMPLAT.  If COUNT is non-NULL, then it
2403specifies the first number tried as a suffix to generate a unique name.
2404The value pointed to by COUNT will be incremented in this case.
2405
24062.6.5.7 'bfd_make_section_old_way'
2407..................................
2408
2409*Synopsis*
2410     asection *bfd_make_section_old_way (bfd *abfd, const char *name);
2411   *Description*
2412Create a new empty section called NAME and attach it to the end of the
2413chain of sections for the BFD ABFD.  An attempt to create a section with
2414a name which is already in use returns its pointer without changing the
2415section chain.
2416
2417   It has the funny name since this is the way it used to be before it
2418was rewritten....
2419
2420   Possible errors are:
2421
2422   * 'bfd_error_invalid_operation' - If output has already started for
2423     this BFD.
2424   * 'bfd_error_no_memory' - If memory allocation fails.
2425
24262.6.5.8 'bfd_make_section_anyway_with_flags'
2427............................................
2428
2429*Synopsis*
2430     asection *bfd_make_section_anyway_with_flags
2431        (bfd *abfd, const char *name, flagword flags);
2432   *Description*
2433Create a new empty section called NAME and attach it to the end of the
2434chain of sections for ABFD.  Create a new section even if there is
2435already a section with that name.  Also set the attributes of the new
2436section to the value FLAGS.
2437
2438   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2439
2440   * 'bfd_error_invalid_operation' - If output has already started for
2441     ABFD.
2442   * 'bfd_error_no_memory' - If memory allocation fails.
2443
24442.6.5.9 'bfd_make_section_anyway'
2445.................................
2446
2447*Synopsis*
2448     asection *bfd_make_section_anyway (bfd *abfd, const char *name);
2449   *Description*
2450Create a new empty section called NAME and attach it to the end of the
2451chain of sections for ABFD.  Create a new section even if there is
2452already a section with that name.
2453
2454   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2455
2456   * 'bfd_error_invalid_operation' - If output has already started for
2457     ABFD.
2458   * 'bfd_error_no_memory' - If memory allocation fails.
2459
24602.6.5.10 'bfd_make_section_with_flags'
2461......................................
2462
2463*Synopsis*
2464     asection *bfd_make_section_with_flags
2465        (bfd *, const char *name, flagword flags);
2466   *Description*
2467Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2468bfd_set_error ()) without changing the section chain if there is already
2469a section named NAME.  Also set the attributes of the new section to the
2470value FLAGS.  If there is an error, return 'NULL' and set 'bfd_error'.
2471
24722.6.5.11 'bfd_make_section'
2473...........................
2474
2475*Synopsis*
2476     asection *bfd_make_section (bfd *, const char *name);
2477   *Description*
2478Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2479bfd_set_error ()) without changing the section chain if there is already
2480a section named NAME.  If there is an error, return 'NULL' and set
2481'bfd_error'.
2482
24832.6.5.12 'bfd_set_section_flags'
2484................................
2485
2486*Synopsis*
2487     bfd_boolean bfd_set_section_flags (asection *sec, flagword flags);
2488   *Description*
2489Set the attributes of the section SEC to the value FLAGS.  Return 'TRUE'
2490on success, 'FALSE' on error.  Possible error returns are:
2491
2492   * 'bfd_error_invalid_operation' - The section cannot have one or more
2493     of the attributes requested.  For example, a .bss section in
2494     'a.out' may not have the 'SEC_HAS_CONTENTS' field set.
2495
24962.6.5.13 'bfd_rename_section'
2497.............................
2498
2499*Synopsis*
2500     void bfd_rename_section
2501        (asection *sec, const char *newname);
2502   *Description*
2503Rename section SEC to NEWNAME.
2504
25052.6.5.14 'bfd_map_over_sections'
2506................................
2507
2508*Synopsis*
2509     void bfd_map_over_sections
2510        (bfd *abfd,
2511         void (*func) (bfd *abfd, asection *sect, void *obj),
2512         void *obj);
2513   *Description*
2514Call the provided function FUNC for each section attached to the BFD
2515ABFD, passing OBJ as an argument.  The function will be called as if by
2516
2517            func (abfd, the_section, obj);
2518
2519   This is the preferred method for iterating over sections; an
2520alternative would be to use a loop:
2521
2522               asection *p;
2523               for (p = abfd->sections; p != NULL; p = p->next)
2524                  func (abfd, p, ...)
2525
25262.6.5.15 'bfd_sections_find_if'
2527...............................
2528
2529*Synopsis*
2530     asection *bfd_sections_find_if
2531        (bfd *abfd,
2532         bfd_boolean (*operation) (bfd *abfd, asection *sect, void *obj),
2533         void *obj);
2534   *Description*
2535Call the provided function OPERATION for each section attached to the
2536BFD ABFD, passing OBJ as an argument.  The function will be called as if
2537by
2538
2539            operation (abfd, the_section, obj);
2540
2541   It returns the first section for which OPERATION returns true.
2542
25432.6.5.16 'bfd_set_section_size'
2544...............................
2545
2546*Synopsis*
2547     bfd_boolean bfd_set_section_size (asection *sec, bfd_size_type val);
2548   *Description*
2549Set SEC to the size VAL.  If the operation is ok, then 'TRUE' is
2550returned, else 'FALSE'.
2551
2552   Possible error returns:
2553
2554   * 'bfd_error_invalid_operation' - Writing has started to the BFD, so
2555     setting the size is invalid.
2556
25572.6.5.17 'bfd_set_section_contents'
2558...................................
2559
2560*Synopsis*
2561     bfd_boolean bfd_set_section_contents
2562        (bfd *abfd, asection *section, const void *data,
2563         file_ptr offset, bfd_size_type count);
2564   *Description*
2565Sets the contents of the section SECTION in BFD ABFD to the data
2566starting in memory at LOCATION.  The data is written to the output
2567section starting at offset OFFSET for COUNT octets.
2568
2569   Normally 'TRUE' is returned, but 'FALSE' is returned if there was an
2570error.  Possible error returns are:
2571
2572   * 'bfd_error_no_contents' - The output section does not have the
2573     'SEC_HAS_CONTENTS' attribute, so nothing can be written to it.
2574   * 'bfd_error_bad_value' - The section is unable to contain all of the
2575     data.
2576   * 'bfd_error_invalid_operation' - The BFD is not writeable.
2577   * and some more too.
2578   This routine is front end to the back end function
2579'_bfd_set_section_contents'.
2580
25812.6.5.18 'bfd_get_section_contents'
2582...................................
2583
2584*Synopsis*
2585     bfd_boolean bfd_get_section_contents
2586        (bfd *abfd, asection *section, void *location, file_ptr offset,
2587         bfd_size_type count);
2588   *Description*
2589Read data from SECTION in BFD ABFD into memory starting at LOCATION.
2590The data is read at an offset of OFFSET from the start of the input
2591section, and is read for COUNT bytes.
2592
2593   If the contents of a constructor with the 'SEC_CONSTRUCTOR' flag set
2594are requested or if the section does not have the 'SEC_HAS_CONTENTS'
2595flag set, then the LOCATION is filled with zeroes.  If no errors occur,
2596'TRUE' is returned, else 'FALSE'.
2597
25982.6.5.19 'bfd_malloc_and_get_section'
2599.....................................
2600
2601*Synopsis*
2602     bfd_boolean bfd_malloc_and_get_section
2603        (bfd *abfd, asection *section, bfd_byte **buf);
2604   *Description*
2605Read all data from SECTION in BFD ABFD into a buffer, *BUF, malloc'd by
2606this function.
2607
26082.6.5.20 'bfd_copy_private_section_data'
2609........................................
2610
2611*Synopsis*
2612     bfd_boolean bfd_copy_private_section_data
2613        (bfd *ibfd, asection *isec, bfd *obfd, asection *osec);
2614   *Description*
2615Copy private section information from ISEC in the BFD IBFD to the
2616section OSEC in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on
2617error.  Possible error returns are:
2618
2619   * 'bfd_error_no_memory' - Not enough memory exists to create private
2620     data for OSEC.
2621     #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
2622            BFD_SEND (obfd, _bfd_copy_private_section_data, \
2623                      (ibfd, isection, obfd, osection))
2624
26252.6.5.21 'bfd_generic_is_group_section'
2626.......................................
2627
2628*Synopsis*
2629     bfd_boolean bfd_generic_is_group_section (bfd *, const asection *sec);
2630   *Description*
2631Returns TRUE if SEC is a member of a group.
2632
26332.6.5.22 'bfd_generic_group_name'
2634.................................
2635
2636*Synopsis*
2637     const char *bfd_generic_group_name (bfd *, const asection *sec);
2638   *Description*
2639Returns group name if SEC is a member of a group.
2640
26412.6.5.23 'bfd_generic_discard_group'
2642....................................
2643
2644*Synopsis*
2645     bfd_boolean bfd_generic_discard_group (bfd *abfd, asection *group);
2646   *Description*
2647Remove all members of GROUP from the output.
2648
2649
2650File: bfd.info,  Node: Symbols,  Next: Archives,  Prev: Sections,  Up: BFD front end
2651
26522.7 Symbols
2653===========
2654
2655BFD tries to maintain as much symbol information as it can when it moves
2656information from file to file.  BFD passes information to applications
2657though the 'asymbol' structure.  When the application requests the
2658symbol table, BFD reads the table in the native form and translates
2659parts of it into the internal format.  To maintain more than the
2660information passed to applications, some targets keep some information
2661"behind the scenes" in a structure only the particular back end knows
2662about.  For example, the coff back end keeps the original symbol table
2663structure as well as the canonical structure when a BFD is read in.  On
2664output, the coff back end can reconstruct the output symbol table so
2665that no information is lost, even information unique to coff which BFD
2666doesn't know or understand.  If a coff symbol table were read, but were
2667written through an a.out back end, all the coff specific information
2668would be lost.  The symbol table of a BFD is not necessarily read in
2669until a canonicalize request is made.  Then the BFD back end fills in a
2670table provided by the application with pointers to the canonical
2671information.  To output symbols, the application provides BFD with a
2672table of pointers to pointers to 'asymbol's.  This allows applications
2673like the linker to output a symbol as it was read, since the "behind the
2674scenes" information will be still available.
2675* Menu:
2676
2677* Reading Symbols::
2678* Writing Symbols::
2679* Mini Symbols::
2680* typedef asymbol::
2681* symbol handling functions::
2682
2683
2684File: bfd.info,  Node: Reading Symbols,  Next: Writing Symbols,  Prev: Symbols,  Up: Symbols
2685
26862.7.1 Reading symbols
2687---------------------
2688
2689There are two stages to reading a symbol table from a BFD: allocating
2690storage, and the actual reading process.  This is an excerpt from an
2691application which reads the symbol table:
2692
2693              long storage_needed;
2694              asymbol **symbol_table;
2695              long number_of_symbols;
2696              long i;
2697
2698              storage_needed = bfd_get_symtab_upper_bound (abfd);
2699
2700              if (storage_needed < 0)
2701                FAIL
2702
2703              if (storage_needed == 0)
2704                return;
2705
2706              symbol_table = xmalloc (storage_needed);
2707                ...
2708              number_of_symbols =
2709                 bfd_canonicalize_symtab (abfd, symbol_table);
2710
2711              if (number_of_symbols < 0)
2712                FAIL
2713
2714              for (i = 0; i < number_of_symbols; i++)
2715                process_symbol (symbol_table[i]);
2716
2717   All storage for the symbols themselves is in an objalloc connected to
2718the BFD; it is freed when the BFD is closed.
2719
2720
2721File: bfd.info,  Node: Writing Symbols,  Next: Mini Symbols,  Prev: Reading Symbols,  Up: Symbols
2722
27232.7.2 Writing symbols
2724---------------------
2725
2726Writing of a symbol table is automatic when a BFD open for writing is
2727closed.  The application attaches a vector of pointers to pointers to
2728symbols to the BFD being written, and fills in the symbol count.  The
2729close and cleanup code reads through the table provided and performs all
2730the necessary operations.  The BFD output code must always be provided
2731with an "owned" symbol: one which has come from another BFD, or one
2732which has been created using 'bfd_make_empty_symbol'.  Here is an
2733example showing the creation of a symbol table with only one element:
2734
2735            #include "sysdep.h"
2736            #include "bfd.h"
2737            int main (void)
2738            {
2739              bfd *abfd;
2740              asymbol *ptrs[2];
2741              asymbol *new;
2742
2743              abfd = bfd_openw ("foo","a.out-sunos-big");
2744              bfd_set_format (abfd, bfd_object);
2745              new = bfd_make_empty_symbol (abfd);
2746              new->name = "dummy_symbol";
2747              new->section = bfd_make_section_old_way (abfd, ".text");
2748              new->flags = BSF_GLOBAL;
2749              new->value = 0x12345;
2750
2751              ptrs[0] = new;
2752              ptrs[1] = 0;
2753
2754              bfd_set_symtab (abfd, ptrs, 1);
2755              bfd_close (abfd);
2756              return 0;
2757            }
2758
2759            ./makesym
2760            nm foo
2761            00012345 A dummy_symbol
2762
2763   Many formats cannot represent arbitrary symbol information; for
2764instance, the 'a.out' object format does not allow an arbitrary number
2765of sections.  A symbol pointing to a section which is not one of
2766'.text', '.data' or '.bss' cannot be described.
2767
2768
2769File: bfd.info,  Node: Mini Symbols,  Next: typedef asymbol,  Prev: Writing Symbols,  Up: Symbols
2770
27712.7.3 Mini Symbols
2772------------------
2773
2774Mini symbols provide read-only access to the symbol table.  They use
2775less memory space, but require more time to access.  They can be useful
2776for tools like nm or objdump, which may have to handle symbol tables of
2777extremely large executables.
2778
2779   The 'bfd_read_minisymbols' function will read the symbols into memory
2780in an internal form.  It will return a 'void *' pointer to a block of
2781memory, a symbol count, and the size of each symbol.  The pointer is
2782allocated using 'malloc', and should be freed by the caller when it is
2783no longer needed.
2784
2785   The function 'bfd_minisymbol_to_symbol' will take a pointer to a
2786minisymbol, and a pointer to a structure returned by
2787'bfd_make_empty_symbol', and return a 'asymbol' structure.  The return
2788value may or may not be the same as the value from
2789'bfd_make_empty_symbol' which was passed in.
2790
2791
2792File: bfd.info,  Node: typedef asymbol,  Next: symbol handling functions,  Prev: Mini Symbols,  Up: Symbols
2793
27942.7.4 typedef asymbol
2795---------------------
2796
2797An 'asymbol' has the form:
2798
2799
2800     typedef struct bfd_symbol
2801     {
2802       /* A pointer to the BFD which owns the symbol. This information
2803          is necessary so that a back end can work out what additional
2804          information (invisible to the application writer) is carried
2805          with the symbol.
2806
2807          This field is *almost* redundant, since you can use section->owner
2808          instead, except that some symbols point to the global sections
2809          bfd_{abs,com,und}_section.  This could be fixed by making
2810          these globals be per-bfd (or per-target-flavor).  FIXME.  */
2811       struct bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field.  */
2812
2813       /* The text of the symbol. The name is left alone, and not copied; the
2814          application may not alter it.  */
2815       const char *name;
2816
2817       /* The value of the symbol.  This really should be a union of a
2818          numeric value with a pointer, since some flags indicate that
2819          a pointer to another symbol is stored here.  */
2820       symvalue value;
2821
2822       /* Attributes of a symbol.  */
2823     #define BSF_NO_FLAGS            0
2824
2825       /* The symbol has local scope; static in C. The value
2826          is the offset into the section of the data.  */
2827     #define BSF_LOCAL               (1 << 0)
2828
2829       /* The symbol has global scope; initialized data in C. The
2830          value is the offset into the section of the data.  */
2831     #define BSF_GLOBAL              (1 << 1)
2832
2833       /* The symbol has global scope and is exported. The value is
2834          the offset into the section of the data.  */
2835     #define BSF_EXPORT              BSF_GLOBAL /* No real difference.  */
2836
2837       /* A normal C symbol would be one of:
2838          BSF_LOCAL, BSF_UNDEFINED or BSF_GLOBAL.  */
2839
2840       /* The symbol is a debugging record. The value has an arbitrary
2841          meaning, unless BSF_DEBUGGING_RELOC is also set.  */
2842     #define BSF_DEBUGGING           (1 << 2)
2843
2844       /* The symbol denotes a function entry point.  Used in ELF,
2845          perhaps others someday.  */
2846     #define BSF_FUNCTION            (1 << 3)
2847
2848       /* Used by the linker.  */
2849     #define BSF_KEEP                (1 << 5)
2850
2851       /* An ELF common symbol.  */
2852     #define BSF_ELF_COMMON          (1 << 6)
2853
2854       /* A weak global symbol, overridable without warnings by
2855          a regular global symbol of the same name.  */
2856     #define BSF_WEAK                (1 << 7)
2857
2858       /* This symbol was created to point to a section, e.g. ELF's
2859          STT_SECTION symbols.  */
2860     #define BSF_SECTION_SYM         (1 << 8)
2861
2862       /* The symbol used to be a common symbol, but now it is
2863          allocated.  */
2864     #define BSF_OLD_COMMON          (1 << 9)
2865
2866       /* In some files the type of a symbol sometimes alters its
2867          location in an output file - ie in coff a ISFCN symbol
2868          which is also C_EXT symbol appears where it was
2869          declared and not at the end of a section.  This bit is set
2870          by the target BFD part to convey this information.  */
2871     #define BSF_NOT_AT_END          (1 << 10)
2872
2873       /* Signal that the symbol is the label of constructor section.  */
2874     #define BSF_CONSTRUCTOR         (1 << 11)
2875
2876       /* Signal that the symbol is a warning symbol.  The name is a
2877          warning.  The name of the next symbol is the one to warn about;
2878          if a reference is made to a symbol with the same name as the next
2879          symbol, a warning is issued by the linker.  */
2880     #define BSF_WARNING             (1 << 12)
2881
2882       /* Signal that the symbol is indirect.  This symbol is an indirect
2883          pointer to the symbol with the same name as the next symbol.  */
2884     #define BSF_INDIRECT            (1 << 13)
2885
2886       /* BSF_FILE marks symbols that contain a file name.  This is used
2887          for ELF STT_FILE symbols.  */
2888     #define BSF_FILE                (1 << 14)
2889
2890       /* Symbol is from dynamic linking information.  */
2891     #define BSF_DYNAMIC             (1 << 15)
2892
2893       /* The symbol denotes a data object.  Used in ELF, and perhaps
2894          others someday.  */
2895     #define BSF_OBJECT              (1 << 16)
2896
2897       /* This symbol is a debugging symbol.  The value is the offset
2898          into the section of the data.  BSF_DEBUGGING should be set
2899          as well.  */
2900     #define BSF_DEBUGGING_RELOC     (1 << 17)
2901
2902       /* This symbol is thread local.  Used in ELF.  */
2903     #define BSF_THREAD_LOCAL        (1 << 18)
2904
2905       /* This symbol represents a complex relocation expression,
2906          with the expression tree serialized in the symbol name.  */
2907     #define BSF_RELC                (1 << 19)
2908
2909       /* This symbol represents a signed complex relocation expression,
2910          with the expression tree serialized in the symbol name.  */
2911     #define BSF_SRELC               (1 << 20)
2912
2913       /* This symbol was created by bfd_get_synthetic_symtab.  */
2914     #define BSF_SYNTHETIC           (1 << 21)
2915
2916       /* This symbol is an indirect code object.  Unrelated to BSF_INDIRECT.
2917          The dynamic linker will compute the value of this symbol by
2918          calling the function that it points to.  BSF_FUNCTION must
2919          also be also set.  */
2920     #define BSF_GNU_INDIRECT_FUNCTION (1 << 22)
2921       /* This symbol is a globally unique data object.  The dynamic linker
2922          will make sure that in the entire process there is just one symbol
2923          with this name and type in use.  BSF_OBJECT must also be set.  */
2924     #define BSF_GNU_UNIQUE          (1 << 23)
2925
2926       /* This section symbol should be included in the symbol table.  */
2927     #define BSF_SECTION_SYM_USED    (1 << 24)
2928
2929       flagword flags;
2930
2931       /* A pointer to the section to which this symbol is
2932          relative.  This will always be non NULL, there are special
2933          sections for undefined and absolute symbols.  */
2934       struct bfd_section *section;
2935
2936       /* Back end special data.  */
2937       union
2938         {
2939           void *p;
2940           bfd_vma i;
2941         }
2942       udata;
2943     }
2944     asymbol;
2945
2946
2947File: bfd.info,  Node: symbol handling functions,  Prev: typedef asymbol,  Up: Symbols
2948
29492.7.5 Symbol handling functions
2950-------------------------------
2951
29522.7.5.1 'bfd_get_symtab_upper_bound'
2953....................................
2954
2955*Description*
2956Return the number of bytes required to store a vector of pointers to
2957'asymbols' for all the symbols in the BFD ABFD, including a terminal
2958NULL pointer.  If there are no symbols in the BFD, then return 0.  If an
2959error occurs, return -1.
2960     #define bfd_get_symtab_upper_bound(abfd) \
2961            BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
2962
29632.7.5.2 'bfd_is_local_label'
2964............................
2965
2966*Synopsis*
2967     bfd_boolean bfd_is_local_label (bfd *abfd, asymbol *sym);
2968   *Description*
2969Return TRUE if the given symbol SYM in the BFD ABFD is a compiler
2970generated local label, else return FALSE.
2971
29722.7.5.3 'bfd_is_local_label_name'
2973.................................
2974
2975*Synopsis*
2976     bfd_boolean bfd_is_local_label_name (bfd *abfd, const char *name);
2977   *Description*
2978Return TRUE if a symbol with the name NAME in the BFD ABFD is a compiler
2979generated local label, else return FALSE. This just checks whether the
2980name has the form of a local label.
2981     #define bfd_is_local_label_name(abfd, name) \
2982            BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
2983
29842.7.5.4 'bfd_is_target_special_symbol'
2985......................................
2986
2987*Synopsis*
2988     bfd_boolean bfd_is_target_special_symbol (bfd *abfd, asymbol *sym);
2989   *Description*
2990Return TRUE iff a symbol SYM in the BFD ABFD is something special to the
2991particular target represented by the BFD. Such symbols should normally
2992not be mentioned to the user.
2993     #define bfd_is_target_special_symbol(abfd, sym) \
2994            BFD_SEND (abfd, _bfd_is_target_special_symbol, (abfd, sym))
2995
29962.7.5.5 'bfd_canonicalize_symtab'
2997.................................
2998
2999*Description*
3000Read the symbols from the BFD ABFD, and fills in the vector LOCATION
3001with pointers to the symbols and a trailing NULL. Return the actual
3002number of symbol pointers, not including the NULL.
3003     #define bfd_canonicalize_symtab(abfd, location) \
3004            BFD_SEND (abfd, _bfd_canonicalize_symtab, (abfd, location))
3005
30062.7.5.6 'bfd_set_symtab'
3007........................
3008
3009*Synopsis*
3010     bfd_boolean bfd_set_symtab
3011        (bfd *abfd, asymbol **location, unsigned int count);
3012   *Description*
3013Arrange that when the output BFD ABFD is closed, the table LOCATION of
3014COUNT pointers to symbols will be written.
3015
30162.7.5.7 'bfd_print_symbol_vandf'
3017................................
3018
3019*Synopsis*
3020     void bfd_print_symbol_vandf (bfd *abfd, void *file, asymbol *symbol);
3021   *Description*
3022Print the value and flags of the SYMBOL supplied to the stream FILE.
3023
30242.7.5.8 'bfd_make_empty_symbol'
3025...............................
3026
3027*Description*
3028Create a new 'asymbol' structure for the BFD ABFD and return a pointer
3029to it.
3030
3031   This routine is necessary because each back end has private
3032information surrounding the 'asymbol'.  Building your own 'asymbol' and
3033pointing to it will not create the private information, and will cause
3034problems later on.
3035     #define bfd_make_empty_symbol(abfd) \
3036            BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
3037
30382.7.5.9 '_bfd_generic_make_empty_symbol'
3039........................................
3040
3041*Synopsis*
3042     asymbol *_bfd_generic_make_empty_symbol (bfd *);
3043   *Description*
3044Create a new 'asymbol' structure for the BFD ABFD and return a pointer
3045to it.  Used by core file routines, binary back-end and anywhere else
3046where no private info is needed.
3047
30482.7.5.10 'bfd_make_debug_symbol'
3049................................
3050
3051*Description*
3052Create a new 'asymbol' structure for the BFD ABFD, to be used as a
3053debugging symbol.  Further details of its use have yet to be worked out.
3054     #define bfd_make_debug_symbol(abfd,ptr,size) \
3055            BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
3056
30572.7.5.11 'bfd_decode_symclass'
3058..............................
3059
3060*Description*
3061Return a character corresponding to the symbol class of SYMBOL, or '?'
3062for an unknown class.
3063
3064   *Synopsis*
3065     int bfd_decode_symclass (asymbol *symbol);
3066
30672.7.5.12 'bfd_is_undefined_symclass'
3068....................................
3069
3070*Description*
3071Returns non-zero if the class symbol returned by bfd_decode_symclass
3072represents an undefined symbol.  Returns zero otherwise.
3073
3074   *Synopsis*
3075     bfd_boolean bfd_is_undefined_symclass (int symclass);
3076
30772.7.5.13 'bfd_symbol_info'
3078..........................
3079
3080*Description*
3081Fill in the basic info about symbol that nm needs.  Additional info may
3082be added by the back-ends after calling this function.
3083
3084   *Synopsis*
3085     void bfd_symbol_info (asymbol *symbol, symbol_info *ret);
3086
30872.7.5.14 'bfd_copy_private_symbol_data'
3088.......................................
3089
3090*Synopsis*
3091     bfd_boolean bfd_copy_private_symbol_data
3092        (bfd *ibfd, asymbol *isym, bfd *obfd, asymbol *osym);
3093   *Description*
3094Copy private symbol information from ISYM in the BFD IBFD to the symbol
3095OSYM in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on error.
3096Possible error returns are:
3097
3098   * 'bfd_error_no_memory' - Not enough memory exists to create private
3099     data for OSEC.
3100     #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
3101            BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
3102                      (ibfd, isymbol, obfd, osymbol))
3103
3104
3105File: bfd.info,  Node: Archives,  Next: Formats,  Prev: Symbols,  Up: BFD front end
3106
31072.8 Archives
3108============
3109
3110*Description*
3111An archive (or library) is just another BFD. It has a symbol table,
3112although there's not much a user program will do with it.
3113
3114   The big difference between an archive BFD and an ordinary BFD is that
3115the archive doesn't have sections.  Instead it has a chain of BFDs that
3116are considered its contents.  These BFDs can be manipulated like any
3117other.  The BFDs contained in an archive opened for reading will all be
3118opened for reading.  You may put either input or output BFDs into an
3119archive opened for output; they will be handled correctly when the
3120archive is closed.
3121
3122   Use 'bfd_openr_next_archived_file' to step through the contents of an
3123archive opened for input.  You don't have to read the entire archive if
3124you don't want to!  Read it until you find what you want.
3125
3126   A BFD returned by 'bfd_openr_next_archived_file' can be closed
3127manually with 'bfd_close'.  If you do not close it, then a second
3128iteration through the members of an archive may return the same BFD. If
3129you close the archive BFD, then all the member BFDs will automatically
3130be closed as well.
3131
3132   Archive contents of output BFDs are chained through the
3133'archive_next' pointer in a BFD. The first one is findable through the
3134'archive_head' slot of the archive.  Set it with 'bfd_set_archive_head'
3135(q.v.).  A given BFD may be in only one open output archive at a time.
3136
3137   As expected, the BFD archive code is more general than the archive
3138code of any given environment.  BFD archives may contain files of
3139different formats (e.g., a.out and coff) and even different
3140architectures.  You may even place archives recursively into archives!
3141
3142   This can cause unexpected confusion, since some archive formats are
3143more expressive than others.  For instance, Intel COFF archives can
3144preserve long filenames; SunOS a.out archives cannot.  If you move a
3145file from the first to the second format and back again, the filename
3146may be truncated.  Likewise, different a.out environments have different
3147conventions as to how they truncate filenames, whether they preserve
3148directory names in filenames, etc.  When interoperating with native
3149tools, be sure your files are homogeneous.
3150
3151   Beware: most of these formats do not react well to the presence of
3152spaces in filenames.  We do the best we can, but can't always handle
3153this case due to restrictions in the format of archives.  Many Unix
3154utilities are braindead in regards to spaces and such in filenames
3155anyway, so this shouldn't be much of a restriction.
3156
3157   Archives are supported in BFD in 'archive.c'.
3158
31592.8.1 Archive functions
3160-----------------------
3161
31622.8.1.1 'bfd_get_next_mapent'
3163.............................
3164
3165*Synopsis*
3166     symindex bfd_get_next_mapent
3167        (bfd *abfd, symindex previous, carsym **sym);
3168   *Description*
3169Step through archive ABFD's symbol table (if it has one).  Successively
3170update SYM with the next symbol's information, returning that symbol's
3171(internal) index into the symbol table.
3172
3173   Supply 'BFD_NO_MORE_SYMBOLS' as the PREVIOUS entry to get the first
3174one; returns 'BFD_NO_MORE_SYMBOLS' when you've already got the last one.
3175
3176   A 'carsym' is a canonical archive symbol.  The only user-visible
3177element is its name, a null-terminated string.
3178
31792.8.1.2 'bfd_set_archive_head'
3180..............................
3181
3182*Synopsis*
3183     bfd_boolean bfd_set_archive_head (bfd *output, bfd *new_head);
3184   *Description*
3185Set the head of the chain of BFDs contained in the archive OUTPUT to
3186NEW_HEAD.
3187
31882.8.1.3 'bfd_openr_next_archived_file'
3189......................................
3190
3191*Synopsis*
3192     bfd *bfd_openr_next_archived_file (bfd *archive, bfd *previous);
3193   *Description*
3194Provided a BFD, ARCHIVE, containing an archive and NULL, open an input
3195BFD on the first contained element and returns that.  Subsequent calls
3196should pass the archive and the previous return value to return a
3197created BFD to the next contained element.  NULL is returned when there
3198are no more.  Note - if you want to process the bfd returned by this
3199call be sure to call bfd_check_format() on it first.
3200
3201
3202File: bfd.info,  Node: Formats,  Next: Relocations,  Prev: Archives,  Up: BFD front end
3203
32042.9 File formats
3205================
3206
3207A format is a BFD concept of high level file contents type.  The formats
3208supported by BFD are:
3209
3210   * 'bfd_object'
3211   The BFD may contain data, symbols, relocations and debug info.
3212
3213   * 'bfd_archive'
3214   The BFD contains other BFDs and an optional index.
3215
3216   * 'bfd_core'
3217   The BFD contains the result of an executable core dump.
3218
32192.9.1 File format functions
3220---------------------------
3221
32222.9.1.1 'bfd_check_format'
3223..........................
3224
3225*Synopsis*
3226     bfd_boolean bfd_check_format (bfd *abfd, bfd_format format);
3227   *Description*
3228Verify if the file attached to the BFD ABFD is compatible with the
3229format FORMAT (i.e., one of 'bfd_object', 'bfd_archive' or 'bfd_core').
3230
3231   If the BFD has been set to a specific target before the call, only
3232the named target and format combination is checked.  If the target has
3233not been set, or has been set to 'default', then all the known target
3234backends is interrogated to determine a match.  If the default target
3235matches, it is used.  If not, exactly one target must recognize the
3236file, or an error results.
3237
3238   The function returns 'TRUE' on success, otherwise 'FALSE' with one of
3239the following error codes:
3240
3241   * 'bfd_error_invalid_operation' - if 'format' is not one of
3242     'bfd_object', 'bfd_archive' or 'bfd_core'.
3243
3244   * 'bfd_error_system_call' - if an error occured during a read - even
3245     some file mismatches can cause bfd_error_system_calls.
3246
3247   * 'file_not_recognised' - none of the backends recognised the file
3248     format.
3249
3250   * 'bfd_error_file_ambiguously_recognized' - more than one backend
3251     recognised the file format.
3252
32532.9.1.2 'bfd_check_format_matches'
3254..................................
3255
3256*Synopsis*
3257     bfd_boolean bfd_check_format_matches
3258        (bfd *abfd, bfd_format format, char ***matching);
3259   *Description*
3260Like 'bfd_check_format', except when it returns FALSE with 'bfd_errno'
3261set to 'bfd_error_file_ambiguously_recognized'.  In that case, if
3262MATCHING is not NULL, it will be filled in with a NULL-terminated list
3263of the names of the formats that matched, allocated with 'malloc'.  Then
3264the user may choose a format and try again.
3265
3266   When done with the list that MATCHING points to, the caller should
3267free it.
3268
32692.9.1.3 'bfd_set_format'
3270........................
3271
3272*Synopsis*
3273     bfd_boolean bfd_set_format (bfd *abfd, bfd_format format);
3274   *Description*
3275This function sets the file format of the BFD ABFD to the format FORMAT.
3276If the target set in the BFD does not support the format requested, the
3277format is invalid, or the BFD is not open for writing, then an error
3278occurs.
3279
32802.9.1.4 'bfd_format_string'
3281...........................
3282
3283*Synopsis*
3284     const char *bfd_format_string (bfd_format format);
3285   *Description*
3286Return a pointer to a const string 'invalid', 'object', 'archive',
3287'core', or 'unknown', depending upon the value of FORMAT.
3288
3289
3290File: bfd.info,  Node: Relocations,  Next: Core Files,  Prev: Formats,  Up: BFD front end
3291
32922.10 Relocations
3293================
3294
3295BFD maintains relocations in much the same way it maintains symbols:
3296they are left alone until required, then read in en-masse and translated
3297into an internal form.  A common routine 'bfd_perform_relocation' acts
3298upon the canonical form to do the fixup.
3299
3300   Relocations are maintained on a per section basis, while symbols are
3301maintained on a per BFD basis.
3302
3303   All that a back end has to do to fit the BFD interface is to create a
3304'struct reloc_cache_entry' for each relocation in a particular section,
3305and fill in the right bits of the structures.
3306
3307* Menu:
3308
3309* typedef arelent::
3310* howto manager::
3311
3312
3313File: bfd.info,  Node: typedef arelent,  Next: howto manager,  Prev: Relocations,  Up: Relocations
3314
33152.10.1 typedef arelent
3316----------------------
3317
3318This is the structure of a relocation entry:
3319
3320
3321     typedef enum bfd_reloc_status
3322     {
3323       /* No errors detected.  Note - the value 2 is used so that it
3324          will not be mistaken for the boolean TRUE or FALSE values.  */
3325       bfd_reloc_ok = 2,
3326
3327       /* The relocation was performed, but there was an overflow.  */
3328       bfd_reloc_overflow,
3329
3330       /* The address to relocate was not within the section supplied.  */
3331       bfd_reloc_outofrange,
3332
3333       /* Used by special functions.  */
3334       bfd_reloc_continue,
3335
3336       /* Unsupported relocation size requested.  */
3337       bfd_reloc_notsupported,
3338
3339       /* Unused.  */
3340       bfd_reloc_other,
3341
3342       /* The symbol to relocate against was undefined.  */
3343       bfd_reloc_undefined,
3344
3345       /* The relocation was performed, but may not be ok.  If this type is
3346          returned, the error_message argument to bfd_perform_relocation
3347          will be set.  */
3348       bfd_reloc_dangerous
3349      }
3350      bfd_reloc_status_type;
3351
3352     typedef const struct reloc_howto_struct reloc_howto_type;
3353
3354     typedef struct reloc_cache_entry
3355     {
3356       /* A pointer into the canonical table of pointers.  */
3357       struct bfd_symbol **sym_ptr_ptr;
3358
3359       /* offset in section.  */
3360       bfd_size_type address;
3361
3362       /* addend for relocation value.  */
3363       bfd_vma addend;
3364
3365       /* Pointer to how to perform the required relocation.  */
3366       reloc_howto_type *howto;
3367
3368     }
3369     arelent;
3370
3371   *Description*
3372Here is a description of each of the fields within an 'arelent':
3373
3374   * 'sym_ptr_ptr'
3375   The symbol table pointer points to a pointer to the symbol associated
3376with the relocation request.  It is the pointer into the table returned
3377by the back end's 'canonicalize_symtab' action.  *Note Symbols::.  The
3378symbol is referenced through a pointer to a pointer so that tools like
3379the linker can fix up all the symbols of the same name by modifying only
3380one pointer.  The relocation routine looks in the symbol and uses the
3381base of the section the symbol is attached to and the value of the
3382symbol as the initial relocation offset.  If the symbol pointer is zero,
3383then the section provided is looked up.
3384
3385   * 'address'
3386   The 'address' field gives the offset in bytes from the base of the
3387section data which owns the relocation record to the first byte of
3388relocatable information.  The actual data relocated will be relative to
3389this point; for example, a relocation type which modifies the bottom two
3390bytes of a four byte word would not touch the first byte pointed to in a
3391big endian world.
3392
3393   * 'addend'
3394   The 'addend' is a value provided by the back end to be added (!)  to
3395the relocation offset.  Its interpretation is dependent upon the howto.
3396For example, on the 68k the code:
3397
3398             char foo[];
3399             main()
3400                     {
3401                     return foo[0x12345678];
3402                     }
3403
3404   Could be compiled into:
3405
3406             linkw fp,#-4
3407             moveb @#12345678,d0
3408             extbl d0
3409             unlk fp
3410             rts
3411
3412   This could create a reloc pointing to 'foo', but leave the offset in
3413the data, something like:
3414
3415     RELOCATION RECORDS FOR [.text]:
3416     offset   type      value
3417     00000006 32        _foo
3418
3419     00000000 4e56 fffc          ; linkw fp,#-4
3420     00000004 1039 1234 5678     ; moveb @#12345678,d0
3421     0000000a 49c0               ; extbl d0
3422     0000000c 4e5e               ; unlk fp
3423     0000000e 4e75               ; rts
3424
3425   Using coff and an 88k, some instructions don't have enough space in
3426them to represent the full address range, and pointers have to be loaded
3427in two parts.  So you'd get something like:
3428
3429             or.u     r13,r0,hi16(_foo+0x12345678)
3430             ld.b     r2,r13,lo16(_foo+0x12345678)
3431             jmp      r1
3432
3433   This should create two relocs, both pointing to '_foo', and with
34340x12340000 in their addend field.  The data would consist of:
3435
3436     RELOCATION RECORDS FOR [.text]:
3437     offset   type      value
3438     00000002 HVRT16    _foo+0x12340000
3439     00000006 LVRT16    _foo+0x12340000
3440
3441     00000000 5da05678           ; or.u r13,r0,0x5678
3442     00000004 1c4d5678           ; ld.b r2,r13,0x5678
3443     00000008 f400c001           ; jmp r1
3444
3445   The relocation routine digs out the value from the data, adds it to
3446the addend to get the original offset, and then adds the value of
3447'_foo'.  Note that all 32 bits have to be kept around somewhere, to cope
3448with carry from bit 15 to bit 16.
3449
3450   One further example is the sparc and the a.out format.  The sparc has
3451a similar problem to the 88k, in that some instructions don't have room
3452for an entire offset, but on the sparc the parts are created in odd
3453sized lumps.  The designers of the a.out format chose to not use the
3454data within the section for storing part of the offset; all the offset
3455is kept within the reloc.  Anything in the data should be ignored.
3456
3457             save %sp,-112,%sp
3458             sethi %hi(_foo+0x12345678),%g2
3459             ldsb [%g2+%lo(_foo+0x12345678)],%i0
3460             ret
3461             restore
3462
3463   Both relocs contain a pointer to 'foo', and the offsets contain junk.
3464
3465     RELOCATION RECORDS FOR [.text]:
3466     offset   type      value
3467     00000004 HI22      _foo+0x12345678
3468     00000008 LO10      _foo+0x12345678
3469
3470     00000000 9de3bf90     ; save %sp,-112,%sp
3471     00000004 05000000     ; sethi %hi(_foo+0),%g2
3472     00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
3473     0000000c 81c7e008     ; ret
3474     00000010 81e80000     ; restore
3475
3476   * 'howto'
3477   The 'howto' field can be imagined as a relocation instruction.  It is
3478a pointer to a structure which contains information on what to do with
3479all of the other information in the reloc record and data section.  A
3480back end would normally have a relocation instruction set and turn
3481relocations into pointers to the correct structure on input - but it
3482would be possible to create each howto field on demand.
3483
34842.10.1.1 'enum complain_overflow'
3485.................................
3486
3487Indicates what sort of overflow checking should be done when performing
3488a relocation.
3489
3490
3491     enum complain_overflow
3492     {
3493       /* Do not complain on overflow.  */
3494       complain_overflow_dont,
3495
3496       /* Complain if the value overflows when considered as a signed
3497          number one bit larger than the field.  ie. A bitfield of N bits
3498          is allowed to represent -2**n to 2**n-1.  */
3499       complain_overflow_bitfield,
3500
3501       /* Complain if the value overflows when considered as a signed
3502          number.  */
3503       complain_overflow_signed,
3504
3505       /* Complain if the value overflows when considered as an
3506          unsigned number.  */
3507       complain_overflow_unsigned
3508     };
3509
35102.10.1.2 'reloc_howto_type'
3511...........................
3512
3513The 'reloc_howto_type' is a structure which contains all the information
3514that libbfd needs to know to tie up a back end's data.
3515
3516     struct reloc_howto_struct
3517     {
3518       /* The type field has mainly a documentary use - the back end can
3519          do what it wants with it, though normally the back end's idea of
3520          an external reloc number is stored in this field.  */
3521       unsigned int type;
3522
3523       /* The encoded size of the item to be relocated.  This is *not* a
3524          power-of-two measure.  Use bfd_get_reloc_size to find the size
3525          of the item in bytes.  */
3526       unsigned int size:3;
3527
3528       /* The number of bits in the field to be relocated.  This is used
3529          when doing overflow checking.  */
3530       unsigned int bitsize:7;
3531
3532       /* The value the final relocation is shifted right by.  This drops
3533          unwanted data from the relocation.  */
3534       unsigned int rightshift:6;
3535
3536       /* The bit position of the reloc value in the destination.
3537          The relocated value is left shifted by this amount.  */
3538       unsigned int bitpos:6;
3539
3540       /* What type of overflow error should be checked for when
3541          relocating.  */
3542       ENUM_BITFIELD (complain_overflow) complain_on_overflow:2;
3543
3544       /* The relocation value should be negated before applying.  */
3545       unsigned int negate:1;
3546
3547       /* The relocation is relative to the item being relocated.  */
3548       unsigned int pc_relative:1;
3549
3550       /* Some formats record a relocation addend in the section contents
3551          rather than with the relocation.  For ELF formats this is the
3552          distinction between USE_REL and USE_RELA (though the code checks
3553          for USE_REL == 1/0).  The value of this field is TRUE if the
3554          addend is recorded with the section contents; when performing a
3555          partial link (ld -r) the section contents (the data) will be
3556          modified.  The value of this field is FALSE if addends are
3557          recorded with the relocation (in arelent.addend); when performing
3558          a partial link the relocation will be modified.
3559          All relocations for all ELF USE_RELA targets should set this field
3560          to FALSE (values of TRUE should be looked on with suspicion).
3561          However, the converse is not true: not all relocations of all ELF
3562          USE_REL targets set this field to TRUE.  Why this is so is peculiar
3563          to each particular target.  For relocs that aren't used in partial
3564          links (e.g. GOT stuff) it doesn't matter what this is set to.  */
3565       unsigned int partial_inplace:1;
3566
3567       /* When some formats create PC relative instructions, they leave
3568          the value of the pc of the place being relocated in the offset
3569          slot of the instruction, so that a PC relative relocation can
3570          be made just by adding in an ordinary offset (e.g., sun3 a.out).
3571          Some formats leave the displacement part of an instruction
3572          empty (e.g., ELF); this flag signals the fact.  */
3573       unsigned int pcrel_offset:1;
3574
3575       /* src_mask selects the part of the instruction (or data) to be used
3576          in the relocation sum.  If the target relocations don't have an
3577          addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
3578          dst_mask to extract the addend from the section contents.  If
3579          relocations do have an addend in the reloc, eg. ELF USE_RELA, this
3580          field should normally be zero.  Non-zero values for ELF USE_RELA
3581          targets should be viewed with suspicion as normally the value in
3582          the dst_mask part of the section contents should be ignored.  */
3583       bfd_vma src_mask;
3584
3585       /* dst_mask selects which parts of the instruction (or data) are
3586          replaced with a relocated value.  */
3587       bfd_vma dst_mask;
3588
3589       /* If this field is non null, then the supplied function is
3590          called rather than the normal function.  This allows really
3591          strange relocation methods to be accommodated.  */
3592       bfd_reloc_status_type (*special_function)
3593         (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
3594          bfd *, char **);
3595
3596       /* The textual name of the relocation type.  */
3597       const char *name;
3598     };
3599
36002.10.1.3 'The HOWTO Macro'
3601..........................
3602
3603*Description*
3604The HOWTO macro fills in a reloc_howto_type (a typedef for const struct
3605reloc_howto_struct).
3606     #define HOWTO(type, right, size, bits, pcrel, left, ovf, func, name,   \
3607                   inplace, src_mask, dst_mask, pcrel_off)                  \
3608       { (unsigned) type, size < 0 ? -size : size, bits, right, left, ovf,  \
3609         size < 0, pcrel, inplace, pcrel_off, src_mask, dst_mask, func, name }
3610
3611   *Description*
3612This is used to fill in an empty howto entry in an array.
3613     #define EMPTY_HOWTO(C) \
3614       HOWTO ((C), 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL, \
3615              NULL, FALSE, 0, 0, FALSE)
3616
36172.10.1.4 'bfd_get_reloc_size'
3618.............................
3619
3620*Synopsis*
3621     unsigned int bfd_get_reloc_size (reloc_howto_type *);
3622   *Description*
3623For a reloc_howto_type that operates on a fixed number of bytes, this
3624returns the number of bytes operated on.
3625
36262.10.1.5 'arelent_chain'
3627........................
3628
3629*Description*
3630How relocs are tied together in an 'asection':
3631     typedef struct relent_chain
3632     {
3633       arelent relent;
3634       struct relent_chain *next;
3635     }
3636     arelent_chain;
3637
36382.10.1.6 'bfd_check_overflow'
3639.............................
3640
3641*Synopsis*
3642     bfd_reloc_status_type bfd_check_overflow
3643        (enum complain_overflow how,
3644         unsigned int bitsize,
3645         unsigned int rightshift,
3646         unsigned int addrsize,
3647         bfd_vma relocation);
3648   *Description*
3649Perform overflow checking on RELOCATION which has BITSIZE significant
3650bits and will be shifted right by RIGHTSHIFT bits, on a machine with
3651addresses containing ADDRSIZE significant bits.  The result is either of
3652'bfd_reloc_ok' or 'bfd_reloc_overflow'.
3653
36542.10.1.7 'bfd_reloc_offset_in_range'
3655....................................
3656
3657*Synopsis*
3658     bfd_boolean bfd_reloc_offset_in_range
3659        (reloc_howto_type *howto,
3660         bfd *abfd,
3661         asection *section,
3662         bfd_size_type offset);
3663   *Description*
3664Returns TRUE if the reloc described by HOWTO can be applied at OFFSET
3665octets in SECTION.
3666
36672.10.1.8 'bfd_perform_relocation'
3668.................................
3669
3670*Synopsis*
3671     bfd_reloc_status_type bfd_perform_relocation
3672        (bfd *abfd,
3673         arelent *reloc_entry,
3674         void *data,
3675         asection *input_section,
3676         bfd *output_bfd,
3677         char **error_message);
3678   *Description*
3679If OUTPUT_BFD is supplied to this function, the generated image will be
3680relocatable; the relocations are copied to the output file after they
3681have been changed to reflect the new state of the world.  There are two
3682ways of reflecting the results of partial linkage in an output file: by
3683modifying the output data in place, and by modifying the relocation
3684record.  Some native formats (e.g., basic a.out and basic coff) have no
3685way of specifying an addend in the relocation type, so the addend has to
3686go in the output data.  This is no big deal since in these formats the
3687output data slot will always be big enough for the addend.  Complex
3688reloc types with addends were invented to solve just this problem.  The
3689ERROR_MESSAGE argument is set to an error message if this return
3690'bfd_reloc_dangerous'.
3691
36922.10.1.9 'bfd_install_relocation'
3693.................................
3694
3695*Synopsis*
3696     bfd_reloc_status_type bfd_install_relocation
3697        (bfd *abfd,
3698         arelent *reloc_entry,
3699         void *data, bfd_vma data_start,
3700         asection *input_section,
3701         char **error_message);
3702   *Description*
3703This looks remarkably like 'bfd_perform_relocation', except it does not
3704expect that the section contents have been filled in.  I.e., it's
3705suitable for use when creating, rather than applying a relocation.
3706
3707   For now, this function should be considered reserved for the
3708assembler.
3709
3710
3711File: bfd.info,  Node: howto manager,  Prev: typedef arelent,  Up: Relocations
3712
37132.10.2 The howto manager
3714------------------------
3715
3716When an application wants to create a relocation, but doesn't know what
3717the target machine might call it, it can find out by using this bit of
3718code.
3719
37202.10.2.1 'bfd_reloc_code_type'
3721..............................
3722
3723*Description*
3724The insides of a reloc code.  The idea is that, eventually, there will
3725be one enumerator for every type of relocation we ever do.  Pass one of
3726these values to 'bfd_reloc_type_lookup', and it'll return a howto
3727pointer.
3728
3729   This does mean that the application must determine the correct
3730enumerator value; you can't get a howto pointer from a random set of
3731attributes.
3732
3733   Here are the possible values for 'enum bfd_reloc_code_real':
3734
3735 -- : BFD_RELOC_64
3736 -- : BFD_RELOC_32
3737 -- : BFD_RELOC_26
3738 -- : BFD_RELOC_24
3739 -- : BFD_RELOC_16
3740 -- : BFD_RELOC_14
3741 -- : BFD_RELOC_8
3742     Basic absolute relocations of N bits.
3743 -- : BFD_RELOC_64_PCREL
3744 -- : BFD_RELOC_32_PCREL
3745 -- : BFD_RELOC_24_PCREL
3746 -- : BFD_RELOC_16_PCREL
3747 -- : BFD_RELOC_12_PCREL
3748 -- : BFD_RELOC_8_PCREL
3749     PC-relative relocations.  Sometimes these are relative to the
3750     address of the relocation itself; sometimes they are relative to
3751     the start of the section containing the relocation.  It depends on
3752     the specific target.
3753 -- : BFD_RELOC_32_SECREL
3754     Section relative relocations.  Some targets need this for DWARF2.
3755 -- : BFD_RELOC_32_GOT_PCREL
3756 -- : BFD_RELOC_16_GOT_PCREL
3757 -- : BFD_RELOC_8_GOT_PCREL
3758 -- : BFD_RELOC_32_GOTOFF
3759 -- : BFD_RELOC_16_GOTOFF
3760 -- : BFD_RELOC_LO16_GOTOFF
3761 -- : BFD_RELOC_HI16_GOTOFF
3762 -- : BFD_RELOC_HI16_S_GOTOFF
3763 -- : BFD_RELOC_8_GOTOFF
3764 -- : BFD_RELOC_64_PLT_PCREL
3765 -- : BFD_RELOC_32_PLT_PCREL
3766 -- : BFD_RELOC_24_PLT_PCREL
3767 -- : BFD_RELOC_16_PLT_PCREL
3768 -- : BFD_RELOC_8_PLT_PCREL
3769 -- : BFD_RELOC_64_PLTOFF
3770 -- : BFD_RELOC_32_PLTOFF
3771 -- : BFD_RELOC_16_PLTOFF
3772 -- : BFD_RELOC_LO16_PLTOFF
3773 -- : BFD_RELOC_HI16_PLTOFF
3774 -- : BFD_RELOC_HI16_S_PLTOFF
3775 -- : BFD_RELOC_8_PLTOFF
3776     For ELF.
3777 -- : BFD_RELOC_SIZE32
3778 -- : BFD_RELOC_SIZE64
3779     Size relocations.
3780 -- : BFD_RELOC_68K_GLOB_DAT
3781 -- : BFD_RELOC_68K_JMP_SLOT
3782 -- : BFD_RELOC_68K_RELATIVE
3783 -- : BFD_RELOC_68K_TLS_GD32
3784 -- : BFD_RELOC_68K_TLS_GD16
3785 -- : BFD_RELOC_68K_TLS_GD8
3786 -- : BFD_RELOC_68K_TLS_LDM32
3787 -- : BFD_RELOC_68K_TLS_LDM16
3788 -- : BFD_RELOC_68K_TLS_LDM8
3789 -- : BFD_RELOC_68K_TLS_LDO32
3790 -- : BFD_RELOC_68K_TLS_LDO16
3791 -- : BFD_RELOC_68K_TLS_LDO8
3792 -- : BFD_RELOC_68K_TLS_IE32
3793 -- : BFD_RELOC_68K_TLS_IE16
3794 -- : BFD_RELOC_68K_TLS_IE8
3795 -- : BFD_RELOC_68K_TLS_LE32
3796 -- : BFD_RELOC_68K_TLS_LE16
3797 -- : BFD_RELOC_68K_TLS_LE8
3798     Relocations used by 68K ELF.
3799 -- : BFD_RELOC_32_BASEREL
3800 -- : BFD_RELOC_16_BASEREL
3801 -- : BFD_RELOC_LO16_BASEREL
3802 -- : BFD_RELOC_HI16_BASEREL
3803 -- : BFD_RELOC_HI16_S_BASEREL
3804 -- : BFD_RELOC_8_BASEREL
3805 -- : BFD_RELOC_RVA
3806     Linkage-table relative.
3807 -- : BFD_RELOC_8_FFnn
3808     Absolute 8-bit relocation, but used to form an address like 0xFFnn.
3809 -- : BFD_RELOC_32_PCREL_S2
3810 -- : BFD_RELOC_16_PCREL_S2
3811 -- : BFD_RELOC_23_PCREL_S2
3812     These PC-relative relocations are stored as word displacements -
3813     i.e., byte displacements shifted right two bits.  The 30-bit word
3814     displacement (<<32_PCREL_S2>> - 32 bits, shifted 2) is used on the
3815     SPARC. (SPARC tools generally refer to this as <<WDISP30>>.)  The
3816     signed 16-bit displacement is used on the MIPS, and the 23-bit
3817     displacement is used on the Alpha.
3818 -- : BFD_RELOC_HI22
3819 -- : BFD_RELOC_LO10
3820     High 22 bits and low 10 bits of 32-bit value, placed into lower
3821     bits of the target word.  These are used on the SPARC.
3822 -- : BFD_RELOC_GPREL16
3823 -- : BFD_RELOC_GPREL32
3824     For systems that allocate a Global Pointer register, these are
3825     displacements off that register.  These relocation types are
3826     handled specially, because the value the register will have is
3827     decided relatively late.
3828 -- : BFD_RELOC_NONE
3829 -- : BFD_RELOC_SPARC_WDISP22
3830 -- : BFD_RELOC_SPARC22
3831 -- : BFD_RELOC_SPARC13
3832 -- : BFD_RELOC_SPARC_GOT10
3833 -- : BFD_RELOC_SPARC_GOT13
3834 -- : BFD_RELOC_SPARC_GOT22
3835 -- : BFD_RELOC_SPARC_PC10
3836 -- : BFD_RELOC_SPARC_PC22
3837 -- : BFD_RELOC_SPARC_WPLT30
3838 -- : BFD_RELOC_SPARC_COPY
3839 -- : BFD_RELOC_SPARC_GLOB_DAT
3840 -- : BFD_RELOC_SPARC_JMP_SLOT
3841 -- : BFD_RELOC_SPARC_RELATIVE
3842 -- : BFD_RELOC_SPARC_UA16
3843 -- : BFD_RELOC_SPARC_UA32
3844 -- : BFD_RELOC_SPARC_UA64
3845 -- : BFD_RELOC_SPARC_GOTDATA_HIX22
3846 -- : BFD_RELOC_SPARC_GOTDATA_LOX10
3847 -- : BFD_RELOC_SPARC_GOTDATA_OP_HIX22
3848 -- : BFD_RELOC_SPARC_GOTDATA_OP_LOX10
3849 -- : BFD_RELOC_SPARC_GOTDATA_OP
3850 -- : BFD_RELOC_SPARC_JMP_IREL
3851 -- : BFD_RELOC_SPARC_IRELATIVE
3852     SPARC ELF relocations.  There is probably some overlap with other
3853     relocation types already defined.
3854 -- : BFD_RELOC_SPARC_BASE13
3855 -- : BFD_RELOC_SPARC_BASE22
3856     I think these are specific to SPARC a.out (e.g., Sun 4).
3857 -- : BFD_RELOC_SPARC_64
3858 -- : BFD_RELOC_SPARC_10
3859 -- : BFD_RELOC_SPARC_11
3860 -- : BFD_RELOC_SPARC_OLO10
3861 -- : BFD_RELOC_SPARC_HH22
3862 -- : BFD_RELOC_SPARC_HM10
3863 -- : BFD_RELOC_SPARC_LM22
3864 -- : BFD_RELOC_SPARC_PC_HH22
3865 -- : BFD_RELOC_SPARC_PC_HM10
3866 -- : BFD_RELOC_SPARC_PC_LM22
3867 -- : BFD_RELOC_SPARC_WDISP16
3868 -- : BFD_RELOC_SPARC_WDISP19
3869 -- : BFD_RELOC_SPARC_7
3870 -- : BFD_RELOC_SPARC_6
3871 -- : BFD_RELOC_SPARC_5
3872 -- : BFD_RELOC_SPARC_DISP64
3873 -- : BFD_RELOC_SPARC_PLT32
3874 -- : BFD_RELOC_SPARC_PLT64
3875 -- : BFD_RELOC_SPARC_HIX22
3876 -- : BFD_RELOC_SPARC_LOX10
3877 -- : BFD_RELOC_SPARC_H44
3878 -- : BFD_RELOC_SPARC_M44
3879 -- : BFD_RELOC_SPARC_L44
3880 -- : BFD_RELOC_SPARC_REGISTER
3881 -- : BFD_RELOC_SPARC_H34
3882 -- : BFD_RELOC_SPARC_SIZE32
3883 -- : BFD_RELOC_SPARC_SIZE64
3884 -- : BFD_RELOC_SPARC_WDISP10
3885     SPARC64 relocations
3886 -- : BFD_RELOC_SPARC_REV32
3887     SPARC little endian relocation
3888 -- : BFD_RELOC_SPARC_TLS_GD_HI22
3889 -- : BFD_RELOC_SPARC_TLS_GD_LO10
3890 -- : BFD_RELOC_SPARC_TLS_GD_ADD
3891 -- : BFD_RELOC_SPARC_TLS_GD_CALL
3892 -- : BFD_RELOC_SPARC_TLS_LDM_HI22
3893 -- : BFD_RELOC_SPARC_TLS_LDM_LO10
3894 -- : BFD_RELOC_SPARC_TLS_LDM_ADD
3895 -- : BFD_RELOC_SPARC_TLS_LDM_CALL
3896 -- : BFD_RELOC_SPARC_TLS_LDO_HIX22
3897 -- : BFD_RELOC_SPARC_TLS_LDO_LOX10
3898 -- : BFD_RELOC_SPARC_TLS_LDO_ADD
3899 -- : BFD_RELOC_SPARC_TLS_IE_HI22
3900 -- : BFD_RELOC_SPARC_TLS_IE_LO10
3901 -- : BFD_RELOC_SPARC_TLS_IE_LD
3902 -- : BFD_RELOC_SPARC_TLS_IE_LDX
3903 -- : BFD_RELOC_SPARC_TLS_IE_ADD
3904 -- : BFD_RELOC_SPARC_TLS_LE_HIX22
3905 -- : BFD_RELOC_SPARC_TLS_LE_LOX10
3906 -- : BFD_RELOC_SPARC_TLS_DTPMOD32
3907 -- : BFD_RELOC_SPARC_TLS_DTPMOD64
3908 -- : BFD_RELOC_SPARC_TLS_DTPOFF32
3909 -- : BFD_RELOC_SPARC_TLS_DTPOFF64
3910 -- : BFD_RELOC_SPARC_TLS_TPOFF32
3911 -- : BFD_RELOC_SPARC_TLS_TPOFF64
3912     SPARC TLS relocations
3913 -- : BFD_RELOC_SPU_IMM7
3914 -- : BFD_RELOC_SPU_IMM8
3915 -- : BFD_RELOC_SPU_IMM10
3916 -- : BFD_RELOC_SPU_IMM10W
3917 -- : BFD_RELOC_SPU_IMM16
3918 -- : BFD_RELOC_SPU_IMM16W
3919 -- : BFD_RELOC_SPU_IMM18
3920 -- : BFD_RELOC_SPU_PCREL9a
3921 -- : BFD_RELOC_SPU_PCREL9b
3922 -- : BFD_RELOC_SPU_PCREL16
3923 -- : BFD_RELOC_SPU_LO16
3924 -- : BFD_RELOC_SPU_HI16
3925 -- : BFD_RELOC_SPU_PPU32
3926 -- : BFD_RELOC_SPU_PPU64
3927 -- : BFD_RELOC_SPU_ADD_PIC
3928     SPU Relocations.
3929 -- : BFD_RELOC_ALPHA_GPDISP_HI16
3930     Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
3931     "addend" in some special way.  For GPDISP_HI16 ("gpdisp")
3932     relocations, the symbol is ignored when writing; when reading, it
3933     will be the absolute section symbol.  The addend is the
3934     displacement in bytes of the "lda" instruction from the "ldah"
3935     instruction (which is at the address of this reloc).
3936 -- : BFD_RELOC_ALPHA_GPDISP_LO16
3937     For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
3938     with GPDISP_HI16 relocs.  The addend is ignored when writing the
3939     relocations out, and is filled in with the file's GP value on
3940     reading, for convenience.
3941 -- : BFD_RELOC_ALPHA_GPDISP
3942     The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
3943     relocation except that there is no accompanying GPDISP_LO16
3944     relocation.
3945 -- : BFD_RELOC_ALPHA_LITERAL
3946 -- : BFD_RELOC_ALPHA_ELF_LITERAL
3947 -- : BFD_RELOC_ALPHA_LITUSE
3948     The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
3949     the assembler turns it into a LDQ instruction to load the address
3950     of the symbol, and then fills in a register in the real
3951     instruction.
3952
3953     The LITERAL reloc, at the LDQ instruction, refers to the .lita
3954     section symbol.  The addend is ignored when writing, but is filled
3955     in with the file's GP value on reading, for convenience, as with
3956     the GPDISP_LO16 reloc.
3957
3958     The ELF_LITERAL reloc is somewhere between 16_GOTOFF and
3959     GPDISP_LO16.  It should refer to the symbol to be referenced, as
3960     with 16_GOTOFF, but it generates output not based on the position
3961     within the .got section, but relative to the GP value chosen for
3962     the file during the final link stage.
3963
3964     The LITUSE reloc, on the instruction using the loaded address,
3965     gives information to the linker that it might be able to use to
3966     optimize away some literal section references.  The symbol is
3967     ignored (read as the absolute section symbol), and the "addend"
3968     indicates the type of instruction using the register: 1 - "memory"
3969     fmt insn 2 - byte-manipulation (byte offset reg) 3 - jsr (target of
3970     branch)
3971 -- : BFD_RELOC_ALPHA_HINT
3972     The HINT relocation indicates a value that should be filled into
3973     the "hint" field of a jmp/jsr/ret instruction, for possible branch-
3974     prediction logic which may be provided on some processors.
3975 -- : BFD_RELOC_ALPHA_LINKAGE
3976     The LINKAGE relocation outputs a linkage pair in the object file,
3977     which is filled by the linker.
3978 -- : BFD_RELOC_ALPHA_CODEADDR
3979     The CODEADDR relocation outputs a STO_CA in the object file, which
3980     is filled by the linker.
3981 -- : BFD_RELOC_ALPHA_GPREL_HI16
3982 -- : BFD_RELOC_ALPHA_GPREL_LO16
3983     The GPREL_HI/LO relocations together form a 32-bit offset from the
3984     GP register.
3985 -- : BFD_RELOC_ALPHA_BRSGP
3986     Like BFD_RELOC_23_PCREL_S2, except that the source and target must
3987     share a common GP, and the target address is adjusted for
3988     STO_ALPHA_STD_GPLOAD.
3989 -- : BFD_RELOC_ALPHA_NOP
3990     The NOP relocation outputs a NOP if the longword displacement
3991     between two procedure entry points is < 2^21.
3992 -- : BFD_RELOC_ALPHA_BSR
3993     The BSR relocation outputs a BSR if the longword displacement
3994     between two procedure entry points is < 2^21.
3995 -- : BFD_RELOC_ALPHA_LDA
3996     The LDA relocation outputs a LDA if the longword displacement
3997     between two procedure entry points is < 2^16.
3998 -- : BFD_RELOC_ALPHA_BOH
3999     The BOH relocation outputs a BSR if the longword displacement
4000     between two procedure entry points is < 2^21, or else a hint.
4001 -- : BFD_RELOC_ALPHA_TLSGD
4002 -- : BFD_RELOC_ALPHA_TLSLDM
4003 -- : BFD_RELOC_ALPHA_DTPMOD64
4004 -- : BFD_RELOC_ALPHA_GOTDTPREL16
4005 -- : BFD_RELOC_ALPHA_DTPREL64
4006 -- : BFD_RELOC_ALPHA_DTPREL_HI16
4007 -- : BFD_RELOC_ALPHA_DTPREL_LO16
4008 -- : BFD_RELOC_ALPHA_DTPREL16
4009 -- : BFD_RELOC_ALPHA_GOTTPREL16
4010 -- : BFD_RELOC_ALPHA_TPREL64
4011 -- : BFD_RELOC_ALPHA_TPREL_HI16
4012 -- : BFD_RELOC_ALPHA_TPREL_LO16
4013 -- : BFD_RELOC_ALPHA_TPREL16
4014     Alpha thread-local storage relocations.
4015 -- : BFD_RELOC_MIPS_JMP
4016 -- : BFD_RELOC_MICROMIPS_JMP
4017     The MIPS jump instruction.
4018 -- : BFD_RELOC_MIPS16_JMP
4019     The MIPS16 jump instruction.
4020 -- : BFD_RELOC_MIPS16_GPREL
4021     MIPS16 GP relative reloc.
4022 -- : BFD_RELOC_HI16
4023     High 16 bits of 32-bit value; simple reloc.
4024 -- : BFD_RELOC_HI16_S
4025     High 16 bits of 32-bit value but the low 16 bits will be sign
4026     extended and added to form the final result.  If the low 16 bits
4027     form a negative number, we need to add one to the high value to
4028     compensate for the borrow when the low bits are added.
4029 -- : BFD_RELOC_LO16
4030     Low 16 bits.
4031 -- : BFD_RELOC_HI16_PCREL
4032     High 16 bits of 32-bit pc-relative value
4033 -- : BFD_RELOC_HI16_S_PCREL
4034     High 16 bits of 32-bit pc-relative value, adjusted
4035 -- : BFD_RELOC_LO16_PCREL
4036     Low 16 bits of pc-relative value
4037 -- : BFD_RELOC_MIPS16_GOT16
4038 -- : BFD_RELOC_MIPS16_CALL16
4039     Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
4040     16-bit immediate fields
4041 -- : BFD_RELOC_MIPS16_HI16
4042     MIPS16 high 16 bits of 32-bit value.
4043 -- : BFD_RELOC_MIPS16_HI16_S
4044     MIPS16 high 16 bits of 32-bit value but the low 16 bits will be
4045     sign extended and added to form the final result.  If the low 16
4046     bits form a negative number, we need to add one to the high value
4047     to compensate for the borrow when the low bits are added.
4048 -- : BFD_RELOC_MIPS16_LO16
4049     MIPS16 low 16 bits.
4050 -- : BFD_RELOC_MIPS16_TLS_GD
4051 -- : BFD_RELOC_MIPS16_TLS_LDM
4052 -- : BFD_RELOC_MIPS16_TLS_DTPREL_HI16
4053 -- : BFD_RELOC_MIPS16_TLS_DTPREL_LO16
4054 -- : BFD_RELOC_MIPS16_TLS_GOTTPREL
4055 -- : BFD_RELOC_MIPS16_TLS_TPREL_HI16
4056 -- : BFD_RELOC_MIPS16_TLS_TPREL_LO16
4057     MIPS16 TLS relocations
4058 -- : BFD_RELOC_MIPS_LITERAL
4059 -- : BFD_RELOC_MICROMIPS_LITERAL
4060     Relocation against a MIPS literal section.
4061 -- : BFD_RELOC_MICROMIPS_7_PCREL_S1
4062 -- : BFD_RELOC_MICROMIPS_10_PCREL_S1
4063 -- : BFD_RELOC_MICROMIPS_16_PCREL_S1
4064     microMIPS PC-relative relocations.
4065 -- : BFD_RELOC_MIPS16_16_PCREL_S1
4066     MIPS16 PC-relative relocation.
4067 -- : BFD_RELOC_MIPS_21_PCREL_S2
4068 -- : BFD_RELOC_MIPS_26_PCREL_S2
4069 -- : BFD_RELOC_MIPS_18_PCREL_S3
4070 -- : BFD_RELOC_MIPS_19_PCREL_S2
4071     MIPS PC-relative relocations.
4072 -- : BFD_RELOC_MICROMIPS_GPREL16
4073 -- : BFD_RELOC_MICROMIPS_HI16
4074 -- : BFD_RELOC_MICROMIPS_HI16_S
4075 -- : BFD_RELOC_MICROMIPS_LO16
4076     microMIPS versions of generic BFD relocs.
4077 -- : BFD_RELOC_MIPS_GOT16
4078 -- : BFD_RELOC_MICROMIPS_GOT16
4079 -- : BFD_RELOC_MIPS_CALL16
4080 -- : BFD_RELOC_MICROMIPS_CALL16
4081 -- : BFD_RELOC_MIPS_GOT_HI16
4082 -- : BFD_RELOC_MICROMIPS_GOT_HI16
4083 -- : BFD_RELOC_MIPS_GOT_LO16
4084 -- : BFD_RELOC_MICROMIPS_GOT_LO16
4085 -- : BFD_RELOC_MIPS_CALL_HI16
4086 -- : BFD_RELOC_MICROMIPS_CALL_HI16
4087 -- : BFD_RELOC_MIPS_CALL_LO16
4088 -- : BFD_RELOC_MICROMIPS_CALL_LO16
4089 -- : BFD_RELOC_MIPS_SUB
4090 -- : BFD_RELOC_MICROMIPS_SUB
4091 -- : BFD_RELOC_MIPS_GOT_PAGE
4092 -- : BFD_RELOC_MICROMIPS_GOT_PAGE
4093 -- : BFD_RELOC_MIPS_GOT_OFST
4094 -- : BFD_RELOC_MICROMIPS_GOT_OFST
4095 -- : BFD_RELOC_MIPS_GOT_DISP
4096 -- : BFD_RELOC_MICROMIPS_GOT_DISP
4097 -- : BFD_RELOC_MIPS_SHIFT5
4098 -- : BFD_RELOC_MIPS_SHIFT6
4099 -- : BFD_RELOC_MIPS_INSERT_A
4100 -- : BFD_RELOC_MIPS_INSERT_B
4101 -- : BFD_RELOC_MIPS_DELETE
4102 -- : BFD_RELOC_MIPS_HIGHEST
4103 -- : BFD_RELOC_MICROMIPS_HIGHEST
4104 -- : BFD_RELOC_MIPS_HIGHER
4105 -- : BFD_RELOC_MICROMIPS_HIGHER
4106 -- : BFD_RELOC_MIPS_SCN_DISP
4107 -- : BFD_RELOC_MICROMIPS_SCN_DISP
4108 -- : BFD_RELOC_MIPS_REL16
4109 -- : BFD_RELOC_MIPS_RELGOT
4110 -- : BFD_RELOC_MIPS_JALR
4111 -- : BFD_RELOC_MICROMIPS_JALR
4112 -- : BFD_RELOC_MIPS_TLS_DTPMOD32
4113 -- : BFD_RELOC_MIPS_TLS_DTPREL32
4114 -- : BFD_RELOC_MIPS_TLS_DTPMOD64
4115 -- : BFD_RELOC_MIPS_TLS_DTPREL64
4116 -- : BFD_RELOC_MIPS_TLS_GD
4117 -- : BFD_RELOC_MICROMIPS_TLS_GD
4118 -- : BFD_RELOC_MIPS_TLS_LDM
4119 -- : BFD_RELOC_MICROMIPS_TLS_LDM
4120 -- : BFD_RELOC_MIPS_TLS_DTPREL_HI16
4121 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16
4122 -- : BFD_RELOC_MIPS_TLS_DTPREL_LO16
4123 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16
4124 -- : BFD_RELOC_MIPS_TLS_GOTTPREL
4125 -- : BFD_RELOC_MICROMIPS_TLS_GOTTPREL
4126 -- : BFD_RELOC_MIPS_TLS_TPREL32
4127 -- : BFD_RELOC_MIPS_TLS_TPREL64
4128 -- : BFD_RELOC_MIPS_TLS_TPREL_HI16
4129 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_HI16
4130 -- : BFD_RELOC_MIPS_TLS_TPREL_LO16
4131 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_LO16
4132 -- : BFD_RELOC_MIPS_EH
4133     MIPS ELF relocations.
4134 -- : BFD_RELOC_MIPS_COPY
4135 -- : BFD_RELOC_MIPS_JUMP_SLOT
4136     MIPS ELF relocations (VxWorks and PLT extensions).
4137 -- : BFD_RELOC_MOXIE_10_PCREL
4138     Moxie ELF relocations.
4139 -- : BFD_RELOC_FT32_10
4140 -- : BFD_RELOC_FT32_20
4141 -- : BFD_RELOC_FT32_17
4142 -- : BFD_RELOC_FT32_18
4143 -- : BFD_RELOC_FT32_RELAX
4144 -- : BFD_RELOC_FT32_SC0
4145 -- : BFD_RELOC_FT32_SC1
4146 -- : BFD_RELOC_FT32_15
4147 -- : BFD_RELOC_FT32_DIFF32
4148     FT32 ELF relocations.
4149 -- : BFD_RELOC_FRV_LABEL16
4150 -- : BFD_RELOC_FRV_LABEL24
4151 -- : BFD_RELOC_FRV_LO16
4152 -- : BFD_RELOC_FRV_HI16
4153 -- : BFD_RELOC_FRV_GPREL12
4154 -- : BFD_RELOC_FRV_GPRELU12
4155 -- : BFD_RELOC_FRV_GPREL32
4156 -- : BFD_RELOC_FRV_GPRELHI
4157 -- : BFD_RELOC_FRV_GPRELLO
4158 -- : BFD_RELOC_FRV_GOT12
4159 -- : BFD_RELOC_FRV_GOTHI
4160 -- : BFD_RELOC_FRV_GOTLO
4161 -- : BFD_RELOC_FRV_FUNCDESC
4162 -- : BFD_RELOC_FRV_FUNCDESC_GOT12
4163 -- : BFD_RELOC_FRV_FUNCDESC_GOTHI
4164 -- : BFD_RELOC_FRV_FUNCDESC_GOTLO
4165 -- : BFD_RELOC_FRV_FUNCDESC_VALUE
4166 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFF12
4167 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFHI
4168 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFLO
4169 -- : BFD_RELOC_FRV_GOTOFF12
4170 -- : BFD_RELOC_FRV_GOTOFFHI
4171 -- : BFD_RELOC_FRV_GOTOFFLO
4172 -- : BFD_RELOC_FRV_GETTLSOFF
4173 -- : BFD_RELOC_FRV_TLSDESC_VALUE
4174 -- : BFD_RELOC_FRV_GOTTLSDESC12
4175 -- : BFD_RELOC_FRV_GOTTLSDESCHI
4176 -- : BFD_RELOC_FRV_GOTTLSDESCLO
4177 -- : BFD_RELOC_FRV_TLSMOFF12
4178 -- : BFD_RELOC_FRV_TLSMOFFHI
4179 -- : BFD_RELOC_FRV_TLSMOFFLO
4180 -- : BFD_RELOC_FRV_GOTTLSOFF12
4181 -- : BFD_RELOC_FRV_GOTTLSOFFHI
4182 -- : BFD_RELOC_FRV_GOTTLSOFFLO
4183 -- : BFD_RELOC_FRV_TLSOFF
4184 -- : BFD_RELOC_FRV_TLSDESC_RELAX
4185 -- : BFD_RELOC_FRV_GETTLSOFF_RELAX
4186 -- : BFD_RELOC_FRV_TLSOFF_RELAX
4187 -- : BFD_RELOC_FRV_TLSMOFF
4188     Fujitsu Frv Relocations.
4189 -- : BFD_RELOC_MN10300_GOTOFF24
4190     This is a 24bit GOT-relative reloc for the mn10300.
4191 -- : BFD_RELOC_MN10300_GOT32
4192     This is a 32bit GOT-relative reloc for the mn10300, offset by two
4193     bytes in the instruction.
4194 -- : BFD_RELOC_MN10300_GOT24
4195     This is a 24bit GOT-relative reloc for the mn10300, offset by two
4196     bytes in the instruction.
4197 -- : BFD_RELOC_MN10300_GOT16
4198     This is a 16bit GOT-relative reloc for the mn10300, offset by two
4199     bytes in the instruction.
4200 -- : BFD_RELOC_MN10300_COPY
4201     Copy symbol at runtime.
4202 -- : BFD_RELOC_MN10300_GLOB_DAT
4203     Create GOT entry.
4204 -- : BFD_RELOC_MN10300_JMP_SLOT
4205     Create PLT entry.
4206 -- : BFD_RELOC_MN10300_RELATIVE
4207     Adjust by program base.
4208 -- : BFD_RELOC_MN10300_SYM_DIFF
4209     Together with another reloc targeted at the same location, allows
4210     for a value that is the difference of two symbols in the same
4211     section.
4212 -- : BFD_RELOC_MN10300_ALIGN
4213     The addend of this reloc is an alignment power that must be
4214     honoured at the offset's location, regardless of linker relaxation.
4215 -- : BFD_RELOC_MN10300_TLS_GD
4216 -- : BFD_RELOC_MN10300_TLS_LD
4217 -- : BFD_RELOC_MN10300_TLS_LDO
4218 -- : BFD_RELOC_MN10300_TLS_GOTIE
4219 -- : BFD_RELOC_MN10300_TLS_IE
4220 -- : BFD_RELOC_MN10300_TLS_LE
4221 -- : BFD_RELOC_MN10300_TLS_DTPMOD
4222 -- : BFD_RELOC_MN10300_TLS_DTPOFF
4223 -- : BFD_RELOC_MN10300_TLS_TPOFF
4224     Various TLS-related relocations.
4225 -- : BFD_RELOC_MN10300_32_PCREL
4226     This is a 32bit pcrel reloc for the mn10300, offset by two bytes in
4227     the instruction.
4228 -- : BFD_RELOC_MN10300_16_PCREL
4229     This is a 16bit pcrel reloc for the mn10300, offset by two bytes in
4230     the instruction.
4231 -- : BFD_RELOC_386_GOT32
4232 -- : BFD_RELOC_386_PLT32
4233 -- : BFD_RELOC_386_COPY
4234 -- : BFD_RELOC_386_GLOB_DAT
4235 -- : BFD_RELOC_386_JUMP_SLOT
4236 -- : BFD_RELOC_386_RELATIVE
4237 -- : BFD_RELOC_386_GOTOFF
4238 -- : BFD_RELOC_386_GOTPC
4239 -- : BFD_RELOC_386_TLS_TPOFF
4240 -- : BFD_RELOC_386_TLS_IE
4241 -- : BFD_RELOC_386_TLS_GOTIE
4242 -- : BFD_RELOC_386_TLS_LE
4243 -- : BFD_RELOC_386_TLS_GD
4244 -- : BFD_RELOC_386_TLS_LDM
4245 -- : BFD_RELOC_386_TLS_LDO_32
4246 -- : BFD_RELOC_386_TLS_IE_32
4247 -- : BFD_RELOC_386_TLS_LE_32
4248 -- : BFD_RELOC_386_TLS_DTPMOD32
4249 -- : BFD_RELOC_386_TLS_DTPOFF32
4250 -- : BFD_RELOC_386_TLS_TPOFF32
4251 -- : BFD_RELOC_386_TLS_GOTDESC
4252 -- : BFD_RELOC_386_TLS_DESC_CALL
4253 -- : BFD_RELOC_386_TLS_DESC
4254 -- : BFD_RELOC_386_IRELATIVE
4255 -- : BFD_RELOC_386_GOT32X
4256     i386/elf relocations
4257 -- : BFD_RELOC_X86_64_GOT32
4258 -- : BFD_RELOC_X86_64_PLT32
4259 -- : BFD_RELOC_X86_64_COPY
4260 -- : BFD_RELOC_X86_64_GLOB_DAT
4261 -- : BFD_RELOC_X86_64_JUMP_SLOT
4262 -- : BFD_RELOC_X86_64_RELATIVE
4263 -- : BFD_RELOC_X86_64_GOTPCREL
4264 -- : BFD_RELOC_X86_64_32S
4265 -- : BFD_RELOC_X86_64_DTPMOD64
4266 -- : BFD_RELOC_X86_64_DTPOFF64
4267 -- : BFD_RELOC_X86_64_TPOFF64
4268 -- : BFD_RELOC_X86_64_TLSGD
4269 -- : BFD_RELOC_X86_64_TLSLD
4270 -- : BFD_RELOC_X86_64_DTPOFF32
4271 -- : BFD_RELOC_X86_64_GOTTPOFF
4272 -- : BFD_RELOC_X86_64_TPOFF32
4273 -- : BFD_RELOC_X86_64_GOTOFF64
4274 -- : BFD_RELOC_X86_64_GOTPC32
4275 -- : BFD_RELOC_X86_64_GOT64
4276 -- : BFD_RELOC_X86_64_GOTPCREL64
4277 -- : BFD_RELOC_X86_64_GOTPC64
4278 -- : BFD_RELOC_X86_64_GOTPLT64
4279 -- : BFD_RELOC_X86_64_PLTOFF64
4280 -- : BFD_RELOC_X86_64_GOTPC32_TLSDESC
4281 -- : BFD_RELOC_X86_64_TLSDESC_CALL
4282 -- : BFD_RELOC_X86_64_TLSDESC
4283 -- : BFD_RELOC_X86_64_IRELATIVE
4284 -- : BFD_RELOC_X86_64_PC32_BND
4285 -- : BFD_RELOC_X86_64_PLT32_BND
4286 -- : BFD_RELOC_X86_64_GOTPCRELX
4287 -- : BFD_RELOC_X86_64_REX_GOTPCRELX
4288     x86-64/elf relocations
4289 -- : BFD_RELOC_NS32K_IMM_8
4290 -- : BFD_RELOC_NS32K_IMM_16
4291 -- : BFD_RELOC_NS32K_IMM_32
4292 -- : BFD_RELOC_NS32K_IMM_8_PCREL
4293 -- : BFD_RELOC_NS32K_IMM_16_PCREL
4294 -- : BFD_RELOC_NS32K_IMM_32_PCREL
4295 -- : BFD_RELOC_NS32K_DISP_8
4296 -- : BFD_RELOC_NS32K_DISP_16
4297 -- : BFD_RELOC_NS32K_DISP_32
4298 -- : BFD_RELOC_NS32K_DISP_8_PCREL
4299 -- : BFD_RELOC_NS32K_DISP_16_PCREL
4300 -- : BFD_RELOC_NS32K_DISP_32_PCREL
4301     ns32k relocations
4302 -- : BFD_RELOC_PDP11_DISP_8_PCREL
4303 -- : BFD_RELOC_PDP11_DISP_6_PCREL
4304     PDP11 relocations
4305 -- : BFD_RELOC_PJ_CODE_HI16
4306 -- : BFD_RELOC_PJ_CODE_LO16
4307 -- : BFD_RELOC_PJ_CODE_DIR16
4308 -- : BFD_RELOC_PJ_CODE_DIR32
4309 -- : BFD_RELOC_PJ_CODE_REL16
4310 -- : BFD_RELOC_PJ_CODE_REL32
4311     Picojava relocs.  Not all of these appear in object files.
4312 -- : BFD_RELOC_PPC_B26
4313 -- : BFD_RELOC_PPC_BA26
4314 -- : BFD_RELOC_PPC_TOC16
4315 -- : BFD_RELOC_PPC_B16
4316 -- : BFD_RELOC_PPC_B16_BRTAKEN
4317 -- : BFD_RELOC_PPC_B16_BRNTAKEN
4318 -- : BFD_RELOC_PPC_BA16
4319 -- : BFD_RELOC_PPC_BA16_BRTAKEN
4320 -- : BFD_RELOC_PPC_BA16_BRNTAKEN
4321 -- : BFD_RELOC_PPC_COPY
4322 -- : BFD_RELOC_PPC_GLOB_DAT
4323 -- : BFD_RELOC_PPC_JMP_SLOT
4324 -- : BFD_RELOC_PPC_RELATIVE
4325 -- : BFD_RELOC_PPC_LOCAL24PC
4326 -- : BFD_RELOC_PPC_EMB_NADDR32
4327 -- : BFD_RELOC_PPC_EMB_NADDR16
4328 -- : BFD_RELOC_PPC_EMB_NADDR16_LO
4329 -- : BFD_RELOC_PPC_EMB_NADDR16_HI
4330 -- : BFD_RELOC_PPC_EMB_NADDR16_HA
4331 -- : BFD_RELOC_PPC_EMB_SDAI16
4332 -- : BFD_RELOC_PPC_EMB_SDA2I16
4333 -- : BFD_RELOC_PPC_EMB_SDA2REL
4334 -- : BFD_RELOC_PPC_EMB_SDA21
4335 -- : BFD_RELOC_PPC_EMB_MRKREF
4336 -- : BFD_RELOC_PPC_EMB_RELSEC16
4337 -- : BFD_RELOC_PPC_EMB_RELST_LO
4338 -- : BFD_RELOC_PPC_EMB_RELST_HI
4339 -- : BFD_RELOC_PPC_EMB_RELST_HA
4340 -- : BFD_RELOC_PPC_EMB_BIT_FLD
4341 -- : BFD_RELOC_PPC_EMB_RELSDA
4342 -- : BFD_RELOC_PPC_VLE_REL8
4343 -- : BFD_RELOC_PPC_VLE_REL15
4344 -- : BFD_RELOC_PPC_VLE_REL24
4345 -- : BFD_RELOC_PPC_VLE_LO16A
4346 -- : BFD_RELOC_PPC_VLE_LO16D
4347 -- : BFD_RELOC_PPC_VLE_HI16A
4348 -- : BFD_RELOC_PPC_VLE_HI16D
4349 -- : BFD_RELOC_PPC_VLE_HA16A
4350 -- : BFD_RELOC_PPC_VLE_HA16D
4351 -- : BFD_RELOC_PPC_VLE_SDA21
4352 -- : BFD_RELOC_PPC_VLE_SDA21_LO
4353 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16A
4354 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16D
4355 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16A
4356 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16D
4357 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16A
4358 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16D
4359 -- : BFD_RELOC_PPC_16DX_HA
4360 -- : BFD_RELOC_PPC_REL16DX_HA
4361 -- : BFD_RELOC_PPC64_HIGHER
4362 -- : BFD_RELOC_PPC64_HIGHER_S
4363 -- : BFD_RELOC_PPC64_HIGHEST
4364 -- : BFD_RELOC_PPC64_HIGHEST_S
4365 -- : BFD_RELOC_PPC64_TOC16_LO
4366 -- : BFD_RELOC_PPC64_TOC16_HI
4367 -- : BFD_RELOC_PPC64_TOC16_HA
4368 -- : BFD_RELOC_PPC64_TOC
4369 -- : BFD_RELOC_PPC64_PLTGOT16
4370 -- : BFD_RELOC_PPC64_PLTGOT16_LO
4371 -- : BFD_RELOC_PPC64_PLTGOT16_HI
4372 -- : BFD_RELOC_PPC64_PLTGOT16_HA
4373 -- : BFD_RELOC_PPC64_ADDR16_DS
4374 -- : BFD_RELOC_PPC64_ADDR16_LO_DS
4375 -- : BFD_RELOC_PPC64_GOT16_DS
4376 -- : BFD_RELOC_PPC64_GOT16_LO_DS
4377 -- : BFD_RELOC_PPC64_PLT16_LO_DS
4378 -- : BFD_RELOC_PPC64_SECTOFF_DS
4379 -- : BFD_RELOC_PPC64_SECTOFF_LO_DS
4380 -- : BFD_RELOC_PPC64_TOC16_DS
4381 -- : BFD_RELOC_PPC64_TOC16_LO_DS
4382 -- : BFD_RELOC_PPC64_PLTGOT16_DS
4383 -- : BFD_RELOC_PPC64_PLTGOT16_LO_DS
4384 -- : BFD_RELOC_PPC64_ADDR16_HIGH
4385 -- : BFD_RELOC_PPC64_ADDR16_HIGHA
4386 -- : BFD_RELOC_PPC64_REL16_HIGH
4387 -- : BFD_RELOC_PPC64_REL16_HIGHA
4388 -- : BFD_RELOC_PPC64_REL16_HIGHER
4389 -- : BFD_RELOC_PPC64_REL16_HIGHERA
4390 -- : BFD_RELOC_PPC64_REL16_HIGHEST
4391 -- : BFD_RELOC_PPC64_REL16_HIGHESTA
4392 -- : BFD_RELOC_PPC64_ADDR64_LOCAL
4393 -- : BFD_RELOC_PPC64_ENTRY
4394 -- : BFD_RELOC_PPC64_REL24_NOTOC
4395 -- : BFD_RELOC_PPC64_D34
4396 -- : BFD_RELOC_PPC64_D34_LO
4397 -- : BFD_RELOC_PPC64_D34_HI30
4398 -- : BFD_RELOC_PPC64_D34_HA30
4399 -- : BFD_RELOC_PPC64_PCREL34
4400 -- : BFD_RELOC_PPC64_GOT_PCREL34
4401 -- : BFD_RELOC_PPC64_PLT_PCREL34
4402 -- : BFD_RELOC_PPC64_ADDR16_HIGHER34
4403 -- : BFD_RELOC_PPC64_ADDR16_HIGHERA34
4404 -- : BFD_RELOC_PPC64_ADDR16_HIGHEST34
4405 -- : BFD_RELOC_PPC64_ADDR16_HIGHESTA34
4406 -- : BFD_RELOC_PPC64_REL16_HIGHER34
4407 -- : BFD_RELOC_PPC64_REL16_HIGHERA34
4408 -- : BFD_RELOC_PPC64_REL16_HIGHEST34
4409 -- : BFD_RELOC_PPC64_REL16_HIGHESTA34
4410 -- : BFD_RELOC_PPC64_D28
4411 -- : BFD_RELOC_PPC64_PCREL28
4412     Power(rs6000) and PowerPC relocations.
4413 -- : BFD_RELOC_PPC_TLS
4414 -- : BFD_RELOC_PPC_TLSGD
4415 -- : BFD_RELOC_PPC_TLSLD
4416 -- : BFD_RELOC_PPC_DTPMOD
4417 -- : BFD_RELOC_PPC_TPREL16
4418 -- : BFD_RELOC_PPC_TPREL16_LO
4419 -- : BFD_RELOC_PPC_TPREL16_HI
4420 -- : BFD_RELOC_PPC_TPREL16_HA
4421 -- : BFD_RELOC_PPC_TPREL
4422 -- : BFD_RELOC_PPC_DTPREL16
4423 -- : BFD_RELOC_PPC_DTPREL16_LO
4424 -- : BFD_RELOC_PPC_DTPREL16_HI
4425 -- : BFD_RELOC_PPC_DTPREL16_HA
4426 -- : BFD_RELOC_PPC_DTPREL
4427 -- : BFD_RELOC_PPC_GOT_TLSGD16
4428 -- : BFD_RELOC_PPC_GOT_TLSGD16_LO
4429 -- : BFD_RELOC_PPC_GOT_TLSGD16_HI
4430 -- : BFD_RELOC_PPC_GOT_TLSGD16_HA
4431 -- : BFD_RELOC_PPC_GOT_TLSLD16
4432 -- : BFD_RELOC_PPC_GOT_TLSLD16_LO
4433 -- : BFD_RELOC_PPC_GOT_TLSLD16_HI
4434 -- : BFD_RELOC_PPC_GOT_TLSLD16_HA
4435 -- : BFD_RELOC_PPC_GOT_TPREL16
4436 -- : BFD_RELOC_PPC_GOT_TPREL16_LO
4437 -- : BFD_RELOC_PPC_GOT_TPREL16_HI
4438 -- : BFD_RELOC_PPC_GOT_TPREL16_HA
4439 -- : BFD_RELOC_PPC_GOT_DTPREL16
4440 -- : BFD_RELOC_PPC_GOT_DTPREL16_LO
4441 -- : BFD_RELOC_PPC_GOT_DTPREL16_HI
4442 -- : BFD_RELOC_PPC_GOT_DTPREL16_HA
4443 -- : BFD_RELOC_PPC64_TPREL16_DS
4444 -- : BFD_RELOC_PPC64_TPREL16_LO_DS
4445 -- : BFD_RELOC_PPC64_TPREL16_HIGH
4446 -- : BFD_RELOC_PPC64_TPREL16_HIGHA
4447 -- : BFD_RELOC_PPC64_TPREL16_HIGHER
4448 -- : BFD_RELOC_PPC64_TPREL16_HIGHERA
4449 -- : BFD_RELOC_PPC64_TPREL16_HIGHEST
4450 -- : BFD_RELOC_PPC64_TPREL16_HIGHESTA
4451 -- : BFD_RELOC_PPC64_DTPREL16_DS
4452 -- : BFD_RELOC_PPC64_DTPREL16_LO_DS
4453 -- : BFD_RELOC_PPC64_DTPREL16_HIGH
4454 -- : BFD_RELOC_PPC64_DTPREL16_HIGHA
4455 -- : BFD_RELOC_PPC64_DTPREL16_HIGHER
4456 -- : BFD_RELOC_PPC64_DTPREL16_HIGHERA
4457 -- : BFD_RELOC_PPC64_DTPREL16_HIGHEST
4458 -- : BFD_RELOC_PPC64_DTPREL16_HIGHESTA
4459 -- : BFD_RELOC_PPC64_TPREL34
4460 -- : BFD_RELOC_PPC64_DTPREL34
4461 -- : BFD_RELOC_PPC64_GOT_TLSGD_PCREL34
4462 -- : BFD_RELOC_PPC64_GOT_TLSLD_PCREL34
4463 -- : BFD_RELOC_PPC64_GOT_TPREL_PCREL34
4464 -- : BFD_RELOC_PPC64_GOT_DTPREL_PCREL34
4465 -- : BFD_RELOC_PPC64_TLS_PCREL
4466     PowerPC and PowerPC64 thread-local storage relocations.
4467 -- : BFD_RELOC_I370_D12
4468     IBM 370/390 relocations
4469 -- : BFD_RELOC_CTOR
4470     The type of reloc used to build a constructor table - at the moment
4471     probably a 32 bit wide absolute relocation, but the target can
4472     choose.  It generally does map to one of the other relocation
4473     types.
4474 -- : BFD_RELOC_ARM_PCREL_BRANCH
4475     ARM 26 bit pc-relative branch.  The lowest two bits must be zero
4476     and are not stored in the instruction.
4477 -- : BFD_RELOC_ARM_PCREL_BLX
4478     ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
4479     not stored in the instruction.  The 2nd lowest bit comes from a 1
4480     bit field in the instruction.
4481 -- : BFD_RELOC_THUMB_PCREL_BLX
4482     Thumb 22 bit pc-relative branch.  The lowest bit must be zero and
4483     is not stored in the instruction.  The 2nd lowest bit comes from a
4484     1 bit field in the instruction.
4485 -- : BFD_RELOC_ARM_PCREL_CALL
4486     ARM 26-bit pc-relative branch for an unconditional BL or BLX
4487     instruction.
4488 -- : BFD_RELOC_ARM_PCREL_JUMP
4489     ARM 26-bit pc-relative branch for B or conditional BL instruction.
4490 -- : BFD_RELOC_THUMB_PCREL_BRANCH5
4491     ARM 5-bit pc-relative branch for Branch Future instructions.
4492 -- : BFD_RELOC_THUMB_PCREL_BFCSEL
4493     ARM 6-bit pc-relative branch for BFCSEL instruction.
4494 -- : BFD_RELOC_ARM_THUMB_BF17
4495     ARM 17-bit pc-relative branch for Branch Future instructions.
4496 -- : BFD_RELOC_ARM_THUMB_BF13
4497     ARM 13-bit pc-relative branch for BFCSEL instruction.
4498 -- : BFD_RELOC_ARM_THUMB_BF19
4499     ARM 19-bit pc-relative branch for Branch Future Link instruction.
4500 -- : BFD_RELOC_ARM_THUMB_LOOP12
4501     ARM 12-bit pc-relative branch for Low Overhead Loop instructions.
4502 -- : BFD_RELOC_THUMB_PCREL_BRANCH7
4503 -- : BFD_RELOC_THUMB_PCREL_BRANCH9
4504 -- : BFD_RELOC_THUMB_PCREL_BRANCH12
4505 -- : BFD_RELOC_THUMB_PCREL_BRANCH20
4506 -- : BFD_RELOC_THUMB_PCREL_BRANCH23
4507 -- : BFD_RELOC_THUMB_PCREL_BRANCH25
4508     Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.  The
4509     lowest bit must be zero and is not stored in the instruction.  Note
4510     that the corresponding ELF R_ARM_THM_JUMPnn constant has an "nn"
4511     one smaller in all cases.  Note further that BRANCH23 corresponds
4512     to R_ARM_THM_CALL.
4513 -- : BFD_RELOC_ARM_OFFSET_IMM
4514     12-bit immediate offset, used in ARM-format ldr and str
4515     instructions.
4516 -- : BFD_RELOC_ARM_THUMB_OFFSET
4517     5-bit immediate offset, used in Thumb-format ldr and str
4518     instructions.
4519 -- : BFD_RELOC_ARM_TARGET1
4520     Pc-relative or absolute relocation depending on target.  Used for
4521     entries in .init_array sections.
4522 -- : BFD_RELOC_ARM_ROSEGREL32
4523     Read-only segment base relative address.
4524 -- : BFD_RELOC_ARM_SBREL32
4525     Data segment base relative address.
4526 -- : BFD_RELOC_ARM_TARGET2
4527     This reloc is used for references to RTTI data from exception
4528     handling tables.  The actual definition depends on the target.  It
4529     may be a pc-relative or some form of GOT-indirect relocation.
4530 -- : BFD_RELOC_ARM_PREL31
4531     31-bit PC relative address.
4532 -- : BFD_RELOC_ARM_MOVW
4533 -- : BFD_RELOC_ARM_MOVT
4534 -- : BFD_RELOC_ARM_MOVW_PCREL
4535 -- : BFD_RELOC_ARM_MOVT_PCREL
4536 -- : BFD_RELOC_ARM_THUMB_MOVW
4537 -- : BFD_RELOC_ARM_THUMB_MOVT
4538 -- : BFD_RELOC_ARM_THUMB_MOVW_PCREL
4539 -- : BFD_RELOC_ARM_THUMB_MOVT_PCREL
4540     Low and High halfword relocations for MOVW and MOVT instructions.
4541 -- : BFD_RELOC_ARM_GOTFUNCDESC
4542 -- : BFD_RELOC_ARM_GOTOFFFUNCDESC
4543 -- : BFD_RELOC_ARM_FUNCDESC
4544 -- : BFD_RELOC_ARM_FUNCDESC_VALUE
4545 -- : BFD_RELOC_ARM_TLS_GD32_FDPIC
4546 -- : BFD_RELOC_ARM_TLS_LDM32_FDPIC
4547 -- : BFD_RELOC_ARM_TLS_IE32_FDPIC
4548     ARM FDPIC specific relocations.
4549 -- : BFD_RELOC_ARM_JUMP_SLOT
4550 -- : BFD_RELOC_ARM_GLOB_DAT
4551 -- : BFD_RELOC_ARM_GOT32
4552 -- : BFD_RELOC_ARM_PLT32
4553 -- : BFD_RELOC_ARM_RELATIVE
4554 -- : BFD_RELOC_ARM_GOTOFF
4555 -- : BFD_RELOC_ARM_GOTPC
4556 -- : BFD_RELOC_ARM_GOT_PREL
4557     Relocations for setting up GOTs and PLTs for shared libraries.
4558 -- : BFD_RELOC_ARM_TLS_GD32
4559 -- : BFD_RELOC_ARM_TLS_LDO32
4560 -- : BFD_RELOC_ARM_TLS_LDM32
4561 -- : BFD_RELOC_ARM_TLS_DTPOFF32
4562 -- : BFD_RELOC_ARM_TLS_DTPMOD32
4563 -- : BFD_RELOC_ARM_TLS_TPOFF32
4564 -- : BFD_RELOC_ARM_TLS_IE32
4565 -- : BFD_RELOC_ARM_TLS_LE32
4566 -- : BFD_RELOC_ARM_TLS_GOTDESC
4567 -- : BFD_RELOC_ARM_TLS_CALL
4568 -- : BFD_RELOC_ARM_THM_TLS_CALL
4569 -- : BFD_RELOC_ARM_TLS_DESCSEQ
4570 -- : BFD_RELOC_ARM_THM_TLS_DESCSEQ
4571 -- : BFD_RELOC_ARM_TLS_DESC
4572     ARM thread-local storage relocations.
4573 -- : BFD_RELOC_ARM_ALU_PC_G0_NC
4574 -- : BFD_RELOC_ARM_ALU_PC_G0
4575 -- : BFD_RELOC_ARM_ALU_PC_G1_NC
4576 -- : BFD_RELOC_ARM_ALU_PC_G1
4577 -- : BFD_RELOC_ARM_ALU_PC_G2
4578 -- : BFD_RELOC_ARM_LDR_PC_G0
4579 -- : BFD_RELOC_ARM_LDR_PC_G1
4580 -- : BFD_RELOC_ARM_LDR_PC_G2
4581 -- : BFD_RELOC_ARM_LDRS_PC_G0
4582 -- : BFD_RELOC_ARM_LDRS_PC_G1
4583 -- : BFD_RELOC_ARM_LDRS_PC_G2
4584 -- : BFD_RELOC_ARM_LDC_PC_G0
4585 -- : BFD_RELOC_ARM_LDC_PC_G1
4586 -- : BFD_RELOC_ARM_LDC_PC_G2
4587 -- : BFD_RELOC_ARM_ALU_SB_G0_NC
4588 -- : BFD_RELOC_ARM_ALU_SB_G0
4589 -- : BFD_RELOC_ARM_ALU_SB_G1_NC
4590 -- : BFD_RELOC_ARM_ALU_SB_G1
4591 -- : BFD_RELOC_ARM_ALU_SB_G2
4592 -- : BFD_RELOC_ARM_LDR_SB_G0
4593 -- : BFD_RELOC_ARM_LDR_SB_G1
4594 -- : BFD_RELOC_ARM_LDR_SB_G2
4595 -- : BFD_RELOC_ARM_LDRS_SB_G0
4596 -- : BFD_RELOC_ARM_LDRS_SB_G1
4597 -- : BFD_RELOC_ARM_LDRS_SB_G2
4598 -- : BFD_RELOC_ARM_LDC_SB_G0
4599 -- : BFD_RELOC_ARM_LDC_SB_G1
4600 -- : BFD_RELOC_ARM_LDC_SB_G2
4601     ARM group relocations.
4602 -- : BFD_RELOC_ARM_V4BX
4603     Annotation of BX instructions.
4604 -- : BFD_RELOC_ARM_IRELATIVE
4605     ARM support for STT_GNU_IFUNC.
4606 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC
4607 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC
4608 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC
4609 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC
4610     Thumb1 relocations to support execute-only code.
4611 -- : BFD_RELOC_ARM_IMMEDIATE
4612 -- : BFD_RELOC_ARM_ADRL_IMMEDIATE
4613 -- : BFD_RELOC_ARM_T32_IMMEDIATE
4614 -- : BFD_RELOC_ARM_T32_ADD_IMM
4615 -- : BFD_RELOC_ARM_T32_IMM12
4616 -- : BFD_RELOC_ARM_T32_ADD_PC12
4617 -- : BFD_RELOC_ARM_SHIFT_IMM
4618 -- : BFD_RELOC_ARM_SMC
4619 -- : BFD_RELOC_ARM_HVC
4620 -- : BFD_RELOC_ARM_SWI
4621 -- : BFD_RELOC_ARM_MULTI
4622 -- : BFD_RELOC_ARM_CP_OFF_IMM
4623 -- : BFD_RELOC_ARM_CP_OFF_IMM_S2
4624 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM
4625 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
4626 -- : BFD_RELOC_ARM_T32_VLDR_VSTR_OFF_IMM
4627 -- : BFD_RELOC_ARM_ADR_IMM
4628 -- : BFD_RELOC_ARM_LDR_IMM
4629 -- : BFD_RELOC_ARM_LITERAL
4630 -- : BFD_RELOC_ARM_IN_POOL
4631 -- : BFD_RELOC_ARM_OFFSET_IMM8
4632 -- : BFD_RELOC_ARM_T32_OFFSET_U8
4633 -- : BFD_RELOC_ARM_T32_OFFSET_IMM
4634 -- : BFD_RELOC_ARM_HWLITERAL
4635 -- : BFD_RELOC_ARM_THUMB_ADD
4636 -- : BFD_RELOC_ARM_THUMB_IMM
4637 -- : BFD_RELOC_ARM_THUMB_SHIFT
4638     These relocs are only used within the ARM assembler.  They are not
4639     (at present) written to any object files.
4640 -- : BFD_RELOC_SH_PCDISP8BY2
4641 -- : BFD_RELOC_SH_PCDISP12BY2
4642 -- : BFD_RELOC_SH_IMM3
4643 -- : BFD_RELOC_SH_IMM3U
4644 -- : BFD_RELOC_SH_DISP12
4645 -- : BFD_RELOC_SH_DISP12BY2
4646 -- : BFD_RELOC_SH_DISP12BY4
4647 -- : BFD_RELOC_SH_DISP12BY8
4648 -- : BFD_RELOC_SH_DISP20
4649 -- : BFD_RELOC_SH_DISP20BY8
4650 -- : BFD_RELOC_SH_IMM4
4651 -- : BFD_RELOC_SH_IMM4BY2
4652 -- : BFD_RELOC_SH_IMM4BY4
4653 -- : BFD_RELOC_SH_IMM8
4654 -- : BFD_RELOC_SH_IMM8BY2
4655 -- : BFD_RELOC_SH_IMM8BY4
4656 -- : BFD_RELOC_SH_PCRELIMM8BY2
4657 -- : BFD_RELOC_SH_PCRELIMM8BY4
4658 -- : BFD_RELOC_SH_SWITCH16
4659 -- : BFD_RELOC_SH_SWITCH32
4660 -- : BFD_RELOC_SH_USES
4661 -- : BFD_RELOC_SH_COUNT
4662 -- : BFD_RELOC_SH_ALIGN
4663 -- : BFD_RELOC_SH_CODE
4664 -- : BFD_RELOC_SH_DATA
4665 -- : BFD_RELOC_SH_LABEL
4666 -- : BFD_RELOC_SH_LOOP_START
4667 -- : BFD_RELOC_SH_LOOP_END
4668 -- : BFD_RELOC_SH_COPY
4669 -- : BFD_RELOC_SH_GLOB_DAT
4670 -- : BFD_RELOC_SH_JMP_SLOT
4671 -- : BFD_RELOC_SH_RELATIVE
4672 -- : BFD_RELOC_SH_GOTPC
4673 -- : BFD_RELOC_SH_GOT_LOW16
4674 -- : BFD_RELOC_SH_GOT_MEDLOW16
4675 -- : BFD_RELOC_SH_GOT_MEDHI16
4676 -- : BFD_RELOC_SH_GOT_HI16
4677 -- : BFD_RELOC_SH_GOTPLT_LOW16
4678 -- : BFD_RELOC_SH_GOTPLT_MEDLOW16
4679 -- : BFD_RELOC_SH_GOTPLT_MEDHI16
4680 -- : BFD_RELOC_SH_GOTPLT_HI16
4681 -- : BFD_RELOC_SH_PLT_LOW16
4682 -- : BFD_RELOC_SH_PLT_MEDLOW16
4683 -- : BFD_RELOC_SH_PLT_MEDHI16
4684 -- : BFD_RELOC_SH_PLT_HI16
4685 -- : BFD_RELOC_SH_GOTOFF_LOW16
4686 -- : BFD_RELOC_SH_GOTOFF_MEDLOW16
4687 -- : BFD_RELOC_SH_GOTOFF_MEDHI16
4688 -- : BFD_RELOC_SH_GOTOFF_HI16
4689 -- : BFD_RELOC_SH_GOTPC_LOW16
4690 -- : BFD_RELOC_SH_GOTPC_MEDLOW16
4691 -- : BFD_RELOC_SH_GOTPC_MEDHI16
4692 -- : BFD_RELOC_SH_GOTPC_HI16
4693 -- : BFD_RELOC_SH_COPY64
4694 -- : BFD_RELOC_SH_GLOB_DAT64
4695 -- : BFD_RELOC_SH_JMP_SLOT64
4696 -- : BFD_RELOC_SH_RELATIVE64
4697 -- : BFD_RELOC_SH_GOT10BY4
4698 -- : BFD_RELOC_SH_GOT10BY8
4699 -- : BFD_RELOC_SH_GOTPLT10BY4
4700 -- : BFD_RELOC_SH_GOTPLT10BY8
4701 -- : BFD_RELOC_SH_GOTPLT32
4702 -- : BFD_RELOC_SH_SHMEDIA_CODE
4703 -- : BFD_RELOC_SH_IMMU5
4704 -- : BFD_RELOC_SH_IMMS6
4705 -- : BFD_RELOC_SH_IMMS6BY32
4706 -- : BFD_RELOC_SH_IMMU6
4707 -- : BFD_RELOC_SH_IMMS10
4708 -- : BFD_RELOC_SH_IMMS10BY2
4709 -- : BFD_RELOC_SH_IMMS10BY4
4710 -- : BFD_RELOC_SH_IMMS10BY8
4711 -- : BFD_RELOC_SH_IMMS16
4712 -- : BFD_RELOC_SH_IMMU16
4713 -- : BFD_RELOC_SH_IMM_LOW16
4714 -- : BFD_RELOC_SH_IMM_LOW16_PCREL
4715 -- : BFD_RELOC_SH_IMM_MEDLOW16
4716 -- : BFD_RELOC_SH_IMM_MEDLOW16_PCREL
4717 -- : BFD_RELOC_SH_IMM_MEDHI16
4718 -- : BFD_RELOC_SH_IMM_MEDHI16_PCREL
4719 -- : BFD_RELOC_SH_IMM_HI16
4720 -- : BFD_RELOC_SH_IMM_HI16_PCREL
4721 -- : BFD_RELOC_SH_PT_16
4722 -- : BFD_RELOC_SH_TLS_GD_32
4723 -- : BFD_RELOC_SH_TLS_LD_32
4724 -- : BFD_RELOC_SH_TLS_LDO_32
4725 -- : BFD_RELOC_SH_TLS_IE_32
4726 -- : BFD_RELOC_SH_TLS_LE_32
4727 -- : BFD_RELOC_SH_TLS_DTPMOD32
4728 -- : BFD_RELOC_SH_TLS_DTPOFF32
4729 -- : BFD_RELOC_SH_TLS_TPOFF32
4730 -- : BFD_RELOC_SH_GOT20
4731 -- : BFD_RELOC_SH_GOTOFF20
4732 -- : BFD_RELOC_SH_GOTFUNCDESC
4733 -- : BFD_RELOC_SH_GOTFUNCDESC20
4734 -- : BFD_RELOC_SH_GOTOFFFUNCDESC
4735 -- : BFD_RELOC_SH_GOTOFFFUNCDESC20
4736 -- : BFD_RELOC_SH_FUNCDESC
4737     Renesas / SuperH SH relocs.  Not all of these appear in object
4738     files.
4739 -- : BFD_RELOC_ARC_NONE
4740 -- : BFD_RELOC_ARC_8
4741 -- : BFD_RELOC_ARC_16
4742 -- : BFD_RELOC_ARC_24
4743 -- : BFD_RELOC_ARC_32
4744 -- : BFD_RELOC_ARC_N8
4745 -- : BFD_RELOC_ARC_N16
4746 -- : BFD_RELOC_ARC_N24
4747 -- : BFD_RELOC_ARC_N32
4748 -- : BFD_RELOC_ARC_SDA
4749 -- : BFD_RELOC_ARC_SECTOFF
4750 -- : BFD_RELOC_ARC_S21H_PCREL
4751 -- : BFD_RELOC_ARC_S21W_PCREL
4752 -- : BFD_RELOC_ARC_S25H_PCREL
4753 -- : BFD_RELOC_ARC_S25W_PCREL
4754 -- : BFD_RELOC_ARC_SDA32
4755 -- : BFD_RELOC_ARC_SDA_LDST
4756 -- : BFD_RELOC_ARC_SDA_LDST1
4757 -- : BFD_RELOC_ARC_SDA_LDST2
4758 -- : BFD_RELOC_ARC_SDA16_LD
4759 -- : BFD_RELOC_ARC_SDA16_LD1
4760 -- : BFD_RELOC_ARC_SDA16_LD2
4761 -- : BFD_RELOC_ARC_S13_PCREL
4762 -- : BFD_RELOC_ARC_W
4763 -- : BFD_RELOC_ARC_32_ME
4764 -- : BFD_RELOC_ARC_32_ME_S
4765 -- : BFD_RELOC_ARC_N32_ME
4766 -- : BFD_RELOC_ARC_SECTOFF_ME
4767 -- : BFD_RELOC_ARC_SDA32_ME
4768 -- : BFD_RELOC_ARC_W_ME
4769 -- : BFD_RELOC_AC_SECTOFF_U8
4770 -- : BFD_RELOC_AC_SECTOFF_U8_1
4771 -- : BFD_RELOC_AC_SECTOFF_U8_2
4772 -- : BFD_RELOC_AC_SECTOFF_S9
4773 -- : BFD_RELOC_AC_SECTOFF_S9_1
4774 -- : BFD_RELOC_AC_SECTOFF_S9_2
4775 -- : BFD_RELOC_ARC_SECTOFF_ME_1
4776 -- : BFD_RELOC_ARC_SECTOFF_ME_2
4777 -- : BFD_RELOC_ARC_SECTOFF_1
4778 -- : BFD_RELOC_ARC_SECTOFF_2
4779 -- : BFD_RELOC_ARC_SDA_12
4780 -- : BFD_RELOC_ARC_SDA16_ST2
4781 -- : BFD_RELOC_ARC_32_PCREL
4782 -- : BFD_RELOC_ARC_PC32
4783 -- : BFD_RELOC_ARC_GOT32
4784 -- : BFD_RELOC_ARC_GOTPC32
4785 -- : BFD_RELOC_ARC_PLT32
4786 -- : BFD_RELOC_ARC_COPY
4787 -- : BFD_RELOC_ARC_GLOB_DAT
4788 -- : BFD_RELOC_ARC_JMP_SLOT
4789 -- : BFD_RELOC_ARC_RELATIVE
4790 -- : BFD_RELOC_ARC_GOTOFF
4791 -- : BFD_RELOC_ARC_GOTPC
4792 -- : BFD_RELOC_ARC_S21W_PCREL_PLT
4793 -- : BFD_RELOC_ARC_S25H_PCREL_PLT
4794 -- : BFD_RELOC_ARC_TLS_DTPMOD
4795 -- : BFD_RELOC_ARC_TLS_TPOFF
4796 -- : BFD_RELOC_ARC_TLS_GD_GOT
4797 -- : BFD_RELOC_ARC_TLS_GD_LD
4798 -- : BFD_RELOC_ARC_TLS_GD_CALL
4799 -- : BFD_RELOC_ARC_TLS_IE_GOT
4800 -- : BFD_RELOC_ARC_TLS_DTPOFF
4801 -- : BFD_RELOC_ARC_TLS_DTPOFF_S9
4802 -- : BFD_RELOC_ARC_TLS_LE_S9
4803 -- : BFD_RELOC_ARC_TLS_LE_32
4804 -- : BFD_RELOC_ARC_S25W_PCREL_PLT
4805 -- : BFD_RELOC_ARC_S21H_PCREL_PLT
4806 -- : BFD_RELOC_ARC_NPS_CMEM16
4807 -- : BFD_RELOC_ARC_JLI_SECTOFF
4808     ARC relocs.
4809 -- : BFD_RELOC_BFIN_16_IMM
4810     ADI Blackfin 16 bit immediate absolute reloc.
4811 -- : BFD_RELOC_BFIN_16_HIGH
4812     ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
4813 -- : BFD_RELOC_BFIN_4_PCREL
4814     ADI Blackfin 'a' part of LSETUP.
4815 -- : BFD_RELOC_BFIN_5_PCREL
4816     ADI Blackfin.
4817 -- : BFD_RELOC_BFIN_16_LOW
4818     ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
4819 -- : BFD_RELOC_BFIN_10_PCREL
4820     ADI Blackfin.
4821 -- : BFD_RELOC_BFIN_11_PCREL
4822     ADI Blackfin 'b' part of LSETUP.
4823 -- : BFD_RELOC_BFIN_12_PCREL_JUMP
4824     ADI Blackfin.
4825 -- : BFD_RELOC_BFIN_12_PCREL_JUMP_S
4826     ADI Blackfin Short jump, pcrel.
4827 -- : BFD_RELOC_BFIN_24_PCREL_CALL_X
4828     ADI Blackfin Call.x not implemented.
4829 -- : BFD_RELOC_BFIN_24_PCREL_JUMP_L
4830     ADI Blackfin Long Jump pcrel.
4831 -- : BFD_RELOC_BFIN_GOT17M4
4832 -- : BFD_RELOC_BFIN_GOTHI
4833 -- : BFD_RELOC_BFIN_GOTLO
4834 -- : BFD_RELOC_BFIN_FUNCDESC
4835 -- : BFD_RELOC_BFIN_FUNCDESC_GOT17M4
4836 -- : BFD_RELOC_BFIN_FUNCDESC_GOTHI
4837 -- : BFD_RELOC_BFIN_FUNCDESC_GOTLO
4838 -- : BFD_RELOC_BFIN_FUNCDESC_VALUE
4839 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
4840 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
4841 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
4842 -- : BFD_RELOC_BFIN_GOTOFF17M4
4843 -- : BFD_RELOC_BFIN_GOTOFFHI
4844 -- : BFD_RELOC_BFIN_GOTOFFLO
4845     ADI Blackfin FD-PIC relocations.
4846 -- : BFD_RELOC_BFIN_GOT
4847     ADI Blackfin GOT relocation.
4848 -- : BFD_RELOC_BFIN_PLTPC
4849     ADI Blackfin PLTPC relocation.
4850 -- : BFD_ARELOC_BFIN_PUSH
4851     ADI Blackfin arithmetic relocation.
4852 -- : BFD_ARELOC_BFIN_CONST
4853     ADI Blackfin arithmetic relocation.
4854 -- : BFD_ARELOC_BFIN_ADD
4855     ADI Blackfin arithmetic relocation.
4856 -- : BFD_ARELOC_BFIN_SUB
4857     ADI Blackfin arithmetic relocation.
4858 -- : BFD_ARELOC_BFIN_MULT
4859     ADI Blackfin arithmetic relocation.
4860 -- : BFD_ARELOC_BFIN_DIV
4861     ADI Blackfin arithmetic relocation.
4862 -- : BFD_ARELOC_BFIN_MOD
4863     ADI Blackfin arithmetic relocation.
4864 -- : BFD_ARELOC_BFIN_LSHIFT
4865     ADI Blackfin arithmetic relocation.
4866 -- : BFD_ARELOC_BFIN_RSHIFT
4867     ADI Blackfin arithmetic relocation.
4868 -- : BFD_ARELOC_BFIN_AND
4869     ADI Blackfin arithmetic relocation.
4870 -- : BFD_ARELOC_BFIN_OR
4871     ADI Blackfin arithmetic relocation.
4872 -- : BFD_ARELOC_BFIN_XOR
4873     ADI Blackfin arithmetic relocation.
4874 -- : BFD_ARELOC_BFIN_LAND
4875     ADI Blackfin arithmetic relocation.
4876 -- : BFD_ARELOC_BFIN_LOR
4877     ADI Blackfin arithmetic relocation.
4878 -- : BFD_ARELOC_BFIN_LEN
4879     ADI Blackfin arithmetic relocation.
4880 -- : BFD_ARELOC_BFIN_NEG
4881     ADI Blackfin arithmetic relocation.
4882 -- : BFD_ARELOC_BFIN_COMP
4883     ADI Blackfin arithmetic relocation.
4884 -- : BFD_ARELOC_BFIN_PAGE
4885     ADI Blackfin arithmetic relocation.
4886 -- : BFD_ARELOC_BFIN_HWPAGE
4887     ADI Blackfin arithmetic relocation.
4888 -- : BFD_ARELOC_BFIN_ADDR
4889     ADI Blackfin arithmetic relocation.
4890 -- : BFD_RELOC_D10V_10_PCREL_R
4891     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4892     bits assumed to be 0.
4893 -- : BFD_RELOC_D10V_10_PCREL_L
4894     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4895     bits assumed to be 0.  This is the same as the previous reloc
4896     except it is in the left container, i.e., shifted left 15 bits.
4897 -- : BFD_RELOC_D10V_18
4898     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4899 -- : BFD_RELOC_D10V_18_PCREL
4900     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4901 -- : BFD_RELOC_D30V_6
4902     Mitsubishi D30V relocs.  This is a 6-bit absolute reloc.
4903 -- : BFD_RELOC_D30V_9_PCREL
4904     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4905     be 0.
4906 -- : BFD_RELOC_D30V_9_PCREL_R
4907     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4908     be 0.  Same as the previous reloc but on the right side of the
4909     container.
4910 -- : BFD_RELOC_D30V_15
4911     This is a 12-bit absolute reloc with the right 3 bitsassumed to be
4912     0.
4913 -- : BFD_RELOC_D30V_15_PCREL
4914     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4915     be 0.
4916 -- : BFD_RELOC_D30V_15_PCREL_R
4917     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4918     be 0.  Same as the previous reloc but on the right side of the
4919     container.
4920 -- : BFD_RELOC_D30V_21
4921     This is an 18-bit absolute reloc with the right 3 bits assumed to
4922     be 0.
4923 -- : BFD_RELOC_D30V_21_PCREL
4924     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4925     to be 0.
4926 -- : BFD_RELOC_D30V_21_PCREL_R
4927     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4928     to be 0.  Same as the previous reloc but on the right side of the
4929     container.
4930 -- : BFD_RELOC_D30V_32
4931     This is a 32-bit absolute reloc.
4932 -- : BFD_RELOC_D30V_32_PCREL
4933     This is a 32-bit pc-relative reloc.
4934 -- : BFD_RELOC_DLX_HI16_S
4935     DLX relocs
4936 -- : BFD_RELOC_DLX_LO16
4937     DLX relocs
4938 -- : BFD_RELOC_DLX_JMP26
4939     DLX relocs
4940 -- : BFD_RELOC_M32C_HI8
4941 -- : BFD_RELOC_M32C_RL_JUMP
4942 -- : BFD_RELOC_M32C_RL_1ADDR
4943 -- : BFD_RELOC_M32C_RL_2ADDR
4944     Renesas M16C/M32C Relocations.
4945 -- : BFD_RELOC_M32R_24
4946     Renesas M32R (formerly Mitsubishi M32R) relocs.  This is a 24 bit
4947     absolute address.
4948 -- : BFD_RELOC_M32R_10_PCREL
4949     This is a 10-bit pc-relative reloc with the right 2 bits assumed to
4950     be 0.
4951 -- : BFD_RELOC_M32R_18_PCREL
4952     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4953 -- : BFD_RELOC_M32R_26_PCREL
4954     This is a 26-bit reloc with the right 2 bits assumed to be 0.
4955 -- : BFD_RELOC_M32R_HI16_ULO
4956     This is a 16-bit reloc containing the high 16 bits of an address
4957     used when the lower 16 bits are treated as unsigned.
4958 -- : BFD_RELOC_M32R_HI16_SLO
4959     This is a 16-bit reloc containing the high 16 bits of an address
4960     used when the lower 16 bits are treated as signed.
4961 -- : BFD_RELOC_M32R_LO16
4962     This is a 16-bit reloc containing the lower 16 bits of an address.
4963 -- : BFD_RELOC_M32R_SDA16
4964     This is a 16-bit reloc containing the small data area offset for
4965     use in add3, load, and store instructions.
4966 -- : BFD_RELOC_M32R_GOT24
4967 -- : BFD_RELOC_M32R_26_PLTREL
4968 -- : BFD_RELOC_M32R_COPY
4969 -- : BFD_RELOC_M32R_GLOB_DAT
4970 -- : BFD_RELOC_M32R_JMP_SLOT
4971 -- : BFD_RELOC_M32R_RELATIVE
4972 -- : BFD_RELOC_M32R_GOTOFF
4973 -- : BFD_RELOC_M32R_GOTOFF_HI_ULO
4974 -- : BFD_RELOC_M32R_GOTOFF_HI_SLO
4975 -- : BFD_RELOC_M32R_GOTOFF_LO
4976 -- : BFD_RELOC_M32R_GOTPC24
4977 -- : BFD_RELOC_M32R_GOT16_HI_ULO
4978 -- : BFD_RELOC_M32R_GOT16_HI_SLO
4979 -- : BFD_RELOC_M32R_GOT16_LO
4980 -- : BFD_RELOC_M32R_GOTPC_HI_ULO
4981 -- : BFD_RELOC_M32R_GOTPC_HI_SLO
4982 -- : BFD_RELOC_M32R_GOTPC_LO
4983     For PIC.
4984 -- : BFD_RELOC_NDS32_20
4985     NDS32 relocs.  This is a 20 bit absolute address.
4986 -- : BFD_RELOC_NDS32_9_PCREL
4987     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4988     be 0.
4989 -- : BFD_RELOC_NDS32_WORD_9_PCREL
4990     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4991     be 0.
4992 -- : BFD_RELOC_NDS32_15_PCREL
4993     This is an 15-bit reloc with the right 1 bit assumed to be 0.
4994 -- : BFD_RELOC_NDS32_17_PCREL
4995     This is an 17-bit reloc with the right 1 bit assumed to be 0.
4996 -- : BFD_RELOC_NDS32_25_PCREL
4997     This is a 25-bit reloc with the right 1 bit assumed to be 0.
4998 -- : BFD_RELOC_NDS32_HI20
4999     This is a 20-bit reloc containing the high 20 bits of an address
5000     used with the lower 12 bits
5001 -- : BFD_RELOC_NDS32_LO12S3
5002     This is a 12-bit reloc containing the lower 12 bits of an address
5003     then shift right by 3.  This is used with ldi,sdi...
5004 -- : BFD_RELOC_NDS32_LO12S2
5005     This is a 12-bit reloc containing the lower 12 bits of an address
5006     then shift left by 2.  This is used with lwi,swi...
5007 -- : BFD_RELOC_NDS32_LO12S1
5008     This is a 12-bit reloc containing the lower 12 bits of an address
5009     then shift left by 1.  This is used with lhi,shi...
5010 -- : BFD_RELOC_NDS32_LO12S0
5011     This is a 12-bit reloc containing the lower 12 bits of an address
5012     then shift left by 0.  This is used with lbisbi...
5013 -- : BFD_RELOC_NDS32_LO12S0_ORI
5014     This is a 12-bit reloc containing the lower 12 bits of an address
5015     then shift left by 0.  This is only used with branch relaxations
5016 -- : BFD_RELOC_NDS32_SDA15S3
5017     This is a 15-bit reloc containing the small data area 18-bit signed
5018     offset and shift left by 3 for use in ldi, sdi...
5019 -- : BFD_RELOC_NDS32_SDA15S2
5020     This is a 15-bit reloc containing the small data area 17-bit signed
5021     offset and shift left by 2 for use in lwi, swi...
5022 -- : BFD_RELOC_NDS32_SDA15S1
5023     This is a 15-bit reloc containing the small data area 16-bit signed
5024     offset and shift left by 1 for use in lhi, shi...
5025 -- : BFD_RELOC_NDS32_SDA15S0
5026     This is a 15-bit reloc containing the small data area 15-bit signed
5027     offset and shift left by 0 for use in lbi, sbi...
5028 -- : BFD_RELOC_NDS32_SDA16S3
5029     This is a 16-bit reloc containing the small data area 16-bit signed
5030     offset and shift left by 3
5031 -- : BFD_RELOC_NDS32_SDA17S2
5032     This is a 17-bit reloc containing the small data area 17-bit signed
5033     offset and shift left by 2 for use in lwi.gp, swi.gp...
5034 -- : BFD_RELOC_NDS32_SDA18S1
5035     This is a 18-bit reloc containing the small data area 18-bit signed
5036     offset and shift left by 1 for use in lhi.gp, shi.gp...
5037 -- : BFD_RELOC_NDS32_SDA19S0
5038     This is a 19-bit reloc containing the small data area 19-bit signed
5039     offset and shift left by 0 for use in lbi.gp, sbi.gp...
5040 -- : BFD_RELOC_NDS32_GOT20
5041 -- : BFD_RELOC_NDS32_9_PLTREL
5042 -- : BFD_RELOC_NDS32_25_PLTREL
5043 -- : BFD_RELOC_NDS32_COPY
5044 -- : BFD_RELOC_NDS32_GLOB_DAT
5045 -- : BFD_RELOC_NDS32_JMP_SLOT
5046 -- : BFD_RELOC_NDS32_RELATIVE
5047 -- : BFD_RELOC_NDS32_GOTOFF
5048 -- : BFD_RELOC_NDS32_GOTOFF_HI20
5049 -- : BFD_RELOC_NDS32_GOTOFF_LO12
5050 -- : BFD_RELOC_NDS32_GOTPC20
5051 -- : BFD_RELOC_NDS32_GOT_HI20
5052 -- : BFD_RELOC_NDS32_GOT_LO12
5053 -- : BFD_RELOC_NDS32_GOTPC_HI20
5054 -- : BFD_RELOC_NDS32_GOTPC_LO12
5055     for PIC
5056 -- : BFD_RELOC_NDS32_INSN16
5057 -- : BFD_RELOC_NDS32_LABEL
5058 -- : BFD_RELOC_NDS32_LONGCALL1
5059 -- : BFD_RELOC_NDS32_LONGCALL2
5060 -- : BFD_RELOC_NDS32_LONGCALL3
5061 -- : BFD_RELOC_NDS32_LONGJUMP1
5062 -- : BFD_RELOC_NDS32_LONGJUMP2
5063 -- : BFD_RELOC_NDS32_LONGJUMP3
5064 -- : BFD_RELOC_NDS32_LOADSTORE
5065 -- : BFD_RELOC_NDS32_9_FIXED
5066 -- : BFD_RELOC_NDS32_15_FIXED
5067 -- : BFD_RELOC_NDS32_17_FIXED
5068 -- : BFD_RELOC_NDS32_25_FIXED
5069 -- : BFD_RELOC_NDS32_LONGCALL4
5070 -- : BFD_RELOC_NDS32_LONGCALL5
5071 -- : BFD_RELOC_NDS32_LONGCALL6
5072 -- : BFD_RELOC_NDS32_LONGJUMP4
5073 -- : BFD_RELOC_NDS32_LONGJUMP5
5074 -- : BFD_RELOC_NDS32_LONGJUMP6
5075 -- : BFD_RELOC_NDS32_LONGJUMP7
5076     for relax
5077 -- : BFD_RELOC_NDS32_PLTREL_HI20
5078 -- : BFD_RELOC_NDS32_PLTREL_LO12
5079 -- : BFD_RELOC_NDS32_PLT_GOTREL_HI20
5080 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO12
5081     for PIC
5082 -- : BFD_RELOC_NDS32_SDA12S2_DP
5083 -- : BFD_RELOC_NDS32_SDA12S2_SP
5084 -- : BFD_RELOC_NDS32_LO12S2_DP
5085 -- : BFD_RELOC_NDS32_LO12S2_SP
5086     for floating point
5087 -- : BFD_RELOC_NDS32_DWARF2_OP1
5088 -- : BFD_RELOC_NDS32_DWARF2_OP2
5089 -- : BFD_RELOC_NDS32_DWARF2_LEB
5090     for dwarf2 debug_line.
5091 -- : BFD_RELOC_NDS32_UPDATE_TA
5092     for eliminate 16-bit instructions
5093 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO20
5094 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO15
5095 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO19
5096 -- : BFD_RELOC_NDS32_GOT_LO15
5097 -- : BFD_RELOC_NDS32_GOT_LO19
5098 -- : BFD_RELOC_NDS32_GOTOFF_LO15
5099 -- : BFD_RELOC_NDS32_GOTOFF_LO19
5100 -- : BFD_RELOC_NDS32_GOT15S2
5101 -- : BFD_RELOC_NDS32_GOT17S2
5102     for PIC object relaxation
5103 -- : BFD_RELOC_NDS32_5
5104     NDS32 relocs.  This is a 5 bit absolute address.
5105 -- : BFD_RELOC_NDS32_10_UPCREL
5106     This is a 10-bit unsigned pc-relative reloc with the right 1 bit
5107     assumed to be 0.
5108 -- : BFD_RELOC_NDS32_SDA_FP7U2_RELA
5109     If fp were omitted, fp can used as another gp.
5110 -- : BFD_RELOC_NDS32_RELAX_ENTRY
5111 -- : BFD_RELOC_NDS32_GOT_SUFF
5112 -- : BFD_RELOC_NDS32_GOTOFF_SUFF
5113 -- : BFD_RELOC_NDS32_PLT_GOT_SUFF
5114 -- : BFD_RELOC_NDS32_MULCALL_SUFF
5115 -- : BFD_RELOC_NDS32_PTR
5116 -- : BFD_RELOC_NDS32_PTR_COUNT
5117 -- : BFD_RELOC_NDS32_PTR_RESOLVED
5118 -- : BFD_RELOC_NDS32_PLTBLOCK
5119 -- : BFD_RELOC_NDS32_RELAX_REGION_BEGIN
5120 -- : BFD_RELOC_NDS32_RELAX_REGION_END
5121 -- : BFD_RELOC_NDS32_MINUEND
5122 -- : BFD_RELOC_NDS32_SUBTRAHEND
5123 -- : BFD_RELOC_NDS32_DIFF8
5124 -- : BFD_RELOC_NDS32_DIFF16
5125 -- : BFD_RELOC_NDS32_DIFF32
5126 -- : BFD_RELOC_NDS32_DIFF_ULEB128
5127 -- : BFD_RELOC_NDS32_EMPTY
5128     relaxation relative relocation types
5129 -- : BFD_RELOC_NDS32_25_ABS
5130     This is a 25 bit absolute address.
5131 -- : BFD_RELOC_NDS32_DATA
5132 -- : BFD_RELOC_NDS32_TRAN
5133 -- : BFD_RELOC_NDS32_17IFC_PCREL
5134 -- : BFD_RELOC_NDS32_10IFCU_PCREL
5135     For ex9 and ifc using.
5136 -- : BFD_RELOC_NDS32_TPOFF
5137 -- : BFD_RELOC_NDS32_GOTTPOFF
5138 -- : BFD_RELOC_NDS32_TLS_LE_HI20
5139 -- : BFD_RELOC_NDS32_TLS_LE_LO12
5140 -- : BFD_RELOC_NDS32_TLS_LE_20
5141 -- : BFD_RELOC_NDS32_TLS_LE_15S0
5142 -- : BFD_RELOC_NDS32_TLS_LE_15S1
5143 -- : BFD_RELOC_NDS32_TLS_LE_15S2
5144 -- : BFD_RELOC_NDS32_TLS_LE_ADD
5145 -- : BFD_RELOC_NDS32_TLS_LE_LS
5146 -- : BFD_RELOC_NDS32_TLS_IE_HI20
5147 -- : BFD_RELOC_NDS32_TLS_IE_LO12
5148 -- : BFD_RELOC_NDS32_TLS_IE_LO12S2
5149 -- : BFD_RELOC_NDS32_TLS_IEGP_HI20
5150 -- : BFD_RELOC_NDS32_TLS_IEGP_LO12
5151 -- : BFD_RELOC_NDS32_TLS_IEGP_LO12S2
5152 -- : BFD_RELOC_NDS32_TLS_IEGP_LW
5153 -- : BFD_RELOC_NDS32_TLS_DESC
5154 -- : BFD_RELOC_NDS32_TLS_DESC_HI20
5155 -- : BFD_RELOC_NDS32_TLS_DESC_LO12
5156 -- : BFD_RELOC_NDS32_TLS_DESC_20
5157 -- : BFD_RELOC_NDS32_TLS_DESC_SDA17S2
5158 -- : BFD_RELOC_NDS32_TLS_DESC_ADD
5159 -- : BFD_RELOC_NDS32_TLS_DESC_FUNC
5160 -- : BFD_RELOC_NDS32_TLS_DESC_CALL
5161 -- : BFD_RELOC_NDS32_TLS_DESC_MEM
5162 -- : BFD_RELOC_NDS32_REMOVE
5163 -- : BFD_RELOC_NDS32_GROUP
5164     For TLS.
5165 -- : BFD_RELOC_NDS32_LSI
5166     For floating load store relaxation.
5167 -- : BFD_RELOC_V850_9_PCREL
5168     This is a 9-bit reloc
5169 -- : BFD_RELOC_V850_22_PCREL
5170     This is a 22-bit reloc
5171 -- : BFD_RELOC_V850_SDA_16_16_OFFSET
5172     This is a 16 bit offset from the short data area pointer.
5173 -- : BFD_RELOC_V850_SDA_15_16_OFFSET
5174     This is a 16 bit offset (of which only 15 bits are used) from the
5175     short data area pointer.
5176 -- : BFD_RELOC_V850_ZDA_16_16_OFFSET
5177     This is a 16 bit offset from the zero data area pointer.
5178 -- : BFD_RELOC_V850_ZDA_15_16_OFFSET
5179     This is a 16 bit offset (of which only 15 bits are used) from the
5180     zero data area pointer.
5181 -- : BFD_RELOC_V850_TDA_6_8_OFFSET
5182     This is an 8 bit offset (of which only 6 bits are used) from the
5183     tiny data area pointer.
5184 -- : BFD_RELOC_V850_TDA_7_8_OFFSET
5185     This is an 8bit offset (of which only 7 bits are used) from the
5186     tiny data area pointer.
5187 -- : BFD_RELOC_V850_TDA_7_7_OFFSET
5188     This is a 7 bit offset from the tiny data area pointer.
5189 -- : BFD_RELOC_V850_TDA_16_16_OFFSET
5190     This is a 16 bit offset from the tiny data area pointer.
5191 -- : BFD_RELOC_V850_TDA_4_5_OFFSET
5192     This is a 5 bit offset (of which only 4 bits are used) from the
5193     tiny data area pointer.
5194 -- : BFD_RELOC_V850_TDA_4_4_OFFSET
5195     This is a 4 bit offset from the tiny data area pointer.
5196 -- : BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
5197     This is a 16 bit offset from the short data area pointer, with the
5198     bits placed non-contiguously in the instruction.
5199 -- : BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
5200     This is a 16 bit offset from the zero data area pointer, with the
5201     bits placed non-contiguously in the instruction.
5202 -- : BFD_RELOC_V850_CALLT_6_7_OFFSET
5203     This is a 6 bit offset from the call table base pointer.
5204 -- : BFD_RELOC_V850_CALLT_16_16_OFFSET
5205     This is a 16 bit offset from the call table base pointer.
5206 -- : BFD_RELOC_V850_LONGCALL
5207     Used for relaxing indirect function calls.
5208 -- : BFD_RELOC_V850_LONGJUMP
5209     Used for relaxing indirect jumps.
5210 -- : BFD_RELOC_V850_ALIGN
5211     Used to maintain alignment whilst relaxing.
5212 -- : BFD_RELOC_V850_LO16_SPLIT_OFFSET
5213     This is a variation of BFD_RELOC_LO16 that can be used in v850e
5214     ld.bu instructions.
5215 -- : BFD_RELOC_V850_16_PCREL
5216     This is a 16-bit reloc.
5217 -- : BFD_RELOC_V850_17_PCREL
5218     This is a 17-bit reloc.
5219 -- : BFD_RELOC_V850_23
5220     This is a 23-bit reloc.
5221 -- : BFD_RELOC_V850_32_PCREL
5222     This is a 32-bit reloc.
5223 -- : BFD_RELOC_V850_32_ABS
5224     This is a 32-bit reloc.
5225 -- : BFD_RELOC_V850_16_SPLIT_OFFSET
5226     This is a 16-bit reloc.
5227 -- : BFD_RELOC_V850_16_S1
5228     This is a 16-bit reloc.
5229 -- : BFD_RELOC_V850_LO16_S1
5230     Low 16 bits.  16 bit shifted by 1.
5231 -- : BFD_RELOC_V850_CALLT_15_16_OFFSET
5232     This is a 16 bit offset from the call table base pointer.
5233 -- : BFD_RELOC_V850_32_GOTPCREL
5234     DSO relocations.
5235 -- : BFD_RELOC_V850_16_GOT
5236     DSO relocations.
5237 -- : BFD_RELOC_V850_32_GOT
5238     DSO relocations.
5239 -- : BFD_RELOC_V850_22_PLT_PCREL
5240     DSO relocations.
5241 -- : BFD_RELOC_V850_32_PLT_PCREL
5242     DSO relocations.
5243 -- : BFD_RELOC_V850_COPY
5244     DSO relocations.
5245 -- : BFD_RELOC_V850_GLOB_DAT
5246     DSO relocations.
5247 -- : BFD_RELOC_V850_JMP_SLOT
5248     DSO relocations.
5249 -- : BFD_RELOC_V850_RELATIVE
5250     DSO relocations.
5251 -- : BFD_RELOC_V850_16_GOTOFF
5252     DSO relocations.
5253 -- : BFD_RELOC_V850_32_GOTOFF
5254     DSO relocations.
5255 -- : BFD_RELOC_V850_CODE
5256     start code.
5257 -- : BFD_RELOC_V850_DATA
5258     start data in text.
5259 -- : BFD_RELOC_TIC30_LDP
5260     This is a 8bit DP reloc for the tms320c30, where the most
5261     significant 8 bits of a 24 bit word are placed into the least
5262     significant 8 bits of the opcode.
5263 -- : BFD_RELOC_TIC54X_PARTLS7
5264     This is a 7bit reloc for the tms320c54x, where the least
5265     significant 7 bits of a 16 bit word are placed into the least
5266     significant 7 bits of the opcode.
5267 -- : BFD_RELOC_TIC54X_PARTMS9
5268     This is a 9bit DP reloc for the tms320c54x, where the most
5269     significant 9 bits of a 16 bit word are placed into the least
5270     significant 9 bits of the opcode.
5271 -- : BFD_RELOC_TIC54X_23
5272     This is an extended address 23-bit reloc for the tms320c54x.
5273 -- : BFD_RELOC_TIC54X_16_OF_23
5274     This is a 16-bit reloc for the tms320c54x, where the least
5275     significant 16 bits of a 23-bit extended address are placed into
5276     the opcode.
5277 -- : BFD_RELOC_TIC54X_MS7_OF_23
5278     This is a reloc for the tms320c54x, where the most significant 7
5279     bits of a 23-bit extended address are placed into the opcode.
5280 -- : BFD_RELOC_C6000_PCR_S21
5281 -- : BFD_RELOC_C6000_PCR_S12
5282 -- : BFD_RELOC_C6000_PCR_S10
5283 -- : BFD_RELOC_C6000_PCR_S7
5284 -- : BFD_RELOC_C6000_ABS_S16
5285 -- : BFD_RELOC_C6000_ABS_L16
5286 -- : BFD_RELOC_C6000_ABS_H16
5287 -- : BFD_RELOC_C6000_SBR_U15_B
5288 -- : BFD_RELOC_C6000_SBR_U15_H
5289 -- : BFD_RELOC_C6000_SBR_U15_W
5290 -- : BFD_RELOC_C6000_SBR_S16
5291 -- : BFD_RELOC_C6000_SBR_L16_B
5292 -- : BFD_RELOC_C6000_SBR_L16_H
5293 -- : BFD_RELOC_C6000_SBR_L16_W
5294 -- : BFD_RELOC_C6000_SBR_H16_B
5295 -- : BFD_RELOC_C6000_SBR_H16_H
5296 -- : BFD_RELOC_C6000_SBR_H16_W
5297 -- : BFD_RELOC_C6000_SBR_GOT_U15_W
5298 -- : BFD_RELOC_C6000_SBR_GOT_L16_W
5299 -- : BFD_RELOC_C6000_SBR_GOT_H16_W
5300 -- : BFD_RELOC_C6000_DSBT_INDEX
5301 -- : BFD_RELOC_C6000_PREL31
5302 -- : BFD_RELOC_C6000_COPY
5303 -- : BFD_RELOC_C6000_JUMP_SLOT
5304 -- : BFD_RELOC_C6000_EHTYPE
5305 -- : BFD_RELOC_C6000_PCR_H16
5306 -- : BFD_RELOC_C6000_PCR_L16
5307 -- : BFD_RELOC_C6000_ALIGN
5308 -- : BFD_RELOC_C6000_FPHEAD
5309 -- : BFD_RELOC_C6000_NOCMP
5310     TMS320C6000 relocations.
5311 -- : BFD_RELOC_FR30_48
5312     This is a 48 bit reloc for the FR30 that stores 32 bits.
5313 -- : BFD_RELOC_FR30_20
5314     This is a 32 bit reloc for the FR30 that stores 20 bits split up
5315     into two sections.
5316 -- : BFD_RELOC_FR30_6_IN_4
5317     This is a 16 bit reloc for the FR30 that stores a 6 bit word offset
5318     in 4 bits.
5319 -- : BFD_RELOC_FR30_8_IN_8
5320     This is a 16 bit reloc for the FR30 that stores an 8 bit byte
5321     offset into 8 bits.
5322 -- : BFD_RELOC_FR30_9_IN_8
5323     This is a 16 bit reloc for the FR30 that stores a 9 bit short
5324     offset into 8 bits.
5325 -- : BFD_RELOC_FR30_10_IN_8
5326     This is a 16 bit reloc for the FR30 that stores a 10 bit word
5327     offset into 8 bits.
5328 -- : BFD_RELOC_FR30_9_PCREL
5329     This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
5330     short offset into 8 bits.
5331 -- : BFD_RELOC_FR30_12_PCREL
5332     This is a 16 bit reloc for the FR30 that stores a 12 bit pc
5333     relative short offset into 11 bits.
5334 -- : BFD_RELOC_MCORE_PCREL_IMM8BY4
5335 -- : BFD_RELOC_MCORE_PCREL_IMM11BY2
5336 -- : BFD_RELOC_MCORE_PCREL_IMM4BY2
5337 -- : BFD_RELOC_MCORE_PCREL_32
5338 -- : BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
5339 -- : BFD_RELOC_MCORE_RVA
5340     Motorola Mcore relocations.
5341 -- : BFD_RELOC_MEP_8
5342 -- : BFD_RELOC_MEP_16
5343 -- : BFD_RELOC_MEP_32
5344 -- : BFD_RELOC_MEP_PCREL8A2
5345 -- : BFD_RELOC_MEP_PCREL12A2
5346 -- : BFD_RELOC_MEP_PCREL17A2
5347 -- : BFD_RELOC_MEP_PCREL24A2
5348 -- : BFD_RELOC_MEP_PCABS24A2
5349 -- : BFD_RELOC_MEP_LOW16
5350 -- : BFD_RELOC_MEP_HI16U
5351 -- : BFD_RELOC_MEP_HI16S
5352 -- : BFD_RELOC_MEP_GPREL
5353 -- : BFD_RELOC_MEP_TPREL
5354 -- : BFD_RELOC_MEP_TPREL7
5355 -- : BFD_RELOC_MEP_TPREL7A2
5356 -- : BFD_RELOC_MEP_TPREL7A4
5357 -- : BFD_RELOC_MEP_UIMM24
5358 -- : BFD_RELOC_MEP_ADDR24A4
5359 -- : BFD_RELOC_MEP_GNU_VTINHERIT
5360 -- : BFD_RELOC_MEP_GNU_VTENTRY
5361     Toshiba Media Processor Relocations.
5362 -- : BFD_RELOC_METAG_HIADDR16
5363 -- : BFD_RELOC_METAG_LOADDR16
5364 -- : BFD_RELOC_METAG_RELBRANCH
5365 -- : BFD_RELOC_METAG_GETSETOFF
5366 -- : BFD_RELOC_METAG_HIOG
5367 -- : BFD_RELOC_METAG_LOOG
5368 -- : BFD_RELOC_METAG_REL8
5369 -- : BFD_RELOC_METAG_REL16
5370 -- : BFD_RELOC_METAG_HI16_GOTOFF
5371 -- : BFD_RELOC_METAG_LO16_GOTOFF
5372 -- : BFD_RELOC_METAG_GETSET_GOTOFF
5373 -- : BFD_RELOC_METAG_GETSET_GOT
5374 -- : BFD_RELOC_METAG_HI16_GOTPC
5375 -- : BFD_RELOC_METAG_LO16_GOTPC
5376 -- : BFD_RELOC_METAG_HI16_PLT
5377 -- : BFD_RELOC_METAG_LO16_PLT
5378 -- : BFD_RELOC_METAG_RELBRANCH_PLT
5379 -- : BFD_RELOC_METAG_GOTOFF
5380 -- : BFD_RELOC_METAG_PLT
5381 -- : BFD_RELOC_METAG_COPY
5382 -- : BFD_RELOC_METAG_JMP_SLOT
5383 -- : BFD_RELOC_METAG_RELATIVE
5384 -- : BFD_RELOC_METAG_GLOB_DAT
5385 -- : BFD_RELOC_METAG_TLS_GD
5386 -- : BFD_RELOC_METAG_TLS_LDM
5387 -- : BFD_RELOC_METAG_TLS_LDO_HI16
5388 -- : BFD_RELOC_METAG_TLS_LDO_LO16
5389 -- : BFD_RELOC_METAG_TLS_LDO
5390 -- : BFD_RELOC_METAG_TLS_IE
5391 -- : BFD_RELOC_METAG_TLS_IENONPIC
5392 -- : BFD_RELOC_METAG_TLS_IENONPIC_HI16
5393 -- : BFD_RELOC_METAG_TLS_IENONPIC_LO16
5394 -- : BFD_RELOC_METAG_TLS_TPOFF
5395 -- : BFD_RELOC_METAG_TLS_DTPMOD
5396 -- : BFD_RELOC_METAG_TLS_DTPOFF
5397 -- : BFD_RELOC_METAG_TLS_LE
5398 -- : BFD_RELOC_METAG_TLS_LE_HI16
5399 -- : BFD_RELOC_METAG_TLS_LE_LO16
5400     Imagination Technologies Meta relocations.
5401 -- : BFD_RELOC_MMIX_GETA
5402 -- : BFD_RELOC_MMIX_GETA_1
5403 -- : BFD_RELOC_MMIX_GETA_2
5404 -- : BFD_RELOC_MMIX_GETA_3
5405     These are relocations for the GETA instruction.
5406 -- : BFD_RELOC_MMIX_CBRANCH
5407 -- : BFD_RELOC_MMIX_CBRANCH_J
5408 -- : BFD_RELOC_MMIX_CBRANCH_1
5409 -- : BFD_RELOC_MMIX_CBRANCH_2
5410 -- : BFD_RELOC_MMIX_CBRANCH_3
5411     These are relocations for a conditional branch instruction.
5412 -- : BFD_RELOC_MMIX_PUSHJ
5413 -- : BFD_RELOC_MMIX_PUSHJ_1
5414 -- : BFD_RELOC_MMIX_PUSHJ_2
5415 -- : BFD_RELOC_MMIX_PUSHJ_3
5416 -- : BFD_RELOC_MMIX_PUSHJ_STUBBABLE
5417     These are relocations for the PUSHJ instruction.
5418 -- : BFD_RELOC_MMIX_JMP
5419 -- : BFD_RELOC_MMIX_JMP_1
5420 -- : BFD_RELOC_MMIX_JMP_2
5421 -- : BFD_RELOC_MMIX_JMP_3
5422     These are relocations for the JMP instruction.
5423 -- : BFD_RELOC_MMIX_ADDR19
5424     This is a relocation for a relative address as in a GETA
5425     instruction or a branch.
5426 -- : BFD_RELOC_MMIX_ADDR27
5427     This is a relocation for a relative address as in a JMP
5428     instruction.
5429 -- : BFD_RELOC_MMIX_REG_OR_BYTE
5430     This is a relocation for an instruction field that may be a general
5431     register or a value 0..255.
5432 -- : BFD_RELOC_MMIX_REG
5433     This is a relocation for an instruction field that may be a general
5434     register.
5435 -- : BFD_RELOC_MMIX_BASE_PLUS_OFFSET
5436     This is a relocation for two instruction fields holding a register
5437     and an offset, the equivalent of the relocation.
5438 -- : BFD_RELOC_MMIX_LOCAL
5439     This relocation is an assertion that the expression is not
5440     allocated as a global register.  It does not modify contents.
5441 -- : BFD_RELOC_AVR_7_PCREL
5442     This is a 16 bit reloc for the AVR that stores 8 bit pc relative
5443     short offset into 7 bits.
5444 -- : BFD_RELOC_AVR_13_PCREL
5445     This is a 16 bit reloc for the AVR that stores 13 bit pc relative
5446     short offset into 12 bits.
5447 -- : BFD_RELOC_AVR_16_PM
5448     This is a 16 bit reloc for the AVR that stores 17 bit value
5449     (usually program memory address) into 16 bits.
5450 -- : BFD_RELOC_AVR_LO8_LDI
5451     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5452     data memory address) into 8 bit immediate value of LDI insn.
5453 -- : BFD_RELOC_AVR_HI8_LDI
5454     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5455     bit of data memory address) into 8 bit immediate value of LDI insn.
5456 -- : BFD_RELOC_AVR_HH8_LDI
5457     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5458     high 8 bit of program memory address) into 8 bit immediate value of
5459     LDI insn.
5460 -- : BFD_RELOC_AVR_MS8_LDI
5461     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5462     high 8 bit of 32 bit value) into 8 bit immediate value of LDI insn.
5463 -- : BFD_RELOC_AVR_LO8_LDI_NEG
5464     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5465     (usually data memory address) into 8 bit immediate value of SUBI
5466     insn.
5467 -- : BFD_RELOC_AVR_HI8_LDI_NEG
5468     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5469     (high 8 bit of data memory address) into 8 bit immediate value of
5470     SUBI insn.
5471 -- : BFD_RELOC_AVR_HH8_LDI_NEG
5472     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5473     (most high 8 bit of program memory address) into 8 bit immediate
5474     value of LDI or SUBI insn.
5475 -- : BFD_RELOC_AVR_MS8_LDI_NEG
5476     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5477     (msb of 32 bit value) into 8 bit immediate value of LDI insn.
5478 -- : BFD_RELOC_AVR_LO8_LDI_PM
5479     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5480     command address) into 8 bit immediate value of LDI insn.
5481 -- : BFD_RELOC_AVR_LO8_LDI_GS
5482     This is a 16 bit reloc for the AVR that stores 8 bit value (command
5483     address) into 8 bit immediate value of LDI insn.  If the address is
5484     beyond the 128k boundary, the linker inserts a jump stub for this
5485     reloc in the lower 128k.
5486 -- : BFD_RELOC_AVR_HI8_LDI_PM
5487     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5488     bit of command address) into 8 bit immediate value of LDI insn.
5489 -- : BFD_RELOC_AVR_HI8_LDI_GS
5490     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5491     bit of command address) into 8 bit immediate value of LDI insn.  If
5492     the address is beyond the 128k boundary, the linker inserts a jump
5493     stub for this reloc below 128k.
5494 -- : BFD_RELOC_AVR_HH8_LDI_PM
5495     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5496     high 8 bit of command address) into 8 bit immediate value of LDI
5497     insn.
5498 -- : BFD_RELOC_AVR_LO8_LDI_PM_NEG
5499     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5500     (usually command address) into 8 bit immediate value of SUBI insn.
5501 -- : BFD_RELOC_AVR_HI8_LDI_PM_NEG
5502     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5503     (high 8 bit of 16 bit command address) into 8 bit immediate value
5504     of SUBI insn.
5505 -- : BFD_RELOC_AVR_HH8_LDI_PM_NEG
5506     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5507     (high 6 bit of 22 bit command address) into 8 bit immediate value
5508     of SUBI insn.
5509 -- : BFD_RELOC_AVR_CALL
5510     This is a 32 bit reloc for the AVR that stores 23 bit value into 22
5511     bits.
5512 -- : BFD_RELOC_AVR_LDI
5513     This is a 16 bit reloc for the AVR that stores all needed bits for
5514     absolute addressing with ldi with overflow check to linktime
5515 -- : BFD_RELOC_AVR_6
5516     This is a 6 bit reloc for the AVR that stores offset for ldd/std
5517     instructions
5518 -- : BFD_RELOC_AVR_6_ADIW
5519     This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
5520     instructions
5521 -- : BFD_RELOC_AVR_8_LO
5522     This is a 8 bit reloc for the AVR that stores bits 0..7 of a symbol
5523     in .byte lo8(symbol)
5524 -- : BFD_RELOC_AVR_8_HI
5525     This is a 8 bit reloc for the AVR that stores bits 8..15 of a
5526     symbol in .byte hi8(symbol)
5527 -- : BFD_RELOC_AVR_8_HLO
5528     This is a 8 bit reloc for the AVR that stores bits 16..23 of a
5529     symbol in .byte hlo8(symbol)
5530 -- : BFD_RELOC_AVR_DIFF8
5531 -- : BFD_RELOC_AVR_DIFF16
5532 -- : BFD_RELOC_AVR_DIFF32
5533     AVR relocations to mark the difference of two local symbols.  These
5534     are only needed to support linker relaxation and can be ignored
5535     when not relaxing.  The field is set to the value of the difference
5536     assuming no relaxation.  The relocation encodes the position of the
5537     second symbol so the linker can determine whether to adjust the
5538     field value.
5539 -- : BFD_RELOC_AVR_LDS_STS_16
5540     This is a 7 bit reloc for the AVR that stores SRAM address for
5541     16bit lds and sts instructions supported only tiny core.
5542 -- : BFD_RELOC_AVR_PORT6
5543     This is a 6 bit reloc for the AVR that stores an I/O register
5544     number for the IN and OUT instructions
5545 -- : BFD_RELOC_AVR_PORT5
5546     This is a 5 bit reloc for the AVR that stores an I/O register
5547     number for the SBIC, SBIS, SBI and CBI instructions
5548 -- : BFD_RELOC_RISCV_HI20
5549 -- : BFD_RELOC_RISCV_PCREL_HI20
5550 -- : BFD_RELOC_RISCV_PCREL_LO12_I
5551 -- : BFD_RELOC_RISCV_PCREL_LO12_S
5552 -- : BFD_RELOC_RISCV_LO12_I
5553 -- : BFD_RELOC_RISCV_LO12_S
5554 -- : BFD_RELOC_RISCV_GPREL12_I
5555 -- : BFD_RELOC_RISCV_GPREL12_S
5556 -- : BFD_RELOC_RISCV_TPREL_HI20
5557 -- : BFD_RELOC_RISCV_TPREL_LO12_I
5558 -- : BFD_RELOC_RISCV_TPREL_LO12_S
5559 -- : BFD_RELOC_RISCV_TPREL_ADD
5560 -- : BFD_RELOC_RISCV_CALL
5561 -- : BFD_RELOC_RISCV_CALL_PLT
5562 -- : BFD_RELOC_RISCV_ADD8
5563 -- : BFD_RELOC_RISCV_ADD16
5564 -- : BFD_RELOC_RISCV_ADD32
5565 -- : BFD_RELOC_RISCV_ADD64
5566 -- : BFD_RELOC_RISCV_SUB8
5567 -- : BFD_RELOC_RISCV_SUB16
5568 -- : BFD_RELOC_RISCV_SUB32
5569 -- : BFD_RELOC_RISCV_SUB64
5570 -- : BFD_RELOC_RISCV_GOT_HI20
5571 -- : BFD_RELOC_RISCV_TLS_GOT_HI20
5572 -- : BFD_RELOC_RISCV_TLS_GD_HI20
5573 -- : BFD_RELOC_RISCV_JMP
5574 -- : BFD_RELOC_RISCV_TLS_DTPMOD32
5575 -- : BFD_RELOC_RISCV_TLS_DTPREL32
5576 -- : BFD_RELOC_RISCV_TLS_DTPMOD64
5577 -- : BFD_RELOC_RISCV_TLS_DTPREL64
5578 -- : BFD_RELOC_RISCV_TLS_TPREL32
5579 -- : BFD_RELOC_RISCV_TLS_TPREL64
5580 -- : BFD_RELOC_RISCV_ALIGN
5581 -- : BFD_RELOC_RISCV_RVC_BRANCH
5582 -- : BFD_RELOC_RISCV_RVC_JUMP
5583 -- : BFD_RELOC_RISCV_RVC_LUI
5584 -- : BFD_RELOC_RISCV_GPREL_I
5585 -- : BFD_RELOC_RISCV_GPREL_S
5586 -- : BFD_RELOC_RISCV_TPREL_I
5587 -- : BFD_RELOC_RISCV_TPREL_S
5588 -- : BFD_RELOC_RISCV_RELAX
5589 -- : BFD_RELOC_RISCV_CFA
5590 -- : BFD_RELOC_RISCV_SUB6
5591 -- : BFD_RELOC_RISCV_SET6
5592 -- : BFD_RELOC_RISCV_SET8
5593 -- : BFD_RELOC_RISCV_SET16
5594 -- : BFD_RELOC_RISCV_SET32
5595 -- : BFD_RELOC_RISCV_32_PCREL
5596     RISC-V relocations.
5597 -- : BFD_RELOC_RL78_NEG8
5598 -- : BFD_RELOC_RL78_NEG16
5599 -- : BFD_RELOC_RL78_NEG24
5600 -- : BFD_RELOC_RL78_NEG32
5601 -- : BFD_RELOC_RL78_16_OP
5602 -- : BFD_RELOC_RL78_24_OP
5603 -- : BFD_RELOC_RL78_32_OP
5604 -- : BFD_RELOC_RL78_8U
5605 -- : BFD_RELOC_RL78_16U
5606 -- : BFD_RELOC_RL78_24U
5607 -- : BFD_RELOC_RL78_DIR3U_PCREL
5608 -- : BFD_RELOC_RL78_DIFF
5609 -- : BFD_RELOC_RL78_GPRELB
5610 -- : BFD_RELOC_RL78_GPRELW
5611 -- : BFD_RELOC_RL78_GPRELL
5612 -- : BFD_RELOC_RL78_SYM
5613 -- : BFD_RELOC_RL78_OP_SUBTRACT
5614 -- : BFD_RELOC_RL78_OP_NEG
5615 -- : BFD_RELOC_RL78_OP_AND
5616 -- : BFD_RELOC_RL78_OP_SHRA
5617 -- : BFD_RELOC_RL78_ABS8
5618 -- : BFD_RELOC_RL78_ABS16
5619 -- : BFD_RELOC_RL78_ABS16_REV
5620 -- : BFD_RELOC_RL78_ABS32
5621 -- : BFD_RELOC_RL78_ABS32_REV
5622 -- : BFD_RELOC_RL78_ABS16U
5623 -- : BFD_RELOC_RL78_ABS16UW
5624 -- : BFD_RELOC_RL78_ABS16UL
5625 -- : BFD_RELOC_RL78_RELAX
5626 -- : BFD_RELOC_RL78_HI16
5627 -- : BFD_RELOC_RL78_HI8
5628 -- : BFD_RELOC_RL78_LO16
5629 -- : BFD_RELOC_RL78_CODE
5630 -- : BFD_RELOC_RL78_SADDR
5631     Renesas RL78 Relocations.
5632 -- : BFD_RELOC_RX_NEG8
5633 -- : BFD_RELOC_RX_NEG16
5634 -- : BFD_RELOC_RX_NEG24
5635 -- : BFD_RELOC_RX_NEG32
5636 -- : BFD_RELOC_RX_16_OP
5637 -- : BFD_RELOC_RX_24_OP
5638 -- : BFD_RELOC_RX_32_OP
5639 -- : BFD_RELOC_RX_8U
5640 -- : BFD_RELOC_RX_16U
5641 -- : BFD_RELOC_RX_24U
5642 -- : BFD_RELOC_RX_DIR3U_PCREL
5643 -- : BFD_RELOC_RX_DIFF
5644 -- : BFD_RELOC_RX_GPRELB
5645 -- : BFD_RELOC_RX_GPRELW
5646 -- : BFD_RELOC_RX_GPRELL
5647 -- : BFD_RELOC_RX_SYM
5648 -- : BFD_RELOC_RX_OP_SUBTRACT
5649 -- : BFD_RELOC_RX_OP_NEG
5650 -- : BFD_RELOC_RX_ABS8
5651 -- : BFD_RELOC_RX_ABS16
5652 -- : BFD_RELOC_RX_ABS16_REV
5653 -- : BFD_RELOC_RX_ABS32
5654 -- : BFD_RELOC_RX_ABS32_REV
5655 -- : BFD_RELOC_RX_ABS16U
5656 -- : BFD_RELOC_RX_ABS16UW
5657 -- : BFD_RELOC_RX_ABS16UL
5658 -- : BFD_RELOC_RX_RELAX
5659     Renesas RX Relocations.
5660 -- : BFD_RELOC_390_12
5661     Direct 12 bit.
5662 -- : BFD_RELOC_390_GOT12
5663     12 bit GOT offset.
5664 -- : BFD_RELOC_390_PLT32
5665     32 bit PC relative PLT address.
5666 -- : BFD_RELOC_390_COPY
5667     Copy symbol at runtime.
5668 -- : BFD_RELOC_390_GLOB_DAT
5669     Create GOT entry.
5670 -- : BFD_RELOC_390_JMP_SLOT
5671     Create PLT entry.
5672 -- : BFD_RELOC_390_RELATIVE
5673     Adjust by program base.
5674 -- : BFD_RELOC_390_GOTPC
5675     32 bit PC relative offset to GOT.
5676 -- : BFD_RELOC_390_GOT16
5677     16 bit GOT offset.
5678 -- : BFD_RELOC_390_PC12DBL
5679     PC relative 12 bit shifted by 1.
5680 -- : BFD_RELOC_390_PLT12DBL
5681     12 bit PC rel.  PLT shifted by 1.
5682 -- : BFD_RELOC_390_PC16DBL
5683     PC relative 16 bit shifted by 1.
5684 -- : BFD_RELOC_390_PLT16DBL
5685     16 bit PC rel.  PLT shifted by 1.
5686 -- : BFD_RELOC_390_PC24DBL
5687     PC relative 24 bit shifted by 1.
5688 -- : BFD_RELOC_390_PLT24DBL
5689     24 bit PC rel.  PLT shifted by 1.
5690 -- : BFD_RELOC_390_PC32DBL
5691     PC relative 32 bit shifted by 1.
5692 -- : BFD_RELOC_390_PLT32DBL
5693     32 bit PC rel.  PLT shifted by 1.
5694 -- : BFD_RELOC_390_GOTPCDBL
5695     32 bit PC rel.  GOT shifted by 1.
5696 -- : BFD_RELOC_390_GOT64
5697     64 bit GOT offset.
5698 -- : BFD_RELOC_390_PLT64
5699     64 bit PC relative PLT address.
5700 -- : BFD_RELOC_390_GOTENT
5701     32 bit rel.  offset to GOT entry.
5702 -- : BFD_RELOC_390_GOTOFF64
5703     64 bit offset to GOT.
5704 -- : BFD_RELOC_390_GOTPLT12
5705     12-bit offset to symbol-entry within GOT, with PLT handling.
5706 -- : BFD_RELOC_390_GOTPLT16
5707     16-bit offset to symbol-entry within GOT, with PLT handling.
5708 -- : BFD_RELOC_390_GOTPLT32
5709     32-bit offset to symbol-entry within GOT, with PLT handling.
5710 -- : BFD_RELOC_390_GOTPLT64
5711     64-bit offset to symbol-entry within GOT, with PLT handling.
5712 -- : BFD_RELOC_390_GOTPLTENT
5713     32-bit rel.  offset to symbol-entry within GOT, with PLT handling.
5714 -- : BFD_RELOC_390_PLTOFF16
5715     16-bit rel.  offset from the GOT to a PLT entry.
5716 -- : BFD_RELOC_390_PLTOFF32
5717     32-bit rel.  offset from the GOT to a PLT entry.
5718 -- : BFD_RELOC_390_PLTOFF64
5719     64-bit rel.  offset from the GOT to a PLT entry.
5720 -- : BFD_RELOC_390_TLS_LOAD
5721 -- : BFD_RELOC_390_TLS_GDCALL
5722 -- : BFD_RELOC_390_TLS_LDCALL
5723 -- : BFD_RELOC_390_TLS_GD32
5724 -- : BFD_RELOC_390_TLS_GD64
5725 -- : BFD_RELOC_390_TLS_GOTIE12
5726 -- : BFD_RELOC_390_TLS_GOTIE32
5727 -- : BFD_RELOC_390_TLS_GOTIE64
5728 -- : BFD_RELOC_390_TLS_LDM32
5729 -- : BFD_RELOC_390_TLS_LDM64
5730 -- : BFD_RELOC_390_TLS_IE32
5731 -- : BFD_RELOC_390_TLS_IE64
5732 -- : BFD_RELOC_390_TLS_IEENT
5733 -- : BFD_RELOC_390_TLS_LE32
5734 -- : BFD_RELOC_390_TLS_LE64
5735 -- : BFD_RELOC_390_TLS_LDO32
5736 -- : BFD_RELOC_390_TLS_LDO64
5737 -- : BFD_RELOC_390_TLS_DTPMOD
5738 -- : BFD_RELOC_390_TLS_DTPOFF
5739 -- : BFD_RELOC_390_TLS_TPOFF
5740     s390 tls relocations.
5741 -- : BFD_RELOC_390_20
5742 -- : BFD_RELOC_390_GOT20
5743 -- : BFD_RELOC_390_GOTPLT20
5744 -- : BFD_RELOC_390_TLS_GOTIE20
5745     Long displacement extension.
5746 -- : BFD_RELOC_390_IRELATIVE
5747     STT_GNU_IFUNC relocation.
5748 -- : BFD_RELOC_SCORE_GPREL15
5749     Score relocations Low 16 bit for load/store
5750 -- : BFD_RELOC_SCORE_DUMMY2
5751 -- : BFD_RELOC_SCORE_JMP
5752     This is a 24-bit reloc with the right 1 bit assumed to be 0
5753 -- : BFD_RELOC_SCORE_BRANCH
5754     This is a 19-bit reloc with the right 1 bit assumed to be 0
5755 -- : BFD_RELOC_SCORE_IMM30
5756     This is a 32-bit reloc for 48-bit instructions.
5757 -- : BFD_RELOC_SCORE_IMM32
5758     This is a 32-bit reloc for 48-bit instructions.
5759 -- : BFD_RELOC_SCORE16_JMP
5760     This is a 11-bit reloc with the right 1 bit assumed to be 0
5761 -- : BFD_RELOC_SCORE16_BRANCH
5762     This is a 8-bit reloc with the right 1 bit assumed to be 0
5763 -- : BFD_RELOC_SCORE_BCMP
5764     This is a 9-bit reloc with the right 1 bit assumed to be 0
5765 -- : BFD_RELOC_SCORE_GOT15
5766 -- : BFD_RELOC_SCORE_GOT_LO16
5767 -- : BFD_RELOC_SCORE_CALL15
5768 -- : BFD_RELOC_SCORE_DUMMY_HI16
5769     Undocumented Score relocs
5770 -- : BFD_RELOC_IP2K_FR9
5771     Scenix IP2K - 9-bit register number / data address
5772 -- : BFD_RELOC_IP2K_BANK
5773     Scenix IP2K - 4-bit register/data bank number
5774 -- : BFD_RELOC_IP2K_ADDR16CJP
5775     Scenix IP2K - low 13 bits of instruction word address
5776 -- : BFD_RELOC_IP2K_PAGE3
5777     Scenix IP2K - high 3 bits of instruction word address
5778 -- : BFD_RELOC_IP2K_LO8DATA
5779 -- : BFD_RELOC_IP2K_HI8DATA
5780 -- : BFD_RELOC_IP2K_EX8DATA
5781     Scenix IP2K - ext/low/high 8 bits of data address
5782 -- : BFD_RELOC_IP2K_LO8INSN
5783 -- : BFD_RELOC_IP2K_HI8INSN
5784     Scenix IP2K - low/high 8 bits of instruction word address
5785 -- : BFD_RELOC_IP2K_PC_SKIP
5786     Scenix IP2K - even/odd PC modifier to modify snb pcl.0
5787 -- : BFD_RELOC_IP2K_TEXT
5788     Scenix IP2K - 16 bit word address in text section.
5789 -- : BFD_RELOC_IP2K_FR_OFFSET
5790     Scenix IP2K - 7-bit sp or dp offset
5791 -- : BFD_RELOC_VPE4KMATH_DATA
5792 -- : BFD_RELOC_VPE4KMATH_INSN
5793     Scenix VPE4K coprocessor - data/insn-space addressing
5794 -- : BFD_RELOC_VTABLE_INHERIT
5795 -- : BFD_RELOC_VTABLE_ENTRY
5796     These two relocations are used by the linker to determine which of
5797     the entries in a C++ virtual function table are actually used.
5798     When the -gc-sections option is given, the linker will zero out the
5799     entries that are not used, so that the code for those functions
5800     need not be included in the output.
5801
5802     VTABLE_INHERIT is a zero-space relocation used to describe to the
5803     linker the inheritance tree of a C++ virtual function table.  The
5804     relocation's symbol should be the parent class' vtable, and the
5805     relocation should be located at the child vtable.
5806
5807     VTABLE_ENTRY is a zero-space relocation that describes the use of a
5808     virtual function table entry.  The reloc's symbol should refer to
5809     the table of the class mentioned in the code.  Off of that base, an
5810     offset describes the entry that is being used.  For Rela hosts,
5811     this offset is stored in the reloc's addend.  For Rel hosts, we are
5812     forced to put this offset in the reloc's section offset.
5813 -- : BFD_RELOC_IA64_IMM14
5814 -- : BFD_RELOC_IA64_IMM22
5815 -- : BFD_RELOC_IA64_IMM64
5816 -- : BFD_RELOC_IA64_DIR32MSB
5817 -- : BFD_RELOC_IA64_DIR32LSB
5818 -- : BFD_RELOC_IA64_DIR64MSB
5819 -- : BFD_RELOC_IA64_DIR64LSB
5820 -- : BFD_RELOC_IA64_GPREL22
5821 -- : BFD_RELOC_IA64_GPREL64I
5822 -- : BFD_RELOC_IA64_GPREL32MSB
5823 -- : BFD_RELOC_IA64_GPREL32LSB
5824 -- : BFD_RELOC_IA64_GPREL64MSB
5825 -- : BFD_RELOC_IA64_GPREL64LSB
5826 -- : BFD_RELOC_IA64_LTOFF22
5827 -- : BFD_RELOC_IA64_LTOFF64I
5828 -- : BFD_RELOC_IA64_PLTOFF22
5829 -- : BFD_RELOC_IA64_PLTOFF64I
5830 -- : BFD_RELOC_IA64_PLTOFF64MSB
5831 -- : BFD_RELOC_IA64_PLTOFF64LSB
5832 -- : BFD_RELOC_IA64_FPTR64I
5833 -- : BFD_RELOC_IA64_FPTR32MSB
5834 -- : BFD_RELOC_IA64_FPTR32LSB
5835 -- : BFD_RELOC_IA64_FPTR64MSB
5836 -- : BFD_RELOC_IA64_FPTR64LSB
5837 -- : BFD_RELOC_IA64_PCREL21B
5838 -- : BFD_RELOC_IA64_PCREL21BI
5839 -- : BFD_RELOC_IA64_PCREL21M
5840 -- : BFD_RELOC_IA64_PCREL21F
5841 -- : BFD_RELOC_IA64_PCREL22
5842 -- : BFD_RELOC_IA64_PCREL60B
5843 -- : BFD_RELOC_IA64_PCREL64I
5844 -- : BFD_RELOC_IA64_PCREL32MSB
5845 -- : BFD_RELOC_IA64_PCREL32LSB
5846 -- : BFD_RELOC_IA64_PCREL64MSB
5847 -- : BFD_RELOC_IA64_PCREL64LSB
5848 -- : BFD_RELOC_IA64_LTOFF_FPTR22
5849 -- : BFD_RELOC_IA64_LTOFF_FPTR64I
5850 -- : BFD_RELOC_IA64_LTOFF_FPTR32MSB
5851 -- : BFD_RELOC_IA64_LTOFF_FPTR32LSB
5852 -- : BFD_RELOC_IA64_LTOFF_FPTR64MSB
5853 -- : BFD_RELOC_IA64_LTOFF_FPTR64LSB
5854 -- : BFD_RELOC_IA64_SEGREL32MSB
5855 -- : BFD_RELOC_IA64_SEGREL32LSB
5856 -- : BFD_RELOC_IA64_SEGREL64MSB
5857 -- : BFD_RELOC_IA64_SEGREL64LSB
5858 -- : BFD_RELOC_IA64_SECREL32MSB
5859 -- : BFD_RELOC_IA64_SECREL32LSB
5860 -- : BFD_RELOC_IA64_SECREL64MSB
5861 -- : BFD_RELOC_IA64_SECREL64LSB
5862 -- : BFD_RELOC_IA64_REL32MSB
5863 -- : BFD_RELOC_IA64_REL32LSB
5864 -- : BFD_RELOC_IA64_REL64MSB
5865 -- : BFD_RELOC_IA64_REL64LSB
5866 -- : BFD_RELOC_IA64_LTV32MSB
5867 -- : BFD_RELOC_IA64_LTV32LSB
5868 -- : BFD_RELOC_IA64_LTV64MSB
5869 -- : BFD_RELOC_IA64_LTV64LSB
5870 -- : BFD_RELOC_IA64_IPLTMSB
5871 -- : BFD_RELOC_IA64_IPLTLSB
5872 -- : BFD_RELOC_IA64_COPY
5873 -- : BFD_RELOC_IA64_LTOFF22X
5874 -- : BFD_RELOC_IA64_LDXMOV
5875 -- : BFD_RELOC_IA64_TPREL14
5876 -- : BFD_RELOC_IA64_TPREL22
5877 -- : BFD_RELOC_IA64_TPREL64I
5878 -- : BFD_RELOC_IA64_TPREL64MSB
5879 -- : BFD_RELOC_IA64_TPREL64LSB
5880 -- : BFD_RELOC_IA64_LTOFF_TPREL22
5881 -- : BFD_RELOC_IA64_DTPMOD64MSB
5882 -- : BFD_RELOC_IA64_DTPMOD64LSB
5883 -- : BFD_RELOC_IA64_LTOFF_DTPMOD22
5884 -- : BFD_RELOC_IA64_DTPREL14
5885 -- : BFD_RELOC_IA64_DTPREL22
5886 -- : BFD_RELOC_IA64_DTPREL64I
5887 -- : BFD_RELOC_IA64_DTPREL32MSB
5888 -- : BFD_RELOC_IA64_DTPREL32LSB
5889 -- : BFD_RELOC_IA64_DTPREL64MSB
5890 -- : BFD_RELOC_IA64_DTPREL64LSB
5891 -- : BFD_RELOC_IA64_LTOFF_DTPREL22
5892     Intel IA64 Relocations.
5893 -- : BFD_RELOC_M68HC11_HI8
5894     Motorola 68HC11 reloc.  This is the 8 bit high part of an absolute
5895     address.
5896 -- : BFD_RELOC_M68HC11_LO8
5897     Motorola 68HC11 reloc.  This is the 8 bit low part of an absolute
5898     address.
5899 -- : BFD_RELOC_M68HC11_3B
5900     Motorola 68HC11 reloc.  This is the 3 bit of a value.
5901 -- : BFD_RELOC_M68HC11_RL_JUMP
5902     Motorola 68HC11 reloc.  This reloc marks the beginning of a
5903     jump/call instruction.  It is used for linker relaxation to
5904     correctly identify beginning of instruction and change some
5905     branches to use PC-relative addressing mode.
5906 -- : BFD_RELOC_M68HC11_RL_GROUP
5907     Motorola 68HC11 reloc.  This reloc marks a group of several
5908     instructions that gcc generates and for which the linker relaxation
5909     pass can modify and/or remove some of them.
5910 -- : BFD_RELOC_M68HC11_LO16
5911     Motorola 68HC11 reloc.  This is the 16-bit lower part of an
5912     address.  It is used for 'call' instruction to specify the symbol
5913     address without any special transformation (due to memory bank
5914     window).
5915 -- : BFD_RELOC_M68HC11_PAGE
5916     Motorola 68HC11 reloc.  This is a 8-bit reloc that specifies the
5917     page number of an address.  It is used by 'call' instruction to
5918     specify the page number of the symbol.
5919 -- : BFD_RELOC_M68HC11_24
5920     Motorola 68HC11 reloc.  This is a 24-bit reloc that represents the
5921     address with a 16-bit value and a 8-bit page number.  The symbol
5922     address is transformed to follow the 16K memory bank of 68HC12
5923     (seen as mapped in the window).
5924 -- : BFD_RELOC_M68HC12_5B
5925     Motorola 68HC12 reloc.  This is the 5 bits of a value.
5926 -- : BFD_RELOC_XGATE_RL_JUMP
5927     Freescale XGATE reloc.  This reloc marks the beginning of a bra/jal
5928     instruction.
5929 -- : BFD_RELOC_XGATE_RL_GROUP
5930     Freescale XGATE reloc.  This reloc marks a group of several
5931     instructions that gcc generates and for which the linker relaxation
5932     pass can modify and/or remove some of them.
5933 -- : BFD_RELOC_XGATE_LO16
5934     Freescale XGATE reloc.  This is the 16-bit lower part of an
5935     address.  It is used for the '16-bit' instructions.
5936 -- : BFD_RELOC_XGATE_GPAGE
5937     Freescale XGATE reloc.
5938 -- : BFD_RELOC_XGATE_24
5939     Freescale XGATE reloc.
5940 -- : BFD_RELOC_XGATE_PCREL_9
5941     Freescale XGATE reloc.  This is a 9-bit pc-relative reloc.
5942 -- : BFD_RELOC_XGATE_PCREL_10
5943     Freescale XGATE reloc.  This is a 10-bit pc-relative reloc.
5944 -- : BFD_RELOC_XGATE_IMM8_LO
5945     Freescale XGATE reloc.  This is the 16-bit lower part of an
5946     address.  It is used for the '16-bit' instructions.
5947 -- : BFD_RELOC_XGATE_IMM8_HI
5948     Freescale XGATE reloc.  This is the 16-bit higher part of an
5949     address.  It is used for the '16-bit' instructions.
5950 -- : BFD_RELOC_XGATE_IMM3
5951     Freescale XGATE reloc.  This is a 3-bit pc-relative reloc.
5952 -- : BFD_RELOC_XGATE_IMM4
5953     Freescale XGATE reloc.  This is a 4-bit pc-relative reloc.
5954 -- : BFD_RELOC_XGATE_IMM5
5955     Freescale XGATE reloc.  This is a 5-bit pc-relative reloc.
5956 -- : BFD_RELOC_M68HC12_9B
5957     Motorola 68HC12 reloc.  This is the 9 bits of a value.
5958 -- : BFD_RELOC_M68HC12_16B
5959     Motorola 68HC12 reloc.  This is the 16 bits of a value.
5960 -- : BFD_RELOC_M68HC12_9_PCREL
5961     Motorola 68HC12/XGATE reloc.  This is a PCREL9 branch.
5962 -- : BFD_RELOC_M68HC12_10_PCREL
5963     Motorola 68HC12/XGATE reloc.  This is a PCREL10 branch.
5964 -- : BFD_RELOC_M68HC12_LO8XG
5965     Motorola 68HC12/XGATE reloc.  This is the 8 bit low part of an
5966     absolute address and immediately precedes a matching HI8XG part.
5967 -- : BFD_RELOC_M68HC12_HI8XG
5968     Motorola 68HC12/XGATE reloc.  This is the 8 bit high part of an
5969     absolute address and immediately follows a matching LO8XG part.
5970 -- : BFD_RELOC_S12Z_15_PCREL
5971     Freescale S12Z reloc.  This is a 15 bit relative address.  If the
5972     most significant bits are all zero then it may be truncated to 8
5973     bits.
5974 -- : BFD_RELOC_CR16_NUM8
5975 -- : BFD_RELOC_CR16_NUM16
5976 -- : BFD_RELOC_CR16_NUM32
5977 -- : BFD_RELOC_CR16_NUM32a
5978 -- : BFD_RELOC_CR16_REGREL0
5979 -- : BFD_RELOC_CR16_REGREL4
5980 -- : BFD_RELOC_CR16_REGREL4a
5981 -- : BFD_RELOC_CR16_REGREL14
5982 -- : BFD_RELOC_CR16_REGREL14a
5983 -- : BFD_RELOC_CR16_REGREL16
5984 -- : BFD_RELOC_CR16_REGREL20
5985 -- : BFD_RELOC_CR16_REGREL20a
5986 -- : BFD_RELOC_CR16_ABS20
5987 -- : BFD_RELOC_CR16_ABS24
5988 -- : BFD_RELOC_CR16_IMM4
5989 -- : BFD_RELOC_CR16_IMM8
5990 -- : BFD_RELOC_CR16_IMM16
5991 -- : BFD_RELOC_CR16_IMM20
5992 -- : BFD_RELOC_CR16_IMM24
5993 -- : BFD_RELOC_CR16_IMM32
5994 -- : BFD_RELOC_CR16_IMM32a
5995 -- : BFD_RELOC_CR16_DISP4
5996 -- : BFD_RELOC_CR16_DISP8
5997 -- : BFD_RELOC_CR16_DISP16
5998 -- : BFD_RELOC_CR16_DISP20
5999 -- : BFD_RELOC_CR16_DISP24
6000 -- : BFD_RELOC_CR16_DISP24a
6001 -- : BFD_RELOC_CR16_SWITCH8
6002 -- : BFD_RELOC_CR16_SWITCH16
6003 -- : BFD_RELOC_CR16_SWITCH32
6004 -- : BFD_RELOC_CR16_GOT_REGREL20
6005 -- : BFD_RELOC_CR16_GOTC_REGREL20
6006 -- : BFD_RELOC_CR16_GLOB_DAT
6007     NS CR16 Relocations.
6008 -- : BFD_RELOC_CRX_REL4
6009 -- : BFD_RELOC_CRX_REL8
6010 -- : BFD_RELOC_CRX_REL8_CMP
6011 -- : BFD_RELOC_CRX_REL16
6012 -- : BFD_RELOC_CRX_REL24
6013 -- : BFD_RELOC_CRX_REL32
6014 -- : BFD_RELOC_CRX_REGREL12
6015 -- : BFD_RELOC_CRX_REGREL22
6016 -- : BFD_RELOC_CRX_REGREL28
6017 -- : BFD_RELOC_CRX_REGREL32
6018 -- : BFD_RELOC_CRX_ABS16
6019 -- : BFD_RELOC_CRX_ABS32
6020 -- : BFD_RELOC_CRX_NUM8
6021 -- : BFD_RELOC_CRX_NUM16
6022 -- : BFD_RELOC_CRX_NUM32
6023 -- : BFD_RELOC_CRX_IMM16
6024 -- : BFD_RELOC_CRX_IMM32
6025 -- : BFD_RELOC_CRX_SWITCH8
6026 -- : BFD_RELOC_CRX_SWITCH16
6027 -- : BFD_RELOC_CRX_SWITCH32
6028     NS CRX Relocations.
6029 -- : BFD_RELOC_CRIS_BDISP8
6030 -- : BFD_RELOC_CRIS_UNSIGNED_5
6031 -- : BFD_RELOC_CRIS_SIGNED_6
6032 -- : BFD_RELOC_CRIS_UNSIGNED_6
6033 -- : BFD_RELOC_CRIS_SIGNED_8
6034 -- : BFD_RELOC_CRIS_UNSIGNED_8
6035 -- : BFD_RELOC_CRIS_SIGNED_16
6036 -- : BFD_RELOC_CRIS_UNSIGNED_16
6037 -- : BFD_RELOC_CRIS_LAPCQ_OFFSET
6038 -- : BFD_RELOC_CRIS_UNSIGNED_4
6039     These relocs are only used within the CRIS assembler.  They are not
6040     (at present) written to any object files.
6041 -- : BFD_RELOC_CRIS_COPY
6042 -- : BFD_RELOC_CRIS_GLOB_DAT
6043 -- : BFD_RELOC_CRIS_JUMP_SLOT
6044 -- : BFD_RELOC_CRIS_RELATIVE
6045     Relocs used in ELF shared libraries for CRIS.
6046 -- : BFD_RELOC_CRIS_32_GOT
6047     32-bit offset to symbol-entry within GOT.
6048 -- : BFD_RELOC_CRIS_16_GOT
6049     16-bit offset to symbol-entry within GOT.
6050 -- : BFD_RELOC_CRIS_32_GOTPLT
6051     32-bit offset to symbol-entry within GOT, with PLT handling.
6052 -- : BFD_RELOC_CRIS_16_GOTPLT
6053     16-bit offset to symbol-entry within GOT, with PLT handling.
6054 -- : BFD_RELOC_CRIS_32_GOTREL
6055     32-bit offset to symbol, relative to GOT.
6056 -- : BFD_RELOC_CRIS_32_PLT_GOTREL
6057     32-bit offset to symbol with PLT entry, relative to GOT.
6058 -- : BFD_RELOC_CRIS_32_PLT_PCREL
6059     32-bit offset to symbol with PLT entry, relative to this
6060     relocation.
6061 -- : BFD_RELOC_CRIS_32_GOT_GD
6062 -- : BFD_RELOC_CRIS_16_GOT_GD
6063 -- : BFD_RELOC_CRIS_32_GD
6064 -- : BFD_RELOC_CRIS_DTP
6065 -- : BFD_RELOC_CRIS_32_DTPREL
6066 -- : BFD_RELOC_CRIS_16_DTPREL
6067 -- : BFD_RELOC_CRIS_32_GOT_TPREL
6068 -- : BFD_RELOC_CRIS_16_GOT_TPREL
6069 -- : BFD_RELOC_CRIS_32_TPREL
6070 -- : BFD_RELOC_CRIS_16_TPREL
6071 -- : BFD_RELOC_CRIS_DTPMOD
6072 -- : BFD_RELOC_CRIS_32_IE
6073     Relocs used in TLS code for CRIS.
6074 -- : BFD_RELOC_OR1K_REL_26
6075 -- : BFD_RELOC_OR1K_SLO16
6076 -- : BFD_RELOC_OR1K_PCREL_PG21
6077 -- : BFD_RELOC_OR1K_LO13
6078 -- : BFD_RELOC_OR1K_SLO13
6079 -- : BFD_RELOC_OR1K_GOTPC_HI16
6080 -- : BFD_RELOC_OR1K_GOTPC_LO16
6081 -- : BFD_RELOC_OR1K_GOT16
6082 -- : BFD_RELOC_OR1K_GOT_PG21
6083 -- : BFD_RELOC_OR1K_GOT_LO13
6084 -- : BFD_RELOC_OR1K_PLT26
6085 -- : BFD_RELOC_OR1K_PLTA26
6086 -- : BFD_RELOC_OR1K_GOTOFF_SLO16
6087 -- : BFD_RELOC_OR1K_COPY
6088 -- : BFD_RELOC_OR1K_GLOB_DAT
6089 -- : BFD_RELOC_OR1K_JMP_SLOT
6090 -- : BFD_RELOC_OR1K_RELATIVE
6091 -- : BFD_RELOC_OR1K_TLS_GD_HI16
6092 -- : BFD_RELOC_OR1K_TLS_GD_LO16
6093 -- : BFD_RELOC_OR1K_TLS_GD_PG21
6094 -- : BFD_RELOC_OR1K_TLS_GD_LO13
6095 -- : BFD_RELOC_OR1K_TLS_LDM_HI16
6096 -- : BFD_RELOC_OR1K_TLS_LDM_LO16
6097 -- : BFD_RELOC_OR1K_TLS_LDM_PG21
6098 -- : BFD_RELOC_OR1K_TLS_LDM_LO13
6099 -- : BFD_RELOC_OR1K_TLS_LDO_HI16
6100 -- : BFD_RELOC_OR1K_TLS_LDO_LO16
6101 -- : BFD_RELOC_OR1K_TLS_IE_HI16
6102 -- : BFD_RELOC_OR1K_TLS_IE_AHI16
6103 -- : BFD_RELOC_OR1K_TLS_IE_LO16
6104 -- : BFD_RELOC_OR1K_TLS_IE_PG21
6105 -- : BFD_RELOC_OR1K_TLS_IE_LO13
6106 -- : BFD_RELOC_OR1K_TLS_LE_HI16
6107 -- : BFD_RELOC_OR1K_TLS_LE_AHI16
6108 -- : BFD_RELOC_OR1K_TLS_LE_LO16
6109 -- : BFD_RELOC_OR1K_TLS_LE_SLO16
6110 -- : BFD_RELOC_OR1K_TLS_TPOFF
6111 -- : BFD_RELOC_OR1K_TLS_DTPOFF
6112 -- : BFD_RELOC_OR1K_TLS_DTPMOD
6113     OpenRISC 1000 Relocations.
6114 -- : BFD_RELOC_H8_DIR16A8
6115 -- : BFD_RELOC_H8_DIR16R8
6116 -- : BFD_RELOC_H8_DIR24A8
6117 -- : BFD_RELOC_H8_DIR24R8
6118 -- : BFD_RELOC_H8_DIR32A16
6119 -- : BFD_RELOC_H8_DISP32A16
6120     H8 elf Relocations.
6121 -- : BFD_RELOC_XSTORMY16_REL_12
6122 -- : BFD_RELOC_XSTORMY16_12
6123 -- : BFD_RELOC_XSTORMY16_24
6124 -- : BFD_RELOC_XSTORMY16_FPTR16
6125     Sony Xstormy16 Relocations.
6126 -- : BFD_RELOC_RELC
6127     Self-describing complex relocations.
6128 -- : BFD_RELOC_XC16X_PAG
6129 -- : BFD_RELOC_XC16X_POF
6130 -- : BFD_RELOC_XC16X_SEG
6131 -- : BFD_RELOC_XC16X_SOF
6132     Infineon Relocations.
6133 -- : BFD_RELOC_VAX_GLOB_DAT
6134 -- : BFD_RELOC_VAX_JMP_SLOT
6135 -- : BFD_RELOC_VAX_RELATIVE
6136     Relocations used by VAX ELF.
6137 -- : BFD_RELOC_MT_PC16
6138     Morpho MT - 16 bit immediate relocation.
6139 -- : BFD_RELOC_MT_HI16
6140     Morpho MT - Hi 16 bits of an address.
6141 -- : BFD_RELOC_MT_LO16
6142     Morpho MT - Low 16 bits of an address.
6143 -- : BFD_RELOC_MT_GNU_VTINHERIT
6144     Morpho MT - Used to tell the linker which vtable entries are used.
6145 -- : BFD_RELOC_MT_GNU_VTENTRY
6146     Morpho MT - Used to tell the linker which vtable entries are used.
6147 -- : BFD_RELOC_MT_PCINSN8
6148     Morpho MT - 8 bit immediate relocation.
6149 -- : BFD_RELOC_MSP430_10_PCREL
6150 -- : BFD_RELOC_MSP430_16_PCREL
6151 -- : BFD_RELOC_MSP430_16
6152 -- : BFD_RELOC_MSP430_16_PCREL_BYTE
6153 -- : BFD_RELOC_MSP430_16_BYTE
6154 -- : BFD_RELOC_MSP430_2X_PCREL
6155 -- : BFD_RELOC_MSP430_RL_PCREL
6156 -- : BFD_RELOC_MSP430_ABS8
6157 -- : BFD_RELOC_MSP430X_PCR20_EXT_SRC
6158 -- : BFD_RELOC_MSP430X_PCR20_EXT_DST
6159 -- : BFD_RELOC_MSP430X_PCR20_EXT_ODST
6160 -- : BFD_RELOC_MSP430X_ABS20_EXT_SRC
6161 -- : BFD_RELOC_MSP430X_ABS20_EXT_DST
6162 -- : BFD_RELOC_MSP430X_ABS20_EXT_ODST
6163 -- : BFD_RELOC_MSP430X_ABS20_ADR_SRC
6164 -- : BFD_RELOC_MSP430X_ABS20_ADR_DST
6165 -- : BFD_RELOC_MSP430X_PCR16
6166 -- : BFD_RELOC_MSP430X_PCR20_CALL
6167 -- : BFD_RELOC_MSP430X_ABS16
6168 -- : BFD_RELOC_MSP430_ABS_HI16
6169 -- : BFD_RELOC_MSP430_PREL31
6170 -- : BFD_RELOC_MSP430_SYM_DIFF
6171 -- : BFD_RELOC_MSP430_SET_ULEB128
6172 -- : BFD_RELOC_MSP430_SUB_ULEB128
6173     msp430 specific relocation codes
6174 -- : BFD_RELOC_NIOS2_S16
6175 -- : BFD_RELOC_NIOS2_U16
6176 -- : BFD_RELOC_NIOS2_CALL26
6177 -- : BFD_RELOC_NIOS2_IMM5
6178 -- : BFD_RELOC_NIOS2_CACHE_OPX
6179 -- : BFD_RELOC_NIOS2_IMM6
6180 -- : BFD_RELOC_NIOS2_IMM8
6181 -- : BFD_RELOC_NIOS2_HI16
6182 -- : BFD_RELOC_NIOS2_LO16
6183 -- : BFD_RELOC_NIOS2_HIADJ16
6184 -- : BFD_RELOC_NIOS2_GPREL
6185 -- : BFD_RELOC_NIOS2_UJMP
6186 -- : BFD_RELOC_NIOS2_CJMP
6187 -- : BFD_RELOC_NIOS2_CALLR
6188 -- : BFD_RELOC_NIOS2_ALIGN
6189 -- : BFD_RELOC_NIOS2_GOT16
6190 -- : BFD_RELOC_NIOS2_CALL16
6191 -- : BFD_RELOC_NIOS2_GOTOFF_LO
6192 -- : BFD_RELOC_NIOS2_GOTOFF_HA
6193 -- : BFD_RELOC_NIOS2_PCREL_LO
6194 -- : BFD_RELOC_NIOS2_PCREL_HA
6195 -- : BFD_RELOC_NIOS2_TLS_GD16
6196 -- : BFD_RELOC_NIOS2_TLS_LDM16
6197 -- : BFD_RELOC_NIOS2_TLS_LDO16
6198 -- : BFD_RELOC_NIOS2_TLS_IE16
6199 -- : BFD_RELOC_NIOS2_TLS_LE16
6200 -- : BFD_RELOC_NIOS2_TLS_DTPMOD
6201 -- : BFD_RELOC_NIOS2_TLS_DTPREL
6202 -- : BFD_RELOC_NIOS2_TLS_TPREL
6203 -- : BFD_RELOC_NIOS2_COPY
6204 -- : BFD_RELOC_NIOS2_GLOB_DAT
6205 -- : BFD_RELOC_NIOS2_JUMP_SLOT
6206 -- : BFD_RELOC_NIOS2_RELATIVE
6207 -- : BFD_RELOC_NIOS2_GOTOFF
6208 -- : BFD_RELOC_NIOS2_CALL26_NOAT
6209 -- : BFD_RELOC_NIOS2_GOT_LO
6210 -- : BFD_RELOC_NIOS2_GOT_HA
6211 -- : BFD_RELOC_NIOS2_CALL_LO
6212 -- : BFD_RELOC_NIOS2_CALL_HA
6213 -- : BFD_RELOC_NIOS2_R2_S12
6214 -- : BFD_RELOC_NIOS2_R2_I10_1_PCREL
6215 -- : BFD_RELOC_NIOS2_R2_T1I7_1_PCREL
6216 -- : BFD_RELOC_NIOS2_R2_T1I7_2
6217 -- : BFD_RELOC_NIOS2_R2_T2I4
6218 -- : BFD_RELOC_NIOS2_R2_T2I4_1
6219 -- : BFD_RELOC_NIOS2_R2_T2I4_2
6220 -- : BFD_RELOC_NIOS2_R2_X1I7_2
6221 -- : BFD_RELOC_NIOS2_R2_X2L5
6222 -- : BFD_RELOC_NIOS2_R2_F1I5_2
6223 -- : BFD_RELOC_NIOS2_R2_L5I4X1
6224 -- : BFD_RELOC_NIOS2_R2_T1X1I6
6225 -- : BFD_RELOC_NIOS2_R2_T1X1I6_2
6226     Relocations used by the Altera Nios II core.
6227 -- : BFD_RELOC_PRU_U16
6228     PRU LDI 16-bit unsigned data-memory relocation.
6229 -- : BFD_RELOC_PRU_U16_PMEMIMM
6230     PRU LDI 16-bit unsigned instruction-memory relocation.
6231 -- : BFD_RELOC_PRU_LDI32
6232     PRU relocation for two consecutive LDI load instructions that load
6233     a 32 bit value into a register.  If the higher bits are all zero,
6234     then the second instruction may be relaxed.
6235 -- : BFD_RELOC_PRU_S10_PCREL
6236     PRU QBBx 10-bit signed PC-relative relocation.
6237 -- : BFD_RELOC_PRU_U8_PCREL
6238     PRU 8-bit unsigned relocation used for the LOOP instruction.
6239 -- : BFD_RELOC_PRU_32_PMEM
6240 -- : BFD_RELOC_PRU_16_PMEM
6241     PRU Program Memory relocations.  Used to convert from byte
6242     addressing to 32-bit word addressing.
6243 -- : BFD_RELOC_PRU_GNU_DIFF8
6244 -- : BFD_RELOC_PRU_GNU_DIFF16
6245 -- : BFD_RELOC_PRU_GNU_DIFF32
6246 -- : BFD_RELOC_PRU_GNU_DIFF16_PMEM
6247 -- : BFD_RELOC_PRU_GNU_DIFF32_PMEM
6248     PRU relocations to mark the difference of two local symbols.  These
6249     are only needed to support linker relaxation and can be ignored
6250     when not relaxing.  The field is set to the value of the difference
6251     assuming no relaxation.  The relocation encodes the position of the
6252     second symbol so the linker can determine whether to adjust the
6253     field value.  The PMEM variants encode the word difference, instead
6254     of byte difference between symbols.
6255 -- : BFD_RELOC_IQ2000_OFFSET_16
6256 -- : BFD_RELOC_IQ2000_OFFSET_21
6257 -- : BFD_RELOC_IQ2000_UHI16
6258     IQ2000 Relocations.
6259 -- : BFD_RELOC_XTENSA_RTLD
6260     Special Xtensa relocation used only by PLT entries in ELF shared
6261     objects to indicate that the runtime linker should set the value to
6262     one of its own internal functions or data structures.
6263 -- : BFD_RELOC_XTENSA_GLOB_DAT
6264 -- : BFD_RELOC_XTENSA_JMP_SLOT
6265 -- : BFD_RELOC_XTENSA_RELATIVE
6266     Xtensa relocations for ELF shared objects.
6267 -- : BFD_RELOC_XTENSA_PLT
6268     Xtensa relocation used in ELF object files for symbols that may
6269     require PLT entries.  Otherwise, this is just a generic 32-bit
6270     relocation.
6271 -- : BFD_RELOC_XTENSA_DIFF8
6272 -- : BFD_RELOC_XTENSA_DIFF16
6273 -- : BFD_RELOC_XTENSA_DIFF32
6274     Xtensa relocations for backward compatibility.  These have been
6275     replaced by BFD_RELOC_XTENSA_PDIFF and BFD_RELOC_XTENSA_NDIFF.
6276     Xtensa relocations to mark the difference of two local symbols.
6277     These are only needed to support linker relaxation and can be
6278     ignored when not relaxing.  The field is set to the value of the
6279     difference assuming no relaxation.  The relocation encodes the
6280     position of the first symbol so the linker can determine whether to
6281     adjust the field value.
6282 -- : BFD_RELOC_XTENSA_SLOT0_OP
6283 -- : BFD_RELOC_XTENSA_SLOT1_OP
6284 -- : BFD_RELOC_XTENSA_SLOT2_OP
6285 -- : BFD_RELOC_XTENSA_SLOT3_OP
6286 -- : BFD_RELOC_XTENSA_SLOT4_OP
6287 -- : BFD_RELOC_XTENSA_SLOT5_OP
6288 -- : BFD_RELOC_XTENSA_SLOT6_OP
6289 -- : BFD_RELOC_XTENSA_SLOT7_OP
6290 -- : BFD_RELOC_XTENSA_SLOT8_OP
6291 -- : BFD_RELOC_XTENSA_SLOT9_OP
6292 -- : BFD_RELOC_XTENSA_SLOT10_OP
6293 -- : BFD_RELOC_XTENSA_SLOT11_OP
6294 -- : BFD_RELOC_XTENSA_SLOT12_OP
6295 -- : BFD_RELOC_XTENSA_SLOT13_OP
6296 -- : BFD_RELOC_XTENSA_SLOT14_OP
6297     Generic Xtensa relocations for instruction operands.  Only the slot
6298     number is encoded in the relocation.  The relocation applies to the
6299     last PC-relative immediate operand, or if there are no PC-relative
6300     immediates, to the last immediate operand.
6301 -- : BFD_RELOC_XTENSA_SLOT0_ALT
6302 -- : BFD_RELOC_XTENSA_SLOT1_ALT
6303 -- : BFD_RELOC_XTENSA_SLOT2_ALT
6304 -- : BFD_RELOC_XTENSA_SLOT3_ALT
6305 -- : BFD_RELOC_XTENSA_SLOT4_ALT
6306 -- : BFD_RELOC_XTENSA_SLOT5_ALT
6307 -- : BFD_RELOC_XTENSA_SLOT6_ALT
6308 -- : BFD_RELOC_XTENSA_SLOT7_ALT
6309 -- : BFD_RELOC_XTENSA_SLOT8_ALT
6310 -- : BFD_RELOC_XTENSA_SLOT9_ALT
6311 -- : BFD_RELOC_XTENSA_SLOT10_ALT
6312 -- : BFD_RELOC_XTENSA_SLOT11_ALT
6313 -- : BFD_RELOC_XTENSA_SLOT12_ALT
6314 -- : BFD_RELOC_XTENSA_SLOT13_ALT
6315 -- : BFD_RELOC_XTENSA_SLOT14_ALT
6316     Alternate Xtensa relocations.  Only the slot is encoded in the
6317     relocation.  The meaning of these relocations is opcode-specific.
6318 -- : BFD_RELOC_XTENSA_OP0
6319 -- : BFD_RELOC_XTENSA_OP1
6320 -- : BFD_RELOC_XTENSA_OP2
6321     Xtensa relocations for backward compatibility.  These have all been
6322     replaced by BFD_RELOC_XTENSA_SLOT0_OP.
6323 -- : BFD_RELOC_XTENSA_ASM_EXPAND
6324     Xtensa relocation to mark that the assembler expanded the
6325     instructions from an original target.  The expansion size is
6326     encoded in the reloc size.
6327 -- : BFD_RELOC_XTENSA_ASM_SIMPLIFY
6328     Xtensa relocation to mark that the linker should simplify
6329     assembler-expanded instructions.  This is commonly used internally
6330     by the linker after analysis of a BFD_RELOC_XTENSA_ASM_EXPAND.
6331 -- : BFD_RELOC_XTENSA_TLSDESC_FN
6332 -- : BFD_RELOC_XTENSA_TLSDESC_ARG
6333 -- : BFD_RELOC_XTENSA_TLS_DTPOFF
6334 -- : BFD_RELOC_XTENSA_TLS_TPOFF
6335 -- : BFD_RELOC_XTENSA_TLS_FUNC
6336 -- : BFD_RELOC_XTENSA_TLS_ARG
6337 -- : BFD_RELOC_XTENSA_TLS_CALL
6338     Xtensa TLS relocations.
6339 -- : BFD_RELOC_XTENSA_PDIFF8
6340 -- : BFD_RELOC_XTENSA_PDIFF16
6341 -- : BFD_RELOC_XTENSA_PDIFF32
6342 -- : BFD_RELOC_XTENSA_NDIFF8
6343 -- : BFD_RELOC_XTENSA_NDIFF16
6344 -- : BFD_RELOC_XTENSA_NDIFF32
6345     Xtensa relocations to mark the difference of two local symbols.
6346     These are only needed to support linker relaxation and can be
6347     ignored when not relaxing.  The field is set to the value of the
6348     difference assuming no relaxation.  The relocation encodes the
6349     position of the subtracted symbol so the linker can determine
6350     whether to adjust the field value.  PDIFF relocations are used for
6351     positive differences, NDIFF relocations are used for negative
6352     differences.  The difference value is treated as unsigned with
6353     these relocation types, giving full 8/16 value ranges.
6354 -- : BFD_RELOC_Z80_DISP8
6355     8 bit signed offset in (ix+d) or (iy+d).
6356 -- : BFD_RELOC_Z80_BYTE0
6357     First 8 bits of multibyte (32, 24 or 16 bit) value.
6358 -- : BFD_RELOC_Z80_BYTE1
6359     Second 8 bits of multibyte (32, 24 or 16 bit) value.
6360 -- : BFD_RELOC_Z80_BYTE2
6361     Third 8 bits of multibyte (32 or 24 bit) value.
6362 -- : BFD_RELOC_Z80_BYTE3
6363     Fourth 8 bits of multibyte (32 bit) value.
6364 -- : BFD_RELOC_Z80_WORD0
6365     Lowest 16 bits of multibyte (32 or 24 bit) value.
6366 -- : BFD_RELOC_Z80_WORD1
6367     Highest 16 bits of multibyte (32 or 24 bit) value.
6368 -- : BFD_RELOC_Z80_16_BE
6369     Like BFD_RELOC_16 but big-endian.
6370 -- : BFD_RELOC_Z8K_DISP7
6371     DJNZ offset.
6372 -- : BFD_RELOC_Z8K_CALLR
6373     CALR offset.
6374 -- : BFD_RELOC_Z8K_IMM4L
6375     4 bit value.
6376 -- : BFD_RELOC_LM32_CALL
6377 -- : BFD_RELOC_LM32_BRANCH
6378 -- : BFD_RELOC_LM32_16_GOT
6379 -- : BFD_RELOC_LM32_GOTOFF_HI16
6380 -- : BFD_RELOC_LM32_GOTOFF_LO16
6381 -- : BFD_RELOC_LM32_COPY
6382 -- : BFD_RELOC_LM32_GLOB_DAT
6383 -- : BFD_RELOC_LM32_JMP_SLOT
6384 -- : BFD_RELOC_LM32_RELATIVE
6385     Lattice Mico32 relocations.
6386 -- : BFD_RELOC_MACH_O_SECTDIFF
6387     Difference between two section addreses.  Must be followed by a
6388     BFD_RELOC_MACH_O_PAIR.
6389 -- : BFD_RELOC_MACH_O_LOCAL_SECTDIFF
6390     Like BFD_RELOC_MACH_O_SECTDIFF but with a local symbol.
6391 -- : BFD_RELOC_MACH_O_PAIR
6392     Pair of relocation.  Contains the first symbol.
6393 -- : BFD_RELOC_MACH_O_SUBTRACTOR32
6394     Symbol will be substracted.  Must be followed by a BFD_RELOC_32.
6395 -- : BFD_RELOC_MACH_O_SUBTRACTOR64
6396     Symbol will be substracted.  Must be followed by a BFD_RELOC_64.
6397 -- : BFD_RELOC_MACH_O_X86_64_BRANCH32
6398 -- : BFD_RELOC_MACH_O_X86_64_BRANCH8
6399     PCREL relocations.  They are marked as branch to create PLT entry
6400     if required.
6401 -- : BFD_RELOC_MACH_O_X86_64_GOT
6402     Used when referencing a GOT entry.
6403 -- : BFD_RELOC_MACH_O_X86_64_GOT_LOAD
6404     Used when loading a GOT entry with movq.  It is specially marked so
6405     that the linker could optimize the movq to a leaq if possible.
6406 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_1
6407     Same as BFD_RELOC_32_PCREL but with an implicit -1 addend.
6408 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_2
6409     Same as BFD_RELOC_32_PCREL but with an implicit -2 addend.
6410 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_4
6411     Same as BFD_RELOC_32_PCREL but with an implicit -4 addend.
6412 -- : BFD_RELOC_MACH_O_X86_64_TLV
6413     Used when referencing a TLV entry.
6414 -- : BFD_RELOC_MACH_O_ARM64_ADDEND
6415     Addend for PAGE or PAGEOFF.
6416 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21
6417     Relative offset to page of GOT slot.
6418 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12
6419     Relative offset within page of GOT slot.
6420 -- : BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT
6421     Address of a GOT entry.
6422 -- : BFD_RELOC_MICROBLAZE_32_LO
6423     This is a 32 bit reloc for the microblaze that stores the low 16
6424     bits of a value
6425 -- : BFD_RELOC_MICROBLAZE_32_LO_PCREL
6426     This is a 32 bit pc-relative reloc for the microblaze that stores
6427     the low 16 bits of a value
6428 -- : BFD_RELOC_MICROBLAZE_32_ROSDA
6429     This is a 32 bit reloc for the microblaze that stores a value
6430     relative to the read-only small data area anchor
6431 -- : BFD_RELOC_MICROBLAZE_32_RWSDA
6432     This is a 32 bit reloc for the microblaze that stores a value
6433     relative to the read-write small data area anchor
6434 -- : BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM
6435     This is a 32 bit reloc for the microblaze to handle expressions of
6436     the form "Symbol Op Symbol"
6437 -- : BFD_RELOC_MICROBLAZE_64_NONE
6438     This is a 64 bit reloc that stores the 32 bit pc relative value in
6439     two words (with an imm instruction).  No relocation is done here -
6440     only used for relaxing
6441 -- : BFD_RELOC_MICROBLAZE_64_GOTPC
6442     This is a 64 bit reloc that stores the 32 bit pc relative value in
6443     two words (with an imm instruction).  The relocation is PC-relative
6444     GOT offset
6445 -- : BFD_RELOC_MICROBLAZE_64_GOT
6446     This is a 64 bit reloc that stores the 32 bit pc relative value in
6447     two words (with an imm instruction).  The relocation is GOT offset
6448 -- : BFD_RELOC_MICROBLAZE_64_PLT
6449     This is a 64 bit reloc that stores the 32 bit pc relative value in
6450     two words (with an imm instruction).  The relocation is PC-relative
6451     offset into PLT
6452 -- : BFD_RELOC_MICROBLAZE_64_GOTOFF
6453     This is a 64 bit reloc that stores the 32 bit GOT relative value in
6454     two words (with an imm instruction).  The relocation is relative
6455     offset from _GLOBAL_OFFSET_TABLE_
6456 -- : BFD_RELOC_MICROBLAZE_32_GOTOFF
6457     This is a 32 bit reloc that stores the 32 bit GOT relative value in
6458     a word.  The relocation is relative offset from
6459 -- : BFD_RELOC_MICROBLAZE_COPY
6460     This is used to tell the dynamic linker to copy the value out of
6461     the dynamic object into the runtime process image.
6462 -- : BFD_RELOC_MICROBLAZE_64_TLS
6463     Unused Reloc
6464 -- : BFD_RELOC_MICROBLAZE_64_TLSGD
6465     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6466     the GOT TLS GD info entry in two words (with an imm instruction).
6467     The relocation is GOT offset.
6468 -- : BFD_RELOC_MICROBLAZE_64_TLSLD
6469     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6470     the GOT TLS LD info entry in two words (with an imm instruction).
6471     The relocation is GOT offset.
6472 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPMOD
6473     This is a 32 bit reloc that stores the Module ID to GOT(n).
6474 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPREL
6475     This is a 32 bit reloc that stores TLS offset to GOT(n+1).
6476 -- : BFD_RELOC_MICROBLAZE_64_TLSDTPREL
6477     This is a 32 bit reloc for storing TLS offset to two words (uses
6478     imm instruction)
6479 -- : BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL
6480     This is a 64 bit reloc that stores 32-bit thread pointer relative
6481     offset to two words (uses imm instruction).
6482 -- : BFD_RELOC_MICROBLAZE_64_TLSTPREL
6483     This is a 64 bit reloc that stores 32-bit thread pointer relative
6484     offset to two words (uses imm instruction).
6485 -- : BFD_RELOC_MICROBLAZE_64_TEXTPCREL
6486     This is a 64 bit reloc that stores the 32 bit pc relative value in
6487     two words (with an imm instruction).  The relocation is PC-relative
6488     offset from start of TEXT.
6489 -- : BFD_RELOC_MICROBLAZE_64_TEXTREL
6490     This is a 64 bit reloc that stores the 32 bit offset value in two
6491     words (with an imm instruction).  The relocation is relative offset
6492     from start of TEXT.
6493 -- : BFD_RELOC_AARCH64_RELOC_START
6494     AArch64 pseudo relocation code to mark the start of the AArch64
6495     relocation enumerators.  N.B. the order of the enumerators is
6496     important as several tables in the AArch64 bfd backend are indexed
6497     by these enumerators; make sure they are all synced.
6498 -- : BFD_RELOC_AARCH64_NULL
6499     Deprecated AArch64 null relocation code.
6500 -- : BFD_RELOC_AARCH64_NONE
6501     AArch64 null relocation code.
6502 -- : BFD_RELOC_AARCH64_64
6503 -- : BFD_RELOC_AARCH64_32
6504 -- : BFD_RELOC_AARCH64_16
6505     Basic absolute relocations of N bits.  These are equivalent to
6506     BFD_RELOC_N and they were added to assist the indexing of the howto
6507     table.
6508 -- : BFD_RELOC_AARCH64_64_PCREL
6509 -- : BFD_RELOC_AARCH64_32_PCREL
6510 -- : BFD_RELOC_AARCH64_16_PCREL
6511     PC-relative relocations.  These are equivalent to BFD_RELOC_N_PCREL
6512     and they were added to assist the indexing of the howto table.
6513 -- : BFD_RELOC_AARCH64_MOVW_G0
6514     AArch64 MOV[NZK] instruction with most significant bits 0 to 15 of
6515     an unsigned address/value.
6516 -- : BFD_RELOC_AARCH64_MOVW_G0_NC
6517     AArch64 MOV[NZK] instruction with less significant bits 0 to 15 of
6518     an address/value.  No overflow checking.
6519 -- : BFD_RELOC_AARCH64_MOVW_G1
6520     AArch64 MOV[NZK] instruction with most significant bits 16 to 31 of
6521     an unsigned address/value.
6522 -- : BFD_RELOC_AARCH64_MOVW_G1_NC
6523     AArch64 MOV[NZK] instruction with less significant bits 16 to 31 of
6524     an address/value.  No overflow checking.
6525 -- : BFD_RELOC_AARCH64_MOVW_G2
6526     AArch64 MOV[NZK] instruction with most significant bits 32 to 47 of
6527     an unsigned address/value.
6528 -- : BFD_RELOC_AARCH64_MOVW_G2_NC
6529     AArch64 MOV[NZK] instruction with less significant bits 32 to 47 of
6530     an address/value.  No overflow checking.
6531 -- : BFD_RELOC_AARCH64_MOVW_G3
6532     AArch64 MOV[NZK] instruction with most signficant bits 48 to 64 of
6533     a signed or unsigned address/value.
6534 -- : BFD_RELOC_AARCH64_MOVW_G0_S
6535     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6536     signed value.  Changes instruction to MOVZ or MOVN depending on the
6537     value's sign.
6538 -- : BFD_RELOC_AARCH64_MOVW_G1_S
6539     AArch64 MOV[NZ] instruction with most significant bits 16 to 31 of
6540     a signed value.  Changes instruction to MOVZ or MOVN depending on
6541     the value's sign.
6542 -- : BFD_RELOC_AARCH64_MOVW_G2_S
6543     AArch64 MOV[NZ] instruction with most significant bits 32 to 47 of
6544     a signed value.  Changes instruction to MOVZ or MOVN depending on
6545     the value's sign.
6546 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0
6547     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6548     signed value.  Changes instruction to MOVZ or MOVN depending on the
6549     value's sign.
6550 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0_NC
6551     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6552     signed value.  Changes instruction to MOVZ or MOVN depending on the
6553     value's sign.
6554 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1
6555     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6556     signed value.
6557 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1_NC
6558     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6559     signed value.
6560 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2
6561     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6562     signed value.
6563 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2_NC
6564     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6565     signed value.
6566 -- : BFD_RELOC_AARCH64_MOVW_PREL_G3
6567     AArch64 MOVK instruction with most significant bits 47 to 63 of a
6568     signed value.
6569 -- : BFD_RELOC_AARCH64_LD_LO19_PCREL
6570     AArch64 Load Literal instruction, holding a 19 bit pc-relative word
6571     offset.  The lowest two bits must be zero and are not stored in the
6572     instruction, giving a 21 bit signed byte offset.
6573 -- : BFD_RELOC_AARCH64_ADR_LO21_PCREL
6574     AArch64 ADR instruction, holding a simple 21 bit pc-relative byte
6575     offset.
6576 -- : BFD_RELOC_AARCH64_ADR_HI21_PCREL
6577     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6578     offset, giving a 4KB aligned page base address.
6579 -- : BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL
6580     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6581     offset, giving a 4KB aligned page base address, but with no
6582     overflow checking.
6583 -- : BFD_RELOC_AARCH64_ADD_LO12
6584     AArch64 ADD immediate instruction, holding bits 0 to 11 of the
6585     address.  Used in conjunction with
6586     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6587 -- : BFD_RELOC_AARCH64_LDST8_LO12
6588     AArch64 8-bit load/store instruction, holding bits 0 to 11 of the
6589     address.  Used in conjunction with
6590     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6591 -- : BFD_RELOC_AARCH64_TSTBR14
6592     AArch64 14 bit pc-relative test bit and branch.  The lowest two
6593     bits must be zero and are not stored in the instruction, giving a
6594     16 bit signed byte offset.
6595 -- : BFD_RELOC_AARCH64_BRANCH19
6596     AArch64 19 bit pc-relative conditional branch and compare & branch.
6597     The lowest two bits must be zero and are not stored in the
6598     instruction, giving a 21 bit signed byte offset.
6599 -- : BFD_RELOC_AARCH64_JUMP26
6600     AArch64 26 bit pc-relative unconditional branch.  The lowest two
6601     bits must be zero and are not stored in the instruction, giving a
6602     28 bit signed byte offset.
6603 -- : BFD_RELOC_AARCH64_CALL26
6604     AArch64 26 bit pc-relative unconditional branch and link.  The
6605     lowest two bits must be zero and are not stored in the instruction,
6606     giving a 28 bit signed byte offset.
6607 -- : BFD_RELOC_AARCH64_LDST16_LO12
6608     AArch64 16-bit load/store instruction, holding bits 0 to 11 of the
6609     address.  Used in conjunction with
6610     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6611 -- : BFD_RELOC_AARCH64_LDST32_LO12
6612     AArch64 32-bit load/store instruction, holding bits 0 to 11 of the
6613     address.  Used in conjunction with
6614     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6615 -- : BFD_RELOC_AARCH64_LDST64_LO12
6616     AArch64 64-bit load/store instruction, holding bits 0 to 11 of the
6617     address.  Used in conjunction with
6618     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6619 -- : BFD_RELOC_AARCH64_LDST128_LO12
6620     AArch64 128-bit load/store instruction, holding bits 0 to 11 of the
6621     address.  Used in conjunction with
6622     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6623 -- : BFD_RELOC_AARCH64_GOT_LD_PREL19
6624     AArch64 Load Literal instruction, holding a 19 bit PC relative word
6625     offset of the global offset table entry for a symbol.  The lowest
6626     two bits must be zero and are not stored in the instruction, giving
6627     a 21 bit signed byte offset.  This relocation type requires signed
6628     overflow checking.
6629 -- : BFD_RELOC_AARCH64_ADR_GOT_PAGE
6630     Get to the page base of the global offset table entry for a symbol
6631     as part of an ADRP instruction using a 21 bit PC relative
6632     value.Used in conjunction with BFD_RELOC_AARCH64_LD64_GOT_LO12_NC.
6633 -- : BFD_RELOC_AARCH64_LD64_GOT_LO12_NC
6634     Unsigned 12 bit byte offset for 64 bit load/store from the page of
6635     the GOT entry for this symbol.  Used in conjunction with
6636     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in LP64 ABI only.
6637 -- : BFD_RELOC_AARCH64_LD32_GOT_LO12_NC
6638     Unsigned 12 bit byte offset for 32 bit load/store from the page of
6639     the GOT entry for this symbol.  Used in conjunction with
6640     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in ILP32 ABI only.
6641 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC
6642     Unsigned 16 bit byte offset for 64 bit load/store from the GOT
6643     entry for this symbol.  Valid in LP64 ABI only.
6644 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G1
6645     Unsigned 16 bit byte higher offset for 64 bit load/store from the
6646     GOT entry for this symbol.  Valid in LP64 ABI only.
6647 -- : BFD_RELOC_AARCH64_LD64_GOTOFF_LO15
6648     Unsigned 15 bit byte offset for 64 bit load/store from the page of
6649     the GOT entry for this symbol.  Valid in LP64 ABI only.
6650 -- : BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14
6651     Scaled 14 bit byte offset to the page base of the global offset
6652     table.
6653 -- : BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15
6654     Scaled 15 bit byte offset to the page base of the global offset
6655     table.
6656 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21
6657     Get to the page base of the global offset table entry for a symbols
6658     tls_index structure as part of an adrp instruction using a 21 bit
6659     PC relative value.  Used in conjunction with
6660     BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC.
6661 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PREL21
6662     AArch64 TLS General Dynamic
6663 -- : BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC
6664     Unsigned 12 bit byte offset to global offset table entry for a
6665     symbols tls_index structure.  Used in conjunction with
6666     BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21.
6667 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC
6668     AArch64 TLS General Dynamic relocation.
6669 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G1
6670     AArch64 TLS General Dynamic relocation.
6671 -- : BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21
6672     AArch64 TLS INITIAL EXEC relocation.
6673 -- : BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC
6674     AArch64 TLS INITIAL EXEC relocation.
6675 -- : BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC
6676     AArch64 TLS INITIAL EXEC relocation.
6677 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19
6678     AArch64 TLS INITIAL EXEC relocation.
6679 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC
6680     AArch64 TLS INITIAL EXEC relocation.
6681 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1
6682     AArch64 TLS INITIAL EXEC relocation.
6683 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12
6684     bit[23:12] of byte offset to module TLS base address.
6685 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12
6686     Unsigned 12 bit byte offset to module TLS base address.
6687 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC
6688     No overflow check version of
6689     BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12.
6690 -- : BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC
6691     Unsigned 12 bit byte offset to global offset table entry for a
6692     symbols tls_index structure.  Used in conjunction with
6693     BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21.
6694 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21
6695     GOT entry page address for AArch64 TLS Local Dynamic, used with
6696     ADRP instruction.
6697 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PREL21
6698     GOT entry address for AArch64 TLS Local Dynamic, used with ADR
6699     instruction.
6700 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12
6701     bit[11:1] of byte offset to module TLS base address, encoded in
6702     ldst instructions.
6703 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC
6704     Similar as BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12, but no
6705     overflow check.
6706 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12
6707     bit[11:2] of byte offset to module TLS base address, encoded in
6708     ldst instructions.
6709 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC
6710     Similar as BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12, but no
6711     overflow check.
6712 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12
6713     bit[11:3] of byte offset to module TLS base address, encoded in
6714     ldst instructions.
6715 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC
6716     Similar as BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12, but no
6717     overflow check.
6718 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12
6719     bit[11:0] of byte offset to module TLS base address, encoded in
6720     ldst instructions.
6721 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC
6722     Similar as BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12, but no
6723     overflow check.
6724 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6725     bit[15:0] of byte offset to module TLS base address.
6726 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC
6727     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6728 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6729     bit[31:16] of byte offset to module TLS base address.
6730 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC
6731     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6732 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2
6733     bit[47:32] of byte offset to module TLS base address.
6734 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2
6735     AArch64 TLS LOCAL EXEC relocation.
6736 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1
6737     AArch64 TLS LOCAL EXEC relocation.
6738 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC
6739     AArch64 TLS LOCAL EXEC relocation.
6740 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0
6741     AArch64 TLS LOCAL EXEC relocation.
6742 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC
6743     AArch64 TLS LOCAL EXEC relocation.
6744 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12
6745     AArch64 TLS LOCAL EXEC relocation.
6746 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12
6747     AArch64 TLS LOCAL EXEC relocation.
6748 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC
6749     AArch64 TLS LOCAL EXEC relocation.
6750 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12
6751     bit[11:1] of byte offset to module TLS base address, encoded in
6752     ldst instructions.
6753 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC
6754     Similar as BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12, but no
6755     overflow check.
6756 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12
6757     bit[11:2] of byte offset to module TLS base address, encoded in
6758     ldst instructions.
6759 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC
6760     Similar as BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12, but no
6761     overflow check.
6762 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12
6763     bit[11:3] of byte offset to module TLS base address, encoded in
6764     ldst instructions.
6765 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC
6766     Similar as BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12, but no
6767     overflow check.
6768 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12
6769     bit[11:0] of byte offset to module TLS base address, encoded in
6770     ldst instructions.
6771 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC
6772     Similar as BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12, but no
6773     overflow check.
6774 -- : BFD_RELOC_AARCH64_TLSDESC_LD_PREL19
6775     AArch64 TLS DESC relocation.
6776 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21
6777     AArch64 TLS DESC relocation.
6778 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21
6779     AArch64 TLS DESC relocation.
6780 -- : BFD_RELOC_AARCH64_TLSDESC_LD64_LO12
6781     AArch64 TLS DESC relocation.
6782 -- : BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC
6783     AArch64 TLS DESC relocation.
6784 -- : BFD_RELOC_AARCH64_TLSDESC_ADD_LO12
6785     AArch64 TLS DESC relocation.
6786 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G1
6787     AArch64 TLS DESC relocation.
6788 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC
6789     AArch64 TLS DESC relocation.
6790 -- : BFD_RELOC_AARCH64_TLSDESC_LDR
6791     AArch64 TLS DESC relocation.
6792 -- : BFD_RELOC_AARCH64_TLSDESC_ADD
6793     AArch64 TLS DESC relocation.
6794 -- : BFD_RELOC_AARCH64_TLSDESC_CALL
6795     AArch64 TLS DESC relocation.
6796 -- : BFD_RELOC_AARCH64_COPY
6797     AArch64 TLS relocation.
6798 -- : BFD_RELOC_AARCH64_GLOB_DAT
6799     AArch64 TLS relocation.
6800 -- : BFD_RELOC_AARCH64_JUMP_SLOT
6801     AArch64 TLS relocation.
6802 -- : BFD_RELOC_AARCH64_RELATIVE
6803     AArch64 TLS relocation.
6804 -- : BFD_RELOC_AARCH64_TLS_DTPMOD
6805     AArch64 TLS relocation.
6806 -- : BFD_RELOC_AARCH64_TLS_DTPREL
6807     AArch64 TLS relocation.
6808 -- : BFD_RELOC_AARCH64_TLS_TPREL
6809     AArch64 TLS relocation.
6810 -- : BFD_RELOC_AARCH64_TLSDESC
6811     AArch64 TLS relocation.
6812 -- : BFD_RELOC_AARCH64_IRELATIVE
6813     AArch64 support for STT_GNU_IFUNC.
6814 -- : BFD_RELOC_AARCH64_RELOC_END
6815     AArch64 pseudo relocation code to mark the end of the AArch64
6816     relocation enumerators that have direct mapping to ELF reloc codes.
6817     There are a few more enumerators after this one; those are mainly
6818     used by the AArch64 assembler for the internal fixup or to select
6819     one of the above enumerators.
6820 -- : BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP
6821     AArch64 pseudo relocation code to be used internally by the AArch64
6822     assembler and not (currently) written to any object files.
6823 -- : BFD_RELOC_AARCH64_LDST_LO12
6824     AArch64 unspecified load/store instruction, holding bits 0 to 11 of
6825     the address.  Used in conjunction with
6826     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6827 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12
6828     AArch64 pseudo relocation code for TLS local dynamic mode.  It's to
6829     be used internally by the AArch64 assembler and not (currently)
6830     written to any object files.
6831 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC
6832     Similar as BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12, but no
6833     overflow check.
6834 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12
6835     AArch64 pseudo relocation code for TLS local exec mode.  It's to be
6836     used internally by the AArch64 assembler and not (currently)
6837     written to any object files.
6838 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC
6839     Similar as BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12, but no overflow
6840     check.
6841 -- : BFD_RELOC_AARCH64_LD_GOT_LO12_NC
6842     AArch64 pseudo relocation code to be used internally by the AArch64
6843     assembler and not (currently) written to any object files.
6844 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC
6845     AArch64 pseudo relocation code to be used internally by the AArch64
6846     assembler and not (currently) written to any object files.
6847 -- : BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC
6848     AArch64 pseudo relocation code to be used internally by the AArch64
6849     assembler and not (currently) written to any object files.
6850 -- : BFD_RELOC_TILEPRO_COPY
6851 -- : BFD_RELOC_TILEPRO_GLOB_DAT
6852 -- : BFD_RELOC_TILEPRO_JMP_SLOT
6853 -- : BFD_RELOC_TILEPRO_RELATIVE
6854 -- : BFD_RELOC_TILEPRO_BROFF_X1
6855 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1
6856 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT
6857 -- : BFD_RELOC_TILEPRO_IMM8_X0
6858 -- : BFD_RELOC_TILEPRO_IMM8_Y0
6859 -- : BFD_RELOC_TILEPRO_IMM8_X1
6860 -- : BFD_RELOC_TILEPRO_IMM8_Y1
6861 -- : BFD_RELOC_TILEPRO_DEST_IMM8_X1
6862 -- : BFD_RELOC_TILEPRO_MT_IMM15_X1
6863 -- : BFD_RELOC_TILEPRO_MF_IMM15_X1
6864 -- : BFD_RELOC_TILEPRO_IMM16_X0
6865 -- : BFD_RELOC_TILEPRO_IMM16_X1
6866 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO
6867 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO
6868 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI
6869 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI
6870 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA
6871 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA
6872 -- : BFD_RELOC_TILEPRO_IMM16_X0_PCREL
6873 -- : BFD_RELOC_TILEPRO_IMM16_X1_PCREL
6874 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL
6875 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL
6876 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL
6877 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL
6878 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL
6879 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL
6880 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT
6881 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT
6882 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO
6883 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO
6884 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI
6885 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI
6886 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA
6887 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA
6888 -- : BFD_RELOC_TILEPRO_MMSTART_X0
6889 -- : BFD_RELOC_TILEPRO_MMEND_X0
6890 -- : BFD_RELOC_TILEPRO_MMSTART_X1
6891 -- : BFD_RELOC_TILEPRO_MMEND_X1
6892 -- : BFD_RELOC_TILEPRO_SHAMT_X0
6893 -- : BFD_RELOC_TILEPRO_SHAMT_X1
6894 -- : BFD_RELOC_TILEPRO_SHAMT_Y0
6895 -- : BFD_RELOC_TILEPRO_SHAMT_Y1
6896 -- : BFD_RELOC_TILEPRO_TLS_GD_CALL
6897 -- : BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD
6898 -- : BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD
6899 -- : BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD
6900 -- : BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD
6901 -- : BFD_RELOC_TILEPRO_TLS_IE_LOAD
6902 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD
6903 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD
6904 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO
6905 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO
6906 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI
6907 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI
6908 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA
6909 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA
6910 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE
6911 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE
6912 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO
6913 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO
6914 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI
6915 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI
6916 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA
6917 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA
6918 -- : BFD_RELOC_TILEPRO_TLS_DTPMOD32
6919 -- : BFD_RELOC_TILEPRO_TLS_DTPOFF32
6920 -- : BFD_RELOC_TILEPRO_TLS_TPOFF32
6921 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE
6922 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE
6923 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO
6924 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO
6925 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI
6926 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI
6927 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA
6928 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA
6929     Tilera TILEPro Relocations.
6930 -- : BFD_RELOC_TILEGX_HW0
6931 -- : BFD_RELOC_TILEGX_HW1
6932 -- : BFD_RELOC_TILEGX_HW2
6933 -- : BFD_RELOC_TILEGX_HW3
6934 -- : BFD_RELOC_TILEGX_HW0_LAST
6935 -- : BFD_RELOC_TILEGX_HW1_LAST
6936 -- : BFD_RELOC_TILEGX_HW2_LAST
6937 -- : BFD_RELOC_TILEGX_COPY
6938 -- : BFD_RELOC_TILEGX_GLOB_DAT
6939 -- : BFD_RELOC_TILEGX_JMP_SLOT
6940 -- : BFD_RELOC_TILEGX_RELATIVE
6941 -- : BFD_RELOC_TILEGX_BROFF_X1
6942 -- : BFD_RELOC_TILEGX_JUMPOFF_X1
6943 -- : BFD_RELOC_TILEGX_JUMPOFF_X1_PLT
6944 -- : BFD_RELOC_TILEGX_IMM8_X0
6945 -- : BFD_RELOC_TILEGX_IMM8_Y0
6946 -- : BFD_RELOC_TILEGX_IMM8_X1
6947 -- : BFD_RELOC_TILEGX_IMM8_Y1
6948 -- : BFD_RELOC_TILEGX_DEST_IMM8_X1
6949 -- : BFD_RELOC_TILEGX_MT_IMM14_X1
6950 -- : BFD_RELOC_TILEGX_MF_IMM14_X1
6951 -- : BFD_RELOC_TILEGX_MMSTART_X0
6952 -- : BFD_RELOC_TILEGX_MMEND_X0
6953 -- : BFD_RELOC_TILEGX_SHAMT_X0
6954 -- : BFD_RELOC_TILEGX_SHAMT_X1
6955 -- : BFD_RELOC_TILEGX_SHAMT_Y0
6956 -- : BFD_RELOC_TILEGX_SHAMT_Y1
6957 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0
6958 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0
6959 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1
6960 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1
6961 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2
6962 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2
6963 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3
6964 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3
6965 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST
6966 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST
6967 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST
6968 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST
6969 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST
6970 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST
6971 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL
6972 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL
6973 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL
6974 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL
6975 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL
6976 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL
6977 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL
6978 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL
6979 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL
6980 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL
6981 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL
6982 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL
6983 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL
6984 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL
6985 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT
6986 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT
6987 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL
6988 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL
6989 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL
6990 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL
6991 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL
6992 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL
6993 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT
6994 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT
6995 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT
6996 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT
6997 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL
6998 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL
6999 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD
7000 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD
7001 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE
7002 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE
7003 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE
7004 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE
7005 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE
7006 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE
7007 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD
7008 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD
7009 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD
7010 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD
7011 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE
7012 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE
7013 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL
7014 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL
7015 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL
7016 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL
7017 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL
7018 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL
7019 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE
7020 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE
7021 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE
7022 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE
7023 -- : BFD_RELOC_TILEGX_TLS_DTPMOD64
7024 -- : BFD_RELOC_TILEGX_TLS_DTPOFF64
7025 -- : BFD_RELOC_TILEGX_TLS_TPOFF64
7026 -- : BFD_RELOC_TILEGX_TLS_DTPMOD32
7027 -- : BFD_RELOC_TILEGX_TLS_DTPOFF32
7028 -- : BFD_RELOC_TILEGX_TLS_TPOFF32
7029 -- : BFD_RELOC_TILEGX_TLS_GD_CALL
7030 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD
7031 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD
7032 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD
7033 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD
7034 -- : BFD_RELOC_TILEGX_TLS_IE_LOAD
7035 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD
7036 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD
7037 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD
7038 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD
7039     Tilera TILE-Gx Relocations.
7040 -- : BFD_RELOC_BPF_64
7041 -- : BFD_RELOC_BPF_32
7042 -- : BFD_RELOC_BPF_16
7043 -- : BFD_RELOC_BPF_DISP16
7044 -- : BFD_RELOC_BPF_DISP32
7045     Linux eBPF relocations.
7046 -- : BFD_RELOC_EPIPHANY_SIMM8
7047     Adapteva EPIPHANY - 8 bit signed pc-relative displacement
7048 -- : BFD_RELOC_EPIPHANY_SIMM24
7049     Adapteva EPIPHANY - 24 bit signed pc-relative displacement
7050 -- : BFD_RELOC_EPIPHANY_HIGH
7051     Adapteva EPIPHANY - 16 most-significant bits of absolute address
7052 -- : BFD_RELOC_EPIPHANY_LOW
7053     Adapteva EPIPHANY - 16 least-significant bits of absolute address
7054 -- : BFD_RELOC_EPIPHANY_SIMM11
7055     Adapteva EPIPHANY - 11 bit signed number - add/sub immediate
7056 -- : BFD_RELOC_EPIPHANY_IMM11
7057     Adapteva EPIPHANY - 11 bit sign-magnitude number (ld/st
7058     displacement)
7059 -- : BFD_RELOC_EPIPHANY_IMM8
7060     Adapteva EPIPHANY - 8 bit immediate for 16 bit mov instruction.
7061 -- : BFD_RELOC_VISIUM_HI16
7062 -- : BFD_RELOC_VISIUM_LO16
7063 -- : BFD_RELOC_VISIUM_IM16
7064 -- : BFD_RELOC_VISIUM_REL16
7065 -- : BFD_RELOC_VISIUM_HI16_PCREL
7066 -- : BFD_RELOC_VISIUM_LO16_PCREL
7067 -- : BFD_RELOC_VISIUM_IM16_PCREL
7068     Visium Relocations.
7069 -- : BFD_RELOC_WASM32_LEB128
7070 -- : BFD_RELOC_WASM32_LEB128_GOT
7071 -- : BFD_RELOC_WASM32_LEB128_GOT_CODE
7072 -- : BFD_RELOC_WASM32_LEB128_PLT
7073 -- : BFD_RELOC_WASM32_PLT_INDEX
7074 -- : BFD_RELOC_WASM32_ABS32_CODE
7075 -- : BFD_RELOC_WASM32_COPY
7076 -- : BFD_RELOC_WASM32_CODE_POINTER
7077 -- : BFD_RELOC_WASM32_INDEX
7078 -- : BFD_RELOC_WASM32_PLT_SIG
7079     WebAssembly relocations.
7080 -- : BFD_RELOC_CKCORE_NONE
7081 -- : BFD_RELOC_CKCORE_ADDR32
7082 -- : BFD_RELOC_CKCORE_PCREL_IMM8BY4
7083 -- : BFD_RELOC_CKCORE_PCREL_IMM11BY2
7084 -- : BFD_RELOC_CKCORE_PCREL_IMM4BY2
7085 -- : BFD_RELOC_CKCORE_PCREL32
7086 -- : BFD_RELOC_CKCORE_PCREL_JSR_IMM11BY2
7087 -- : BFD_RELOC_CKCORE_GNU_VTINHERIT
7088 -- : BFD_RELOC_CKCORE_GNU_VTENTRY
7089 -- : BFD_RELOC_CKCORE_RELATIVE
7090 -- : BFD_RELOC_CKCORE_COPY
7091 -- : BFD_RELOC_CKCORE_GLOB_DAT
7092 -- : BFD_RELOC_CKCORE_JUMP_SLOT
7093 -- : BFD_RELOC_CKCORE_GOTOFF
7094 -- : BFD_RELOC_CKCORE_GOTPC
7095 -- : BFD_RELOC_CKCORE_GOT32
7096 -- : BFD_RELOC_CKCORE_PLT32
7097 -- : BFD_RELOC_CKCORE_ADDRGOT
7098 -- : BFD_RELOC_CKCORE_ADDRPLT
7099 -- : BFD_RELOC_CKCORE_PCREL_IMM26BY2
7100 -- : BFD_RELOC_CKCORE_PCREL_IMM16BY2
7101 -- : BFD_RELOC_CKCORE_PCREL_IMM16BY4
7102 -- : BFD_RELOC_CKCORE_PCREL_IMM10BY2
7103 -- : BFD_RELOC_CKCORE_PCREL_IMM10BY4
7104 -- : BFD_RELOC_CKCORE_ADDR_HI16
7105 -- : BFD_RELOC_CKCORE_ADDR_LO16
7106 -- : BFD_RELOC_CKCORE_GOTPC_HI16
7107 -- : BFD_RELOC_CKCORE_GOTPC_LO16
7108 -- : BFD_RELOC_CKCORE_GOTOFF_HI16
7109 -- : BFD_RELOC_CKCORE_GOTOFF_LO16
7110 -- : BFD_RELOC_CKCORE_GOT12
7111 -- : BFD_RELOC_CKCORE_GOT_HI16
7112 -- : BFD_RELOC_CKCORE_GOT_LO16
7113 -- : BFD_RELOC_CKCORE_PLT12
7114 -- : BFD_RELOC_CKCORE_PLT_HI16
7115 -- : BFD_RELOC_CKCORE_PLT_LO16
7116 -- : BFD_RELOC_CKCORE_ADDRGOT_HI16
7117 -- : BFD_RELOC_CKCORE_ADDRGOT_LO16
7118 -- : BFD_RELOC_CKCORE_ADDRPLT_HI16
7119 -- : BFD_RELOC_CKCORE_ADDRPLT_LO16
7120 -- : BFD_RELOC_CKCORE_PCREL_JSR_IMM26BY2
7121 -- : BFD_RELOC_CKCORE_TOFFSET_LO16
7122 -- : BFD_RELOC_CKCORE_DOFFSET_LO16
7123 -- : BFD_RELOC_CKCORE_PCREL_IMM18BY2
7124 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18
7125 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18BY2
7126 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18BY4
7127 -- : BFD_RELOC_CKCORE_GOTOFF_IMM18
7128 -- : BFD_RELOC_CKCORE_GOT_IMM18BY4
7129 -- : BFD_RELOC_CKCORE_PLT_IMM18BY4
7130 -- : BFD_RELOC_CKCORE_PCREL_IMM7BY4
7131 -- : BFD_RELOC_CKCORE_TLS_LE32
7132 -- : BFD_RELOC_CKCORE_TLS_IE32
7133 -- : BFD_RELOC_CKCORE_TLS_GD32
7134 -- : BFD_RELOC_CKCORE_TLS_LDM32
7135 -- : BFD_RELOC_CKCORE_TLS_LDO32
7136 -- : BFD_RELOC_CKCORE_TLS_DTPMOD32
7137 -- : BFD_RELOC_CKCORE_TLS_DTPOFF32
7138 -- : BFD_RELOC_CKCORE_TLS_TPOFF32
7139 -- : BFD_RELOC_CKCORE_PCREL_FLRW_IMM8BY4
7140 -- : BFD_RELOC_CKCORE_NOJSRI
7141 -- : BFD_RELOC_CKCORE_CALLGRAPH
7142 -- : BFD_RELOC_CKCORE_IRELATIVE
7143 -- : BFD_RELOC_CKCORE_PCREL_BLOOP_IMM4BY4
7144 -- : BFD_RELOC_CKCORE_PCREL_BLOOP_IMM12BY4
7145     C-SKY relocations.
7146 -- : BFD_RELOC_S12Z_OPR
7147     S12Z relocations.
7148
7149
7150     typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
7151
71522.10.2.2 'bfd_reloc_type_lookup'
7153................................
7154
7155*Synopsis*
7156     reloc_howto_type *bfd_reloc_type_lookup
7157        (bfd *abfd, bfd_reloc_code_real_type code);
7158     reloc_howto_type *bfd_reloc_name_lookup
7159        (bfd *abfd, const char *reloc_name);
7160   *Description*
7161Return a pointer to a howto structure which, when invoked, will perform
7162the relocation CODE on data from the architecture noted.
7163
71642.10.2.3 'bfd_default_reloc_type_lookup'
7165........................................
7166
7167*Synopsis*
7168     reloc_howto_type *bfd_default_reloc_type_lookup
7169        (bfd *abfd, bfd_reloc_code_real_type  code);
7170   *Description*
7171Provides a default relocation lookup routine for any architecture.
7172
71732.10.2.4 'bfd_get_reloc_code_name'
7174..................................
7175
7176*Synopsis*
7177     const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code);
7178   *Description*
7179Provides a printable name for the supplied relocation code.  Useful
7180mainly for printing error messages.
7181
71822.10.2.5 'bfd_generic_relax_section'
7183....................................
7184
7185*Synopsis*
7186     bfd_boolean bfd_generic_relax_section
7187        (bfd *abfd,
7188         asection *section,
7189         struct bfd_link_info *,
7190         bfd_boolean *);
7191   *Description*
7192Provides default handling for relaxing for back ends which don't do
7193relaxing.
7194
71952.10.2.6 'bfd_generic_gc_sections'
7196..................................
7197
7198*Synopsis*
7199     bfd_boolean bfd_generic_gc_sections
7200        (bfd *, struct bfd_link_info *);
7201   *Description*
7202Provides default handling for relaxing for back ends which don't do
7203section gc - i.e., does nothing.
7204
72052.10.2.7 'bfd_generic_lookup_section_flags'
7206...........................................
7207
7208*Synopsis*
7209     bfd_boolean bfd_generic_lookup_section_flags
7210        (struct bfd_link_info *, struct flag_info *, asection *);
7211   *Description*
7212Provides default handling for section flags lookup - i.e., does nothing.
7213Returns FALSE if the section should be omitted, otherwise TRUE.
7214
72152.10.2.8 'bfd_generic_merge_sections'
7216.....................................
7217
7218*Synopsis*
7219     bfd_boolean bfd_generic_merge_sections
7220        (bfd *, struct bfd_link_info *);
7221   *Description*
7222Provides default handling for SEC_MERGE section merging for back ends
7223which don't have SEC_MERGE support - i.e., does nothing.
7224
72252.10.2.9 'bfd_generic_get_relocated_section_contents'
7226.....................................................
7227
7228*Synopsis*
7229     bfd_byte *bfd_generic_get_relocated_section_contents
7230        (bfd *abfd,
7231         struct bfd_link_info *link_info,
7232         struct bfd_link_order *link_order,
7233         bfd_byte *data,
7234         bfd_boolean relocatable,
7235         asymbol **symbols);
7236   *Description*
7237Provides default handling of relocation effort for back ends which can't
7238be bothered to do it efficiently.
7239
72402.10.2.10 '_bfd_generic_set_reloc'
7241..................................
7242
7243*Synopsis*
7244     void _bfd_generic_set_reloc
7245        (bfd *abfd,
7246         sec_ptr section,
7247         arelent **relptr,
7248         unsigned int count);
7249   *Description*
7250Installs a new set of internal relocations in SECTION.
7251
72522.10.2.11 '_bfd_unrecognized_reloc'
7253...................................
7254
7255*Synopsis*
7256     bfd_boolean _bfd_unrecognized_reloc
7257        (bfd * abfd,
7258         sec_ptr section,
7259         unsigned int r_type);
7260   *Description*
7261Reports an unrecognized reloc.  Written as a function in order to reduce
7262code duplication.  Returns FALSE so that it can be called from a return
7263statement.
7264
7265
7266File: bfd.info,  Node: Core Files,  Next: Targets,  Prev: Relocations,  Up: BFD front end
7267
72682.11 Core files
7269===============
7270
72712.11.1 Core file functions
7272--------------------------
7273
7274*Description*
7275These are functions pertaining to core files.
7276
72772.11.1.1 'bfd_core_file_failing_command'
7278........................................
7279
7280*Synopsis*
7281     const char *bfd_core_file_failing_command (bfd *abfd);
7282   *Description*
7283Return a read-only string explaining which program was running when it
7284failed and produced the core file ABFD.
7285
72862.11.1.2 'bfd_core_file_failing_signal'
7287.......................................
7288
7289*Synopsis*
7290     int bfd_core_file_failing_signal (bfd *abfd);
7291   *Description*
7292Returns the signal number which caused the core dump which generated the
7293file the BFD ABFD is attached to.
7294
72952.11.1.3 'bfd_core_file_pid'
7296............................
7297
7298*Synopsis*
7299     int bfd_core_file_pid (bfd *abfd);
7300   *Description*
7301Returns the PID of the process the core dump the BFD ABFD is attached to
7302was generated from.
7303
73042.11.1.4 'core_file_matches_executable_p'
7305.........................................
7306
7307*Synopsis*
7308     bfd_boolean core_file_matches_executable_p
7309        (bfd *core_bfd, bfd *exec_bfd);
7310   *Description*
7311Return 'TRUE' if the core file attached to CORE_BFD was generated by a
7312run of the executable file attached to EXEC_BFD, 'FALSE' otherwise.
7313
73142.11.1.5 'generic_core_file_matches_executable_p'
7315.................................................
7316
7317*Synopsis*
7318     bfd_boolean generic_core_file_matches_executable_p
7319        (bfd *core_bfd, bfd *exec_bfd);
7320   *Description*
7321Return TRUE if the core file attached to CORE_BFD was generated by a run
7322of the executable file attached to EXEC_BFD.  The match is based on
7323executable basenames only.
7324
7325   Note: When not able to determine the core file failing command or the
7326executable name, we still return TRUE even though we're not sure that
7327core file and executable match.  This is to avoid generating a false
7328warning in situations where we really don't know whether they match or
7329not.
7330
7331
7332File: bfd.info,  Node: Targets,  Next: Architectures,  Prev: Core Files,  Up: BFD front end
7333
73342.12 Targets
7335============
7336
7337*Description*
7338Each port of BFD to a different machine requires the creation of a
7339target back end.  All the back end provides to the root part of BFD is a
7340structure containing pointers to functions which perform certain low
7341level operations on files.  BFD translates the applications's requests
7342through a pointer into calls to the back end routines.
7343
7344   When a file is opened with 'bfd_openr', its format and target are
7345unknown.  BFD uses various mechanisms to determine how to interpret the
7346file.  The operations performed are:
7347
7348   * Create a BFD by calling the internal routine '_bfd_new_bfd', then
7349     call 'bfd_find_target' with the target string supplied to
7350     'bfd_openr' and the new BFD pointer.
7351
7352   * If a null target string was provided to 'bfd_find_target', look up
7353     the environment variable 'GNUTARGET' and use that as the target
7354     string.
7355
7356   * If the target string is still 'NULL', or the target string is
7357     'default', then use the first item in the target vector as the
7358     target type, and set 'target_defaulted' in the BFD to cause
7359     'bfd_check_format' to loop through all the targets.  *Note
7360     bfd_target::.  *Note Formats::.
7361
7362   * Otherwise, inspect the elements in the target vector one by one,
7363     until a match on target name is found.  When found, use it.
7364
7365   * Otherwise return the error 'bfd_error_invalid_target' to
7366     'bfd_openr'.
7367
7368   * 'bfd_openr' attempts to open the file using 'bfd_open_file', and
7369     returns the BFD.
7370   Once the BFD has been opened and the target selected, the file format
7371may be determined.  This is done by calling 'bfd_check_format' on the
7372BFD with a suggested format.  If 'target_defaulted' has been set, each
7373possible target type is tried to see if it recognizes the specified
7374format.  'bfd_check_format' returns 'TRUE' when the caller guesses
7375right.
7376* Menu:
7377
7378* bfd_target::
7379
7380
7381File: bfd.info,  Node: bfd_target,  Prev: Targets,  Up: Targets
7382
73832.12.1 bfd_target
7384-----------------
7385
7386*Description*
7387This structure contains everything that BFD knows about a target.  It
7388includes things like its byte order, name, and which routines to call to
7389do various operations.
7390
7391   Every BFD points to a target structure with its 'xvec' member.
7392
7393   The macros below are used to dispatch to functions through the
7394'bfd_target' vector.  They are used in a number of macros further down
7395in 'bfd.h', and are also used when calling various routines by hand
7396inside the BFD implementation.  The ARGLIST argument must be
7397parenthesized; it contains all the arguments to the called function.
7398
7399   They make the documentation (more) unpleasant to read, so if someone
7400wants to fix this and not break the above, please do.
7401     #define BFD_SEND(bfd, message, arglist) \
7402       ((*((bfd)->xvec->message)) arglist)
7403
7404     #ifdef DEBUG_BFD_SEND
7405     #undef BFD_SEND
7406     #define BFD_SEND(bfd, message, arglist) \
7407       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7408         ((*((bfd)->xvec->message)) arglist) : \
7409         (bfd_assert (__FILE__,__LINE__), NULL))
7410     #endif
7411   For operations which index on the BFD format:
7412     #define BFD_SEND_FMT(bfd, message, arglist) \
7413       (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
7414
7415     #ifdef DEBUG_BFD_SEND
7416     #undef BFD_SEND_FMT
7417     #define BFD_SEND_FMT(bfd, message, arglist) \
7418       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7419        (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
7420        (bfd_assert (__FILE__,__LINE__), NULL))
7421     #endif
7422
7423     /* Defined to TRUE if unused section symbol should be kept.  */
7424     #ifndef TARGET_KEEP_UNUSED_SECTION_SYMBOLS
7425     #define TARGET_KEEP_UNUSED_SECTION_SYMBOLS TRUE
7426     #endif
7427
7428   This is the structure which defines the type of BFD this is.  The
7429'xvec' member of the struct 'bfd' itself points here.  Each module that
7430implements access to a different target under BFD, defines one of these.
7431
7432   FIXME, these names should be rationalised with the names of the entry
7433points which call them.  Too bad we can't have one macro to define them
7434both!
7435     enum bfd_flavour
7436     {
7437       /* N.B. Update bfd_flavour_name if you change this.  */
7438       bfd_target_unknown_flavour,
7439       bfd_target_aout_flavour,
7440       bfd_target_coff_flavour,
7441       bfd_target_ecoff_flavour,
7442       bfd_target_xcoff_flavour,
7443       bfd_target_elf_flavour,
7444       bfd_target_tekhex_flavour,
7445       bfd_target_srec_flavour,
7446       bfd_target_verilog_flavour,
7447       bfd_target_ihex_flavour,
7448       bfd_target_som_flavour,
7449       bfd_target_os9k_flavour,
7450       bfd_target_versados_flavour,
7451       bfd_target_msdos_flavour,
7452       bfd_target_ovax_flavour,
7453       bfd_target_evax_flavour,
7454       bfd_target_mmo_flavour,
7455       bfd_target_mach_o_flavour,
7456       bfd_target_pef_flavour,
7457       bfd_target_pef_xlib_flavour,
7458       bfd_target_sym_flavour
7459     };
7460
7461     enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
7462
7463     /* Forward declaration.  */
7464     typedef struct bfd_link_info _bfd_link_info;
7465
7466     /* Forward declaration.  */
7467     typedef struct flag_info flag_info;
7468
7469     typedef void (*bfd_cleanup) (bfd *);
7470
7471     typedef struct bfd_target
7472     {
7473       /* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  */
7474       const char *name;
7475
7476      /* The "flavour" of a back end is a general indication about
7477         the contents of a file.  */
7478       enum bfd_flavour flavour;
7479
7480       /* The order of bytes within the data area of a file.  */
7481       enum bfd_endian byteorder;
7482
7483      /* The order of bytes within the header parts of a file.  */
7484       enum bfd_endian header_byteorder;
7485
7486       /* A mask of all the flags which an executable may have set -
7487          from the set BFD_NO_FLAGS, HAS_RELOC, ...D_PAGED.  */
7488       flagword object_flags;
7489
7490      /* A mask of all the flags which a section may have set - from
7491         the set SEC_NO_FLAGS, SEC_ALLOC, ...SET_NEVER_LOAD.  */
7492       flagword section_flags;
7493
7494      /* The character normally found at the front of a symbol.
7495         (if any), perhaps `_'.  */
7496       char symbol_leading_char;
7497
7498      /* The pad character for file names within an archive header.  */
7499       char ar_pad_char;
7500
7501       /* The maximum number of characters in an archive header.  */
7502       unsigned char ar_max_namelen;
7503
7504       /* How well this target matches, used to select between various
7505          possible targets when more than one target matches.  */
7506       unsigned char match_priority;
7507
7508      /* TRUE if unused section symbols should be kept.  */
7509       bfd_boolean keep_unused_section_symbols;
7510
7511       /* Entries for byte swapping for data. These are different from the
7512          other entry points, since they don't take a BFD as the first argument.
7513          Certain other handlers could do the same.  */
7514       bfd_uint64_t   (*bfd_getx64) (const void *);
7515       bfd_int64_t    (*bfd_getx_signed_64) (const void *);
7516       void           (*bfd_putx64) (bfd_uint64_t, void *);
7517       bfd_vma        (*bfd_getx32) (const void *);
7518       bfd_signed_vma (*bfd_getx_signed_32) (const void *);
7519       void           (*bfd_putx32) (bfd_vma, void *);
7520       bfd_vma        (*bfd_getx16) (const void *);
7521       bfd_signed_vma (*bfd_getx_signed_16) (const void *);
7522       void           (*bfd_putx16) (bfd_vma, void *);
7523
7524       /* Byte swapping for the headers.  */
7525       bfd_uint64_t   (*bfd_h_getx64) (const void *);
7526       bfd_int64_t    (*bfd_h_getx_signed_64) (const void *);
7527       void           (*bfd_h_putx64) (bfd_uint64_t, void *);
7528       bfd_vma        (*bfd_h_getx32) (const void *);
7529       bfd_signed_vma (*bfd_h_getx_signed_32) (const void *);
7530       void           (*bfd_h_putx32) (bfd_vma, void *);
7531       bfd_vma        (*bfd_h_getx16) (const void *);
7532       bfd_signed_vma (*bfd_h_getx_signed_16) (const void *);
7533       void           (*bfd_h_putx16) (bfd_vma, void *);
7534
7535       /* Format dependent routines: these are vectors of entry points
7536          within the target vector structure, one for each format to check.  */
7537
7538       /* Check the format of a file being read.  Return a bfd_cleanup on
7539          success or zero on failure.  */
7540       bfd_cleanup (*_bfd_check_format[bfd_type_end]) (bfd *);
7541
7542       /* Set the format of a file being written.  */
7543       bfd_boolean (*_bfd_set_format[bfd_type_end]) (bfd *);
7544
7545       /* Write cached information into a file being written, at bfd_close.  */
7546       bfd_boolean (*_bfd_write_contents[bfd_type_end]) (bfd *);
7547
7548   The general target vector.  These vectors are initialized using the
7549BFD_JUMP_TABLE macros.
7550
7551       /* Generic entry points.  */
7552     #define BFD_JUMP_TABLE_GENERIC(NAME) \
7553       NAME##_close_and_cleanup, \
7554       NAME##_bfd_free_cached_info, \
7555       NAME##_new_section_hook, \
7556       NAME##_get_section_contents, \
7557       NAME##_get_section_contents_in_window
7558
7559       /* Called when the BFD is being closed to do any necessary cleanup.  */
7560       bfd_boolean (*_close_and_cleanup) (bfd *);
7561       /* Ask the BFD to free all cached information.  */
7562       bfd_boolean (*_bfd_free_cached_info) (bfd *);
7563       /* Called when a new section is created.  */
7564       bfd_boolean (*_new_section_hook) (bfd *, sec_ptr);
7565       /* Read the contents of a section.  */
7566       bfd_boolean (*_bfd_get_section_contents) (bfd *, sec_ptr, void *, file_ptr,
7567                                                 bfd_size_type);
7568       bfd_boolean (*_bfd_get_section_contents_in_window) (bfd *, sec_ptr,
7569                                                           bfd_window *, file_ptr,
7570                                                           bfd_size_type);
7571
7572       /* Entry points to copy private data.  */
7573     #define BFD_JUMP_TABLE_COPY(NAME) \
7574       NAME##_bfd_copy_private_bfd_data, \
7575       NAME##_bfd_merge_private_bfd_data, \
7576       _bfd_generic_init_private_section_data, \
7577       NAME##_bfd_copy_private_section_data, \
7578       NAME##_bfd_copy_private_symbol_data, \
7579       NAME##_bfd_copy_private_header_data, \
7580       NAME##_bfd_set_private_flags, \
7581       NAME##_bfd_print_private_bfd_data
7582
7583       /* Called to copy BFD general private data from one object file
7584          to another.  */
7585       bfd_boolean (*_bfd_copy_private_bfd_data) (bfd *, bfd *);
7586       /* Called to merge BFD general private data from one object file
7587          to a common output file when linking.  */
7588       bfd_boolean (*_bfd_merge_private_bfd_data) (bfd *, struct bfd_link_info *);
7589       /* Called to initialize BFD private section data from one object file
7590          to another.  */
7591     #define bfd_init_private_section_data(ibfd, isec, obfd, osec, link_info) \
7592            BFD_SEND (obfd, _bfd_init_private_section_data, \
7593                      (ibfd, isec, obfd, osec, link_info))
7594       bfd_boolean (*_bfd_init_private_section_data) (bfd *, sec_ptr, bfd *,
7595                                                      sec_ptr,
7596                                                      struct bfd_link_info *);
7597       /* Called to copy BFD private section data from one object file
7598          to another.  */
7599       bfd_boolean (*_bfd_copy_private_section_data) (bfd *, sec_ptr, bfd *,
7600                                                      sec_ptr);
7601       /* Called to copy BFD private symbol data from one symbol
7602          to another.  */
7603       bfd_boolean (*_bfd_copy_private_symbol_data) (bfd *, asymbol *, bfd *,
7604                                                     asymbol *);
7605       /* Called to copy BFD private header data from one object file
7606          to another.  */
7607       bfd_boolean (*_bfd_copy_private_header_data) (bfd *, bfd *);
7608       /* Called to set private backend flags.  */
7609       bfd_boolean (*_bfd_set_private_flags) (bfd *, flagword);
7610
7611       /* Called to print private BFD data.  */
7612       bfd_boolean (*_bfd_print_private_bfd_data) (bfd *, void *);
7613
7614       /* Core file entry points.  */
7615     #define BFD_JUMP_TABLE_CORE(NAME) \
7616       NAME##_core_file_failing_command, \
7617       NAME##_core_file_failing_signal, \
7618       NAME##_core_file_matches_executable_p, \
7619       NAME##_core_file_pid
7620
7621       char *      (*_core_file_failing_command) (bfd *);
7622       int         (*_core_file_failing_signal) (bfd *);
7623       bfd_boolean (*_core_file_matches_executable_p) (bfd *, bfd *);
7624       int         (*_core_file_pid) (bfd *);
7625
7626       /* Archive entry points.  */
7627     #define BFD_JUMP_TABLE_ARCHIVE(NAME) \
7628       NAME##_slurp_armap, \
7629       NAME##_slurp_extended_name_table, \
7630       NAME##_construct_extended_name_table, \
7631       NAME##_truncate_arname, \
7632       NAME##_write_armap, \
7633       NAME##_read_ar_hdr, \
7634       NAME##_write_ar_hdr, \
7635       NAME##_openr_next_archived_file, \
7636       NAME##_get_elt_at_index, \
7637       NAME##_generic_stat_arch_elt, \
7638       NAME##_update_armap_timestamp
7639
7640       bfd_boolean (*_bfd_slurp_armap) (bfd *);
7641       bfd_boolean (*_bfd_slurp_extended_name_table) (bfd *);
7642       bfd_boolean (*_bfd_construct_extended_name_table) (bfd *, char **,
7643                                                          bfd_size_type *,
7644                                                          const char **);
7645       void        (*_bfd_truncate_arname) (bfd *, const char *, char *);
7646       bfd_boolean (*write_armap) (bfd *, unsigned int, struct orl *,
7647                                   unsigned int, int);
7648       void *      (*_bfd_read_ar_hdr_fn) (bfd *);
7649       bfd_boolean (*_bfd_write_ar_hdr_fn) (bfd *, bfd *);
7650       bfd *       (*openr_next_archived_file) (bfd *, bfd *);
7651     #define bfd_get_elt_at_index(b,i) \
7652            BFD_SEND (b, _bfd_get_elt_at_index, (b,i))
7653       bfd *       (*_bfd_get_elt_at_index) (bfd *, symindex);
7654       int         (*_bfd_stat_arch_elt) (bfd *, struct stat *);
7655       bfd_boolean (*_bfd_update_armap_timestamp) (bfd *);
7656
7657       /* Entry points used for symbols.  */
7658     #define BFD_JUMP_TABLE_SYMBOLS(NAME) \
7659       NAME##_get_symtab_upper_bound, \
7660       NAME##_canonicalize_symtab, \
7661       NAME##_make_empty_symbol, \
7662       NAME##_print_symbol, \
7663       NAME##_get_symbol_info, \
7664       NAME##_get_symbol_version_string, \
7665       NAME##_bfd_is_local_label_name, \
7666       NAME##_bfd_is_target_special_symbol, \
7667       NAME##_get_lineno, \
7668       NAME##_find_nearest_line, \
7669       NAME##_find_line, \
7670       NAME##_find_inliner_info, \
7671       NAME##_bfd_make_debug_symbol, \
7672       NAME##_read_minisymbols, \
7673       NAME##_minisymbol_to_symbol
7674
7675       long        (*_bfd_get_symtab_upper_bound) (bfd *);
7676       long        (*_bfd_canonicalize_symtab) (bfd *, struct bfd_symbol **);
7677       struct bfd_symbol *
7678                   (*_bfd_make_empty_symbol) (bfd *);
7679       void        (*_bfd_print_symbol) (bfd *, void *, struct bfd_symbol *,
7680                                         bfd_print_symbol_type);
7681     #define bfd_print_symbol(b,p,s,e) \
7682            BFD_SEND (b, _bfd_print_symbol, (b,p,s,e))
7683       void        (*_bfd_get_symbol_info) (bfd *, struct bfd_symbol *,
7684                                            symbol_info *);
7685     #define bfd_get_symbol_info(b,p,e) \
7686            BFD_SEND (b, _bfd_get_symbol_info, (b,p,e))
7687       const char *(*_bfd_get_symbol_version_string) (bfd *, struct bfd_symbol *,
7688                                                      bfd_boolean,
7689                                                      bfd_boolean *);
7690     #define bfd_get_symbol_version_string(b,s,p,h) \
7691            BFD_SEND (b, _bfd_get_symbol_version_string, (b,s,p,h))
7692       bfd_boolean (*_bfd_is_local_label_name) (bfd *, const char *);
7693       bfd_boolean (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
7694       alent *     (*_get_lineno) (bfd *, struct bfd_symbol *);
7695       bfd_boolean (*_bfd_find_nearest_line) (bfd *, struct bfd_symbol **,
7696                                              struct bfd_section *, bfd_vma,
7697                                              const char **, const char **,
7698                                              unsigned int *, unsigned int *);
7699       bfd_boolean (*_bfd_find_line) (bfd *, struct bfd_symbol **,
7700                                      struct bfd_symbol *, const char **,
7701                                      unsigned int *);
7702       bfd_boolean (*_bfd_find_inliner_info)
7703         (bfd *, const char **, const char **, unsigned int *);
7704      /* Back-door to allow format-aware applications to create debug symbols
7705         while using BFD for everything else.  Currently used by the assembler
7706         when creating COFF files.  */
7707       asymbol *   (*_bfd_make_debug_symbol) (bfd *, void *, unsigned long size);
7708     #define bfd_read_minisymbols(b, d, m, s) \
7709            BFD_SEND (b, _read_minisymbols, (b, d, m, s))
7710       long        (*_read_minisymbols) (bfd *, bfd_boolean, void **,
7711                                         unsigned int *);
7712     #define bfd_minisymbol_to_symbol(b, d, m, f) \
7713            BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
7714       asymbol *   (*_minisymbol_to_symbol) (bfd *, bfd_boolean, const void *,
7715                                             asymbol *);
7716
7717       /* Routines for relocs.  */
7718     #define BFD_JUMP_TABLE_RELOCS(NAME) \
7719       NAME##_get_reloc_upper_bound, \
7720       NAME##_canonicalize_reloc, \
7721       NAME##_set_reloc, \
7722       NAME##_bfd_reloc_type_lookup, \
7723       NAME##_bfd_reloc_name_lookup
7724
7725       long        (*_get_reloc_upper_bound) (bfd *, sec_ptr);
7726       long        (*_bfd_canonicalize_reloc) (bfd *, sec_ptr, arelent **,
7727                                               struct bfd_symbol **);
7728       void        (*_bfd_set_reloc) (bfd *, sec_ptr, arelent **, unsigned int);
7729       /* See documentation on reloc types.  */
7730       reloc_howto_type *
7731                   (*reloc_type_lookup) (bfd *, bfd_reloc_code_real_type);
7732       reloc_howto_type *
7733                   (*reloc_name_lookup) (bfd *, const char *);
7734
7735       /* Routines used when writing an object file.  */
7736     #define BFD_JUMP_TABLE_WRITE(NAME) \
7737       NAME##_set_arch_mach, \
7738       NAME##_set_section_contents
7739
7740       bfd_boolean (*_bfd_set_arch_mach) (bfd *, enum bfd_architecture,
7741                                          unsigned long);
7742       bfd_boolean (*_bfd_set_section_contents) (bfd *, sec_ptr, const void *,
7743                                                 file_ptr, bfd_size_type);
7744
7745       /* Routines used by the linker.  */
7746     #define BFD_JUMP_TABLE_LINK(NAME) \
7747       NAME##_sizeof_headers, \
7748       NAME##_bfd_get_relocated_section_contents, \
7749       NAME##_bfd_relax_section, \
7750       NAME##_bfd_link_hash_table_create, \
7751       NAME##_bfd_link_add_symbols, \
7752       NAME##_bfd_link_just_syms, \
7753       NAME##_bfd_copy_link_hash_symbol_type, \
7754       NAME##_bfd_final_link, \
7755       NAME##_bfd_link_split_section, \
7756       NAME##_bfd_link_check_relocs, \
7757       NAME##_bfd_gc_sections, \
7758       NAME##_bfd_lookup_section_flags, \
7759       NAME##_bfd_merge_sections, \
7760       NAME##_bfd_is_group_section, \
7761       NAME##_bfd_group_name, \
7762       NAME##_bfd_discard_group, \
7763       NAME##_section_already_linked, \
7764       NAME##_bfd_define_common_symbol, \
7765       NAME##_bfd_link_hide_symbol, \
7766       NAME##_bfd_define_start_stop
7767
7768       int         (*_bfd_sizeof_headers) (bfd *, struct bfd_link_info *);
7769       bfd_byte *  (*_bfd_get_relocated_section_contents) (bfd *,
7770                                                           struct bfd_link_info *,
7771                                                           struct bfd_link_order *,
7772                                                           bfd_byte *, bfd_boolean,
7773                                                           struct bfd_symbol **);
7774
7775       bfd_boolean (*_bfd_relax_section) (bfd *, struct bfd_section *,
7776                                          struct bfd_link_info *, bfd_boolean *);
7777
7778       /* Create a hash table for the linker.  Different backends store
7779          different information in this table.  */
7780       struct bfd_link_hash_table *
7781                   (*_bfd_link_hash_table_create) (bfd *);
7782
7783       /* Add symbols from this object file into the hash table.  */
7784       bfd_boolean (*_bfd_link_add_symbols) (bfd *, struct bfd_link_info *);
7785
7786       /* Indicate that we are only retrieving symbol values from this section.  */
7787       void        (*_bfd_link_just_syms) (asection *, struct bfd_link_info *);
7788
7789       /* Copy the symbol type and other attributes for a linker script
7790          assignment of one symbol to another.  */
7791     #define bfd_copy_link_hash_symbol_type(b, t, f) \
7792            BFD_SEND (b, _bfd_copy_link_hash_symbol_type, (b, t, f))
7793       void        (*_bfd_copy_link_hash_symbol_type) (bfd *,
7794                                                       struct bfd_link_hash_entry *,
7795                                                       struct bfd_link_hash_entry *);
7796
7797       /* Do a link based on the link_order structures attached to each
7798          section of the BFD.  */
7799       bfd_boolean (*_bfd_final_link) (bfd *, struct bfd_link_info *);
7800
7801       /* Should this section be split up into smaller pieces during linking.  */
7802       bfd_boolean (*_bfd_link_split_section) (bfd *, struct bfd_section *);
7803
7804       /* Check the relocations in the bfd for validity.  */
7805       bfd_boolean (* _bfd_link_check_relocs)(bfd *, struct bfd_link_info *);
7806
7807       /* Remove sections that are not referenced from the output.  */
7808       bfd_boolean (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
7809
7810       /* Sets the bitmask of allowed and disallowed section flags.  */
7811       bfd_boolean (*_bfd_lookup_section_flags) (struct bfd_link_info *,
7812                                                 struct flag_info *, asection *);
7813
7814       /* Attempt to merge SEC_MERGE sections.  */
7815       bfd_boolean (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
7816
7817       /* Is this section a member of a group?  */
7818       bfd_boolean (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
7819
7820       /* The group name, if section is a member of a group.  */
7821       const char *(*_bfd_group_name) (bfd *, const struct bfd_section *);
7822
7823       /* Discard members of a group.  */
7824       bfd_boolean (*_bfd_discard_group) (bfd *, struct bfd_section *);
7825
7826       /* Check if SEC has been already linked during a reloceatable or
7827          final link.  */
7828       bfd_boolean (*_section_already_linked) (bfd *, asection *,
7829                                               struct bfd_link_info *);
7830
7831       /* Define a common symbol.  */
7832       bfd_boolean (*_bfd_define_common_symbol) (bfd *, struct bfd_link_info *,
7833                                                 struct bfd_link_hash_entry *);
7834
7835       /* Hide a symbol.  */
7836       void (*_bfd_link_hide_symbol) (bfd *, struct bfd_link_info *,
7837                                      struct bfd_link_hash_entry *);
7838
7839       /* Define a __start, __stop, .startof. or .sizeof. symbol.  */
7840       struct bfd_link_hash_entry *
7841                   (*_bfd_define_start_stop) (struct bfd_link_info *, const char *,
7842                                              asection *);
7843
7844       /* Routines to handle dynamic symbols and relocs.  */
7845     #define BFD_JUMP_TABLE_DYNAMIC(NAME) \
7846       NAME##_get_dynamic_symtab_upper_bound, \
7847       NAME##_canonicalize_dynamic_symtab, \
7848       NAME##_get_synthetic_symtab, \
7849       NAME##_get_dynamic_reloc_upper_bound, \
7850       NAME##_canonicalize_dynamic_reloc
7851
7852       /* Get the amount of memory required to hold the dynamic symbols.  */
7853       long        (*_bfd_get_dynamic_symtab_upper_bound) (bfd *);
7854       /* Read in the dynamic symbols.  */
7855       long        (*_bfd_canonicalize_dynamic_symtab) (bfd *, struct bfd_symbol **);
7856       /* Create synthetized symbols.  */
7857       long        (*_bfd_get_synthetic_symtab) (bfd *, long, struct bfd_symbol **,
7858                                                 long, struct bfd_symbol **,
7859                                                 struct bfd_symbol **);
7860       /* Get the amount of memory required to hold the dynamic relocs.  */
7861       long        (*_bfd_get_dynamic_reloc_upper_bound) (bfd *);
7862       /* Read in the dynamic relocs.  */
7863       long        (*_bfd_canonicalize_dynamic_reloc) (bfd *, arelent **,
7864                                                       struct bfd_symbol **);
7865
7866   A pointer to an alternative bfd_target in case the current one is not
7867satisfactory.  This can happen when the target cpu supports both big and
7868little endian code, and target chosen by the linker has the wrong
7869endianness.  The function open_output() in ld/ldlang.c uses this field
7870to find an alternative output format that is suitable.
7871       /* Opposite endian version of this target.  */
7872       const struct bfd_target *alternative_target;
7873
7874       /* Data for use by back-end routines, which isn't
7875          generic enough to belong in this structure.  */
7876       const void *backend_data;
7877
7878     } bfd_target;
7879
7880     static inline const char *
7881     bfd_get_target (const bfd *abfd)
7882     {
7883       return abfd->xvec->name;
7884     }
7885
7886     static inline enum bfd_flavour
7887     bfd_get_flavour (const bfd *abfd)
7888     {
7889       return abfd->xvec->flavour;
7890     }
7891
7892     static inline flagword
7893     bfd_applicable_file_flags (const bfd *abfd)
7894     {
7895       return abfd->xvec->object_flags;
7896     }
7897
7898     static inline bfd_boolean
7899     bfd_family_coff (const bfd *abfd)
7900     {
7901       return (bfd_get_flavour (abfd) == bfd_target_coff_flavour
7902               || bfd_get_flavour (abfd) == bfd_target_xcoff_flavour);
7903     }
7904
7905     static inline bfd_boolean
7906     bfd_big_endian (const bfd *abfd)
7907     {
7908       return abfd->xvec->byteorder == BFD_ENDIAN_BIG;
7909     }
7910     static inline bfd_boolean
7911     bfd_little_endian (const bfd *abfd)
7912     {
7913       return abfd->xvec->byteorder == BFD_ENDIAN_LITTLE;
7914     }
7915
7916     static inline bfd_boolean
7917     bfd_header_big_endian (const bfd *abfd)
7918     {
7919       return abfd->xvec->header_byteorder == BFD_ENDIAN_BIG;
7920     }
7921
7922     static inline bfd_boolean
7923     bfd_header_little_endian (const bfd *abfd)
7924     {
7925       return abfd->xvec->header_byteorder == BFD_ENDIAN_LITTLE;
7926     }
7927
7928     static inline flagword
7929     bfd_applicable_section_flags (const bfd *abfd)
7930     {
7931       return abfd->xvec->section_flags;
7932     }
7933
7934     static inline char
7935     bfd_get_symbol_leading_char (const bfd *abfd)
7936     {
7937       return abfd->xvec->symbol_leading_char;
7938     }
7939
7940     static inline enum bfd_flavour
7941     bfd_asymbol_flavour (const asymbol *sy)
7942     {
7943       if ((sy->flags & BSF_SYNTHETIC) != 0)
7944         return bfd_target_unknown_flavour;
7945       return sy->the_bfd->xvec->flavour;
7946     }
7947
7948     static inline bfd_boolean
7949     bfd_keep_unused_section_symbols (const bfd *abfd)
7950     {
7951       return abfd->xvec->keep_unused_section_symbols;
7952     }
7953
79542.12.1.1 'bfd_set_default_target'
7955.................................
7956
7957*Synopsis*
7958     bfd_boolean bfd_set_default_target (const char *name);
7959   *Description*
7960Set the default target vector to use when recognizing a BFD. This takes
7961the name of the target, which may be a BFD target name or a
7962configuration triplet.
7963
79642.12.1.2 'bfd_find_target'
7965..........................
7966
7967*Synopsis*
7968     const bfd_target *bfd_find_target (const char *target_name, bfd *abfd);
7969   *Description*
7970Return a pointer to the transfer vector for the object target named
7971TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
7972environment variable 'GNUTARGET'; if that is null or not defined, then
7973choose the first entry in the target list.  Passing in the string
7974"default" or setting the environment variable to "default" will cause
7975the first entry in the target list to be returned, and
7976"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
7977causes 'bfd_check_format' to loop over all the targets to find the one
7978that matches the file being read.
7979
79802.12.1.3 'bfd_get_target_info'
7981..............................
7982
7983*Synopsis*
7984     const bfd_target *bfd_get_target_info (const char *target_name,
7985         bfd *abfd,
7986         bfd_boolean *is_bigendian,
7987         int *underscoring,
7988         const char **def_target_arch);
7989   *Description*
7990Return a pointer to the transfer vector for the object target named
7991TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
7992environment variable 'GNUTARGET'; if that is null or not defined, then
7993choose the first entry in the target list.  Passing in the string
7994"default" or setting the environment variable to "default" will cause
7995the first entry in the target list to be returned, and
7996"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
7997causes 'bfd_check_format' to loop over all the targets to find the one
7998that matches the file being read.  If IS_BIGENDIAN is not 'NULL', then
7999set this value to target's endian mode.  True for big-endian, FALSE for
8000little-endian or for invalid target.  If UNDERSCORING is not 'NULL',
8001then set this value to target's underscoring mode.  Zero for
8002none-underscoring, -1 for invalid target, else the value of target
8003vector's symbol underscoring.  If DEF_TARGET_ARCH is not 'NULL', then
8004set it to the architecture string specified by the target_name.
8005
80062.12.1.4 'bfd_target_list'
8007..........................
8008
8009*Synopsis*
8010     const char ** bfd_target_list (void);
8011   *Description*
8012Return a freshly malloced NULL-terminated vector of the names of all the
8013valid BFD targets.  Do not modify the names.
8014
80152.12.1.5 'bfd_iterate_over_targets'
8016...................................
8017
8018*Synopsis*
8019     const bfd_target *bfd_iterate_over_targets
8020        (int (*func) (const bfd_target *, void *),
8021         void *data);
8022   *Description*
8023Call FUNC for each target in the list of BFD target vectors, passing
8024DATA to FUNC.  Stop iterating if FUNC returns a non-zero result, and
8025return that target vector.  Return NULL if FUNC always returns zero.
8026
80272.12.1.6 'bfd_flavour_name'
8028...........................
8029
8030*Synopsis*
8031     const char *bfd_flavour_name (enum bfd_flavour flavour);
8032   *Description*
8033Return the string form of FLAVOUR.
8034
8035
8036File: bfd.info,  Node: Architectures,  Next: Opening and Closing,  Prev: Targets,  Up: BFD front end
8037
80382.13 Architectures
8039==================
8040
8041BFD keeps one atom in a BFD describing the architecture of the data
8042attached to the BFD: a pointer to a 'bfd_arch_info_type'.
8043
8044   Pointers to structures can be requested independently of a BFD so
8045that an architecture's information can be interrogated without access to
8046an open BFD.
8047
8048   The architecture information is provided by each architecture
8049package.  The set of default architectures is selected by the macro
8050'SELECT_ARCHITECTURES'.  This is normally set up in the
8051'config/TARGET.mt' file of your choice.  If the name is not defined,
8052then all the architectures supported are included.
8053
8054   When BFD starts up, all the architectures are called with an
8055initialize method.  It is up to the architecture back end to insert as
8056many items into the list of architectures as it wants to; generally this
8057would be one for each machine and one for the default case (an item with
8058a machine field of 0).
8059
8060   BFD's idea of an architecture is implemented in 'archures.c'.
8061
80622.13.1 bfd_architecture
8063-----------------------
8064
8065*Description*
8066This enum gives the object file's CPU architecture, in a global
8067sense--i.e., what processor family does it belong to?  Another field
8068indicates which processor within the family is in use.  The machine
8069gives a number which distinguishes different versions of the
8070architecture, containing, for example, 68020 for Motorola 68020.
8071     enum bfd_architecture
8072     {
8073       bfd_arch_unknown,   /* File arch not known.  */
8074       bfd_arch_obscure,   /* Arch known, not one of these.  */
8075       bfd_arch_m68k,      /* Motorola 68xxx.  */
8076     #define bfd_mach_m68000                1
8077     #define bfd_mach_m68008                2
8078     #define bfd_mach_m68010                3
8079     #define bfd_mach_m68020                4
8080     #define bfd_mach_m68030                5
8081     #define bfd_mach_m68040                6
8082     #define bfd_mach_m68060                7
8083     #define bfd_mach_cpu32                 8
8084     #define bfd_mach_fido                  9
8085     #define bfd_mach_mcf_isa_a_nodiv       10
8086     #define bfd_mach_mcf_isa_a             11
8087     #define bfd_mach_mcf_isa_a_mac         12
8088     #define bfd_mach_mcf_isa_a_emac        13
8089     #define bfd_mach_mcf_isa_aplus         14
8090     #define bfd_mach_mcf_isa_aplus_mac     15
8091     #define bfd_mach_mcf_isa_aplus_emac    16
8092     #define bfd_mach_mcf_isa_b_nousp       17
8093     #define bfd_mach_mcf_isa_b_nousp_mac   18
8094     #define bfd_mach_mcf_isa_b_nousp_emac  19
8095     #define bfd_mach_mcf_isa_b             20
8096     #define bfd_mach_mcf_isa_b_mac         21
8097     #define bfd_mach_mcf_isa_b_emac        22
8098     #define bfd_mach_mcf_isa_b_float       23
8099     #define bfd_mach_mcf_isa_b_float_mac   24
8100     #define bfd_mach_mcf_isa_b_float_emac  25
8101     #define bfd_mach_mcf_isa_c             26
8102     #define bfd_mach_mcf_isa_c_mac         27
8103     #define bfd_mach_mcf_isa_c_emac        28
8104     #define bfd_mach_mcf_isa_c_nodiv       29
8105     #define bfd_mach_mcf_isa_c_nodiv_mac   30
8106     #define bfd_mach_mcf_isa_c_nodiv_emac  31
8107       bfd_arch_vax,       /* DEC Vax.  */
8108
8109       bfd_arch_or1k,      /* OpenRISC 1000.  */
8110     #define bfd_mach_or1k          1
8111     #define bfd_mach_or1knd        2
8112
8113       bfd_arch_sparc,     /* SPARC.  */
8114     #define bfd_mach_sparc                 1
8115     /* The difference between v8plus and v9 is that v9 is a true 64 bit env.  */
8116     #define bfd_mach_sparc_sparclet        2
8117     #define bfd_mach_sparc_sparclite       3
8118     #define bfd_mach_sparc_v8plus          4
8119     #define bfd_mach_sparc_v8plusa         5 /* with ultrasparc add'ns.  */
8120     #define bfd_mach_sparc_sparclite_le    6
8121     #define bfd_mach_sparc_v9              7
8122     #define bfd_mach_sparc_v9a             8 /* with ultrasparc add'ns.  */
8123     #define bfd_mach_sparc_v8plusb         9 /* with cheetah add'ns.  */
8124     #define bfd_mach_sparc_v9b             10 /* with cheetah add'ns.  */
8125     #define bfd_mach_sparc_v8plusc         11 /* with UA2005 and T1 add'ns.  */
8126     #define bfd_mach_sparc_v9c             12 /* with UA2005 and T1 add'ns.  */
8127     #define bfd_mach_sparc_v8plusd         13 /* with UA2007 and T3 add'ns.  */
8128     #define bfd_mach_sparc_v9d             14 /* with UA2007 and T3 add'ns.  */
8129     #define bfd_mach_sparc_v8pluse         15 /* with OSA2001 and T4 add'ns (no IMA).  */
8130     #define bfd_mach_sparc_v9e             16 /* with OSA2001 and T4 add'ns (no IMA).  */
8131     #define bfd_mach_sparc_v8plusv         17 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
8132     #define bfd_mach_sparc_v9v             18 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
8133     #define bfd_mach_sparc_v8plusm         19 /* with OSA2015 and M7 add'ns.  */
8134     #define bfd_mach_sparc_v9m             20 /* with OSA2015 and M7 add'ns.  */
8135     #define bfd_mach_sparc_v8plusm8        21 /* with OSA2017 and M8 add'ns.  */
8136     #define bfd_mach_sparc_v9m8            22 /* with OSA2017 and M8 add'ns.  */
8137     /* Nonzero if MACH has the v9 instruction set.  */
8138     #define bfd_mach_sparc_v9_p(mach) \
8139       ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9m8 \
8140        && (mach) != bfd_mach_sparc_sparclite_le)
8141     /* Nonzero if MACH is a 64 bit sparc architecture.  */
8142     #define bfd_mach_sparc_64bit_p(mach) \
8143       ((mach) >= bfd_mach_sparc_v9 \
8144        && (mach) != bfd_mach_sparc_v8plusb \
8145        && (mach) != bfd_mach_sparc_v8plusc \
8146        && (mach) != bfd_mach_sparc_v8plusd \
8147        && (mach) != bfd_mach_sparc_v8pluse \
8148        && (mach) != bfd_mach_sparc_v8plusv \
8149        && (mach) != bfd_mach_sparc_v8plusm \
8150        && (mach) != bfd_mach_sparc_v8plusm8)
8151       bfd_arch_spu,       /* PowerPC SPU.  */
8152     #define bfd_mach_spu           256
8153       bfd_arch_mips,      /* MIPS Rxxxx.  */
8154     #define bfd_mach_mips3000              3000
8155     #define bfd_mach_mips3900              3900
8156     #define bfd_mach_mips4000              4000
8157     #define bfd_mach_mips4010              4010
8158     #define bfd_mach_mips4100              4100
8159     #define bfd_mach_mips4111              4111
8160     #define bfd_mach_mips4120              4120
8161     #define bfd_mach_mips4300              4300
8162     #define bfd_mach_mips4400              4400
8163     #define bfd_mach_mips4600              4600
8164     #define bfd_mach_mips4650              4650
8165     #define bfd_mach_mips5000              5000
8166     #define bfd_mach_mips5400              5400
8167     #define bfd_mach_mips5500              5500
8168     #define bfd_mach_mips5900              5900
8169     #define bfd_mach_mips6000              6000
8170     #define bfd_mach_mips7000              7000
8171     #define bfd_mach_mips8000              8000
8172     #define bfd_mach_mips9000              9000
8173     #define bfd_mach_mips10000             10000
8174     #define bfd_mach_mips12000             12000
8175     #define bfd_mach_mips14000             14000
8176     #define bfd_mach_mips16000             16000
8177     #define bfd_mach_mips16                16
8178     #define bfd_mach_mips5                 5
8179     #define bfd_mach_mips_loongson_2e      3001
8180     #define bfd_mach_mips_loongson_2f      3002
8181     #define bfd_mach_mips_gs464            3003
8182     #define bfd_mach_mips_gs464e           3004
8183     #define bfd_mach_mips_gs264e           3005
8184     #define bfd_mach_mips_sb1              12310201 /* octal 'SB', 01.  */
8185     #define bfd_mach_mips_octeon           6501
8186     #define bfd_mach_mips_octeonp          6601
8187     #define bfd_mach_mips_octeon2          6502
8188     #define bfd_mach_mips_octeon3          6503
8189     #define bfd_mach_mips_xlr              887682   /* decimal 'XLR'.  */
8190     #define bfd_mach_mips_interaptiv_mr2   736550   /* decimal 'IA2'.  */
8191     #define bfd_mach_mipsisa32             32
8192     #define bfd_mach_mipsisa32r2           33
8193     #define bfd_mach_mipsisa32r3           34
8194     #define bfd_mach_mipsisa32r5           36
8195     #define bfd_mach_mipsisa32r6           37
8196     #define bfd_mach_mipsisa64             64
8197     #define bfd_mach_mipsisa64r2           65
8198     #define bfd_mach_mipsisa64r3           66
8199     #define bfd_mach_mipsisa64r5           68
8200     #define bfd_mach_mipsisa64r6           69
8201     #define bfd_mach_mips_micromips        96
8202       bfd_arch_i386,      /* Intel 386.  */
8203     #define bfd_mach_i386_intel_syntax     (1 << 0)
8204     #define bfd_mach_i386_i8086            (1 << 1)
8205     #define bfd_mach_i386_i386             (1 << 2)
8206     #define bfd_mach_x86_64                (1 << 3)
8207     #define bfd_mach_x64_32                (1 << 4)
8208     #define bfd_mach_i386_i386_intel_syntax (bfd_mach_i386_i386 | bfd_mach_i386_intel_syntax)
8209     #define bfd_mach_x86_64_intel_syntax   (bfd_mach_x86_64 | bfd_mach_i386_intel_syntax)
8210     #define bfd_mach_x64_32_intel_syntax   (bfd_mach_x64_32 | bfd_mach_i386_intel_syntax)
8211       bfd_arch_l1om,      /* Intel L1OM.  */
8212     #define bfd_mach_l1om                  (1 << 5)
8213     #define bfd_mach_l1om_intel_syntax     (bfd_mach_l1om | bfd_mach_i386_intel_syntax)
8214       bfd_arch_k1om,      /* Intel K1OM.  */
8215     #define bfd_mach_k1om                  (1 << 6)
8216     #define bfd_mach_k1om_intel_syntax     (bfd_mach_k1om | bfd_mach_i386_intel_syntax)
8217       bfd_arch_iamcu,     /* Intel MCU.  */
8218     #define bfd_mach_iamcu                 (1 << 8)
8219     #define bfd_mach_i386_iamcu            (bfd_mach_i386_i386 | bfd_mach_iamcu)
8220     #define bfd_mach_i386_iamcu_intel_syntax (bfd_mach_i386_iamcu | bfd_mach_i386_intel_syntax)
8221       bfd_arch_romp,      /* IBM ROMP PC/RT.  */
8222       bfd_arch_convex,    /* Convex.  */
8223       bfd_arch_m98k,      /* Motorola 98xxx.  */
8224       bfd_arch_pyramid,   /* Pyramid Technology.  */
8225       bfd_arch_h8300,     /* Renesas H8/300 (formerly Hitachi H8/300).  */
8226     #define bfd_mach_h8300         1
8227     #define bfd_mach_h8300h        2
8228     #define bfd_mach_h8300s        3
8229     #define bfd_mach_h8300hn       4
8230     #define bfd_mach_h8300sn       5
8231     #define bfd_mach_h8300sx       6
8232     #define bfd_mach_h8300sxn      7
8233       bfd_arch_pdp11,     /* DEC PDP-11.  */
8234       bfd_arch_powerpc,   /* PowerPC.  */
8235     #define bfd_mach_ppc           32
8236     #define bfd_mach_ppc64         64
8237     #define bfd_mach_ppc_403       403
8238     #define bfd_mach_ppc_403gc     4030
8239     #define bfd_mach_ppc_405       405
8240     #define bfd_mach_ppc_505       505
8241     #define bfd_mach_ppc_601       601
8242     #define bfd_mach_ppc_602       602
8243     #define bfd_mach_ppc_603       603
8244     #define bfd_mach_ppc_ec603e    6031
8245     #define bfd_mach_ppc_604       604
8246     #define bfd_mach_ppc_620       620
8247     #define bfd_mach_ppc_630       630
8248     #define bfd_mach_ppc_750       750
8249     #define bfd_mach_ppc_860       860
8250     #define bfd_mach_ppc_a35       35
8251     #define bfd_mach_ppc_rs64ii    642
8252     #define bfd_mach_ppc_rs64iii   643
8253     #define bfd_mach_ppc_7400      7400
8254     #define bfd_mach_ppc_e500      500
8255     #define bfd_mach_ppc_e500mc    5001
8256     #define bfd_mach_ppc_e500mc64  5005
8257     #define bfd_mach_ppc_e5500     5006
8258     #define bfd_mach_ppc_e6500     5007
8259     #define bfd_mach_ppc_titan     83
8260     #define bfd_mach_ppc_vle       84
8261       bfd_arch_rs6000,    /* IBM RS/6000.  */
8262     #define bfd_mach_rs6k          6000
8263     #define bfd_mach_rs6k_rs1      6001
8264     #define bfd_mach_rs6k_rsc      6003
8265     #define bfd_mach_rs6k_rs2      6002
8266       bfd_arch_hppa,      /* HP PA RISC.  */
8267     #define bfd_mach_hppa10        10
8268     #define bfd_mach_hppa11        11
8269     #define bfd_mach_hppa20        20
8270     #define bfd_mach_hppa20w       25
8271       bfd_arch_d10v,      /* Mitsubishi D10V.  */
8272     #define bfd_mach_d10v          1
8273     #define bfd_mach_d10v_ts2      2
8274     #define bfd_mach_d10v_ts3      3
8275       bfd_arch_d30v,      /* Mitsubishi D30V.  */
8276       bfd_arch_dlx,       /* DLX.  */
8277       bfd_arch_m68hc11,   /* Motorola 68HC11.  */
8278       bfd_arch_m68hc12,   /* Motorola 68HC12.  */
8279     #define bfd_mach_m6812_default 0
8280     #define bfd_mach_m6812         1
8281     #define bfd_mach_m6812s        2
8282       bfd_arch_m9s12x,    /* Freescale S12X.  */
8283       bfd_arch_m9s12xg,   /* Freescale XGATE.  */
8284       bfd_arch_s12z,    /* Freescale S12Z.  */
8285     #define bfd_mach_s12z_default 0
8286       bfd_arch_z8k,       /* Zilog Z8000.  */
8287     #define bfd_mach_z8001         1
8288     #define bfd_mach_z8002         2
8289       bfd_arch_sh,        /* Renesas / SuperH SH (formerly Hitachi SH).  */
8290     #define bfd_mach_sh                            1
8291     #define bfd_mach_sh2                           0x20
8292     #define bfd_mach_sh_dsp                        0x2d
8293     #define bfd_mach_sh2a                          0x2a
8294     #define bfd_mach_sh2a_nofpu                    0x2b
8295     #define bfd_mach_sh2a_nofpu_or_sh4_nommu_nofpu 0x2a1
8296     #define bfd_mach_sh2a_nofpu_or_sh3_nommu       0x2a2
8297     #define bfd_mach_sh2a_or_sh4                   0x2a3
8298     #define bfd_mach_sh2a_or_sh3e                  0x2a4
8299     #define bfd_mach_sh2e                          0x2e
8300     #define bfd_mach_sh3                           0x30
8301     #define bfd_mach_sh3_nommu                     0x31
8302     #define bfd_mach_sh3_dsp                       0x3d
8303     #define bfd_mach_sh3e                          0x3e
8304     #define bfd_mach_sh4                           0x40
8305     #define bfd_mach_sh4_nofpu                     0x41
8306     #define bfd_mach_sh4_nommu_nofpu               0x42
8307     #define bfd_mach_sh4a                          0x4a
8308     #define bfd_mach_sh4a_nofpu                    0x4b
8309     #define bfd_mach_sh4al_dsp                     0x4d
8310       bfd_arch_alpha,     /* Dec Alpha.  */
8311     #define bfd_mach_alpha_ev4     0x10
8312     #define bfd_mach_alpha_ev5     0x20
8313     #define bfd_mach_alpha_ev6     0x30
8314       bfd_arch_arm,       /* Advanced Risc Machines ARM.  */
8315     #define bfd_mach_arm_unknown   0
8316     #define bfd_mach_arm_2         1
8317     #define bfd_mach_arm_2a        2
8318     #define bfd_mach_arm_3         3
8319     #define bfd_mach_arm_3M        4
8320     #define bfd_mach_arm_4         5
8321     #define bfd_mach_arm_4T        6
8322     #define bfd_mach_arm_5         7
8323     #define bfd_mach_arm_5T        8
8324     #define bfd_mach_arm_5TE       9
8325     #define bfd_mach_arm_XScale    10
8326     #define bfd_mach_arm_ep9312    11
8327     #define bfd_mach_arm_iWMMXt    12
8328     #define bfd_mach_arm_iWMMXt2   13
8329     #define bfd_mach_arm_5TEJ      14
8330     #define bfd_mach_arm_6         15
8331     #define bfd_mach_arm_6KZ       16
8332     #define bfd_mach_arm_6T2       17
8333     #define bfd_mach_arm_6K        18
8334     #define bfd_mach_arm_7         19
8335     #define bfd_mach_arm_6M        20
8336     #define bfd_mach_arm_6SM       21
8337     #define bfd_mach_arm_7EM       22
8338     #define bfd_mach_arm_8         23
8339     #define bfd_mach_arm_8R        24
8340     #define bfd_mach_arm_8M_BASE   25
8341     #define bfd_mach_arm_8M_MAIN   26
8342     #define bfd_mach_arm_8_1M_MAIN 27
8343       bfd_arch_nds32,     /* Andes NDS32.  */
8344     #define bfd_mach_n1            1
8345     #define bfd_mach_n1h           2
8346     #define bfd_mach_n1h_v2        3
8347     #define bfd_mach_n1h_v3        4
8348     #define bfd_mach_n1h_v3m       5
8349       bfd_arch_ns32k,     /* National Semiconductors ns32000.  */
8350       bfd_arch_tic30,     /* Texas Instruments TMS320C30.  */
8351       bfd_arch_tic4x,     /* Texas Instruments TMS320C3X/4X.  */
8352     #define bfd_mach_tic3x         30
8353     #define bfd_mach_tic4x         40
8354       bfd_arch_tic54x,    /* Texas Instruments TMS320C54X.  */
8355       bfd_arch_tic6x,     /* Texas Instruments TMS320C6X.  */
8356       bfd_arch_v850,      /* NEC V850.  */
8357       bfd_arch_v850_rh850,/* NEC V850 (using RH850 ABI).  */
8358     #define bfd_mach_v850          1
8359     #define bfd_mach_v850e         'E'
8360     #define bfd_mach_v850e1        '1'
8361     #define bfd_mach_v850e2        0x4532
8362     #define bfd_mach_v850e2v3      0x45325633
8363     #define bfd_mach_v850e3v5      0x45335635 /* ('E'|'3'|'V'|'5').  */
8364       bfd_arch_arc,       /* ARC Cores.  */
8365     #define bfd_mach_arc_a4        0
8366     #define bfd_mach_arc_a5        1
8367     #define bfd_mach_arc_arc600    2
8368     #define bfd_mach_arc_arc601    4
8369     #define bfd_mach_arc_arc700    3
8370     #define bfd_mach_arc_arcv2     5
8371      bfd_arch_m32c,       /* Renesas M16C/M32C.  */
8372     #define bfd_mach_m16c          0x75
8373     #define bfd_mach_m32c          0x78
8374       bfd_arch_m32r,      /* Renesas M32R (formerly Mitsubishi M32R/D).  */
8375     #define bfd_mach_m32r          1 /* For backwards compatibility.  */
8376     #define bfd_mach_m32rx         'x'
8377     #define bfd_mach_m32r2         '2'
8378       bfd_arch_mn10200,   /* Matsushita MN10200.  */
8379       bfd_arch_mn10300,   /* Matsushita MN10300.  */
8380     #define bfd_mach_mn10300       300
8381     #define bfd_mach_am33          330
8382     #define bfd_mach_am33_2        332
8383       bfd_arch_fr30,
8384     #define bfd_mach_fr30          0x46523330
8385       bfd_arch_frv,
8386     #define bfd_mach_frv           1
8387     #define bfd_mach_frvsimple     2
8388     #define bfd_mach_fr300         300
8389     #define bfd_mach_fr400         400
8390     #define bfd_mach_fr450         450
8391     #define bfd_mach_frvtomcat     499     /* fr500 prototype.  */
8392     #define bfd_mach_fr500         500
8393     #define bfd_mach_fr550         550
8394       bfd_arch_moxie,     /* The moxie processor.  */
8395     #define bfd_mach_moxie         1
8396       bfd_arch_ft32,      /* The ft32 processor.  */
8397     #define bfd_mach_ft32          1
8398     #define bfd_mach_ft32b         2
8399       bfd_arch_mcore,
8400       bfd_arch_mep,
8401     #define bfd_mach_mep           1
8402     #define bfd_mach_mep_h1        0x6831
8403     #define bfd_mach_mep_c5        0x6335
8404       bfd_arch_metag,
8405     #define bfd_mach_metag         1
8406       bfd_arch_ia64,      /* HP/Intel ia64.  */
8407     #define bfd_mach_ia64_elf64    64
8408     #define bfd_mach_ia64_elf32    32
8409       bfd_arch_ip2k,      /* Ubicom IP2K microcontrollers. */
8410     #define bfd_mach_ip2022        1
8411     #define bfd_mach_ip2022ext     2
8412      bfd_arch_iq2000,     /* Vitesse IQ2000.  */
8413     #define bfd_mach_iq2000        1
8414     #define bfd_mach_iq10          2
8415       bfd_arch_bpf,       /* Linux eBPF.  */
8416     #define bfd_mach_bpf           1
8417     #define bfd_mach_xbpf          2
8418       bfd_arch_epiphany,  /* Adapteva EPIPHANY.  */
8419     #define bfd_mach_epiphany16    1
8420     #define bfd_mach_epiphany32    2
8421       bfd_arch_mt,
8422     #define bfd_mach_ms1           1
8423     #define bfd_mach_mrisc2        2
8424     #define bfd_mach_ms2           3
8425       bfd_arch_pj,
8426       bfd_arch_avr,       /* Atmel AVR microcontrollers.  */
8427     #define bfd_mach_avr1          1
8428     #define bfd_mach_avr2          2
8429     #define bfd_mach_avr25         25
8430     #define bfd_mach_avr3          3
8431     #define bfd_mach_avr31         31
8432     #define bfd_mach_avr35         35
8433     #define bfd_mach_avr4          4
8434     #define bfd_mach_avr5          5
8435     #define bfd_mach_avr51         51
8436     #define bfd_mach_avr6          6
8437     #define bfd_mach_avrtiny       100
8438     #define bfd_mach_avrxmega1     101
8439     #define bfd_mach_avrxmega2     102
8440     #define bfd_mach_avrxmega3     103
8441     #define bfd_mach_avrxmega4     104
8442     #define bfd_mach_avrxmega5     105
8443     #define bfd_mach_avrxmega6     106
8444     #define bfd_mach_avrxmega7     107
8445       bfd_arch_bfin,      /* ADI Blackfin.  */
8446     #define bfd_mach_bfin          1
8447       bfd_arch_cr16,      /* National Semiconductor CompactRISC (ie CR16).  */
8448     #define bfd_mach_cr16          1
8449       bfd_arch_crx,       /*  National Semiconductor CRX.  */
8450     #define bfd_mach_crx           1
8451       bfd_arch_cris,      /* Axis CRIS.  */
8452     #define bfd_mach_cris_v0_v10   255
8453     #define bfd_mach_cris_v32      32
8454     #define bfd_mach_cris_v10_v32  1032
8455       bfd_arch_riscv,
8456     #define bfd_mach_riscv32       132
8457     #define bfd_mach_riscv64       164
8458       bfd_arch_rl78,
8459     #define bfd_mach_rl78          0x75
8460       bfd_arch_rx,        /* Renesas RX.  */
8461     #define bfd_mach_rx            0x75
8462     #define bfd_mach_rx_v2         0x76
8463     #define bfd_mach_rx_v3         0x77
8464       bfd_arch_s390,      /* IBM s390.  */
8465     #define bfd_mach_s390_31       31
8466     #define bfd_mach_s390_64       64
8467       bfd_arch_score,     /* Sunplus score.  */
8468     #define bfd_mach_score3        3
8469     #define bfd_mach_score7        7
8470       bfd_arch_mmix,      /* Donald Knuth's educational processor.  */
8471       bfd_arch_xstormy16,
8472     #define bfd_mach_xstormy16     1
8473       bfd_arch_msp430,    /* Texas Instruments MSP430 architecture.  */
8474     #define bfd_mach_msp11         11
8475     #define bfd_mach_msp110        110
8476     #define bfd_mach_msp12         12
8477     #define bfd_mach_msp13         13
8478     #define bfd_mach_msp14         14
8479     #define bfd_mach_msp15         15
8480     #define bfd_mach_msp16         16
8481     #define bfd_mach_msp20         20
8482     #define bfd_mach_msp21         21
8483     #define bfd_mach_msp22         22
8484     #define bfd_mach_msp23         23
8485     #define bfd_mach_msp24         24
8486     #define bfd_mach_msp26         26
8487     #define bfd_mach_msp31         31
8488     #define bfd_mach_msp32         32
8489     #define bfd_mach_msp33         33
8490     #define bfd_mach_msp41         41
8491     #define bfd_mach_msp42         42
8492     #define bfd_mach_msp43         43
8493     #define bfd_mach_msp44         44
8494     #define bfd_mach_msp430x       45
8495     #define bfd_mach_msp46         46
8496     #define bfd_mach_msp47         47
8497     #define bfd_mach_msp54         54
8498       bfd_arch_xc16x,     /* Infineon's XC16X Series.  */
8499     #define bfd_mach_xc16x         1
8500     #define bfd_mach_xc16xl        2
8501     #define bfd_mach_xc16xs        3
8502       bfd_arch_xgate,     /* Freescale XGATE.  */
8503     #define bfd_mach_xgate         1
8504       bfd_arch_xtensa,    /* Tensilica's Xtensa cores.  */
8505     #define bfd_mach_xtensa        1
8506       bfd_arch_z80,
8507     /* Zilog Z80 without undocumented opcodes.  */
8508     #define bfd_mach_z80strict     1
8509     /* Zilog Z180: successor with additional instructions, but without
8510      halves of ix and iy.  */
8511     #define bfd_mach_z180          2
8512     /* Zilog Z80 with ixl, ixh, iyl, and iyh.  */
8513     #define bfd_mach_z80           3
8514     /* Zilog eZ80 (successor of Z80 & Z180) in Z80 (16-bit address) mode.  */
8515     #define bfd_mach_ez80_z80      4
8516     /* Zilog eZ80 (successor of Z80 & Z180) in ADL (24-bit address) mode.  */
8517     #define bfd_mach_ez80_adl      5
8518     /* Z80N */
8519     #define bfd_mach_z80n          6
8520     /* Zilog Z80 with all undocumented instructions.  */
8521     #define bfd_mach_z80full       7
8522     /* GameBoy Z80 (reduced instruction set).  */
8523     #define bfd_mach_gbz80         8
8524     /* ASCII R800: successor with multiplication.  */
8525     #define bfd_mach_r800          11
8526       bfd_arch_lm32,      /* Lattice Mico32.  */
8527     #define bfd_mach_lm32          1
8528       bfd_arch_microblaze,/* Xilinx MicroBlaze.  */
8529       bfd_arch_tilepro,   /* Tilera TILEPro.  */
8530       bfd_arch_tilegx,    /* Tilera TILE-Gx.  */
8531     #define bfd_mach_tilepro       1
8532     #define bfd_mach_tilegx        1
8533     #define bfd_mach_tilegx32      2
8534       bfd_arch_aarch64,   /* AArch64.  */
8535     #define bfd_mach_aarch64 0
8536     #define bfd_mach_aarch64_8R    1
8537     #define bfd_mach_aarch64_ilp32 32
8538       bfd_arch_nios2,     /* Nios II.  */
8539     #define bfd_mach_nios2         0
8540     #define bfd_mach_nios2r1       1
8541     #define bfd_mach_nios2r2       2
8542       bfd_arch_visium,    /* Visium.  */
8543     #define bfd_mach_visium        1
8544       bfd_arch_wasm32,    /* WebAssembly.  */
8545     #define bfd_mach_wasm32        1
8546       bfd_arch_pru,       /* PRU.  */
8547     #define bfd_mach_pru           0
8548       bfd_arch_nfp,       /* Netronome Flow Processor */
8549     #define bfd_mach_nfp3200       0x3200
8550     #define bfd_mach_nfp6000       0x6000
8551       bfd_arch_csky,      /* C-SKY.  */
8552     #define bfd_mach_ck_unknown    0
8553     #define bfd_mach_ck510         1
8554     #define bfd_mach_ck610         2
8555     #define bfd_mach_ck801         3
8556     #define bfd_mach_ck802         4
8557     #define bfd_mach_ck803         5
8558     #define bfd_mach_ck807         6
8559     #define bfd_mach_ck810         7
8560     #define bfd_mach_ck860         8
8561       bfd_arch_last
8562       };
8563
85642.13.2 bfd_arch_info
8565--------------------
8566
8567*Description*
8568This structure contains information on architectures for use within BFD.
8569
8570     typedef struct bfd_arch_info
8571     {
8572       int bits_per_word;
8573       int bits_per_address;
8574       int bits_per_byte;
8575       enum bfd_architecture arch;
8576       unsigned long mach;
8577       const char *arch_name;
8578       const char *printable_name;
8579       unsigned int section_align_power;
8580       /* TRUE if this is the default machine for the architecture.
8581          The default arch should be the first entry for an arch so that
8582          all the entries for that arch can be accessed via next.  */
8583       bfd_boolean the_default;
8584       const struct bfd_arch_info * (*compatible) (const struct bfd_arch_info *,
8585                                                   const struct bfd_arch_info *);
8586
8587       bfd_boolean (*scan) (const struct bfd_arch_info *, const char *);
8588
8589       /* Allocate via bfd_malloc and return a fill buffer of size COUNT.  If
8590          IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8591          TRUE, the buffer contains code.  */
8592       void *(*fill) (bfd_size_type count, bfd_boolean is_bigendian,
8593                      bfd_boolean code);
8594
8595       const struct bfd_arch_info *next;
8596
8597       /* On some architectures the offset for a relocation can point into
8598          the middle of an instruction.  This field specifies the maximum
8599          offset such a relocation can have (in octets).  This affects the
8600          behaviour of the disassembler, since a value greater than zero
8601          means that it may need to disassemble an instruction twice, once
8602          to get its length and then a second time to display it.  If the
8603          value is negative then this has to be done for every single
8604          instruction, regardless of the offset of the reloc.  */
8605       signed int max_reloc_offset_into_insn;
8606     }
8607     bfd_arch_info_type;
8608
86092.13.2.1 'bfd_printable_name'
8610.............................
8611
8612*Synopsis*
8613     const char *bfd_printable_name (bfd *abfd);
8614   *Description*
8615Return a printable string representing the architecture and machine from
8616the pointer to the architecture info structure.
8617
86182.13.2.2 'bfd_scan_arch'
8619........................
8620
8621*Synopsis*
8622     const bfd_arch_info_type *bfd_scan_arch (const char *string);
8623   *Description*
8624Figure out if BFD supports any cpu which could be described with the
8625name STRING.  Return a pointer to an 'arch_info' structure if a machine
8626is found, otherwise NULL.
8627
86282.13.2.3 'bfd_arch_list'
8629........................
8630
8631*Synopsis*
8632     const char **bfd_arch_list (void);
8633   *Description*
8634Return a freshly malloced NULL-terminated vector of the names of all the
8635valid BFD architectures.  Do not modify the names.
8636
86372.13.2.4 'bfd_arch_get_compatible'
8638..................................
8639
8640*Synopsis*
8641     const bfd_arch_info_type *bfd_arch_get_compatible
8642        (const bfd *abfd, const bfd *bbfd, bfd_boolean accept_unknowns);
8643   *Description*
8644Determine whether two BFDs' architectures and machine types are
8645compatible.  Calculates the lowest common denominator between the two
8646architectures and machine types implied by the BFDs and returns a
8647pointer to an 'arch_info' structure describing the compatible machine.
8648
86492.13.2.5 'bfd_default_arch_struct'
8650..................................
8651
8652*Description*
8653The 'bfd_default_arch_struct' is an item of 'bfd_arch_info_type' which
8654has been initialized to a fairly generic state.  A BFD starts life by
8655pointing to this structure, until the correct back end has determined
8656the real architecture of the file.
8657     extern const bfd_arch_info_type bfd_default_arch_struct;
8658
86592.13.2.6 'bfd_set_arch_info'
8660............................
8661
8662*Synopsis*
8663     void bfd_set_arch_info (bfd *abfd, const bfd_arch_info_type *arg);
8664   *Description*
8665Set the architecture info of ABFD to ARG.
8666
86672.13.2.7 'bfd_default_set_arch_mach'
8668....................................
8669
8670*Synopsis*
8671     bfd_boolean bfd_default_set_arch_mach
8672        (bfd *abfd, enum bfd_architecture arch, unsigned long mach);
8673   *Description*
8674Set the architecture and machine type in BFD ABFD to ARCH and MACH.
8675Find the correct pointer to a structure and insert it into the
8676'arch_info' pointer.
8677
86782.13.2.8 'bfd_get_arch'
8679.......................
8680
8681*Synopsis*
8682     enum bfd_architecture bfd_get_arch (const bfd *abfd);
8683   *Description*
8684Return the enumerated type which describes the BFD ABFD's architecture.
8685
86862.13.2.9 'bfd_get_mach'
8687.......................
8688
8689*Synopsis*
8690     unsigned long bfd_get_mach (const bfd *abfd);
8691   *Description*
8692Return the long type which describes the BFD ABFD's machine.
8693
86942.13.2.10 'bfd_arch_bits_per_byte'
8695..................................
8696
8697*Synopsis*
8698     unsigned int bfd_arch_bits_per_byte (const bfd *abfd);
8699   *Description*
8700Return the number of bits in one of the BFD ABFD's architecture's bytes.
8701
87022.13.2.11 'bfd_arch_bits_per_address'
8703.....................................
8704
8705*Synopsis*
8706     unsigned int bfd_arch_bits_per_address (const bfd *abfd);
8707   *Description*
8708Return the number of bits in one of the BFD ABFD's architecture's
8709addresses.
8710
87112.13.2.12 'bfd_default_compatible'
8712..................................
8713
8714*Synopsis*
8715     const bfd_arch_info_type *bfd_default_compatible
8716        (const bfd_arch_info_type *a, const bfd_arch_info_type *b);
8717   *Description*
8718The default function for testing for compatibility.
8719
87202.13.2.13 'bfd_default_scan'
8721............................
8722
8723*Synopsis*
8724     bfd_boolean bfd_default_scan
8725        (const struct bfd_arch_info *info, const char *string);
8726   *Description*
8727The default function for working out whether this is an architecture hit
8728and a machine hit.
8729
87302.13.2.14 'bfd_get_arch_info'
8731.............................
8732
8733*Synopsis*
8734     const bfd_arch_info_type *bfd_get_arch_info (bfd *abfd);
8735   *Description*
8736Return the architecture info struct in ABFD.
8737
87382.13.2.15 'bfd_lookup_arch'
8739...........................
8740
8741*Synopsis*
8742     const bfd_arch_info_type *bfd_lookup_arch
8743        (enum bfd_architecture arch, unsigned long machine);
8744   *Description*
8745Look for the architecture info structure which matches the arguments
8746ARCH and MACHINE.  A machine of 0 matches the machine/architecture
8747structure which marks itself as the default.
8748
87492.13.2.16 'bfd_printable_arch_mach'
8750...................................
8751
8752*Synopsis*
8753     const char *bfd_printable_arch_mach
8754        (enum bfd_architecture arch, unsigned long machine);
8755   *Description*
8756Return a printable string representing the architecture and machine
8757type.
8758
8759   This routine is depreciated.
8760
87612.13.2.17 'bfd_octets_per_byte'
8762...............................
8763
8764*Synopsis*
8765     unsigned int bfd_octets_per_byte (const bfd *abfd,
8766         const asection *sec);
8767   *Description*
8768Return the number of octets (8-bit quantities) per target byte (minimum
8769addressable unit).  In most cases, this will be one, but some DSP
8770targets have 16, 32, or even 48 bits per byte.
8771
87722.13.2.18 'bfd_arch_mach_octets_per_byte'
8773.........................................
8774
8775*Synopsis*
8776     unsigned int bfd_arch_mach_octets_per_byte
8777        (enum bfd_architecture arch, unsigned long machine);
8778   *Description*
8779See bfd_octets_per_byte.
8780
8781   This routine is provided for those cases where a bfd * is not
8782available
8783
87842.13.2.19 'bfd_arch_default_fill'
8785.................................
8786
8787*Synopsis*
8788     void *bfd_arch_default_fill (bfd_size_type count,
8789         bfd_boolean is_bigendian,
8790         bfd_boolean code);
8791   *Description*
8792Allocate via bfd_malloc and return a fill buffer of size COUNT. If
8793IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8794TRUE, the buffer contains code.
8795
8796
8797File: bfd.info,  Node: Opening and Closing,  Next: Internal,  Prev: Architectures,  Up: BFD front end
8798
8799     /* Set to N to open the next N BFDs using an alternate id space.  */
8800     extern unsigned int bfd_use_reserved_id;
8801
88022.14 Opening and closing BFDs
8803=============================
8804
88052.14.1 Functions for opening and closing
8806----------------------------------------
8807
88082.14.1.1 'bfd_fopen'
8809....................
8810
8811*Synopsis*
8812     bfd *bfd_fopen (const char *filename, const char *target,
8813         const char *mode, int fd);
8814   *Description*
8815Open the file FILENAME with the target TARGET.  Return a pointer to the
8816created BFD. If FD is not -1, then 'fdopen' is used to open the file;
8817otherwise, 'fopen' is used.  MODE is passed directly to 'fopen' or
8818'fdopen'.
8819
8820   Calls 'bfd_find_target', so TARGET is interpreted as by that
8821function.
8822
8823   The new BFD is marked as cacheable iff FD is -1.
8824
8825   If 'NULL' is returned then an error has occured.  Possible errors are
8826'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8827error.
8828
8829   On error, FD is always closed.
8830
8831   A copy of the FILENAME argument is stored in the newly created BFD.
8832It can be accessed via the bfd_get_filename() macro.
8833
88342.14.1.2 'bfd_openr'
8835....................
8836
8837*Synopsis*
8838     bfd *bfd_openr (const char *filename, const char *target);
8839   *Description*
8840Open the file FILENAME (using 'fopen') with the target TARGET.  Return a
8841pointer to the created BFD.
8842
8843   Calls 'bfd_find_target', so TARGET is interpreted as by that
8844function.
8845
8846   If 'NULL' is returned then an error has occured.  Possible errors are
8847'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8848error.
8849
8850   A copy of the FILENAME argument is stored in the newly created BFD.
8851It can be accessed via the bfd_get_filename() macro.
8852
88532.14.1.3 'bfd_fdopenr'
8854......................
8855
8856*Synopsis*
8857     bfd *bfd_fdopenr (const char *filename, const char *target, int fd);
8858   *Description*
8859'bfd_fdopenr' is to 'bfd_fopenr' much like 'fdopen' is to 'fopen'.  It
8860opens a BFD on a file already described by the FD supplied.
8861
8862   When the file is later 'bfd_close'd, the file descriptor will be
8863closed.  If the caller desires that this file descriptor be cached by
8864BFD (opened as needed, closed as needed to free descriptors for other
8865opens), with the supplied FD used as an initial file descriptor (but
8866subject to closure at any time), call bfd_set_cacheable(bfd, 1) on the
8867returned BFD. The default is to assume no caching; the file descriptor
8868will remain open until 'bfd_close', and will not be affected by BFD
8869operations on other files.
8870
8871   Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
8872and 'bfd_error_system_call'.
8873
8874   On error, FD is closed.
8875
8876   A copy of the FILENAME argument is stored in the newly created BFD.
8877It can be accessed via the bfd_get_filename() macro.
8878
88792.14.1.4 'bfd_fdopenw'
8880......................
8881
8882*Synopsis*
8883     bfd *bfd_fdopenw (const char *filename, const char *target, int fd);
8884   *Description*
8885'bfd_fdopenw' is exactly like 'bfd_fdopenr' with the exception that the
8886resulting BFD is suitable for output.
8887
88882.14.1.5 'bfd_openstreamr'
8889..........................
8890
8891*Synopsis*
8892     bfd *bfd_openstreamr (const char * filename, const char * target,
8893         void * stream);
8894   *Description*
8895Open a BFD for read access on an existing stdio stream.  When the BFD is
8896passed to 'bfd_close', the stream will be closed.
8897
8898   A copy of the FILENAME argument is stored in the newly created BFD.
8899It can be accessed via the bfd_get_filename() macro.
8900
89012.14.1.6 'bfd_openr_iovec'
8902..........................
8903
8904*Synopsis*
8905     bfd *bfd_openr_iovec (const char *filename, const char *target,
8906         void *(*open_func) (struct bfd *nbfd,
8907         void *open_closure),
8908         void *open_closure,
8909         file_ptr (*pread_func) (struct bfd *nbfd,
8910         void *stream,
8911         void *buf,
8912         file_ptr nbytes,
8913         file_ptr offset),
8914         int (*close_func) (struct bfd *nbfd,
8915         void *stream),
8916         int (*stat_func) (struct bfd *abfd,
8917         void *stream,
8918         struct stat *sb));
8919   *Description*
8920Create and return a BFD backed by a read-only STREAM.  The STREAM is
8921created using OPEN_FUNC, accessed using PREAD_FUNC and destroyed using
8922CLOSE_FUNC.
8923
8924   Calls 'bfd_find_target', so TARGET is interpreted as by that
8925function.
8926
8927   Calls OPEN_FUNC (which can call 'bfd_zalloc' and 'bfd_get_filename')
8928to obtain the read-only stream backing the BFD. OPEN_FUNC either
8929succeeds returning the non-'NULL' STREAM, or fails returning 'NULL'
8930(setting 'bfd_error').
8931
8932   Calls PREAD_FUNC to request NBYTES of data from STREAM starting at
8933OFFSET (e.g., via a call to 'bfd_read').  PREAD_FUNC either succeeds
8934returning the number of bytes read (which can be less than NBYTES when
8935end-of-file), or fails returning -1 (setting 'bfd_error').
8936
8937   Calls CLOSE_FUNC when the BFD is later closed using 'bfd_close'.
8938CLOSE_FUNC either succeeds returning 0, or fails returning -1 (setting
8939'bfd_error').
8940
8941   Calls STAT_FUNC to fill in a stat structure for bfd_stat,
8942bfd_get_size, and bfd_get_mtime calls.  STAT_FUNC returns 0 on success,
8943or returns -1 on failure (setting 'bfd_error').
8944
8945   If 'bfd_openr_iovec' returns 'NULL' then an error has occurred.
8946Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
8947and 'bfd_error_system_call'.
8948
8949   A copy of the FILENAME argument is stored in the newly created BFD.
8950It can be accessed via the bfd_get_filename() macro.
8951
89522.14.1.7 'bfd_openw'
8953....................
8954
8955*Synopsis*
8956     bfd *bfd_openw (const char *filename, const char *target);
8957   *Description*
8958Create a BFD, associated with file FILENAME, using the file format
8959TARGET, and return a pointer to it.
8960
8961   Possible errors are 'bfd_error_system_call', 'bfd_error_no_memory',
8962'bfd_error_invalid_target'.
8963
8964   A copy of the FILENAME argument is stored in the newly created BFD.
8965It can be accessed via the bfd_get_filename() macro.
8966
89672.14.1.8 'bfd_close'
8968....................
8969
8970*Synopsis*
8971     bfd_boolean bfd_close (bfd *abfd);
8972   *Description*
8973Close a BFD. If the BFD was open for writing, then pending operations
8974are completed and the file written out and closed.  If the created file
8975is executable, then 'chmod' is called to mark it as such.
8976
8977   All memory attached to the BFD is released.
8978
8979   The file descriptor associated with the BFD is closed (even if it was
8980passed in to BFD by 'bfd_fdopenr').
8981
8982   *Returns*
8983'TRUE' is returned if all is ok, otherwise 'FALSE'.
8984
89852.14.1.9 'bfd_close_all_done'
8986.............................
8987
8988*Synopsis*
8989     bfd_boolean bfd_close_all_done (bfd *);
8990   *Description*
8991Close a BFD. Differs from 'bfd_close' since it does not complete any
8992pending operations.  This routine would be used if the application had
8993just used BFD for swapping and didn't want to use any of the writing
8994code.
8995
8996   If the created file is executable, then 'chmod' is called to mark it
8997as such.
8998
8999   All memory attached to the BFD is released.
9000
9001   *Returns*
9002'TRUE' is returned if all is ok, otherwise 'FALSE'.
9003
90042.14.1.10 'bfd_create'
9005......................
9006
9007*Synopsis*
9008     bfd *bfd_create (const char *filename, bfd *templ);
9009   *Description*
9010Create a new BFD in the manner of 'bfd_openw', but without opening a
9011file.  The new BFD takes the target from the target used by TEMPL.  The
9012format is always set to 'bfd_object'.
9013
9014   A copy of the FILENAME argument is stored in the newly created BFD.
9015It can be accessed via the bfd_get_filename() macro.
9016
90172.14.1.11 'bfd_make_writable'
9018.............................
9019
9020*Synopsis*
9021     bfd_boolean bfd_make_writable (bfd *abfd);
9022   *Description*
9023Takes a BFD as created by 'bfd_create' and converts it into one like as
9024returned by 'bfd_openw'.  It does this by converting the BFD to
9025BFD_IN_MEMORY. It's assumed that you will call 'bfd_make_readable' on
9026this bfd later.
9027
9028   *Returns*
9029'TRUE' is returned if all is ok, otherwise 'FALSE'.
9030
90312.14.1.12 'bfd_make_readable'
9032.............................
9033
9034*Synopsis*
9035     bfd_boolean bfd_make_readable (bfd *abfd);
9036   *Description*
9037Takes a BFD as created by 'bfd_create' and 'bfd_make_writable' and
9038converts it into one like as returned by 'bfd_openr'.  It does this by
9039writing the contents out to the memory buffer, then reversing the
9040direction.
9041
9042   *Returns*
9043'TRUE' is returned if all is ok, otherwise 'FALSE'.
9044
90452.14.1.13 'bfd_alloc'
9046.....................
9047
9048*Synopsis*
9049     void *bfd_alloc (bfd *abfd, bfd_size_type wanted);
9050   *Description*
9051Allocate a block of WANTED bytes of memory attached to 'abfd' and return
9052a pointer to it.
9053
90542.14.1.14 'bfd_zalloc'
9055......................
9056
9057*Synopsis*
9058     void *bfd_zalloc (bfd *abfd, bfd_size_type wanted);
9059   *Description*
9060Allocate a block of WANTED bytes of zeroed memory attached to 'abfd' and
9061return a pointer to it.
9062
90632.14.1.15 'bfd_calc_gnu_debuglink_crc32'
9064........................................
9065
9066*Synopsis*
9067     unsigned long bfd_calc_gnu_debuglink_crc32
9068        (unsigned long crc, const unsigned char *buf, bfd_size_type len);
9069   *Description*
9070Computes a CRC value as used in the .gnu_debuglink section.  Advances
9071the previously computed CRC value by computing and adding in the crc32
9072for LEN bytes of BUF.
9073
9074   *Returns*
9075Return the updated CRC32 value.
9076
90772.14.1.16 'bfd_get_debug_link_info_1'
9078.....................................
9079
9080*Synopsis*
9081     char *bfd_get_debug_link_info_1 (bfd *abfd, void *crc32_out);
9082   *Description*
9083Extracts the filename and CRC32 value for any separate debug information
9084file associated with ABFD.
9085
9086   The CRC32_OUT parameter is an untyped pointer because this routine is
9087used as a 'get_func_type' function, but it is expected to be an unsigned
9088long pointer.
9089
9090   *Returns*
9091The filename of the associated debug information file, or NULL if there
9092is no such file.  If the filename was found then the contents of
9093CRC32_OUT are updated to hold the corresponding CRC32 value for the
9094file.
9095
9096   The returned filename is allocated with 'malloc'; freeing it is the
9097responsibility of the caller.
9098
90992.14.1.17 'bfd_get_debug_link_info'
9100...................................
9101
9102*Synopsis*
9103     char *bfd_get_debug_link_info (bfd *abfd, unsigned long *crc32_out);
9104   *Description*
9105Extracts the filename and CRC32 value for any separate debug information
9106file associated with ABFD.
9107
9108   *Returns*
9109The filename of the associated debug information file, or NULL if there
9110is no such file.  If the filename was found then the contents of
9111CRC32_OUT are updated to hold the corresponding CRC32 value for the
9112file.
9113
9114   The returned filename is allocated with 'malloc'; freeing it is the
9115responsibility of the caller.
9116
91172.14.1.18 'bfd_get_alt_debug_link_info'
9118.......................................
9119
9120*Synopsis*
9121     char *bfd_get_alt_debug_link_info (bfd * abfd,
9122         bfd_size_type *buildid_len,
9123         bfd_byte **buildid_out);
9124   *Description*
9125Fetch the filename and BuildID value for any alternate debuginfo
9126associated with ABFD.  Return NULL if no such info found, otherwise
9127return filename and update BUILDID_LEN and BUILDID_OUT.  The returned
9128filename and build_id are allocated with 'malloc'; freeing them is the
9129responsibility of the caller.
9130
91312.14.1.19 'separate_debug_file_exists'
9132......................................
9133
9134*Synopsis*
9135     bfd_boolean separate_debug_file_exists
9136        (char *name, void *crc32_p);
9137   *Description*
9138Checks to see if NAME is a file and if its contents match CRC32, which
9139is a pointer to an 'unsigned long' containing a CRC32.
9140
9141   The CRC32_P parameter is an untyped pointer because this routine is
9142used as a 'check_func_type' function.
9143
91442.14.1.20 'separate_alt_debug_file_exists'
9145..........................................
9146
9147*Synopsis*
9148     bfd_boolean separate_alt_debug_file_exists
9149        (char *name, void *unused);
9150   *Description*
9151Checks to see if NAME is a file.
9152
91532.14.1.21 'find_separate_debug_file'
9154....................................
9155
9156*Synopsis*
9157     char *find_separate_debug_file
9158        (bfd *abfd, const char *dir, bfd_boolean include_dirs,
9159         get_func_type get, check_func_type check, void *data);
9160   *Description*
9161Searches for a debug information file corresponding to ABFD.
9162
9163   The name of the separate debug info file is returned by the GET
9164function.  This function scans various fixed locations in the
9165filesystem, including the file tree rooted at DIR.  If the INCLUDE_DIRS
9166parameter is true then the directory components of ABFD's filename will
9167be included in the searched locations.
9168
9169   DATA is passed unmodified to the GET and CHECK functions.  It is
9170generally used to implement build-id-like matching in the callback
9171functions.
9172
9173   *Returns*
9174Returns the filename of the first file to be found which receives a TRUE
9175result from the CHECK function.  Returns NULL if no valid file could be
9176found.
9177
91782.14.1.22 'bfd_follow_gnu_debuglink'
9179....................................
9180
9181*Synopsis*
9182     char *bfd_follow_gnu_debuglink (bfd *abfd, const char *dir);
9183   *Description*
9184Takes a BFD and searches it for a .gnu_debuglink section.  If this
9185section is found, it examines the section for the name and checksum of a
9186'.debug' file containing auxiliary debugging information.  It then
9187searches the filesystem for this .debug file in some standard locations,
9188including the directory tree rooted at DIR, and if found returns the
9189full filename.
9190
9191   If DIR is NULL, the search will take place starting at the current
9192directory.
9193
9194   *Returns*
9195'NULL' on any errors or failure to locate the .debug file, otherwise a
9196pointer to a heap-allocated string containing the filename.  The caller
9197is responsible for freeing this string.
9198
91992.14.1.23 'bfd_follow_gnu_debugaltlink'
9200.......................................
9201
9202*Synopsis*
9203     char *bfd_follow_gnu_debugaltlink (bfd *abfd, const char *dir);
9204   *Description*
9205Takes a BFD and searches it for a .gnu_debugaltlink section.  If this
9206section is found, it examines the section for the name of a file
9207containing auxiliary debugging information.  It then searches the
9208filesystem for this file in a set of standard locations, including the
9209directory tree rooted at DIR, and if found returns the full filename.
9210
9211   If DIR is NULL, the search will take place starting at the current
9212directory.
9213
9214   *Returns*
9215'NULL' on any errors or failure to locate the debug file, otherwise a
9216pointer to a heap-allocated string containing the filename.  The caller
9217is responsible for freeing this string.
9218
92192.14.1.24 'bfd_create_gnu_debuglink_section'
9220............................................
9221
9222*Synopsis*
9223     struct bfd_section *bfd_create_gnu_debuglink_section
9224        (bfd *abfd, const char *filename);
9225   *Description*
9226Takes a BFD and adds a .gnu_debuglink section to it.  The section is
9227sized to be big enough to contain a link to the specified FILENAME.
9228
9229   *Returns*
9230A pointer to the new section is returned if all is ok.  Otherwise 'NULL'
9231is returned and bfd_error is set.
9232
92332.14.1.25 'bfd_fill_in_gnu_debuglink_section'
9234.............................................
9235
9236*Synopsis*
9237     bfd_boolean bfd_fill_in_gnu_debuglink_section
9238        (bfd *abfd, struct bfd_section *sect, const char *filename);
9239   *Description*
9240Takes a BFD and containing a .gnu_debuglink section SECT and fills in
9241the contents of the section to contain a link to the specified FILENAME.
9242The filename should be relative to the current directory.
9243
9244   *Returns*
9245'TRUE' is returned if all is ok.  Otherwise 'FALSE' is returned and
9246bfd_error is set.
9247
92482.14.1.26 'get_build_id'
9249........................
9250
9251*Synopsis*
9252     struct bfd_build_id * get_build_id (bfd *abfd);
9253   *Description*
9254Finds the build-id associated with ABFD.  If the build-id is extracted
9255from the note section then a build-id structure is built for it, using
9256memory allocated to ABFD, and this is then attached to the ABFD.
9257
9258   *Returns*
9259Returns a pointer to the build-id structure if a build-id could be
9260found.  If no build-id is found NULL is returned and error code is set.
9261
92622.14.1.27 'get_build_id_name'
9263.............................
9264
9265*Synopsis*
9266     char * get_build_id_name (bfd *abfd, void *build_id_out_p)
9267   *Description*
9268Searches ABFD for a build-id, and then constructs a pathname from it.
9269The path is computed as .build-id/NN/NN+NN.debug where NNNN+NN is the
9270build-id value as a hexadecimal string.
9271
9272   *Returns*
9273Returns the constructed filename or NULL upon error.  It is the caller's
9274responsibility to free the memory used to hold the filename.  If a
9275filename is returned then the BUILD_ID_OUT_P parameter (which points to
9276a 'struct bfd_build_id' pointer) is set to a pointer to the build_id
9277structure.
9278
92792.14.1.28 'check_build_id_file'
9280...............................
9281
9282*Synopsis*
9283     bfd_boolean check_build_id_file (char *name, void *buildid_p);
9284   *Description*
9285Checks to see if NAME is a readable file and if its build-id matches
9286BUILDID.
9287
9288   *Returns*
9289Returns TRUE if the file exists, is readable, and contains a build-id
9290which matches the build-id pointed at by BUILD_ID_P (which is really a
9291'struct bfd_build_id **').
9292
92932.14.1.29 'bfd_follow_build_id_debuglink'
9294.........................................
9295
9296*Synopsis*
9297     char *bfd_follow_build_id_debuglink (bfd *abfd, const char *dir);
9298   *Description*
9299Takes ABFD and searches it for a .note.gnu.build-id section.  If this
9300section is found, it extracts the value of the NT_GNU_BUILD_ID note,
9301which should be a hexadecimal value NNNN+NN (for 32+ hex digits).  It
9302then searches the filesystem for a file named .BUILD-ID/NN/NN+NN.DEBUG
9303in a set of standard locations, including the directory tree rooted at
9304DIR.  The filename of the first matching file to be found is returned.
9305A matching file should contain a .note.gnu.build-id section with the
9306same NNNN+NN note as ABFD, although this check is currently not
9307implemented.
9308
9309   If DIR is NULL, the search will take place starting at the current
9310directory.
9311
9312   *Returns*
9313'NULL' on any errors or failure to locate the debug file, otherwise a
9314pointer to a heap-allocated string containing the filename.  The caller
9315is responsible for freeing this string.
9316
93172.14.1.30 'bfd_set_filename'
9318............................
9319
9320*Synopsis*
9321     const char *bfd_set_filename (bfd *abfd, const char *filename);
9322   *Description*
9323Set the filename of ABFD, copying the FILENAME parameter to bfd_alloc'd
9324memory owned by ABFD.  Returns a pointer the newly allocated name, or
9325NULL if the allocation failed.
9326
9327
9328File: bfd.info,  Node: Internal,  Next: File Caching,  Prev: Opening and Closing,  Up: BFD front end
9329
93302.15 Implementation details
9331===========================
9332
93332.15.1 Internal functions
9334-------------------------
9335
9336*Description*
9337These routines are used within BFD. They are not intended for export,
9338but are documented here for completeness.
9339
93402.15.1.1 'bfd_write_bigendian_4byte_int'
9341........................................
9342
9343*Synopsis*
9344     bfd_boolean bfd_write_bigendian_4byte_int (bfd *, unsigned int);
9345   *Description*
9346Write a 4 byte integer I to the output BFD ABFD, in big endian order
9347regardless of what else is going on.  This is useful in archives.
9348
93492.15.1.2 'bfd_put_size'
9350.......................
9351
93522.15.1.3 'bfd_get_size'
9353.......................
9354
9355*Description*
9356These macros as used for reading and writing raw data in sections; each
9357access (except for bytes) is vectored through the target format of the
9358BFD and mangled accordingly.  The mangling performs any necessary endian
9359translations and removes alignment restrictions.  Note that types
9360accepted and returned by these macros are identical so they can be
9361swapped around in macros--for example, 'libaout.h' defines 'GET_WORD' to
9362either 'bfd_get_32' or 'bfd_get_64'.
9363
9364   In the put routines, VAL must be a 'bfd_vma'.  If we are on a system
9365without prototypes, the caller is responsible for making sure that is
9366true, with a cast if necessary.  We don't cast them in the macro
9367definitions because that would prevent 'lint' or 'gcc -Wall' from
9368detecting sins such as passing a pointer.  To detect calling these with
9369less than a 'bfd_vma', use 'gcc -Wconversion' on a host with 64 bit
9370'bfd_vma''s.
9371
9372     /* Byte swapping macros for user section data.  */
9373
9374     #define bfd_put_8(abfd, val, ptr) \
9375       ((void) (*((unsigned char *) (ptr)) = (val) & 0xff))
9376     #define bfd_put_signed_8 \
9377       bfd_put_8
9378     #define bfd_get_8(abfd, ptr) \
9379       ((bfd_vma) *(const unsigned char *) (ptr) & 0xff)
9380     #define bfd_get_signed_8(abfd, ptr) \
9381       ((((bfd_signed_vma) *(const unsigned char *) (ptr) & 0xff) ^ 0x80) - 0x80)
9382
9383     #define bfd_put_16(abfd, val, ptr) \
9384       BFD_SEND (abfd, bfd_putx16, ((val),(ptr)))
9385     #define bfd_put_signed_16 \
9386       bfd_put_16
9387     #define bfd_get_16(abfd, ptr) \
9388       BFD_SEND (abfd, bfd_getx16, (ptr))
9389     #define bfd_get_signed_16(abfd, ptr) \
9390       BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
9391
9392     #define bfd_put_24(abfd, val, ptr) \
9393       do                                   \
9394         if (bfd_big_endian (abfd))         \
9395           bfd_putb24 ((val), (ptr));       \
9396         else                               \
9397           bfd_putl24 ((val), (ptr));       \
9398       while (0)
9399
9400     bfd_vma bfd_getb24 (const void *p);
9401     bfd_vma bfd_getl24 (const void *p);
9402
9403     #define bfd_get_24(abfd, ptr) \
9404       (bfd_big_endian (abfd) ? bfd_getb24 (ptr) : bfd_getl24 (ptr))
9405
9406     #define bfd_put_32(abfd, val, ptr) \
9407       BFD_SEND (abfd, bfd_putx32, ((val),(ptr)))
9408     #define bfd_put_signed_32 \
9409       bfd_put_32
9410     #define bfd_get_32(abfd, ptr) \
9411       BFD_SEND (abfd, bfd_getx32, (ptr))
9412     #define bfd_get_signed_32(abfd, ptr) \
9413       BFD_SEND (abfd, bfd_getx_signed_32, (ptr))
9414
9415     #define bfd_put_64(abfd, val, ptr) \
9416       BFD_SEND (abfd, bfd_putx64, ((val), (ptr)))
9417     #define bfd_put_signed_64 \
9418       bfd_put_64
9419     #define bfd_get_64(abfd, ptr) \
9420       BFD_SEND (abfd, bfd_getx64, (ptr))
9421     #define bfd_get_signed_64(abfd, ptr) \
9422       BFD_SEND (abfd, bfd_getx_signed_64, (ptr))
9423
9424     #define bfd_get(bits, abfd, ptr)                       \
9425       ((bits) == 8 ? bfd_get_8 (abfd, ptr)                 \
9426        : (bits) == 16 ? bfd_get_16 (abfd, ptr)             \
9427        : (bits) == 32 ? bfd_get_32 (abfd, ptr)             \
9428        : (bits) == 64 ? bfd_get_64 (abfd, ptr)             \
9429        : (abort (), (bfd_vma) - 1))
9430
9431     #define bfd_put(bits, abfd, val, ptr)                  \
9432       ((bits) == 8 ? bfd_put_8  (abfd, val, ptr)           \
9433        : (bits) == 16 ? bfd_put_16 (abfd, val, ptr)        \
9434        : (bits) == 32 ? bfd_put_32 (abfd, val, ptr)        \
9435        : (bits) == 64 ? bfd_put_64 (abfd, val, ptr)        \
9436        : (abort (), (void) 0))
9437
94382.15.1.4 'bfd_h_put_size'
9439.........................
9440
9441*Description*
9442These macros have the same function as their 'bfd_get_x' brethren,
9443except that they are used for removing information for the header
9444records of object files.  Believe it or not, some object files keep
9445their header records in big endian order and their data in little endian
9446order.
9447
9448     /* Byte swapping macros for file header data.  */
9449
9450     #define bfd_h_put_8(abfd, val, ptr) \
9451       bfd_put_8 (abfd, val, ptr)
9452     #define bfd_h_put_signed_8(abfd, val, ptr) \
9453       bfd_put_8 (abfd, val, ptr)
9454     #define bfd_h_get_8(abfd, ptr) \
9455       bfd_get_8 (abfd, ptr)
9456     #define bfd_h_get_signed_8(abfd, ptr) \
9457       bfd_get_signed_8 (abfd, ptr)
9458
9459     #define bfd_h_put_16(abfd, val, ptr) \
9460       BFD_SEND (abfd, bfd_h_putx16, (val, ptr))
9461     #define bfd_h_put_signed_16 \
9462       bfd_h_put_16
9463     #define bfd_h_get_16(abfd, ptr) \
9464       BFD_SEND (abfd, bfd_h_getx16, (ptr))
9465     #define bfd_h_get_signed_16(abfd, ptr) \
9466       BFD_SEND (abfd, bfd_h_getx_signed_16, (ptr))
9467
9468     #define bfd_h_put_32(abfd, val, ptr) \
9469       BFD_SEND (abfd, bfd_h_putx32, (val, ptr))
9470     #define bfd_h_put_signed_32 \
9471       bfd_h_put_32
9472     #define bfd_h_get_32(abfd, ptr) \
9473       BFD_SEND (abfd, bfd_h_getx32, (ptr))
9474     #define bfd_h_get_signed_32(abfd, ptr) \
9475       BFD_SEND (abfd, bfd_h_getx_signed_32, (ptr))
9476
9477     #define bfd_h_put_64(abfd, val, ptr) \
9478       BFD_SEND (abfd, bfd_h_putx64, (val, ptr))
9479     #define bfd_h_put_signed_64 \
9480       bfd_h_put_64
9481     #define bfd_h_get_64(abfd, ptr) \
9482       BFD_SEND (abfd, bfd_h_getx64, (ptr))
9483     #define bfd_h_get_signed_64(abfd, ptr) \
9484       BFD_SEND (abfd, bfd_h_getx_signed_64, (ptr))
9485
9486     /* Aliases for the above, which should eventually go away.  */
9487
9488     #define H_PUT_64  bfd_h_put_64
9489     #define H_PUT_32  bfd_h_put_32
9490     #define H_PUT_16  bfd_h_put_16
9491     #define H_PUT_8   bfd_h_put_8
9492     #define H_PUT_S64 bfd_h_put_signed_64
9493     #define H_PUT_S32 bfd_h_put_signed_32
9494     #define H_PUT_S16 bfd_h_put_signed_16
9495     #define H_PUT_S8  bfd_h_put_signed_8
9496     #define H_GET_64  bfd_h_get_64
9497     #define H_GET_32  bfd_h_get_32
9498     #define H_GET_16  bfd_h_get_16
9499     #define H_GET_8   bfd_h_get_8
9500     #define H_GET_S64 bfd_h_get_signed_64
9501     #define H_GET_S32 bfd_h_get_signed_32
9502     #define H_GET_S16 bfd_h_get_signed_16
9503     #define H_GET_S8  bfd_h_get_signed_8
9504
9505
95062.15.1.5 'bfd_log2'
9507...................
9508
9509*Synopsis*
9510     unsigned int bfd_log2 (bfd_vma x);
9511   *Description*
9512Return the log base 2 of the value supplied, rounded up.  E.g., an X of
95131025 returns 11.  A X of 0 returns 0.
9514
9515
9516File: bfd.info,  Node: File Caching,  Next: Linker Functions,  Prev: Internal,  Up: BFD front end
9517
95182.16 File caching
9519=================
9520
9521The file caching mechanism is embedded within BFD and allows the
9522application to open as many BFDs as it wants without regard to the
9523underlying operating system's file descriptor limit (often as low as 20
9524open files).  The module in 'cache.c' maintains a least recently used
9525list of 'bfd_cache_max_open' files, and exports the name
9526'bfd_cache_lookup', which runs around and makes sure that the required
9527BFD is open.  If not, then it chooses a file to close, closes it and
9528opens the one wanted, returning its file handle.
9529
95302.16.1 Caching functions
9531------------------------
9532
95332.16.1.1 'bfd_cache_init'
9534.........................
9535
9536*Synopsis*
9537     bfd_boolean bfd_cache_init (bfd *abfd);
9538   *Description*
9539Add a newly opened BFD to the cache.
9540
95412.16.1.2 'bfd_cache_close'
9542..........................
9543
9544*Synopsis*
9545     bfd_boolean bfd_cache_close (bfd *abfd);
9546   *Description*
9547Remove the BFD ABFD from the cache.  If the attached file is open, then
9548close it too.
9549
9550   *Returns*
9551'FALSE' is returned if closing the file fails, 'TRUE' is returned if all
9552is well.
9553
95542.16.1.3 'bfd_cache_close_all'
9555..............................
9556
9557*Synopsis*
9558     bfd_boolean bfd_cache_close_all (void);
9559   *Description*
9560Remove all BFDs from the cache.  If the attached file is open, then
9561close it too.
9562
9563   *Returns*
9564'FALSE' is returned if closing one of the file fails, 'TRUE' is returned
9565if all is well.
9566
95672.16.1.4 'bfd_open_file'
9568........................
9569
9570*Synopsis*
9571     FILE* bfd_open_file (bfd *abfd);
9572   *Description*
9573Call the OS to open a file for ABFD.  Return the 'FILE *' (possibly
9574'NULL') that results from this operation.  Set up the BFD so that future
9575accesses know the file is open.  If the 'FILE *' returned is 'NULL',
9576then it won't have been put in the cache, so it won't have to be removed
9577from it.
9578
9579
9580File: bfd.info,  Node: Linker Functions,  Next: Hash Tables,  Prev: File Caching,  Up: BFD front end
9581
95822.17 Linker Functions
9583=====================
9584
9585The linker uses three special entry points in the BFD target vector.  It
9586is not necessary to write special routines for these entry points when
9587creating a new BFD back end, since generic versions are provided.
9588However, writing them can speed up linking and make it use significantly
9589less runtime memory.
9590
9591   The first routine creates a hash table used by the other routines.
9592The second routine adds the symbols from an object file to the hash
9593table.  The third routine takes all the object files and links them
9594together to create the output file.  These routines are designed so that
9595the linker proper does not need to know anything about the symbols in
9596the object files that it is linking.  The linker merely arranges the
9597sections as directed by the linker script and lets BFD handle the
9598details of symbols and relocs.
9599
9600   The second routine and third routines are passed a pointer to a
9601'struct bfd_link_info' structure (defined in 'bfdlink.h') which holds
9602information relevant to the link, including the linker hash table (which
9603was created by the first routine) and a set of callback functions to the
9604linker proper.
9605
9606   The generic linker routines are in 'linker.c', and use the header
9607file 'genlink.h'.  As of this writing, the only back ends which have
9608implemented versions of these routines are a.out (in 'aoutx.h') and
9609ECOFF (in 'ecoff.c').  The a.out routines are used as examples
9610throughout this section.
9611
9612* Menu:
9613
9614* Creating a Linker Hash Table::
9615* Adding Symbols to the Hash Table::
9616* Performing the Final Link::
9617
9618
9619File: bfd.info,  Node: Creating a Linker Hash Table,  Next: Adding Symbols to the Hash Table,  Prev: Linker Functions,  Up: Linker Functions
9620
96212.17.1 Creating a linker hash table
9622-----------------------------------
9623
9624The linker routines must create a hash table, which must be derived from
9625'struct bfd_link_hash_table' described in 'bfdlink.c'.  *Note Hash
9626Tables::, for information on how to create a derived hash table.  This
9627entry point is called using the target vector of the linker output file.
9628
9629   The '_bfd_link_hash_table_create' entry point must allocate and
9630initialize an instance of the desired hash table.  If the back end does
9631not require any additional information to be stored with the entries in
9632the hash table, the entry point may simply create a 'struct
9633bfd_link_hash_table'.  Most likely, however, some additional information
9634will be needed.
9635
9636   For example, with each entry in the hash table the a.out linker keeps
9637the index the symbol has in the final output file (this index number is
9638used so that when doing a relocatable link the symbol index used in the
9639output file can be quickly filled in when copying over a reloc).  The
9640a.out linker code defines the required structures and functions for a
9641hash table derived from 'struct bfd_link_hash_table'.  The a.out linker
9642hash table is created by the function
9643'NAME(aout,link_hash_table_create)'; it simply allocates space for the
9644hash table, initializes it, and returns a pointer to it.
9645
9646   When writing the linker routines for a new back end, you will
9647generally not know exactly which fields will be required until you have
9648finished.  You should simply create a new hash table which defines no
9649additional fields, and then simply add fields as they become necessary.
9650
9651
9652File: bfd.info,  Node: Adding Symbols to the Hash Table,  Next: Performing the Final Link,  Prev: Creating a Linker Hash Table,  Up: Linker Functions
9653
96542.17.2 Adding symbols to the hash table
9655---------------------------------------
9656
9657The linker proper will call the '_bfd_link_add_symbols' entry point for
9658each object file or archive which is to be linked (typically these are
9659the files named on the command line, but some may also come from the
9660linker script).  The entry point is responsible for examining the file.
9661For an object file, BFD must add any relevant symbol information to the
9662hash table.  For an archive, BFD must determine which elements of the
9663archive should be used and adding them to the link.
9664
9665   The a.out version of this entry point is
9666'NAME(aout,link_add_symbols)'.
9667
9668* Menu:
9669
9670* Differing file formats::
9671* Adding symbols from an object file::
9672* Adding symbols from an archive::
9673
9674
9675File: 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
9676
96772.17.2.1 Differing file formats
9678...............................
9679
9680Normally all the files involved in a link will be of the same format,
9681but it is also possible to link together different format object files,
9682and the back end must support that.  The '_bfd_link_add_symbols' entry
9683point is called via the target vector of the file to be added.  This has
9684an important consequence: the function may not assume that the hash
9685table is the type created by the corresponding
9686'_bfd_link_hash_table_create' vector.  All the '_bfd_link_add_symbols'
9687function can assume about the hash table is that it is derived from
9688'struct bfd_link_hash_table'.
9689
9690   Sometimes the '_bfd_link_add_symbols' function must store some
9691information in the hash table entry to be used by the '_bfd_final_link'
9692function.  In such a case the output bfd xvec must be checked to make
9693sure that the hash table was created by an object file of the same
9694format.
9695
9696   The '_bfd_final_link' routine must be prepared to handle a hash entry
9697without any extra information added by the '_bfd_link_add_symbols'
9698function.  A hash entry without extra information will also occur when
9699the linker script directs the linker to create a symbol.  Note that,
9700regardless of how a hash table entry is added, all the fields will be
9701initialized to some sort of null value by the hash table entry
9702initialization function.
9703
9704   See 'ecoff_link_add_externals' for an example of how to check the
9705output bfd before saving information (in this case, the ECOFF external
9706symbol debugging information) in a hash table entry.
9707
9708
9709File: 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
9710
97112.17.2.2 Adding symbols from an object file
9712...........................................
9713
9714When the '_bfd_link_add_symbols' routine is passed an object file, it
9715must add all externally visible symbols in that object file to the hash
9716table.  The actual work of adding the symbol to the hash table is
9717normally handled by the function '_bfd_generic_link_add_one_symbol'.
9718The '_bfd_link_add_symbols' routine is responsible for reading all the
9719symbols from the object file and passing the correct information to
9720'_bfd_generic_link_add_one_symbol'.
9721
9722   The '_bfd_link_add_symbols' routine should not use
9723'bfd_canonicalize_symtab' to read the symbols.  The point of providing
9724this routine is to avoid the overhead of converting the symbols into
9725generic 'asymbol' structures.
9726
9727   '_bfd_generic_link_add_one_symbol' handles the details of combining
9728common symbols, warning about multiple definitions, and so forth.  It
9729takes arguments which describe the symbol to add, notably symbol flags,
9730a section, and an offset.  The symbol flags include such things as
9731'BSF_WEAK' or 'BSF_INDIRECT'.  The section is a section in the object
9732file, or something like 'bfd_und_section_ptr' for an undefined symbol or
9733'bfd_com_section_ptr' for a common symbol.
9734
9735   If the '_bfd_final_link' routine is also going to need to read the
9736symbol information, the '_bfd_link_add_symbols' routine should save it
9737somewhere attached to the object file BFD. However, the information
9738should only be saved if the 'keep_memory' field of the 'info' argument
9739is TRUE, so that the '-no-keep-memory' linker switch is effective.
9740
9741   The a.out function which adds symbols from an object file is
9742'aout_link_add_object_symbols', and most of the interesting work is in
9743'aout_link_add_symbols'.  The latter saves pointers to the hash tables
9744entries created by '_bfd_generic_link_add_one_symbol' indexed by symbol
9745number, so that the '_bfd_final_link' routine does not have to call the
9746hash table lookup routine to locate the entry.
9747
9748
9749File: bfd.info,  Node: Adding symbols from an archive,  Prev: Adding symbols from an object file,  Up: Adding Symbols to the Hash Table
9750
97512.17.2.3 Adding symbols from an archive
9752.......................................
9753
9754When the '_bfd_link_add_symbols' routine is passed an archive, it must
9755look through the symbols defined by the archive and decide which
9756elements of the archive should be included in the link.  For each such
9757element it must call the 'add_archive_element' linker callback, and it
9758must add the symbols from the object file to the linker hash table.
9759(The callback may in fact indicate that a replacement BFD should be
9760used, in which case the symbols from that BFD should be added to the
9761linker hash table instead.)
9762
9763   In most cases the work of looking through the symbols in the archive
9764should be done by the '_bfd_generic_link_add_archive_symbols' function.
9765'_bfd_generic_link_add_archive_symbols' is passed a function to call to
9766make the final decision about adding an archive element to the link and
9767to do the actual work of adding the symbols to the linker hash table.
9768If the element is to be included, the 'add_archive_element' linker
9769callback routine must be called with the element as an argument, and the
9770element's symbols must be added to the linker hash table just as though
9771the element had itself been passed to the '_bfd_link_add_symbols'
9772function.
9773
9774   When the a.out '_bfd_link_add_symbols' function receives an archive,
9775it calls '_bfd_generic_link_add_archive_symbols' passing
9776'aout_link_check_archive_element' as the function argument.
9777'aout_link_check_archive_element' calls 'aout_link_check_ar_symbols'.
9778If the latter decides to add the element (an element is only added if it
9779provides a real, non-common, definition for a previously undefined or
9780common symbol) it calls the 'add_archive_element' callback and then
9781'aout_link_check_archive_element' calls 'aout_link_add_symbols' to
9782actually add the symbols to the linker hash table - possibly those of a
9783substitute BFD, if the 'add_archive_element' callback avails itself of
9784that option.
9785
9786   The ECOFF back end is unusual in that it does not normally call
9787'_bfd_generic_link_add_archive_symbols', because ECOFF archives already
9788contain a hash table of symbols.  The ECOFF back end searches the
9789archive itself to avoid the overhead of creating a new hash table.
9790
9791
9792File: bfd.info,  Node: Performing the Final Link,  Prev: Adding Symbols to the Hash Table,  Up: Linker Functions
9793
97942.17.3 Performing the final link
9795--------------------------------
9796
9797When all the input files have been processed, the linker calls the
9798'_bfd_final_link' entry point of the output BFD. This routine is
9799responsible for producing the final output file, which has several
9800aspects.  It must relocate the contents of the input sections and copy
9801the data into the output sections.  It must build an output symbol table
9802including any local symbols from the input files and the global symbols
9803from the hash table.  When producing relocatable output, it must modify
9804the input relocs and write them into the output file.  There may also be
9805object format dependent work to be done.
9806
9807   The linker will also call the 'write_object_contents' entry point
9808when the BFD is closed.  The two entry points must work together in
9809order to produce the correct output file.
9810
9811   The details of how this works are inevitably dependent upon the
9812specific object file format.  The a.out '_bfd_final_link' routine is
9813'NAME(aout,final_link)'.
9814
9815* Menu:
9816
9817* Information provided by the linker::
9818* Relocating the section contents::
9819* Writing the symbol table::
9820
9821
9822File: bfd.info,  Node: Information provided by the linker,  Next: Relocating the section contents,  Prev: Performing the Final Link,  Up: Performing the Final Link
9823
98242.17.3.1 Information provided by the linker
9825...........................................
9826
9827Before the linker calls the '_bfd_final_link' entry point, it sets up
9828some data structures for the function to use.
9829
9830   The 'input_bfds' field of the 'bfd_link_info' structure will point to
9831a list of all the input files included in the link.  These files are
9832linked through the 'link.next' field of the 'bfd' structure.
9833
9834   Each section in the output file will have a list of 'link_order'
9835structures attached to the 'map_head.link_order' field (the 'link_order'
9836structure is defined in 'bfdlink.h').  These structures describe how to
9837create the contents of the output section in terms of the contents of
9838various input sections, fill constants, and, eventually, other types of
9839information.  They also describe relocs that must be created by the BFD
9840backend, but do not correspond to any input file; this is used to
9841support -Ur, which builds constructors while generating a relocatable
9842object file.
9843
9844
9845File: bfd.info,  Node: Relocating the section contents,  Next: Writing the symbol table,  Prev: Information provided by the linker,  Up: Performing the Final Link
9846
98472.17.3.2 Relocating the section contents
9848........................................
9849
9850The '_bfd_final_link' function should look through the 'link_order'
9851structures attached to each section of the output file.  Each
9852'link_order' structure should either be handled specially, or it should
9853be passed to the function '_bfd_default_link_order' which will do the
9854right thing ('_bfd_default_link_order' is defined in 'linker.c').
9855
9856   For efficiency, a 'link_order' of type 'bfd_indirect_link_order'
9857whose associated section belongs to a BFD of the same format as the
9858output BFD must be handled specially.  This type of 'link_order'
9859describes part of an output section in terms of a section belonging to
9860one of the input files.  The '_bfd_final_link' function should read the
9861contents of the section and any associated relocs, apply the relocs to
9862the section contents, and write out the modified section contents.  If
9863performing a relocatable link, the relocs themselves must also be
9864modified and written out.
9865
9866   The functions '_bfd_relocate_contents' and '_bfd_final_link_relocate'
9867provide some general support for performing the actual relocations,
9868notably overflow checking.  Their arguments include information about
9869the symbol the relocation is against and a 'reloc_howto_type' argument
9870which describes the relocation to perform.  These functions are defined
9871in 'reloc.c'.
9872
9873   The a.out function which handles reading, relocating, and writing
9874section contents is 'aout_link_input_section'.  The actual relocation is
9875done in 'aout_link_input_section_std' and 'aout_link_input_section_ext'.
9876
9877
9878File: bfd.info,  Node: Writing the symbol table,  Prev: Relocating the section contents,  Up: Performing the Final Link
9879
98802.17.3.3 Writing the symbol table
9881.................................
9882
9883The '_bfd_final_link' function must gather all the symbols in the input
9884files and write them out.  It must also write out all the symbols in the
9885global hash table.  This must be controlled by the 'strip' and 'discard'
9886fields of the 'bfd_link_info' structure.
9887
9888   The local symbols of the input files will not have been entered into
9889the linker hash table.  The '_bfd_final_link' routine must consider each
9890input file and include the symbols in the output file.  It may be
9891convenient to do this when looking through the 'link_order' structures,
9892or it may be done by stepping through the 'input_bfds' list.
9893
9894   The '_bfd_final_link' routine must also traverse the global hash
9895table to gather all the externally visible symbols.  It is possible that
9896most of the externally visible symbols may be written out when
9897considering the symbols of each input file, but it is still necessary to
9898traverse the hash table since the linker script may have defined some
9899symbols that are not in any of the input files.
9900
9901   The 'strip' field of the 'bfd_link_info' structure controls which
9902symbols are written out.  The possible values are listed in 'bfdlink.h'.
9903If the value is 'strip_some', then the 'keep_hash' field of the
9904'bfd_link_info' structure is a hash table of symbols to keep; each
9905symbol should be looked up in this hash table, and only symbols which
9906are present should be included in the output file.
9907
9908   If the 'strip' field of the 'bfd_link_info' structure permits local
9909symbols to be written out, the 'discard' field is used to further
9910controls which local symbols are included in the output file.  If the
9911value is 'discard_l', then all local symbols which begin with a certain
9912prefix are discarded; this is controlled by the
9913'bfd_is_local_label_name' entry point.
9914
9915   The a.out backend handles symbols by calling
9916'aout_link_write_symbols' on each input BFD and then traversing the
9917global hash table with the function 'aout_link_write_other_symbol'.  It
9918builds a string table while writing out the symbols, which is written to
9919the output file at the end of 'NAME(aout,final_link)'.
9920
99212.17.3.4 'bfd_link_split_section'
9922.................................
9923
9924*Synopsis*
9925     bfd_boolean bfd_link_split_section (bfd *abfd, asection *sec);
9926   *Description*
9927Return nonzero if SEC should be split during a reloceatable or final
9928link.
9929     #define bfd_link_split_section(abfd, sec) \
9930            BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
9931
99322.17.3.5 'bfd_section_already_linked'
9933.....................................
9934
9935*Synopsis*
9936     bfd_boolean bfd_section_already_linked (bfd *abfd,
9937         asection *sec,
9938         struct bfd_link_info *info);
9939   *Description*
9940Check if DATA has been already linked during a reloceatable or final
9941link.  Return TRUE if it has.
9942     #define bfd_section_already_linked(abfd, sec, info) \
9943            BFD_SEND (abfd, _section_already_linked, (abfd, sec, info))
9944
99452.17.3.6 'bfd_generic_define_common_symbol'
9946...........................................
9947
9948*Synopsis*
9949     bfd_boolean bfd_generic_define_common_symbol
9950        (bfd *output_bfd, struct bfd_link_info *info,
9951         struct bfd_link_hash_entry *h);
9952   *Description*
9953Convert common symbol H into a defined symbol.  Return TRUE on success
9954and FALSE on failure.
9955     #define bfd_define_common_symbol(output_bfd, info, h) \
9956            BFD_SEND (output_bfd, _bfd_define_common_symbol, (output_bfd, info, h))
9957
99582.17.3.7 '_bfd_generic_link_hide_symbol'
9959........................................
9960
9961*Synopsis*
9962     void _bfd_generic_link_hide_symbol
9963        (bfd *output_bfd, struct bfd_link_info *info,
9964         struct bfd_link_hash_entry *h);
9965   *Description*
9966Hide symbol H.  This is an internal function.  It should not be called
9967from outside the BFD library.
9968     #define bfd_link_hide_symbol(output_bfd, info, h) \
9969            BFD_SEND (output_bfd, _bfd_link_hide_symbol, (output_bfd, info, h))
9970
99712.17.3.8 'bfd_generic_define_start_stop'
9972........................................
9973
9974*Synopsis*
9975     struct bfd_link_hash_entry *bfd_generic_define_start_stop
9976        (struct bfd_link_info *info,
9977         const char *symbol, asection *sec);
9978   *Description*
9979Define a __start, __stop, .startof.  or .sizeof.  symbol.  Return the
9980symbol or NULL if no such undefined symbol exists.
9981     #define bfd_define_start_stop(output_bfd, info, symbol, sec) \
9982            BFD_SEND (output_bfd, _bfd_define_start_stop, (info, symbol, sec))
9983
99842.17.3.9 'bfd_find_version_for_sym'
9985...................................
9986
9987*Synopsis*
9988     struct bfd_elf_version_tree * bfd_find_version_for_sym
9989        (struct bfd_elf_version_tree *verdefs,
9990         const char *sym_name, bfd_boolean *hide);
9991   *Description*
9992Search an elf version script tree for symbol versioning info and export
9993/ don't-export status for a given symbol.  Return non-NULL on success
9994and NULL on failure; also sets the output 'hide' boolean parameter.
9995
99962.17.3.10 'bfd_hide_sym_by_version'
9997...................................
9998
9999*Synopsis*
10000     bfd_boolean bfd_hide_sym_by_version
10001        (struct bfd_elf_version_tree *verdefs, const char *sym_name);
10002   *Description*
10003Search an elf version script tree for symbol versioning info for a given
10004symbol.  Return TRUE if the symbol is hidden.
10005
100062.17.3.11 'bfd_link_check_relocs'
10007.................................
10008
10009*Synopsis*
10010     bfd_boolean bfd_link_check_relocs
10011        (bfd *abfd, struct bfd_link_info *info);
10012   *Description*
10013Checks the relocs in ABFD for validity.  Does not execute the relocs.
10014Return TRUE if everything is OK, FALSE otherwise.  This is the external
10015entry point to this code.
10016
100172.17.3.12 '_bfd_generic_link_check_relocs'
10018..........................................
10019
10020*Synopsis*
10021     bfd_boolean _bfd_generic_link_check_relocs
10022        (bfd *abfd, struct bfd_link_info *info);
10023   *Description*
10024Stub function for targets that do not implement reloc checking.  Return
10025TRUE. This is an internal function.  It should not be called from
10026outside the BFD library.
10027
100282.17.3.13 'bfd_merge_private_bfd_data'
10029......................................
10030
10031*Synopsis*
10032     bfd_boolean bfd_merge_private_bfd_data
10033        (bfd *ibfd, struct bfd_link_info *info);
10034   *Description*
10035Merge private BFD information from the BFD IBFD to the the output file
10036BFD when linking.  Return 'TRUE' on success, 'FALSE' on error.  Possible
10037error returns are:
10038
10039   * 'bfd_error_no_memory' - Not enough memory exists to create private
10040     data for OBFD.
10041     #define bfd_merge_private_bfd_data(ibfd, info) \
10042            BFD_SEND ((info)->output_bfd, _bfd_merge_private_bfd_data, \
10043                      (ibfd, info))
10044
100452.17.3.14 '_bfd_generic_verify_endian_match'
10046............................................
10047
10048*Synopsis*
10049     bfd_boolean _bfd_generic_verify_endian_match
10050        (bfd *ibfd, struct bfd_link_info *info);
10051   *Description*
10052Can be used from / for bfd_merge_private_bfd_data to check that
10053endianness matches between input and output file.  Returns TRUE for a
10054match, otherwise returns FALSE and emits an error.
10055
10056
10057File: bfd.info,  Node: Hash Tables,  Prev: Linker Functions,  Up: BFD front end
10058
100592.18 Hash Tables
10060================
10061
10062BFD provides a simple set of hash table functions.  Routines are
10063provided to initialize a hash table, to free a hash table, to look up a
10064string in a hash table and optionally create an entry for it, and to
10065traverse a hash table.  There is currently no routine to delete an
10066string from a hash table.
10067
10068   The basic hash table does not permit any data to be stored with a
10069string.  However, a hash table is designed to present a base class from
10070which other types of hash tables may be derived.  These derived types
10071may store additional information with the string.  Hash tables were
10072implemented in this way, rather than simply providing a data pointer in
10073a hash table entry, because they were designed for use by the linker
10074back ends.  The linker may create thousands of hash table entries, and
10075the overhead of allocating private data and storing and following
10076pointers becomes noticeable.
10077
10078   The basic hash table code is in 'hash.c'.
10079
10080* Menu:
10081
10082* Creating and Freeing a Hash Table::
10083* Looking Up or Entering a String::
10084* Traversing a Hash Table::
10085* Deriving a New Hash Table Type::
10086
10087
10088File: bfd.info,  Node: Creating and Freeing a Hash Table,  Next: Looking Up or Entering a String,  Prev: Hash Tables,  Up: Hash Tables
10089
100902.18.1 Creating and freeing a hash table
10091----------------------------------------
10092
10093To create a hash table, create an instance of a 'struct bfd_hash_table'
10094(defined in 'bfd.h') and call 'bfd_hash_table_init' (if you know
10095approximately how many entries you will need, the function
10096'bfd_hash_table_init_n', which takes a SIZE argument, may be used).
10097'bfd_hash_table_init' returns 'FALSE' if some sort of error occurs.
10098
10099   The function 'bfd_hash_table_init' take as an argument a function to
10100use to create new entries.  For a basic hash table, use the function
10101'bfd_hash_newfunc'.  *Note Deriving a New Hash Table Type::, for why you
10102would want to use a different value for this argument.
10103
10104   'bfd_hash_table_init' will create an objalloc which will be used to
10105allocate new entries.  You may allocate memory on this objalloc using
10106'bfd_hash_allocate'.
10107
10108   Use 'bfd_hash_table_free' to free up all the memory that has been
10109allocated for a hash table.  This will not free up the 'struct
10110bfd_hash_table' itself, which you must provide.
10111
10112   Use 'bfd_hash_set_default_size' to set the default size of hash table
10113to use.
10114
10115
10116File: bfd.info,  Node: Looking Up or Entering a String,  Next: Traversing a Hash Table,  Prev: Creating and Freeing a Hash Table,  Up: Hash Tables
10117
101182.18.2 Looking up or entering a string
10119--------------------------------------
10120
10121The function 'bfd_hash_lookup' is used both to look up a string in the
10122hash table and to create a new entry.
10123
10124   If the CREATE argument is 'FALSE', 'bfd_hash_lookup' will look up a
10125string.  If the string is found, it will returns a pointer to a 'struct
10126bfd_hash_entry'.  If the string is not found in the table
10127'bfd_hash_lookup' will return 'NULL'.  You should not modify any of the
10128fields in the returns 'struct bfd_hash_entry'.
10129
10130   If the CREATE argument is 'TRUE', the string will be entered into the
10131hash table if it is not already there.  Either way a pointer to a
10132'struct bfd_hash_entry' will be returned, either to the existing
10133structure or to a newly created one.  In this case, a 'NULL' return
10134means that an error occurred.
10135
10136   If the CREATE argument is 'TRUE', and a new entry is created, the
10137COPY argument is used to decide whether to copy the string onto the hash
10138table objalloc or not.  If COPY is passed as 'FALSE', you must be
10139careful not to deallocate or modify the string as long as the hash table
10140exists.
10141
10142
10143File: bfd.info,  Node: Traversing a Hash Table,  Next: Deriving a New Hash Table Type,  Prev: Looking Up or Entering a String,  Up: Hash Tables
10144
101452.18.3 Traversing a hash table
10146------------------------------
10147
10148The function 'bfd_hash_traverse' may be used to traverse a hash table,
10149calling a function on each element.  The traversal is done in a random
10150order.
10151
10152   'bfd_hash_traverse' takes as arguments a function and a generic 'void
10153*' pointer.  The function is called with a hash table entry (a 'struct
10154bfd_hash_entry *') and the generic pointer passed to
10155'bfd_hash_traverse'.  The function must return a 'boolean' value, which
10156indicates whether to continue traversing the hash table.  If the
10157function returns 'FALSE', 'bfd_hash_traverse' will stop the traversal
10158and return immediately.
10159
10160
10161File: bfd.info,  Node: Deriving a New Hash Table Type,  Prev: Traversing a Hash Table,  Up: Hash Tables
10162
101632.18.4 Deriving a new hash table type
10164-------------------------------------
10165
10166Many uses of hash tables want to store additional information which each
10167entry in the hash table.  Some also find it convenient to store
10168additional information with the hash table itself.  This may be done
10169using a derived hash table.
10170
10171   Since C is not an object oriented language, creating a derived hash
10172table requires sticking together some boilerplate routines with a few
10173differences specific to the type of hash table you want to create.
10174
10175   An example of a derived hash table is the linker hash table.  The
10176structures for this are defined in 'bfdlink.h'.  The functions are in
10177'linker.c'.
10178
10179   You may also derive a hash table from an already derived hash table.
10180For example, the a.out linker backend code uses a hash table derived
10181from the linker hash table.
10182
10183* Menu:
10184
10185* Define the Derived Structures::
10186* Write the Derived Creation Routine::
10187* Write Other Derived Routines::
10188
10189
10190File: 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
10191
101922.18.4.1 Define the derived structures
10193......................................
10194
10195You must define a structure for an entry in the hash table, and a
10196structure for the hash table itself.
10197
10198   The first field in the structure for an entry in the hash table must
10199be of the type used for an entry in the hash table you are deriving
10200from.  If you are deriving from a basic hash table this is 'struct
10201bfd_hash_entry', which is defined in 'bfd.h'.  The first field in the
10202structure for the hash table itself must be of the type of the hash
10203table you are deriving from itself.  If you are deriving from a basic
10204hash table, this is 'struct bfd_hash_table'.
10205
10206   For example, the linker hash table defines 'struct
10207bfd_link_hash_entry' (in 'bfdlink.h').  The first field, 'root', is of
10208type 'struct bfd_hash_entry'.  Similarly, the first field in 'struct
10209bfd_link_hash_table', 'table', is of type 'struct bfd_hash_table'.
10210
10211
10212File: 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
10213
102142.18.4.2 Write the derived creation routine
10215...........................................
10216
10217You must write a routine which will create and initialize an entry in
10218the hash table.  This routine is passed as the function argument to
10219'bfd_hash_table_init'.
10220
10221   In order to permit other hash tables to be derived from the hash
10222table you are creating, this routine must be written in a standard way.
10223
10224   The first argument to the creation routine is a pointer to a hash
10225table entry.  This may be 'NULL', in which case the routine should
10226allocate the right amount of space.  Otherwise the space has already
10227been allocated by a hash table type derived from this one.
10228
10229   After allocating space, the creation routine must call the creation
10230routine of the hash table type it is derived from, passing in a pointer
10231to the space it just allocated.  This will initialize any fields used by
10232the base hash table.
10233
10234   Finally the creation routine must initialize any local fields for the
10235new hash table type.
10236
10237   Here is a boilerplate example of a creation routine.  FUNCTION_NAME
10238is the name of the routine.  ENTRY_TYPE is the type of an entry in the
10239hash table you are creating.  BASE_NEWFUNC is the name of the creation
10240routine of the hash table type your hash table is derived from.
10241
10242     struct bfd_hash_entry *
10243     FUNCTION_NAME (struct bfd_hash_entry *entry,
10244                          struct bfd_hash_table *table,
10245                          const char *string)
10246     {
10247       struct ENTRY_TYPE *ret = (ENTRY_TYPE *) entry;
10248
10249      /* Allocate the structure if it has not already been allocated by a
10250         derived class.  */
10251       if (ret == NULL)
10252         {
10253           ret = bfd_hash_allocate (table, sizeof (* ret));
10254           if (ret == NULL)
10255             return NULL;
10256         }
10257
10258      /* Call the allocation method of the base class.  */
10259       ret = ((ENTRY_TYPE *)
10260              BASE_NEWFUNC ((struct bfd_hash_entry *) ret, table, string));
10261
10262      /* Initialize the local fields here.  */
10263
10264       return (struct bfd_hash_entry *) ret;
10265     }
10266   *Description*
10267The creation routine for the linker hash table, which is in 'linker.c',
10268looks just like this example.  FUNCTION_NAME is
10269'_bfd_link_hash_newfunc'.  ENTRY_TYPE is 'struct bfd_link_hash_entry'.
10270BASE_NEWFUNC is 'bfd_hash_newfunc', the creation routine for a basic
10271hash table.
10272
10273   '_bfd_link_hash_newfunc' also initializes the local fields in a
10274linker hash table entry: 'type', 'written' and 'next'.
10275
10276
10277File: bfd.info,  Node: Write Other Derived Routines,  Prev: Write the Derived Creation Routine,  Up: Deriving a New Hash Table Type
10278
102792.18.4.3 Write other derived routines
10280.....................................
10281
10282You will want to write other routines for your new hash table, as well.
10283
10284   You will want an initialization routine which calls the
10285initialization routine of the hash table you are deriving from and
10286initializes any other local fields.  For the linker hash table, this is
10287'_bfd_link_hash_table_init' in 'linker.c'.
10288
10289   You will want a lookup routine which calls the lookup routine of the
10290hash table you are deriving from and casts the result.  The linker hash
10291table uses 'bfd_link_hash_lookup' in 'linker.c' (this actually takes an
10292additional argument which it uses to decide how to return the looked up
10293value).
10294
10295   You may want a traversal routine.  This should just call the
10296traversal routine of the hash table you are deriving from with
10297appropriate casts.  The linker hash table uses 'bfd_link_hash_traverse'
10298in 'linker.c'.
10299
10300   These routines may simply be defined as macros.  For example, the
10301a.out backend linker hash table, which is derived from the linker hash
10302table, uses macros for the lookup and traversal routines.  These are
10303'aout_link_hash_lookup' and 'aout_link_hash_traverse' in aoutx.h.
10304
10305
10306File: bfd.info,  Node: BFD back ends,  Next: GNU Free Documentation License,  Prev: BFD front end,  Up: Top
10307
103083 BFD back ends
10309***************
10310
10311* Menu:
10312
10313* What to Put Where::
10314* aout ::	a.out backends
10315* coff ::	coff backends
10316* elf  ::	elf backends
10317* mmo  ::	mmo backend
10318
10319
10320File: bfd.info,  Node: What to Put Where,  Next: aout,  Prev: BFD back ends,  Up: BFD back ends
10321
103223.1 What to Put Where
10323=====================
10324
10325All of BFD lives in one directory.
10326
10327
10328File: bfd.info,  Node: aout,  Next: coff,  Prev: What to Put Where,  Up: BFD back ends
10329
103303.2 a.out backends
10331==================
10332
10333*Description*
10334BFD supports a number of different flavours of a.out format, though the
10335major differences are only the sizes of the structures on disk, and the
10336shape of the relocation information.
10337
10338   The support is split into a basic support file 'aoutx.h' and other
10339files which derive functions from the base.  One derivation file is
10340'aoutf1.h' (for a.out flavour 1), and adds to the basic a.out functions
10341support for sun3, sun4, and 386 a.out files, to create a target jump
10342vector for a specific target.
10343
10344   This information is further split out into more specific files for
10345each machine, including 'sunos.c' for sun3 and sun4, and 'demo64.c' for
10346a demonstration of a 64 bit a.out format.
10347
10348   The base file 'aoutx.h' defines general mechanisms for reading and
10349writing records to and from disk and various other methods which BFD
10350requires.  It is included by 'aout32.c' and 'aout64.c' to form the names
10351'aout_32_swap_exec_header_in', 'aout_64_swap_exec_header_in', etc.
10352
10353   As an example, this is what goes on to make the back end for a sun4,
10354from 'aout32.c':
10355
10356            #define ARCH_SIZE 32
10357            #include "aoutx.h"
10358
10359   Which exports names:
10360
10361            ...
10362            aout_32_canonicalize_reloc
10363            aout_32_find_nearest_line
10364            aout_32_get_lineno
10365            aout_32_get_reloc_upper_bound
10366            ...
10367
10368   from 'sunos.c':
10369
10370            #define TARGET_NAME "a.out-sunos-big"
10371            #define VECNAME    sparc_aout_sunos_be_vec
10372            #include "aoutf1.h"
10373
10374   requires all the names from 'aout32.c', and produces the jump vector
10375
10376            sparc_aout_sunos_be_vec
10377
10378   The file 'host-aout.c' is a special case.  It is for a large set of
10379hosts that use "more or less standard" a.out files, and for which
10380cross-debugging is not interesting.  It uses the standard 32-bit a.out
10381support routines, but determines the file offsets and addresses of the
10382text, data, and BSS sections, the machine architecture and machine type,
10383and the entry point address, in a host-dependent manner.  Once these
10384values have been determined, generic code is used to handle the object
10385file.
10386
10387   When porting it to run on a new system, you must supply:
10388
10389             HOST_PAGE_SIZE
10390             HOST_SEGMENT_SIZE
10391             HOST_MACHINE_ARCH       (optional)
10392             HOST_MACHINE_MACHINE    (optional)
10393             HOST_TEXT_START_ADDR
10394             HOST_STACK_END_ADDR
10395
10396   in the file '../include/sys/h-XXX.h' (for your host).  These values,
10397plus the structures and macros defined in 'a.out.h' on your host system,
10398will produce a BFD target that will access ordinary a.out files on your
10399host.  To configure a new machine to use 'host-aout.c', specify:
10400
10401            TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec
10402            TDEPFILES= host-aout.o trad-core.o
10403
10404   in the 'config/XXX.mt' file, and modify 'configure.ac' to use the
10405'XXX.mt' file (by setting "'bfd_target=XXX'") when your configuration is
10406selected.
10407
104083.2.1 Relocations
10409-----------------
10410
10411*Description*
10412The file 'aoutx.h' provides for both the _standard_ and _extended_ forms
10413of a.out relocation records.
10414
10415   The standard records contain only an address, a symbol index, and a
10416type field.  The extended records also have a full integer for an
10417addend.
10418
104193.2.2 Internal entry points
10420---------------------------
10421
10422*Description*
10423'aoutx.h' exports several routines for accessing the contents of an
10424a.out file, which are gathered and exported in turn by various format
10425specific files (eg sunos.c).
10426
104273.2.2.1 'aout_SIZE_swap_exec_header_in'
10428.......................................
10429
10430*Synopsis*
10431     void aout_SIZE_swap_exec_header_in,
10432        (bfd *abfd,
10433         struct external_exec *bytes,
10434         struct internal_exec *execp);
10435   *Description*
10436Swap the information in an executable header RAW_BYTES taken from a raw
10437byte stream memory image into the internal exec header structure EXECP.
10438
104393.2.2.2 'aout_SIZE_swap_exec_header_out'
10440........................................
10441
10442*Synopsis*
10443     void aout_SIZE_swap_exec_header_out
10444        (bfd *abfd,
10445         struct internal_exec *execp,
10446         struct external_exec *raw_bytes);
10447   *Description*
10448Swap the information in an internal exec header structure EXECP into the
10449buffer RAW_BYTES ready for writing to disk.
10450
104513.2.2.3 'aout_SIZE_some_aout_object_p'
10452......................................
10453
10454*Synopsis*
10455     const bfd_target *aout_SIZE_some_aout_object_p
10456        (bfd *abfd,
10457         struct internal_exec *execp,
10458         const bfd_target *(*callback_to_real_object_p) (bfd *));
10459   *Description*
10460Some a.out variant thinks that the file open in ABFD checking is an
10461a.out file.  Do some more checking, and set up for access if it really
10462is.  Call back to the calling environment's "finish up" function just
10463before returning, to handle any last-minute setup.
10464
104653.2.2.4 'aout_SIZE_mkobject'
10466............................
10467
10468*Synopsis*
10469     bfd_boolean aout_SIZE_mkobject, (bfd *abfd);
10470   *Description*
10471Initialize BFD ABFD for use with a.out files.
10472
104733.2.2.5 'aout_SIZE_machine_type'
10474................................
10475
10476*Synopsis*
10477     enum machine_type  aout_SIZE_machine_type
10478        (enum bfd_architecture arch,
10479         unsigned long machine,
10480         bfd_boolean *unknown);
10481   *Description*
10482Keep track of machine architecture and machine type for a.out's.  Return
10483the 'machine_type' for a particular architecture and machine, or
10484'M_UNKNOWN' if that exact architecture and machine can't be represented
10485in a.out format.
10486
10487   If the architecture is understood, machine type 0 (default) is always
10488understood.
10489
104903.2.2.6 'aout_SIZE_set_arch_mach'
10491.................................
10492
10493*Synopsis*
10494     bfd_boolean aout_SIZE_set_arch_mach,
10495        (bfd *,
10496         enum bfd_architecture arch,
10497         unsigned long machine);
10498   *Description*
10499Set the architecture and the machine of the BFD ABFD to the values ARCH
10500and MACHINE.  Verify that ABFD's format can support the architecture
10501required.
10502
105033.2.2.7 'aout_SIZE_new_section_hook'
10504....................................
10505
10506*Synopsis*
10507     bfd_boolean aout_SIZE_new_section_hook,
10508        (bfd *abfd,
10509         asection *newsect);
10510   *Description*
10511Called by the BFD in response to a 'bfd_make_section' request.
10512
10513
10514File: bfd.info,  Node: coff,  Next: elf,  Prev: aout,  Up: BFD back ends
10515
105163.3 coff backends
10517=================
10518
10519BFD supports a number of different flavours of coff format.  The major
10520differences between formats are the sizes and alignments of fields in
10521structures on disk, and the occasional extra field.
10522
10523   Coff in all its varieties is implemented with a few common files and
10524a number of implementation specific files.  For example, the i386 coff
10525format is implemented in the file 'coff-i386.c'.  This file '#include's
10526'coff/i386.h' which defines the external structure of the coff format
10527for the i386, and 'coff/internal.h' which defines the internal
10528structure.  'coff-i386.c' also defines the relocations used by the i386
10529coff format *Note Relocations::.
10530
105313.3.1 Porting to a new version of coff
10532--------------------------------------
10533
10534The recommended method is to select from the existing implementations
10535the version of coff which is most like the one you want to use.  For
10536example, we'll say that i386 coff is the one you select, and that your
10537coff flavour is called foo.  Copy 'i386coff.c' to 'foocoff.c', copy
10538'../include/coff/i386.h' to '../include/coff/foo.h', and add the lines
10539to 'targets.c' and 'Makefile.in' so that your new back end is used.
10540Alter the shapes of the structures in '../include/coff/foo.h' so that
10541they match what you need.  You will probably also have to add '#ifdef's
10542to the code in 'coff/internal.h' and 'coffcode.h' if your version of
10543coff is too wild.
10544
10545   You can verify that your new BFD backend works quite simply by
10546building 'objdump' from the 'binutils' directory, and making sure that
10547its version of what's going on and your host system's idea (assuming it
10548has the pretty standard coff dump utility, usually called 'att-dump' or
10549just 'dump') are the same.  Then clean up your code, and send what
10550you've done to Cygnus.  Then your stuff will be in the next release, and
10551you won't have to keep integrating it.
10552
105533.3.2 How the coff backend works
10554--------------------------------
10555
105563.3.2.1 File layout
10557...................
10558
10559The Coff backend is split into generic routines that are applicable to
10560any Coff target and routines that are specific to a particular target.
10561The target-specific routines are further split into ones which are
10562basically the same for all Coff targets except that they use the
10563external symbol format or use different values for certain constants.
10564
10565   The generic routines are in 'coffgen.c'.  These routines work for any
10566Coff target.  They use some hooks into the target specific code; the
10567hooks are in a 'bfd_coff_backend_data' structure, one of which exists
10568for each target.
10569
10570   The essentially similar target-specific routines are in 'coffcode.h'.
10571This header file includes executable C code.  The various Coff targets
10572first include the appropriate Coff header file, make any special defines
10573that are needed, and then include 'coffcode.h'.
10574
10575   Some of the Coff targets then also have additional routines in the
10576target source file itself.
10577
105783.3.2.2 Coff long section names
10579...............................
10580
10581In the standard Coff object format, section names are limited to the
10582eight bytes available in the 's_name' field of the 'SCNHDR' section
10583header structure.  The format requires the field to be NUL-padded, but
10584not necessarily NUL-terminated, so the longest section names permitted
10585are a full eight characters.
10586
10587   The Microsoft PE variants of the Coff object file format add an
10588extension to support the use of long section names.  This extension is
10589defined in section 4 of the Microsoft PE/COFF specification (rev 8.1).
10590If a section name is too long to fit into the section header's 's_name'
10591field, it is instead placed into the string table, and the 's_name'
10592field is filled with a slash ("/") followed by the ASCII decimal
10593representation of the offset of the full name relative to the string
10594table base.
10595
10596   Note that this implies that the extension can only be used in object
10597files, as executables do not contain a string table.  The standard
10598specifies that long section names from objects emitted into executable
10599images are to be truncated.
10600
10601   However, as a GNU extension, BFD can generate executable images that
10602contain a string table and long section names.  This would appear to be
10603technically valid, as the standard only says that Coff debugging
10604information is deprecated, not forbidden, and in practice it works,
10605although some tools that parse PE files expecting the MS standard format
10606may become confused; 'PEview' is one known example.
10607
10608   The functionality is supported in BFD by code implemented under the
10609control of the macro 'COFF_LONG_SECTION_NAMES'.  If not defined, the
10610format does not support long section names in any way.  If defined, it
10611is used to initialise a flag, '_bfd_coff_long_section_names', and a hook
10612function pointer, '_bfd_coff_set_long_section_names', in the Coff
10613backend data structure.  The flag controls the generation of long
10614section names in output BFDs at runtime; if it is false, as it will be
10615by default when generating an executable image, long section names are
10616truncated; if true, the long section names extension is employed.  The
10617hook points to a function that allows the value of the flag to be
10618altered at runtime, on formats that support long section names at all;
10619on other formats it points to a stub that returns an error indication.
10620
10621   With input BFDs, the flag is set according to whether any long
10622section names are detected while reading the section headers.  For a
10623completely new BFD, the flag is set to the default for the target
10624format.  This information can be used by a client of the BFD library
10625when deciding what output format to generate, and means that a BFD that
10626is opened for read and subsequently converted to a writeable BFD and
10627modified in-place will retain whatever format it had on input.
10628
10629   If 'COFF_LONG_SECTION_NAMES' is simply defined (blank), or is defined
10630to the value "1", then long section names are enabled by default; if it
10631is defined to the value zero, they are disabled by default (but still
10632accepted in input BFDs).  The header 'coffcode.h' defines a macro,
10633'COFF_DEFAULT_LONG_SECTION_NAMES', which is used in the backends to
10634initialise the backend data structure fields appropriately; see the
10635comments for further detail.
10636
106373.3.2.3 Bit twiddling
10638.....................
10639
10640Each flavour of coff supported in BFD has its own header file describing
10641the external layout of the structures.  There is also an internal
10642description of the coff layout, in 'coff/internal.h'.  A major function
10643of the coff backend is swapping the bytes and twiddling the bits to
10644translate the external form of the structures into the normal internal
10645form.  This is all performed in the 'bfd_swap'_thing_direction routines.
10646Some elements are different sizes between different versions of coff; it
10647is the duty of the coff version specific include file to override the
10648definitions of various packing routines in 'coffcode.h'.  E.g., the size
10649of line number entry in coff is sometimes 16 bits, and sometimes 32
10650bits.  '#define'ing 'PUT_LNSZ_LNNO' and 'GET_LNSZ_LNNO' will select the
10651correct one.  No doubt, some day someone will find a version of coff
10652which has a varying field size not catered to at the moment.  To port
10653BFD, that person will have to add more '#defines'.  Three of the bit
10654twiddling routines are exported to 'gdb'; 'coff_swap_aux_in',
10655'coff_swap_sym_in' and 'coff_swap_lineno_in'.  'GDB' reads the symbol
10656table on its own, but uses BFD to fix things up.  More of the bit
10657twiddlers are exported for 'gas'; 'coff_swap_aux_out',
10658'coff_swap_sym_out', 'coff_swap_lineno_out', 'coff_swap_reloc_out',
10659'coff_swap_filehdr_out', 'coff_swap_aouthdr_out',
10660'coff_swap_scnhdr_out'.  'Gas' currently keeps track of all the symbol
10661table and reloc drudgery itself, thereby saving the internal BFD
10662overhead, but uses BFD to swap things on the way out, making cross ports
10663much safer.  Doing so also allows BFD (and thus the linker) to use the
10664same header files as 'gas', which makes one avenue to disaster
10665disappear.
10666
106673.3.2.4 Symbol reading
10668......................
10669
10670The simple canonical form for symbols used by BFD is not rich enough to
10671keep all the information available in a coff symbol table.  The back end
10672gets around this problem by keeping the original symbol table around,
10673"behind the scenes".
10674
10675   When a symbol table is requested (through a call to
10676'bfd_canonicalize_symtab'), a request gets through to
10677'coff_get_normalized_symtab'.  This reads the symbol table from the coff
10678file and swaps all the structures inside into the internal form.  It
10679also fixes up all the pointers in the table (represented in the file by
10680offsets from the first symbol in the table) into physical pointers to
10681elements in the new internal table.  This involves some work since the
10682meanings of fields change depending upon context: a field that is a
10683pointer to another structure in the symbol table at one moment may be
10684the size in bytes of a structure at the next.  Another pass is made over
10685the table.  All symbols which mark file names ('C_FILE' symbols) are
10686modified so that the internal string points to the value in the auxent
10687(the real filename) rather than the normal text associated with the
10688symbol ('".file"').
10689
10690   At this time the symbol names are moved around.  Coff stores all
10691symbols less than nine characters long physically within the symbol
10692table; longer strings are kept at the end of the file in the string
10693table.  This pass moves all strings into memory and replaces them with
10694pointers to the strings.
10695
10696   The symbol table is massaged once again, this time to create the
10697canonical table used by the BFD application.  Each symbol is inspected
10698in turn, and a decision made (using the 'sclass' field) about the
10699various flags to set in the 'asymbol'.  *Note Symbols::.  The generated
10700canonical table shares strings with the hidden internal symbol table.
10701
10702   Any linenumbers are read from the coff file too, and attached to the
10703symbols which own the functions the linenumbers belong to.
10704
107053.3.2.5 Symbol writing
10706......................
10707
10708Writing a symbol to a coff file which didn't come from a coff file will
10709lose any debugging information.  The 'asymbol' structure remembers the
10710BFD from which the symbol was taken, and on output the back end makes
10711sure that the same destination target as source target is present.
10712
10713   When the symbols have come from a coff file then all the debugging
10714information is preserved.
10715
10716   Symbol tables are provided for writing to the back end in a vector of
10717pointers to pointers.  This allows applications like the linker to
10718accumulate and output large symbol tables without having to do too much
10719byte copying.
10720
10721   This function runs through the provided symbol table and patches each
10722symbol marked as a file place holder ('C_FILE') to point to the next
10723file place holder in the list.  It also marks each 'offset' field in the
10724list with the offset from the first symbol of the current symbol.
10725
10726   Another function of this procedure is to turn the canonical value
10727form of BFD into the form used by coff.  Internally, BFD expects symbol
10728values to be offsets from a section base; so a symbol physically at
107290x120, but in a section starting at 0x100, would have the value 0x20.
10730Coff expects symbols to contain their final value, so symbols have their
10731values changed at this point to reflect their sum with their owning
10732section.  This transformation uses the 'output_section' field of the
10733'asymbol''s 'asection' *Note Sections::.
10734
10735   * 'coff_mangle_symbols'
10736   This routine runs though the provided symbol table and uses the
10737offsets generated by the previous pass and the pointers generated when
10738the symbol table was read in to create the structured hierarchy required
10739by coff.  It changes each pointer to a symbol into the index into the
10740symbol table of the asymbol.
10741
10742   * 'coff_write_symbols'
10743   This routine runs through the symbol table and patches up the symbols
10744from their internal form into the coff way, calls the bit twiddlers, and
10745writes out the table to the file.
10746
107473.3.2.6 'coff_symbol_type'
10748..........................
10749
10750*Description*
10751The hidden information for an 'asymbol' is described in a
10752'combined_entry_type':
10753
10754
10755     typedef struct coff_ptr_struct
10756     {
10757       /* Remembers the offset from the first symbol in the file for
10758          this symbol. Generated by coff_renumber_symbols.  */
10759       unsigned int offset;
10760
10761       /* Should the value of this symbol be renumbered.  Used for
10762          XCOFF C_BSTAT symbols.  Set by coff_slurp_symbol_table.  */
10763       unsigned int fix_value : 1;
10764
10765       /* Should the tag field of this symbol be renumbered.
10766          Created by coff_pointerize_aux.  */
10767       unsigned int fix_tag : 1;
10768
10769       /* Should the endidx field of this symbol be renumbered.
10770          Created by coff_pointerize_aux.  */
10771       unsigned int fix_end : 1;
10772
10773       /* Should the x_csect.x_scnlen field be renumbered.
10774          Created by coff_pointerize_aux.  */
10775       unsigned int fix_scnlen : 1;
10776
10777       /* Fix up an XCOFF C_BINCL/C_EINCL symbol.  The value is the
10778          index into the line number entries.  Set by coff_slurp_symbol_table.  */
10779       unsigned int fix_line : 1;
10780
10781       /* The container for the symbol structure as read and translated
10782          from the file.  */
10783       union
10784       {
10785         union internal_auxent auxent;
10786         struct internal_syment syment;
10787       } u;
10788
10789      /* Selector for the union above.  */
10790      bfd_boolean is_sym;
10791     } combined_entry_type;
10792
10793
10794     /* Each canonical asymbol really looks like this: */
10795
10796     typedef struct coff_symbol_struct
10797     {
10798       /* The actual symbol which the rest of BFD works with */
10799       asymbol symbol;
10800
10801       /* A pointer to the hidden information for this symbol */
10802       combined_entry_type *native;
10803
10804       /* A pointer to the linenumber information for this symbol */
10805       struct lineno_cache_entry *lineno;
10806
10807       /* Have the line numbers been relocated yet ? */
10808       bfd_boolean done_lineno;
10809     } coff_symbol_type;
10810
108113.3.2.7 'bfd_coff_backend_data'
10812...............................
10813
10814     /* COFF symbol classifications.  */
10815
10816     enum coff_symbol_classification
10817     {
10818       /* Global symbol.  */
10819       COFF_SYMBOL_GLOBAL,
10820       /* Common symbol.  */
10821       COFF_SYMBOL_COMMON,
10822       /* Undefined symbol.  */
10823       COFF_SYMBOL_UNDEFINED,
10824       /* Local symbol.  */
10825       COFF_SYMBOL_LOCAL,
10826       /* PE section symbol.  */
10827       COFF_SYMBOL_PE_SECTION
10828     };
10829
10830     typedef asection * (*coff_gc_mark_hook_fn)
10831       (asection *, struct bfd_link_info *, struct internal_reloc *,
10832        struct coff_link_hash_entry *, struct internal_syment *);
10833
10834   Special entry points for gdb to swap in coff symbol table parts:
10835     typedef struct
10836     {
10837       void (*_bfd_coff_swap_aux_in)
10838         (bfd *, void *, int, int, int, int, void *);
10839
10840       void (*_bfd_coff_swap_sym_in)
10841         (bfd *, void *, void *);
10842
10843       void (*_bfd_coff_swap_lineno_in)
10844         (bfd *, void *, void *);
10845
10846       unsigned int (*_bfd_coff_swap_aux_out)
10847         (bfd *, void *, int, int, int, int, void *);
10848
10849       unsigned int (*_bfd_coff_swap_sym_out)
10850         (bfd *, void *, void *);
10851
10852       unsigned int (*_bfd_coff_swap_lineno_out)
10853         (bfd *, void *, void *);
10854
10855       unsigned int (*_bfd_coff_swap_reloc_out)
10856         (bfd *, void *, void *);
10857
10858       unsigned int (*_bfd_coff_swap_filehdr_out)
10859         (bfd *, void *, void *);
10860
10861       unsigned int (*_bfd_coff_swap_aouthdr_out)
10862         (bfd *, void *, void *);
10863
10864       unsigned int (*_bfd_coff_swap_scnhdr_out)
10865         (bfd *, void *, void *);
10866
10867       unsigned int _bfd_filhsz;
10868       unsigned int _bfd_aoutsz;
10869       unsigned int _bfd_scnhsz;
10870       unsigned int _bfd_symesz;
10871       unsigned int _bfd_auxesz;
10872       unsigned int _bfd_relsz;
10873       unsigned int _bfd_linesz;
10874       unsigned int _bfd_filnmlen;
10875       bfd_boolean _bfd_coff_long_filenames;
10876
10877       bfd_boolean _bfd_coff_long_section_names;
10878       bfd_boolean (*_bfd_coff_set_long_section_names)
10879         (bfd *, int);
10880
10881       unsigned int _bfd_coff_default_section_alignment_power;
10882       bfd_boolean _bfd_coff_force_symnames_in_strings;
10883       unsigned int _bfd_coff_debug_string_prefix_length;
10884       unsigned int _bfd_coff_max_nscns;
10885
10886       void (*_bfd_coff_swap_filehdr_in)
10887         (bfd *, void *, void *);
10888
10889       void (*_bfd_coff_swap_aouthdr_in)
10890         (bfd *, void *, void *);
10891
10892       void (*_bfd_coff_swap_scnhdr_in)
10893         (bfd *, void *, void *);
10894
10895       void (*_bfd_coff_swap_reloc_in)
10896         (bfd *abfd, void *, void *);
10897
10898       bfd_boolean (*_bfd_coff_bad_format_hook)
10899         (bfd *, void *);
10900
10901       bfd_boolean (*_bfd_coff_set_arch_mach_hook)
10902         (bfd *, void *);
10903
10904       void * (*_bfd_coff_mkobject_hook)
10905         (bfd *, void *, void *);
10906
10907       bfd_boolean (*_bfd_styp_to_sec_flags_hook)
10908         (bfd *, void *, const char *, asection *, flagword *);
10909
10910       void (*_bfd_set_alignment_hook)
10911         (bfd *, asection *, void *);
10912
10913       bfd_boolean (*_bfd_coff_slurp_symbol_table)
10914         (bfd *);
10915
10916       bfd_boolean (*_bfd_coff_symname_in_debug)
10917         (bfd *, struct internal_syment *);
10918
10919       bfd_boolean (*_bfd_coff_pointerize_aux_hook)
10920         (bfd *, combined_entry_type *, combined_entry_type *,
10921          unsigned int, combined_entry_type *);
10922
10923       bfd_boolean (*_bfd_coff_print_aux)
10924         (bfd *, FILE *, combined_entry_type *, combined_entry_type *,
10925          combined_entry_type *, unsigned int);
10926
10927       void (*_bfd_coff_reloc16_extra_cases)
10928         (bfd *, struct bfd_link_info *, struct bfd_link_order *, arelent *,
10929          bfd_byte *, unsigned int *, unsigned int *);
10930
10931       int (*_bfd_coff_reloc16_estimate)
10932         (bfd *, asection *, arelent *, unsigned int,
10933          struct bfd_link_info *);
10934
10935       enum coff_symbol_classification (*_bfd_coff_classify_symbol)
10936         (bfd *, struct internal_syment *);
10937
10938       bfd_boolean (*_bfd_coff_compute_section_file_positions)
10939         (bfd *);
10940
10941       bfd_boolean (*_bfd_coff_start_final_link)
10942         (bfd *, struct bfd_link_info *);
10943
10944       bfd_boolean (*_bfd_coff_relocate_section)
10945         (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
10946          struct internal_reloc *, struct internal_syment *, asection **);
10947
10948       reloc_howto_type *(*_bfd_coff_rtype_to_howto)
10949         (bfd *, asection *, struct internal_reloc *,
10950          struct coff_link_hash_entry *, struct internal_syment *, bfd_vma *);
10951
10952       bfd_boolean (*_bfd_coff_adjust_symndx)
10953         (bfd *, struct bfd_link_info *, bfd *, asection *,
10954          struct internal_reloc *, bfd_boolean *);
10955
10956       bfd_boolean (*_bfd_coff_link_add_one_symbol)
10957         (struct bfd_link_info *, bfd *, const char *, flagword,
10958          asection *, bfd_vma, const char *, bfd_boolean, bfd_boolean,
10959          struct bfd_link_hash_entry **);
10960
10961       bfd_boolean (*_bfd_coff_link_output_has_begun)
10962         (bfd *, struct coff_final_link_info *);
10963
10964       bfd_boolean (*_bfd_coff_final_link_postscript)
10965         (bfd *, struct coff_final_link_info *);
10966
10967       bfd_boolean (*_bfd_coff_print_pdata)
10968         (bfd *, void *);
10969
10970     } bfd_coff_backend_data;
10971
10972     #define coff_backend_info(abfd) \
10973       ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
10974
10975     #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
10976       ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
10977
10978     #define bfd_coff_swap_sym_in(a,e,i) \
10979       ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
10980
10981     #define bfd_coff_swap_lineno_in(a,e,i) \
10982       ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
10983
10984     #define bfd_coff_swap_reloc_out(abfd, i, o) \
10985       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
10986
10987     #define bfd_coff_swap_lineno_out(abfd, i, o) \
10988       ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
10989
10990     #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
10991       ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
10992
10993     #define bfd_coff_swap_sym_out(abfd, i,o) \
10994       ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
10995
10996     #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
10997       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
10998
10999     #define bfd_coff_swap_filehdr_out(abfd, i,o) \
11000       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
11001
11002     #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
11003       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
11004
11005     #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
11006     #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
11007     #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
11008     #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
11009     #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
11010     #define bfd_coff_relsz(abfd)  (coff_backend_info (abfd)->_bfd_relsz)
11011     #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
11012     #define bfd_coff_filnmlen(abfd) (coff_backend_info (abfd)->_bfd_filnmlen)
11013     #define bfd_coff_long_filenames(abfd) \
11014       (coff_backend_info (abfd)->_bfd_coff_long_filenames)
11015     #define bfd_coff_long_section_names(abfd) \
11016       (coff_backend_info (abfd)->_bfd_coff_long_section_names)
11017     #define bfd_coff_set_long_section_names(abfd, enable) \
11018       ((coff_backend_info (abfd)->_bfd_coff_set_long_section_names) (abfd, enable))
11019     #define bfd_coff_default_section_alignment_power(abfd) \
11020       (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power)
11021     #define bfd_coff_max_nscns(abfd) \
11022       (coff_backend_info (abfd)->_bfd_coff_max_nscns)
11023
11024     #define bfd_coff_swap_filehdr_in(abfd, i,o) \
11025       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
11026
11027     #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
11028       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
11029
11030     #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
11031       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
11032
11033     #define bfd_coff_swap_reloc_in(abfd, i, o) \
11034       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
11035
11036     #define bfd_coff_bad_format_hook(abfd, filehdr) \
11037       ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
11038
11039     #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
11040       ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
11041     #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
11042       ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook)\
11043        (abfd, filehdr, aouthdr))
11044
11045     #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name, section, flags_ptr)\
11046       ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook)\
11047        (abfd, scnhdr, name, section, flags_ptr))
11048
11049     #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
11050       ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
11051
11052     #define bfd_coff_slurp_symbol_table(abfd)\
11053       ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
11054
11055     #define bfd_coff_symname_in_debug(abfd, sym)\
11056       ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
11057
11058     #define bfd_coff_force_symnames_in_strings(abfd)\
11059       (coff_backend_info (abfd)->_bfd_coff_force_symnames_in_strings)
11060
11061     #define bfd_coff_debug_string_prefix_length(abfd)\
11062       (coff_backend_info (abfd)->_bfd_coff_debug_string_prefix_length)
11063
11064     #define bfd_coff_print_aux(abfd, file, base, symbol, aux, indaux)\
11065       ((coff_backend_info (abfd)->_bfd_coff_print_aux)\
11066        (abfd, file, base, symbol, aux, indaux))
11067
11068     #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order,\
11069                                          reloc, data, src_ptr, dst_ptr)\
11070       ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
11071        (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
11072
11073     #define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
11074       ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
11075        (abfd, section, reloc, shrink, link_info))
11076
11077     #define bfd_coff_classify_symbol(abfd, sym)\
11078       ((coff_backend_info (abfd)->_bfd_coff_classify_symbol)\
11079        (abfd, sym))
11080
11081     #define bfd_coff_compute_section_file_positions(abfd)\
11082       ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
11083        (abfd))
11084
11085     #define bfd_coff_start_final_link(obfd, info)\
11086       ((coff_backend_info (obfd)->_bfd_coff_start_final_link)\
11087        (obfd, info))
11088     #define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
11089       ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
11090        (obfd, info, ibfd, o, con, rel, isyms, secs))
11091     #define bfd_coff_rtype_to_howto(abfd, sec, rel, h, sym, addendp)\
11092       ((coff_backend_info (abfd)->_bfd_coff_rtype_to_howto)\
11093        (abfd, sec, rel, h, sym, addendp))
11094     #define bfd_coff_adjust_symndx(obfd, info, ibfd, sec, rel, adjustedp)\
11095       ((coff_backend_info (abfd)->_bfd_coff_adjust_symndx)\
11096        (obfd, info, ibfd, sec, rel, adjustedp))
11097     #define bfd_coff_link_add_one_symbol(info, abfd, name, flags, section,\
11098                                          value, string, cp, coll, hashp)\
11099       ((coff_backend_info (abfd)->_bfd_coff_link_add_one_symbol)\
11100        (info, abfd, name, flags, section, value, string, cp, coll, hashp))
11101
11102     #define bfd_coff_link_output_has_begun(a,p) \
11103       ((coff_backend_info (a)->_bfd_coff_link_output_has_begun) (a, p))
11104     #define bfd_coff_final_link_postscript(a,p) \
11105       ((coff_backend_info (a)->_bfd_coff_final_link_postscript) (a, p))
11106
11107     #define bfd_coff_have_print_pdata(a) \
11108       (coff_backend_info (a)->_bfd_coff_print_pdata)
11109     #define bfd_coff_print_pdata(a,p) \
11110       ((coff_backend_info (a)->_bfd_coff_print_pdata) (a, p))
11111
11112     /* Macro: Returns true if the bfd is a PE executable as opposed to a
11113        PE object file.  */
11114     #define bfd_pei_p(abfd) \
11115       (CONST_STRNEQ ((abfd)->xvec->name, "pei-"))
11116
111173.3.2.8 Writing relocations
11118...........................
11119
11120To write relocations, the back end steps though the canonical relocation
11121table and create an 'internal_reloc'.  The symbol index to use is
11122removed from the 'offset' field in the symbol table supplied.  The
11123address comes directly from the sum of the section base address and the
11124relocation offset; the type is dug directly from the howto field.  Then
11125the 'internal_reloc' is swapped into the shape of an 'external_reloc'
11126and written out to disk.
11127
111283.3.2.9 Reading linenumbers
11129...........................
11130
11131Creating the linenumber table is done by reading in the entire coff
11132linenumber table, and creating another table for internal use.
11133
11134   A coff linenumber table is structured so that each function is marked
11135as having a line number of 0.  Each line within the function is an
11136offset from the first line in the function.  The base of the line number
11137information for the table is stored in the symbol associated with the
11138function.
11139
11140   Note: The PE format uses line number 0 for a flag indicating a new
11141source file.
11142
11143   The information is copied from the external to the internal table,
11144and each symbol which marks a function is marked by pointing its...
11145
11146   How does this work ?
11147
111483.3.2.10 Reading relocations
11149............................
11150
11151Coff relocations are easily transformed into the internal BFD form
11152('arelent').
11153
11154   Reading a coff relocation table is done in the following stages:
11155
11156   * Read the entire coff relocation table into memory.
11157
11158   * Process each relocation in turn; first swap it from the external to
11159     the internal form.
11160
11161   * Turn the symbol referenced in the relocation's symbol index into a
11162     pointer into the canonical symbol table.  This table is the same as
11163     the one returned by a call to 'bfd_canonicalize_symtab'.  The back
11164     end will call that routine and save the result if a
11165     canonicalization hasn't been done.
11166
11167   * The reloc index is turned into a pointer to a howto structure, in a
11168     back end specific way.  For instance, the 386 uses the 'r_type' to
11169     directly produce an index into a howto table vector.
11170
11171
11172File: bfd.info,  Node: elf,  Next: mmo,  Prev: coff,  Up: BFD back ends
11173
111743.4 ELF backends
11175================
11176
11177BFD support for ELF formats is being worked on.  Currently, the best
11178supported back ends are for sparc and i386 (running svr4 or Solaris 2).
11179
11180   Documentation of the internals of the support code still needs to be
11181written.  The code is changing quickly enough that we haven't bothered
11182yet.
11183
11184
11185File: bfd.info,  Node: mmo,  Prev: elf,  Up: BFD back ends
11186
111873.5 mmo backend
11188===============
11189
11190The mmo object format is used exclusively together with Professor Donald
11191E. Knuth's educational 64-bit processor MMIX. The simulator 'mmix' which
11192is available at <http://mmix.cs.hm.edu/src/index.html> understands this
11193format.  That package also includes a combined assembler and linker
11194called 'mmixal'.  The mmo format has no advantages feature-wise compared
11195to e.g.  ELF. It is a simple non-relocatable object format with no
11196support for archives or debugging information, except for symbol value
11197information and line numbers (which is not yet implemented in BFD). See
11198<http://mmix.cs.hm.edu/> for more information about MMIX. The ELF format
11199is used for intermediate object files in the BFD implementation.
11200
11201* Menu:
11202
11203* File layout::
11204* Symbol-table::
11205* mmo section mapping::
11206
11207
11208File: bfd.info,  Node: File layout,  Next: Symbol-table,  Prev: mmo,  Up: mmo
11209
112103.5.1 File layout
11211-----------------
11212
11213The mmo file contents is not partitioned into named sections as with
11214e.g. ELF. Memory areas is formed by specifying the location of the data
11215that follows.  Only the memory area '0x0000...00' to '0x01ff...ff' is
11216executable, so it is used for code (and constants) and the area
11217'0x2000...00' to '0x20ff...ff' is used for writable data.  *Note mmo
11218section mapping::.
11219
11220   There is provision for specifying "special data" of 65536 different
11221types.  We use type 80 (decimal), arbitrarily chosen the same as the ELF
11222'e_machine' number for MMIX, filling it with section information
11223normally found in ELF objects.  *Note mmo section mapping::.
11224
11225   Contents is entered as 32-bit words, xor:ed over previous contents,
11226always zero-initialized.  A word that starts with the byte '0x98' forms
11227a command called a 'lopcode', where the next byte distinguished between
11228the thirteen lopcodes.  The two remaining bytes, called the 'Y' and 'Z'
11229fields, or the 'YZ' field (a 16-bit big-endian number), are used for
11230various purposes different for each lopcode.  As documented in
11231<http://mmix.cs.hm.edu/doc/mmixal.pdf>, the lopcodes are:
11232
11233'lop_quote'
11234     0x98000001.  The next word is contents, regardless of whether it
11235     starts with 0x98 or not.
11236
11237'lop_loc'
11238     0x9801YYZZ, where 'Z' is 1 or 2.  This is a location directive,
11239     setting the location for the next data to the next 32-bit word (for
11240     Z = 1) or 64-bit word (for Z = 2), plus Y * 2^56.  Normally 'Y' is
11241     0 for the text segment and 2 for the data segment.  Beware that the
11242     low bits of non- tetrabyte-aligned values are silently discarded
11243     when being automatically incremented and when storing contents (in
11244     contrast to e.g.  its use as current location when followed by
11245     lop_fixo et al before the next possibly-quoted tetrabyte contents).
11246
11247'lop_skip'
11248     0x9802YYZZ. Increase the current location by 'YZ' bytes.
11249
11250'lop_fixo'
11251     0x9803YYZZ, where 'Z' is 1 or 2.  Store the current location as 64
11252     bits into the location pointed to by the next 32-bit (Z = 1) or
11253     64-bit (Z = 2) word, plus Y * 2^56.
11254
11255'lop_fixr'
11256     0x9804YYZZ. 'YZ' is stored into the current location plus 2 - 4 *
11257     YZ.
11258
11259'lop_fixrx'
11260     0x980500ZZ. 'Z' is 16 or 24.  A value 'L' derived from the
11261     following 32-bit word are used in a manner similar to 'YZ' in
11262     lop_fixr: it is xor:ed into the current location minus 4 * L.  The
11263     first byte of the word is 0 or 1.  If it is 1, then L = (LOWEST 24
11264     BITS OF WORD) - 2^Z, if 0, then L = (LOWEST 24 BITS OF WORD).
11265
11266'lop_file'
11267     0x9806YYZZ. 'Y' is the file number, 'Z' is count of 32-bit words.
11268     Set the file number to 'Y' and the line counter to 0.  The next Z *
11269     4 bytes contain the file name, padded with zeros if the count is
11270     not a multiple of four.  The same 'Y' may occur multiple times, but
11271     'Z' must be 0 for all but the first occurrence.
11272
11273'lop_line'
11274     0x9807YYZZ. 'YZ' is the line number.  Together with lop_file, it
11275     forms the source location for the next 32-bit word.  Note that for
11276     each non-lopcode 32-bit word, line numbers are assumed incremented
11277     by one.
11278
11279'lop_spec'
11280     0x9808YYZZ. 'YZ' is the type number.  Data until the next lopcode
11281     other than lop_quote forms special data of type 'YZ'.  *Note mmo
11282     section mapping::.
11283
11284     Other types than 80, (or type 80 with a content that does not
11285     parse) is stored in sections named '.MMIX.spec_data.N' where N is
11286     the 'YZ'-type.  The flags for such a sections say not to allocate
11287     or load the data.  The vma is 0.  Contents of multiple occurrences
11288     of special data N is concatenated to the data of the previous
11289     lop_spec Ns.  The location in data or code at which the lop_spec
11290     occurred is lost.
11291
11292'lop_pre'
11293     0x980901ZZ. The first lopcode in a file.  The 'Z' field forms the
11294     length of header information in 32-bit words, where the first word
11295     tells the time in seconds since '00:00:00 GMT Jan 1 1970'.
11296
11297'lop_post'
11298     0x980a00ZZ. Z > 32.  This lopcode follows after all
11299     content-generating lopcodes in a program.  The 'Z' field denotes
11300     the value of 'rG' at the beginning of the program.  The following
11301     256 - Z big-endian 64-bit words are loaded into global registers
11302     '$G' ... '$255'.
11303
11304'lop_stab'
11305     0x980b0000.  The next-to-last lopcode in a program.  Must follow
11306     immediately after the lop_post lopcode and its data.  After this
11307     lopcode follows all symbols in a compressed format (*note
11308     Symbol-table::).
11309
11310'lop_end'
11311     0x980cYYZZ. The last lopcode in a program.  It must follow the
11312     lop_stab lopcode and its data.  The 'YZ' field contains the number
11313     of 32-bit words of symbol table information after the preceding
11314     lop_stab lopcode.
11315
11316   Note that the lopcode "fixups"; 'lop_fixr', 'lop_fixrx' and
11317'lop_fixo' are not generated by BFD, but are handled.  They are
11318generated by 'mmixal'.
11319
11320   This trivial one-label, one-instruction file:
11321
11322      :Main TRAP 1,2,3
11323
11324   can be represented this way in mmo:
11325
11326      0x98090101 - lop_pre, one 32-bit word with timestamp.
11327      <timestamp>
11328      0x98010002 - lop_loc, text segment, using a 64-bit address.
11329                   Note that mmixal does not emit this for the file above.
11330      0x00000000 - Address, high 32 bits.
11331      0x00000000 - Address, low 32 bits.
11332      0x98060002 - lop_file, 2 32-bit words for file-name.
11333      0x74657374 - "test"
11334      0x2e730000 - ".s\0\0"
11335      0x98070001 - lop_line, line 1.
11336      0x00010203 - TRAP 1,2,3
11337      0x980a00ff - lop_post, setting $255 to 0.
11338      0x00000000
11339      0x00000000
11340      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
11341      0x203a4040   *Note Symbol-table::.
11342      0x10404020
11343      0x4d206120
11344      0x69016e00
11345      0x81000000
11346      0x980c0005 - lop_end; symbol table contained five 32-bit words.
11347
11348
11349File: bfd.info,  Node: Symbol-table,  Next: mmo section mapping,  Prev: File layout,  Up: mmo
11350
113513.5.2 Symbol table format
11352-------------------------
11353
11354From mmixal.w (or really, the generated mmixal.tex) in the MMIXware
11355package which also contains the 'mmix' simulator: "Symbols are stored
11356and retrieved by means of a 'ternary search trie', following ideas of
11357Bentley and Sedgewick.  (See ACM-SIAM Symp. on Discrete Algorithms '8'
11358(1997), 360-369; R.Sedgewick, 'Algorithms in C' (Reading, Mass.
11359Addison-Wesley, 1998), '15.4'.)  Each trie node stores a character, and
11360there are branches to subtries for the cases where a given character is
11361less than, equal to, or greater than the character in the trie.  There
11362also is a pointer to a symbol table entry if a symbol ends at the
11363current node."
11364
11365   So it's a tree encoded as a stream of bytes.  The stream of bytes
11366acts on a single virtual global symbol, adding and removing characters
11367and signalling complete symbol points.  Here, we read the stream and
11368create symbols at the completion points.
11369
11370   First, there's a control byte 'm'.  If any of the listed bits in 'm'
11371is nonzero, we execute what stands at the right, in the listed order:
11372
11373      (MMO3_LEFT)
11374      0x40 - Traverse left trie.
11375             (Read a new command byte and recurse.)
11376
11377      (MMO3_SYMBITS)
11378      0x2f - Read the next byte as a character and store it in the
11379             current character position; increment character position.
11380             Test the bits of m:
11381
11382             (MMO3_WCHAR)
11383             0x80 - The character is 16-bit (so read another byte,
11384                    merge into current character.
11385
11386             (MMO3_TYPEBITS)
11387             0xf  - We have a complete symbol; parse the type, value
11388                    and serial number and do what should be done
11389                    with a symbol.  The type and length information
11390                    is in j = (m & 0xf).
11391
11392                    (MMO3_REGQUAL_BITS)
11393                    j == 0xf: A register variable.  The following
11394                              byte tells which register.
11395                    j <= 8:   An absolute symbol.  Read j bytes as the
11396                              big-endian number the symbol equals.
11397                              A j = 2 with two zero bytes denotes an
11398                              unknown symbol.
11399                    j > 8:    As with j <= 8, but add (0x20 << 56)
11400                              to the value in the following j - 8
11401                              bytes.
11402
11403                    Then comes the serial number, as a variant of
11404                    uleb128, but better named ubeb128:
11405                    Read bytes and shift the previous value left 7
11406                    (multiply by 128).  Add in the new byte, repeat
11407                    until a byte has bit 7 set.  The serial number
11408                    is the computed value minus 128.
11409
11410             (MMO3_MIDDLE)
11411             0x20 - Traverse middle trie.  (Read a new command byte
11412                    and recurse.)  Decrement character position.
11413
11414      (MMO3_RIGHT)
11415      0x10 - Traverse right trie.  (Read a new command byte and
11416             recurse.)
11417
11418   Let's look again at the 'lop_stab' for the trivial file (*note File
11419layout::).
11420
11421      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
11422      0x203a4040
11423      0x10404020
11424      0x4d206120
11425      0x69016e00
11426      0x81000000
11427
11428   This forms the trivial trie (note that the path between ":" and "M"
11429is redundant):
11430
11431      203a     ":"
11432      40       /
11433      40      /
11434      10      \
11435      40      /
11436      40     /
11437      204d  "M"
11438      2061  "a"
11439      2069  "i"
11440      016e  "n" is the last character in a full symbol, and
11441            with a value represented in one byte.
11442      00    The value is 0.
11443      81    The serial number is 1.
11444
11445
11446File: bfd.info,  Node: mmo section mapping,  Prev: Symbol-table,  Up: mmo
11447
114483.5.3 mmo section mapping
11449-------------------------
11450
11451The implementation in BFD uses special data type 80 (decimal) to
11452encapsulate and describe named sections, containing e.g. debug
11453information.  If needed, any datum in the encapsulation will be quoted
11454using lop_quote.  First comes a 32-bit word holding the number of 32-bit
11455words containing the zero-terminated zero-padded segment name.  After
11456the name there's a 32-bit word holding flags describing the section
11457type.  Then comes a 64-bit big-endian word with the section length (in
11458bytes), then another with the section start address.  Depending on the
11459type of section, the contents might follow, zero-padded to 32-bit
11460boundary.  For a loadable section (such as data or code), the contents
11461might follow at some later point, not necessarily immediately, as a
11462lop_loc with the same start address as in the section description,
11463followed by the contents.  This in effect forms a descriptor that must
11464be emitted before the actual contents.  Sections described this way must
11465not overlap.
11466
11467   For areas that don't have such descriptors, synthetic sections are
11468formed by BFD. Consecutive contents in the two memory areas
11469'0x0000...00' to '0x01ff...ff' and '0x2000...00' to '0x20ff...ff' are
11470entered in sections named '.text' and '.data' respectively.  If an area
11471is not otherwise described, but would together with a neighboring lower
11472area be less than '0x40000000' bytes long, it is joined with the lower
11473area and the gap is zero-filled.  For other cases, a new section is
11474formed, named '.MMIX.sec.N'.  Here, N is a number, a running count
11475through the mmo file, starting at 0.
11476
11477   A loadable section specified as:
11478
11479      .section secname,"ax"
11480      TETRA 1,2,3,4,-1,-2009
11481      BYTE 80
11482
11483   and linked to address '0x4', is represented by the sequence:
11484
11485      0x98080050 - lop_spec 80
11486      0x00000002 - two 32-bit words for the section name
11487      0x7365636e - "secn"
11488      0x616d6500 - "ame\0"
11489      0x00000033 - flags CODE, READONLY, LOAD, ALLOC
11490      0x00000000 - high 32 bits of section length
11491      0x0000001c - section length is 28 bytes; 6 * 4 + 1 + alignment to 32 bits
11492      0x00000000 - high 32 bits of section address
11493      0x00000004 - section address is 4
11494      0x98010002 - 64 bits with address of following data
11495      0x00000000 - high 32 bits of address
11496      0x00000004 - low 32 bits: data starts at address 4
11497      0x00000001 - 1
11498      0x00000002 - 2
11499      0x00000003 - 3
11500      0x00000004 - 4
11501      0xffffffff - -1
11502      0xfffff827 - -2009
11503      0x50000000 - 80 as a byte, padded with zeros.
11504
11505   Note that the lop_spec wrapping does not include the section
11506contents.  Compare this to a non-loaded section specified as:
11507
11508      .section thirdsec
11509      TETRA 200001,100002
11510      BYTE 38,40
11511
11512   This, when linked to address '0x200000000000001c', is represented by:
11513
11514      0x98080050 - lop_spec 80
11515      0x00000002 - two 32-bit words for the section name
11516      0x7365636e - "thir"
11517      0x616d6500 - "dsec"
11518      0x00000010 - flag READONLY
11519      0x00000000 - high 32 bits of section length
11520      0x0000000c - section length is 12 bytes; 2 * 4 + 2 + alignment to 32 bits
11521      0x20000000 - high 32 bits of address
11522      0x0000001c - low 32 bits of address 0x200000000000001c
11523      0x00030d41 - 200001
11524      0x000186a2 - 100002
11525      0x26280000 - 38, 40 as bytes, padded with zeros
11526
11527   For the latter example, the section contents must not be loaded in
11528memory, and is therefore specified as part of the special data.  The
11529address is usually unimportant but might provide information for e.g.
11530the DWARF 2 debugging format.
11531
11532
11533File: bfd.info,  Node: GNU Free Documentation License,  Next: BFD Index,  Prev: BFD back ends,  Up: Top
11534
11535                     Version 1.3, 3 November 2008
11536
11537     Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
11538     <http://fsf.org/>
11539
11540     Everyone is permitted to copy and distribute verbatim copies
11541     of this license document, but changing it is not allowed.
11542
11543  0. PREAMBLE
11544
11545     The purpose of this License is to make a manual, textbook, or other
11546     functional and useful document "free" in the sense of freedom: to
11547     assure everyone the effective freedom to copy and redistribute it,
11548     with or without modifying it, either commercially or
11549     noncommercially.  Secondarily, this License preserves for the
11550     author and publisher a way to get credit for their work, while not
11551     being considered responsible for modifications made by others.
11552
11553     This License is a kind of "copyleft", which means that derivative
11554     works of the document must themselves be free in the same sense.
11555     It complements the GNU General Public License, which is a copyleft
11556     license designed for free software.
11557
11558     We have designed this License in order to use it for manuals for
11559     free software, because free software needs free documentation: a
11560     free program should come with manuals providing the same freedoms
11561     that the software does.  But this License is not limited to
11562     software manuals; it can be used for any textual work, regardless
11563     of subject matter or whether it is published as a printed book.  We
11564     recommend this License principally for works whose purpose is
11565     instruction or reference.
11566
11567  1. APPLICABILITY AND DEFINITIONS
11568
11569     This License applies to any manual or other work, in any medium,
11570     that contains a notice placed by the copyright holder saying it can
11571     be distributed under the terms of this License.  Such a notice
11572     grants a world-wide, royalty-free license, unlimited in duration,
11573     to use that work under the conditions stated herein.  The
11574     "Document", below, refers to any such manual or work.  Any member
11575     of the public is a licensee, and is addressed as "you".  You accept
11576     the license if you copy, modify or distribute the work in a way
11577     requiring permission under copyright law.
11578
11579     A "Modified Version" of the Document means any work containing the
11580     Document or a portion of it, either copied verbatim, or with
11581     modifications and/or translated into another language.
11582
11583     A "Secondary Section" is a named appendix or a front-matter section
11584     of the Document that deals exclusively with the relationship of the
11585     publishers or authors of the Document to the Document's overall
11586     subject (or to related matters) and contains nothing that could
11587     fall directly within that overall subject.  (Thus, if the Document
11588     is in part a textbook of mathematics, a Secondary Section may not
11589     explain any mathematics.)  The relationship could be a matter of
11590     historical connection with the subject or with related matters, or
11591     of legal, commercial, philosophical, ethical or political position
11592     regarding them.
11593
11594     The "Invariant Sections" are certain Secondary Sections whose
11595     titles are designated, as being those of Invariant Sections, in the
11596     notice that says that the Document is released under this License.
11597     If a section does not fit the above definition of Secondary then it
11598     is not allowed to be designated as Invariant.  The Document may
11599     contain zero Invariant Sections.  If the Document does not identify
11600     any Invariant Sections then there are none.
11601
11602     The "Cover Texts" are certain short passages of text that are
11603     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
11604     that says that the Document is released under this License.  A
11605     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
11606     be at most 25 words.
11607
11608     A "Transparent" copy of the Document means a machine-readable copy,
11609     represented in a format whose specification is available to the
11610     general public, that is suitable for revising the document
11611     straightforwardly with generic text editors or (for images composed
11612     of pixels) generic paint programs or (for drawings) some widely
11613     available drawing editor, and that is suitable for input to text
11614     formatters or for automatic translation to a variety of formats
11615     suitable for input to text formatters.  A copy made in an otherwise
11616     Transparent file format whose markup, or absence of markup, has
11617     been arranged to thwart or discourage subsequent modification by
11618     readers is not Transparent.  An image format is not Transparent if
11619     used for any substantial amount of text.  A copy that is not
11620     "Transparent" is called "Opaque".
11621
11622     Examples of suitable formats for Transparent copies include plain
11623     ASCII without markup, Texinfo input format, LaTeX input format,
11624     SGML or XML using a publicly available DTD, and standard-conforming
11625     simple HTML, PostScript or PDF designed for human modification.
11626     Examples of transparent image formats include PNG, XCF and JPG.
11627     Opaque formats include proprietary formats that can be read and
11628     edited only by proprietary word processors, SGML or XML for which
11629     the DTD and/or processing tools are not generally available, and
11630     the machine-generated HTML, PostScript or PDF produced by some word
11631     processors for output purposes only.
11632
11633     The "Title Page" means, for a printed book, the title page itself,
11634     plus such following pages as are needed to hold, legibly, the
11635     material this License requires to appear in the title page.  For
11636     works in formats which do not have any title page as such, "Title
11637     Page" means the text near the most prominent appearance of the
11638     work's title, preceding the beginning of the body of the text.
11639
11640     The "publisher" means any person or entity that distributes copies
11641     of the Document to the public.
11642
11643     A section "Entitled XYZ" means a named subunit of the Document
11644     whose title either is precisely XYZ or contains XYZ in parentheses
11645     following text that translates XYZ in another language.  (Here XYZ
11646     stands for a specific section name mentioned below, such as
11647     "Acknowledgements", "Dedications", "Endorsements", or "History".)
11648     To "Preserve the Title" of such a section when you modify the
11649     Document means that it remains a section "Entitled XYZ" according
11650     to this definition.
11651
11652     The Document may include Warranty Disclaimers next to the notice
11653     which states that this License applies to the Document.  These
11654     Warranty Disclaimers are considered to be included by reference in
11655     this License, but only as regards disclaiming warranties: any other
11656     implication that these Warranty Disclaimers may have is void and
11657     has no effect on the meaning of this License.
11658
11659  2. VERBATIM COPYING
11660
11661     You may copy and distribute the Document in any medium, either
11662     commercially or noncommercially, provided that this License, the
11663     copyright notices, and the license notice saying this License
11664     applies to the Document are reproduced in all copies, and that you
11665     add no other conditions whatsoever to those of this License.  You
11666     may not use technical measures to obstruct or control the reading
11667     or further copying of the copies you make or distribute.  However,
11668     you may accept compensation in exchange for copies.  If you
11669     distribute a large enough number of copies you must also follow the
11670     conditions in section 3.
11671
11672     You may also lend copies, under the same conditions stated above,
11673     and you may publicly display copies.
11674
11675  3. COPYING IN QUANTITY
11676
11677     If you publish printed copies (or copies in media that commonly
11678     have printed covers) of the Document, numbering more than 100, and
11679     the Document's license notice requires Cover Texts, you must
11680     enclose the copies in covers that carry, clearly and legibly, all
11681     these Cover Texts: Front-Cover Texts on the front cover, and
11682     Back-Cover Texts on the back cover.  Both covers must also clearly
11683     and legibly identify you as the publisher of these copies.  The
11684     front cover must present the full title with all words of the title
11685     equally prominent and visible.  You may add other material on the
11686     covers in addition.  Copying with changes limited to the covers, as
11687     long as they preserve the title of the Document and satisfy these
11688     conditions, can be treated as verbatim copying in other respects.
11689
11690     If the required texts for either cover are too voluminous to fit
11691     legibly, you should put the first ones listed (as many as fit
11692     reasonably) on the actual cover, and continue the rest onto
11693     adjacent pages.
11694
11695     If you publish or distribute Opaque copies of the Document
11696     numbering more than 100, you must either include a machine-readable
11697     Transparent copy along with each Opaque copy, or state in or with
11698     each Opaque copy a computer-network location from which the general
11699     network-using public has access to download using public-standard
11700     network protocols a complete Transparent copy of the Document, free
11701     of added material.  If you use the latter option, you must take
11702     reasonably prudent steps, when you begin distribution of Opaque
11703     copies in quantity, to ensure that this Transparent copy will
11704     remain thus accessible at the stated location until at least one
11705     year after the last time you distribute an Opaque copy (directly or
11706     through your agents or retailers) of that edition to the public.
11707
11708     It is requested, but not required, that you contact the authors of
11709     the Document well before redistributing any large number of copies,
11710     to give them a chance to provide you with an updated version of the
11711     Document.
11712
11713  4. MODIFICATIONS
11714
11715     You may copy and distribute a Modified Version of the Document
11716     under the conditions of sections 2 and 3 above, provided that you
11717     release the Modified Version under precisely this License, with the
11718     Modified Version filling the role of the Document, thus licensing
11719     distribution and modification of the Modified Version to whoever
11720     possesses a copy of it.  In addition, you must do these things in
11721     the Modified Version:
11722
11723       A. Use in the Title Page (and on the covers, if any) a title
11724          distinct from that of the Document, and from those of previous
11725          versions (which should, if there were any, be listed in the
11726          History section of the Document).  You may use the same title
11727          as a previous version if the original publisher of that
11728          version gives permission.
11729
11730       B. List on the Title Page, as authors, one or more persons or
11731          entities responsible for authorship of the modifications in
11732          the Modified Version, together with at least five of the
11733          principal authors of the Document (all of its principal
11734          authors, if it has fewer than five), unless they release you
11735          from this requirement.
11736
11737       C. State on the Title page the name of the publisher of the
11738          Modified Version, as the publisher.
11739
11740       D. Preserve all the copyright notices of the Document.
11741
11742       E. Add an appropriate copyright notice for your modifications
11743          adjacent to the other copyright notices.
11744
11745       F. Include, immediately after the copyright notices, a license
11746          notice giving the public permission to use the Modified
11747          Version under the terms of this License, in the form shown in
11748          the Addendum below.
11749
11750       G. Preserve in that license notice the full lists of Invariant
11751          Sections and required Cover Texts given in the Document's
11752          license notice.
11753
11754       H. Include an unaltered copy of this License.
11755
11756       I. Preserve the section Entitled "History", Preserve its Title,
11757          and add to it an item stating at least the title, year, new
11758          authors, and publisher of the Modified Version as given on the
11759          Title Page.  If there is no section Entitled "History" in the
11760          Document, create one stating the title, year, authors, and
11761          publisher of the Document as given on its Title Page, then add
11762          an item describing the Modified Version as stated in the
11763          previous sentence.
11764
11765       J. Preserve the network location, if any, given in the Document
11766          for public access to a Transparent copy of the Document, and
11767          likewise the network locations given in the Document for
11768          previous versions it was based on.  These may be placed in the
11769          "History" section.  You may omit a network location for a work
11770          that was published at least four years before the Document
11771          itself, or if the original publisher of the version it refers
11772          to gives permission.
11773
11774       K. For any section Entitled "Acknowledgements" or "Dedications",
11775          Preserve the Title of the section, and preserve in the section
11776          all the substance and tone of each of the contributor
11777          acknowledgements and/or dedications given therein.
11778
11779       L. Preserve all the Invariant Sections of the Document, unaltered
11780          in their text and in their titles.  Section numbers or the
11781          equivalent are not considered part of the section titles.
11782
11783       M. Delete any section Entitled "Endorsements".  Such a section
11784          may not be included in the Modified Version.
11785
11786       N. Do not retitle any existing section to be Entitled
11787          "Endorsements" or to conflict in title with any Invariant
11788          Section.
11789
11790       O. Preserve any Warranty Disclaimers.
11791
11792     If the Modified Version includes new front-matter sections or
11793     appendices that qualify as Secondary Sections and contain no
11794     material copied from the Document, you may at your option designate
11795     some or all of these sections as invariant.  To do this, add their
11796     titles to the list of Invariant Sections in the Modified Version's
11797     license notice.  These titles must be distinct from any other
11798     section titles.
11799
11800     You may add a section Entitled "Endorsements", provided it contains
11801     nothing but endorsements of your Modified Version by various
11802     parties--for example, statements of peer review or that the text
11803     has been approved by an organization as the authoritative
11804     definition of a standard.
11805
11806     You may add a passage of up to five words as a Front-Cover Text,
11807     and a passage of up to 25 words as a Back-Cover Text, to the end of
11808     the list of Cover Texts in the Modified Version.  Only one passage
11809     of Front-Cover Text and one of Back-Cover Text may be added by (or
11810     through arrangements made by) any one entity.  If the Document
11811     already includes a cover text for the same cover, previously added
11812     by you or by arrangement made by the same entity you are acting on
11813     behalf of, you may not add another; but you may replace the old
11814     one, on explicit permission from the previous publisher that added
11815     the old one.
11816
11817     The author(s) and publisher(s) of the Document do not by this
11818     License give permission to use their names for publicity for or to
11819     assert or imply endorsement of any Modified Version.
11820
11821  5. COMBINING DOCUMENTS
11822
11823     You may combine the Document with other documents released under
11824     this License, under the terms defined in section 4 above for
11825     modified versions, provided that you include in the combination all
11826     of the Invariant Sections of all of the original documents,
11827     unmodified, and list them all as Invariant Sections of your
11828     combined work in its license notice, and that you preserve all
11829     their Warranty Disclaimers.
11830
11831     The combined work need only contain one copy of this License, and
11832     multiple identical Invariant Sections may be replaced with a single
11833     copy.  If there are multiple Invariant Sections with the same name
11834     but different contents, make the title of each such section unique
11835     by adding at the end of it, in parentheses, the name of the
11836     original author or publisher of that section if known, or else a
11837     unique number.  Make the same adjustment to the section titles in
11838     the list of Invariant Sections in the license notice of the
11839     combined work.
11840
11841     In the combination, you must combine any sections Entitled
11842     "History" in the various original documents, forming one section
11843     Entitled "History"; likewise combine any sections Entitled
11844     "Acknowledgements", and any sections Entitled "Dedications".  You
11845     must delete all sections Entitled "Endorsements."
11846
11847  6. COLLECTIONS OF DOCUMENTS
11848
11849     You may make a collection consisting of the Document and other
11850     documents released under this License, and replace the individual
11851     copies of this License in the various documents with a single copy
11852     that is included in the collection, provided that you follow the
11853     rules of this License for verbatim copying of each of the documents
11854     in all other respects.
11855
11856     You may extract a single document from such a collection, and
11857     distribute it individually under this License, provided you insert
11858     a copy of this License into the extracted document, and follow this
11859     License in all other respects regarding verbatim copying of that
11860     document.
11861
11862  7. AGGREGATION WITH INDEPENDENT WORKS
11863
11864     A compilation of the Document or its derivatives with other
11865     separate and independent documents or works, in or on a volume of a
11866     storage or distribution medium, is called an "aggregate" if the
11867     copyright resulting from the compilation is not used to limit the
11868     legal rights of the compilation's users beyond what the individual
11869     works permit.  When the Document is included in an aggregate, this
11870     License does not apply to the other works in the aggregate which
11871     are not themselves derivative works of the Document.
11872
11873     If the Cover Text requirement of section 3 is applicable to these
11874     copies of the Document, then if the Document is less than one half
11875     of the entire aggregate, the Document's Cover Texts may be placed
11876     on covers that bracket the Document within the aggregate, or the
11877     electronic equivalent of covers if the Document is in electronic
11878     form.  Otherwise they must appear on printed covers that bracket
11879     the whole aggregate.
11880
11881  8. TRANSLATION
11882
11883     Translation is considered a kind of modification, so you may
11884     distribute translations of the Document under the terms of section
11885     4.  Replacing Invariant Sections with translations requires special
11886     permission from their copyright holders, but you may include
11887     translations of some or all Invariant Sections in addition to the
11888     original versions of these Invariant Sections.  You may include a
11889     translation of this License, and all the license notices in the
11890     Document, and any Warranty Disclaimers, provided that you also
11891     include the original English version of this License and the
11892     original versions of those notices and disclaimers.  In case of a
11893     disagreement between the translation and the original version of
11894     this License or a notice or disclaimer, the original version will
11895     prevail.
11896
11897     If a section in the Document is Entitled "Acknowledgements",
11898     "Dedications", or "History", the requirement (section 4) to
11899     Preserve its Title (section 1) will typically require changing the
11900     actual title.
11901
11902  9. TERMINATION
11903
11904     You may not copy, modify, sublicense, or distribute the Document
11905     except as expressly provided under this License.  Any attempt
11906     otherwise to copy, modify, sublicense, or distribute it is void,
11907     and will automatically terminate your rights under this License.
11908
11909     However, if you cease all violation of this License, then your
11910     license from a particular copyright holder is reinstated (a)
11911     provisionally, unless and until the copyright holder explicitly and
11912     finally terminates your license, and (b) permanently, if the
11913     copyright holder fails to notify you of the violation by some
11914     reasonable means prior to 60 days after the cessation.
11915
11916     Moreover, your license from a particular copyright holder is
11917     reinstated permanently if the copyright holder notifies you of the
11918     violation by some reasonable means, this is the first time you have
11919     received notice of violation of this License (for any work) from
11920     that copyright holder, and you cure the violation prior to 30 days
11921     after your receipt of the notice.
11922
11923     Termination of your rights under this section does not terminate
11924     the licenses of parties who have received copies or rights from you
11925     under this License.  If your rights have been terminated and not
11926     permanently reinstated, receipt of a copy of some or all of the
11927     same material does not give you any rights to use it.
11928
11929  10. FUTURE REVISIONS OF THIS LICENSE
11930
11931     The Free Software Foundation may publish new, revised versions of
11932     the GNU Free Documentation License from time to time.  Such new
11933     versions will be similar in spirit to the present version, but may
11934     differ in detail to address new problems or concerns.  See
11935     <http://www.gnu.org/copyleft/>.
11936
11937     Each version of the License is given a distinguishing version
11938     number.  If the Document specifies that a particular numbered
11939     version of this License "or any later version" applies to it, you
11940     have the option of following the terms and conditions either of
11941     that specified version or of any later version that has been
11942     published (not as a draft) by the Free Software Foundation.  If the
11943     Document does not specify a version number of this License, you may
11944     choose any version ever published (not as a draft) by the Free
11945     Software Foundation.  If the Document specifies that a proxy can
11946     decide which future versions of this License can be used, that
11947     proxy's public statement of acceptance of a version permanently
11948     authorizes you to choose that version for the Document.
11949
11950  11. RELICENSING
11951
11952     "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
11953     World Wide Web server that publishes copyrightable works and also
11954     provides prominent facilities for anybody to edit those works.  A
11955     public wiki that anybody can edit is an example of such a server.
11956     A "Massive Multiauthor Collaboration" (or "MMC") contained in the
11957     site means any set of copyrightable works thus published on the MMC
11958     site.
11959
11960     "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
11961     license published by Creative Commons Corporation, a not-for-profit
11962     corporation with a principal place of business in San Francisco,
11963     California, as well as future copyleft versions of that license
11964     published by that same organization.
11965
11966     "Incorporate" means to publish or republish a Document, in whole or
11967     in part, as part of another Document.
11968
11969     An MMC is "eligible for relicensing" if it is licensed under this
11970     License, and if all works that were first published under this
11971     License somewhere other than this MMC, and subsequently
11972     incorporated in whole or in part into the MMC, (1) had no cover
11973     texts or invariant sections, and (2) were thus incorporated prior
11974     to November 1, 2008.
11975
11976     The operator of an MMC Site may republish an MMC contained in the
11977     site under CC-BY-SA on the same site at any time before August 1,
11978     2009, provided the MMC is eligible for relicensing.
11979
11980ADDENDUM: How to use this License for your documents
11981====================================================
11982
11983To use this License in a document you have written, include a copy of
11984the License in the document and put the following copyright and license
11985notices just after the title page:
11986
11987       Copyright (C)  YEAR  YOUR NAME.
11988       Permission is granted to copy, distribute and/or modify this document
11989       under the terms of the GNU Free Documentation License, Version 1.3
11990       or any later version published by the Free Software Foundation;
11991       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
11992       Texts.  A copy of the license is included in the section entitled ``GNU
11993       Free Documentation License''.
11994
11995   If you have Invariant Sections, Front-Cover Texts and Back-Cover
11996Texts, replace the "with...Texts."  line with this:
11997
11998         with the Invariant Sections being LIST THEIR TITLES, with
11999         the Front-Cover Texts being LIST, and with the Back-Cover Texts
12000         being LIST.
12001
12002   If you have Invariant Sections without Cover Texts, or some other
12003combination of the three, merge those two alternatives to suit the
12004situation.
12005
12006   If your document contains nontrivial examples of program code, we
12007recommend releasing these examples in parallel under your choice of free
12008software license, such as the GNU General Public License, to permit
12009their use in free software.
12010
12011
12012File: bfd.info,  Node: BFD Index,  Prev: GNU Free Documentation License,  Up: Top
12013
12014BFD Index
12015*********
12016
12017�[index�]
12018* Menu:
12019
12020* _bfd_error_handler:                    Error reporting.    (line  111)
12021* _bfd_final_link_relocate:              Relocating the section contents.
12022                                                             (line   22)
12023* _bfd_generic_link_add_archive_symbols: Adding symbols from an archive.
12024                                                             (line   15)
12025* _bfd_generic_link_add_one_symbol:      Adding symbols from an object file.
12026                                                             (line   19)
12027* _bfd_generic_link_check_relocs:        Writing the symbol table.
12028                                                             (line  139)
12029* _bfd_generic_link_hide_symbol:         Writing the symbol table.
12030                                                             (line   80)
12031* _bfd_generic_make_empty_symbol:        symbol handling functions.
12032                                                             (line   91)
12033* _bfd_generic_set_reloc:                howto manager.      (line 3529)
12034* _bfd_generic_verify_endian_match:      Writing the symbol table.
12035                                                             (line  167)
12036* _bfd_link_add_symbols in target vector: Adding Symbols to the Hash Table.
12037                                                             (line    6)
12038* _bfd_link_final_link in target vector: Performing the Final Link.
12039                                                             (line    6)
12040* _bfd_link_hash_table_create in target vector: Creating a Linker Hash Table.
12041                                                             (line    6)
12042* _bfd_relocate_contents:                Relocating the section contents.
12043                                                             (line   22)
12044* _bfd_unrecognized_reloc:               howto manager.      (line 3541)
12045* aout_SIZE_machine_type:                aout.               (line  145)
12046* aout_SIZE_mkobject:                    aout.               (line  137)
12047* aout_SIZE_new_section_hook:            aout.               (line  175)
12048* aout_SIZE_set_arch_mach:               aout.               (line  162)
12049* aout_SIZE_some_aout_object_p:          aout.               (line  123)
12050* aout_SIZE_swap_exec_header_in:         aout.               (line   99)
12051* aout_SIZE_swap_exec_header_out:        aout.               (line  111)
12052* arelent_chain:                         typedef arelent.    (line  313)
12053* BFD:                                   Overview.           (line    6)
12054* BFD canonical format:                  Canonical format.   (line   11)
12055* bfd_alloc:                             Opening and Closing.
12056                                                             (line  248)
12057* bfd_alt_mach_code:                     Miscellaneous.      (line  291)
12058* bfd_arch_bits_per_address:             Architectures.      (line  666)
12059* bfd_arch_bits_per_byte:                Architectures.      (line  658)
12060* bfd_arch_default_fill:                 Architectures.      (line  748)
12061* bfd_arch_get_compatible:               Architectures.      (line  601)
12062* bfd_arch_list:                         Architectures.      (line  592)
12063* bfd_arch_mach_octets_per_byte:         Architectures.      (line  736)
12064* BFD_ARELOC_BFIN_ADD:                   howto manager.      (line 1144)
12065* BFD_ARELOC_BFIN_ADDR:                  howto manager.      (line 1178)
12066* BFD_ARELOC_BFIN_AND:                   howto manager.      (line 1158)
12067* BFD_ARELOC_BFIN_COMP:                  howto manager.      (line 1172)
12068* BFD_ARELOC_BFIN_CONST:                 howto manager.      (line 1142)
12069* BFD_ARELOC_BFIN_DIV:                   howto manager.      (line 1150)
12070* BFD_ARELOC_BFIN_HWPAGE:                howto manager.      (line 1176)
12071* BFD_ARELOC_BFIN_LAND:                  howto manager.      (line 1164)
12072* BFD_ARELOC_BFIN_LEN:                   howto manager.      (line 1168)
12073* BFD_ARELOC_BFIN_LOR:                   howto manager.      (line 1166)
12074* BFD_ARELOC_BFIN_LSHIFT:                howto manager.      (line 1154)
12075* BFD_ARELOC_BFIN_MOD:                   howto manager.      (line 1152)
12076* BFD_ARELOC_BFIN_MULT:                  howto manager.      (line 1148)
12077* BFD_ARELOC_BFIN_NEG:                   howto manager.      (line 1170)
12078* BFD_ARELOC_BFIN_OR:                    howto manager.      (line 1160)
12079* BFD_ARELOC_BFIN_PAGE:                  howto manager.      (line 1174)
12080* BFD_ARELOC_BFIN_PUSH:                  howto manager.      (line 1140)
12081* BFD_ARELOC_BFIN_RSHIFT:                howto manager.      (line 1156)
12082* BFD_ARELOC_BFIN_SUB:                   howto manager.      (line 1146)
12083* BFD_ARELOC_BFIN_XOR:                   howto manager.      (line 1162)
12084* bfd_cache_close:                       File Caching.       (line   25)
12085* bfd_cache_close_all:                   File Caching.       (line   38)
12086* bfd_cache_init:                        File Caching.       (line   17)
12087* bfd_calc_gnu_debuglink_crc32:          Opening and Closing.
12088                                                             (line  266)
12089* bfd_canonicalize_reloc:                Miscellaneous.      (line   18)
12090* bfd_canonicalize_symtab:               symbol handling functions.
12091                                                             (line   49)
12092* bfd_check_compression_header:          Miscellaneous.      (line  345)
12093* bfd_check_format:                      Formats.            (line   20)
12094* bfd_check_format_matches:              Formats.            (line   51)
12095* bfd_check_overflow:                    typedef arelent.    (line  325)
12096* bfd_close:                             Opening and Closing.
12097                                                             (line  170)
12098* bfd_close_all_done:                    Opening and Closing.
12099                                                             (line  188)
12100* bfd_coff_backend_data:                 coff.               (line  296)
12101* bfd_convert_section_contents:          Miscellaneous.      (line  383)
12102* bfd_convert_section_size:              Miscellaneous.      (line  373)
12103* bfd_copy_private_bfd_data:             Miscellaneous.      (line  159)
12104* bfd_copy_private_header_data:          Miscellaneous.      (line  142)
12105* bfd_copy_private_section_data:         section prototypes. (line  279)
12106* bfd_copy_private_symbol_data:          symbol handling functions.
12107                                                             (line  139)
12108* bfd_core_file_failing_command:         Core Files.         (line   11)
12109* bfd_core_file_failing_signal:          Core Files.         (line   20)
12110* bfd_core_file_pid:                     Core Files.         (line   29)
12111* bfd_create:                            Opening and Closing.
12112                                                             (line  207)
12113* bfd_create_gnu_debuglink_section:      Opening and Closing.
12114                                                             (line  422)
12115* bfd_decode_symclass:                   symbol handling functions.
12116                                                             (line  110)
12117* bfd_default_arch_struct:               Architectures.      (line  613)
12118* bfd_default_compatible:                Architectures.      (line  675)
12119* bfd_default_reloc_type_lookup:         howto manager.      (line 3453)
12120* bfd_default_scan:                      Architectures.      (line  684)
12121* bfd_default_set_arch_mach:             Architectures.      (line  631)
12122* bfd_demangle:                          Miscellaneous.      (line  324)
12123* bfd_emul_get_commonpagesize:           Miscellaneous.      (line  313)
12124* bfd_emul_get_maxpagesize:              Miscellaneous.      (line  302)
12125* bfd_errmsg:                            Error reporting.    (line   78)
12126* bfd_fdopenr:                           Opening and Closing.
12127                                                             (line   56)
12128* bfd_fdopenw:                           Opening and Closing.
12129                                                             (line   82)
12130* bfd_fill_in_gnu_debuglink_section:     Opening and Closing.
12131                                                             (line  436)
12132* bfd_find_target:                       bfd_target.         (line  583)
12133* bfd_find_version_for_sym:              Writing the symbol table.
12134                                                             (line  106)
12135* bfd_flavour_name:                      bfd_target.         (line  646)
12136* bfd_follow_build_id_debuglink:         Opening and Closing.
12137                                                             (line  496)
12138* bfd_follow_gnu_debugaltlink:           Opening and Closing.
12139                                                             (line  402)
12140* bfd_follow_gnu_debuglink:              Opening and Closing.
12141                                                             (line  381)
12142* bfd_fopen:                             Opening and Closing.
12143                                                             (line   11)
12144* bfd_format_string:                     Formats.            (line   78)
12145* bfd_generic_define_common_symbol:      Writing the symbol table.
12146                                                             (line   67)
12147* bfd_generic_define_start_stop:         Writing the symbol table.
12148                                                             (line   93)
12149* bfd_generic_discard_group:             section prototypes. (line  312)
12150* bfd_generic_gc_sections:               howto manager.      (line 3484)
12151* bfd_generic_get_relocated_section_contents: howto manager. (line 3514)
12152* bfd_generic_group_name:                section prototypes. (line  304)
12153* bfd_generic_is_group_section:          section prototypes. (line  296)
12154* bfd_generic_lookup_section_flags:      howto manager.      (line 3494)
12155* bfd_generic_merge_sections:            howto manager.      (line 3504)
12156* bfd_generic_relax_section:             howto manager.      (line 3471)
12157* bfd_get_alt_debug_link_info:           Opening and Closing.
12158                                                             (line  320)
12159* bfd_get_arch:                          Architectures.      (line  642)
12160* bfd_get_arch_info:                     Architectures.      (line  694)
12161* bfd_get_arch_size:                     Miscellaneous.      (line   63)
12162* bfd_get_compression_header_size:       Miscellaneous.      (line  362)
12163* bfd_get_debug_link_info:               Opening and Closing.
12164                                                             (line  302)
12165* bfd_get_debug_link_info_1:             Opening and Closing.
12166                                                             (line  280)
12167* bfd_get_error:                         Error reporting.    (line   49)
12168* bfd_get_file_size:                     Miscellaneous.      (line  474)
12169* bfd_get_gp_size:                       Miscellaneous.      (line  106)
12170* bfd_get_linker_section:                section prototypes. (line   37)
12171* bfd_get_mach:                          Architectures.      (line  650)
12172* bfd_get_mtime:                         Miscellaneous.      (line  435)
12173* bfd_get_next_mapent:                   Archives.           (line   57)
12174* bfd_get_next_section_by_name:          section prototypes. (line   25)
12175* bfd_get_reloc_code_name:               howto manager.      (line 3462)
12176* bfd_get_reloc_size:                    typedef arelent.    (line  304)
12177* bfd_get_reloc_upper_bound:             Miscellaneous.      (line    8)
12178* bfd_get_section_by_name:               section prototypes. (line   16)
12179* bfd_get_section_by_name_if:            section prototypes. (line   46)
12180* bfd_get_section_contents:              section prototypes. (line  252)
12181* bfd_get_sign_extend_vma:               Miscellaneous.      (line   78)
12182* bfd_get_size:                          Miscellaneous.      (line  444)
12183* bfd_get_size <1>:                      Internal.           (line   24)
12184* bfd_get_symtab_upper_bound:            symbol handling functions.
12185                                                             (line    5)
12186* bfd_get_target_info:                   bfd_target.         (line  599)
12187* bfd_get_unique_section_name:           section prototypes. (line   65)
12188* bfd_hash_allocate:                     Creating and Freeing a Hash Table.
12189                                                             (line   17)
12190* bfd_hash_lookup:                       Looking Up or Entering a String.
12191                                                             (line    6)
12192* bfd_hash_newfunc:                      Creating and Freeing a Hash Table.
12193                                                             (line   12)
12194* bfd_hash_set_default_size:             Creating and Freeing a Hash Table.
12195                                                             (line   25)
12196* bfd_hash_table_free:                   Creating and Freeing a Hash Table.
12197                                                             (line   21)
12198* bfd_hash_table_init:                   Creating and Freeing a Hash Table.
12199                                                             (line    6)
12200* bfd_hash_table_init_n:                 Creating and Freeing a Hash Table.
12201                                                             (line    6)
12202* bfd_hash_traverse:                     Traversing a Hash Table.
12203                                                             (line    6)
12204* bfd_hide_sym_by_version:               Writing the symbol table.
12205                                                             (line  118)
12206* bfd_h_put_size:                        Internal.           (line  110)
12207* bfd_init:                              Initialization.     (line   10)
12208* bfd_install_relocation:                typedef arelent.    (line  379)
12209* bfd_is_local_label:                    symbol handling functions.
12210                                                             (line   16)
12211* bfd_is_local_label_name:               symbol handling functions.
12212                                                             (line   25)
12213* bfd_is_target_special_symbol:          symbol handling functions.
12214                                                             (line   37)
12215* bfd_is_undefined_symclass:             symbol handling functions.
12216                                                             (line  119)
12217* bfd_iterate_over_targets:              bfd_target.         (line  634)
12218* bfd_link_check_relocs:                 Writing the symbol table.
12219                                                             (line  128)
12220* bfd_link_split_section:                Writing the symbol table.
12221                                                             (line   43)
12222* bfd_log2:                              Internal.           (line  178)
12223* bfd_lookup_arch:                       Architectures.      (line  702)
12224* bfd_make_debug_symbol:                 symbol handling functions.
12225                                                             (line  101)
12226* bfd_make_empty_symbol:                 symbol handling functions.
12227                                                             (line   77)
12228* bfd_make_readable:                     Opening and Closing.
12229                                                             (line  234)
12230* bfd_make_section:                      section prototypes. (line  143)
12231* bfd_make_section_anyway:               section prototypes. (line  115)
12232* bfd_make_section_anyway_with_flags:    section prototypes. (line   97)
12233* bfd_make_section_old_way:              section prototypes. (line   77)
12234* bfd_make_section_with_flags:           section prototypes. (line  131)
12235* bfd_make_writable:                     Opening and Closing.
12236                                                             (line  220)
12237* bfd_malloc_and_get_section:            section prototypes. (line  269)
12238* bfd_map_over_sections:                 section prototypes. (line  176)
12239* bfd_merge_private_bfd_data:            Writing the symbol table.
12240                                                             (line  150)
12241* bfd_mmap:                              Miscellaneous.      (line  483)
12242* bfd_octets_per_byte:                   Architectures.      (line  725)
12243* bfd_openr:                             Opening and Closing.
12244                                                             (line   37)
12245* bfd_openr_iovec:                       Opening and Closing.
12246                                                             (line  104)
12247* bfd_openr_next_archived_file:          Archives.           (line   83)
12248* bfd_openstreamr:                       Opening and Closing.
12249                                                             (line   91)
12250* bfd_openw:                             Opening and Closing.
12251                                                             (line  155)
12252* bfd_open_file:                         File Caching.       (line   51)
12253* bfd_perform_relocation:                typedef arelent.    (line  354)
12254* bfd_perror:                            Error reporting.    (line   87)
12255* bfd_printable_arch_mach:               Architectures.      (line  713)
12256* bfd_printable_name:                    Architectures.      (line  573)
12257* bfd_print_symbol_vandf:                symbol handling functions.
12258                                                             (line   69)
12259* bfd_put_size:                          Internal.           (line   21)
12260* BFD_RELOC_12_PCREL:                    howto manager.      (line   37)
12261* BFD_RELOC_14:                          howto manager.      (line   30)
12262* BFD_RELOC_16:                          howto manager.      (line   29)
12263* BFD_RELOC_16_BASEREL:                  howto manager.      (line   90)
12264* BFD_RELOC_16_GOTOFF:                   howto manager.      (line   49)
12265* BFD_RELOC_16_GOT_PCREL:                howto manager.      (line   46)
12266* BFD_RELOC_16_PCREL:                    howto manager.      (line   36)
12267* BFD_RELOC_16_PCREL_S2:                 howto manager.      (line  100)
12268* BFD_RELOC_16_PLTOFF:                   howto manager.      (line   61)
12269* BFD_RELOC_16_PLT_PCREL:                howto manager.      (line   57)
12270* BFD_RELOC_23_PCREL_S2:                 howto manager.      (line  101)
12271* BFD_RELOC_24:                          howto manager.      (line   28)
12272* BFD_RELOC_24_PCREL:                    howto manager.      (line   35)
12273* BFD_RELOC_24_PLT_PCREL:                howto manager.      (line   56)
12274* BFD_RELOC_26:                          howto manager.      (line   27)
12275* BFD_RELOC_32:                          howto manager.      (line   26)
12276* BFD_RELOC_32_BASEREL:                  howto manager.      (line   89)
12277* BFD_RELOC_32_GOTOFF:                   howto manager.      (line   48)
12278* BFD_RELOC_32_GOT_PCREL:                howto manager.      (line   45)
12279* BFD_RELOC_32_PCREL:                    howto manager.      (line   34)
12280* BFD_RELOC_32_PCREL_S2:                 howto manager.      (line   99)
12281* BFD_RELOC_32_PLTOFF:                   howto manager.      (line   60)
12282* BFD_RELOC_32_PLT_PCREL:                howto manager.      (line   55)
12283* BFD_RELOC_32_SECREL:                   howto manager.      (line   43)
12284* BFD_RELOC_386_COPY:                    howto manager.      (line  523)
12285* BFD_RELOC_386_GLOB_DAT:                howto manager.      (line  524)
12286* BFD_RELOC_386_GOT32:                   howto manager.      (line  521)
12287* BFD_RELOC_386_GOT32X:                  howto manager.      (line  545)
12288* BFD_RELOC_386_GOTOFF:                  howto manager.      (line  527)
12289* BFD_RELOC_386_GOTPC:                   howto manager.      (line  528)
12290* BFD_RELOC_386_IRELATIVE:               howto manager.      (line  544)
12291* BFD_RELOC_386_JUMP_SLOT:               howto manager.      (line  525)
12292* BFD_RELOC_386_PLT32:                   howto manager.      (line  522)
12293* BFD_RELOC_386_RELATIVE:                howto manager.      (line  526)
12294* BFD_RELOC_386_TLS_DESC:                howto manager.      (line  543)
12295* BFD_RELOC_386_TLS_DESC_CALL:           howto manager.      (line  542)
12296* BFD_RELOC_386_TLS_DTPMOD32:            howto manager.      (line  538)
12297* BFD_RELOC_386_TLS_DTPOFF32:            howto manager.      (line  539)
12298* BFD_RELOC_386_TLS_GD:                  howto manager.      (line  533)
12299* BFD_RELOC_386_TLS_GOTDESC:             howto manager.      (line  541)
12300* BFD_RELOC_386_TLS_GOTIE:               howto manager.      (line  531)
12301* BFD_RELOC_386_TLS_IE:                  howto manager.      (line  530)
12302* BFD_RELOC_386_TLS_IE_32:               howto manager.      (line  536)
12303* BFD_RELOC_386_TLS_LDM:                 howto manager.      (line  534)
12304* BFD_RELOC_386_TLS_LDO_32:              howto manager.      (line  535)
12305* BFD_RELOC_386_TLS_LE:                  howto manager.      (line  532)
12306* BFD_RELOC_386_TLS_LE_32:               howto manager.      (line  537)
12307* BFD_RELOC_386_TLS_TPOFF:               howto manager.      (line  529)
12308* BFD_RELOC_386_TLS_TPOFF32:             howto manager.      (line  540)
12309* BFD_RELOC_390_12:                      howto manager.      (line 1950)
12310* BFD_RELOC_390_20:                      howto manager.      (line 2031)
12311* BFD_RELOC_390_COPY:                    howto manager.      (line 1956)
12312* BFD_RELOC_390_GLOB_DAT:                howto manager.      (line 1958)
12313* BFD_RELOC_390_GOT12:                   howto manager.      (line 1952)
12314* BFD_RELOC_390_GOT16:                   howto manager.      (line 1966)
12315* BFD_RELOC_390_GOT20:                   howto manager.      (line 2032)
12316* BFD_RELOC_390_GOT64:                   howto manager.      (line 1986)
12317* BFD_RELOC_390_GOTENT:                  howto manager.      (line 1990)
12318* BFD_RELOC_390_GOTOFF64:                howto manager.      (line 1992)
12319* BFD_RELOC_390_GOTPC:                   howto manager.      (line 1964)
12320* BFD_RELOC_390_GOTPCDBL:                howto manager.      (line 1984)
12321* BFD_RELOC_390_GOTPLT12:                howto manager.      (line 1994)
12322* BFD_RELOC_390_GOTPLT16:                howto manager.      (line 1996)
12323* BFD_RELOC_390_GOTPLT20:                howto manager.      (line 2033)
12324* BFD_RELOC_390_GOTPLT32:                howto manager.      (line 1998)
12325* BFD_RELOC_390_GOTPLT64:                howto manager.      (line 2000)
12326* BFD_RELOC_390_GOTPLTENT:               howto manager.      (line 2002)
12327* BFD_RELOC_390_IRELATIVE:               howto manager.      (line 2036)
12328* BFD_RELOC_390_JMP_SLOT:                howto manager.      (line 1960)
12329* BFD_RELOC_390_PC12DBL:                 howto manager.      (line 1968)
12330* BFD_RELOC_390_PC16DBL:                 howto manager.      (line 1972)
12331* BFD_RELOC_390_PC24DBL:                 howto manager.      (line 1976)
12332* BFD_RELOC_390_PC32DBL:                 howto manager.      (line 1980)
12333* BFD_RELOC_390_PLT12DBL:                howto manager.      (line 1970)
12334* BFD_RELOC_390_PLT16DBL:                howto manager.      (line 1974)
12335* BFD_RELOC_390_PLT24DBL:                howto manager.      (line 1978)
12336* BFD_RELOC_390_PLT32:                   howto manager.      (line 1954)
12337* BFD_RELOC_390_PLT32DBL:                howto manager.      (line 1982)
12338* BFD_RELOC_390_PLT64:                   howto manager.      (line 1988)
12339* BFD_RELOC_390_PLTOFF16:                howto manager.      (line 2004)
12340* BFD_RELOC_390_PLTOFF32:                howto manager.      (line 2006)
12341* BFD_RELOC_390_PLTOFF64:                howto manager.      (line 2008)
12342* BFD_RELOC_390_RELATIVE:                howto manager.      (line 1962)
12343* BFD_RELOC_390_TLS_DTPMOD:              howto manager.      (line 2027)
12344* BFD_RELOC_390_TLS_DTPOFF:              howto manager.      (line 2028)
12345* BFD_RELOC_390_TLS_GD32:                howto manager.      (line 2013)
12346* BFD_RELOC_390_TLS_GD64:                howto manager.      (line 2014)
12347* BFD_RELOC_390_TLS_GDCALL:              howto manager.      (line 2011)
12348* BFD_RELOC_390_TLS_GOTIE12:             howto manager.      (line 2015)
12349* BFD_RELOC_390_TLS_GOTIE20:             howto manager.      (line 2034)
12350* BFD_RELOC_390_TLS_GOTIE32:             howto manager.      (line 2016)
12351* BFD_RELOC_390_TLS_GOTIE64:             howto manager.      (line 2017)
12352* BFD_RELOC_390_TLS_IE32:                howto manager.      (line 2020)
12353* BFD_RELOC_390_TLS_IE64:                howto manager.      (line 2021)
12354* BFD_RELOC_390_TLS_IEENT:               howto manager.      (line 2022)
12355* BFD_RELOC_390_TLS_LDCALL:              howto manager.      (line 2012)
12356* BFD_RELOC_390_TLS_LDM32:               howto manager.      (line 2018)
12357* BFD_RELOC_390_TLS_LDM64:               howto manager.      (line 2019)
12358* BFD_RELOC_390_TLS_LDO32:               howto manager.      (line 2025)
12359* BFD_RELOC_390_TLS_LDO64:               howto manager.      (line 2026)
12360* BFD_RELOC_390_TLS_LE32:                howto manager.      (line 2023)
12361* BFD_RELOC_390_TLS_LE64:                howto manager.      (line 2024)
12362* BFD_RELOC_390_TLS_LOAD:                howto manager.      (line 2010)
12363* BFD_RELOC_390_TLS_TPOFF:               howto manager.      (line 2029)
12364* BFD_RELOC_64:                          howto manager.      (line   25)
12365* BFD_RELOC_64_PCREL:                    howto manager.      (line   33)
12366* BFD_RELOC_64_PLTOFF:                   howto manager.      (line   59)
12367* BFD_RELOC_64_PLT_PCREL:                howto manager.      (line   54)
12368* BFD_RELOC_68K_GLOB_DAT:                howto manager.      (line   70)
12369* BFD_RELOC_68K_JMP_SLOT:                howto manager.      (line   71)
12370* BFD_RELOC_68K_RELATIVE:                howto manager.      (line   72)
12371* BFD_RELOC_68K_TLS_GD16:                howto manager.      (line   74)
12372* BFD_RELOC_68K_TLS_GD32:                howto manager.      (line   73)
12373* BFD_RELOC_68K_TLS_GD8:                 howto manager.      (line   75)
12374* BFD_RELOC_68K_TLS_IE16:                howto manager.      (line   83)
12375* BFD_RELOC_68K_TLS_IE32:                howto manager.      (line   82)
12376* BFD_RELOC_68K_TLS_IE8:                 howto manager.      (line   84)
12377* BFD_RELOC_68K_TLS_LDM16:               howto manager.      (line   77)
12378* BFD_RELOC_68K_TLS_LDM32:               howto manager.      (line   76)
12379* BFD_RELOC_68K_TLS_LDM8:                howto manager.      (line   78)
12380* BFD_RELOC_68K_TLS_LDO16:               howto manager.      (line   80)
12381* BFD_RELOC_68K_TLS_LDO32:               howto manager.      (line   79)
12382* BFD_RELOC_68K_TLS_LDO8:                howto manager.      (line   81)
12383* BFD_RELOC_68K_TLS_LE16:                howto manager.      (line   86)
12384* BFD_RELOC_68K_TLS_LE32:                howto manager.      (line   85)
12385* BFD_RELOC_68K_TLS_LE8:                 howto manager.      (line   87)
12386* BFD_RELOC_8:                           howto manager.      (line   31)
12387* BFD_RELOC_8_BASEREL:                   howto manager.      (line   94)
12388* BFD_RELOC_8_FFnn:                      howto manager.      (line   97)
12389* BFD_RELOC_8_GOTOFF:                    howto manager.      (line   53)
12390* BFD_RELOC_8_GOT_PCREL:                 howto manager.      (line   47)
12391* BFD_RELOC_8_PCREL:                     howto manager.      (line   38)
12392* BFD_RELOC_8_PLTOFF:                    howto manager.      (line   65)
12393* BFD_RELOC_8_PLT_PCREL:                 howto manager.      (line   58)
12394* BFD_RELOC_AARCH64_16:                  howto manager.      (line 2794)
12395* BFD_RELOC_AARCH64_16_PCREL:            howto manager.      (line 2800)
12396* BFD_RELOC_AARCH64_32:                  howto manager.      (line 2793)
12397* BFD_RELOC_AARCH64_32_PCREL:            howto manager.      (line 2799)
12398* BFD_RELOC_AARCH64_64:                  howto manager.      (line 2792)
12399* BFD_RELOC_AARCH64_64_PCREL:            howto manager.      (line 2798)
12400* BFD_RELOC_AARCH64_ADD_LO12:            howto manager.      (line 2873)
12401* BFD_RELOC_AARCH64_ADR_GOT_PAGE:        howto manager.      (line 2919)
12402* BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL:   howto manager.      (line 2869)
12403* BFD_RELOC_AARCH64_ADR_HI21_PCREL:      howto manager.      (line 2866)
12404* BFD_RELOC_AARCH64_ADR_LO21_PCREL:      howto manager.      (line 2863)
12405* BFD_RELOC_AARCH64_BRANCH19:            howto manager.      (line 2885)
12406* BFD_RELOC_AARCH64_CALL26:              howto manager.      (line 2893)
12407* BFD_RELOC_AARCH64_COPY:                howto manager.      (line 3086)
12408* BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP:  howto manager.      (line 3110)
12409* BFD_RELOC_AARCH64_GLOB_DAT:            howto manager.      (line 3088)
12410* BFD_RELOC_AARCH64_GOT_LD_PREL19:       howto manager.      (line 2913)
12411* BFD_RELOC_AARCH64_IRELATIVE:           howto manager.      (line 3102)
12412* BFD_RELOC_AARCH64_JUMP26:              howto manager.      (line 2889)
12413* BFD_RELOC_AARCH64_JUMP_SLOT:           howto manager.      (line 3090)
12414* BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14:   howto manager.      (line 2940)
12415* BFD_RELOC_AARCH64_LD32_GOT_LO12_NC:    howto manager.      (line 2927)
12416* BFD_RELOC_AARCH64_LD64_GOTOFF_LO15:    howto manager.      (line 2937)
12417* BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15:   howto manager.      (line 2943)
12418* BFD_RELOC_AARCH64_LD64_GOT_LO12_NC:    howto manager.      (line 2923)
12419* BFD_RELOC_AARCH64_LDST128_LO12:        howto manager.      (line 2909)
12420* BFD_RELOC_AARCH64_LDST16_LO12:         howto manager.      (line 2897)
12421* BFD_RELOC_AARCH64_LDST32_LO12:         howto manager.      (line 2901)
12422* BFD_RELOC_AARCH64_LDST64_LO12:         howto manager.      (line 2905)
12423* BFD_RELOC_AARCH64_LDST8_LO12:          howto manager.      (line 2877)
12424* BFD_RELOC_AARCH64_LDST_LO12:           howto manager.      (line 3113)
12425* BFD_RELOC_AARCH64_LD_GOT_LO12_NC:      howto manager.      (line 3131)
12426* BFD_RELOC_AARCH64_LD_LO19_PCREL:       howto manager.      (line 2859)
12427* BFD_RELOC_AARCH64_MOVW_G0:             howto manager.      (line 2803)
12428* BFD_RELOC_AARCH64_MOVW_G0_NC:          howto manager.      (line 2806)
12429* BFD_RELOC_AARCH64_MOVW_G0_S:           howto manager.      (line 2824)
12430* BFD_RELOC_AARCH64_MOVW_G1:             howto manager.      (line 2809)
12431* BFD_RELOC_AARCH64_MOVW_G1_NC:          howto manager.      (line 2812)
12432* BFD_RELOC_AARCH64_MOVW_G1_S:           howto manager.      (line 2828)
12433* BFD_RELOC_AARCH64_MOVW_G2:             howto manager.      (line 2815)
12434* BFD_RELOC_AARCH64_MOVW_G2_NC:          howto manager.      (line 2818)
12435* BFD_RELOC_AARCH64_MOVW_G2_S:           howto manager.      (line 2832)
12436* BFD_RELOC_AARCH64_MOVW_G3:             howto manager.      (line 2821)
12437* BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC:   howto manager.      (line 2931)
12438* BFD_RELOC_AARCH64_MOVW_GOTOFF_G1:      howto manager.      (line 2934)
12439* BFD_RELOC_AARCH64_MOVW_PREL_G0:        howto manager.      (line 2836)
12440* BFD_RELOC_AARCH64_MOVW_PREL_G0_NC:     howto manager.      (line 2840)
12441* BFD_RELOC_AARCH64_MOVW_PREL_G1:        howto manager.      (line 2844)
12442* BFD_RELOC_AARCH64_MOVW_PREL_G1_NC:     howto manager.      (line 2847)
12443* BFD_RELOC_AARCH64_MOVW_PREL_G2:        howto manager.      (line 2850)
12444* BFD_RELOC_AARCH64_MOVW_PREL_G2_NC:     howto manager.      (line 2853)
12445* BFD_RELOC_AARCH64_MOVW_PREL_G3:        howto manager.      (line 2856)
12446* BFD_RELOC_AARCH64_NONE:                howto manager.      (line 2790)
12447* BFD_RELOC_AARCH64_NULL:                howto manager.      (line 2788)
12448* BFD_RELOC_AARCH64_RELATIVE:            howto manager.      (line 3092)
12449* BFD_RELOC_AARCH64_RELOC_END:           howto manager.      (line 3104)
12450* BFD_RELOC_AARCH64_RELOC_START:         howto manager.      (line 2783)
12451* BFD_RELOC_AARCH64_TLSDESC:             howto manager.      (line 3100)
12452* BFD_RELOC_AARCH64_TLSDESC_ADD:         howto manager.      (line 3082)
12453* BFD_RELOC_AARCH64_TLSDESC_ADD_LO12:    howto manager.      (line 3074)
12454* BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21:  howto manager.      (line 3068)
12455* BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21:  howto manager.      (line 3066)
12456* BFD_RELOC_AARCH64_TLSDESC_CALL:        howto manager.      (line 3084)
12457* BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC: howto manager.     (line 3072)
12458* BFD_RELOC_AARCH64_TLSDESC_LD64_LO12:   howto manager.      (line 3070)
12459* BFD_RELOC_AARCH64_TLSDESC_LDR:         howto manager.      (line 3080)
12460* BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC:  howto manager.      (line 3137)
12461* BFD_RELOC_AARCH64_TLSDESC_LD_PREL19:   howto manager.      (line 3064)
12462* BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC:   howto manager.      (line 3078)
12463* BFD_RELOC_AARCH64_TLSDESC_OFF_G1:      howto manager.      (line 3076)
12464* BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC:   howto manager.      (line 2953)
12465* BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21:    howto manager.      (line 2946)
12466* BFD_RELOC_AARCH64_TLSGD_ADR_PREL21:    howto manager.      (line 2951)
12467* BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC:    howto manager.      (line 2957)
12468* BFD_RELOC_AARCH64_TLSGD_MOVW_G1:       howto manager.      (line 2959)
12469* BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21: howto manager.
12470                                                             (line 2961)
12471* BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC: howto manager.
12472                                                             (line 2965)
12473* BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC: howto manager.
12474                                                             (line 2963)
12475* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC: howto manager.
12476                                                             (line 3134)
12477* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19: howto manager. (line 2967)
12478* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC: howto manager.
12479                                                             (line 2969)
12480* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1: howto manager.   (line 2971)
12481* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12: howto manager.    (line 2973)
12482* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12: howto manager.    (line 2975)
12483* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC: howto manager. (line 2977)
12484* BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC:   howto manager.      (line 2980)
12485* BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21:    howto manager.      (line 2984)
12486* BFD_RELOC_AARCH64_TLSLD_ADR_PREL21:    howto manager.      (line 2987)
12487* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12: howto manager. (line 2990)
12488* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC: howto manager.
12489                                                             (line 2993)
12490* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12: howto manager. (line 2996)
12491* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC: howto manager.
12492                                                             (line 2999)
12493* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12: howto manager. (line 3002)
12494* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC: howto manager.
12495                                                             (line 3005)
12496* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12: howto manager.  (line 3008)
12497* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC: howto manager.
12498                                                             (line 3011)
12499* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12: howto manager.   (line 3117)
12500* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC: howto manager.
12501                                                             (line 3121)
12502* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0: howto manager.     (line 3014)
12503* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC: howto manager.  (line 3016)
12504* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1: howto manager.     (line 3018)
12505* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC: howto manager.  (line 3020)
12506* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2: howto manager.     (line 3022)
12507* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12: howto manager.     (line 3034)
12508* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12: howto manager.     (line 3036)
12509* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC: howto manager.  (line 3038)
12510* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12: howto manager.  (line 3040)
12511* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC: howto manager.
12512                                                             (line 3043)
12513* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12: howto manager.  (line 3046)
12514* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC: howto manager.
12515                                                             (line 3049)
12516* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12: howto manager.  (line 3052)
12517* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC: howto manager.
12518                                                             (line 3055)
12519* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12: howto manager.   (line 3058)
12520* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC: howto manager.
12521                                                             (line 3061)
12522* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12: howto manager.    (line 3124)
12523* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC: howto manager. (line 3128)
12524* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0: howto manager.      (line 3030)
12525* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC: howto manager.   (line 3032)
12526* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1: howto manager.      (line 3026)
12527* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC: howto manager.   (line 3028)
12528* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2: howto manager.      (line 3024)
12529* BFD_RELOC_AARCH64_TLS_DTPMOD:          howto manager.      (line 3094)
12530* BFD_RELOC_AARCH64_TLS_DTPREL:          howto manager.      (line 3096)
12531* BFD_RELOC_AARCH64_TLS_TPREL:           howto manager.      (line 3098)
12532* BFD_RELOC_AARCH64_TSTBR14:             howto manager.      (line 2881)
12533* BFD_RELOC_AC_SECTOFF_S9:               howto manager.      (line 1062)
12534* BFD_RELOC_AC_SECTOFF_S9_1:             howto manager.      (line 1063)
12535* BFD_RELOC_AC_SECTOFF_S9_2:             howto manager.      (line 1064)
12536* BFD_RELOC_AC_SECTOFF_U8:               howto manager.      (line 1059)
12537* BFD_RELOC_AC_SECTOFF_U8_1:             howto manager.      (line 1060)
12538* BFD_RELOC_AC_SECTOFF_U8_2:             howto manager.      (line 1061)
12539* BFD_RELOC_ALPHA_BOH:                   howto manager.      (line  288)
12540* BFD_RELOC_ALPHA_BRSGP:                 howto manager.      (line  275)
12541* BFD_RELOC_ALPHA_BSR:                   howto manager.      (line  282)
12542* BFD_RELOC_ALPHA_CODEADDR:              howto manager.      (line  268)
12543* BFD_RELOC_ALPHA_DTPMOD64:              howto manager.      (line  293)
12544* BFD_RELOC_ALPHA_DTPREL16:              howto manager.      (line  298)
12545* BFD_RELOC_ALPHA_DTPREL64:              howto manager.      (line  295)
12546* BFD_RELOC_ALPHA_DTPREL_HI16:           howto manager.      (line  296)
12547* BFD_RELOC_ALPHA_DTPREL_LO16:           howto manager.      (line  297)
12548* BFD_RELOC_ALPHA_ELF_LITERAL:           howto manager.      (line  236)
12549* BFD_RELOC_ALPHA_GOTDTPREL16:           howto manager.      (line  294)
12550* BFD_RELOC_ALPHA_GOTTPREL16:            howto manager.      (line  299)
12551* BFD_RELOC_ALPHA_GPDISP:                howto manager.      (line  231)
12552* BFD_RELOC_ALPHA_GPDISP_HI16:           howto manager.      (line  219)
12553* BFD_RELOC_ALPHA_GPDISP_LO16:           howto manager.      (line  226)
12554* BFD_RELOC_ALPHA_GPREL_HI16:            howto manager.      (line  271)
12555* BFD_RELOC_ALPHA_GPREL_LO16:            howto manager.      (line  272)
12556* BFD_RELOC_ALPHA_HINT:                  howto manager.      (line  261)
12557* BFD_RELOC_ALPHA_LDA:                   howto manager.      (line  285)
12558* BFD_RELOC_ALPHA_LINKAGE:               howto manager.      (line  265)
12559* BFD_RELOC_ALPHA_LITERAL:               howto manager.      (line  235)
12560* BFD_RELOC_ALPHA_LITUSE:                howto manager.      (line  237)
12561* BFD_RELOC_ALPHA_NOP:                   howto manager.      (line  279)
12562* BFD_RELOC_ALPHA_TLSGD:                 howto manager.      (line  291)
12563* BFD_RELOC_ALPHA_TLSLDM:                howto manager.      (line  292)
12564* BFD_RELOC_ALPHA_TPREL16:               howto manager.      (line  303)
12565* BFD_RELOC_ALPHA_TPREL64:               howto manager.      (line  300)
12566* BFD_RELOC_ALPHA_TPREL_HI16:            howto manager.      (line  301)
12567* BFD_RELOC_ALPHA_TPREL_LO16:            howto manager.      (line  302)
12568* BFD_RELOC_ARC_16:                      howto manager.      (line 1031)
12569* BFD_RELOC_ARC_24:                      howto manager.      (line 1032)
12570* BFD_RELOC_ARC_32:                      howto manager.      (line 1033)
12571* BFD_RELOC_ARC_32_ME:                   howto manager.      (line 1053)
12572* BFD_RELOC_ARC_32_ME_S:                 howto manager.      (line 1054)
12573* BFD_RELOC_ARC_32_PCREL:                howto manager.      (line 1071)
12574* BFD_RELOC_ARC_8:                       howto manager.      (line 1030)
12575* BFD_RELOC_ARC_COPY:                    howto manager.      (line 1076)
12576* BFD_RELOC_ARC_GLOB_DAT:                howto manager.      (line 1077)
12577* BFD_RELOC_ARC_GOT32:                   howto manager.      (line 1073)
12578* BFD_RELOC_ARC_GOTOFF:                  howto manager.      (line 1080)
12579* BFD_RELOC_ARC_GOTPC:                   howto manager.      (line 1081)
12580* BFD_RELOC_ARC_GOTPC32:                 howto manager.      (line 1074)
12581* BFD_RELOC_ARC_JLI_SECTOFF:             howto manager.      (line 1097)
12582* BFD_RELOC_ARC_JMP_SLOT:                howto manager.      (line 1078)
12583* BFD_RELOC_ARC_N16:                     howto manager.      (line 1035)
12584* BFD_RELOC_ARC_N24:                     howto manager.      (line 1036)
12585* BFD_RELOC_ARC_N32:                     howto manager.      (line 1037)
12586* BFD_RELOC_ARC_N32_ME:                  howto manager.      (line 1055)
12587* BFD_RELOC_ARC_N8:                      howto manager.      (line 1034)
12588* BFD_RELOC_ARC_NONE:                    howto manager.      (line 1029)
12589* BFD_RELOC_ARC_NPS_CMEM16:              howto manager.      (line 1096)
12590* BFD_RELOC_ARC_PC32:                    howto manager.      (line 1072)
12591* BFD_RELOC_ARC_PLT32:                   howto manager.      (line 1075)
12592* BFD_RELOC_ARC_RELATIVE:                howto manager.      (line 1079)
12593* BFD_RELOC_ARC_S13_PCREL:               howto manager.      (line 1051)
12594* BFD_RELOC_ARC_S21H_PCREL:              howto manager.      (line 1040)
12595* BFD_RELOC_ARC_S21H_PCREL_PLT:          howto manager.      (line 1095)
12596* BFD_RELOC_ARC_S21W_PCREL:              howto manager.      (line 1041)
12597* BFD_RELOC_ARC_S21W_PCREL_PLT:          howto manager.      (line 1082)
12598* BFD_RELOC_ARC_S25H_PCREL:              howto manager.      (line 1042)
12599* BFD_RELOC_ARC_S25H_PCREL_PLT:          howto manager.      (line 1083)
12600* BFD_RELOC_ARC_S25W_PCREL:              howto manager.      (line 1043)
12601* BFD_RELOC_ARC_S25W_PCREL_PLT:          howto manager.      (line 1094)
12602* BFD_RELOC_ARC_SDA:                     howto manager.      (line 1038)
12603* BFD_RELOC_ARC_SDA16_LD:                howto manager.      (line 1048)
12604* BFD_RELOC_ARC_SDA16_LD1:               howto manager.      (line 1049)
12605* BFD_RELOC_ARC_SDA16_LD2:               howto manager.      (line 1050)
12606* BFD_RELOC_ARC_SDA16_ST2:               howto manager.      (line 1070)
12607* BFD_RELOC_ARC_SDA32:                   howto manager.      (line 1044)
12608* BFD_RELOC_ARC_SDA32_ME:                howto manager.      (line 1057)
12609* BFD_RELOC_ARC_SDA_12:                  howto manager.      (line 1069)
12610* BFD_RELOC_ARC_SDA_LDST:                howto manager.      (line 1045)
12611* BFD_RELOC_ARC_SDA_LDST1:               howto manager.      (line 1046)
12612* BFD_RELOC_ARC_SDA_LDST2:               howto manager.      (line 1047)
12613* BFD_RELOC_ARC_SECTOFF:                 howto manager.      (line 1039)
12614* BFD_RELOC_ARC_SECTOFF_1:               howto manager.      (line 1067)
12615* BFD_RELOC_ARC_SECTOFF_2:               howto manager.      (line 1068)
12616* BFD_RELOC_ARC_SECTOFF_ME:              howto manager.      (line 1056)
12617* BFD_RELOC_ARC_SECTOFF_ME_1:            howto manager.      (line 1065)
12618* BFD_RELOC_ARC_SECTOFF_ME_2:            howto manager.      (line 1066)
12619* BFD_RELOC_ARC_TLS_DTPMOD:              howto manager.      (line 1084)
12620* BFD_RELOC_ARC_TLS_DTPOFF:              howto manager.      (line 1090)
12621* BFD_RELOC_ARC_TLS_DTPOFF_S9:           howto manager.      (line 1091)
12622* BFD_RELOC_ARC_TLS_GD_CALL:             howto manager.      (line 1088)
12623* BFD_RELOC_ARC_TLS_GD_GOT:              howto manager.      (line 1086)
12624* BFD_RELOC_ARC_TLS_GD_LD:               howto manager.      (line 1087)
12625* BFD_RELOC_ARC_TLS_IE_GOT:              howto manager.      (line 1089)
12626* BFD_RELOC_ARC_TLS_LE_32:               howto manager.      (line 1093)
12627* BFD_RELOC_ARC_TLS_LE_S9:               howto manager.      (line 1092)
12628* BFD_RELOC_ARC_TLS_TPOFF:               howto manager.      (line 1085)
12629* BFD_RELOC_ARC_W:                       howto manager.      (line 1052)
12630* BFD_RELOC_ARC_W_ME:                    howto manager.      (line 1058)
12631* BFD_RELOC_ARM_ADRL_IMMEDIATE:          howto manager.      (line  902)
12632* BFD_RELOC_ARM_ADR_IMM:                 howto manager.      (line  917)
12633* BFD_RELOC_ARM_ALU_PC_G0:               howto manager.      (line  864)
12634* BFD_RELOC_ARM_ALU_PC_G0_NC:            howto manager.      (line  863)
12635* BFD_RELOC_ARM_ALU_PC_G1:               howto manager.      (line  866)
12636* BFD_RELOC_ARM_ALU_PC_G1_NC:            howto manager.      (line  865)
12637* BFD_RELOC_ARM_ALU_PC_G2:               howto manager.      (line  867)
12638* BFD_RELOC_ARM_ALU_SB_G0:               howto manager.      (line  878)
12639* BFD_RELOC_ARM_ALU_SB_G0_NC:            howto manager.      (line  877)
12640* BFD_RELOC_ARM_ALU_SB_G1:               howto manager.      (line  880)
12641* BFD_RELOC_ARM_ALU_SB_G1_NC:            howto manager.      (line  879)
12642* BFD_RELOC_ARM_ALU_SB_G2:               howto manager.      (line  881)
12643* BFD_RELOC_ARM_CP_OFF_IMM:              howto manager.      (line  912)
12644* BFD_RELOC_ARM_CP_OFF_IMM_S2:           howto manager.      (line  913)
12645* BFD_RELOC_ARM_FUNCDESC:                howto manager.      (line  833)
12646* BFD_RELOC_ARM_FUNCDESC_VALUE:          howto manager.      (line  834)
12647* BFD_RELOC_ARM_GLOB_DAT:                howto manager.      (line  840)
12648* BFD_RELOC_ARM_GOT32:                   howto manager.      (line  841)
12649* BFD_RELOC_ARM_GOTFUNCDESC:             howto manager.      (line  831)
12650* BFD_RELOC_ARM_GOTOFF:                  howto manager.      (line  844)
12651* BFD_RELOC_ARM_GOTOFFFUNCDESC:          howto manager.      (line  832)
12652* BFD_RELOC_ARM_GOTPC:                   howto manager.      (line  845)
12653* BFD_RELOC_ARM_GOT_PREL:                howto manager.      (line  846)
12654* BFD_RELOC_ARM_HVC:                     howto manager.      (line  909)
12655* BFD_RELOC_ARM_HWLITERAL:               howto manager.      (line  924)
12656* BFD_RELOC_ARM_IMMEDIATE:               howto manager.      (line  901)
12657* BFD_RELOC_ARM_IN_POOL:                 howto manager.      (line  920)
12658* BFD_RELOC_ARM_IRELATIVE:               howto manager.      (line  894)
12659* BFD_RELOC_ARM_JUMP_SLOT:               howto manager.      (line  839)
12660* BFD_RELOC_ARM_LDC_PC_G0:               howto manager.      (line  874)
12661* BFD_RELOC_ARM_LDC_PC_G1:               howto manager.      (line  875)
12662* BFD_RELOC_ARM_LDC_PC_G2:               howto manager.      (line  876)
12663* BFD_RELOC_ARM_LDC_SB_G0:               howto manager.      (line  888)
12664* BFD_RELOC_ARM_LDC_SB_G1:               howto manager.      (line  889)
12665* BFD_RELOC_ARM_LDC_SB_G2:               howto manager.      (line  890)
12666* BFD_RELOC_ARM_LDRS_PC_G0:              howto manager.      (line  871)
12667* BFD_RELOC_ARM_LDRS_PC_G1:              howto manager.      (line  872)
12668* BFD_RELOC_ARM_LDRS_PC_G2:              howto manager.      (line  873)
12669* BFD_RELOC_ARM_LDRS_SB_G0:              howto manager.      (line  885)
12670* BFD_RELOC_ARM_LDRS_SB_G1:              howto manager.      (line  886)
12671* BFD_RELOC_ARM_LDRS_SB_G2:              howto manager.      (line  887)
12672* BFD_RELOC_ARM_LDR_IMM:                 howto manager.      (line  918)
12673* BFD_RELOC_ARM_LDR_PC_G0:               howto manager.      (line  868)
12674* BFD_RELOC_ARM_LDR_PC_G1:               howto manager.      (line  869)
12675* BFD_RELOC_ARM_LDR_PC_G2:               howto manager.      (line  870)
12676* BFD_RELOC_ARM_LDR_SB_G0:               howto manager.      (line  882)
12677* BFD_RELOC_ARM_LDR_SB_G1:               howto manager.      (line  883)
12678* BFD_RELOC_ARM_LDR_SB_G2:               howto manager.      (line  884)
12679* BFD_RELOC_ARM_LITERAL:                 howto manager.      (line  919)
12680* BFD_RELOC_ARM_MOVT:                    howto manager.      (line  823)
12681* BFD_RELOC_ARM_MOVT_PCREL:              howto manager.      (line  825)
12682* BFD_RELOC_ARM_MOVW:                    howto manager.      (line  822)
12683* BFD_RELOC_ARM_MOVW_PCREL:              howto manager.      (line  824)
12684* BFD_RELOC_ARM_MULTI:                   howto manager.      (line  911)
12685* BFD_RELOC_ARM_OFFSET_IMM:              howto manager.      (line  803)
12686* BFD_RELOC_ARM_OFFSET_IMM8:             howto manager.      (line  921)
12687* BFD_RELOC_ARM_PCREL_BLX:               howto manager.      (line  767)
12688* BFD_RELOC_ARM_PCREL_BRANCH:            howto manager.      (line  764)
12689* BFD_RELOC_ARM_PCREL_CALL:              howto manager.      (line  775)
12690* BFD_RELOC_ARM_PCREL_JUMP:              howto manager.      (line  778)
12691* BFD_RELOC_ARM_PLT32:                   howto manager.      (line  842)
12692* BFD_RELOC_ARM_PREL31:                  howto manager.      (line  820)
12693* BFD_RELOC_ARM_RELATIVE:                howto manager.      (line  843)
12694* BFD_RELOC_ARM_ROSEGREL32:              howto manager.      (line  812)
12695* BFD_RELOC_ARM_SBREL32:                 howto manager.      (line  814)
12696* BFD_RELOC_ARM_SHIFT_IMM:               howto manager.      (line  907)
12697* BFD_RELOC_ARM_SMC:                     howto manager.      (line  908)
12698* BFD_RELOC_ARM_SWI:                     howto manager.      (line  910)
12699* BFD_RELOC_ARM_T32_ADD_IMM:             howto manager.      (line  904)
12700* BFD_RELOC_ARM_T32_ADD_PC12:            howto manager.      (line  906)
12701* BFD_RELOC_ARM_T32_CP_OFF_IMM:          howto manager.      (line  914)
12702* BFD_RELOC_ARM_T32_CP_OFF_IMM_S2:       howto manager.      (line  915)
12703* BFD_RELOC_ARM_T32_IMM12:               howto manager.      (line  905)
12704* BFD_RELOC_ARM_T32_IMMEDIATE:           howto manager.      (line  903)
12705* BFD_RELOC_ARM_T32_OFFSET_IMM:          howto manager.      (line  923)
12706* BFD_RELOC_ARM_T32_OFFSET_U8:           howto manager.      (line  922)
12707* BFD_RELOC_ARM_T32_VLDR_VSTR_OFF_IMM:   howto manager.      (line  916)
12708* BFD_RELOC_ARM_TARGET1:                 howto manager.      (line  809)
12709* BFD_RELOC_ARM_TARGET2:                 howto manager.      (line  816)
12710* BFD_RELOC_ARM_THM_TLS_CALL:            howto manager.      (line  858)
12711* BFD_RELOC_ARM_THM_TLS_DESCSEQ:         howto manager.      (line  860)
12712* BFD_RELOC_ARM_THUMB_ADD:               howto manager.      (line  925)
12713* BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC:     howto manager.      (line  896)
12714* BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC:     howto manager.      (line  897)
12715* BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC:     howto manager.      (line  898)
12716* BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC:     howto manager.      (line  899)
12717* BFD_RELOC_ARM_THUMB_BF13:              howto manager.      (line  786)
12718* BFD_RELOC_ARM_THUMB_BF17:              howto manager.      (line  784)
12719* BFD_RELOC_ARM_THUMB_BF19:              howto manager.      (line  788)
12720* BFD_RELOC_ARM_THUMB_IMM:               howto manager.      (line  926)
12721* BFD_RELOC_ARM_THUMB_LOOP12:            howto manager.      (line  790)
12722* BFD_RELOC_ARM_THUMB_MOVT:              howto manager.      (line  827)
12723* BFD_RELOC_ARM_THUMB_MOVT_PCREL:        howto manager.      (line  829)
12724* BFD_RELOC_ARM_THUMB_MOVW:              howto manager.      (line  826)
12725* BFD_RELOC_ARM_THUMB_MOVW_PCREL:        howto manager.      (line  828)
12726* BFD_RELOC_ARM_THUMB_OFFSET:            howto manager.      (line  806)
12727* BFD_RELOC_ARM_THUMB_SHIFT:             howto manager.      (line  927)
12728* BFD_RELOC_ARM_TLS_CALL:                howto manager.      (line  857)
12729* BFD_RELOC_ARM_TLS_DESC:                howto manager.      (line  861)
12730* BFD_RELOC_ARM_TLS_DESCSEQ:             howto manager.      (line  859)
12731* BFD_RELOC_ARM_TLS_DTPMOD32:            howto manager.      (line  852)
12732* BFD_RELOC_ARM_TLS_DTPOFF32:            howto manager.      (line  851)
12733* BFD_RELOC_ARM_TLS_GD32:                howto manager.      (line  848)
12734* BFD_RELOC_ARM_TLS_GD32_FDPIC:          howto manager.      (line  835)
12735* BFD_RELOC_ARM_TLS_GOTDESC:             howto manager.      (line  856)
12736* BFD_RELOC_ARM_TLS_IE32:                howto manager.      (line  854)
12737* BFD_RELOC_ARM_TLS_IE32_FDPIC:          howto manager.      (line  837)
12738* BFD_RELOC_ARM_TLS_LDM32:               howto manager.      (line  850)
12739* BFD_RELOC_ARM_TLS_LDM32_FDPIC:         howto manager.      (line  836)
12740* BFD_RELOC_ARM_TLS_LDO32:               howto manager.      (line  849)
12741* BFD_RELOC_ARM_TLS_LE32:                howto manager.      (line  855)
12742* BFD_RELOC_ARM_TLS_TPOFF32:             howto manager.      (line  853)
12743* BFD_RELOC_ARM_V4BX:                    howto manager.      (line  892)
12744* BFD_RELOC_AVR_13_PCREL:                howto manager.      (line 1734)
12745* BFD_RELOC_AVR_16_PM:                   howto manager.      (line 1737)
12746* BFD_RELOC_AVR_6:                       howto manager.      (line 1805)
12747* BFD_RELOC_AVR_6_ADIW:                  howto manager.      (line 1808)
12748* BFD_RELOC_AVR_7_PCREL:                 howto manager.      (line 1731)
12749* BFD_RELOC_AVR_8_HI:                    howto manager.      (line 1814)
12750* BFD_RELOC_AVR_8_HLO:                   howto manager.      (line 1817)
12751* BFD_RELOC_AVR_8_LO:                    howto manager.      (line 1811)
12752* BFD_RELOC_AVR_CALL:                    howto manager.      (line 1799)
12753* BFD_RELOC_AVR_DIFF16:                  howto manager.      (line 1821)
12754* BFD_RELOC_AVR_DIFF32:                  howto manager.      (line 1822)
12755* BFD_RELOC_AVR_DIFF8:                   howto manager.      (line 1820)
12756* BFD_RELOC_AVR_HH8_LDI:                 howto manager.      (line 1746)
12757* BFD_RELOC_AVR_HH8_LDI_NEG:             howto manager.      (line 1761)
12758* BFD_RELOC_AVR_HH8_LDI_PM:              howto manager.      (line 1784)
12759* BFD_RELOC_AVR_HH8_LDI_PM_NEG:          howto manager.      (line 1795)
12760* BFD_RELOC_AVR_HI8_LDI:                 howto manager.      (line 1743)
12761* BFD_RELOC_AVR_HI8_LDI_GS:              howto manager.      (line 1779)
12762* BFD_RELOC_AVR_HI8_LDI_NEG:             howto manager.      (line 1757)
12763* BFD_RELOC_AVR_HI8_LDI_PM:              howto manager.      (line 1776)
12764* BFD_RELOC_AVR_HI8_LDI_PM_NEG:          howto manager.      (line 1791)
12765* BFD_RELOC_AVR_LDI:                     howto manager.      (line 1802)
12766* BFD_RELOC_AVR_LDS_STS_16:              howto manager.      (line 1829)
12767* BFD_RELOC_AVR_LO8_LDI:                 howto manager.      (line 1740)
12768* BFD_RELOC_AVR_LO8_LDI_GS:              howto manager.      (line 1771)
12769* BFD_RELOC_AVR_LO8_LDI_NEG:             howto manager.      (line 1753)
12770* BFD_RELOC_AVR_LO8_LDI_PM:              howto manager.      (line 1768)
12771* BFD_RELOC_AVR_LO8_LDI_PM_NEG:          howto manager.      (line 1788)
12772* BFD_RELOC_AVR_MS8_LDI:                 howto manager.      (line 1750)
12773* BFD_RELOC_AVR_MS8_LDI_NEG:             howto manager.      (line 1765)
12774* BFD_RELOC_AVR_PORT5:                   howto manager.      (line 1835)
12775* BFD_RELOC_AVR_PORT6:                   howto manager.      (line 1832)
12776* BFD_RELOC_BFIN_10_PCREL:               howto manager.      (line 1109)
12777* BFD_RELOC_BFIN_11_PCREL:               howto manager.      (line 1111)
12778* BFD_RELOC_BFIN_12_PCREL_JUMP:          howto manager.      (line 1113)
12779* BFD_RELOC_BFIN_12_PCREL_JUMP_S:        howto manager.      (line 1115)
12780* BFD_RELOC_BFIN_16_HIGH:                howto manager.      (line 1101)
12781* BFD_RELOC_BFIN_16_IMM:                 howto manager.      (line 1099)
12782* BFD_RELOC_BFIN_16_LOW:                 howto manager.      (line 1107)
12783* BFD_RELOC_BFIN_24_PCREL_CALL_X:        howto manager.      (line 1117)
12784* BFD_RELOC_BFIN_24_PCREL_JUMP_L:        howto manager.      (line 1119)
12785* BFD_RELOC_BFIN_4_PCREL:                howto manager.      (line 1103)
12786* BFD_RELOC_BFIN_5_PCREL:                howto manager.      (line 1105)
12787* BFD_RELOC_BFIN_FUNCDESC:               howto manager.      (line 1124)
12788* BFD_RELOC_BFIN_FUNCDESC_GOT17M4:       howto manager.      (line 1125)
12789* BFD_RELOC_BFIN_FUNCDESC_GOTHI:         howto manager.      (line 1126)
12790* BFD_RELOC_BFIN_FUNCDESC_GOTLO:         howto manager.      (line 1127)
12791* BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4:    howto manager.      (line 1129)
12792* BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI:      howto manager.      (line 1130)
12793* BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO:      howto manager.      (line 1131)
12794* BFD_RELOC_BFIN_FUNCDESC_VALUE:         howto manager.      (line 1128)
12795* BFD_RELOC_BFIN_GOT:                    howto manager.      (line 1136)
12796* BFD_RELOC_BFIN_GOT17M4:                howto manager.      (line 1121)
12797* BFD_RELOC_BFIN_GOTHI:                  howto manager.      (line 1122)
12798* BFD_RELOC_BFIN_GOTLO:                  howto manager.      (line 1123)
12799* BFD_RELOC_BFIN_GOTOFF17M4:             howto manager.      (line 1132)
12800* BFD_RELOC_BFIN_GOTOFFHI:               howto manager.      (line 1133)
12801* BFD_RELOC_BFIN_GOTOFFLO:               howto manager.      (line 1134)
12802* BFD_RELOC_BFIN_PLTPC:                  howto manager.      (line 1138)
12803* BFD_RELOC_BPF_16:                      howto manager.      (line 3332)
12804* BFD_RELOC_BPF_32:                      howto manager.      (line 3331)
12805* BFD_RELOC_BPF_64:                      howto manager.      (line 3330)
12806* BFD_RELOC_BPF_DISP16:                  howto manager.      (line 3333)
12807* BFD_RELOC_BPF_DISP32:                  howto manager.      (line 3334)
12808* BFD_RELOC_C6000_ABS_H16:               howto manager.      (line 1576)
12809* BFD_RELOC_C6000_ABS_L16:               howto manager.      (line 1575)
12810* BFD_RELOC_C6000_ABS_S16:               howto manager.      (line 1574)
12811* BFD_RELOC_C6000_ALIGN:                 howto manager.      (line 1597)
12812* BFD_RELOC_C6000_COPY:                  howto manager.      (line 1592)
12813* BFD_RELOC_C6000_DSBT_INDEX:            howto manager.      (line 1590)
12814* BFD_RELOC_C6000_EHTYPE:                howto manager.      (line 1594)
12815* BFD_RELOC_C6000_FPHEAD:                howto manager.      (line 1598)
12816* BFD_RELOC_C6000_JUMP_SLOT:             howto manager.      (line 1593)
12817* BFD_RELOC_C6000_NOCMP:                 howto manager.      (line 1599)
12818* BFD_RELOC_C6000_PCR_H16:               howto manager.      (line 1595)
12819* BFD_RELOC_C6000_PCR_L16:               howto manager.      (line 1596)
12820* BFD_RELOC_C6000_PCR_S10:               howto manager.      (line 1572)
12821* BFD_RELOC_C6000_PCR_S12:               howto manager.      (line 1571)
12822* BFD_RELOC_C6000_PCR_S21:               howto manager.      (line 1570)
12823* BFD_RELOC_C6000_PCR_S7:                howto manager.      (line 1573)
12824* BFD_RELOC_C6000_PREL31:                howto manager.      (line 1591)
12825* BFD_RELOC_C6000_SBR_GOT_H16_W:         howto manager.      (line 1589)
12826* BFD_RELOC_C6000_SBR_GOT_L16_W:         howto manager.      (line 1588)
12827* BFD_RELOC_C6000_SBR_GOT_U15_W:         howto manager.      (line 1587)
12828* BFD_RELOC_C6000_SBR_H16_B:             howto manager.      (line 1584)
12829* BFD_RELOC_C6000_SBR_H16_H:             howto manager.      (line 1585)
12830* BFD_RELOC_C6000_SBR_H16_W:             howto manager.      (line 1586)
12831* BFD_RELOC_C6000_SBR_L16_B:             howto manager.      (line 1581)
12832* BFD_RELOC_C6000_SBR_L16_H:             howto manager.      (line 1582)
12833* BFD_RELOC_C6000_SBR_L16_W:             howto manager.      (line 1583)
12834* BFD_RELOC_C6000_SBR_S16:               howto manager.      (line 1580)
12835* BFD_RELOC_C6000_SBR_U15_B:             howto manager.      (line 1577)
12836* BFD_RELOC_C6000_SBR_U15_H:             howto manager.      (line 1578)
12837* BFD_RELOC_C6000_SBR_U15_W:             howto manager.      (line 1579)
12838* BFD_RELOC_CKCORE_ADDR32:               howto manager.      (line 3371)
12839* BFD_RELOC_CKCORE_ADDRGOT:              howto manager.      (line 3387)
12840* BFD_RELOC_CKCORE_ADDRGOT_HI16:         howto manager.      (line 3406)
12841* BFD_RELOC_CKCORE_ADDRGOT_LO16:         howto manager.      (line 3407)
12842* BFD_RELOC_CKCORE_ADDRPLT:              howto manager.      (line 3388)
12843* BFD_RELOC_CKCORE_ADDRPLT_HI16:         howto manager.      (line 3408)
12844* BFD_RELOC_CKCORE_ADDRPLT_LO16:         howto manager.      (line 3409)
12845* BFD_RELOC_CKCORE_ADDR_HI16:            howto manager.      (line 3394)
12846* BFD_RELOC_CKCORE_ADDR_LO16:            howto manager.      (line 3395)
12847* BFD_RELOC_CKCORE_CALLGRAPH:            howto manager.      (line 3431)
12848* BFD_RELOC_CKCORE_COPY:                 howto manager.      (line 3380)
12849* BFD_RELOC_CKCORE_DOFFSET_IMM18:        howto manager.      (line 3414)
12850* BFD_RELOC_CKCORE_DOFFSET_IMM18BY2:     howto manager.      (line 3415)
12851* BFD_RELOC_CKCORE_DOFFSET_IMM18BY4:     howto manager.      (line 3416)
12852* BFD_RELOC_CKCORE_DOFFSET_LO16:         howto manager.      (line 3412)
12853* BFD_RELOC_CKCORE_GLOB_DAT:             howto manager.      (line 3381)
12854* BFD_RELOC_CKCORE_GNU_VTENTRY:          howto manager.      (line 3378)
12855* BFD_RELOC_CKCORE_GNU_VTINHERIT:        howto manager.      (line 3377)
12856* BFD_RELOC_CKCORE_GOT12:                howto manager.      (line 3400)
12857* BFD_RELOC_CKCORE_GOT32:                howto manager.      (line 3385)
12858* BFD_RELOC_CKCORE_GOTOFF:               howto manager.      (line 3383)
12859* BFD_RELOC_CKCORE_GOTOFF_HI16:          howto manager.      (line 3398)
12860* BFD_RELOC_CKCORE_GOTOFF_IMM18:         howto manager.      (line 3417)
12861* BFD_RELOC_CKCORE_GOTOFF_LO16:          howto manager.      (line 3399)
12862* BFD_RELOC_CKCORE_GOTPC:                howto manager.      (line 3384)
12863* BFD_RELOC_CKCORE_GOTPC_HI16:           howto manager.      (line 3396)
12864* BFD_RELOC_CKCORE_GOTPC_LO16:           howto manager.      (line 3397)
12865* BFD_RELOC_CKCORE_GOT_HI16:             howto manager.      (line 3401)
12866* BFD_RELOC_CKCORE_GOT_IMM18BY4:         howto manager.      (line 3418)
12867* BFD_RELOC_CKCORE_GOT_LO16:             howto manager.      (line 3402)
12868* BFD_RELOC_CKCORE_IRELATIVE:            howto manager.      (line 3432)
12869* BFD_RELOC_CKCORE_JUMP_SLOT:            howto manager.      (line 3382)
12870* BFD_RELOC_CKCORE_NOJSRI:               howto manager.      (line 3430)
12871* BFD_RELOC_CKCORE_NONE:                 howto manager.      (line 3370)
12872* BFD_RELOC_CKCORE_PCREL32:              howto manager.      (line 3375)
12873* BFD_RELOC_CKCORE_PCREL_BLOOP_IMM12BY4: howto manager.      (line 3434)
12874* BFD_RELOC_CKCORE_PCREL_BLOOP_IMM4BY4:  howto manager.      (line 3433)
12875* BFD_RELOC_CKCORE_PCREL_FLRW_IMM8BY4:   howto manager.      (line 3429)
12876* BFD_RELOC_CKCORE_PCREL_IMM10BY2:       howto manager.      (line 3392)
12877* BFD_RELOC_CKCORE_PCREL_IMM10BY4:       howto manager.      (line 3393)
12878* BFD_RELOC_CKCORE_PCREL_IMM11BY2:       howto manager.      (line 3373)
12879* BFD_RELOC_CKCORE_PCREL_IMM16BY2:       howto manager.      (line 3390)
12880* BFD_RELOC_CKCORE_PCREL_IMM16BY4:       howto manager.      (line 3391)
12881* BFD_RELOC_CKCORE_PCREL_IMM18BY2:       howto manager.      (line 3413)
12882* BFD_RELOC_CKCORE_PCREL_IMM26BY2:       howto manager.      (line 3389)
12883* BFD_RELOC_CKCORE_PCREL_IMM4BY2:        howto manager.      (line 3374)
12884* BFD_RELOC_CKCORE_PCREL_IMM7BY4:        howto manager.      (line 3420)
12885* BFD_RELOC_CKCORE_PCREL_IMM8BY4:        howto manager.      (line 3372)
12886* BFD_RELOC_CKCORE_PCREL_JSR_IMM11BY2:   howto manager.      (line 3376)
12887* BFD_RELOC_CKCORE_PCREL_JSR_IMM26BY2:   howto manager.      (line 3410)
12888* BFD_RELOC_CKCORE_PLT12:                howto manager.      (line 3403)
12889* BFD_RELOC_CKCORE_PLT32:                howto manager.      (line 3386)
12890* BFD_RELOC_CKCORE_PLT_HI16:             howto manager.      (line 3404)
12891* BFD_RELOC_CKCORE_PLT_IMM18BY4:         howto manager.      (line 3419)
12892* BFD_RELOC_CKCORE_PLT_LO16:             howto manager.      (line 3405)
12893* BFD_RELOC_CKCORE_RELATIVE:             howto manager.      (line 3379)
12894* BFD_RELOC_CKCORE_TLS_DTPMOD32:         howto manager.      (line 3426)
12895* BFD_RELOC_CKCORE_TLS_DTPOFF32:         howto manager.      (line 3427)
12896* BFD_RELOC_CKCORE_TLS_GD32:             howto manager.      (line 3423)
12897* BFD_RELOC_CKCORE_TLS_IE32:             howto manager.      (line 3422)
12898* BFD_RELOC_CKCORE_TLS_LDM32:            howto manager.      (line 3424)
12899* BFD_RELOC_CKCORE_TLS_LDO32:            howto manager.      (line 3425)
12900* BFD_RELOC_CKCORE_TLS_LE32:             howto manager.      (line 3421)
12901* BFD_RELOC_CKCORE_TLS_TPOFF32:          howto manager.      (line 3428)
12902* BFD_RELOC_CKCORE_TOFFSET_LO16:         howto manager.      (line 3411)
12903* bfd_reloc_code_type:                   howto manager.      (line    9)
12904* BFD_RELOC_CR16_ABS20:                  howto manager.      (line 2276)
12905* BFD_RELOC_CR16_ABS24:                  howto manager.      (line 2277)
12906* BFD_RELOC_CR16_DISP16:                 howto manager.      (line 2287)
12907* BFD_RELOC_CR16_DISP20:                 howto manager.      (line 2288)
12908* BFD_RELOC_CR16_DISP24:                 howto manager.      (line 2289)
12909* BFD_RELOC_CR16_DISP24a:                howto manager.      (line 2290)
12910* BFD_RELOC_CR16_DISP4:                  howto manager.      (line 2285)
12911* BFD_RELOC_CR16_DISP8:                  howto manager.      (line 2286)
12912* BFD_RELOC_CR16_GLOB_DAT:               howto manager.      (line 2296)
12913* BFD_RELOC_CR16_GOTC_REGREL20:          howto manager.      (line 2295)
12914* BFD_RELOC_CR16_GOT_REGREL20:           howto manager.      (line 2294)
12915* BFD_RELOC_CR16_IMM16:                  howto manager.      (line 2280)
12916* BFD_RELOC_CR16_IMM20:                  howto manager.      (line 2281)
12917* BFD_RELOC_CR16_IMM24:                  howto manager.      (line 2282)
12918* BFD_RELOC_CR16_IMM32:                  howto manager.      (line 2283)
12919* BFD_RELOC_CR16_IMM32a:                 howto manager.      (line 2284)
12920* BFD_RELOC_CR16_IMM4:                   howto manager.      (line 2278)
12921* BFD_RELOC_CR16_IMM8:                   howto manager.      (line 2279)
12922* BFD_RELOC_CR16_NUM16:                  howto manager.      (line 2265)
12923* BFD_RELOC_CR16_NUM32:                  howto manager.      (line 2266)
12924* BFD_RELOC_CR16_NUM32a:                 howto manager.      (line 2267)
12925* BFD_RELOC_CR16_NUM8:                   howto manager.      (line 2264)
12926* BFD_RELOC_CR16_REGREL0:                howto manager.      (line 2268)
12927* BFD_RELOC_CR16_REGREL14:               howto manager.      (line 2271)
12928* BFD_RELOC_CR16_REGREL14a:              howto manager.      (line 2272)
12929* BFD_RELOC_CR16_REGREL16:               howto manager.      (line 2273)
12930* BFD_RELOC_CR16_REGREL20:               howto manager.      (line 2274)
12931* BFD_RELOC_CR16_REGREL20a:              howto manager.      (line 2275)
12932* BFD_RELOC_CR16_REGREL4:                howto manager.      (line 2269)
12933* BFD_RELOC_CR16_REGREL4a:               howto manager.      (line 2270)
12934* BFD_RELOC_CR16_SWITCH16:               howto manager.      (line 2292)
12935* BFD_RELOC_CR16_SWITCH32:               howto manager.      (line 2293)
12936* BFD_RELOC_CR16_SWITCH8:                howto manager.      (line 2291)
12937* BFD_RELOC_CRIS_16_DTPREL:              howto manager.      (line 2356)
12938* BFD_RELOC_CRIS_16_GOT:                 howto manager.      (line 2338)
12939* BFD_RELOC_CRIS_16_GOTPLT:              howto manager.      (line 2342)
12940* BFD_RELOC_CRIS_16_GOT_GD:              howto manager.      (line 2352)
12941* BFD_RELOC_CRIS_16_GOT_TPREL:           howto manager.      (line 2358)
12942* BFD_RELOC_CRIS_16_TPREL:               howto manager.      (line 2360)
12943* BFD_RELOC_CRIS_32_DTPREL:              howto manager.      (line 2355)
12944* BFD_RELOC_CRIS_32_GD:                  howto manager.      (line 2353)
12945* BFD_RELOC_CRIS_32_GOT:                 howto manager.      (line 2336)
12946* BFD_RELOC_CRIS_32_GOTPLT:              howto manager.      (line 2340)
12947* BFD_RELOC_CRIS_32_GOTREL:              howto manager.      (line 2344)
12948* BFD_RELOC_CRIS_32_GOT_GD:              howto manager.      (line 2351)
12949* BFD_RELOC_CRIS_32_GOT_TPREL:           howto manager.      (line 2357)
12950* BFD_RELOC_CRIS_32_IE:                  howto manager.      (line 2362)
12951* BFD_RELOC_CRIS_32_PLT_GOTREL:          howto manager.      (line 2346)
12952* BFD_RELOC_CRIS_32_PLT_PCREL:           howto manager.      (line 2348)
12953* BFD_RELOC_CRIS_32_TPREL:               howto manager.      (line 2359)
12954* BFD_RELOC_CRIS_BDISP8:                 howto manager.      (line 2319)
12955* BFD_RELOC_CRIS_COPY:                   howto manager.      (line 2331)
12956* BFD_RELOC_CRIS_DTP:                    howto manager.      (line 2354)
12957* BFD_RELOC_CRIS_DTPMOD:                 howto manager.      (line 2361)
12958* BFD_RELOC_CRIS_GLOB_DAT:               howto manager.      (line 2332)
12959* BFD_RELOC_CRIS_JUMP_SLOT:              howto manager.      (line 2333)
12960* BFD_RELOC_CRIS_LAPCQ_OFFSET:           howto manager.      (line 2327)
12961* BFD_RELOC_CRIS_RELATIVE:               howto manager.      (line 2334)
12962* BFD_RELOC_CRIS_SIGNED_16:              howto manager.      (line 2325)
12963* BFD_RELOC_CRIS_SIGNED_6:               howto manager.      (line 2321)
12964* BFD_RELOC_CRIS_SIGNED_8:               howto manager.      (line 2323)
12965* BFD_RELOC_CRIS_UNSIGNED_16:            howto manager.      (line 2326)
12966* BFD_RELOC_CRIS_UNSIGNED_4:             howto manager.      (line 2328)
12967* BFD_RELOC_CRIS_UNSIGNED_5:             howto manager.      (line 2320)
12968* BFD_RELOC_CRIS_UNSIGNED_6:             howto manager.      (line 2322)
12969* BFD_RELOC_CRIS_UNSIGNED_8:             howto manager.      (line 2324)
12970* BFD_RELOC_CRX_ABS16:                   howto manager.      (line 2308)
12971* BFD_RELOC_CRX_ABS32:                   howto manager.      (line 2309)
12972* BFD_RELOC_CRX_IMM16:                   howto manager.      (line 2313)
12973* BFD_RELOC_CRX_IMM32:                   howto manager.      (line 2314)
12974* BFD_RELOC_CRX_NUM16:                   howto manager.      (line 2311)
12975* BFD_RELOC_CRX_NUM32:                   howto manager.      (line 2312)
12976* BFD_RELOC_CRX_NUM8:                    howto manager.      (line 2310)
12977* BFD_RELOC_CRX_REGREL12:                howto manager.      (line 2304)
12978* BFD_RELOC_CRX_REGREL22:                howto manager.      (line 2305)
12979* BFD_RELOC_CRX_REGREL28:                howto manager.      (line 2306)
12980* BFD_RELOC_CRX_REGREL32:                howto manager.      (line 2307)
12981* BFD_RELOC_CRX_REL16:                   howto manager.      (line 2301)
12982* BFD_RELOC_CRX_REL24:                   howto manager.      (line 2302)
12983* BFD_RELOC_CRX_REL32:                   howto manager.      (line 2303)
12984* BFD_RELOC_CRX_REL4:                    howto manager.      (line 2298)
12985* BFD_RELOC_CRX_REL8:                    howto manager.      (line 2299)
12986* BFD_RELOC_CRX_REL8_CMP:                howto manager.      (line 2300)
12987* BFD_RELOC_CRX_SWITCH16:                howto manager.      (line 2316)
12988* BFD_RELOC_CRX_SWITCH32:                howto manager.      (line 2317)
12989* BFD_RELOC_CRX_SWITCH8:                 howto manager.      (line 2315)
12990* BFD_RELOC_CTOR:                        howto manager.      (line  759)
12991* BFD_RELOC_D10V_10_PCREL_L:             howto manager.      (line 1183)
12992* BFD_RELOC_D10V_10_PCREL_R:             howto manager.      (line 1180)
12993* BFD_RELOC_D10V_18:                     howto manager.      (line 1187)
12994* BFD_RELOC_D10V_18_PCREL:               howto manager.      (line 1189)
12995* BFD_RELOC_D30V_15:                     howto manager.      (line 1200)
12996* BFD_RELOC_D30V_15_PCREL:               howto manager.      (line 1203)
12997* BFD_RELOC_D30V_15_PCREL_R:             howto manager.      (line 1206)
12998* BFD_RELOC_D30V_21:                     howto manager.      (line 1210)
12999* BFD_RELOC_D30V_21_PCREL:               howto manager.      (line 1213)
13000* BFD_RELOC_D30V_21_PCREL_R:             howto manager.      (line 1216)
13001* BFD_RELOC_D30V_32:                     howto manager.      (line 1220)
13002* BFD_RELOC_D30V_32_PCREL:               howto manager.      (line 1222)
13003* BFD_RELOC_D30V_6:                      howto manager.      (line 1191)
13004* BFD_RELOC_D30V_9_PCREL:                howto manager.      (line 1193)
13005* BFD_RELOC_D30V_9_PCREL_R:              howto manager.      (line 1196)
13006* BFD_RELOC_DLX_HI16_S:                  howto manager.      (line 1224)
13007* BFD_RELOC_DLX_JMP26:                   howto manager.      (line 1228)
13008* BFD_RELOC_DLX_LO16:                    howto manager.      (line 1226)
13009* BFD_RELOC_EPIPHANY_HIGH:               howto manager.      (line 3340)
13010* BFD_RELOC_EPIPHANY_IMM11:              howto manager.      (line 3346)
13011* BFD_RELOC_EPIPHANY_IMM8:               howto manager.      (line 3349)
13012* BFD_RELOC_EPIPHANY_LOW:                howto manager.      (line 3342)
13013* BFD_RELOC_EPIPHANY_SIMM11:             howto manager.      (line 3344)
13014* BFD_RELOC_EPIPHANY_SIMM24:             howto manager.      (line 3338)
13015* BFD_RELOC_EPIPHANY_SIMM8:              howto manager.      (line 3336)
13016* BFD_RELOC_FR30_10_IN_8:                howto manager.      (line 1615)
13017* BFD_RELOC_FR30_12_PCREL:               howto manager.      (line 1621)
13018* BFD_RELOC_FR30_20:                     howto manager.      (line 1603)
13019* BFD_RELOC_FR30_48:                     howto manager.      (line 1601)
13020* BFD_RELOC_FR30_6_IN_4:                 howto manager.      (line 1606)
13021* BFD_RELOC_FR30_8_IN_8:                 howto manager.      (line 1609)
13022* BFD_RELOC_FR30_9_IN_8:                 howto manager.      (line 1612)
13023* BFD_RELOC_FR30_9_PCREL:                howto manager.      (line 1618)
13024* BFD_RELOC_FRV_FUNCDESC:                howto manager.      (line  451)
13025* BFD_RELOC_FRV_FUNCDESC_GOT12:          howto manager.      (line  452)
13026* BFD_RELOC_FRV_FUNCDESC_GOTHI:          howto manager.      (line  453)
13027* BFD_RELOC_FRV_FUNCDESC_GOTLO:          howto manager.      (line  454)
13028* BFD_RELOC_FRV_FUNCDESC_GOTOFF12:       howto manager.      (line  456)
13029* BFD_RELOC_FRV_FUNCDESC_GOTOFFHI:       howto manager.      (line  457)
13030* BFD_RELOC_FRV_FUNCDESC_GOTOFFLO:       howto manager.      (line  458)
13031* BFD_RELOC_FRV_FUNCDESC_VALUE:          howto manager.      (line  455)
13032* BFD_RELOC_FRV_GETTLSOFF:               howto manager.      (line  462)
13033* BFD_RELOC_FRV_GETTLSOFF_RELAX:         howto manager.      (line  475)
13034* BFD_RELOC_FRV_GOT12:                   howto manager.      (line  448)
13035* BFD_RELOC_FRV_GOTHI:                   howto manager.      (line  449)
13036* BFD_RELOC_FRV_GOTLO:                   howto manager.      (line  450)
13037* BFD_RELOC_FRV_GOTOFF12:                howto manager.      (line  459)
13038* BFD_RELOC_FRV_GOTOFFHI:                howto manager.      (line  460)
13039* BFD_RELOC_FRV_GOTOFFLO:                howto manager.      (line  461)
13040* BFD_RELOC_FRV_GOTTLSDESC12:            howto manager.      (line  464)
13041* BFD_RELOC_FRV_GOTTLSDESCHI:            howto manager.      (line  465)
13042* BFD_RELOC_FRV_GOTTLSDESCLO:            howto manager.      (line  466)
13043* BFD_RELOC_FRV_GOTTLSOFF12:             howto manager.      (line  470)
13044* BFD_RELOC_FRV_GOTTLSOFFHI:             howto manager.      (line  471)
13045* BFD_RELOC_FRV_GOTTLSOFFLO:             howto manager.      (line  472)
13046* BFD_RELOC_FRV_GPREL12:                 howto manager.      (line  443)
13047* BFD_RELOC_FRV_GPREL32:                 howto manager.      (line  445)
13048* BFD_RELOC_FRV_GPRELHI:                 howto manager.      (line  446)
13049* BFD_RELOC_FRV_GPRELLO:                 howto manager.      (line  447)
13050* BFD_RELOC_FRV_GPRELU12:                howto manager.      (line  444)
13051* BFD_RELOC_FRV_HI16:                    howto manager.      (line  442)
13052* BFD_RELOC_FRV_LABEL16:                 howto manager.      (line  439)
13053* BFD_RELOC_FRV_LABEL24:                 howto manager.      (line  440)
13054* BFD_RELOC_FRV_LO16:                    howto manager.      (line  441)
13055* BFD_RELOC_FRV_TLSDESC_RELAX:           howto manager.      (line  474)
13056* BFD_RELOC_FRV_TLSDESC_VALUE:           howto manager.      (line  463)
13057* BFD_RELOC_FRV_TLSMOFF:                 howto manager.      (line  477)
13058* BFD_RELOC_FRV_TLSMOFF12:               howto manager.      (line  467)
13059* BFD_RELOC_FRV_TLSMOFFHI:               howto manager.      (line  468)
13060* BFD_RELOC_FRV_TLSMOFFLO:               howto manager.      (line  469)
13061* BFD_RELOC_FRV_TLSOFF:                  howto manager.      (line  473)
13062* BFD_RELOC_FRV_TLSOFF_RELAX:            howto manager.      (line  476)
13063* BFD_RELOC_FT32_10:                     howto manager.      (line  429)
13064* BFD_RELOC_FT32_15:                     howto manager.      (line  436)
13065* BFD_RELOC_FT32_17:                     howto manager.      (line  431)
13066* BFD_RELOC_FT32_18:                     howto manager.      (line  432)
13067* BFD_RELOC_FT32_20:                     howto manager.      (line  430)
13068* BFD_RELOC_FT32_DIFF32:                 howto manager.      (line  437)
13069* BFD_RELOC_FT32_RELAX:                  howto manager.      (line  433)
13070* BFD_RELOC_FT32_SC0:                    howto manager.      (line  434)
13071* BFD_RELOC_FT32_SC1:                    howto manager.      (line  435)
13072* BFD_RELOC_GPREL16:                     howto manager.      (line  112)
13073* BFD_RELOC_GPREL32:                     howto manager.      (line  113)
13074* BFD_RELOC_H8_DIR16A8:                  howto manager.      (line 2404)
13075* BFD_RELOC_H8_DIR16R8:                  howto manager.      (line 2405)
13076* BFD_RELOC_H8_DIR24A8:                  howto manager.      (line 2406)
13077* BFD_RELOC_H8_DIR24R8:                  howto manager.      (line 2407)
13078* BFD_RELOC_H8_DIR32A16:                 howto manager.      (line 2408)
13079* BFD_RELOC_H8_DISP32A16:                howto manager.      (line 2409)
13080* BFD_RELOC_HI16:                        howto manager.      (line  312)
13081* BFD_RELOC_HI16_BASEREL:                howto manager.      (line   92)
13082* BFD_RELOC_HI16_GOTOFF:                 howto manager.      (line   51)
13083* BFD_RELOC_HI16_PCREL:                  howto manager.      (line  321)
13084* BFD_RELOC_HI16_PLTOFF:                 howto manager.      (line   63)
13085* BFD_RELOC_HI16_S:                      howto manager.      (line  314)
13086* BFD_RELOC_HI16_S_BASEREL:              howto manager.      (line   93)
13087* BFD_RELOC_HI16_S_GOTOFF:               howto manager.      (line   52)
13088* BFD_RELOC_HI16_S_PCREL:                howto manager.      (line  323)
13089* BFD_RELOC_HI16_S_PLTOFF:               howto manager.      (line   64)
13090* BFD_RELOC_HI22:                        howto manager.      (line  108)
13091* BFD_RELOC_I370_D12:                    howto manager.      (line  757)
13092* BFD_RELOC_IA64_COPY:                   howto manager.      (line 2162)
13093* BFD_RELOC_IA64_DIR32LSB:               howto manager.      (line 2107)
13094* BFD_RELOC_IA64_DIR32MSB:               howto manager.      (line 2106)
13095* BFD_RELOC_IA64_DIR64LSB:               howto manager.      (line 2109)
13096* BFD_RELOC_IA64_DIR64MSB:               howto manager.      (line 2108)
13097* BFD_RELOC_IA64_DTPMOD64LSB:            howto manager.      (line 2172)
13098* BFD_RELOC_IA64_DTPMOD64MSB:            howto manager.      (line 2171)
13099* BFD_RELOC_IA64_DTPREL14:               howto manager.      (line 2174)
13100* BFD_RELOC_IA64_DTPREL22:               howto manager.      (line 2175)
13101* BFD_RELOC_IA64_DTPREL32LSB:            howto manager.      (line 2178)
13102* BFD_RELOC_IA64_DTPREL32MSB:            howto manager.      (line 2177)
13103* BFD_RELOC_IA64_DTPREL64I:              howto manager.      (line 2176)
13104* BFD_RELOC_IA64_DTPREL64LSB:            howto manager.      (line 2180)
13105* BFD_RELOC_IA64_DTPREL64MSB:            howto manager.      (line 2179)
13106* BFD_RELOC_IA64_FPTR32LSB:              howto manager.      (line 2124)
13107* BFD_RELOC_IA64_FPTR32MSB:              howto manager.      (line 2123)
13108* BFD_RELOC_IA64_FPTR64I:                howto manager.      (line 2122)
13109* BFD_RELOC_IA64_FPTR64LSB:              howto manager.      (line 2126)
13110* BFD_RELOC_IA64_FPTR64MSB:              howto manager.      (line 2125)
13111* BFD_RELOC_IA64_GPREL22:                howto manager.      (line 2110)
13112* BFD_RELOC_IA64_GPREL32LSB:             howto manager.      (line 2113)
13113* BFD_RELOC_IA64_GPREL32MSB:             howto manager.      (line 2112)
13114* BFD_RELOC_IA64_GPREL64I:               howto manager.      (line 2111)
13115* BFD_RELOC_IA64_GPREL64LSB:             howto manager.      (line 2115)
13116* BFD_RELOC_IA64_GPREL64MSB:             howto manager.      (line 2114)
13117* BFD_RELOC_IA64_IMM14:                  howto manager.      (line 2103)
13118* BFD_RELOC_IA64_IMM22:                  howto manager.      (line 2104)
13119* BFD_RELOC_IA64_IMM64:                  howto manager.      (line 2105)
13120* BFD_RELOC_IA64_IPLTLSB:                howto manager.      (line 2161)
13121* BFD_RELOC_IA64_IPLTMSB:                howto manager.      (line 2160)
13122* BFD_RELOC_IA64_LDXMOV:                 howto manager.      (line 2164)
13123* BFD_RELOC_IA64_LTOFF22:                howto manager.      (line 2116)
13124* BFD_RELOC_IA64_LTOFF22X:               howto manager.      (line 2163)
13125* BFD_RELOC_IA64_LTOFF64I:               howto manager.      (line 2117)
13126* BFD_RELOC_IA64_LTOFF_DTPMOD22:         howto manager.      (line 2173)
13127* BFD_RELOC_IA64_LTOFF_DTPREL22:         howto manager.      (line 2181)
13128* BFD_RELOC_IA64_LTOFF_FPTR22:           howto manager.      (line 2138)
13129* BFD_RELOC_IA64_LTOFF_FPTR32LSB:        howto manager.      (line 2141)
13130* BFD_RELOC_IA64_LTOFF_FPTR32MSB:        howto manager.      (line 2140)
13131* BFD_RELOC_IA64_LTOFF_FPTR64I:          howto manager.      (line 2139)
13132* BFD_RELOC_IA64_LTOFF_FPTR64LSB:        howto manager.      (line 2143)
13133* BFD_RELOC_IA64_LTOFF_FPTR64MSB:        howto manager.      (line 2142)
13134* BFD_RELOC_IA64_LTOFF_TPREL22:          howto manager.      (line 2170)
13135* BFD_RELOC_IA64_LTV32LSB:               howto manager.      (line 2157)
13136* BFD_RELOC_IA64_LTV32MSB:               howto manager.      (line 2156)
13137* BFD_RELOC_IA64_LTV64LSB:               howto manager.      (line 2159)
13138* BFD_RELOC_IA64_LTV64MSB:               howto manager.      (line 2158)
13139* BFD_RELOC_IA64_PCREL21B:               howto manager.      (line 2127)
13140* BFD_RELOC_IA64_PCREL21BI:              howto manager.      (line 2128)
13141* BFD_RELOC_IA64_PCREL21F:               howto manager.      (line 2130)
13142* BFD_RELOC_IA64_PCREL21M:               howto manager.      (line 2129)
13143* BFD_RELOC_IA64_PCREL22:                howto manager.      (line 2131)
13144* BFD_RELOC_IA64_PCREL32LSB:             howto manager.      (line 2135)
13145* BFD_RELOC_IA64_PCREL32MSB:             howto manager.      (line 2134)
13146* BFD_RELOC_IA64_PCREL60B:               howto manager.      (line 2132)
13147* BFD_RELOC_IA64_PCREL64I:               howto manager.      (line 2133)
13148* BFD_RELOC_IA64_PCREL64LSB:             howto manager.      (line 2137)
13149* BFD_RELOC_IA64_PCREL64MSB:             howto manager.      (line 2136)
13150* BFD_RELOC_IA64_PLTOFF22:               howto manager.      (line 2118)
13151* BFD_RELOC_IA64_PLTOFF64I:              howto manager.      (line 2119)
13152* BFD_RELOC_IA64_PLTOFF64LSB:            howto manager.      (line 2121)
13153* BFD_RELOC_IA64_PLTOFF64MSB:            howto manager.      (line 2120)
13154* BFD_RELOC_IA64_REL32LSB:               howto manager.      (line 2153)
13155* BFD_RELOC_IA64_REL32MSB:               howto manager.      (line 2152)
13156* BFD_RELOC_IA64_REL64LSB:               howto manager.      (line 2155)
13157* BFD_RELOC_IA64_REL64MSB:               howto manager.      (line 2154)
13158* BFD_RELOC_IA64_SECREL32LSB:            howto manager.      (line 2149)
13159* BFD_RELOC_IA64_SECREL32MSB:            howto manager.      (line 2148)
13160* BFD_RELOC_IA64_SECREL64LSB:            howto manager.      (line 2151)
13161* BFD_RELOC_IA64_SECREL64MSB:            howto manager.      (line 2150)
13162* BFD_RELOC_IA64_SEGREL32LSB:            howto manager.      (line 2145)
13163* BFD_RELOC_IA64_SEGREL32MSB:            howto manager.      (line 2144)
13164* BFD_RELOC_IA64_SEGREL64LSB:            howto manager.      (line 2147)
13165* BFD_RELOC_IA64_SEGREL64MSB:            howto manager.      (line 2146)
13166* BFD_RELOC_IA64_TPREL14:                howto manager.      (line 2165)
13167* BFD_RELOC_IA64_TPREL22:                howto manager.      (line 2166)
13168* BFD_RELOC_IA64_TPREL64I:               howto manager.      (line 2167)
13169* BFD_RELOC_IA64_TPREL64LSB:             howto manager.      (line 2169)
13170* BFD_RELOC_IA64_TPREL64MSB:             howto manager.      (line 2168)
13171* BFD_RELOC_IP2K_ADDR16CJP:              howto manager.      (line 2064)
13172* BFD_RELOC_IP2K_BANK:                   howto manager.      (line 2062)
13173* BFD_RELOC_IP2K_EX8DATA:                howto manager.      (line 2070)
13174* BFD_RELOC_IP2K_FR9:                    howto manager.      (line 2060)
13175* BFD_RELOC_IP2K_FR_OFFSET:              howto manager.      (line 2079)
13176* BFD_RELOC_IP2K_HI8DATA:                howto manager.      (line 2069)
13177* BFD_RELOC_IP2K_HI8INSN:                howto manager.      (line 2073)
13178* BFD_RELOC_IP2K_LO8DATA:                howto manager.      (line 2068)
13179* BFD_RELOC_IP2K_LO8INSN:                howto manager.      (line 2072)
13180* BFD_RELOC_IP2K_PAGE3:                  howto manager.      (line 2066)
13181* BFD_RELOC_IP2K_PC_SKIP:                howto manager.      (line 2075)
13182* BFD_RELOC_IP2K_TEXT:                   howto manager.      (line 2077)
13183* BFD_RELOC_IQ2000_OFFSET_16:            howto manager.      (line 2545)
13184* BFD_RELOC_IQ2000_OFFSET_21:            howto manager.      (line 2546)
13185* BFD_RELOC_IQ2000_UHI16:                howto manager.      (line 2547)
13186* BFD_RELOC_LM32_16_GOT:                 howto manager.      (line 2668)
13187* BFD_RELOC_LM32_BRANCH:                 howto manager.      (line 2667)
13188* BFD_RELOC_LM32_CALL:                   howto manager.      (line 2666)
13189* BFD_RELOC_LM32_COPY:                   howto manager.      (line 2671)
13190* BFD_RELOC_LM32_GLOB_DAT:               howto manager.      (line 2672)
13191* BFD_RELOC_LM32_GOTOFF_HI16:            howto manager.      (line 2669)
13192* BFD_RELOC_LM32_GOTOFF_LO16:            howto manager.      (line 2670)
13193* BFD_RELOC_LM32_JMP_SLOT:               howto manager.      (line 2673)
13194* BFD_RELOC_LM32_RELATIVE:               howto manager.      (line 2674)
13195* BFD_RELOC_LO10:                        howto manager.      (line  109)
13196* BFD_RELOC_LO16:                        howto manager.      (line  319)
13197* BFD_RELOC_LO16_BASEREL:                howto manager.      (line   91)
13198* BFD_RELOC_LO16_GOTOFF:                 howto manager.      (line   50)
13199* BFD_RELOC_LO16_PCREL:                  howto manager.      (line  325)
13200* BFD_RELOC_LO16_PLTOFF:                 howto manager.      (line   62)
13201* BFD_RELOC_M32C_HI8:                    howto manager.      (line 1230)
13202* BFD_RELOC_M32C_RL_1ADDR:               howto manager.      (line 1232)
13203* BFD_RELOC_M32C_RL_2ADDR:               howto manager.      (line 1233)
13204* BFD_RELOC_M32C_RL_JUMP:                howto manager.      (line 1231)
13205* BFD_RELOC_M32R_10_PCREL:               howto manager.      (line 1238)
13206* BFD_RELOC_M32R_18_PCREL:               howto manager.      (line 1241)
13207* BFD_RELOC_M32R_24:                     howto manager.      (line 1235)
13208* BFD_RELOC_M32R_26_PCREL:               howto manager.      (line 1243)
13209* BFD_RELOC_M32R_26_PLTREL:              howto manager.      (line 1257)
13210* BFD_RELOC_M32R_COPY:                   howto manager.      (line 1258)
13211* BFD_RELOC_M32R_GLOB_DAT:               howto manager.      (line 1259)
13212* BFD_RELOC_M32R_GOT16_HI_SLO:           howto manager.      (line 1268)
13213* BFD_RELOC_M32R_GOT16_HI_ULO:           howto manager.      (line 1267)
13214* BFD_RELOC_M32R_GOT16_LO:               howto manager.      (line 1269)
13215* BFD_RELOC_M32R_GOT24:                  howto manager.      (line 1256)
13216* BFD_RELOC_M32R_GOTOFF:                 howto manager.      (line 1262)
13217* BFD_RELOC_M32R_GOTOFF_HI_SLO:          howto manager.      (line 1264)
13218* BFD_RELOC_M32R_GOTOFF_HI_ULO:          howto manager.      (line 1263)
13219* BFD_RELOC_M32R_GOTOFF_LO:              howto manager.      (line 1265)
13220* BFD_RELOC_M32R_GOTPC24:                howto manager.      (line 1266)
13221* BFD_RELOC_M32R_GOTPC_HI_SLO:           howto manager.      (line 1271)
13222* BFD_RELOC_M32R_GOTPC_HI_ULO:           howto manager.      (line 1270)
13223* BFD_RELOC_M32R_GOTPC_LO:               howto manager.      (line 1272)
13224* BFD_RELOC_M32R_HI16_SLO:               howto manager.      (line 1248)
13225* BFD_RELOC_M32R_HI16_ULO:               howto manager.      (line 1245)
13226* BFD_RELOC_M32R_JMP_SLOT:               howto manager.      (line 1260)
13227* BFD_RELOC_M32R_LO16:                   howto manager.      (line 1251)
13228* BFD_RELOC_M32R_RELATIVE:               howto manager.      (line 1261)
13229* BFD_RELOC_M32R_SDA16:                  howto manager.      (line 1253)
13230* BFD_RELOC_M68HC11_24:                  howto manager.      (line 2209)
13231* BFD_RELOC_M68HC11_3B:                  howto manager.      (line 2189)
13232* BFD_RELOC_M68HC11_HI8:                 howto manager.      (line 2183)
13233* BFD_RELOC_M68HC11_LO16:                howto manager.      (line 2200)
13234* BFD_RELOC_M68HC11_LO8:                 howto manager.      (line 2186)
13235* BFD_RELOC_M68HC11_PAGE:                howto manager.      (line 2205)
13236* BFD_RELOC_M68HC11_RL_GROUP:            howto manager.      (line 2196)
13237* BFD_RELOC_M68HC11_RL_JUMP:             howto manager.      (line 2191)
13238* BFD_RELOC_M68HC12_10_PCREL:            howto manager.      (line 2252)
13239* BFD_RELOC_M68HC12_16B:                 howto manager.      (line 2248)
13240* BFD_RELOC_M68HC12_5B:                  howto manager.      (line 2214)
13241* BFD_RELOC_M68HC12_9B:                  howto manager.      (line 2246)
13242* BFD_RELOC_M68HC12_9_PCREL:             howto manager.      (line 2250)
13243* BFD_RELOC_M68HC12_HI8XG:               howto manager.      (line 2257)
13244* BFD_RELOC_M68HC12_LO8XG:               howto manager.      (line 2254)
13245* BFD_RELOC_MACH_O_ARM64_ADDEND:         howto manager.      (line 2704)
13246* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21: howto manager.     (line 2706)
13247* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12: howto manager.  (line 2708)
13248* BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT: howto manager.      (line 2710)
13249* BFD_RELOC_MACH_O_LOCAL_SECTDIFF:       howto manager.      (line 2679)
13250* BFD_RELOC_MACH_O_PAIR:                 howto manager.      (line 2681)
13251* BFD_RELOC_MACH_O_SECTDIFF:             howto manager.      (line 2676)
13252* BFD_RELOC_MACH_O_SUBTRACTOR32:         howto manager.      (line 2683)
13253* BFD_RELOC_MACH_O_SUBTRACTOR64:         howto manager.      (line 2685)
13254* BFD_RELOC_MACH_O_X86_64_BRANCH32:      howto manager.      (line 2687)
13255* BFD_RELOC_MACH_O_X86_64_BRANCH8:       howto manager.      (line 2688)
13256* BFD_RELOC_MACH_O_X86_64_GOT:           howto manager.      (line 2691)
13257* BFD_RELOC_MACH_O_X86_64_GOT_LOAD:      howto manager.      (line 2693)
13258* BFD_RELOC_MACH_O_X86_64_PCREL32_1:     howto manager.      (line 2696)
13259* BFD_RELOC_MACH_O_X86_64_PCREL32_2:     howto manager.      (line 2698)
13260* BFD_RELOC_MACH_O_X86_64_PCREL32_4:     howto manager.      (line 2700)
13261* BFD_RELOC_MACH_O_X86_64_TLV:           howto manager.      (line 2702)
13262* BFD_RELOC_MCORE_PCREL_32:              howto manager.      (line 1627)
13263* BFD_RELOC_MCORE_PCREL_IMM11BY2:        howto manager.      (line 1625)
13264* BFD_RELOC_MCORE_PCREL_IMM4BY2:         howto manager.      (line 1626)
13265* BFD_RELOC_MCORE_PCREL_IMM8BY4:         howto manager.      (line 1624)
13266* BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2:    howto manager.      (line 1628)
13267* BFD_RELOC_MCORE_RVA:                   howto manager.      (line 1629)
13268* BFD_RELOC_MEP_16:                      howto manager.      (line 1632)
13269* BFD_RELOC_MEP_32:                      howto manager.      (line 1633)
13270* BFD_RELOC_MEP_8:                       howto manager.      (line 1631)
13271* BFD_RELOC_MEP_ADDR24A4:                howto manager.      (line 1648)
13272* BFD_RELOC_MEP_GNU_VTENTRY:             howto manager.      (line 1650)
13273* BFD_RELOC_MEP_GNU_VTINHERIT:           howto manager.      (line 1649)
13274* BFD_RELOC_MEP_GPREL:                   howto manager.      (line 1642)
13275* BFD_RELOC_MEP_HI16S:                   howto manager.      (line 1641)
13276* BFD_RELOC_MEP_HI16U:                   howto manager.      (line 1640)
13277* BFD_RELOC_MEP_LOW16:                   howto manager.      (line 1639)
13278* BFD_RELOC_MEP_PCABS24A2:               howto manager.      (line 1638)
13279* BFD_RELOC_MEP_PCREL12A2:               howto manager.      (line 1635)
13280* BFD_RELOC_MEP_PCREL17A2:               howto manager.      (line 1636)
13281* BFD_RELOC_MEP_PCREL24A2:               howto manager.      (line 1637)
13282* BFD_RELOC_MEP_PCREL8A2:                howto manager.      (line 1634)
13283* BFD_RELOC_MEP_TPREL:                   howto manager.      (line 1643)
13284* BFD_RELOC_MEP_TPREL7:                  howto manager.      (line 1644)
13285* BFD_RELOC_MEP_TPREL7A2:                howto manager.      (line 1645)
13286* BFD_RELOC_MEP_TPREL7A4:                howto manager.      (line 1646)
13287* BFD_RELOC_MEP_UIMM24:                  howto manager.      (line 1647)
13288* BFD_RELOC_METAG_COPY:                  howto manager.      (line 1671)
13289* BFD_RELOC_METAG_GETSETOFF:             howto manager.      (line 1655)
13290* BFD_RELOC_METAG_GETSET_GOT:            howto manager.      (line 1663)
13291* BFD_RELOC_METAG_GETSET_GOTOFF:         howto manager.      (line 1662)
13292* BFD_RELOC_METAG_GLOB_DAT:              howto manager.      (line 1674)
13293* BFD_RELOC_METAG_GOTOFF:                howto manager.      (line 1669)
13294* BFD_RELOC_METAG_HI16_GOTOFF:           howto manager.      (line 1660)
13295* BFD_RELOC_METAG_HI16_GOTPC:            howto manager.      (line 1664)
13296* BFD_RELOC_METAG_HI16_PLT:              howto manager.      (line 1666)
13297* BFD_RELOC_METAG_HIADDR16:              howto manager.      (line 1652)
13298* BFD_RELOC_METAG_HIOG:                  howto manager.      (line 1656)
13299* BFD_RELOC_METAG_JMP_SLOT:              howto manager.      (line 1672)
13300* BFD_RELOC_METAG_LO16_GOTOFF:           howto manager.      (line 1661)
13301* BFD_RELOC_METAG_LO16_GOTPC:            howto manager.      (line 1665)
13302* BFD_RELOC_METAG_LO16_PLT:              howto manager.      (line 1667)
13303* BFD_RELOC_METAG_LOADDR16:              howto manager.      (line 1653)
13304* BFD_RELOC_METAG_LOOG:                  howto manager.      (line 1657)
13305* BFD_RELOC_METAG_PLT:                   howto manager.      (line 1670)
13306* BFD_RELOC_METAG_REL16:                 howto manager.      (line 1659)
13307* BFD_RELOC_METAG_REL8:                  howto manager.      (line 1658)
13308* BFD_RELOC_METAG_RELATIVE:              howto manager.      (line 1673)
13309* BFD_RELOC_METAG_RELBRANCH:             howto manager.      (line 1654)
13310* BFD_RELOC_METAG_RELBRANCH_PLT:         howto manager.      (line 1668)
13311* BFD_RELOC_METAG_TLS_DTPMOD:            howto manager.      (line 1685)
13312* BFD_RELOC_METAG_TLS_DTPOFF:            howto manager.      (line 1686)
13313* BFD_RELOC_METAG_TLS_GD:                howto manager.      (line 1675)
13314* BFD_RELOC_METAG_TLS_IE:                howto manager.      (line 1680)
13315* BFD_RELOC_METAG_TLS_IENONPIC:          howto manager.      (line 1681)
13316* BFD_RELOC_METAG_TLS_IENONPIC_HI16:     howto manager.      (line 1682)
13317* BFD_RELOC_METAG_TLS_IENONPIC_LO16:     howto manager.      (line 1683)
13318* BFD_RELOC_METAG_TLS_LDM:               howto manager.      (line 1676)
13319* BFD_RELOC_METAG_TLS_LDO:               howto manager.      (line 1679)
13320* BFD_RELOC_METAG_TLS_LDO_HI16:          howto manager.      (line 1677)
13321* BFD_RELOC_METAG_TLS_LDO_LO16:          howto manager.      (line 1678)
13322* BFD_RELOC_METAG_TLS_LE:                howto manager.      (line 1687)
13323* BFD_RELOC_METAG_TLS_LE_HI16:           howto manager.      (line 1688)
13324* BFD_RELOC_METAG_TLS_LE_LO16:           howto manager.      (line 1689)
13325* BFD_RELOC_METAG_TLS_TPOFF:             howto manager.      (line 1684)
13326* BFD_RELOC_MICROBLAZE_32_GOTOFF:        howto manager.      (line 2746)
13327* BFD_RELOC_MICROBLAZE_32_LO:            howto manager.      (line 2712)
13328* BFD_RELOC_MICROBLAZE_32_LO_PCREL:      howto manager.      (line 2715)
13329* BFD_RELOC_MICROBLAZE_32_ROSDA:         howto manager.      (line 2718)
13330* BFD_RELOC_MICROBLAZE_32_RWSDA:         howto manager.      (line 2721)
13331* BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM:    howto manager.      (line 2724)
13332* BFD_RELOC_MICROBLAZE_32_TLSDTPMOD:     howto manager.      (line 2762)
13333* BFD_RELOC_MICROBLAZE_32_TLSDTPREL:     howto manager.      (line 2764)
13334* BFD_RELOC_MICROBLAZE_64_GOT:           howto manager.      (line 2735)
13335* BFD_RELOC_MICROBLAZE_64_GOTOFF:        howto manager.      (line 2742)
13336* BFD_RELOC_MICROBLAZE_64_GOTPC:         howto manager.      (line 2731)
13337* BFD_RELOC_MICROBLAZE_64_NONE:          howto manager.      (line 2727)
13338* BFD_RELOC_MICROBLAZE_64_PLT:           howto manager.      (line 2738)
13339* BFD_RELOC_MICROBLAZE_64_TEXTPCREL:     howto manager.      (line 2775)
13340* BFD_RELOC_MICROBLAZE_64_TEXTREL:       howto manager.      (line 2779)
13341* BFD_RELOC_MICROBLAZE_64_TLS:           howto manager.      (line 2752)
13342* BFD_RELOC_MICROBLAZE_64_TLSDTPREL:     howto manager.      (line 2766)
13343* BFD_RELOC_MICROBLAZE_64_TLSGD:         howto manager.      (line 2754)
13344* BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL:   howto manager.      (line 2769)
13345* BFD_RELOC_MICROBLAZE_64_TLSLD:         howto manager.      (line 2758)
13346* BFD_RELOC_MICROBLAZE_64_TLSTPREL:      howto manager.      (line 2772)
13347* BFD_RELOC_MICROBLAZE_COPY:             howto manager.      (line 2749)
13348* BFD_RELOC_MICROMIPS_10_PCREL_S1:       howto manager.      (line  352)
13349* BFD_RELOC_MICROMIPS_16_PCREL_S1:       howto manager.      (line  353)
13350* BFD_RELOC_MICROMIPS_7_PCREL_S1:        howto manager.      (line  351)
13351* BFD_RELOC_MICROMIPS_CALL16:            howto manager.      (line  370)
13352* BFD_RELOC_MICROMIPS_CALL_HI16:         howto manager.      (line  376)
13353* BFD_RELOC_MICROMIPS_CALL_LO16:         howto manager.      (line  378)
13354* BFD_RELOC_MICROMIPS_GOT16:             howto manager.      (line  368)
13355* BFD_RELOC_MICROMIPS_GOT_DISP:          howto manager.      (line  386)
13356* BFD_RELOC_MICROMIPS_GOT_HI16:          howto manager.      (line  372)
13357* BFD_RELOC_MICROMIPS_GOT_LO16:          howto manager.      (line  374)
13358* BFD_RELOC_MICROMIPS_GOT_OFST:          howto manager.      (line  384)
13359* BFD_RELOC_MICROMIPS_GOT_PAGE:          howto manager.      (line  382)
13360* BFD_RELOC_MICROMIPS_GPREL16:           howto manager.      (line  362)
13361* BFD_RELOC_MICROMIPS_HI16:              howto manager.      (line  363)
13362* BFD_RELOC_MICROMIPS_HI16_S:            howto manager.      (line  364)
13363* BFD_RELOC_MICROMIPS_HIGHER:            howto manager.      (line  395)
13364* BFD_RELOC_MICROMIPS_HIGHEST:           howto manager.      (line  393)
13365* BFD_RELOC_MICROMIPS_JALR:              howto manager.      (line  401)
13366* BFD_RELOC_MICROMIPS_JMP:               howto manager.      (line  306)
13367* BFD_RELOC_MICROMIPS_LITERAL:           howto manager.      (line  349)
13368* BFD_RELOC_MICROMIPS_LO16:              howto manager.      (line  365)
13369* BFD_RELOC_MICROMIPS_SCN_DISP:          howto manager.      (line  397)
13370* BFD_RELOC_MICROMIPS_SUB:               howto manager.      (line  380)
13371* BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16:   howto manager.      (line  411)
13372* BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16:   howto manager.      (line  413)
13373* BFD_RELOC_MICROMIPS_TLS_GD:            howto manager.      (line  407)
13374* BFD_RELOC_MICROMIPS_TLS_GOTTPREL:      howto manager.      (line  415)
13375* BFD_RELOC_MICROMIPS_TLS_LDM:           howto manager.      (line  409)
13376* BFD_RELOC_MICROMIPS_TLS_TPREL_HI16:    howto manager.      (line  419)
13377* BFD_RELOC_MICROMIPS_TLS_TPREL_LO16:    howto manager.      (line  421)
13378* BFD_RELOC_MIPS16_16_PCREL_S1:          howto manager.      (line  355)
13379* BFD_RELOC_MIPS16_CALL16:               howto manager.      (line  328)
13380* BFD_RELOC_MIPS16_GOT16:                howto manager.      (line  327)
13381* BFD_RELOC_MIPS16_GPREL:                howto manager.      (line  310)
13382* BFD_RELOC_MIPS16_HI16:                 howto manager.      (line  331)
13383* BFD_RELOC_MIPS16_HI16_S:               howto manager.      (line  333)
13384* BFD_RELOC_MIPS16_JMP:                  howto manager.      (line  308)
13385* BFD_RELOC_MIPS16_LO16:                 howto manager.      (line  338)
13386* BFD_RELOC_MIPS16_TLS_DTPREL_HI16:      howto manager.      (line  342)
13387* BFD_RELOC_MIPS16_TLS_DTPREL_LO16:      howto manager.      (line  343)
13388* BFD_RELOC_MIPS16_TLS_GD:               howto manager.      (line  340)
13389* BFD_RELOC_MIPS16_TLS_GOTTPREL:         howto manager.      (line  344)
13390* BFD_RELOC_MIPS16_TLS_LDM:              howto manager.      (line  341)
13391* BFD_RELOC_MIPS16_TLS_TPREL_HI16:       howto manager.      (line  345)
13392* BFD_RELOC_MIPS16_TLS_TPREL_LO16:       howto manager.      (line  346)
13393* BFD_RELOC_MIPS_18_PCREL_S3:            howto manager.      (line  359)
13394* BFD_RELOC_MIPS_19_PCREL_S2:            howto manager.      (line  360)
13395* BFD_RELOC_MIPS_21_PCREL_S2:            howto manager.      (line  357)
13396* BFD_RELOC_MIPS_26_PCREL_S2:            howto manager.      (line  358)
13397* BFD_RELOC_MIPS_CALL16:                 howto manager.      (line  369)
13398* BFD_RELOC_MIPS_CALL_HI16:              howto manager.      (line  375)
13399* BFD_RELOC_MIPS_CALL_LO16:              howto manager.      (line  377)
13400* BFD_RELOC_MIPS_COPY:                   howto manager.      (line  424)
13401* BFD_RELOC_MIPS_DELETE:                 howto manager.      (line  391)
13402* BFD_RELOC_MIPS_EH:                     howto manager.      (line  422)
13403* BFD_RELOC_MIPS_GOT16:                  howto manager.      (line  367)
13404* BFD_RELOC_MIPS_GOT_DISP:               howto manager.      (line  385)
13405* BFD_RELOC_MIPS_GOT_HI16:               howto manager.      (line  371)
13406* BFD_RELOC_MIPS_GOT_LO16:               howto manager.      (line  373)
13407* BFD_RELOC_MIPS_GOT_OFST:               howto manager.      (line  383)
13408* BFD_RELOC_MIPS_GOT_PAGE:               howto manager.      (line  381)
13409* BFD_RELOC_MIPS_HIGHER:                 howto manager.      (line  394)
13410* BFD_RELOC_MIPS_HIGHEST:                howto manager.      (line  392)
13411* BFD_RELOC_MIPS_INSERT_A:               howto manager.      (line  389)
13412* BFD_RELOC_MIPS_INSERT_B:               howto manager.      (line  390)
13413* BFD_RELOC_MIPS_JALR:                   howto manager.      (line  400)
13414* BFD_RELOC_MIPS_JMP:                    howto manager.      (line  305)
13415* BFD_RELOC_MIPS_JUMP_SLOT:              howto manager.      (line  425)
13416* BFD_RELOC_MIPS_LITERAL:                howto manager.      (line  348)
13417* BFD_RELOC_MIPS_REL16:                  howto manager.      (line  398)
13418* BFD_RELOC_MIPS_RELGOT:                 howto manager.      (line  399)
13419* BFD_RELOC_MIPS_SCN_DISP:               howto manager.      (line  396)
13420* BFD_RELOC_MIPS_SHIFT5:                 howto manager.      (line  387)
13421* BFD_RELOC_MIPS_SHIFT6:                 howto manager.      (line  388)
13422* BFD_RELOC_MIPS_SUB:                    howto manager.      (line  379)
13423* BFD_RELOC_MIPS_TLS_DTPMOD32:           howto manager.      (line  402)
13424* BFD_RELOC_MIPS_TLS_DTPMOD64:           howto manager.      (line  404)
13425* BFD_RELOC_MIPS_TLS_DTPREL32:           howto manager.      (line  403)
13426* BFD_RELOC_MIPS_TLS_DTPREL64:           howto manager.      (line  405)
13427* BFD_RELOC_MIPS_TLS_DTPREL_HI16:        howto manager.      (line  410)
13428* BFD_RELOC_MIPS_TLS_DTPREL_LO16:        howto manager.      (line  412)
13429* BFD_RELOC_MIPS_TLS_GD:                 howto manager.      (line  406)
13430* BFD_RELOC_MIPS_TLS_GOTTPREL:           howto manager.      (line  414)
13431* BFD_RELOC_MIPS_TLS_LDM:                howto manager.      (line  408)
13432* BFD_RELOC_MIPS_TLS_TPREL32:            howto manager.      (line  416)
13433* BFD_RELOC_MIPS_TLS_TPREL64:            howto manager.      (line  417)
13434* BFD_RELOC_MIPS_TLS_TPREL_HI16:         howto manager.      (line  418)
13435* BFD_RELOC_MIPS_TLS_TPREL_LO16:         howto manager.      (line  420)
13436* BFD_RELOC_MMIX_ADDR19:                 howto manager.      (line 1713)
13437* BFD_RELOC_MMIX_ADDR27:                 howto manager.      (line 1716)
13438* BFD_RELOC_MMIX_BASE_PLUS_OFFSET:       howto manager.      (line 1725)
13439* BFD_RELOC_MMIX_CBRANCH:                howto manager.      (line 1696)
13440* BFD_RELOC_MMIX_CBRANCH_1:              howto manager.      (line 1698)
13441* BFD_RELOC_MMIX_CBRANCH_2:              howto manager.      (line 1699)
13442* BFD_RELOC_MMIX_CBRANCH_3:              howto manager.      (line 1700)
13443* BFD_RELOC_MMIX_CBRANCH_J:              howto manager.      (line 1697)
13444* BFD_RELOC_MMIX_GETA:                   howto manager.      (line 1691)
13445* BFD_RELOC_MMIX_GETA_1:                 howto manager.      (line 1692)
13446* BFD_RELOC_MMIX_GETA_2:                 howto manager.      (line 1693)
13447* BFD_RELOC_MMIX_GETA_3:                 howto manager.      (line 1694)
13448* BFD_RELOC_MMIX_JMP:                    howto manager.      (line 1708)
13449* BFD_RELOC_MMIX_JMP_1:                  howto manager.      (line 1709)
13450* BFD_RELOC_MMIX_JMP_2:                  howto manager.      (line 1710)
13451* BFD_RELOC_MMIX_JMP_3:                  howto manager.      (line 1711)
13452* BFD_RELOC_MMIX_LOCAL:                  howto manager.      (line 1728)
13453* BFD_RELOC_MMIX_PUSHJ:                  howto manager.      (line 1702)
13454* BFD_RELOC_MMIX_PUSHJ_1:                howto manager.      (line 1703)
13455* BFD_RELOC_MMIX_PUSHJ_2:                howto manager.      (line 1704)
13456* BFD_RELOC_MMIX_PUSHJ_3:                howto manager.      (line 1705)
13457* BFD_RELOC_MMIX_PUSHJ_STUBBABLE:        howto manager.      (line 1706)
13458* BFD_RELOC_MMIX_REG:                    howto manager.      (line 1722)
13459* BFD_RELOC_MMIX_REG_OR_BYTE:            howto manager.      (line 1719)
13460* BFD_RELOC_MN10300_16_PCREL:            howto manager.      (line  518)
13461* BFD_RELOC_MN10300_32_PCREL:            howto manager.      (line  515)
13462* BFD_RELOC_MN10300_ALIGN:               howto manager.      (line  502)
13463* BFD_RELOC_MN10300_COPY:                howto manager.      (line  490)
13464* BFD_RELOC_MN10300_GLOB_DAT:            howto manager.      (line  492)
13465* BFD_RELOC_MN10300_GOT16:               howto manager.      (line  487)
13466* BFD_RELOC_MN10300_GOT24:               howto manager.      (line  484)
13467* BFD_RELOC_MN10300_GOT32:               howto manager.      (line  481)
13468* BFD_RELOC_MN10300_GOTOFF24:            howto manager.      (line  479)
13469* BFD_RELOC_MN10300_JMP_SLOT:            howto manager.      (line  494)
13470* BFD_RELOC_MN10300_RELATIVE:            howto manager.      (line  496)
13471* BFD_RELOC_MN10300_SYM_DIFF:            howto manager.      (line  498)
13472* BFD_RELOC_MN10300_TLS_DTPMOD:          howto manager.      (line  511)
13473* BFD_RELOC_MN10300_TLS_DTPOFF:          howto manager.      (line  512)
13474* BFD_RELOC_MN10300_TLS_GD:              howto manager.      (line  505)
13475* BFD_RELOC_MN10300_TLS_GOTIE:           howto manager.      (line  508)
13476* BFD_RELOC_MN10300_TLS_IE:              howto manager.      (line  509)
13477* BFD_RELOC_MN10300_TLS_LD:              howto manager.      (line  506)
13478* BFD_RELOC_MN10300_TLS_LDO:             howto manager.      (line  507)
13479* BFD_RELOC_MN10300_TLS_LE:              howto manager.      (line  510)
13480* BFD_RELOC_MN10300_TLS_TPOFF:           howto manager.      (line  513)
13481* BFD_RELOC_MOXIE_10_PCREL:              howto manager.      (line  427)
13482* BFD_RELOC_MSP430X_ABS16:               howto manager.      (line 2457)
13483* BFD_RELOC_MSP430X_ABS20_ADR_DST:       howto manager.      (line 2454)
13484* BFD_RELOC_MSP430X_ABS20_ADR_SRC:       howto manager.      (line 2453)
13485* BFD_RELOC_MSP430X_ABS20_EXT_DST:       howto manager.      (line 2451)
13486* BFD_RELOC_MSP430X_ABS20_EXT_ODST:      howto manager.      (line 2452)
13487* BFD_RELOC_MSP430X_ABS20_EXT_SRC:       howto manager.      (line 2450)
13488* BFD_RELOC_MSP430X_PCR16:               howto manager.      (line 2455)
13489* BFD_RELOC_MSP430X_PCR20_CALL:          howto manager.      (line 2456)
13490* BFD_RELOC_MSP430X_PCR20_EXT_DST:       howto manager.      (line 2448)
13491* BFD_RELOC_MSP430X_PCR20_EXT_ODST:      howto manager.      (line 2449)
13492* BFD_RELOC_MSP430X_PCR20_EXT_SRC:       howto manager.      (line 2447)
13493* BFD_RELOC_MSP430_10_PCREL:             howto manager.      (line 2439)
13494* BFD_RELOC_MSP430_16:                   howto manager.      (line 2441)
13495* BFD_RELOC_MSP430_16_BYTE:              howto manager.      (line 2443)
13496* BFD_RELOC_MSP430_16_PCREL:             howto manager.      (line 2440)
13497* BFD_RELOC_MSP430_16_PCREL_BYTE:        howto manager.      (line 2442)
13498* BFD_RELOC_MSP430_2X_PCREL:             howto manager.      (line 2444)
13499* BFD_RELOC_MSP430_ABS8:                 howto manager.      (line 2446)
13500* BFD_RELOC_MSP430_ABS_HI16:             howto manager.      (line 2458)
13501* BFD_RELOC_MSP430_PREL31:               howto manager.      (line 2459)
13502* BFD_RELOC_MSP430_RL_PCREL:             howto manager.      (line 2445)
13503* BFD_RELOC_MSP430_SET_ULEB128:          howto manager.      (line 2461)
13504* BFD_RELOC_MSP430_SUB_ULEB128:          howto manager.      (line 2462)
13505* BFD_RELOC_MSP430_SYM_DIFF:             howto manager.      (line 2460)
13506* BFD_RELOC_MT_GNU_VTENTRY:              howto manager.      (line 2435)
13507* BFD_RELOC_MT_GNU_VTINHERIT:            howto manager.      (line 2433)
13508* BFD_RELOC_MT_HI16:                     howto manager.      (line 2429)
13509* BFD_RELOC_MT_LO16:                     howto manager.      (line 2431)
13510* BFD_RELOC_MT_PC16:                     howto manager.      (line 2427)
13511* BFD_RELOC_MT_PCINSN8:                  howto manager.      (line 2437)
13512* BFD_RELOC_NDS32_10IFCU_PCREL:          howto manager.      (line 1424)
13513* BFD_RELOC_NDS32_10_UPCREL:             howto manager.      (line 1395)
13514* BFD_RELOC_NDS32_15_FIXED:              howto manager.      (line 1356)
13515* BFD_RELOC_NDS32_15_PCREL:              howto manager.      (line 1282)
13516* BFD_RELOC_NDS32_17IFC_PCREL:           howto manager.      (line 1423)
13517* BFD_RELOC_NDS32_17_FIXED:              howto manager.      (line 1357)
13518* BFD_RELOC_NDS32_17_PCREL:              howto manager.      (line 1284)
13519* BFD_RELOC_NDS32_20:                    howto manager.      (line 1274)
13520* BFD_RELOC_NDS32_25_ABS:                howto manager.      (line 1419)
13521* BFD_RELOC_NDS32_25_FIXED:              howto manager.      (line 1358)
13522* BFD_RELOC_NDS32_25_PCREL:              howto manager.      (line 1286)
13523* BFD_RELOC_NDS32_25_PLTREL:             howto manager.      (line 1332)
13524* BFD_RELOC_NDS32_5:                     howto manager.      (line 1393)
13525* BFD_RELOC_NDS32_9_FIXED:               howto manager.      (line 1355)
13526* BFD_RELOC_NDS32_9_PCREL:               howto manager.      (line 1276)
13527* BFD_RELOC_NDS32_9_PLTREL:              howto manager.      (line 1331)
13528* BFD_RELOC_NDS32_COPY:                  howto manager.      (line 1333)
13529* BFD_RELOC_NDS32_DATA:                  howto manager.      (line 1421)
13530* BFD_RELOC_NDS32_DIFF16:                howto manager.      (line 1414)
13531* BFD_RELOC_NDS32_DIFF32:                howto manager.      (line 1415)
13532* BFD_RELOC_NDS32_DIFF8:                 howto manager.      (line 1413)
13533* BFD_RELOC_NDS32_DIFF_ULEB128:          howto manager.      (line 1416)
13534* BFD_RELOC_NDS32_DWARF2_LEB:            howto manager.      (line 1379)
13535* BFD_RELOC_NDS32_DWARF2_OP1:            howto manager.      (line 1377)
13536* BFD_RELOC_NDS32_DWARF2_OP2:            howto manager.      (line 1378)
13537* BFD_RELOC_NDS32_EMPTY:                 howto manager.      (line 1417)
13538* BFD_RELOC_NDS32_GLOB_DAT:              howto manager.      (line 1334)
13539* BFD_RELOC_NDS32_GOT15S2:               howto manager.      (line 1390)
13540* BFD_RELOC_NDS32_GOT17S2:               howto manager.      (line 1391)
13541* BFD_RELOC_NDS32_GOT20:                 howto manager.      (line 1330)
13542* BFD_RELOC_NDS32_GOTOFF:                howto manager.      (line 1337)
13543* BFD_RELOC_NDS32_GOTOFF_HI20:           howto manager.      (line 1338)
13544* BFD_RELOC_NDS32_GOTOFF_LO12:           howto manager.      (line 1339)
13545* BFD_RELOC_NDS32_GOTOFF_LO15:           howto manager.      (line 1388)
13546* BFD_RELOC_NDS32_GOTOFF_LO19:           howto manager.      (line 1389)
13547* BFD_RELOC_NDS32_GOTOFF_SUFF:           howto manager.      (line 1402)
13548* BFD_RELOC_NDS32_GOTPC20:               howto manager.      (line 1340)
13549* BFD_RELOC_NDS32_GOTPC_HI20:            howto manager.      (line 1343)
13550* BFD_RELOC_NDS32_GOTPC_LO12:            howto manager.      (line 1344)
13551* BFD_RELOC_NDS32_GOTTPOFF:              howto manager.      (line 1427)
13552* BFD_RELOC_NDS32_GOT_HI20:              howto manager.      (line 1341)
13553* BFD_RELOC_NDS32_GOT_LO12:              howto manager.      (line 1342)
13554* BFD_RELOC_NDS32_GOT_LO15:              howto manager.      (line 1386)
13555* BFD_RELOC_NDS32_GOT_LO19:              howto manager.      (line 1387)
13556* BFD_RELOC_NDS32_GOT_SUFF:              howto manager.      (line 1401)
13557* BFD_RELOC_NDS32_GROUP:                 howto manager.      (line 1453)
13558* BFD_RELOC_NDS32_HI20:                  howto manager.      (line 1288)
13559* BFD_RELOC_NDS32_INSN16:                howto manager.      (line 1346)
13560* BFD_RELOC_NDS32_JMP_SLOT:              howto manager.      (line 1335)
13561* BFD_RELOC_NDS32_LABEL:                 howto manager.      (line 1347)
13562* BFD_RELOC_NDS32_LO12S0:                howto manager.      (line 1300)
13563* BFD_RELOC_NDS32_LO12S0_ORI:            howto manager.      (line 1303)
13564* BFD_RELOC_NDS32_LO12S1:                howto manager.      (line 1297)
13565* BFD_RELOC_NDS32_LO12S2:                howto manager.      (line 1294)
13566* BFD_RELOC_NDS32_LO12S2_DP:             howto manager.      (line 1374)
13567* BFD_RELOC_NDS32_LO12S2_SP:             howto manager.      (line 1375)
13568* BFD_RELOC_NDS32_LO12S3:                howto manager.      (line 1291)
13569* BFD_RELOC_NDS32_LOADSTORE:             howto manager.      (line 1354)
13570* BFD_RELOC_NDS32_LONGCALL1:             howto manager.      (line 1348)
13571* BFD_RELOC_NDS32_LONGCALL2:             howto manager.      (line 1349)
13572* BFD_RELOC_NDS32_LONGCALL3:             howto manager.      (line 1350)
13573* BFD_RELOC_NDS32_LONGCALL4:             howto manager.      (line 1359)
13574* BFD_RELOC_NDS32_LONGCALL5:             howto manager.      (line 1360)
13575* BFD_RELOC_NDS32_LONGCALL6:             howto manager.      (line 1361)
13576* BFD_RELOC_NDS32_LONGJUMP1:             howto manager.      (line 1351)
13577* BFD_RELOC_NDS32_LONGJUMP2:             howto manager.      (line 1352)
13578* BFD_RELOC_NDS32_LONGJUMP3:             howto manager.      (line 1353)
13579* BFD_RELOC_NDS32_LONGJUMP4:             howto manager.      (line 1362)
13580* BFD_RELOC_NDS32_LONGJUMP5:             howto manager.      (line 1363)
13581* BFD_RELOC_NDS32_LONGJUMP6:             howto manager.      (line 1364)
13582* BFD_RELOC_NDS32_LONGJUMP7:             howto manager.      (line 1365)
13583* BFD_RELOC_NDS32_LSI:                   howto manager.      (line 1455)
13584* BFD_RELOC_NDS32_MINUEND:               howto manager.      (line 1411)
13585* BFD_RELOC_NDS32_MULCALL_SUFF:          howto manager.      (line 1404)
13586* BFD_RELOC_NDS32_PLTBLOCK:              howto manager.      (line 1408)
13587* BFD_RELOC_NDS32_PLTREL_HI20:           howto manager.      (line 1367)
13588* BFD_RELOC_NDS32_PLTREL_LO12:           howto manager.      (line 1368)
13589* BFD_RELOC_NDS32_PLT_GOTREL_HI20:       howto manager.      (line 1369)
13590* BFD_RELOC_NDS32_PLT_GOTREL_LO12:       howto manager.      (line 1370)
13591* BFD_RELOC_NDS32_PLT_GOTREL_LO15:       howto manager.      (line 1384)
13592* BFD_RELOC_NDS32_PLT_GOTREL_LO19:       howto manager.      (line 1385)
13593* BFD_RELOC_NDS32_PLT_GOTREL_LO20:       howto manager.      (line 1383)
13594* BFD_RELOC_NDS32_PLT_GOT_SUFF:          howto manager.      (line 1403)
13595* BFD_RELOC_NDS32_PTR:                   howto manager.      (line 1405)
13596* BFD_RELOC_NDS32_PTR_COUNT:             howto manager.      (line 1406)
13597* BFD_RELOC_NDS32_PTR_RESOLVED:          howto manager.      (line 1407)
13598* BFD_RELOC_NDS32_RELATIVE:              howto manager.      (line 1336)
13599* BFD_RELOC_NDS32_RELAX_ENTRY:           howto manager.      (line 1400)
13600* BFD_RELOC_NDS32_RELAX_REGION_BEGIN:    howto manager.      (line 1409)
13601* BFD_RELOC_NDS32_RELAX_REGION_END:      howto manager.      (line 1410)
13602* BFD_RELOC_NDS32_REMOVE:                howto manager.      (line 1452)
13603* BFD_RELOC_NDS32_SDA12S2_DP:            howto manager.      (line 1372)
13604* BFD_RELOC_NDS32_SDA12S2_SP:            howto manager.      (line 1373)
13605* BFD_RELOC_NDS32_SDA15S0:               howto manager.      (line 1315)
13606* BFD_RELOC_NDS32_SDA15S1:               howto manager.      (line 1312)
13607* BFD_RELOC_NDS32_SDA15S2:               howto manager.      (line 1309)
13608* BFD_RELOC_NDS32_SDA15S3:               howto manager.      (line 1306)
13609* BFD_RELOC_NDS32_SDA16S3:               howto manager.      (line 1318)
13610* BFD_RELOC_NDS32_SDA17S2:               howto manager.      (line 1321)
13611* BFD_RELOC_NDS32_SDA18S1:               howto manager.      (line 1324)
13612* BFD_RELOC_NDS32_SDA19S0:               howto manager.      (line 1327)
13613* BFD_RELOC_NDS32_SDA_FP7U2_RELA:        howto manager.      (line 1398)
13614* BFD_RELOC_NDS32_SUBTRAHEND:            howto manager.      (line 1412)
13615* BFD_RELOC_NDS32_TLS_DESC:              howto manager.      (line 1443)
13616* BFD_RELOC_NDS32_TLS_DESC_20:           howto manager.      (line 1446)
13617* BFD_RELOC_NDS32_TLS_DESC_ADD:          howto manager.      (line 1448)
13618* BFD_RELOC_NDS32_TLS_DESC_CALL:         howto manager.      (line 1450)
13619* BFD_RELOC_NDS32_TLS_DESC_FUNC:         howto manager.      (line 1449)
13620* BFD_RELOC_NDS32_TLS_DESC_HI20:         howto manager.      (line 1444)
13621* BFD_RELOC_NDS32_TLS_DESC_LO12:         howto manager.      (line 1445)
13622* BFD_RELOC_NDS32_TLS_DESC_MEM:          howto manager.      (line 1451)
13623* BFD_RELOC_NDS32_TLS_DESC_SDA17S2:      howto manager.      (line 1447)
13624* BFD_RELOC_NDS32_TLS_IEGP_HI20:         howto manager.      (line 1439)
13625* BFD_RELOC_NDS32_TLS_IEGP_LO12:         howto manager.      (line 1440)
13626* BFD_RELOC_NDS32_TLS_IEGP_LO12S2:       howto manager.      (line 1441)
13627* BFD_RELOC_NDS32_TLS_IEGP_LW:           howto manager.      (line 1442)
13628* BFD_RELOC_NDS32_TLS_IE_HI20:           howto manager.      (line 1436)
13629* BFD_RELOC_NDS32_TLS_IE_LO12:           howto manager.      (line 1437)
13630* BFD_RELOC_NDS32_TLS_IE_LO12S2:         howto manager.      (line 1438)
13631* BFD_RELOC_NDS32_TLS_LE_15S0:           howto manager.      (line 1431)
13632* BFD_RELOC_NDS32_TLS_LE_15S1:           howto manager.      (line 1432)
13633* BFD_RELOC_NDS32_TLS_LE_15S2:           howto manager.      (line 1433)
13634* BFD_RELOC_NDS32_TLS_LE_20:             howto manager.      (line 1430)
13635* BFD_RELOC_NDS32_TLS_LE_ADD:            howto manager.      (line 1434)
13636* BFD_RELOC_NDS32_TLS_LE_HI20:           howto manager.      (line 1428)
13637* BFD_RELOC_NDS32_TLS_LE_LO12:           howto manager.      (line 1429)
13638* BFD_RELOC_NDS32_TLS_LE_LS:             howto manager.      (line 1435)
13639* BFD_RELOC_NDS32_TPOFF:                 howto manager.      (line 1426)
13640* BFD_RELOC_NDS32_TRAN:                  howto manager.      (line 1422)
13641* BFD_RELOC_NDS32_UPDATE_TA:             howto manager.      (line 1381)
13642* BFD_RELOC_NDS32_WORD_9_PCREL:          howto manager.      (line 1279)
13643* BFD_RELOC_NIOS2_ALIGN:                 howto manager.      (line 2478)
13644* BFD_RELOC_NIOS2_CACHE_OPX:             howto manager.      (line 2468)
13645* BFD_RELOC_NIOS2_CALL16:                howto manager.      (line 2480)
13646* BFD_RELOC_NIOS2_CALL26:                howto manager.      (line 2466)
13647* BFD_RELOC_NIOS2_CALL26_NOAT:           howto manager.      (line 2498)
13648* BFD_RELOC_NIOS2_CALLR:                 howto manager.      (line 2477)
13649* BFD_RELOC_NIOS2_CALL_HA:               howto manager.      (line 2502)
13650* BFD_RELOC_NIOS2_CALL_LO:               howto manager.      (line 2501)
13651* BFD_RELOC_NIOS2_CJMP:                  howto manager.      (line 2476)
13652* BFD_RELOC_NIOS2_COPY:                  howto manager.      (line 2493)
13653* BFD_RELOC_NIOS2_GLOB_DAT:              howto manager.      (line 2494)
13654* BFD_RELOC_NIOS2_GOT16:                 howto manager.      (line 2479)
13655* BFD_RELOC_NIOS2_GOTOFF:                howto manager.      (line 2497)
13656* BFD_RELOC_NIOS2_GOTOFF_HA:             howto manager.      (line 2482)
13657* BFD_RELOC_NIOS2_GOTOFF_LO:             howto manager.      (line 2481)
13658* BFD_RELOC_NIOS2_GOT_HA:                howto manager.      (line 2500)
13659* BFD_RELOC_NIOS2_GOT_LO:                howto manager.      (line 2499)
13660* BFD_RELOC_NIOS2_GPREL:                 howto manager.      (line 2474)
13661* BFD_RELOC_NIOS2_HI16:                  howto manager.      (line 2471)
13662* BFD_RELOC_NIOS2_HIADJ16:               howto manager.      (line 2473)
13663* BFD_RELOC_NIOS2_IMM5:                  howto manager.      (line 2467)
13664* BFD_RELOC_NIOS2_IMM6:                  howto manager.      (line 2469)
13665* BFD_RELOC_NIOS2_IMM8:                  howto manager.      (line 2470)
13666* BFD_RELOC_NIOS2_JUMP_SLOT:             howto manager.      (line 2495)
13667* BFD_RELOC_NIOS2_LO16:                  howto manager.      (line 2472)
13668* BFD_RELOC_NIOS2_PCREL_HA:              howto manager.      (line 2484)
13669* BFD_RELOC_NIOS2_PCREL_LO:              howto manager.      (line 2483)
13670* BFD_RELOC_NIOS2_R2_F1I5_2:             howto manager.      (line 2512)
13671* BFD_RELOC_NIOS2_R2_I10_1_PCREL:        howto manager.      (line 2504)
13672* BFD_RELOC_NIOS2_R2_L5I4X1:             howto manager.      (line 2513)
13673* BFD_RELOC_NIOS2_R2_S12:                howto manager.      (line 2503)
13674* BFD_RELOC_NIOS2_R2_T1I7_1_PCREL:       howto manager.      (line 2505)
13675* BFD_RELOC_NIOS2_R2_T1I7_2:             howto manager.      (line 2506)
13676* BFD_RELOC_NIOS2_R2_T1X1I6:             howto manager.      (line 2514)
13677* BFD_RELOC_NIOS2_R2_T1X1I6_2:           howto manager.      (line 2515)
13678* BFD_RELOC_NIOS2_R2_T2I4:               howto manager.      (line 2507)
13679* BFD_RELOC_NIOS2_R2_T2I4_1:             howto manager.      (line 2508)
13680* BFD_RELOC_NIOS2_R2_T2I4_2:             howto manager.      (line 2509)
13681* BFD_RELOC_NIOS2_R2_X1I7_2:             howto manager.      (line 2510)
13682* BFD_RELOC_NIOS2_R2_X2L5:               howto manager.      (line 2511)
13683* BFD_RELOC_NIOS2_RELATIVE:              howto manager.      (line 2496)
13684* BFD_RELOC_NIOS2_S16:                   howto manager.      (line 2464)
13685* BFD_RELOC_NIOS2_TLS_DTPMOD:            howto manager.      (line 2490)
13686* BFD_RELOC_NIOS2_TLS_DTPREL:            howto manager.      (line 2491)
13687* BFD_RELOC_NIOS2_TLS_GD16:              howto manager.      (line 2485)
13688* BFD_RELOC_NIOS2_TLS_IE16:              howto manager.      (line 2488)
13689* BFD_RELOC_NIOS2_TLS_LDM16:             howto manager.      (line 2486)
13690* BFD_RELOC_NIOS2_TLS_LDO16:             howto manager.      (line 2487)
13691* BFD_RELOC_NIOS2_TLS_LE16:              howto manager.      (line 2489)
13692* BFD_RELOC_NIOS2_TLS_TPREL:             howto manager.      (line 2492)
13693* BFD_RELOC_NIOS2_U16:                   howto manager.      (line 2465)
13694* BFD_RELOC_NIOS2_UJMP:                  howto manager.      (line 2475)
13695* BFD_RELOC_NONE:                        howto manager.      (line  118)
13696* BFD_RELOC_NS32K_DISP_16:               howto manager.      (line  586)
13697* BFD_RELOC_NS32K_DISP_16_PCREL:         howto manager.      (line  589)
13698* BFD_RELOC_NS32K_DISP_32:               howto manager.      (line  587)
13699* BFD_RELOC_NS32K_DISP_32_PCREL:         howto manager.      (line  590)
13700* BFD_RELOC_NS32K_DISP_8:                howto manager.      (line  585)
13701* BFD_RELOC_NS32K_DISP_8_PCREL:          howto manager.      (line  588)
13702* BFD_RELOC_NS32K_IMM_16:                howto manager.      (line  580)
13703* BFD_RELOC_NS32K_IMM_16_PCREL:          howto manager.      (line  583)
13704* BFD_RELOC_NS32K_IMM_32:                howto manager.      (line  581)
13705* BFD_RELOC_NS32K_IMM_32_PCREL:          howto manager.      (line  584)
13706* BFD_RELOC_NS32K_IMM_8:                 howto manager.      (line  579)
13707* BFD_RELOC_NS32K_IMM_8_PCREL:           howto manager.      (line  582)
13708* bfd_reloc_offset_in_range:             typedef arelent.    (line  341)
13709* BFD_RELOC_OR1K_COPY:                   howto manager.      (line 2377)
13710* BFD_RELOC_OR1K_GLOB_DAT:               howto manager.      (line 2378)
13711* BFD_RELOC_OR1K_GOT16:                  howto manager.      (line 2371)
13712* BFD_RELOC_OR1K_GOTOFF_SLO16:           howto manager.      (line 2376)
13713* BFD_RELOC_OR1K_GOTPC_HI16:             howto manager.      (line 2369)
13714* BFD_RELOC_OR1K_GOTPC_LO16:             howto manager.      (line 2370)
13715* BFD_RELOC_OR1K_GOT_LO13:               howto manager.      (line 2373)
13716* BFD_RELOC_OR1K_GOT_PG21:               howto manager.      (line 2372)
13717* BFD_RELOC_OR1K_JMP_SLOT:               howto manager.      (line 2379)
13718* BFD_RELOC_OR1K_LO13:                   howto manager.      (line 2367)
13719* BFD_RELOC_OR1K_PCREL_PG21:             howto manager.      (line 2366)
13720* BFD_RELOC_OR1K_PLT26:                  howto manager.      (line 2374)
13721* BFD_RELOC_OR1K_PLTA26:                 howto manager.      (line 2375)
13722* BFD_RELOC_OR1K_RELATIVE:               howto manager.      (line 2380)
13723* BFD_RELOC_OR1K_REL_26:                 howto manager.      (line 2364)
13724* BFD_RELOC_OR1K_SLO13:                  howto manager.      (line 2368)
13725* BFD_RELOC_OR1K_SLO16:                  howto manager.      (line 2365)
13726* BFD_RELOC_OR1K_TLS_DTPMOD:             howto manager.      (line 2402)
13727* BFD_RELOC_OR1K_TLS_DTPOFF:             howto manager.      (line 2401)
13728* BFD_RELOC_OR1K_TLS_GD_HI16:            howto manager.      (line 2381)
13729* BFD_RELOC_OR1K_TLS_GD_LO13:            howto manager.      (line 2384)
13730* BFD_RELOC_OR1K_TLS_GD_LO16:            howto manager.      (line 2382)
13731* BFD_RELOC_OR1K_TLS_GD_PG21:            howto manager.      (line 2383)
13732* BFD_RELOC_OR1K_TLS_IE_AHI16:           howto manager.      (line 2392)
13733* BFD_RELOC_OR1K_TLS_IE_HI16:            howto manager.      (line 2391)
13734* BFD_RELOC_OR1K_TLS_IE_LO13:            howto manager.      (line 2395)
13735* BFD_RELOC_OR1K_TLS_IE_LO16:            howto manager.      (line 2393)
13736* BFD_RELOC_OR1K_TLS_IE_PG21:            howto manager.      (line 2394)
13737* BFD_RELOC_OR1K_TLS_LDM_HI16:           howto manager.      (line 2385)
13738* BFD_RELOC_OR1K_TLS_LDM_LO13:           howto manager.      (line 2388)
13739* BFD_RELOC_OR1K_TLS_LDM_LO16:           howto manager.      (line 2386)
13740* BFD_RELOC_OR1K_TLS_LDM_PG21:           howto manager.      (line 2387)
13741* BFD_RELOC_OR1K_TLS_LDO_HI16:           howto manager.      (line 2389)
13742* BFD_RELOC_OR1K_TLS_LDO_LO16:           howto manager.      (line 2390)
13743* BFD_RELOC_OR1K_TLS_LE_AHI16:           howto manager.      (line 2397)
13744* BFD_RELOC_OR1K_TLS_LE_HI16:            howto manager.      (line 2396)
13745* BFD_RELOC_OR1K_TLS_LE_LO16:            howto manager.      (line 2398)
13746* BFD_RELOC_OR1K_TLS_LE_SLO16:           howto manager.      (line 2399)
13747* BFD_RELOC_OR1K_TLS_TPOFF:              howto manager.      (line 2400)
13748* BFD_RELOC_PDP11_DISP_6_PCREL:          howto manager.      (line  593)
13749* BFD_RELOC_PDP11_DISP_8_PCREL:          howto manager.      (line  592)
13750* BFD_RELOC_PJ_CODE_DIR16:               howto manager.      (line  597)
13751* BFD_RELOC_PJ_CODE_DIR32:               howto manager.      (line  598)
13752* BFD_RELOC_PJ_CODE_HI16:                howto manager.      (line  595)
13753* BFD_RELOC_PJ_CODE_LO16:                howto manager.      (line  596)
13754* BFD_RELOC_PJ_CODE_REL16:               howto manager.      (line  599)
13755* BFD_RELOC_PJ_CODE_REL32:               howto manager.      (line  600)
13756* BFD_RELOC_PPC64_ADDR16_DS:             howto manager.      (line  663)
13757* BFD_RELOC_PPC64_ADDR16_HIGH:           howto manager.      (line  674)
13758* BFD_RELOC_PPC64_ADDR16_HIGHA:          howto manager.      (line  675)
13759* BFD_RELOC_PPC64_ADDR16_HIGHER34:       howto manager.      (line  692)
13760* BFD_RELOC_PPC64_ADDR16_HIGHERA34:      howto manager.      (line  693)
13761* BFD_RELOC_PPC64_ADDR16_HIGHEST34:      howto manager.      (line  694)
13762* BFD_RELOC_PPC64_ADDR16_HIGHESTA34:     howto manager.      (line  695)
13763* BFD_RELOC_PPC64_ADDR16_LO_DS:          howto manager.      (line  664)
13764* BFD_RELOC_PPC64_ADDR64_LOCAL:          howto manager.      (line  682)
13765* BFD_RELOC_PPC64_D28:                   howto manager.      (line  700)
13766* BFD_RELOC_PPC64_D34:                   howto manager.      (line  685)
13767* BFD_RELOC_PPC64_D34_HA30:              howto manager.      (line  688)
13768* BFD_RELOC_PPC64_D34_HI30:              howto manager.      (line  687)
13769* BFD_RELOC_PPC64_D34_LO:                howto manager.      (line  686)
13770* BFD_RELOC_PPC64_DTPREL16_DS:           howto manager.      (line  741)
13771* BFD_RELOC_PPC64_DTPREL16_HIGH:         howto manager.      (line  743)
13772* BFD_RELOC_PPC64_DTPREL16_HIGHA:        howto manager.      (line  744)
13773* BFD_RELOC_PPC64_DTPREL16_HIGHER:       howto manager.      (line  745)
13774* BFD_RELOC_PPC64_DTPREL16_HIGHERA:      howto manager.      (line  746)
13775* BFD_RELOC_PPC64_DTPREL16_HIGHEST:      howto manager.      (line  747)
13776* BFD_RELOC_PPC64_DTPREL16_HIGHESTA:     howto manager.      (line  748)
13777* BFD_RELOC_PPC64_DTPREL16_LO_DS:        howto manager.      (line  742)
13778* BFD_RELOC_PPC64_DTPREL34:              howto manager.      (line  750)
13779* BFD_RELOC_PPC64_ENTRY:                 howto manager.      (line  683)
13780* BFD_RELOC_PPC64_GOT16_DS:              howto manager.      (line  665)
13781* BFD_RELOC_PPC64_GOT16_LO_DS:           howto manager.      (line  666)
13782* BFD_RELOC_PPC64_GOT_DTPREL_PCREL34:    howto manager.      (line  754)
13783* BFD_RELOC_PPC64_GOT_PCREL34:           howto manager.      (line  690)
13784* BFD_RELOC_PPC64_GOT_TLSGD_PCREL34:     howto manager.      (line  751)
13785* BFD_RELOC_PPC64_GOT_TLSLD_PCREL34:     howto manager.      (line  752)
13786* BFD_RELOC_PPC64_GOT_TPREL_PCREL34:     howto manager.      (line  753)
13787* BFD_RELOC_PPC64_HIGHER:                howto manager.      (line  651)
13788* BFD_RELOC_PPC64_HIGHER_S:              howto manager.      (line  652)
13789* BFD_RELOC_PPC64_HIGHEST:               howto manager.      (line  653)
13790* BFD_RELOC_PPC64_HIGHEST_S:             howto manager.      (line  654)
13791* BFD_RELOC_PPC64_PCREL28:               howto manager.      (line  701)
13792* BFD_RELOC_PPC64_PCREL34:               howto manager.      (line  689)
13793* BFD_RELOC_PPC64_PLT16_LO_DS:           howto manager.      (line  667)
13794* BFD_RELOC_PPC64_PLTGOT16:              howto manager.      (line  659)
13795* BFD_RELOC_PPC64_PLTGOT16_DS:           howto manager.      (line  672)
13796* BFD_RELOC_PPC64_PLTGOT16_HA:           howto manager.      (line  662)
13797* BFD_RELOC_PPC64_PLTGOT16_HI:           howto manager.      (line  661)
13798* BFD_RELOC_PPC64_PLTGOT16_LO:           howto manager.      (line  660)
13799* BFD_RELOC_PPC64_PLTGOT16_LO_DS:        howto manager.      (line  673)
13800* BFD_RELOC_PPC64_PLT_PCREL34:           howto manager.      (line  691)
13801* BFD_RELOC_PPC64_REL16_HIGH:            howto manager.      (line  676)
13802* BFD_RELOC_PPC64_REL16_HIGHA:           howto manager.      (line  677)
13803* BFD_RELOC_PPC64_REL16_HIGHER:          howto manager.      (line  678)
13804* BFD_RELOC_PPC64_REL16_HIGHER34:        howto manager.      (line  696)
13805* BFD_RELOC_PPC64_REL16_HIGHERA:         howto manager.      (line  679)
13806* BFD_RELOC_PPC64_REL16_HIGHERA34:       howto manager.      (line  697)
13807* BFD_RELOC_PPC64_REL16_HIGHEST:         howto manager.      (line  680)
13808* BFD_RELOC_PPC64_REL16_HIGHEST34:       howto manager.      (line  698)
13809* BFD_RELOC_PPC64_REL16_HIGHESTA:        howto manager.      (line  681)
13810* BFD_RELOC_PPC64_REL16_HIGHESTA34:      howto manager.      (line  699)
13811* BFD_RELOC_PPC64_REL24_NOTOC:           howto manager.      (line  684)
13812* BFD_RELOC_PPC64_SECTOFF_DS:            howto manager.      (line  668)
13813* BFD_RELOC_PPC64_SECTOFF_LO_DS:         howto manager.      (line  669)
13814* BFD_RELOC_PPC64_TLS_PCREL:             howto manager.      (line  755)
13815* BFD_RELOC_PPC64_TOC:                   howto manager.      (line  658)
13816* BFD_RELOC_PPC64_TOC16_DS:              howto manager.      (line  670)
13817* BFD_RELOC_PPC64_TOC16_HA:              howto manager.      (line  657)
13818* BFD_RELOC_PPC64_TOC16_HI:              howto manager.      (line  656)
13819* BFD_RELOC_PPC64_TOC16_LO:              howto manager.      (line  655)
13820* BFD_RELOC_PPC64_TOC16_LO_DS:           howto manager.      (line  671)
13821* BFD_RELOC_PPC64_TPREL16_DS:            howto manager.      (line  733)
13822* BFD_RELOC_PPC64_TPREL16_HIGH:          howto manager.      (line  735)
13823* BFD_RELOC_PPC64_TPREL16_HIGHA:         howto manager.      (line  736)
13824* BFD_RELOC_PPC64_TPREL16_HIGHER:        howto manager.      (line  737)
13825* BFD_RELOC_PPC64_TPREL16_HIGHERA:       howto manager.      (line  738)
13826* BFD_RELOC_PPC64_TPREL16_HIGHEST:       howto manager.      (line  739)
13827* BFD_RELOC_PPC64_TPREL16_HIGHESTA:      howto manager.      (line  740)
13828* BFD_RELOC_PPC64_TPREL16_LO_DS:         howto manager.      (line  734)
13829* BFD_RELOC_PPC64_TPREL34:               howto manager.      (line  749)
13830* BFD_RELOC_PPC_16DX_HA:                 howto manager.      (line  649)
13831* BFD_RELOC_PPC_B16:                     howto manager.      (line  605)
13832* BFD_RELOC_PPC_B16_BRNTAKEN:            howto manager.      (line  607)
13833* BFD_RELOC_PPC_B16_BRTAKEN:             howto manager.      (line  606)
13834* BFD_RELOC_PPC_B26:                     howto manager.      (line  602)
13835* BFD_RELOC_PPC_BA16:                    howto manager.      (line  608)
13836* BFD_RELOC_PPC_BA16_BRNTAKEN:           howto manager.      (line  610)
13837* BFD_RELOC_PPC_BA16_BRTAKEN:            howto manager.      (line  609)
13838* BFD_RELOC_PPC_BA26:                    howto manager.      (line  603)
13839* BFD_RELOC_PPC_COPY:                    howto manager.      (line  611)
13840* BFD_RELOC_PPC_DTPMOD:                  howto manager.      (line  706)
13841* BFD_RELOC_PPC_DTPREL:                  howto manager.      (line  716)
13842* BFD_RELOC_PPC_DTPREL16:                howto manager.      (line  712)
13843* BFD_RELOC_PPC_DTPREL16_HA:             howto manager.      (line  715)
13844* BFD_RELOC_PPC_DTPREL16_HI:             howto manager.      (line  714)
13845* BFD_RELOC_PPC_DTPREL16_LO:             howto manager.      (line  713)
13846* BFD_RELOC_PPC_EMB_BIT_FLD:             howto manager.      (line  630)
13847* BFD_RELOC_PPC_EMB_MRKREF:              howto manager.      (line  625)
13848* BFD_RELOC_PPC_EMB_NADDR16:             howto manager.      (line  617)
13849* BFD_RELOC_PPC_EMB_NADDR16_HA:          howto manager.      (line  620)
13850* BFD_RELOC_PPC_EMB_NADDR16_HI:          howto manager.      (line  619)
13851* BFD_RELOC_PPC_EMB_NADDR16_LO:          howto manager.      (line  618)
13852* BFD_RELOC_PPC_EMB_NADDR32:             howto manager.      (line  616)
13853* BFD_RELOC_PPC_EMB_RELSDA:              howto manager.      (line  631)
13854* BFD_RELOC_PPC_EMB_RELSEC16:            howto manager.      (line  626)
13855* BFD_RELOC_PPC_EMB_RELST_HA:            howto manager.      (line  629)
13856* BFD_RELOC_PPC_EMB_RELST_HI:            howto manager.      (line  628)
13857* BFD_RELOC_PPC_EMB_RELST_LO:            howto manager.      (line  627)
13858* BFD_RELOC_PPC_EMB_SDA21:               howto manager.      (line  624)
13859* BFD_RELOC_PPC_EMB_SDA2I16:             howto manager.      (line  622)
13860* BFD_RELOC_PPC_EMB_SDA2REL:             howto manager.      (line  623)
13861* BFD_RELOC_PPC_EMB_SDAI16:              howto manager.      (line  621)
13862* BFD_RELOC_PPC_GLOB_DAT:                howto manager.      (line  612)
13863* BFD_RELOC_PPC_GOT_DTPREL16:            howto manager.      (line  729)
13864* BFD_RELOC_PPC_GOT_DTPREL16_HA:         howto manager.      (line  732)
13865* BFD_RELOC_PPC_GOT_DTPREL16_HI:         howto manager.      (line  731)
13866* BFD_RELOC_PPC_GOT_DTPREL16_LO:         howto manager.      (line  730)
13867* BFD_RELOC_PPC_GOT_TLSGD16:             howto manager.      (line  717)
13868* BFD_RELOC_PPC_GOT_TLSGD16_HA:          howto manager.      (line  720)
13869* BFD_RELOC_PPC_GOT_TLSGD16_HI:          howto manager.      (line  719)
13870* BFD_RELOC_PPC_GOT_TLSGD16_LO:          howto manager.      (line  718)
13871* BFD_RELOC_PPC_GOT_TLSLD16:             howto manager.      (line  721)
13872* BFD_RELOC_PPC_GOT_TLSLD16_HA:          howto manager.      (line  724)
13873* BFD_RELOC_PPC_GOT_TLSLD16_HI:          howto manager.      (line  723)
13874* BFD_RELOC_PPC_GOT_TLSLD16_LO:          howto manager.      (line  722)
13875* BFD_RELOC_PPC_GOT_TPREL16:             howto manager.      (line  725)
13876* BFD_RELOC_PPC_GOT_TPREL16_HA:          howto manager.      (line  728)
13877* BFD_RELOC_PPC_GOT_TPREL16_HI:          howto manager.      (line  727)
13878* BFD_RELOC_PPC_GOT_TPREL16_LO:          howto manager.      (line  726)
13879* BFD_RELOC_PPC_JMP_SLOT:                howto manager.      (line  613)
13880* BFD_RELOC_PPC_LOCAL24PC:               howto manager.      (line  615)
13881* BFD_RELOC_PPC_REL16DX_HA:              howto manager.      (line  650)
13882* BFD_RELOC_PPC_RELATIVE:                howto manager.      (line  614)
13883* BFD_RELOC_PPC_TLS:                     howto manager.      (line  703)
13884* BFD_RELOC_PPC_TLSGD:                   howto manager.      (line  704)
13885* BFD_RELOC_PPC_TLSLD:                   howto manager.      (line  705)
13886* BFD_RELOC_PPC_TOC16:                   howto manager.      (line  604)
13887* BFD_RELOC_PPC_TPREL:                   howto manager.      (line  711)
13888* BFD_RELOC_PPC_TPREL16:                 howto manager.      (line  707)
13889* BFD_RELOC_PPC_TPREL16_HA:              howto manager.      (line  710)
13890* BFD_RELOC_PPC_TPREL16_HI:              howto manager.      (line  709)
13891* BFD_RELOC_PPC_TPREL16_LO:              howto manager.      (line  708)
13892* BFD_RELOC_PPC_VLE_HA16A:               howto manager.      (line  639)
13893* BFD_RELOC_PPC_VLE_HA16D:               howto manager.      (line  640)
13894* BFD_RELOC_PPC_VLE_HI16A:               howto manager.      (line  637)
13895* BFD_RELOC_PPC_VLE_HI16D:               howto manager.      (line  638)
13896* BFD_RELOC_PPC_VLE_LO16A:               howto manager.      (line  635)
13897* BFD_RELOC_PPC_VLE_LO16D:               howto manager.      (line  636)
13898* BFD_RELOC_PPC_VLE_REL15:               howto manager.      (line  633)
13899* BFD_RELOC_PPC_VLE_REL24:               howto manager.      (line  634)
13900* BFD_RELOC_PPC_VLE_REL8:                howto manager.      (line  632)
13901* BFD_RELOC_PPC_VLE_SDA21:               howto manager.      (line  641)
13902* BFD_RELOC_PPC_VLE_SDA21_LO:            howto manager.      (line  642)
13903* BFD_RELOC_PPC_VLE_SDAREL_HA16A:        howto manager.      (line  647)
13904* BFD_RELOC_PPC_VLE_SDAREL_HA16D:        howto manager.      (line  648)
13905* BFD_RELOC_PPC_VLE_SDAREL_HI16A:        howto manager.      (line  645)
13906* BFD_RELOC_PPC_VLE_SDAREL_HI16D:        howto manager.      (line  646)
13907* BFD_RELOC_PPC_VLE_SDAREL_LO16A:        howto manager.      (line  643)
13908* BFD_RELOC_PPC_VLE_SDAREL_LO16D:        howto manager.      (line  644)
13909* BFD_RELOC_PRU_16_PMEM:                 howto manager.      (line 2530)
13910* BFD_RELOC_PRU_32_PMEM:                 howto manager.      (line 2529)
13911* BFD_RELOC_PRU_GNU_DIFF16:              howto manager.      (line 2534)
13912* BFD_RELOC_PRU_GNU_DIFF16_PMEM:         howto manager.      (line 2536)
13913* BFD_RELOC_PRU_GNU_DIFF32:              howto manager.      (line 2535)
13914* BFD_RELOC_PRU_GNU_DIFF32_PMEM:         howto manager.      (line 2537)
13915* BFD_RELOC_PRU_GNU_DIFF8:               howto manager.      (line 2533)
13916* BFD_RELOC_PRU_LDI32:                   howto manager.      (line 2521)
13917* BFD_RELOC_PRU_S10_PCREL:               howto manager.      (line 2525)
13918* BFD_RELOC_PRU_U16:                     howto manager.      (line 2517)
13919* BFD_RELOC_PRU_U16_PMEMIMM:             howto manager.      (line 2519)
13920* BFD_RELOC_PRU_U8_PCREL:                howto manager.      (line 2527)
13921* BFD_RELOC_RELC:                        howto manager.      (line 2416)
13922* BFD_RELOC_RISCV_32_PCREL:              howto manager.      (line 1885)
13923* BFD_RELOC_RISCV_ADD16:                 howto manager.      (line 1853)
13924* BFD_RELOC_RISCV_ADD32:                 howto manager.      (line 1854)
13925* BFD_RELOC_RISCV_ADD64:                 howto manager.      (line 1855)
13926* BFD_RELOC_RISCV_ADD8:                  howto manager.      (line 1852)
13927* BFD_RELOC_RISCV_ALIGN:                 howto manager.      (line 1870)
13928* BFD_RELOC_RISCV_CALL:                  howto manager.      (line 1850)
13929* BFD_RELOC_RISCV_CALL_PLT:              howto manager.      (line 1851)
13930* BFD_RELOC_RISCV_CFA:                   howto manager.      (line 1879)
13931* BFD_RELOC_RISCV_GOT_HI20:              howto manager.      (line 1860)
13932* BFD_RELOC_RISCV_GPREL12_I:             howto manager.      (line 1844)
13933* BFD_RELOC_RISCV_GPREL12_S:             howto manager.      (line 1845)
13934* BFD_RELOC_RISCV_GPREL_I:               howto manager.      (line 1874)
13935* BFD_RELOC_RISCV_GPREL_S:               howto manager.      (line 1875)
13936* BFD_RELOC_RISCV_HI20:                  howto manager.      (line 1838)
13937* BFD_RELOC_RISCV_JMP:                   howto manager.      (line 1863)
13938* BFD_RELOC_RISCV_LO12_I:                howto manager.      (line 1842)
13939* BFD_RELOC_RISCV_LO12_S:                howto manager.      (line 1843)
13940* BFD_RELOC_RISCV_PCREL_HI20:            howto manager.      (line 1839)
13941* BFD_RELOC_RISCV_PCREL_LO12_I:          howto manager.      (line 1840)
13942* BFD_RELOC_RISCV_PCREL_LO12_S:          howto manager.      (line 1841)
13943* BFD_RELOC_RISCV_RELAX:                 howto manager.      (line 1878)
13944* BFD_RELOC_RISCV_RVC_BRANCH:            howto manager.      (line 1871)
13945* BFD_RELOC_RISCV_RVC_JUMP:              howto manager.      (line 1872)
13946* BFD_RELOC_RISCV_RVC_LUI:               howto manager.      (line 1873)
13947* BFD_RELOC_RISCV_SET16:                 howto manager.      (line 1883)
13948* BFD_RELOC_RISCV_SET32:                 howto manager.      (line 1884)
13949* BFD_RELOC_RISCV_SET6:                  howto manager.      (line 1881)
13950* BFD_RELOC_RISCV_SET8:                  howto manager.      (line 1882)
13951* BFD_RELOC_RISCV_SUB16:                 howto manager.      (line 1857)
13952* BFD_RELOC_RISCV_SUB32:                 howto manager.      (line 1858)
13953* BFD_RELOC_RISCV_SUB6:                  howto manager.      (line 1880)
13954* BFD_RELOC_RISCV_SUB64:                 howto manager.      (line 1859)
13955* BFD_RELOC_RISCV_SUB8:                  howto manager.      (line 1856)
13956* BFD_RELOC_RISCV_TLS_DTPMOD32:          howto manager.      (line 1864)
13957* BFD_RELOC_RISCV_TLS_DTPMOD64:          howto manager.      (line 1866)
13958* BFD_RELOC_RISCV_TLS_DTPREL32:          howto manager.      (line 1865)
13959* BFD_RELOC_RISCV_TLS_DTPREL64:          howto manager.      (line 1867)
13960* BFD_RELOC_RISCV_TLS_GD_HI20:           howto manager.      (line 1862)
13961* BFD_RELOC_RISCV_TLS_GOT_HI20:          howto manager.      (line 1861)
13962* BFD_RELOC_RISCV_TLS_TPREL32:           howto manager.      (line 1868)
13963* BFD_RELOC_RISCV_TLS_TPREL64:           howto manager.      (line 1869)
13964* BFD_RELOC_RISCV_TPREL_ADD:             howto manager.      (line 1849)
13965* BFD_RELOC_RISCV_TPREL_HI20:            howto manager.      (line 1846)
13966* BFD_RELOC_RISCV_TPREL_I:               howto manager.      (line 1876)
13967* BFD_RELOC_RISCV_TPREL_LO12_I:          howto manager.      (line 1847)
13968* BFD_RELOC_RISCV_TPREL_LO12_S:          howto manager.      (line 1848)
13969* BFD_RELOC_RISCV_TPREL_S:               howto manager.      (line 1877)
13970* BFD_RELOC_RL78_16U:                    howto manager.      (line 1895)
13971* BFD_RELOC_RL78_16_OP:                  howto manager.      (line 1891)
13972* BFD_RELOC_RL78_24U:                    howto manager.      (line 1896)
13973* BFD_RELOC_RL78_24_OP:                  howto manager.      (line 1892)
13974* BFD_RELOC_RL78_32_OP:                  howto manager.      (line 1893)
13975* BFD_RELOC_RL78_8U:                     howto manager.      (line 1894)
13976* BFD_RELOC_RL78_ABS16:                  howto manager.      (line 1908)
13977* BFD_RELOC_RL78_ABS16U:                 howto manager.      (line 1912)
13978* BFD_RELOC_RL78_ABS16UL:                howto manager.      (line 1914)
13979* BFD_RELOC_RL78_ABS16UW:                howto manager.      (line 1913)
13980* BFD_RELOC_RL78_ABS16_REV:              howto manager.      (line 1909)
13981* BFD_RELOC_RL78_ABS32:                  howto manager.      (line 1910)
13982* BFD_RELOC_RL78_ABS32_REV:              howto manager.      (line 1911)
13983* BFD_RELOC_RL78_ABS8:                   howto manager.      (line 1907)
13984* BFD_RELOC_RL78_CODE:                   howto manager.      (line 1919)
13985* BFD_RELOC_RL78_DIFF:                   howto manager.      (line 1898)
13986* BFD_RELOC_RL78_DIR3U_PCREL:            howto manager.      (line 1897)
13987* BFD_RELOC_RL78_GPRELB:                 howto manager.      (line 1899)
13988* BFD_RELOC_RL78_GPRELL:                 howto manager.      (line 1901)
13989* BFD_RELOC_RL78_GPRELW:                 howto manager.      (line 1900)
13990* BFD_RELOC_RL78_HI16:                   howto manager.      (line 1916)
13991* BFD_RELOC_RL78_HI8:                    howto manager.      (line 1917)
13992* BFD_RELOC_RL78_LO16:                   howto manager.      (line 1918)
13993* BFD_RELOC_RL78_NEG16:                  howto manager.      (line 1888)
13994* BFD_RELOC_RL78_NEG24:                  howto manager.      (line 1889)
13995* BFD_RELOC_RL78_NEG32:                  howto manager.      (line 1890)
13996* BFD_RELOC_RL78_NEG8:                   howto manager.      (line 1887)
13997* BFD_RELOC_RL78_OP_AND:                 howto manager.      (line 1905)
13998* BFD_RELOC_RL78_OP_NEG:                 howto manager.      (line 1904)
13999* BFD_RELOC_RL78_OP_SHRA:                howto manager.      (line 1906)
14000* BFD_RELOC_RL78_OP_SUBTRACT:            howto manager.      (line 1903)
14001* BFD_RELOC_RL78_RELAX:                  howto manager.      (line 1915)
14002* BFD_RELOC_RL78_SADDR:                  howto manager.      (line 1920)
14003* BFD_RELOC_RL78_SYM:                    howto manager.      (line 1902)
14004* BFD_RELOC_RVA:                         howto manager.      (line   95)
14005* BFD_RELOC_RX_16U:                      howto manager.      (line 1930)
14006* BFD_RELOC_RX_16_OP:                    howto manager.      (line 1926)
14007* BFD_RELOC_RX_24U:                      howto manager.      (line 1931)
14008* BFD_RELOC_RX_24_OP:                    howto manager.      (line 1927)
14009* BFD_RELOC_RX_32_OP:                    howto manager.      (line 1928)
14010* BFD_RELOC_RX_8U:                       howto manager.      (line 1929)
14011* BFD_RELOC_RX_ABS16:                    howto manager.      (line 1941)
14012* BFD_RELOC_RX_ABS16U:                   howto manager.      (line 1945)
14013* BFD_RELOC_RX_ABS16UL:                  howto manager.      (line 1947)
14014* BFD_RELOC_RX_ABS16UW:                  howto manager.      (line 1946)
14015* BFD_RELOC_RX_ABS16_REV:                howto manager.      (line 1942)
14016* BFD_RELOC_RX_ABS32:                    howto manager.      (line 1943)
14017* BFD_RELOC_RX_ABS32_REV:                howto manager.      (line 1944)
14018* BFD_RELOC_RX_ABS8:                     howto manager.      (line 1940)
14019* BFD_RELOC_RX_DIFF:                     howto manager.      (line 1933)
14020* BFD_RELOC_RX_DIR3U_PCREL:              howto manager.      (line 1932)
14021* BFD_RELOC_RX_GPRELB:                   howto manager.      (line 1934)
14022* BFD_RELOC_RX_GPRELL:                   howto manager.      (line 1936)
14023* BFD_RELOC_RX_GPRELW:                   howto manager.      (line 1935)
14024* BFD_RELOC_RX_NEG16:                    howto manager.      (line 1923)
14025* BFD_RELOC_RX_NEG24:                    howto manager.      (line 1924)
14026* BFD_RELOC_RX_NEG32:                    howto manager.      (line 1925)
14027* BFD_RELOC_RX_NEG8:                     howto manager.      (line 1922)
14028* BFD_RELOC_RX_OP_NEG:                   howto manager.      (line 1939)
14029* BFD_RELOC_RX_OP_SUBTRACT:              howto manager.      (line 1938)
14030* BFD_RELOC_RX_RELAX:                    howto manager.      (line 1948)
14031* BFD_RELOC_RX_SYM:                      howto manager.      (line 1937)
14032* BFD_RELOC_S12Z_15_PCREL:               howto manager.      (line 2260)
14033* BFD_RELOC_S12Z_OPR:                    howto manager.      (line 3436)
14034* BFD_RELOC_SCORE16_BRANCH:              howto manager.      (line 2051)
14035* BFD_RELOC_SCORE16_JMP:                 howto manager.      (line 2049)
14036* BFD_RELOC_SCORE_BCMP:                  howto manager.      (line 2053)
14037* BFD_RELOC_SCORE_BRANCH:                howto manager.      (line 2043)
14038* BFD_RELOC_SCORE_CALL15:                howto manager.      (line 2057)
14039* BFD_RELOC_SCORE_DUMMY2:                howto manager.      (line 2040)
14040* BFD_RELOC_SCORE_DUMMY_HI16:            howto manager.      (line 2058)
14041* BFD_RELOC_SCORE_GOT15:                 howto manager.      (line 2055)
14042* BFD_RELOC_SCORE_GOT_LO16:              howto manager.      (line 2056)
14043* BFD_RELOC_SCORE_GPREL15:               howto manager.      (line 2038)
14044* BFD_RELOC_SCORE_IMM30:                 howto manager.      (line 2045)
14045* BFD_RELOC_SCORE_IMM32:                 howto manager.      (line 2047)
14046* BFD_RELOC_SCORE_JMP:                   howto manager.      (line 2041)
14047* BFD_RELOC_SH_ALIGN:                    howto manager.      (line  952)
14048* BFD_RELOC_SH_CODE:                     howto manager.      (line  953)
14049* BFD_RELOC_SH_COPY:                     howto manager.      (line  958)
14050* BFD_RELOC_SH_COPY64:                   howto manager.      (line  983)
14051* BFD_RELOC_SH_COUNT:                    howto manager.      (line  951)
14052* BFD_RELOC_SH_DATA:                     howto manager.      (line  954)
14053* BFD_RELOC_SH_DISP12:                   howto manager.      (line  934)
14054* BFD_RELOC_SH_DISP12BY2:                howto manager.      (line  935)
14055* BFD_RELOC_SH_DISP12BY4:                howto manager.      (line  936)
14056* BFD_RELOC_SH_DISP12BY8:                howto manager.      (line  937)
14057* BFD_RELOC_SH_DISP20:                   howto manager.      (line  938)
14058* BFD_RELOC_SH_DISP20BY8:                howto manager.      (line  939)
14059* BFD_RELOC_SH_FUNCDESC:                 howto manager.      (line 1026)
14060* BFD_RELOC_SH_GLOB_DAT:                 howto manager.      (line  959)
14061* BFD_RELOC_SH_GLOB_DAT64:               howto manager.      (line  984)
14062* BFD_RELOC_SH_GOT10BY4:                 howto manager.      (line  987)
14063* BFD_RELOC_SH_GOT10BY8:                 howto manager.      (line  988)
14064* BFD_RELOC_SH_GOT20:                    howto manager.      (line 1020)
14065* BFD_RELOC_SH_GOTFUNCDESC:              howto manager.      (line 1022)
14066* BFD_RELOC_SH_GOTFUNCDESC20:            howto manager.      (line 1023)
14067* BFD_RELOC_SH_GOTOFF20:                 howto manager.      (line 1021)
14068* BFD_RELOC_SH_GOTOFFFUNCDESC:           howto manager.      (line 1024)
14069* BFD_RELOC_SH_GOTOFFFUNCDESC20:         howto manager.      (line 1025)
14070* BFD_RELOC_SH_GOTOFF_HI16:              howto manager.      (line  978)
14071* BFD_RELOC_SH_GOTOFF_LOW16:             howto manager.      (line  975)
14072* BFD_RELOC_SH_GOTOFF_MEDHI16:           howto manager.      (line  977)
14073* BFD_RELOC_SH_GOTOFF_MEDLOW16:          howto manager.      (line  976)
14074* BFD_RELOC_SH_GOTPC:                    howto manager.      (line  962)
14075* BFD_RELOC_SH_GOTPC_HI16:               howto manager.      (line  982)
14076* BFD_RELOC_SH_GOTPC_LOW16:              howto manager.      (line  979)
14077* BFD_RELOC_SH_GOTPC_MEDHI16:            howto manager.      (line  981)
14078* BFD_RELOC_SH_GOTPC_MEDLOW16:           howto manager.      (line  980)
14079* BFD_RELOC_SH_GOTPLT10BY4:              howto manager.      (line  989)
14080* BFD_RELOC_SH_GOTPLT10BY8:              howto manager.      (line  990)
14081* BFD_RELOC_SH_GOTPLT32:                 howto manager.      (line  991)
14082* BFD_RELOC_SH_GOTPLT_HI16:              howto manager.      (line  970)
14083* BFD_RELOC_SH_GOTPLT_LOW16:             howto manager.      (line  967)
14084* BFD_RELOC_SH_GOTPLT_MEDHI16:           howto manager.      (line  969)
14085* BFD_RELOC_SH_GOTPLT_MEDLOW16:          howto manager.      (line  968)
14086* BFD_RELOC_SH_GOT_HI16:                 howto manager.      (line  966)
14087* BFD_RELOC_SH_GOT_LOW16:                howto manager.      (line  963)
14088* BFD_RELOC_SH_GOT_MEDHI16:              howto manager.      (line  965)
14089* BFD_RELOC_SH_GOT_MEDLOW16:             howto manager.      (line  964)
14090* BFD_RELOC_SH_IMM3:                     howto manager.      (line  932)
14091* BFD_RELOC_SH_IMM3U:                    howto manager.      (line  933)
14092* BFD_RELOC_SH_IMM4:                     howto manager.      (line  940)
14093* BFD_RELOC_SH_IMM4BY2:                  howto manager.      (line  941)
14094* BFD_RELOC_SH_IMM4BY4:                  howto manager.      (line  942)
14095* BFD_RELOC_SH_IMM8:                     howto manager.      (line  943)
14096* BFD_RELOC_SH_IMM8BY2:                  howto manager.      (line  944)
14097* BFD_RELOC_SH_IMM8BY4:                  howto manager.      (line  945)
14098* BFD_RELOC_SH_IMMS10:                   howto manager.      (line  997)
14099* BFD_RELOC_SH_IMMS10BY2:                howto manager.      (line  998)
14100* BFD_RELOC_SH_IMMS10BY4:                howto manager.      (line  999)
14101* BFD_RELOC_SH_IMMS10BY8:                howto manager.      (line 1000)
14102* BFD_RELOC_SH_IMMS16:                   howto manager.      (line 1001)
14103* BFD_RELOC_SH_IMMS6:                    howto manager.      (line  994)
14104* BFD_RELOC_SH_IMMS6BY32:                howto manager.      (line  995)
14105* BFD_RELOC_SH_IMMU16:                   howto manager.      (line 1002)
14106* BFD_RELOC_SH_IMMU5:                    howto manager.      (line  993)
14107* BFD_RELOC_SH_IMMU6:                    howto manager.      (line  996)
14108* BFD_RELOC_SH_IMM_HI16:                 howto manager.      (line 1009)
14109* BFD_RELOC_SH_IMM_HI16_PCREL:           howto manager.      (line 1010)
14110* BFD_RELOC_SH_IMM_LOW16:                howto manager.      (line 1003)
14111* BFD_RELOC_SH_IMM_LOW16_PCREL:          howto manager.      (line 1004)
14112* BFD_RELOC_SH_IMM_MEDHI16:              howto manager.      (line 1007)
14113* BFD_RELOC_SH_IMM_MEDHI16_PCREL:        howto manager.      (line 1008)
14114* BFD_RELOC_SH_IMM_MEDLOW16:             howto manager.      (line 1005)
14115* BFD_RELOC_SH_IMM_MEDLOW16_PCREL:       howto manager.      (line 1006)
14116* BFD_RELOC_SH_JMP_SLOT:                 howto manager.      (line  960)
14117* BFD_RELOC_SH_JMP_SLOT64:               howto manager.      (line  985)
14118* BFD_RELOC_SH_LABEL:                    howto manager.      (line  955)
14119* BFD_RELOC_SH_LOOP_END:                 howto manager.      (line  957)
14120* BFD_RELOC_SH_LOOP_START:               howto manager.      (line  956)
14121* BFD_RELOC_SH_PCDISP12BY2:              howto manager.      (line  931)
14122* BFD_RELOC_SH_PCDISP8BY2:               howto manager.      (line  930)
14123* BFD_RELOC_SH_PCRELIMM8BY2:             howto manager.      (line  946)
14124* BFD_RELOC_SH_PCRELIMM8BY4:             howto manager.      (line  947)
14125* BFD_RELOC_SH_PLT_HI16:                 howto manager.      (line  974)
14126* BFD_RELOC_SH_PLT_LOW16:                howto manager.      (line  971)
14127* BFD_RELOC_SH_PLT_MEDHI16:              howto manager.      (line  973)
14128* BFD_RELOC_SH_PLT_MEDLOW16:             howto manager.      (line  972)
14129* BFD_RELOC_SH_PT_16:                    howto manager.      (line 1011)
14130* BFD_RELOC_SH_RELATIVE:                 howto manager.      (line  961)
14131* BFD_RELOC_SH_RELATIVE64:               howto manager.      (line  986)
14132* BFD_RELOC_SH_SHMEDIA_CODE:             howto manager.      (line  992)
14133* BFD_RELOC_SH_SWITCH16:                 howto manager.      (line  948)
14134* BFD_RELOC_SH_SWITCH32:                 howto manager.      (line  949)
14135* BFD_RELOC_SH_TLS_DTPMOD32:             howto manager.      (line 1017)
14136* BFD_RELOC_SH_TLS_DTPOFF32:             howto manager.      (line 1018)
14137* BFD_RELOC_SH_TLS_GD_32:                howto manager.      (line 1012)
14138* BFD_RELOC_SH_TLS_IE_32:                howto manager.      (line 1015)
14139* BFD_RELOC_SH_TLS_LDO_32:               howto manager.      (line 1014)
14140* BFD_RELOC_SH_TLS_LD_32:                howto manager.      (line 1013)
14141* BFD_RELOC_SH_TLS_LE_32:                howto manager.      (line 1016)
14142* BFD_RELOC_SH_TLS_TPOFF32:              howto manager.      (line 1019)
14143* BFD_RELOC_SH_USES:                     howto manager.      (line  950)
14144* BFD_RELOC_SIZE32:                      howto manager.      (line   67)
14145* BFD_RELOC_SIZE64:                      howto manager.      (line   68)
14146* BFD_RELOC_SPARC13:                     howto manager.      (line  121)
14147* BFD_RELOC_SPARC22:                     howto manager.      (line  120)
14148* BFD_RELOC_SPARC_10:                    howto manager.      (line  148)
14149* BFD_RELOC_SPARC_11:                    howto manager.      (line  149)
14150* BFD_RELOC_SPARC_5:                     howto manager.      (line  161)
14151* BFD_RELOC_SPARC_6:                     howto manager.      (line  160)
14152* BFD_RELOC_SPARC_64:                    howto manager.      (line  147)
14153* BFD_RELOC_SPARC_7:                     howto manager.      (line  159)
14154* BFD_RELOC_SPARC_BASE13:                howto manager.      (line  144)
14155* BFD_RELOC_SPARC_BASE22:                howto manager.      (line  145)
14156* BFD_RELOC_SPARC_COPY:                  howto manager.      (line  128)
14157* BFD_RELOC_SPARC_DISP64:                howto manager.      (line  162)
14158* BFD_RELOC_SPARC_GLOB_DAT:              howto manager.      (line  129)
14159* BFD_RELOC_SPARC_GOT10:                 howto manager.      (line  122)
14160* BFD_RELOC_SPARC_GOT13:                 howto manager.      (line  123)
14161* BFD_RELOC_SPARC_GOT22:                 howto manager.      (line  124)
14162* BFD_RELOC_SPARC_GOTDATA_HIX22:         howto manager.      (line  135)
14163* BFD_RELOC_SPARC_GOTDATA_LOX10:         howto manager.      (line  136)
14164* BFD_RELOC_SPARC_GOTDATA_OP:            howto manager.      (line  139)
14165* BFD_RELOC_SPARC_GOTDATA_OP_HIX22:      howto manager.      (line  137)
14166* BFD_RELOC_SPARC_GOTDATA_OP_LOX10:      howto manager.      (line  138)
14167* BFD_RELOC_SPARC_H34:                   howto manager.      (line  171)
14168* BFD_RELOC_SPARC_H44:                   howto manager.      (line  167)
14169* BFD_RELOC_SPARC_HH22:                  howto manager.      (line  151)
14170* BFD_RELOC_SPARC_HIX22:                 howto manager.      (line  165)
14171* BFD_RELOC_SPARC_HM10:                  howto manager.      (line  152)
14172* BFD_RELOC_SPARC_IRELATIVE:             howto manager.      (line  141)
14173* BFD_RELOC_SPARC_JMP_IREL:              howto manager.      (line  140)
14174* BFD_RELOC_SPARC_JMP_SLOT:              howto manager.      (line  130)
14175* BFD_RELOC_SPARC_L44:                   howto manager.      (line  169)
14176* BFD_RELOC_SPARC_LM22:                  howto manager.      (line  153)
14177* BFD_RELOC_SPARC_LOX10:                 howto manager.      (line  166)
14178* BFD_RELOC_SPARC_M44:                   howto manager.      (line  168)
14179* BFD_RELOC_SPARC_OLO10:                 howto manager.      (line  150)
14180* BFD_RELOC_SPARC_PC10:                  howto manager.      (line  125)
14181* BFD_RELOC_SPARC_PC22:                  howto manager.      (line  126)
14182* BFD_RELOC_SPARC_PC_HH22:               howto manager.      (line  154)
14183* BFD_RELOC_SPARC_PC_HM10:               howto manager.      (line  155)
14184* BFD_RELOC_SPARC_PC_LM22:               howto manager.      (line  156)
14185* BFD_RELOC_SPARC_PLT32:                 howto manager.      (line  163)
14186* BFD_RELOC_SPARC_PLT64:                 howto manager.      (line  164)
14187* BFD_RELOC_SPARC_REGISTER:              howto manager.      (line  170)
14188* BFD_RELOC_SPARC_RELATIVE:              howto manager.      (line  131)
14189* BFD_RELOC_SPARC_REV32:                 howto manager.      (line  176)
14190* BFD_RELOC_SPARC_SIZE32:                howto manager.      (line  172)
14191* BFD_RELOC_SPARC_SIZE64:                howto manager.      (line  173)
14192* BFD_RELOC_SPARC_TLS_DTPMOD32:          howto manager.      (line  196)
14193* BFD_RELOC_SPARC_TLS_DTPMOD64:          howto manager.      (line  197)
14194* BFD_RELOC_SPARC_TLS_DTPOFF32:          howto manager.      (line  198)
14195* BFD_RELOC_SPARC_TLS_DTPOFF64:          howto manager.      (line  199)
14196* BFD_RELOC_SPARC_TLS_GD_ADD:            howto manager.      (line  180)
14197* BFD_RELOC_SPARC_TLS_GD_CALL:           howto manager.      (line  181)
14198* BFD_RELOC_SPARC_TLS_GD_HI22:           howto manager.      (line  178)
14199* BFD_RELOC_SPARC_TLS_GD_LO10:           howto manager.      (line  179)
14200* BFD_RELOC_SPARC_TLS_IE_ADD:            howto manager.      (line  193)
14201* BFD_RELOC_SPARC_TLS_IE_HI22:           howto manager.      (line  189)
14202* BFD_RELOC_SPARC_TLS_IE_LD:             howto manager.      (line  191)
14203* BFD_RELOC_SPARC_TLS_IE_LDX:            howto manager.      (line  192)
14204* BFD_RELOC_SPARC_TLS_IE_LO10:           howto manager.      (line  190)
14205* BFD_RELOC_SPARC_TLS_LDM_ADD:           howto manager.      (line  184)
14206* BFD_RELOC_SPARC_TLS_LDM_CALL:          howto manager.      (line  185)
14207* BFD_RELOC_SPARC_TLS_LDM_HI22:          howto manager.      (line  182)
14208* BFD_RELOC_SPARC_TLS_LDM_LO10:          howto manager.      (line  183)
14209* BFD_RELOC_SPARC_TLS_LDO_ADD:           howto manager.      (line  188)
14210* BFD_RELOC_SPARC_TLS_LDO_HIX22:         howto manager.      (line  186)
14211* BFD_RELOC_SPARC_TLS_LDO_LOX10:         howto manager.      (line  187)
14212* BFD_RELOC_SPARC_TLS_LE_HIX22:          howto manager.      (line  194)
14213* BFD_RELOC_SPARC_TLS_LE_LOX10:          howto manager.      (line  195)
14214* BFD_RELOC_SPARC_TLS_TPOFF32:           howto manager.      (line  200)
14215* BFD_RELOC_SPARC_TLS_TPOFF64:           howto manager.      (line  201)
14216* BFD_RELOC_SPARC_UA16:                  howto manager.      (line  132)
14217* BFD_RELOC_SPARC_UA32:                  howto manager.      (line  133)
14218* BFD_RELOC_SPARC_UA64:                  howto manager.      (line  134)
14219* BFD_RELOC_SPARC_WDISP10:               howto manager.      (line  174)
14220* BFD_RELOC_SPARC_WDISP16:               howto manager.      (line  157)
14221* BFD_RELOC_SPARC_WDISP19:               howto manager.      (line  158)
14222* BFD_RELOC_SPARC_WDISP22:               howto manager.      (line  119)
14223* BFD_RELOC_SPARC_WPLT30:                howto manager.      (line  127)
14224* BFD_RELOC_SPU_ADD_PIC:                 howto manager.      (line  217)
14225* BFD_RELOC_SPU_HI16:                    howto manager.      (line  214)
14226* BFD_RELOC_SPU_IMM10:                   howto manager.      (line  205)
14227* BFD_RELOC_SPU_IMM10W:                  howto manager.      (line  206)
14228* BFD_RELOC_SPU_IMM16:                   howto manager.      (line  207)
14229* BFD_RELOC_SPU_IMM16W:                  howto manager.      (line  208)
14230* BFD_RELOC_SPU_IMM18:                   howto manager.      (line  209)
14231* BFD_RELOC_SPU_IMM7:                    howto manager.      (line  203)
14232* BFD_RELOC_SPU_IMM8:                    howto manager.      (line  204)
14233* BFD_RELOC_SPU_LO16:                    howto manager.      (line  213)
14234* BFD_RELOC_SPU_PCREL16:                 howto manager.      (line  212)
14235* BFD_RELOC_SPU_PCREL9a:                 howto manager.      (line  210)
14236* BFD_RELOC_SPU_PCREL9b:                 howto manager.      (line  211)
14237* BFD_RELOC_SPU_PPU32:                   howto manager.      (line  215)
14238* BFD_RELOC_SPU_PPU64:                   howto manager.      (line  216)
14239* BFD_RELOC_THUMB_PCREL_BFCSEL:          howto manager.      (line  782)
14240* BFD_RELOC_THUMB_PCREL_BLX:             howto manager.      (line  771)
14241* BFD_RELOC_THUMB_PCREL_BRANCH12:        howto manager.      (line  794)
14242* BFD_RELOC_THUMB_PCREL_BRANCH20:        howto manager.      (line  795)
14243* BFD_RELOC_THUMB_PCREL_BRANCH23:        howto manager.      (line  796)
14244* BFD_RELOC_THUMB_PCREL_BRANCH25:        howto manager.      (line  797)
14245* BFD_RELOC_THUMB_PCREL_BRANCH5:         howto manager.      (line  780)
14246* BFD_RELOC_THUMB_PCREL_BRANCH7:         howto manager.      (line  792)
14247* BFD_RELOC_THUMB_PCREL_BRANCH9:         howto manager.      (line  793)
14248* BFD_RELOC_TIC30_LDP:                   howto manager.      (line 1549)
14249* BFD_RELOC_TIC54X_16_OF_23:             howto manager.      (line 1563)
14250* BFD_RELOC_TIC54X_23:                   howto manager.      (line 1561)
14251* BFD_RELOC_TIC54X_MS7_OF_23:            howto manager.      (line 1567)
14252* BFD_RELOC_TIC54X_PARTLS7:              howto manager.      (line 1553)
14253* BFD_RELOC_TIC54X_PARTMS9:              howto manager.      (line 1557)
14254* BFD_RELOC_TILEGX_BROFF_X1:             howto manager.      (line 3231)
14255* BFD_RELOC_TILEGX_COPY:                 howto manager.      (line 3227)
14256* BFD_RELOC_TILEGX_DEST_IMM8_X1:         howto manager.      (line 3238)
14257* BFD_RELOC_TILEGX_GLOB_DAT:             howto manager.      (line 3228)
14258* BFD_RELOC_TILEGX_HW0:                  howto manager.      (line 3220)
14259* BFD_RELOC_TILEGX_HW0_LAST:             howto manager.      (line 3224)
14260* BFD_RELOC_TILEGX_HW1:                  howto manager.      (line 3221)
14261* BFD_RELOC_TILEGX_HW1_LAST:             howto manager.      (line 3225)
14262* BFD_RELOC_TILEGX_HW2:                  howto manager.      (line 3222)
14263* BFD_RELOC_TILEGX_HW2_LAST:             howto manager.      (line 3226)
14264* BFD_RELOC_TILEGX_HW3:                  howto manager.      (line 3223)
14265* BFD_RELOC_TILEGX_IMM16_X0_HW0:         howto manager.      (line 3247)
14266* BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT:     howto manager.      (line 3275)
14267* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST:    howto manager.      (line 3255)
14268* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT: howto manager.     (line 3283)
14269* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL: howto manager.   (line 3269)
14270* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL: howto manager.
14271                                                             (line 3303)
14272* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD: howto manager.  (line 3297)
14273* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE: howto manager.  (line 3309)
14274* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE: howto manager.  (line 3293)
14275* BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL:   howto manager.      (line 3261)
14276* BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL: howto manager.    (line 3277)
14277* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD:  howto manager.      (line 3289)
14278* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE:  howto manager.      (line 3301)
14279* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE:  howto manager.      (line 3291)
14280* BFD_RELOC_TILEGX_IMM16_X0_HW1:         howto manager.      (line 3249)
14281* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST:    howto manager.      (line 3257)
14282* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT: howto manager.     (line 3285)
14283* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL: howto manager.   (line 3271)
14284* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL: howto manager.
14285                                                             (line 3305)
14286* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD: howto manager.  (line 3299)
14287* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE: howto manager.  (line 3311)
14288* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE: howto manager.  (line 3295)
14289* BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL:   howto manager.      (line 3263)
14290* BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL: howto manager.    (line 3279)
14291* BFD_RELOC_TILEGX_IMM16_X0_HW2:         howto manager.      (line 3251)
14292* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST:    howto manager.      (line 3259)
14293* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL: howto manager.   (line 3273)
14294* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL: howto manager.
14295                                                             (line 3307)
14296* BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL:   howto manager.      (line 3265)
14297* BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL: howto manager.    (line 3281)
14298* BFD_RELOC_TILEGX_IMM16_X0_HW3:         howto manager.      (line 3253)
14299* BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL:   howto manager.      (line 3267)
14300* BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL: howto manager.    (line 3287)
14301* BFD_RELOC_TILEGX_IMM16_X1_HW0:         howto manager.      (line 3248)
14302* BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT:     howto manager.      (line 3276)
14303* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST:    howto manager.      (line 3256)
14304* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT: howto manager.     (line 3284)
14305* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL: howto manager.   (line 3270)
14306* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL: howto manager.
14307                                                             (line 3304)
14308* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD: howto manager.  (line 3298)
14309* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE: howto manager.  (line 3310)
14310* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE: howto manager.  (line 3294)
14311* BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL:   howto manager.      (line 3262)
14312* BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL: howto manager.    (line 3278)
14313* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD:  howto manager.      (line 3290)
14314* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE:  howto manager.      (line 3302)
14315* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE:  howto manager.      (line 3292)
14316* BFD_RELOC_TILEGX_IMM16_X1_HW1:         howto manager.      (line 3250)
14317* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST:    howto manager.      (line 3258)
14318* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT: howto manager.     (line 3286)
14319* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL: howto manager.   (line 3272)
14320* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL: howto manager.
14321                                                             (line 3306)
14322* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD: howto manager.  (line 3300)
14323* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE: howto manager.  (line 3312)
14324* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE: howto manager.  (line 3296)
14325* BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL:   howto manager.      (line 3264)
14326* BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL: howto manager.    (line 3280)
14327* BFD_RELOC_TILEGX_IMM16_X1_HW2:         howto manager.      (line 3252)
14328* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST:    howto manager.      (line 3260)
14329* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL: howto manager.   (line 3274)
14330* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL: howto manager.
14331                                                             (line 3308)
14332* BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL:   howto manager.      (line 3266)
14333* BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL: howto manager.    (line 3282)
14334* BFD_RELOC_TILEGX_IMM16_X1_HW3:         howto manager.      (line 3254)
14335* BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL:   howto manager.      (line 3268)
14336* BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL: howto manager.    (line 3288)
14337* BFD_RELOC_TILEGX_IMM8_X0:              howto manager.      (line 3234)
14338* BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD:      howto manager.      (line 3325)
14339* BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD:   howto manager.      (line 3320)
14340* BFD_RELOC_TILEGX_IMM8_X1:              howto manager.      (line 3236)
14341* BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD:      howto manager.      (line 3326)
14342* BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD:   howto manager.      (line 3321)
14343* BFD_RELOC_TILEGX_IMM8_Y0:              howto manager.      (line 3235)
14344* BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD:      howto manager.      (line 3327)
14345* BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD:   howto manager.      (line 3322)
14346* BFD_RELOC_TILEGX_IMM8_Y1:              howto manager.      (line 3237)
14347* BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD:      howto manager.      (line 3328)
14348* BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD:   howto manager.      (line 3323)
14349* BFD_RELOC_TILEGX_JMP_SLOT:             howto manager.      (line 3229)
14350* BFD_RELOC_TILEGX_JUMPOFF_X1:           howto manager.      (line 3232)
14351* BFD_RELOC_TILEGX_JUMPOFF_X1_PLT:       howto manager.      (line 3233)
14352* BFD_RELOC_TILEGX_MF_IMM14_X1:          howto manager.      (line 3240)
14353* BFD_RELOC_TILEGX_MMEND_X0:             howto manager.      (line 3242)
14354* BFD_RELOC_TILEGX_MMSTART_X0:           howto manager.      (line 3241)
14355* BFD_RELOC_TILEGX_MT_IMM14_X1:          howto manager.      (line 3239)
14356* BFD_RELOC_TILEGX_RELATIVE:             howto manager.      (line 3230)
14357* BFD_RELOC_TILEGX_SHAMT_X0:             howto manager.      (line 3243)
14358* BFD_RELOC_TILEGX_SHAMT_X1:             howto manager.      (line 3244)
14359* BFD_RELOC_TILEGX_SHAMT_Y0:             howto manager.      (line 3245)
14360* BFD_RELOC_TILEGX_SHAMT_Y1:             howto manager.      (line 3246)
14361* BFD_RELOC_TILEGX_TLS_DTPMOD32:         howto manager.      (line 3316)
14362* BFD_RELOC_TILEGX_TLS_DTPMOD64:         howto manager.      (line 3313)
14363* BFD_RELOC_TILEGX_TLS_DTPOFF32:         howto manager.      (line 3317)
14364* BFD_RELOC_TILEGX_TLS_DTPOFF64:         howto manager.      (line 3314)
14365* BFD_RELOC_TILEGX_TLS_GD_CALL:          howto manager.      (line 3319)
14366* BFD_RELOC_TILEGX_TLS_IE_LOAD:          howto manager.      (line 3324)
14367* BFD_RELOC_TILEGX_TLS_TPOFF32:          howto manager.      (line 3318)
14368* BFD_RELOC_TILEGX_TLS_TPOFF64:          howto manager.      (line 3315)
14369* BFD_RELOC_TILEPRO_BROFF_X1:            howto manager.      (line 3144)
14370* BFD_RELOC_TILEPRO_COPY:                howto manager.      (line 3140)
14371* BFD_RELOC_TILEPRO_DEST_IMM8_X1:        howto manager.      (line 3151)
14372* BFD_RELOC_TILEPRO_GLOB_DAT:            howto manager.      (line 3141)
14373* BFD_RELOC_TILEPRO_IMM16_X0:            howto manager.      (line 3154)
14374* BFD_RELOC_TILEPRO_IMM16_X0_GOT:        howto manager.      (line 3170)
14375* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA:     howto manager.      (line 3176)
14376* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI:     howto manager.      (line 3174)
14377* BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO:     howto manager.      (line 3172)
14378* BFD_RELOC_TILEPRO_IMM16_X0_HA:         howto manager.      (line 3160)
14379* BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL:   howto manager.      (line 3168)
14380* BFD_RELOC_TILEPRO_IMM16_X0_HI:         howto manager.      (line 3158)
14381* BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL:   howto manager.      (line 3166)
14382* BFD_RELOC_TILEPRO_IMM16_X0_LO:         howto manager.      (line 3156)
14383* BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL:   howto manager.      (line 3164)
14384* BFD_RELOC_TILEPRO_IMM16_X0_PCREL:      howto manager.      (line 3162)
14385* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD:     howto manager.      (line 3192)
14386* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA:  howto manager.      (line 3198)
14387* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI:  howto manager.      (line 3196)
14388* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO:  howto manager.      (line 3194)
14389* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE:     howto manager.      (line 3200)
14390* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA:  howto manager.      (line 3206)
14391* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI:  howto manager.      (line 3204)
14392* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO:  howto manager.      (line 3202)
14393* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE:     howto manager.      (line 3211)
14394* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA:  howto manager.      (line 3217)
14395* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI:  howto manager.      (line 3215)
14396* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO:  howto manager.      (line 3213)
14397* BFD_RELOC_TILEPRO_IMM16_X1:            howto manager.      (line 3155)
14398* BFD_RELOC_TILEPRO_IMM16_X1_GOT:        howto manager.      (line 3171)
14399* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA:     howto manager.      (line 3177)
14400* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI:     howto manager.      (line 3175)
14401* BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO:     howto manager.      (line 3173)
14402* BFD_RELOC_TILEPRO_IMM16_X1_HA:         howto manager.      (line 3161)
14403* BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL:   howto manager.      (line 3169)
14404* BFD_RELOC_TILEPRO_IMM16_X1_HI:         howto manager.      (line 3159)
14405* BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL:   howto manager.      (line 3167)
14406* BFD_RELOC_TILEPRO_IMM16_X1_LO:         howto manager.      (line 3157)
14407* BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL:   howto manager.      (line 3165)
14408* BFD_RELOC_TILEPRO_IMM16_X1_PCREL:      howto manager.      (line 3163)
14409* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD:     howto manager.      (line 3193)
14410* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA:  howto manager.      (line 3199)
14411* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI:  howto manager.      (line 3197)
14412* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO:  howto manager.      (line 3195)
14413* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE:     howto manager.      (line 3201)
14414* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA:  howto manager.      (line 3207)
14415* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI:  howto manager.      (line 3205)
14416* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO:  howto manager.      (line 3203)
14417* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE:     howto manager.      (line 3212)
14418* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA:  howto manager.      (line 3218)
14419* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI:  howto manager.      (line 3216)
14420* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO:  howto manager.      (line 3214)
14421* BFD_RELOC_TILEPRO_IMM8_X0:             howto manager.      (line 3147)
14422* BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD:  howto manager.      (line 3187)
14423* BFD_RELOC_TILEPRO_IMM8_X1:             howto manager.      (line 3149)
14424* BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD:  howto manager.      (line 3188)
14425* BFD_RELOC_TILEPRO_IMM8_Y0:             howto manager.      (line 3148)
14426* BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD:  howto manager.      (line 3189)
14427* BFD_RELOC_TILEPRO_IMM8_Y1:             howto manager.      (line 3150)
14428* BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD:  howto manager.      (line 3190)
14429* BFD_RELOC_TILEPRO_JMP_SLOT:            howto manager.      (line 3142)
14430* BFD_RELOC_TILEPRO_JOFFLONG_X1:         howto manager.      (line 3145)
14431* BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT:     howto manager.      (line 3146)
14432* BFD_RELOC_TILEPRO_MF_IMM15_X1:         howto manager.      (line 3153)
14433* BFD_RELOC_TILEPRO_MMEND_X0:            howto manager.      (line 3179)
14434* BFD_RELOC_TILEPRO_MMEND_X1:            howto manager.      (line 3181)
14435* BFD_RELOC_TILEPRO_MMSTART_X0:          howto manager.      (line 3178)
14436* BFD_RELOC_TILEPRO_MMSTART_X1:          howto manager.      (line 3180)
14437* BFD_RELOC_TILEPRO_MT_IMM15_X1:         howto manager.      (line 3152)
14438* BFD_RELOC_TILEPRO_RELATIVE:            howto manager.      (line 3143)
14439* BFD_RELOC_TILEPRO_SHAMT_X0:            howto manager.      (line 3182)
14440* BFD_RELOC_TILEPRO_SHAMT_X1:            howto manager.      (line 3183)
14441* BFD_RELOC_TILEPRO_SHAMT_Y0:            howto manager.      (line 3184)
14442* BFD_RELOC_TILEPRO_SHAMT_Y1:            howto manager.      (line 3185)
14443* BFD_RELOC_TILEPRO_TLS_DTPMOD32:        howto manager.      (line 3208)
14444* BFD_RELOC_TILEPRO_TLS_DTPOFF32:        howto manager.      (line 3209)
14445* BFD_RELOC_TILEPRO_TLS_GD_CALL:         howto manager.      (line 3186)
14446* BFD_RELOC_TILEPRO_TLS_IE_LOAD:         howto manager.      (line 3191)
14447* BFD_RELOC_TILEPRO_TLS_TPOFF32:         howto manager.      (line 3210)
14448* bfd_reloc_type_lookup:                 howto manager.      (line 3440)
14449* BFD_RELOC_V850_16_GOT:                 howto manager.      (line 1525)
14450* BFD_RELOC_V850_16_GOTOFF:              howto manager.      (line 1541)
14451* BFD_RELOC_V850_16_PCREL:               howto manager.      (line 1505)
14452* BFD_RELOC_V850_16_S1:                  howto manager.      (line 1517)
14453* BFD_RELOC_V850_16_SPLIT_OFFSET:        howto manager.      (line 1515)
14454* BFD_RELOC_V850_17_PCREL:               howto manager.      (line 1507)
14455* BFD_RELOC_V850_22_PCREL:               howto manager.      (line 1459)
14456* BFD_RELOC_V850_22_PLT_PCREL:           howto manager.      (line 1529)
14457* BFD_RELOC_V850_23:                     howto manager.      (line 1509)
14458* BFD_RELOC_V850_32_ABS:                 howto manager.      (line 1513)
14459* BFD_RELOC_V850_32_GOT:                 howto manager.      (line 1527)
14460* BFD_RELOC_V850_32_GOTOFF:              howto manager.      (line 1543)
14461* BFD_RELOC_V850_32_GOTPCREL:            howto manager.      (line 1523)
14462* BFD_RELOC_V850_32_PCREL:               howto manager.      (line 1511)
14463* BFD_RELOC_V850_32_PLT_PCREL:           howto manager.      (line 1531)
14464* BFD_RELOC_V850_9_PCREL:                howto manager.      (line 1457)
14465* BFD_RELOC_V850_ALIGN:                  howto manager.      (line 1500)
14466* BFD_RELOC_V850_CALLT_15_16_OFFSET:     howto manager.      (line 1521)
14467* BFD_RELOC_V850_CALLT_16_16_OFFSET:     howto manager.      (line 1494)
14468* BFD_RELOC_V850_CALLT_6_7_OFFSET:       howto manager.      (line 1492)
14469* BFD_RELOC_V850_CODE:                   howto manager.      (line 1545)
14470* BFD_RELOC_V850_COPY:                   howto manager.      (line 1533)
14471* BFD_RELOC_V850_DATA:                   howto manager.      (line 1547)
14472* BFD_RELOC_V850_GLOB_DAT:               howto manager.      (line 1535)
14473* BFD_RELOC_V850_JMP_SLOT:               howto manager.      (line 1537)
14474* BFD_RELOC_V850_LO16_S1:                howto manager.      (line 1519)
14475* BFD_RELOC_V850_LO16_SPLIT_OFFSET:      howto manager.      (line 1502)
14476* BFD_RELOC_V850_LONGCALL:               howto manager.      (line 1496)
14477* BFD_RELOC_V850_LONGJUMP:               howto manager.      (line 1498)
14478* BFD_RELOC_V850_RELATIVE:               howto manager.      (line 1539)
14479* BFD_RELOC_V850_SDA_15_16_OFFSET:       howto manager.      (line 1463)
14480* BFD_RELOC_V850_SDA_16_16_OFFSET:       howto manager.      (line 1461)
14481* BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET: howto manager.      (line 1486)
14482* BFD_RELOC_V850_TDA_16_16_OFFSET:       howto manager.      (line 1479)
14483* BFD_RELOC_V850_TDA_4_4_OFFSET:         howto manager.      (line 1484)
14484* BFD_RELOC_V850_TDA_4_5_OFFSET:         howto manager.      (line 1481)
14485* BFD_RELOC_V850_TDA_6_8_OFFSET:         howto manager.      (line 1471)
14486* BFD_RELOC_V850_TDA_7_7_OFFSET:         howto manager.      (line 1477)
14487* BFD_RELOC_V850_TDA_7_8_OFFSET:         howto manager.      (line 1474)
14488* BFD_RELOC_V850_ZDA_15_16_OFFSET:       howto manager.      (line 1468)
14489* BFD_RELOC_V850_ZDA_16_16_OFFSET:       howto manager.      (line 1466)
14490* BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET: howto manager.      (line 1489)
14491* BFD_RELOC_VAX_GLOB_DAT:                howto manager.      (line 2423)
14492* BFD_RELOC_VAX_JMP_SLOT:                howto manager.      (line 2424)
14493* BFD_RELOC_VAX_RELATIVE:                howto manager.      (line 2425)
14494* BFD_RELOC_VISIUM_HI16:                 howto manager.      (line 3351)
14495* BFD_RELOC_VISIUM_HI16_PCREL:           howto manager.      (line 3355)
14496* BFD_RELOC_VISIUM_IM16:                 howto manager.      (line 3353)
14497* BFD_RELOC_VISIUM_IM16_PCREL:           howto manager.      (line 3357)
14498* BFD_RELOC_VISIUM_LO16:                 howto manager.      (line 3352)
14499* BFD_RELOC_VISIUM_LO16_PCREL:           howto manager.      (line 3356)
14500* BFD_RELOC_VISIUM_REL16:                howto manager.      (line 3354)
14501* BFD_RELOC_VPE4KMATH_DATA:              howto manager.      (line 2081)
14502* BFD_RELOC_VPE4KMATH_INSN:              howto manager.      (line 2082)
14503* BFD_RELOC_VTABLE_ENTRY:                howto manager.      (line 2085)
14504* BFD_RELOC_VTABLE_INHERIT:              howto manager.      (line 2084)
14505* BFD_RELOC_WASM32_ABS32_CODE:           howto manager.      (line 3364)
14506* BFD_RELOC_WASM32_CODE_POINTER:         howto manager.      (line 3366)
14507* BFD_RELOC_WASM32_COPY:                 howto manager.      (line 3365)
14508* BFD_RELOC_WASM32_INDEX:                howto manager.      (line 3367)
14509* BFD_RELOC_WASM32_LEB128:               howto manager.      (line 3359)
14510* BFD_RELOC_WASM32_LEB128_GOT:           howto manager.      (line 3360)
14511* BFD_RELOC_WASM32_LEB128_GOT_CODE:      howto manager.      (line 3361)
14512* BFD_RELOC_WASM32_LEB128_PLT:           howto manager.      (line 3362)
14513* BFD_RELOC_WASM32_PLT_INDEX:            howto manager.      (line 3363)
14514* BFD_RELOC_WASM32_PLT_SIG:              howto manager.      (line 3368)
14515* BFD_RELOC_X86_64_32S:                  howto manager.      (line  554)
14516* BFD_RELOC_X86_64_COPY:                 howto manager.      (line  549)
14517* BFD_RELOC_X86_64_DTPMOD64:             howto manager.      (line  555)
14518* BFD_RELOC_X86_64_DTPOFF32:             howto manager.      (line  560)
14519* BFD_RELOC_X86_64_DTPOFF64:             howto manager.      (line  556)
14520* BFD_RELOC_X86_64_GLOB_DAT:             howto manager.      (line  550)
14521* BFD_RELOC_X86_64_GOT32:                howto manager.      (line  547)
14522* BFD_RELOC_X86_64_GOT64:                howto manager.      (line  565)
14523* BFD_RELOC_X86_64_GOTOFF64:             howto manager.      (line  563)
14524* BFD_RELOC_X86_64_GOTPC32:              howto manager.      (line  564)
14525* BFD_RELOC_X86_64_GOTPC32_TLSDESC:      howto manager.      (line  570)
14526* BFD_RELOC_X86_64_GOTPC64:              howto manager.      (line  567)
14527* BFD_RELOC_X86_64_GOTPCREL:             howto manager.      (line  553)
14528* BFD_RELOC_X86_64_GOTPCREL64:           howto manager.      (line  566)
14529* BFD_RELOC_X86_64_GOTPCRELX:            howto manager.      (line  576)
14530* BFD_RELOC_X86_64_GOTPLT64:             howto manager.      (line  568)
14531* BFD_RELOC_X86_64_GOTTPOFF:             howto manager.      (line  561)
14532* BFD_RELOC_X86_64_IRELATIVE:            howto manager.      (line  573)
14533* BFD_RELOC_X86_64_JUMP_SLOT:            howto manager.      (line  551)
14534* BFD_RELOC_X86_64_PC32_BND:             howto manager.      (line  574)
14535* BFD_RELOC_X86_64_PLT32:                howto manager.      (line  548)
14536* BFD_RELOC_X86_64_PLT32_BND:            howto manager.      (line  575)
14537* BFD_RELOC_X86_64_PLTOFF64:             howto manager.      (line  569)
14538* BFD_RELOC_X86_64_RELATIVE:             howto manager.      (line  552)
14539* BFD_RELOC_X86_64_REX_GOTPCRELX:        howto manager.      (line  577)
14540* BFD_RELOC_X86_64_TLSDESC:              howto manager.      (line  572)
14541* BFD_RELOC_X86_64_TLSDESC_CALL:         howto manager.      (line  571)
14542* BFD_RELOC_X86_64_TLSGD:                howto manager.      (line  558)
14543* BFD_RELOC_X86_64_TLSLD:                howto manager.      (line  559)
14544* BFD_RELOC_X86_64_TPOFF32:              howto manager.      (line  562)
14545* BFD_RELOC_X86_64_TPOFF64:              howto manager.      (line  557)
14546* BFD_RELOC_XC16X_PAG:                   howto manager.      (line 2418)
14547* BFD_RELOC_XC16X_POF:                   howto manager.      (line 2419)
14548* BFD_RELOC_XC16X_SEG:                   howto manager.      (line 2420)
14549* BFD_RELOC_XC16X_SOF:                   howto manager.      (line 2421)
14550* BFD_RELOC_XGATE_24:                    howto manager.      (line 2228)
14551* BFD_RELOC_XGATE_GPAGE:                 howto manager.      (line 2226)
14552* BFD_RELOC_XGATE_IMM3:                  howto manager.      (line 2240)
14553* BFD_RELOC_XGATE_IMM4:                  howto manager.      (line 2242)
14554* BFD_RELOC_XGATE_IMM5:                  howto manager.      (line 2244)
14555* BFD_RELOC_XGATE_IMM8_HI:               howto manager.      (line 2237)
14556* BFD_RELOC_XGATE_IMM8_LO:               howto manager.      (line 2234)
14557* BFD_RELOC_XGATE_LO16:                  howto manager.      (line 2223)
14558* BFD_RELOC_XGATE_PCREL_10:              howto manager.      (line 2232)
14559* BFD_RELOC_XGATE_PCREL_9:               howto manager.      (line 2230)
14560* BFD_RELOC_XGATE_RL_GROUP:              howto manager.      (line 2219)
14561* BFD_RELOC_XGATE_RL_JUMP:               howto manager.      (line 2216)
14562* BFD_RELOC_XSTORMY16_12:                howto manager.      (line 2412)
14563* BFD_RELOC_XSTORMY16_24:                howto manager.      (line 2413)
14564* BFD_RELOC_XSTORMY16_FPTR16:            howto manager.      (line 2414)
14565* BFD_RELOC_XSTORMY16_REL_12:            howto manager.      (line 2411)
14566* BFD_RELOC_XTENSA_ASM_EXPAND:           howto manager.      (line 2613)
14567* BFD_RELOC_XTENSA_ASM_SIMPLIFY:         howto manager.      (line 2617)
14568* BFD_RELOC_XTENSA_DIFF16:               howto manager.      (line 2562)
14569* BFD_RELOC_XTENSA_DIFF32:               howto manager.      (line 2563)
14570* BFD_RELOC_XTENSA_DIFF8:                howto manager.      (line 2561)
14571* BFD_RELOC_XTENSA_GLOB_DAT:             howto manager.      (line 2553)
14572* BFD_RELOC_XTENSA_JMP_SLOT:             howto manager.      (line 2554)
14573* BFD_RELOC_XTENSA_NDIFF16:              howto manager.      (line 2633)
14574* BFD_RELOC_XTENSA_NDIFF32:              howto manager.      (line 2634)
14575* BFD_RELOC_XTENSA_NDIFF8:               howto manager.      (line 2632)
14576* BFD_RELOC_XTENSA_OP0:                  howto manager.      (line 2608)
14577* BFD_RELOC_XTENSA_OP1:                  howto manager.      (line 2609)
14578* BFD_RELOC_XTENSA_OP2:                  howto manager.      (line 2610)
14579* BFD_RELOC_XTENSA_PDIFF16:              howto manager.      (line 2630)
14580* BFD_RELOC_XTENSA_PDIFF32:              howto manager.      (line 2631)
14581* BFD_RELOC_XTENSA_PDIFF8:               howto manager.      (line 2629)
14582* BFD_RELOC_XTENSA_PLT:                  howto manager.      (line 2557)
14583* BFD_RELOC_XTENSA_RELATIVE:             howto manager.      (line 2555)
14584* BFD_RELOC_XTENSA_RTLD:                 howto manager.      (line 2549)
14585* BFD_RELOC_XTENSA_SLOT0_ALT:            howto manager.      (line 2591)
14586* BFD_RELOC_XTENSA_SLOT0_OP:             howto manager.      (line 2572)
14587* BFD_RELOC_XTENSA_SLOT10_ALT:           howto manager.      (line 2601)
14588* BFD_RELOC_XTENSA_SLOT10_OP:            howto manager.      (line 2582)
14589* BFD_RELOC_XTENSA_SLOT11_ALT:           howto manager.      (line 2602)
14590* BFD_RELOC_XTENSA_SLOT11_OP:            howto manager.      (line 2583)
14591* BFD_RELOC_XTENSA_SLOT12_ALT:           howto manager.      (line 2603)
14592* BFD_RELOC_XTENSA_SLOT12_OP:            howto manager.      (line 2584)
14593* BFD_RELOC_XTENSA_SLOT13_ALT:           howto manager.      (line 2604)
14594* BFD_RELOC_XTENSA_SLOT13_OP:            howto manager.      (line 2585)
14595* BFD_RELOC_XTENSA_SLOT14_ALT:           howto manager.      (line 2605)
14596* BFD_RELOC_XTENSA_SLOT14_OP:            howto manager.      (line 2586)
14597* BFD_RELOC_XTENSA_SLOT1_ALT:            howto manager.      (line 2592)
14598* BFD_RELOC_XTENSA_SLOT1_OP:             howto manager.      (line 2573)
14599* BFD_RELOC_XTENSA_SLOT2_ALT:            howto manager.      (line 2593)
14600* BFD_RELOC_XTENSA_SLOT2_OP:             howto manager.      (line 2574)
14601* BFD_RELOC_XTENSA_SLOT3_ALT:            howto manager.      (line 2594)
14602* BFD_RELOC_XTENSA_SLOT3_OP:             howto manager.      (line 2575)
14603* BFD_RELOC_XTENSA_SLOT4_ALT:            howto manager.      (line 2595)
14604* BFD_RELOC_XTENSA_SLOT4_OP:             howto manager.      (line 2576)
14605* BFD_RELOC_XTENSA_SLOT5_ALT:            howto manager.      (line 2596)
14606* BFD_RELOC_XTENSA_SLOT5_OP:             howto manager.      (line 2577)
14607* BFD_RELOC_XTENSA_SLOT6_ALT:            howto manager.      (line 2597)
14608* BFD_RELOC_XTENSA_SLOT6_OP:             howto manager.      (line 2578)
14609* BFD_RELOC_XTENSA_SLOT7_ALT:            howto manager.      (line 2598)
14610* BFD_RELOC_XTENSA_SLOT7_OP:             howto manager.      (line 2579)
14611* BFD_RELOC_XTENSA_SLOT8_ALT:            howto manager.      (line 2599)
14612* BFD_RELOC_XTENSA_SLOT8_OP:             howto manager.      (line 2580)
14613* BFD_RELOC_XTENSA_SLOT9_ALT:            howto manager.      (line 2600)
14614* BFD_RELOC_XTENSA_SLOT9_OP:             howto manager.      (line 2581)
14615* BFD_RELOC_XTENSA_TLSDESC_ARG:          howto manager.      (line 2622)
14616* BFD_RELOC_XTENSA_TLSDESC_FN:           howto manager.      (line 2621)
14617* BFD_RELOC_XTENSA_TLS_ARG:              howto manager.      (line 2626)
14618* BFD_RELOC_XTENSA_TLS_CALL:             howto manager.      (line 2627)
14619* BFD_RELOC_XTENSA_TLS_DTPOFF:           howto manager.      (line 2623)
14620* BFD_RELOC_XTENSA_TLS_FUNC:             howto manager.      (line 2625)
14621* BFD_RELOC_XTENSA_TLS_TPOFF:            howto manager.      (line 2624)
14622* BFD_RELOC_Z80_16_BE:                   howto manager.      (line 2658)
14623* BFD_RELOC_Z80_BYTE0:                   howto manager.      (line 2646)
14624* BFD_RELOC_Z80_BYTE1:                   howto manager.      (line 2648)
14625* BFD_RELOC_Z80_BYTE2:                   howto manager.      (line 2650)
14626* BFD_RELOC_Z80_BYTE3:                   howto manager.      (line 2652)
14627* BFD_RELOC_Z80_DISP8:                   howto manager.      (line 2644)
14628* BFD_RELOC_Z80_WORD0:                   howto manager.      (line 2654)
14629* BFD_RELOC_Z80_WORD1:                   howto manager.      (line 2656)
14630* BFD_RELOC_Z8K_CALLR:                   howto manager.      (line 2662)
14631* BFD_RELOC_Z8K_DISP7:                   howto manager.      (line 2660)
14632* BFD_RELOC_Z8K_IMM4L:                   howto manager.      (line 2664)
14633* bfd_rename_section:                    section prototypes. (line  167)
14634* bfd_scan_arch:                         Architectures.      (line  582)
14635* bfd_scan_vma:                          Miscellaneous.      (line  126)
14636* bfd_sections_find_if:                  section prototypes. (line  197)
14637* bfd_section_already_linked:            Writing the symbol table.
14638                                                             (line   54)
14639* bfd_section_list_clear:                section prototypes. (line    7)
14640* bfd_set_archive_head:                  Archives.           (line   74)
14641* bfd_set_arch_info:                     Architectures.      (line  623)
14642* bfd_set_assert_handler:                Error reporting.    (line  160)
14643* bfd_set_default_target:                bfd_target.         (line  573)
14644* bfd_set_error:                         Error reporting.    (line   57)
14645* bfd_set_error_handler:                 Error reporting.    (line  126)
14646* bfd_set_error_program_name:            Error reporting.    (line  134)
14647* bfd_set_filename:                      Opening and Closing.
14648                                                             (line  520)
14649* bfd_set_file_flags:                    Miscellaneous.      (line   45)
14650* bfd_set_format:                        Formats.            (line   67)
14651* bfd_set_gp_size:                       Miscellaneous.      (line  116)
14652* bfd_set_input_error:                   Error reporting.    (line   68)
14653* bfd_set_private_flags:                 Miscellaneous.      (line  174)
14654* bfd_set_reloc:                         Miscellaneous.      (line   33)
14655* bfd_set_section_contents:              section prototypes. (line  228)
14656* bfd_set_section_flags:                 section prototypes. (line  154)
14657* bfd_set_section_size:                  section prototypes. (line  214)
14658* bfd_set_start_address:                 Miscellaneous.      (line   95)
14659* bfd_set_symtab:                        symbol handling functions.
14660                                                             (line   59)
14661* bfd_symbol_info:                       symbol handling functions.
14662                                                             (line  129)
14663* bfd_target_list:                       bfd_target.         (line  625)
14664* bfd_update_compression_header:         Miscellaneous.      (line  335)
14665* bfd_write_bigendian_4byte_int:         Internal.           (line   12)
14666* bfd_zalloc:                            Opening and Closing.
14667                                                             (line  257)
14668* check_build_id_file:                   Opening and Closing.
14669                                                             (line  482)
14670* coff_symbol_type:                      coff.               (line  233)
14671* core_file_matches_executable_p:        Core Files.         (line   38)
14672* find_separate_debug_file:              Opening and Closing.
14673                                                             (line  356)
14674* generic_core_file_matches_executable_p: Core Files.        (line   48)
14675* get_build_id:                          Opening and Closing.
14676                                                             (line  451)
14677* get_build_id_name:                     Opening and Closing.
14678                                                             (line  465)
14679* Hash tables:                           Hash Tables.        (line    6)
14680* internal object-file format:           Canonical format.   (line   11)
14681* Linker:                                Linker Functions.   (line    6)
14682* Other functions:                       Miscellaneous.      (line  188)
14683* separate_alt_debug_file_exists:        Opening and Closing.
14684                                                             (line  347)
14685* separate_debug_file_exists:            Opening and Closing.
14686                                                             (line  334)
14687* struct bfd_iovec:                      Miscellaneous.      (line  396)
14688* target vector (_bfd_final_link):       Performing the Final Link.
14689                                                             (line    6)
14690* target vector (_bfd_link_add_symbols): Adding Symbols to the Hash Table.
14691                                                             (line    6)
14692* target vector (_bfd_link_hash_table_create): Creating a Linker Hash Table.
14693                                                             (line    6)
14694* The HOWTO Macro:                       typedef arelent.    (line  287)
14695* what is it?:                           Overview.           (line    6)
14696
14697
14698
14699Tag Table:
14700Node: Top1051
14701Node: Overview1387
14702Node: History2445
14703Node: How It Works3390
14704Node: What BFD Version 2 Can Do4927
14705Node: BFD information loss6244
14706Node: Canonical format8785
14707Node: BFD front end13128
14708Node: typedef bfd13552
14709Node: Error reporting31353
14710Node: Miscellaneous36601
14711Node: Memory Usage55332
14712Node: Initialization56563
14713Node: Sections57239
14714Node: Section Input57722
14715Node: Section Output58916
14716Node: typedef asection61403
14717Node: section prototypes86415
14718Node: Symbols97159
14719Node: Reading Symbols98762
14720Node: Writing Symbols99870
14721Node: Mini Symbols101614
14722Node: typedef asymbol102588
14723Node: symbol handling functions108794
14724Node: Archives114162
14725Node: Formats118299
14726Node: Relocations121250
14727Node: typedef arelent121977
14728Node: howto manager136892
14729Node: Core Files270534
14730Node: Targets272572
14731Node: bfd_target274547
14732Node: Architectures302441
14733Node: Opening and Closing334212
14734Node: Internal352443
14735Node: File Caching359273
14736Node: Linker Functions361191
14737Node: Creating a Linker Hash Table362865
14738Node: Adding Symbols to the Hash Table364604
14739Node: Differing file formats365504
14740Node: Adding symbols from an object file367229
14741Node: Adding symbols from an archive369379
14742Node: Performing the Final Link371725
14743Node: Information provided by the linker372966
14744Node: Relocating the section contents374120
14745Node: Writing the symbol table375872
14746Node: Hash Tables383021
14747Node: Creating and Freeing a Hash Table384219
14748Node: Looking Up or Entering a String385469
14749Node: Traversing a Hash Table386722
14750Node: Deriving a New Hash Table Type387511
14751Node: Define the Derived Structures388577
14752Node: Write the Derived Creation Routine389658
14753Node: Write Other Derived Routines392283
14754Node: BFD back ends393598
14755Node: What to Put Where393868
14756Node: aout394048
14757Node: coff400330
14758Node: elf428481
14759Node: mmo428882
14760Node: File layout429752
14761Node: Symbol-table435666
14762Node: mmo section mapping439429
14763Node: GNU Free Documentation License443083
14764Node: BFD Index468146
14765
14766End Tag Table
14767