1This is bfd.info, produced by makeinfo version 7.0.2 from bfd.texi.
2
3This file documents the BFD library.
4
5   Copyright �� 1991-2024 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* Initialization::
302* Threading::
303* Miscellaneous::
304* Memory Usage::
305* Sections::
306* Symbols::
307* Archives::
308* Formats::
309* Relocations::
310* Core Files::
311* Targets::
312* Architectures::
313* Opening and Closing::
314* Internal::
315* File Caching::
316* Linker Functions::
317* Hash Tables::
318
319
320File: bfd.info,  Node: typedef bfd,  Next: Error reporting,  Prev: BFD front end,  Up: BFD front end
321
3222.1 ���typedef bfd���
323=================
324
325A BFD has type ���bfd���; objects of this type are the cornerstone of any
326application using BFD. Using BFD consists of making references though
327the BFD and to data in the BFD.
328
329   Here is the structure that defines the type ���bfd���.  It contains the
330major data about the file and pointers to the rest of the data.
331
332     struct bfd
333     {
334       /* The filename the application opened the BFD with.  */
335       const char *filename;
336
337       /* A pointer to the target jump table.  */
338       const struct bfd_target *xvec;
339
340       /* The IOSTREAM, and corresponding IO vector that provide access
341          to the file backing the BFD.  */
342       void *iostream;
343       const struct bfd_iovec *iovec;
344
345       /* The caching routines use these to maintain a
346          least-recently-used list of BFDs.  */
347       struct bfd *lru_prev, *lru_next;
348
349       /* Track current file position (or current buffer offset for
350          in-memory BFDs).  When a file is closed by the caching routines,
351          BFD retains state information on the file here.  */
352       ufile_ptr where;
353
354       /* File modified time, if mtime_set is TRUE.  */
355       long mtime;
356
357       /* A unique identifier of the BFD  */
358       unsigned int id;
359
360       /* Format_specific flags.  */
361       flagword flags;
362
363       /* Values that may appear in the flags field of a BFD.  These also
364          appear in the object_flags field of the bfd_target structure, where
365          they indicate the set of flags used by that backend (not all flags
366          are meaningful for all object file formats) (FIXME: at the moment,
367          the object_flags values have mostly just been copied from backend
368          to another, and are not necessarily correct).  */
369
370     #define BFD_NO_FLAGS                0x0
371
372       /* BFD contains relocation entries.  */
373     #define HAS_RELOC                   0x1
374
375       /* BFD is directly executable.  */
376     #define EXEC_P                      0x2
377
378       /* BFD has line number information (basically used for F_LNNO in a
379          COFF header).  */
380     #define HAS_LINENO                  0x4
381
382       /* BFD has debugging information.  */
383     #define HAS_DEBUG                  0x08
384
385       /* BFD has symbols.  */
386     #define HAS_SYMS                   0x10
387
388       /* BFD has local symbols (basically used for F_LSYMS in a COFF
389          header).  */
390     #define HAS_LOCALS                 0x20
391
392       /* BFD is a dynamic object.  */
393     #define DYNAMIC                    0x40
394
395       /* Text section is write protected (if D_PAGED is not set, this is
396          like an a.out NMAGIC file) (the linker sets this by default, but
397          clears it for -r or -N).  */
398     #define WP_TEXT                    0x80
399
400       /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
401          linker sets this by default, but clears it for -r or -n or -N).  */
402     #define D_PAGED                   0x100
403
404       /* BFD is relaxable (this means that bfd_relax_section may be able to
405          do something) (sometimes bfd_relax_section can do something even if
406          this is not set).  */
407     #define BFD_IS_RELAXABLE          0x200
408
409       /* This may be set before writing out a BFD to request using a
410          traditional format.  For example, this is used to request that when
411          writing out an a.out object the symbols not be hashed to eliminate
412          duplicates.  */
413     #define BFD_TRADITIONAL_FORMAT    0x400
414
415       /* This flag indicates that the BFD contents are actually cached
416          in memory.  If this is set, iostream points to a malloc'd
417          bfd_in_memory struct.  */
418     #define BFD_IN_MEMORY             0x800
419
420       /* This BFD has been created by the linker and doesn't correspond
421          to any input file.  */
422     #define BFD_LINKER_CREATED       0x1000
423
424       /* This may be set before writing out a BFD to request that it
425          be written using values for UIDs, GIDs, timestamps, etc. that
426          will be consistent from run to run.  */
427     #define BFD_DETERMINISTIC_OUTPUT 0x2000
428
429       /* Compress sections in this BFD.  */
430     #define BFD_COMPRESS             0x4000
431
432       /* Decompress sections in this BFD.  */
433     #define BFD_DECOMPRESS           0x8000
434
435       /* BFD is a dummy, for plugins.  */
436     #define BFD_PLUGIN              0x10000
437
438       /* Compress sections in this BFD with SHF_COMPRESSED from gABI.  */
439     #define BFD_COMPRESS_GABI       0x20000
440
441       /* Convert ELF common symbol type to STT_COMMON or STT_OBJECT in this
442          BFD.  */
443     #define BFD_CONVERT_ELF_COMMON  0x40000
444
445       /* Use the ELF STT_COMMON type in this BFD.  */
446     #define BFD_USE_ELF_STT_COMMON  0x80000
447
448       /* Put pathnames into archives (non-POSIX).  */
449     #define BFD_ARCHIVE_FULL_PATH  0x100000
450
451     #define BFD_CLOSED_BY_CACHE    0x200000
452       /* Compress sections in this BFD with SHF_COMPRESSED zstd.  */
453     #define BFD_COMPRESS_ZSTD      0x400000
454
455       /* Don't generate ELF section header.  */
456     #define BFD_NO_SECTION_HEADER  0x800000
457
458       /* Flags bits which are for BFD use only.  */
459     #define BFD_FLAGS_FOR_BFD_USE_MASK \
460       (BFD_IN_MEMORY | BFD_COMPRESS | BFD_DECOMPRESS | BFD_LINKER_CREATED \
461        | BFD_PLUGIN | BFD_TRADITIONAL_FORMAT | BFD_DETERMINISTIC_OUTPUT \
462        | BFD_COMPRESS_GABI | BFD_CONVERT_ELF_COMMON | BFD_USE_ELF_STT_COMMON \
463        | BFD_NO_SECTION_HEADER)
464
465       /* The format which belongs to the BFD. (object, core, etc.)  */
466       ENUM_BITFIELD (bfd_format) format : 3;
467
468       /* The direction with which the BFD was opened.  */
469       ENUM_BITFIELD (bfd_direction) direction : 2;
470
471       /* POSIX.1-2017 (IEEE Std 1003.1) says of fopen : "When a file is
472          opened with update mode ('+' as the second or third character in
473          the mode argument), both input and output may be performed on
474          the associated stream.  However, the application shall ensure
475          that output is not directly followed by input without an
476          intervening call to fflush() or to a file positioning function
477          (fseek(), fsetpos(), or rewind()), and input is not directly
478          followed by output without an intervening call to a file
479          positioning function, unless the input operation encounters
480          end-of-file."
481          This field tracks the last IO operation, so that bfd can insert
482          a seek when IO direction changes.  */
483       ENUM_BITFIELD (bfd_last_io) last_io : 2;
484
485       /* Is the file descriptor being cached?  That is, can it be closed as
486          needed, and re-opened when accessed later?  */
487       unsigned int cacheable : 1;
488
489       /* Marks whether there was a default target specified when the
490          BFD was opened. This is used to select which matching algorithm
491          to use to choose the back end.  */
492       unsigned int target_defaulted : 1;
493
494       /* ... and here: (``once'' means at least once).  */
495       unsigned int opened_once : 1;
496
497       /* Set if we have a locally maintained mtime value, rather than
498          getting it from the file each time.  */
499       unsigned int mtime_set : 1;
500
501       /* Flag set if symbols from this BFD should not be exported.  */
502       unsigned int no_export : 1;
503
504       /* Remember when output has begun, to stop strange things
505          from happening.  */
506       unsigned int output_has_begun : 1;
507
508       /* Have archive map.  */
509       unsigned int has_armap : 1;
510
511       /* Set if this is a thin archive.  */
512       unsigned int is_thin_archive : 1;
513
514       /* Set if this archive should not cache element positions.  */
515       unsigned int no_element_cache : 1;
516
517       /* Set if only required symbols should be added in the link hash table for
518          this object.  Used by VMS linkers.  */
519       unsigned int selective_search : 1;
520
521       /* Set if this is the linker output BFD.  */
522       unsigned int is_linker_output : 1;
523
524       /* Set if this is the linker input BFD.  */
525       unsigned int is_linker_input : 1;
526
527       /* If this is an input for a compiler plug-in library.  */
528       ENUM_BITFIELD (bfd_plugin_format) plugin_format : 2;
529
530       /* Set if this is a plugin output file.  */
531       unsigned int lto_output : 1;
532
533       /* Set if this is a slim LTO object not loaded with a compiler plugin.  */
534       unsigned int lto_slim_object : 1;
535
536       /* Do not attempt to modify this file.  Set when detecting errors
537          that BFD is not prepared to handle for objcopy/strip.  */
538       unsigned int read_only : 1;
539
540       /* Set to dummy BFD created when claimed by a compiler plug-in
541          library.  */
542       bfd *plugin_dummy_bfd;
543
544       /* The offset of this bfd in the file, typically 0 if it is not
545          contained in an archive.  */
546       ufile_ptr origin;
547
548       /* The origin in the archive of the proxy entry.  This will
549          normally be the same as origin, except for thin archives,
550          when it will contain the current offset of the proxy in the
551          thin archive rather than the offset of the bfd in its actual
552          container.  */
553       ufile_ptr proxy_origin;
554
555       /* A hash table for section names.  */
556       struct bfd_hash_table section_htab;
557
558       /* Pointer to linked list of sections.  */
559       struct bfd_section *sections;
560
561       /* The last section on the section list.  */
562       struct bfd_section *section_last;
563
564       /* The number of sections.  */
565       unsigned int section_count;
566
567       /* The archive plugin file descriptor.  */
568       int archive_plugin_fd;
569
570       /* The number of opens on the archive plugin file descriptor.  */
571       unsigned int archive_plugin_fd_open_count;
572
573       /* A field used by _bfd_generic_link_add_archive_symbols.  This will
574          be used only for archive elements.  */
575       int archive_pass;
576
577       /* The total size of memory from bfd_alloc.  */
578       bfd_size_type alloc_size;
579
580       /* Stuff only useful for object files:
581          The start address.  */
582       bfd_vma start_address;
583
584       /* Symbol table for output BFD (with symcount entries).
585          Also used by the linker to cache input BFD symbols.  */
586       struct bfd_symbol **outsymbols;
587
588       /* Used for input and output.  */
589       unsigned int symcount;
590
591       /* Used for slurped dynamic symbol tables.  */
592       unsigned int dynsymcount;
593
594       /* Pointer to structure which contains architecture information.  */
595       const struct bfd_arch_info *arch_info;
596
597       /* Cached length of file for bfd_get_size.  0 until bfd_get_size is
598          called, 1 if stat returns an error or the file size is too large to
599          return in ufile_ptr.  Both 0 and 1 should be treated as "unknown".  */
600       ufile_ptr size;
601
602       /* Stuff only useful for archives.  */
603       void *arelt_data;
604       struct bfd *my_archive;      /* The containing archive BFD.  */
605       struct bfd *archive_next;    /* The next BFD in the archive.  */
606       struct bfd *archive_head;    /* The first BFD in the archive.  */
607       struct bfd *nested_archives; /* List of nested archive in a flattened
608                                       thin archive.  */
609
610       union {
611         /* For input BFDs, a chain of BFDs involved in a link.  */
612         struct bfd *next;
613         /* For output BFD, the linker hash table.  */
614         struct bfd_link_hash_table *hash;
615       } link;
616
617       /* Used by the back end to hold private data.  */
618       union
619         {
620           struct aout_data_struct *aout_data;
621           struct artdata *aout_ar_data;
622           struct coff_tdata *coff_obj_data;
623           struct pe_tdata *pe_obj_data;
624           struct xcoff_tdata *xcoff_obj_data;
625           struct ecoff_tdata *ecoff_obj_data;
626           struct srec_data_struct *srec_data;
627           struct verilog_data_struct *verilog_data;
628           struct ihex_data_struct *ihex_data;
629           struct tekhex_data_struct *tekhex_data;
630           struct elf_obj_tdata *elf_obj_data;
631           struct mmo_data_struct *mmo_data;
632           struct trad_core_struct *trad_core_data;
633           struct som_data_struct *som_data;
634           struct hpux_core_struct *hpux_core_data;
635           struct hppabsd_core_struct *hppabsd_core_data;
636           struct sgi_core_struct *sgi_core_data;
637           struct lynx_core_struct *lynx_core_data;
638           struct osf_core_struct *osf_core_data;
639           struct cisco_core_struct *cisco_core_data;
640           struct netbsd_core_struct *netbsd_core_data;
641           struct mach_o_data_struct *mach_o_data;
642           struct mach_o_fat_data_struct *mach_o_fat_data;
643           struct plugin_data_struct *plugin_data;
644           struct bfd_pef_data_struct *pef_data;
645           struct bfd_pef_xlib_data_struct *pef_xlib_data;
646           struct bfd_sym_data_struct *sym_data;
647           void *any;
648         }
649       tdata;
650
651       /* Used by the application to hold private data.  */
652       void *usrdata;
653
654       /* Where all the allocated stuff under this BFD goes.  This is a
655          struct objalloc *, but we use void * to avoid requiring the inclusion
656          of objalloc.h.  */
657       void *memory;
658
659       /* For input BFDs, the build ID, if the object has one. */
660       const struct bfd_build_id *build_id;
661     };
662
663
664
665File: bfd.info,  Node: Error reporting,  Next: Initialization,  Prev: typedef bfd,  Up: BFD front end
666
6672.2 Error reporting
668===================
669
670Most BFD functions return nonzero on success (check their individual
671documentation for precise semantics).  On an error, they call
672���bfd_set_error��� to set an error condition that callers can check by
673calling ���bfd_get_error���.  If that returns ���bfd_error_system_call���, then
674check ���errno���.
675
676   The easiest way to report a BFD error to the user is to use
677���bfd_perror���.
678
679   The BFD error is thread-local.
680
6812.2.1 Type ���bfd_error_type���
682---------------------------
683
684The values returned by ���bfd_get_error��� are defined by the enumerated
685type ���bfd_error_type���.
686
687     typedef enum bfd_error
688     {
689       bfd_error_no_error = 0,
690       bfd_error_system_call,
691       bfd_error_invalid_target,
692       bfd_error_wrong_format,
693       bfd_error_wrong_object_format,
694       bfd_error_invalid_operation,
695       bfd_error_no_memory,
696       bfd_error_no_symbols,
697       bfd_error_no_armap,
698       bfd_error_no_more_archived_files,
699       bfd_error_malformed_archive,
700       bfd_error_missing_dso,
701       bfd_error_file_not_recognized,
702       bfd_error_file_ambiguously_recognized,
703       bfd_error_no_contents,
704       bfd_error_nonrepresentable_section,
705       bfd_error_no_debug_section,
706       bfd_error_bad_value,
707       bfd_error_file_truncated,
708       bfd_error_file_too_big,
709       bfd_error_sorry,
710       bfd_error_on_input,
711       bfd_error_invalid_error_code
712     }
713     bfd_error_type;
714
715
7162.2.1.1 ���bfd_get_error���
717.......................
718
719 -- Function: bfd_error_type bfd_get_error (void);
720     Return the current BFD error condition.
721
7222.2.1.2 ���bfd_set_error���
723.......................
724
725 -- Function: void bfd_set_error (bfd_error_type error_tag);
726     Set the BFD error condition to be ERROR_TAG.
727
728     ERROR_TAG must not be bfd_error_on_input.  Use bfd_set_input_error
729     for input errors instead.
730
7312.2.1.3 ���bfd_set_input_error���
732.............................
733
734 -- Function: void bfd_set_input_error (bfd *input, bfd_error_type
735          error_tag);
736     Set the BFD error condition to be bfd_error_on_input.  INPUT is the
737     input bfd where the error occurred, and ERROR_TAG the
738     bfd_error_type error.
739
7402.2.1.4 ���bfd_errmsg���
741....................
742
743 -- Function: const char *bfd_errmsg (bfd_error_type error_tag);
744     Return a string describing the error ERROR_TAG, or the system error
745     if ERROR_TAG is ���bfd_error_system_call���.
746
7472.2.1.5 ���bfd_perror���
748....................
749
750 -- Function: void bfd_perror (const char *message);
751     Print to the standard error stream a string describing the last BFD
752     error that occurred, or the last system error if the last BFD error
753     was a system call failure.  If MESSAGE is non-NULL and non-empty,
754     the error string printed is preceded by MESSAGE, a colon, and a
755     space.  It is followed by a newline.
756
7572.2.1.6 ���_bfd_clear_error_data���
758...............................
759
760 -- Function: void _bfd_clear_error_data (void);
761     Free any data associated with the BFD error.
762
7632.2.1.7 ���bfd_asprintf���
764......................
765
766 -- Function: char *bfd_asprintf (const char *fmt, ...);
767     Primarily for error reporting, this function is like libiberty���s
768     xasprintf except that it can return NULL on no memory and the
769     returned string should not be freed.  Uses a thread-local malloc���d
770     buffer managed by libbfd, _bfd_error_buf.  Be aware that a call to
771     this function frees the result of any previous call.  bfd_errmsg
772     (bfd_error_on_input) also calls this function.
773
7742.2.2 BFD error handler
775-----------------------
776
777Some BFD functions want to print messages describing the problem.  They
778call a BFD error handler function.  This function may be overridden by
779the program.
780
781   The BFD error handler acts like vprintf.
782
783     typedef void (*bfd_error_handler_type) (const char *, va_list);
784
785
7862.2.2.1 ���_bfd_error_handler���
787............................
788
789 -- Function: void _bfd_error_handler (const char *fmt, ...)
790          ATTRIBUTE_PRINTF_1;
791     This is the default routine to handle BFD error messages.  Like
792     fprintf (stderr, ...), but also handles some extra format
793     specifiers.
794
795     %pA section name from section.  For group components, prints group
796     name too.  %pB file name from bfd.  For archive components, prints
797     archive too.
798
799     Beware: Only supports a maximum of 9 format arguments.
800
8012.2.2.2 ���bfd_set_error_handler���
802...............................
803
804 -- Function: bfd_error_handler_type bfd_set_error_handler
805          (bfd_error_handler_type);
806     Set the BFD error handler function.  Returns the previous function.
807
8082.2.2.3 ���_bfd_set_error_handler_caching���
809........................................
810
811 -- Function: bfd_error_handler_type _bfd_set_error_handler_caching (bfd
812          *);
813     Set the BFD error handler function to one that stores messages to
814     the per_xvec_warn array.  Returns the previous function.
815
8162.2.2.4 ���bfd_set_error_program_name���
817....................................
818
819 -- Function: void bfd_set_error_program_name (const char *);
820     Set the program name to use when printing a BFD error.  This is
821     printed before the error message followed by a colon and space.
822     The string must not be changed after it is passed to this function.
823
8242.2.2.5 ���_bfd_get_error_program_name���
825.....................................
826
827 -- Function: const char *_bfd_get_error_program_name (void);
828     Get the program name used when printing a BFD error.
829
8302.2.3 BFD assert handler
831------------------------
832
833If BFD finds an internal inconsistency, the bfd assert handler is called
834with information on the BFD version, BFD source file and line.  If this
835happens, most programs linked against BFD are expected to want to exit
836with an error, or mark the current BFD operation as failed, so it is
837recommended to override the default handler, which just calls
838_bfd_error_handler and continues.
839
840     typedef void (*bfd_assert_handler_type) (const char *bfd_formatmsg,
841                                              const char *bfd_version,
842                                              const char *bfd_file,
843                                              int bfd_line);
844
845
8462.2.3.1 ���bfd_set_assert_handler���
847................................
848
849 -- Function: bfd_assert_handler_type bfd_set_assert_handler
850          (bfd_assert_handler_type);
851     Set the BFD assert handler function.  Returns the previous
852     function.
853
854
855File: bfd.info,  Node: Initialization,  Next: Threading,  Prev: Error reporting,  Up: BFD front end
856
8572.2.3.2 ���bfd_init���
858..................
859
860 -- Function: unsigned int bfd_init (void);
861     This routine must be called before any other BFD function to
862     initialize magical internal data structures.  Returns a magic
863     number, which may be used to check that the bfd library is
864     configured as expected by users.
865          /* Value returned by bfd_init.  */
866          #define BFD_INIT_MAGIC (sizeof (struct bfd_section))
867
868
869
870File: bfd.info,  Node: Threading,  Next: Miscellaneous,  Prev: Initialization,  Up: BFD front end
871
8722.3 Threading
873=============
874
875BFD has limited support for thread-safety.  Most BFD globals are
876protected by locks, while the error-related globals are thread-local.  A
877given BFD cannot safely be used from two threads at the same time; it is
878up to the application to do any needed locking.  However, it is ok for
879different threads to work on different BFD objects at the same time.
880
8812.3.1 Thread functions.
882-----------------------
883
884     typedef bool (*bfd_lock_unlock_fn_type) (void *);
885
8862.3.1.1 ���bfd_thread_init���
887.........................
888
889 -- Function: bool bfd_thread_init (bfd_lock_unlock_fn_type lock,
890          bfd_lock_unlock_fn_type unlock, void *data);
891     Initialize BFD threading.  The functions passed in will be used to
892     lock and unlock global data structures.  This may only be called a
893     single time in a given process.  Returns true on success and false
894     on error.  DATA is passed verbatim to the lock and unlock
895     functions.  The lock and unlock functions should return true on
896     success, or set the BFD error and return false on failure.
897
8982.3.1.2 ���bfd_thread_cleanup���
899............................
900
901 -- Function: void bfd_thread_cleanup (void);
902     Clean up any thread-local state.  This should be called by a thread
903     that uses any BFD functions, before the thread exits.  It is fine
904     to call this multiple times, or to call it and then later call BFD
905     functions on the same thread again.
906
9072.3.1.3 ���bfd_lock���
908..................
909
910 -- Function: bool bfd_lock (void);
911     Acquire the global BFD lock, if needed.  Returns true on success,
912     false on error.
913
9142.3.1.4 ���bfd_unlock���
915....................
916
917 -- Function: bool bfd_unlock (void);
918     Release the global BFD lock, if needed.  Returns true on success,
919     false on error.
920
921
922File: bfd.info,  Node: Miscellaneous,  Next: Memory Usage,  Prev: Threading,  Up: BFD front end
923
9242.4 Miscellaneous
925=================
926
9272.4.1 Miscellaneous functions
928-----------------------------
929
9302.4.1.1 ���bfd_get_reloc_upper_bound���
931...................................
932
933 -- Function: long bfd_get_reloc_upper_bound (bfd *abfd, asection
934          *sect);
935     Return the number of bytes required to store the relocation
936     information associated with section SECT attached to bfd ABFD.  If
937     an error occurs, return -1.
938
9392.4.1.2 ���bfd_canonicalize_reloc���
940................................
941
942 -- Function: long bfd_canonicalize_reloc (bfd *abfd, asection *sec,
943          arelent **loc, asymbol **syms);
944     Call the back end associated with the open BFD ABFD and translate
945     the external form of the relocation information attached to SEC
946     into the internal canonical form.  Place the table into memory at
947     LOC, which has been preallocated, usually by a call to
948     ���bfd_get_reloc_upper_bound���.  Returns the number of relocs, or -1
949     on error.
950
951     The SYMS table is also needed for horrible internal magic reasons.
952
9532.4.1.3 ���bfd_set_reloc���
954.......................
955
956 -- Function: void bfd_set_reloc (bfd *abfd, asection *sec, arelent
957          **rel, unsigned int count);
958     Set the relocation pointer and count within section SEC to the
959     values REL and COUNT.  The argument ABFD is ignored.
960          #define bfd_set_reloc(abfd, asect, location, count) \
961                 BFD_SEND (abfd, _bfd_set_reloc, (abfd, asect, location, count))
962
9632.4.1.4 ���bfd_set_file_flags���
964............................
965
966 -- Function: bool bfd_set_file_flags (bfd *abfd, flagword flags);
967     Set the flag word in the BFD ABFD to the value FLAGS.
968
969     Possible errors are:
970
971        ��� ���bfd_error_wrong_format��� - The target bfd was not of object
972          format.
973        ��� ���bfd_error_invalid_operation��� - The target bfd was open for
974          reading.
975        ��� ���bfd_error_invalid_operation��� - The flag word contained a bit
976          which was not applicable to the type of file.  E.g., an
977          attempt was made to set the ���D_PAGED��� bit on a BFD format
978          which does not support demand paging.
979
9802.4.1.5 ���bfd_get_arch_size���
981...........................
982
983 -- Function: int bfd_get_arch_size (bfd *abfd);
984     Returns the normalized architecture address size, in bits, as
985     determined by the object file���s format.  By normalized, we mean
986     either 32 or 64.  For ELF, this information is included in the
987     header.  Use bfd_arch_bits_per_address for number of bits in the
988     architecture address.
989
990     Returns the arch size in bits if known, ���-1��� otherwise.
991
9922.4.1.6 ���bfd_get_sign_extend_vma���
993.................................
994
995 -- Function: int bfd_get_sign_extend_vma (bfd *abfd);
996     Indicates if the target architecture "naturally" sign extends an
997     address.  Some architectures implicitly sign extend address values
998     when they are converted to types larger than the size of an
999     address.  For instance, bfd_get_start_address() will return an
1000     address sign extended to fill a bfd_vma when this is the case.
1001
1002     Returns ���1��� if the target architecture is known to sign extend
1003     addresses, ���0��� if the target architecture is known to not sign
1004     extend addresses, and ���-1��� otherwise.
1005
10062.4.1.7 ���bfd_set_start_address���
1007...............................
1008
1009 -- Function: bool bfd_set_start_address (bfd *abfd, bfd_vma vma);
1010     Make VMA the entry point of output BFD ABFD.
1011
1012     Returns ���TRUE��� on success, ���FALSE��� otherwise.
1013
10142.4.1.8 ���bfd_get_gp_size���
1015.........................
1016
1017 -- Function: unsigned int bfd_get_gp_size (bfd *abfd);
1018     Return the maximum size of objects to be optimized using the GP
1019     register under MIPS ECOFF. This is typically set by the ���-G���
1020     argument to the compiler, assembler or linker.
1021
10222.4.1.9 ���bfd_set_gp_size���
1023.........................
1024
1025 -- Function: void bfd_set_gp_size (bfd *abfd, unsigned int i);
1026     Set the maximum size of objects to be optimized using the GP
1027     register under ECOFF or MIPS ELF. This is typically set by the ���-G���
1028     argument to the compiler, assembler or linker.
1029
10302.4.1.10 ���bfd_set_gp_value���
1031...........................
1032
1033 -- Function: void bfd_set_gp_value (bfd *abfd, bfd_vma v);
1034     Allow external access to the fucntion to set the GP value.  This is
1035     specifically added for gdb-compile support.
1036
10372.4.1.11 ���bfd_scan_vma���
1038.......................
1039
1040 -- Function: bfd_vma bfd_scan_vma (const char *string, const char
1041          **end, int base);
1042     Convert, like ���strtoul��� or ���stdtoull���depending on the size of a
1043     ���bfd_vma���, a numerical expression STRING into a ���bfd_vma��� integer,
1044     and return that integer.
1045
10462.4.1.12 ���bfd_copy_private_header_data���
1047.......................................
1048
1049 -- Function: bool bfd_copy_private_header_data (bfd *ibfd, bfd *obfd);
1050     Copy private BFD header information from the BFD IBFD to the the
1051     BFD OBFD.  This copies information that may require sections to
1052     exist, but does not require symbol tables.  Return ���true��� on
1053     success, ���false��� on error.  Possible error returns are:
1054
1055        ��� ���bfd_error_no_memory��� - Not enough memory exists to create
1056          private data for OBFD.
1057          #define bfd_copy_private_header_data(ibfd, obfd) \
1058                 BFD_SEND (obfd, _bfd_copy_private_header_data, \
1059                           (ibfd, obfd))
1060
10612.4.1.13 ���bfd_copy_private_bfd_data���
1062....................................
1063
1064 -- Function: bool bfd_copy_private_bfd_data (bfd *ibfd, bfd *obfd);
1065     Copy private BFD information from the BFD IBFD to the the BFD OBFD.
1066     Return ���TRUE��� on success, ���FALSE��� on error.  Possible error returns
1067     are:
1068
1069        ��� ���bfd_error_no_memory��� - Not enough memory exists to create
1070          private data for OBFD.
1071          #define bfd_copy_private_bfd_data(ibfd, obfd) \
1072                 BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
1073                           (ibfd, obfd))
1074
10752.4.1.14 ���bfd_set_private_flags���
1076................................
1077
1078 -- Function: bool bfd_set_private_flags (bfd *abfd, flagword flags);
1079     Set private BFD flag information in the BFD ABFD.  Return ���TRUE��� on
1080     success, ���FALSE��� on error.  Possible error returns are:
1081
1082        ��� ���bfd_error_no_memory��� - Not enough memory exists to create
1083          private data for OBFD.
1084          #define bfd_set_private_flags(abfd, flags) \
1085                 BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags))
1086
10872.4.1.15 ���Other functions���
1088..........................
1089
1090The following functions exist but have not yet been documented.
1091     #define bfd_sizeof_headers(abfd, info) \
1092            BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, info))
1093
1094     #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1095            BFD_SEND (abfd, _bfd_find_nearest_line, \
1096                      (abfd, syms, sec, off, file, func, line, NULL))
1097
1098     #define bfd_find_nearest_line_with_alt(abfd, alt_filename, sec, syms, off, \
1099                                            file, func, line, disc) \
1100            BFD_SEND (abfd, _bfd_find_nearest_line_with_alt, \
1101                      (abfd, alt_filename, syms, sec, off, file, func, line, disc))
1102
1103     #define bfd_find_nearest_line_discriminator(abfd, sec, syms, off, file, func, \
1104                                                line, disc) \
1105            BFD_SEND (abfd, _bfd_find_nearest_line, \
1106                      (abfd, syms, sec, off, file, func, line, disc))
1107
1108     #define bfd_find_line(abfd, syms, sym, file, line) \
1109            BFD_SEND (abfd, _bfd_find_line, \
1110                      (abfd, syms, sym, file, line))
1111
1112     #define bfd_find_inliner_info(abfd, file, func, line) \
1113            BFD_SEND (abfd, _bfd_find_inliner_info, \
1114                      (abfd, file, func, line))
1115
1116     #define bfd_debug_info_start(abfd) \
1117            BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1118
1119     #define bfd_debug_info_end(abfd) \
1120            BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1121
1122     #define bfd_debug_info_accumulate(abfd, section) \
1123            BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1124
1125     #define bfd_stat_arch_elt(abfd, stat) \
1126            BFD_SEND (abfd->my_archive ? abfd->my_archive : abfd, \
1127                      _bfd_stat_arch_elt, (abfd, stat))
1128
1129     #define bfd_update_armap_timestamp(abfd) \
1130            BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
1131
1132     #define bfd_set_arch_mach(abfd, arch, mach)\
1133            BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
1134
1135     #define bfd_relax_section(abfd, section, link_info, again) \
1136            BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
1137
1138     #define bfd_gc_sections(abfd, link_info) \
1139            BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info))
1140
1141     #define bfd_lookup_section_flags(link_info, flag_info, section) \
1142            BFD_SEND (abfd, _bfd_lookup_section_flags, (link_info, flag_info, section))
1143
1144     #define bfd_merge_sections(abfd, link_info) \
1145            BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info))
1146
1147     #define bfd_is_group_section(abfd, sec) \
1148            BFD_SEND (abfd, _bfd_is_group_section, (abfd, sec))
1149
1150     #define bfd_group_name(abfd, sec) \
1151            BFD_SEND (abfd, _bfd_group_name, (abfd, sec))
1152
1153     #define bfd_discard_group(abfd, sec) \
1154            BFD_SEND (abfd, _bfd_discard_group, (abfd, sec))
1155
1156     #define bfd_link_hash_table_create(abfd) \
1157            BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
1158
1159     #define bfd_link_add_symbols(abfd, info) \
1160            BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
1161
1162     #define bfd_link_just_syms(abfd, sec, info) \
1163            BFD_SEND (abfd, _bfd_link_just_syms, (sec, info))
1164
1165     #define bfd_final_link(abfd, info) \
1166            BFD_SEND (abfd, _bfd_final_link, (abfd, info))
1167
1168     #define bfd_free_cached_info(abfd) \
1169            BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
1170
1171     #define bfd_get_dynamic_symtab_upper_bound(abfd) \
1172            BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
1173
1174     #define bfd_print_private_bfd_data(abfd, file)\
1175            BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
1176
1177     #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
1178            BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
1179
1180     #define bfd_get_synthetic_symtab(abfd, count, syms, dyncount, dynsyms, ret) \
1181            BFD_SEND (abfd, _bfd_get_synthetic_symtab, (abfd, count, syms, \
1182                                                        dyncount, dynsyms, ret))
1183
1184     #define bfd_get_dynamic_reloc_upper_bound(abfd) \
1185            BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
1186
1187     #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
1188            BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
1189
1190
11912.4.1.16 ���bfd_get_relocated_section_contents���
1192.............................................
1193
1194 -- Function: bfd_byte *bfd_get_relocated_section_contents (bfd *,
1195          struct bfd_link_info *, struct bfd_link_order *, bfd_byte *,
1196          bool, asymbol **);
1197     Read and relocate the indirect link_order section, into DATA (if
1198     non-NULL) or to a malloc���d buffer.  Return the buffer, or NULL on
1199     errors.
1200
12012.4.1.17 ���bfd_record_phdr���
1202..........................
1203
1204 -- Function: bool bfd_record_phdr (bfd *, unsigned long, bool,
1205          flagword, bool, bfd_vma, bool, bool, unsigned int, struct
1206          bfd_section **);
1207     Record information about an ELF program header.
1208
12092.4.1.18 ���bfd_sprintf_vma���
1210..........................
1211
1212 -- Function: void bfd_sprintf_vma (bfd *, char *, bfd_vma); void
1213          bfd_fprintf_vma (bfd *, void *, bfd_vma);
1214     bfd_sprintf_vma and bfd_fprintf_vma display an address in the
1215     target���s address size.
1216
12172.4.1.19 ���bfd_alt_mach_code���
1218............................
1219
1220 -- Function: bool bfd_alt_mach_code (bfd *abfd, int alternative);
1221     When more than one machine code number is available for the same
1222     machine type, this function can be used to switch between the
1223     preferred one (alternative == 0) and any others.  Currently, only
1224     ELF supports this feature, with up to two alternate machine codes.
1225
12262.4.1.20 ���bfd_emul_get_maxpagesize���
1227...................................
1228
1229 -- Function: bfd_vma bfd_emul_get_maxpagesize (const char *);
1230     Returns the maximum page size, in bytes, as determined by
1231     emulation.
1232
12332.4.1.21 ���bfd_emul_get_commonpagesize���
1234......................................
1235
1236 -- Function: bfd_vma bfd_emul_get_commonpagesize (const char *);
1237     Returns the common page size, in bytes, as determined by emulation.
1238
12392.4.1.22 ���bfd_demangle���
1240.......................
1241
1242 -- Function: char *bfd_demangle (bfd *, const char *, int);
1243     Wrapper around cplus_demangle.  Strips leading underscores and
1244     other such chars that would otherwise confuse the demangler.  If
1245     passed a g++ v3 ABI mangled name, returns a buffer allocated with
1246     malloc holding the demangled name.  Returns NULL otherwise and on
1247     memory alloc failure.
1248
12492.4.1.23 ���struct bfd_iovec���
1250...........................
1251
1252The ���struct bfd_iovec��� contains the internal file I/O class.  Each ���BFD���
1253has an instance of this class and all file I/O is routed through it (it
1254is assumed that the instance implements all methods listed below).
1255     struct bfd_iovec
1256     {
1257       /* To avoid problems with macros, a "b" rather than "f"
1258          prefix is prepended to each method name.  */
1259       /* Attempt to read/write NBYTES on ABFD's IOSTREAM storing/fetching
1260          bytes starting at PTR.  Return the number of bytes actually
1261          transfered (a read past end-of-file returns less than NBYTES),
1262          or -1 (setting bfd_error) if an error occurs.  */
1263       file_ptr (*bread) (struct bfd *abfd, void *ptr, file_ptr nbytes);
1264       file_ptr (*bwrite) (struct bfd *abfd, const void *ptr,
1265                           file_ptr nbytes);
1266       /* Return the current IOSTREAM file offset, or -1 (setting bfd_error
1267          if an error occurs.  */
1268       file_ptr (*btell) (struct bfd *abfd);
1269       /* For the following, on successful completion a value of 0 is returned.
1270          Otherwise, a value of -1 is returned (and bfd_error is set).  */
1271       int (*bseek) (struct bfd *abfd, file_ptr offset, int whence);
1272       int (*bclose) (struct bfd *abfd);
1273       int (*bflush) (struct bfd *abfd);
1274       int (*bstat) (struct bfd *abfd, struct stat *sb);
1275       /* Mmap a part of the files. ADDR, LEN, PROT, FLAGS and OFFSET are the usual
1276          mmap parameter, except that LEN and OFFSET do not need to be page
1277          aligned.  Returns (void *)-1 on failure, mmapped address on success.
1278          Also write in MAP_ADDR the address of the page aligned buffer and in
1279          MAP_LEN the size mapped (a page multiple).  Use unmap with MAP_ADDR and
1280          MAP_LEN to unmap.  */
1281       void *(*bmmap) (struct bfd *abfd, void *addr, bfd_size_type len,
1282                       int prot, int flags, file_ptr offset,
1283                       void **map_addr, bfd_size_type *map_len);
1284     };
1285     extern const struct bfd_iovec _bfd_memory_iovec;
1286
1287
12882.4.1.24 ���bfd_read���
1289...................
1290
1291 -- Function: bfd_size_type bfd_read (void *, bfd_size_type, bfd *)
1292          ATTRIBUTE_WARN_UNUSED_RESULT;
1293     Attempt to read SIZE bytes from ABFD���s iostream to PTR. Return the
1294     amount read.
1295
12962.4.1.25 ���bfd_write���
1297....................
1298
1299 -- Function: bfd_size_type bfd_write (const void *, bfd_size_type, bfd
1300          *) ATTRIBUTE_WARN_UNUSED_RESULT;
1301     Attempt to write SIZE bytes to ABFD���s iostream from PTR. Return the
1302     amount written.
1303
13042.4.1.26 ���bfd_tell���
1305...................
1306
1307 -- Function: file_ptr bfd_tell (bfd *) ATTRIBUTE_WARN_UNUSED_RESULT;
1308     Return ABFD���s iostream file position.
1309
13102.4.1.27 ���bfd_flush���
1311....................
1312
1313 -- Function: int bfd_flush (bfd *);
1314     Flush ABFD���s iostream pending IO.
1315
13162.4.1.28 ���bfd_stat���
1317...................
1318
1319 -- Function: int bfd_stat (bfd *, struct stat *)
1320          ATTRIBUTE_WARN_UNUSED_RESULT;
1321     Call fstat on ABFD���s iostream.  Return 0 on success, and a negative
1322     value on failure.
1323
13242.4.1.29 ���bfd_seek���
1325...................
1326
1327 -- Function: int bfd_seek (bfd *, file_ptr, int)
1328          ATTRIBUTE_WARN_UNUSED_RESULT;
1329     Call fseek on ABFD���s iostream.  Return 0 on success, and a negative
1330     value on failure.
1331
13322.4.1.30 ���bfd_get_mtime���
1333........................
1334
1335 -- Function: long bfd_get_mtime (bfd *abfd);
1336     Return the file modification time (as read from the file system, or
1337     from the archive header for archive members).
1338
13392.4.1.31 ���bfd_get_size���
1340.......................
1341
1342 -- Function: ufile_ptr bfd_get_size (bfd *abfd);
1343     Return the file size (as read from file system) for the file
1344     associated with BFD ABFD.
1345
1346     The initial motivation for, and use of, this routine is not so we
1347     can get the exact size of the object the BFD applies to, since that
1348     might not be generally possible (archive members for example).  It
1349     would be ideal if someone could eventually modify it so that such
1350     results were guaranteed.
1351
1352     Instead, we want to ask questions like "is this NNN byte sized
1353     object I���m about to try read from file offset YYY reasonable?"  As
1354     as example of where we might do this, some object formats use
1355     string tables for which the first ���sizeof (long)��� bytes of the
1356     table contain the size of the table itself, including the size
1357     bytes.  If an application tries to read what it thinks is one of
1358     these string tables, without some way to validate the size, and for
1359     some reason the size is wrong (byte swapping error, wrong location
1360     for the string table, etc.), the only clue is likely to be a read
1361     error when it tries to read the table, or a "virtual memory
1362     exhausted" error when it tries to allocate 15 bazillon bytes of
1363     space for the 15 bazillon byte table it is about to read.  This
1364     function at least allows us to answer the question, "is the size
1365     reasonable?".
1366
1367     A return value of zero indicates the file size is unknown.
1368
13692.4.1.32 ���bfd_get_file_size���
1370............................
1371
1372 -- Function: ufile_ptr bfd_get_file_size (bfd *abfd);
1373     Return the file size (as read from file system) for the file
1374     associated with BFD ABFD.  It supports both normal files and
1375     archive elements.
1376
13772.4.1.33 ���bfd_mmap���
1378...................
1379
1380 -- Function: void *bfd_mmap (bfd *abfd, void *addr, bfd_size_type len,
1381          int prot, int flags, file_ptr offset, void **map_addr,
1382          bfd_size_type *map_len) ATTRIBUTE_WARN_UNUSED_RESULT;
1383     Return mmap()ed region of the file, if possible and implemented.
1384     LEN and OFFSET do not need to be page aligned.  The page aligned
1385     address and length are written to MAP_ADDR and MAP_LEN.
1386
13872.4.1.34 ���bfd_get_current_time���
1388...............................
1389
1390 -- Function: time_t bfd_get_current_time (time_t now);
1391     Returns the current time.
1392
1393     If the environment variable SOURCE_DATE_EPOCH is defined then this
1394     is parsed and its value is returned.  Otherwise if the paramter NOW
1395     is non-zero, then that is returned.  Otherwise the result of the
1396     system call "time(NULL)" is returned.
1397
1398
1399File: bfd.info,  Node: Memory Usage,  Next: Sections,  Prev: Miscellaneous,  Up: BFD front end
1400
14012.5 Memory Usage
1402================
1403
1404BFD keeps all of its internal structures in obstacks.  There is one
1405obstack per open BFD file, into which the current state is stored.  When
1406a BFD is closed, the obstack is deleted, and so everything which has
1407been allocated by BFD for the closing file is thrown away.
1408
1409   BFD does not free anything created by an application, but pointers
1410into ���bfd��� structures become invalid on a ���bfd_close���; for example,
1411after a ���bfd_close��� the vector passed to ���bfd_canonicalize_symtab��� is
1412still around, since it has been allocated by the application, but the
1413data that it pointed to are lost.
1414
1415   The general rule is to not close a BFD until all operations dependent
1416upon data from the BFD have been completed, or all the data from within
1417the file has been copied.  To help with the management of memory, there
1418is a function (���bfd_alloc_size���) which returns the number of bytes in
1419obstacks associated with the supplied BFD. This could be used to select
1420the greediest open BFD, close it to reclaim the memory, perform some
1421operation and reopen the BFD again, to get a fresh copy of the data
1422structures.
1423
1424
1425File: bfd.info,  Node: Sections,  Next: Symbols,  Prev: Memory Usage,  Up: BFD front end
1426
14272.6 Sections
1428============
1429
1430The raw data contained within a BFD is maintained through the section
1431abstraction.  A single BFD may have any number of sections.  It keeps
1432hold of them by pointing to the first; each one points to the next in
1433the list.
1434
1435   Sections are supported in BFD in ���section.c���.
1436
1437* Menu:
1438
1439* Section Input::
1440* Section Output::
1441* typedef asection::
1442* section prototypes::
1443
1444
1445File: bfd.info,  Node: Section Input,  Next: Section Output,  Prev: Sections,  Up: Sections
1446
14472.6.1 Section input
1448-------------------
1449
1450When a BFD is opened for reading, the section structures are created and
1451attached to the BFD.
1452
1453   Each section has a name which describes the section in the outside
1454world���for example, ���a.out��� would contain at least three sections, called
1455���.text���, ���.data��� and ���.bss���.
1456
1457   Names need not be unique; for example a COFF file may have several
1458sections named ���.data���.
1459
1460   Sometimes a BFD will contain more than the ���natural��� number of
1461sections.  A back end may attach other sections containing constructor
1462data, or an application may add a section (using ���bfd_make_section���) to
1463the sections attached to an already open BFD. For example, the linker
1464creates an extra section ���COMMON��� for each input file���s BFD to hold
1465information about common storage.
1466
1467   The raw data is not necessarily read in when the section descriptor
1468is created.  Some targets may leave the data in place until a
1469���bfd_get_section_contents��� call is made.  Other back ends may read in
1470all the data at once.  For example, an S-record file has to be read once
1471to determine the size of the data.
1472
1473
1474File: bfd.info,  Node: Section Output,  Next: typedef asection,  Prev: Section Input,  Up: Sections
1475
14762.6.2 Section output
1477--------------------
1478
1479To write a new object style BFD, the various sections to be written have
1480to be created.  They are attached to the BFD in the same way as input
1481sections; data is written to the sections using
1482���bfd_set_section_contents���.
1483
1484   Any program that creates or combines sections (e.g., the assembler
1485and linker) must use the ���asection��� fields ���output_section��� and
1486���output_offset��� to indicate the file sections to which each section must
1487be written.  (If the section is being created from scratch,
1488���output_section��� should probably point to the section itself and
1489���output_offset��� should probably be zero.)
1490
1491   The data to be written comes from input sections attached (via
1492���output_section��� pointers) to the output sections.  The output section
1493structure can be considered a filter for the input section: the output
1494section determines the vma of the output data and the name, but the
1495input section determines the offset into the output section of the data
1496to be written.
1497
1498   E.g., to create a section "O", starting at 0x100, 0x123 long,
1499containing two subsections, "A" at offset 0x0 (i.e., at vma 0x100) and
1500"B" at offset 0x20 (i.e., at vma 0x120) the ���asection��� structures would
1501look like:
1502
1503        section name          "A"
1504          output_offset   0x00
1505          size            0x20
1506          output_section ----------->  section name    "O"
1507                                  |    vma             0x100
1508        section name          "B" |    size            0x123
1509          output_offset   0x20    |
1510          size            0x103   |
1511          output_section  --------|
1512
15132.6.3 Link orders
1514-----------------
1515
1516The data within a section is stored in a ���link_order���.  These are much
1517like the fixups in ���gas���.  The link_order abstraction allows a section
1518to grow and shrink within itself.
1519
1520   A link_order knows how big it is, and which is the next link_order
1521and where the raw data for it is; it also points to a list of
1522relocations which apply to it.
1523
1524   The link_order is used by the linker to perform relaxing on final
1525code.  The compiler creates code which is as big as necessary to make it
1526work without relaxing, and the user can select whether to relax.
1527Sometimes relaxing takes a lot of time.  The linker runs around the
1528relocations to see if any are attached to data which can be shrunk, if
1529so it does it on a link_order by link_order basis.
1530
1531
1532File: bfd.info,  Node: typedef asection,  Next: section prototypes,  Prev: Section Output,  Up: Sections
1533
15342.6.4 typedef asection
1535----------------------
1536
1537Here is the section structure:
1538
1539     typedef struct bfd_section
1540     {
1541       /* The name of the section; the name isn't a copy, the pointer is
1542          the same as that passed to bfd_make_section.  */
1543       const char *name;
1544
1545       /* The next section in the list belonging to the BFD, or NULL.  */
1546       struct bfd_section *next;
1547
1548       /* The previous section in the list belonging to the BFD, or NULL.  */
1549       struct bfd_section *prev;
1550
1551       /* A unique sequence number.  */
1552       unsigned int id;
1553
1554       /* A unique section number which can be used by assembler to
1555          distinguish different sections with the same section name.  */
1556       unsigned int section_id;
1557
1558       /* Which section in the bfd; 0..n-1 as sections are created in a bfd.  */
1559       unsigned int index;
1560
1561       /* The field flags contains attributes of the section. Some
1562          flags are read in from the object file, and some are
1563          synthesized from other information.  */
1564       flagword flags;
1565
1566     #define SEC_NO_FLAGS                      0x0
1567
1568       /* Tells the OS to allocate space for this section when loading.
1569          This is clear for a section containing debug information only.  */
1570     #define SEC_ALLOC                         0x1
1571
1572       /* Tells the OS to load the section from the file when loading.
1573          This is clear for a .bss section.  */
1574     #define SEC_LOAD                          0x2
1575
1576       /* The section contains data still to be relocated, so there is
1577          some relocation information too.  */
1578     #define SEC_RELOC                         0x4
1579
1580       /* A signal to the OS that the section contains read only data.  */
1581     #define SEC_READONLY                      0x8
1582
1583       /* The section contains code only.  */
1584     #define SEC_CODE                         0x10
1585
1586       /* The section contains data only.  */
1587     #define SEC_DATA                         0x20
1588
1589       /* The section will reside in ROM.  */
1590     #define SEC_ROM                          0x40
1591
1592       /* The section contains constructor information. This section
1593          type is used by the linker to create lists of constructors and
1594          destructors used by g++. When a back end sees a symbol
1595          which should be used in a constructor list, it creates a new
1596          section for the type of name (e.g., __CTOR_LIST__), attaches
1597          the symbol to it, and builds a relocation. To build the lists
1598          of constructors, all the linker has to do is catenate all the
1599          sections called __CTOR_LIST__ and relocate the data
1600          contained within - exactly the operations it would peform on
1601          standard data.  */
1602     #define SEC_CONSTRUCTOR                  0x80
1603
1604       /* The section has contents - a data section could be
1605          SEC_ALLOC | SEC_HAS_CONTENTS; a debug section could be
1606          SEC_HAS_CONTENTS  */
1607     #define SEC_HAS_CONTENTS                0x100
1608
1609       /* An instruction to the linker to not output the section
1610          even if it has information which would normally be written.  */
1611     #define SEC_NEVER_LOAD                  0x200
1612
1613       /* The section contains thread local data.  */
1614     #define SEC_THREAD_LOCAL                0x400
1615
1616       /* The section's size is fixed.  Generic linker code will not
1617          recalculate it and it is up to whoever has set this flag to
1618          get the size right.  */
1619     #define SEC_FIXED_SIZE                  0x800
1620
1621       /* The section contains common symbols (symbols may be defined
1622          multiple times, the value of a symbol is the amount of
1623          space it requires, and the largest symbol value is the one
1624          used).  Most targets have exactly one of these (which we
1625          translate to bfd_com_section_ptr), but ECOFF has two.  */
1626     #define SEC_IS_COMMON                  0x1000
1627
1628       /* The section contains only debugging information.  For
1629          example, this is set for ELF .debug and .stab sections.
1630          strip tests this flag to see if a section can be
1631          discarded.  */
1632     #define SEC_DEBUGGING                  0x2000
1633
1634       /* The contents of this section are held in memory pointed to
1635          by the contents field.  This is checked by bfd_get_section_contents,
1636          and the data is retrieved from memory if appropriate.  */
1637     #define SEC_IN_MEMORY                  0x4000
1638
1639       /* The contents of this section are to be excluded by the
1640          linker for executable and shared objects unless those
1641          objects are to be further relocated.  */
1642     #define SEC_EXCLUDE                    0x8000
1643
1644       /* The contents of this section are to be sorted based on the sum of
1645          the symbol and addend values specified by the associated relocation
1646          entries.  Entries without associated relocation entries will be
1647          appended to the end of the section in an unspecified order.  */
1648     #define SEC_SORT_ENTRIES              0x10000
1649
1650       /* When linking, duplicate sections of the same name should be
1651          discarded, rather than being combined into a single section as
1652          is usually done.  This is similar to how common symbols are
1653          handled.  See SEC_LINK_DUPLICATES below.  */
1654     #define SEC_LINK_ONCE                 0x20000
1655
1656       /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
1657          should handle duplicate sections.  */
1658     #define SEC_LINK_DUPLICATES           0xc0000
1659
1660       /* This value for SEC_LINK_DUPLICATES means that duplicate
1661          sections with the same name should simply be discarded.  */
1662     #define SEC_LINK_DUPLICATES_DISCARD       0x0
1663
1664       /* This value for SEC_LINK_DUPLICATES means that the linker
1665          should warn if there are any duplicate sections, although
1666          it should still only link one copy.  */
1667     #define SEC_LINK_DUPLICATES_ONE_ONLY  0x40000
1668
1669       /* This value for SEC_LINK_DUPLICATES means that the linker
1670          should warn if any duplicate sections are a different size.  */
1671     #define SEC_LINK_DUPLICATES_SAME_SIZE 0x80000
1672
1673       /* This value for SEC_LINK_DUPLICATES means that the linker
1674          should warn if any duplicate sections contain different
1675          contents.  */
1676     #define SEC_LINK_DUPLICATES_SAME_CONTENTS \
1677       (SEC_LINK_DUPLICATES_ONE_ONLY | SEC_LINK_DUPLICATES_SAME_SIZE)
1678
1679       /* This section was created by the linker as part of dynamic
1680          relocation or other arcane processing.  It is skipped when
1681          going through the first-pass output, trusting that someone
1682          else up the line will take care of it later.  */
1683     #define SEC_LINKER_CREATED           0x100000
1684
1685       /* This section contains a section ID to distinguish different
1686          sections with the same section name.  */
1687     #define SEC_ASSEMBLER_SECTION_ID     0x100000
1688
1689       /* This section should not be subject to garbage collection.
1690          Also set to inform the linker that this section should not be
1691          listed in the link map as discarded.  */
1692     #define SEC_KEEP                     0x200000
1693
1694       /* This section contains "short" data, and should be placed
1695          "near" the GP.  */
1696     #define SEC_SMALL_DATA               0x400000
1697
1698       /* Attempt to merge identical entities in the section.
1699          Entity size is given in the entsize field.  */
1700     #define SEC_MERGE                    0x800000
1701
1702       /* If given with SEC_MERGE, entities to merge are zero terminated
1703          strings where entsize specifies character size instead of fixed
1704          size entries.  */
1705     #define SEC_STRINGS                 0x1000000
1706
1707       /* This section contains data about section groups.  */
1708     #define SEC_GROUP                   0x2000000
1709
1710       /* The section is a COFF shared library section.  This flag is
1711          only for the linker.  If this type of section appears in
1712          the input file, the linker must copy it to the output file
1713          without changing the vma or size.  FIXME: Although this
1714          was originally intended to be general, it really is COFF
1715          specific (and the flag was renamed to indicate this).  It
1716          might be cleaner to have some more general mechanism to
1717          allow the back end to control what the linker does with
1718          sections.  */
1719     #define SEC_COFF_SHARED_LIBRARY     0x4000000
1720
1721       /* This input section should be copied to output in reverse order
1722          as an array of pointers.  This is for ELF linker internal use
1723          only.  */
1724     #define SEC_ELF_REVERSE_COPY        0x4000000
1725
1726       /* This section contains data which may be shared with other
1727          executables or shared objects. This is for COFF only.  */
1728     #define SEC_COFF_SHARED             0x8000000
1729
1730       /* Indicate that section has the purecode flag set.  */
1731     #define SEC_ELF_PURECODE            0x8000000
1732
1733       /* When a section with this flag is being linked, then if the size of
1734          the input section is less than a page, it should not cross a page
1735          boundary.  If the size of the input section is one page or more,
1736          it should be aligned on a page boundary.  This is for TI
1737          TMS320C54X only.  */
1738     #define SEC_TIC54X_BLOCK           0x10000000
1739
1740       /* This section has the SHF_X86_64_LARGE flag.  This is ELF x86-64 only.  */
1741     #define SEC_ELF_LARGE              0x10000000
1742
1743       /* Conditionally link this section; do not link if there are no
1744          references found to any symbol in the section.  This is for TI
1745          TMS320C54X only.  */
1746     #define SEC_TIC54X_CLINK           0x20000000
1747
1748       /* This section contains vliw code.  This is for Toshiba MeP only.  */
1749     #define SEC_MEP_VLIW               0x20000000
1750
1751       /* All symbols, sizes and relocations in this section are octets
1752          instead of bytes.  Required for DWARF debug sections as DWARF
1753          information is organized in octets, not bytes.  */
1754     #define SEC_ELF_OCTETS             0x40000000
1755
1756       /* Indicate that section has the no read flag set. This happens
1757          when memory read flag isn't set. */
1758     #define SEC_COFF_NOREAD            0x40000000
1759
1760       /*  End of section flags.  */
1761
1762       /* Some internal packed boolean fields.  */
1763
1764       /* See the vma field.  */
1765       unsigned int user_set_vma : 1;
1766
1767       /* A mark flag used by some of the linker backends.  */
1768       unsigned int linker_mark : 1;
1769
1770       /* Another mark flag used by some of the linker backends.  Set for
1771          output sections that have an input section.  */
1772       unsigned int linker_has_input : 1;
1773
1774       /* Mark flag used by some linker backends for garbage collection.  */
1775       unsigned int gc_mark : 1;
1776
1777       /* Section compression status.  */
1778       unsigned int compress_status : 2;
1779     #define COMPRESS_SECTION_NONE    0
1780     #define COMPRESS_SECTION_DONE    1
1781     #define DECOMPRESS_SECTION_ZLIB  2
1782     #define DECOMPRESS_SECTION_ZSTD  3
1783
1784       /* The following flags are used by the ELF linker. */
1785
1786       /* Mark sections which have been allocated to segments.  */
1787       unsigned int segment_mark : 1;
1788
1789       /* Type of sec_info information.  */
1790       unsigned int sec_info_type:3;
1791     #define SEC_INFO_TYPE_NONE      0
1792     #define SEC_INFO_TYPE_STABS     1
1793     #define SEC_INFO_TYPE_MERGE     2
1794     #define SEC_INFO_TYPE_EH_FRAME  3
1795     #define SEC_INFO_TYPE_JUST_SYMS 4
1796     #define SEC_INFO_TYPE_TARGET    5
1797     #define SEC_INFO_TYPE_EH_FRAME_ENTRY 6
1798     #define SEC_INFO_TYPE_SFRAME  7
1799
1800       /* Nonzero if this section uses RELA relocations, rather than REL.  */
1801       unsigned int use_rela_p:1;
1802
1803       /* Bits used by various backends.  The generic code doesn't touch
1804          these fields.  */
1805
1806       unsigned int sec_flg0:1;
1807       unsigned int sec_flg1:1;
1808       unsigned int sec_flg2:1;
1809       unsigned int sec_flg3:1;
1810       unsigned int sec_flg4:1;
1811       unsigned int sec_flg5:1;
1812
1813       /* End of internal packed boolean fields.  */
1814
1815       /*  The virtual memory address of the section - where it will be
1816           at run time.  The symbols are relocated against this.  The
1817           user_set_vma flag is maintained by bfd; if it's not set, the
1818           backend can assign addresses (for example, in a.out, where
1819           the default address for .data is dependent on the specific
1820           target and various flags).  */
1821       bfd_vma vma;
1822
1823       /*  The load address of the section - where it would be in a
1824           rom image; really only used for writing section header
1825           information.  */
1826       bfd_vma lma;
1827
1828       /* The size of the section in *octets*, as it will be output.
1829          Contains a value even if the section has no contents (e.g., the
1830          size of .bss).  */
1831       bfd_size_type size;
1832
1833       /* For input sections, the original size on disk of the section, in
1834          octets.  This field should be set for any section whose size is
1835          changed by linker relaxation.  It is required for sections where
1836          the linker relaxation scheme doesn't cache altered section and
1837          reloc contents (stabs, eh_frame, SEC_MERGE, some coff relaxing
1838          targets), and thus the original size needs to be kept to read the
1839          section multiple times.  For output sections, rawsize holds the
1840          section size calculated on a previous linker relaxation pass.  */
1841       bfd_size_type rawsize;
1842
1843       /* The compressed size of the section in octets.  */
1844       bfd_size_type compressed_size;
1845
1846       /* If this section is going to be output, then this value is the
1847          offset in *bytes* into the output section of the first byte in the
1848          input section (byte ==> smallest addressable unit on the
1849          target).  In most cases, if this was going to start at the
1850          100th octet (8-bit quantity) in the output section, this value
1851          would be 100.  However, if the target byte size is 16 bits
1852          (bfd_octets_per_byte is "2"), this value would be 50.  */
1853       bfd_vma output_offset;
1854
1855       /* The output section through which to map on output.  */
1856       struct bfd_section *output_section;
1857
1858       /* If an input section, a pointer to a vector of relocation
1859          records for the data in this section.  */
1860       struct reloc_cache_entry *relocation;
1861
1862       /* If an output section, a pointer to a vector of pointers to
1863          relocation records for the data in this section.  */
1864       struct reloc_cache_entry **orelocation;
1865
1866       /* The number of relocation records in one of the above.  */
1867       unsigned reloc_count;
1868
1869       /* The alignment requirement of the section, as an exponent of 2 -
1870          e.g., 3 aligns to 2^3 (or 8).  */
1871       unsigned int alignment_power;
1872
1873       /* Information below is back end specific - and not always used
1874          or updated.  */
1875
1876       /* File position of section data.  */
1877       file_ptr filepos;
1878
1879       /* File position of relocation info.  */
1880       file_ptr rel_filepos;
1881
1882       /* File position of line data.  */
1883       file_ptr line_filepos;
1884
1885       /* Pointer to data for applications.  */
1886       void *userdata;
1887
1888       /* If the SEC_IN_MEMORY flag is set, this points to the actual
1889          contents.  */
1890       bfd_byte *contents;
1891
1892       /* Attached line number information.  */
1893       alent *lineno;
1894
1895       /* Number of line number records.  */
1896       unsigned int lineno_count;
1897
1898       /* Entity size for merging purposes.  */
1899       unsigned int entsize;
1900
1901       /* Points to the kept section if this section is a link-once section,
1902          and is discarded.  */
1903       struct bfd_section *kept_section;
1904
1905       /* When a section is being output, this value changes as more
1906          linenumbers are written out.  */
1907       file_ptr moving_line_filepos;
1908
1909       /* What the section number is in the target world.  */
1910       int target_index;
1911
1912       void *used_by_bfd;
1913
1914       /* If this is a constructor section then here is a list of the
1915          relocations created to relocate items within it.  */
1916       struct relent_chain *constructor_chain;
1917
1918       /* The BFD which owns the section.  */
1919       bfd *owner;
1920
1921       /* A symbol which points at this section only.  */
1922       struct bfd_symbol *symbol;
1923       struct bfd_symbol **symbol_ptr_ptr;
1924
1925       /* Early in the link process, map_head and map_tail are used to build
1926          a list of input sections attached to an output section.  Later,
1927          output sections use these fields for a list of bfd_link_order
1928          structs.  The linked_to_symbol_name field is for ELF assembler
1929          internal use.  */
1930       union {
1931         struct bfd_link_order *link_order;
1932         struct bfd_section *s;
1933         const char *linked_to_symbol_name;
1934       } map_head, map_tail;
1935
1936       /* Points to the output section this section is already assigned to,
1937          if any.  This is used when support for non-contiguous memory
1938          regions is enabled.  */
1939       struct bfd_section *already_assigned;
1940
1941       /* Explicitly specified section type, if non-zero.  */
1942       unsigned int type;
1943
1944     } asection;
1945
1946
1947
1948File: bfd.info,  Node: section prototypes,  Prev: typedef asection,  Up: Sections
1949
19502.6.5 Section prototypes
1951------------------------
1952
1953These are the functions exported by the section handling part of BFD.
1954
19552.6.5.1 ���bfd_section_list_clear���
1956................................
1957
1958 -- Function: void bfd_section_list_clear (bfd *);
1959     Clears the section list, and also resets the section count and hash
1960     table entries.
1961
19622.6.5.2 ���bfd_get_section_by_name���
1963.................................
1964
1965 -- Function: asection *bfd_get_section_by_name (bfd *abfd, const char
1966          *name);
1967     Return the most recently created section attached to ABFD named
1968     NAME.  Return NULL if no such section exists.
1969
19702.6.5.3 ���bfd_get_next_section_by_name���
1971......................................
1972
1973 -- Function: asection *bfd_get_next_section_by_name (bfd *ibfd,
1974          asection *sec);
1975     Given SEC is a section returned by ���bfd_get_section_by_name���,
1976     return the next most recently created section attached to the same
1977     BFD with the same name, or if no such section exists in the same
1978     BFD and IBFD is non-NULL, the next section with the same name in
1979     any input BFD following IBFD. Return NULL on finding no section.
1980
19812.6.5.4 ���bfd_get_linker_section���
1982................................
1983
1984 -- Function: asection *bfd_get_linker_section (bfd *abfd, const char
1985          *name);
1986     Return the linker created section attached to ABFD named NAME.
1987     Return NULL if no such section exists.
1988
19892.6.5.5 ���bfd_get_section_by_name_if���
1990....................................
1991
1992 -- Function: asection *bfd_get_section_by_name_if (bfd *abfd, const
1993          char *name, bool (*func) (bfd *abfd, asection *sect, void
1994          *obj), void *obj);
1995     Call the provided function FUNC for each section attached to the
1996     BFD ABFD whose name matches NAME, passing OBJ as an argument.  The
1997     function will be called as if by
1998
1999                 func (abfd, the_section, obj);
2000
2001     It returns the first section for which FUNC returns true, otherwise
2002     ���NULL���.
2003
20042.6.5.6 ���bfd_get_unique_section_name���
2005.....................................
2006
2007 -- Function: char *bfd_get_unique_section_name (bfd *abfd, const char
2008          *templat, int *count);
2009     Invent a section name that is unique in ABFD by tacking a dot and a
2010     digit suffix onto the original TEMPLAT.  If COUNT is non-NULL, then
2011     it specifies the first number tried as a suffix to generate a
2012     unique name.  The value pointed to by COUNT will be incremented in
2013     this case.
2014
20152.6.5.7 ���bfd_make_section_old_way���
2016..................................
2017
2018 -- Function: asection *bfd_make_section_old_way (bfd *abfd, const char
2019          *name);
2020     Create a new empty section called NAME and attach it to the end of
2021     the chain of sections for the BFD ABFD.  An attempt to create a
2022     section with a name which is already in use returns its pointer
2023     without changing the section chain.
2024
2025     It has the funny name since this is the way it used to be before it
2026     was rewritten....
2027
2028     Possible errors are:
2029
2030        ��� ���bfd_error_invalid_operation��� - If output has already started
2031          for this BFD.
2032        ��� ���bfd_error_no_memory��� - If memory allocation fails.
2033
20342.6.5.8 ���bfd_make_section_anyway_with_flags���
2035............................................
2036
2037 -- Function: asection *bfd_make_section_anyway_with_flags (bfd *abfd,
2038          const char *name, flagword flags);
2039     Create a new empty section called NAME and attach it to the end of
2040     the chain of sections for ABFD.  Create a new section even if there
2041     is already a section with that name.  Also set the attributes of
2042     the new section to the value FLAGS.
2043
2044     Return ���NULL��� and set ���bfd_error��� on error; possible errors are:
2045
2046        ��� ���bfd_error_invalid_operation��� - If output has already started
2047          for ABFD.
2048        ��� ���bfd_error_no_memory��� - If memory allocation fails.
2049
20502.6.5.9 ���bfd_make_section_anyway���
2051.................................
2052
2053 -- Function: asection *bfd_make_section_anyway (bfd *abfd, const char
2054          *name);
2055     Create a new empty section called NAME and attach it to the end of
2056     the chain of sections for ABFD.  Create a new section even if there
2057     is already a section with that name.
2058
2059     Return ���NULL��� and set ���bfd_error��� on error; possible errors are:
2060
2061        ��� ���bfd_error_invalid_operation��� - If output has already started
2062          for ABFD.
2063        ��� ���bfd_error_no_memory��� - If memory allocation fails.
2064
20652.6.5.10 ���bfd_make_section_with_flags���
2066......................................
2067
2068 -- Function: asection *bfd_make_section_with_flags (bfd *, const char
2069          *name, flagword flags);
2070     Like ���bfd_make_section_anyway���, but return ���NULL��� (without calling
2071     bfd_set_error ()) without changing the section chain if there is
2072     already a section named NAME.  Also set the attributes of the new
2073     section to the value FLAGS.  If there is an error, return ���NULL���
2074     and set ���bfd_error���.
2075
20762.6.5.11 ���bfd_make_section���
2077...........................
2078
2079 -- Function: asection *bfd_make_section (bfd *, const char *name);
2080     Like ���bfd_make_section_anyway���, but return ���NULL��� (without calling
2081     bfd_set_error ()) without changing the section chain if there is
2082     already a section named NAME.  If there is an error, return ���NULL���
2083     and set ���bfd_error���.
2084
20852.6.5.12 ���bfd_set_section_flags���
2086................................
2087
2088 -- Function: bool bfd_set_section_flags (asection *sec, flagword
2089          flags);
2090     Set the attributes of the section SEC to the value FLAGS.  Return
2091     ���TRUE��� on success, ���FALSE��� on error.  Possible error returns are:
2092
2093        ��� ���bfd_error_invalid_operation��� - The section cannot have one or
2094          more of the attributes requested.  For example, a .bss section
2095          in ���a.out��� may not have the ���SEC_HAS_CONTENTS��� field set.
2096
20972.6.5.13 ���bfd_rename_section���
2098.............................
2099
2100 -- Function: void bfd_rename_section (asection *sec, const char
2101          *newname);
2102     Rename section SEC to NEWNAME.
2103
21042.6.5.14 ���bfd_map_over_sections���
2105................................
2106
2107 -- Function: void bfd_map_over_sections (bfd *abfd, void (*func) (bfd
2108          *abfd, asection *sect, void *obj), void *obj);
2109     Call the provided function FUNC for each section attached to the
2110     BFD ABFD, passing OBJ as an argument.  The function will be called
2111     as if by
2112
2113                 func (abfd, the_section, obj);
2114
2115     This is the preferred method for iterating over sections; an
2116     alternative would be to use a loop:
2117
2118                    asection *p;
2119                    for (p = abfd->sections; p != NULL; p = p->next)
2120                       func (abfd, p, ...)
2121
21222.6.5.15 ���bfd_sections_find_if���
2123...............................
2124
2125 -- Function: asection *bfd_sections_find_if (bfd *abfd, bool
2126          (*operation) (bfd *abfd, asection *sect, void *obj), void
2127          *obj);
2128     Call the provided function OPERATION for each section attached to
2129     the BFD ABFD, passing OBJ as an argument.  The function will be
2130     called as if by
2131
2132                 operation (abfd, the_section, obj);
2133
2134     It returns the first section for which OPERATION returns true.
2135
21362.6.5.16 ���bfd_set_section_size���
2137...............................
2138
2139 -- Function: bool bfd_set_section_size (asection *sec, bfd_size_type
2140          val);
2141     Set SEC to the size VAL.  If the operation is ok, then ���TRUE��� is
2142     returned, else ���FALSE���.
2143
2144     Possible error returns:
2145
2146        ��� ���bfd_error_invalid_operation��� - Writing has started to the
2147          BFD, so setting the size is invalid.
2148
21492.6.5.17 ���bfd_set_section_contents���
2150...................................
2151
2152 -- Function: bool bfd_set_section_contents (bfd *abfd, asection
2153          *section, const void *data, file_ptr offset, bfd_size_type
2154          count);
2155     Sets the contents of the section SECTION in BFD ABFD to the data
2156     starting in memory at LOCATION.  The data is written to the output
2157     section starting at offset OFFSET for COUNT octets.
2158
2159     Normally ���TRUE��� is returned, but ���FALSE��� is returned if there was
2160     an error.  Possible error returns are:
2161
2162        ��� ���bfd_error_no_contents��� - The output section does not have the
2163          ���SEC_HAS_CONTENTS��� attribute, so nothing can be written to it.
2164        ��� ���bfd_error_bad_value��� - The section is unable to contain all
2165          of the data.
2166        ��� ���bfd_error_invalid_operation��� - The BFD is not writeable.
2167        ��� and some more too.
2168     This routine is front end to the back end function
2169     ���_bfd_set_section_contents���.
2170
21712.6.5.18 ���bfd_get_section_contents���
2172...................................
2173
2174 -- Function: bool bfd_get_section_contents (bfd *abfd, asection
2175          *section, void *location, file_ptr offset, bfd_size_type
2176          count);
2177     Read data from SECTION in BFD ABFD into memory starting at
2178     LOCATION.  The data is read at an offset of OFFSET from the start
2179     of the input section, and is read for COUNT bytes.
2180
2181     If the contents of a constructor with the ���SEC_CONSTRUCTOR��� flag
2182     set are requested or if the section does not have the
2183     ���SEC_HAS_CONTENTS��� flag set, then the LOCATION is filled with
2184     zeroes.  If no errors occur, ���TRUE��� is returned, else ���FALSE���.
2185
21862.6.5.19 ���bfd_malloc_and_get_section���
2187.....................................
2188
2189 -- Function: bool bfd_malloc_and_get_section (bfd *abfd, asection
2190          *section, bfd_byte **buf);
2191     Read all data from SECTION in BFD ABFD into a buffer, *BUF,
2192     malloc���d by this function.  Return ���true��� on success, ���false��� on
2193     failure in which case *BUF will be NULL.
2194
21952.6.5.20 ���bfd_copy_private_section_data���
2196........................................
2197
2198 -- Function: bool bfd_copy_private_section_data (bfd *ibfd, asection
2199          *isec, bfd *obfd, asection *osec);
2200     Copy private section information from ISEC in the BFD IBFD to the
2201     section OSEC in the BFD OBFD.  Return ���TRUE��� on success, ���FALSE��� on
2202     error.  Possible error returns are:
2203
2204        ��� ���bfd_error_no_memory��� - Not enough memory exists to create
2205          private data for OSEC.
2206          #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
2207                 BFD_SEND (obfd, _bfd_copy_private_section_data, \
2208                           (ibfd, isection, obfd, osection))
2209
22102.6.5.21 ���bfd_generic_is_group_section���
2211.......................................
2212
2213 -- Function: bool bfd_generic_is_group_section (bfd *, const asection
2214          *sec);
2215     Returns TRUE if SEC is a member of a group.
2216
22172.6.5.22 ���bfd_generic_group_name���
2218.................................
2219
2220 -- Function: const char *bfd_generic_group_name (bfd *, const asection
2221          *sec);
2222     Returns group name if SEC is a member of a group.
2223
22242.6.5.23 ���bfd_generic_discard_group���
2225....................................
2226
2227 -- Function: bool bfd_generic_discard_group (bfd *abfd, asection
2228          *group);
2229     Remove all members of GROUP from the output.
2230
22312.6.5.24 ���_bfd_section_size_insane���
2232...................................
2233
2234 -- Function: bool _bfd_section_size_insane (bfd *abfd, asection *sec);
2235     Returns true if the given section has a size that indicates it
2236     cannot be read from file.  Return false if the size is OK or* this
2237     function can���t say one way or the other.
2238
2239
2240File: bfd.info,  Node: Symbols,  Next: Archives,  Prev: Sections,  Up: BFD front end
2241
22422.7 Symbols
2243===========
2244
2245BFD tries to maintain as much symbol information as it can when it moves
2246information from file to file.  BFD passes information to applications
2247though the ���asymbol��� structure.  When the application requests the
2248symbol table, BFD reads the table in the native form and translates
2249parts of it into the internal format.  To maintain more than the
2250information passed to applications, some targets keep some information
2251���behind the scenes��� in a structure only the particular back end knows
2252about.  For example, the coff back end keeps the original symbol table
2253structure as well as the canonical structure when a BFD is read in.  On
2254output, the coff back end can reconstruct the output symbol table so
2255that no information is lost, even information unique to coff which BFD
2256doesn���t know or understand.  If a coff symbol table were read, but were
2257written through an a.out back end, all the coff specific information
2258would be lost.  The symbol table of a BFD is not necessarily read in
2259until a canonicalize request is made.  Then the BFD back end fills in a
2260table provided by the application with pointers to the canonical
2261information.  To output symbols, the application provides BFD with a
2262table of pointers to pointers to ���asymbol���s.  This allows applications
2263like the linker to output a symbol as it was read, since the ���behind the
2264scenes��� information will be still available.
2265* Menu:
2266
2267* Reading Symbols::
2268* Writing Symbols::
2269* Mini Symbols::
2270* typedef asymbol::
2271* symbol handling functions::
2272
2273
2274File: bfd.info,  Node: Reading Symbols,  Next: Writing Symbols,  Prev: Symbols,  Up: Symbols
2275
22762.7.1 Reading symbols
2277---------------------
2278
2279There are two stages to reading a symbol table from a BFD: allocating
2280storage, and the actual reading process.  This is an excerpt from an
2281application which reads the symbol table:
2282
2283              long storage_needed;
2284              asymbol **symbol_table;
2285              long number_of_symbols;
2286              long i;
2287
2288              storage_needed = bfd_get_symtab_upper_bound (abfd);
2289
2290              if (storage_needed < 0)
2291                FAIL
2292
2293              if (storage_needed == 0)
2294                return;
2295
2296              symbol_table = xmalloc (storage_needed);
2297                ...
2298              number_of_symbols =
2299                 bfd_canonicalize_symtab (abfd, symbol_table);
2300
2301              if (number_of_symbols < 0)
2302                FAIL
2303
2304              for (i = 0; i < number_of_symbols; i++)
2305                process_symbol (symbol_table[i]);
2306
2307   All storage for the symbols themselves is in an objalloc connected to
2308the BFD; it is freed when the BFD is closed.
2309
2310
2311File: bfd.info,  Node: Writing Symbols,  Next: Mini Symbols,  Prev: Reading Symbols,  Up: Symbols
2312
23132.7.2 Writing symbols
2314---------------------
2315
2316Writing of a symbol table is automatic when a BFD open for writing is
2317closed.  The application attaches a vector of pointers to pointers to
2318symbols to the BFD being written, and fills in the symbol count.  The
2319close and cleanup code reads through the table provided and performs all
2320the necessary operations.  The BFD output code must always be provided
2321with an ���owned��� symbol: one which has come from another BFD, or one
2322which has been created using ���bfd_make_empty_symbol���.  Here is an
2323example showing the creation of a symbol table with only one element:
2324
2325            #include "sysdep.h"
2326            #include "bfd.h"
2327            int main (void)
2328            {
2329              bfd *abfd;
2330              asymbol *ptrs[2];
2331              asymbol *new;
2332
2333              abfd = bfd_openw ("foo","a.out-sunos-big");
2334              bfd_set_format (abfd, bfd_object);
2335              new = bfd_make_empty_symbol (abfd);
2336              new->name = "dummy_symbol";
2337              new->section = bfd_make_section_old_way (abfd, ".text");
2338              new->flags = BSF_GLOBAL;
2339              new->value = 0x12345;
2340
2341              ptrs[0] = new;
2342              ptrs[1] = 0;
2343
2344              bfd_set_symtab (abfd, ptrs, 1);
2345              bfd_close (abfd);
2346              return 0;
2347            }
2348
2349            ./makesym
2350            nm foo
2351            00012345 A dummy_symbol
2352
2353   Many formats cannot represent arbitrary symbol information; for
2354instance, the ���a.out��� object format does not allow an arbitrary number
2355of sections.  A symbol pointing to a section which is not one of
2356���.text���, ���.data��� or ���.bss��� cannot be described.
2357
2358
2359File: bfd.info,  Node: Mini Symbols,  Next: typedef asymbol,  Prev: Writing Symbols,  Up: Symbols
2360
23612.7.3 Mini Symbols
2362------------------
2363
2364Mini symbols provide read-only access to the symbol table.  They use
2365less memory space, but require more time to access.  They can be useful
2366for tools like nm or objdump, which may have to handle symbol tables of
2367extremely large executables.
2368
2369   The ���bfd_read_minisymbols��� function will read the symbols into memory
2370in an internal form.  It will return a ���void *��� pointer to a block of
2371memory, a symbol count, and the size of each symbol.  The pointer is
2372allocated using ���malloc���, and should be freed by the caller when it is
2373no longer needed.
2374
2375   The function ���bfd_minisymbol_to_symbol��� will take a pointer to a
2376minisymbol, and a pointer to a structure returned by
2377���bfd_make_empty_symbol���, and return a ���asymbol��� structure.  The return
2378value may or may not be the same as the value from
2379���bfd_make_empty_symbol��� which was passed in.
2380
2381
2382File: bfd.info,  Node: typedef asymbol,  Next: symbol handling functions,  Prev: Mini Symbols,  Up: Symbols
2383
23842.7.4 typedef asymbol
2385---------------------
2386
2387An ���asymbol��� has the form:
2388
2389     typedef struct bfd_symbol
2390     {
2391       /* A pointer to the BFD which owns the symbol. This information
2392          is necessary so that a back end can work out what additional
2393          information (invisible to the application writer) is carried
2394          with the symbol.
2395
2396          This field is *almost* redundant, since you can use section->owner
2397          instead, except that some symbols point to the global sections
2398          bfd_{abs,com,und}_section.  This could be fixed by making
2399          these globals be per-bfd (or per-target-flavor).  FIXME.  */
2400       struct bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field.  */
2401
2402       /* The text of the symbol. The name is left alone, and not copied; the
2403          application may not alter it.  */
2404       const char *name;
2405
2406       /* The value of the symbol.  This really should be a union of a
2407          numeric value with a pointer, since some flags indicate that
2408          a pointer to another symbol is stored here.  */
2409       symvalue value;
2410
2411       /* Attributes of a symbol.  */
2412     #define BSF_NO_FLAGS            0
2413
2414       /* The symbol has local scope; static in C. The value
2415          is the offset into the section of the data.  */
2416     #define BSF_LOCAL               (1 << 0)
2417
2418       /* The symbol has global scope; initialized data in C. The
2419          value is the offset into the section of the data.  */
2420     #define BSF_GLOBAL              (1 << 1)
2421
2422       /* The symbol has global scope and is exported. The value is
2423          the offset into the section of the data.  */
2424     #define BSF_EXPORT              BSF_GLOBAL /* No real difference.  */
2425
2426       /* A normal C symbol would be one of:
2427          BSF_LOCAL, BSF_UNDEFINED or BSF_GLOBAL.  */
2428
2429       /* The symbol is a debugging record. The value has an arbitrary
2430          meaning, unless BSF_DEBUGGING_RELOC is also set.  */
2431     #define BSF_DEBUGGING           (1 << 2)
2432
2433       /* The symbol denotes a function entry point.  Used in ELF,
2434          perhaps others someday.  */
2435     #define BSF_FUNCTION            (1 << 3)
2436
2437       /* Used by the linker.  */
2438     #define BSF_KEEP                (1 << 5)
2439
2440       /* An ELF common symbol.  */
2441     #define BSF_ELF_COMMON          (1 << 6)
2442
2443       /* A weak global symbol, overridable without warnings by
2444          a regular global symbol of the same name.  */
2445     #define BSF_WEAK                (1 << 7)
2446
2447       /* This symbol was created to point to a section, e.g. ELF's
2448          STT_SECTION symbols.  */
2449     #define BSF_SECTION_SYM         (1 << 8)
2450
2451       /* The symbol used to be a common symbol, but now it is
2452          allocated.  */
2453     #define BSF_OLD_COMMON          (1 << 9)
2454
2455       /* In some files the type of a symbol sometimes alters its
2456          location in an output file - ie in coff a ISFCN symbol
2457          which is also C_EXT symbol appears where it was
2458          declared and not at the end of a section.  This bit is set
2459          by the target BFD part to convey this information.  */
2460     #define BSF_NOT_AT_END          (1 << 10)
2461
2462       /* Signal that the symbol is the label of constructor section.  */
2463     #define BSF_CONSTRUCTOR         (1 << 11)
2464
2465       /* Signal that the symbol is a warning symbol.  The name is a
2466          warning.  The name of the next symbol is the one to warn about;
2467          if a reference is made to a symbol with the same name as the next
2468          symbol, a warning is issued by the linker.  */
2469     #define BSF_WARNING             (1 << 12)
2470
2471       /* Signal that the symbol is indirect.  This symbol is an indirect
2472          pointer to the symbol with the same name as the next symbol.  */
2473     #define BSF_INDIRECT            (1 << 13)
2474
2475       /* BSF_FILE marks symbols that contain a file name.  This is used
2476          for ELF STT_FILE symbols.  */
2477     #define BSF_FILE                (1 << 14)
2478
2479       /* Symbol is from dynamic linking information.  */
2480     #define BSF_DYNAMIC             (1 << 15)
2481
2482       /* The symbol denotes a data object.  Used in ELF, and perhaps
2483          others someday.  */
2484     #define BSF_OBJECT              (1 << 16)
2485
2486       /* This symbol is a debugging symbol.  The value is the offset
2487          into the section of the data.  BSF_DEBUGGING should be set
2488          as well.  */
2489     #define BSF_DEBUGGING_RELOC     (1 << 17)
2490
2491       /* This symbol is thread local.  Used in ELF.  */
2492     #define BSF_THREAD_LOCAL        (1 << 18)
2493
2494       /* This symbol represents a complex relocation expression,
2495          with the expression tree serialized in the symbol name.  */
2496     #define BSF_RELC                (1 << 19)
2497
2498       /* This symbol represents a signed complex relocation expression,
2499          with the expression tree serialized in the symbol name.  */
2500     #define BSF_SRELC               (1 << 20)
2501
2502       /* This symbol was created by bfd_get_synthetic_symtab.  */
2503     #define BSF_SYNTHETIC           (1 << 21)
2504
2505       /* This symbol is an indirect code object.  Unrelated to BSF_INDIRECT.
2506          The dynamic linker will compute the value of this symbol by
2507          calling the function that it points to.  BSF_FUNCTION must
2508          also be also set.  */
2509     #define BSF_GNU_INDIRECT_FUNCTION (1 << 22)
2510       /* This symbol is a globally unique data object.  The dynamic linker
2511          will make sure that in the entire process there is just one symbol
2512          with this name and type in use.  BSF_OBJECT must also be set.  */
2513     #define BSF_GNU_UNIQUE          (1 << 23)
2514
2515       /* This section symbol should be included in the symbol table.  */
2516     #define BSF_SECTION_SYM_USED    (1 << 24)
2517
2518       flagword flags;
2519
2520       /* A pointer to the section to which this symbol is
2521          relative.  This will always be non NULL, there are special
2522          sections for undefined and absolute symbols.  */
2523       struct bfd_section *section;
2524
2525       /* Back end special data.  */
2526       union
2527         {
2528           void *p;
2529           bfd_vma i;
2530         }
2531       udata;
2532     }
2533     asymbol;
2534
2535
2536
2537File: bfd.info,  Node: symbol handling functions,  Prev: typedef asymbol,  Up: Symbols
2538
25392.7.5 Symbol handling functions
2540-------------------------------
2541
25422.7.5.1 ���bfd_get_symtab_upper_bound���
2543....................................
2544
2545Return the number of bytes required to store a vector of pointers to
2546���asymbols��� for all the symbols in the BFD ABFD, including a terminal
2547NULL pointer.  If there are no symbols in the BFD, then return 0.  If an
2548error occurs, return -1.
2549     #define bfd_get_symtab_upper_bound(abfd) \
2550            BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
2551
2552
25532.7.5.2 ���bfd_is_local_label���
2554............................
2555
2556 -- Function: bool bfd_is_local_label (bfd *abfd, asymbol *sym);
2557     Return TRUE if the given symbol SYM in the BFD ABFD is a compiler
2558     generated local label, else return FALSE.
2559
25602.7.5.3 ���bfd_is_local_label_name���
2561.................................
2562
2563 -- Function: bool bfd_is_local_label_name (bfd *abfd, const char
2564          *name);
2565     Return TRUE if a symbol with the name NAME in the BFD ABFD is a
2566     compiler generated local label, else return FALSE. This just checks
2567     whether the name has the form of a local label.
2568          #define bfd_is_local_label_name(abfd, name) \
2569                 BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
2570
2571
25722.7.5.4 ���bfd_is_target_special_symbol���
2573......................................
2574
2575 -- Function: bool bfd_is_target_special_symbol (bfd *abfd, asymbol
2576          *sym);
2577     Return TRUE iff a symbol SYM in the BFD ABFD is something special
2578     to the particular target represented by the BFD. Such symbols
2579     should normally not be mentioned to the user.
2580          #define bfd_is_target_special_symbol(abfd, sym) \
2581                 BFD_SEND (abfd, _bfd_is_target_special_symbol, (abfd, sym))
2582
2583
25842.7.5.5 ���bfd_canonicalize_symtab���
2585.................................
2586
2587Read the symbols from the BFD ABFD, and fills in the vector LOCATION
2588with pointers to the symbols and a trailing NULL. Return the actual
2589number of symbol pointers, not including the NULL.
2590     #define bfd_canonicalize_symtab(abfd, location) \
2591            BFD_SEND (abfd, _bfd_canonicalize_symtab, (abfd, location))
2592
2593
25942.7.5.6 ���bfd_set_symtab���
2595........................
2596
2597 -- Function: bool bfd_set_symtab (bfd *abfd, asymbol **location,
2598          unsigned int count);
2599     Arrange that when the output BFD ABFD is closed, the table LOCATION
2600     of COUNT pointers to symbols will be written.
2601
26022.7.5.7 ���bfd_print_symbol_vandf���
2603................................
2604
2605 -- Function: void bfd_print_symbol_vandf (bfd *abfd, void *file,
2606          asymbol *symbol);
2607     Print the value and flags of the SYMBOL supplied to the stream
2608     FILE.
2609
26102.7.5.8 ���bfd_make_empty_symbol���
2611...............................
2612
2613Create a new ���asymbol��� structure for the BFD ABFD and return a pointer
2614to it.
2615
2616   This routine is necessary because each back end has private
2617information surrounding the ���asymbol���.  Building your own ���asymbol��� and
2618pointing to it will not create the private information, and will cause
2619problems later on.
2620     #define bfd_make_empty_symbol(abfd) \
2621            BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
2622
2623
26242.7.5.9 ���_bfd_generic_make_empty_symbol���
2625........................................
2626
2627 -- Function: asymbol *_bfd_generic_make_empty_symbol (bfd *);
2628     Create a new ���asymbol��� structure for the BFD ABFD and return a
2629     pointer to it.  Used by core file routines, binary back-end and
2630     anywhere else where no private info is needed.
2631
26322.7.5.10 ���bfd_make_debug_symbol���
2633................................
2634
2635Create a new ���asymbol��� structure for the BFD ABFD, to be used as a
2636debugging symbol.
2637     #define bfd_make_debug_symbol(abfd) \
2638            BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd))
2639
2640
26412.7.5.11 ���bfd_decode_symclass���
2642..............................
2643
2644 -- Function: int bfd_decode_symclass (asymbol *symbol);
2645     Return a character corresponding to the symbol class of SYMBOL, or
2646     ���?��� for an unknown class.
2647
26482.7.5.12 ���bfd_is_undefined_symclass���
2649....................................
2650
2651 -- Function: bool bfd_is_undefined_symclass (int symclass);
2652     Returns non-zero if the class symbol returned by
2653     bfd_decode_symclass represents an undefined symbol.  Returns zero
2654     otherwise.
2655
26562.7.5.13 ���bfd_symbol_info���
2657..........................
2658
2659 -- Function: void bfd_symbol_info (asymbol *symbol, symbol_info *ret);
2660     Fill in the basic info about symbol that nm needs.  Additional info
2661     may be added by the back-ends after calling this function.
2662
26632.7.5.14 ���bfd_copy_private_symbol_data���
2664.......................................
2665
2666 -- Function: bool bfd_copy_private_symbol_data (bfd *ibfd, asymbol
2667          *isym, bfd *obfd, asymbol *osym);
2668     Copy private symbol information from ISYM in the BFD IBFD to the
2669     symbol OSYM in the BFD OBFD.  Return ���TRUE��� on success, ���FALSE��� on
2670     error.  Possible error returns are:
2671
2672        ��� ���bfd_error_no_memory��� - Not enough memory exists to create
2673          private data for OSEC.
2674          #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
2675                 BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
2676                           (ibfd, isymbol, obfd, osymbol))
2677
2678
2679
2680File: bfd.info,  Node: Archives,  Next: Formats,  Prev: Symbols,  Up: BFD front end
2681
26822.8 Archives
2683============
2684
2685An archive (or library) is just another BFD. It has a symbol table,
2686although there���s not much a user program will do with it.
2687
2688   The big difference between an archive BFD and an ordinary BFD is that
2689the archive doesn���t have sections.  Instead it has a chain of BFDs that
2690are considered its contents.  These BFDs can be manipulated like any
2691other.  The BFDs contained in an archive opened for reading will all be
2692opened for reading.  You may put either input or output BFDs into an
2693archive opened for output; they will be handled correctly when the
2694archive is closed.
2695
2696   Use ���bfd_openr_next_archived_file��� to step through the contents of an
2697archive opened for input.  You don���t have to read the entire archive if
2698you don���t want to!  Read it until you find what you want.
2699
2700   A BFD returned by ���bfd_openr_next_archived_file��� can be closed
2701manually with ���bfd_close���.  If you do not close it, then a second
2702iteration through the members of an archive may return the same BFD. If
2703you close the archive BFD, then all the member BFDs will automatically
2704be closed as well.
2705
2706   Archive contents of output BFDs are chained through the
2707���archive_next��� pointer in a BFD. The first one is findable through the
2708���archive_head��� slot of the archive.  Set it with ���bfd_set_archive_head���
2709(q.v.).  A given BFD may be in only one open output archive at a time.
2710
2711   As expected, the BFD archive code is more general than the archive
2712code of any given environment.  BFD archives may contain files of
2713different formats (e.g., a.out and coff) and even different
2714architectures.  You may even place archives recursively into archives!
2715
2716   This can cause unexpected confusion, since some archive formats are
2717more expressive than others.  For instance, Intel COFF archives can
2718preserve long filenames; SunOS a.out archives cannot.  If you move a
2719file from the first to the second format and back again, the filename
2720may be truncated.  Likewise, different a.out environments have different
2721conventions as to how they truncate filenames, whether they preserve
2722directory names in filenames, etc.  When interoperating with native
2723tools, be sure your files are homogeneous.
2724
2725   Beware: most of these formats do not react well to the presence of
2726spaces in filenames.  We do the best we can, but can���t always handle
2727this case due to restrictions in the format of archives.  Many Unix
2728utilities are braindead in regards to spaces and such in filenames
2729anyway, so this shouldn���t be much of a restriction.
2730
2731   Archives are supported in BFD in ���archive.c���.
2732
27332.8.1 Archive functions
2734-----------------------
2735
27362.8.1.1 ���bfd_get_next_mapent���
2737.............................
2738
2739 -- Function: symindex bfd_get_next_mapent (bfd *abfd, symindex
2740          previous, carsym **sym);
2741     Step through archive ABFD���s symbol table (if it has one).
2742     Successively update SYM with the next symbol���s information,
2743     returning that symbol���s (internal) index into the symbol table.
2744
2745     Supply ���BFD_NO_MORE_SYMBOLS��� as the PREVIOUS entry to get the first
2746     one; returns ���BFD_NO_MORE_SYMBOLS��� when you���ve already got the last
2747     one.
2748
2749     A ���carsym��� is a canonical archive symbol.  The only user-visible
2750     element is its name, a null-terminated string.
2751
27522.8.1.2 ���bfd_set_archive_head���
2753..............................
2754
2755 -- Function: bool bfd_set_archive_head (bfd *output, bfd *new_head);
2756     Set the head of the chain of BFDs contained in the archive OUTPUT
2757     to NEW_HEAD.
2758
27592.8.1.3 ���bfd_openr_next_archived_file���
2760......................................
2761
2762 -- Function: bfd *bfd_openr_next_archived_file (bfd *archive, bfd
2763          *previous);
2764     Provided a BFD, ARCHIVE, containing an archive and NULL, open an
2765     input BFD on the first contained element and returns that.
2766     Subsequent calls should pass the archive and the previous return
2767     value to return a created BFD to the next contained element.  NULL
2768     is returned when there are no more.  Note - if you want to process
2769     the bfd returned by this call be sure to call bfd_check_format() on
2770     it first.
2771
2772
2773File: bfd.info,  Node: Formats,  Next: Relocations,  Prev: Archives,  Up: BFD front end
2774
27752.9 File formats
2776================
2777
2778A format is a BFD concept of high level file contents type.  The formats
2779supported by BFD are:
2780
2781   ��� ���bfd_object���
2782   The BFD may contain data, symbols, relocations and debug info.
2783
2784   ��� ���bfd_archive���
2785   The BFD contains other BFDs and an optional index.
2786
2787   ��� ���bfd_core���
2788   The BFD contains the result of an executable core dump.
2789
27902.9.1 File format functions
2791---------------------------
2792
27932.9.1.1 ���bfd_check_format���
2794..........................
2795
2796 -- Function: bool bfd_check_format (bfd *abfd, bfd_format format);
2797     Verify if the file attached to the BFD ABFD is compatible with the
2798     format FORMAT (i.e., one of ���bfd_object���, ���bfd_archive��� or
2799     ���bfd_core���).
2800
2801     If the BFD has been set to a specific target before the call, only
2802     the named target and format combination is checked.  If the target
2803     has not been set, or has been set to ���default���, then all the known
2804     target backends is interrogated to determine a match.  If the
2805     default target matches, it is used.  If not, exactly one target
2806     must recognize the file, or an error results.
2807
2808     The function returns ���TRUE��� on success, otherwise ���FALSE��� with one
2809     of the following error codes:
2810
2811        ��� ���bfd_error_invalid_operation��� - if ���format��� is not one of
2812          ���bfd_object���, ���bfd_archive��� or ���bfd_core���.
2813
2814        ��� ���bfd_error_system_call��� - if an error occured during a read -
2815          even some file mismatches can cause bfd_error_system_calls.
2816
2817        ��� ���file_not_recognised��� - none of the backends recognised the
2818          file format.
2819
2820        ��� ���bfd_error_file_ambiguously_recognized��� - more than one
2821          backend recognised the file format.
2822
28232.9.1.2 ���bfd_check_format_matches���
2824..................................
2825
2826 -- Function: bool bfd_check_format_matches (bfd *abfd, bfd_format
2827          format, char ***matching);
2828     Like ���bfd_check_format���, except when it returns FALSE with
2829     ���bfd_errno��� set to ���bfd_error_file_ambiguously_recognized���.  In
2830     that case, if MATCHING is not NULL, it will be filled in with a
2831     NULL-terminated list of the names of the formats that matched,
2832     allocated with ���malloc���.  Then the user may choose a format and try
2833     again.
2834
2835     When done with the list that MATCHING points to, the caller should
2836     free it.
2837
28382.9.1.3 ���bfd_set_format���
2839........................
2840
2841 -- Function: bool bfd_set_format (bfd *abfd, bfd_format format);
2842     This function sets the file format of the BFD ABFD to the format
2843     FORMAT.  If the target set in the BFD does not support the format
2844     requested, the format is invalid, or the BFD is not open for
2845     writing, then an error occurs.
2846
28472.9.1.4 ���bfd_format_string���
2848...........................
2849
2850 -- Function: const char *bfd_format_string (bfd_format format);
2851     Return a pointer to a const string ���invalid���, ���object���, ���archive���,
2852     ���core���, or ���unknown���, depending upon the value of FORMAT.
2853
2854
2855File: bfd.info,  Node: Relocations,  Next: Core Files,  Prev: Formats,  Up: BFD front end
2856
28572.10 Relocations
2858================
2859
2860BFD maintains relocations in much the same way it maintains symbols:
2861they are left alone until required, then read in en-masse and translated
2862into an internal form.  A common routine ���bfd_perform_relocation��� acts
2863upon the canonical form to do the fixup.
2864
2865   Relocations are maintained on a per section basis, while symbols are
2866maintained on a per BFD basis.
2867
2868   All that a back end has to do to fit the BFD interface is to create a
2869���struct reloc_cache_entry��� for each relocation in a particular section,
2870and fill in the right bits of the structures.
2871
2872* Menu:
2873
2874* typedef arelent::
2875* howto manager::
2876
2877
2878File: bfd.info,  Node: typedef arelent,  Next: howto manager,  Prev: Relocations,  Up: Relocations
2879
28802.10.1 typedef arelent
2881----------------------
2882
2883This is the structure of a relocation entry:
2884
2885     struct reloc_cache_entry
2886     {
2887       /* A pointer into the canonical table of pointers.  */
2888       struct bfd_symbol **sym_ptr_ptr;
2889
2890       /* offset in section.  */
2891       bfd_size_type address;
2892
2893       /* addend for relocation value.  */
2894       bfd_vma addend;
2895
2896       /* Pointer to how to perform the required relocation.  */
2897       reloc_howto_type *howto;
2898
2899     };
2900
2901   Here is a description of each of the fields within an ���arelent���:
2902
2903   ��� ���sym_ptr_ptr���
2904   The symbol table pointer points to a pointer to the symbol associated
2905with the relocation request.  It is the pointer into the table returned
2906by the back end���s ���canonicalize_symtab��� action.  *Note Symbols::.  The
2907symbol is referenced through a pointer to a pointer so that tools like
2908the linker can fix up all the symbols of the same name by modifying only
2909one pointer.  The relocation routine looks in the symbol and uses the
2910base of the section the symbol is attached to and the value of the
2911symbol as the initial relocation offset.  If the symbol pointer is zero,
2912then the section provided is looked up.
2913
2914   ��� ���address���
2915   The ���address��� field gives the offset in bytes from the base of the
2916section data which owns the relocation record to the first byte of
2917relocatable information.  The actual data relocated will be relative to
2918this point; for example, a relocation type which modifies the bottom two
2919bytes of a four byte word would not touch the first byte pointed to in a
2920big endian world.
2921
2922   ��� ���addend���
2923   The ���addend��� is a value provided by the back end to be added (!)  to
2924the relocation offset.  Its interpretation is dependent upon the howto.
2925For example, on the 68k the code:
2926
2927             char foo[];
2928             main()
2929                     {
2930                     return foo[0x12345678];
2931                     }
2932
2933   Could be compiled into:
2934
2935             linkw fp,#-4
2936             moveb @#12345678,d0
2937             extbl d0
2938             unlk fp
2939             rts
2940
2941   This could create a reloc pointing to ���foo���, but leave the offset in
2942the data, something like:
2943
2944     RELOCATION RECORDS FOR [.text]:
2945     offset   type      value
2946     00000006 32        _foo
2947
2948     00000000 4e56 fffc          ; linkw fp,#-4
2949     00000004 1039 1234 5678     ; moveb @#12345678,d0
2950     0000000a 49c0               ; extbl d0
2951     0000000c 4e5e               ; unlk fp
2952     0000000e 4e75               ; rts
2953
2954   Using coff and an 88k, some instructions don���t have enough space in
2955them to represent the full address range, and pointers have to be loaded
2956in two parts.  So you���d get something like:
2957
2958             or.u     r13,r0,hi16(_foo+0x12345678)
2959             ld.b     r2,r13,lo16(_foo+0x12345678)
2960             jmp      r1
2961
2962   This should create two relocs, both pointing to ���_foo���, and with
29630x12340000 in their addend field.  The data would consist of:
2964
2965     RELOCATION RECORDS FOR [.text]:
2966     offset   type      value
2967     00000002 HVRT16    _foo+0x12340000
2968     00000006 LVRT16    _foo+0x12340000
2969
2970     00000000 5da05678           ; or.u r13,r0,0x5678
2971     00000004 1c4d5678           ; ld.b r2,r13,0x5678
2972     00000008 f400c001           ; jmp r1
2973
2974   The relocation routine digs out the value from the data, adds it to
2975the addend to get the original offset, and then adds the value of
2976���_foo���.  Note that all 32 bits have to be kept around somewhere, to cope
2977with carry from bit 15 to bit 16.
2978
2979   One further example is the sparc and the a.out format.  The sparc has
2980a similar problem to the 88k, in that some instructions don���t have room
2981for an entire offset, but on the sparc the parts are created in odd
2982sized lumps.  The designers of the a.out format chose to not use the
2983data within the section for storing part of the offset; all the offset
2984is kept within the reloc.  Anything in the data should be ignored.
2985
2986             save %sp,-112,%sp
2987             sethi %hi(_foo+0x12345678),%g2
2988             ldsb [%g2+%lo(_foo+0x12345678)],%i0
2989             ret
2990             restore
2991
2992   Both relocs contain a pointer to ���foo���, and the offsets contain junk.
2993
2994     RELOCATION RECORDS FOR [.text]:
2995     offset   type      value
2996     00000004 HI22      _foo+0x12345678
2997     00000008 LO10      _foo+0x12345678
2998
2999     00000000 9de3bf90     ; save %sp,-112,%sp
3000     00000004 05000000     ; sethi %hi(_foo+0),%g2
3001     00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
3002     0000000c 81c7e008     ; ret
3003     00000010 81e80000     ; restore
3004
3005   ��� ���howto���
3006   The ���howto��� field can be imagined as a relocation instruction.  It is
3007a pointer to a structure which contains information on what to do with
3008all of the other information in the reloc record and data section.  A
3009back end would normally have a relocation instruction set and turn
3010relocations into pointers to the correct structure on input - but it
3011would be possible to create each howto field on demand.
3012
30132.10.1.1 ���enum complain_overflow���
3014.................................
3015
3016Indicates what sort of overflow checking should be done when performing
3017a relocation.
3018
3019     enum complain_overflow
3020     {
3021       /* Do not complain on overflow.  */
3022       complain_overflow_dont,
3023
3024       /* Complain if the value overflows when considered as a signed
3025          number one bit larger than the field.  ie. A bitfield of N bits
3026          is allowed to represent -2**n to 2**n-1.  */
3027       complain_overflow_bitfield,
3028
3029       /* Complain if the value overflows when considered as a signed
3030          number.  */
3031       complain_overflow_signed,
3032
3033       /* Complain if the value overflows when considered as an
3034          unsigned number.  */
3035       complain_overflow_unsigned
3036     };
3037
3038
30392.10.1.2 ���reloc_howto_type���
3040...........................
3041
3042The ���reloc_howto_type��� is a structure which contains all the information
3043that libbfd needs to know to tie up a back end���s data.
3044
3045     struct reloc_howto_struct
3046     {
3047       /* The type field has mainly a documentary use - the back end can
3048          do what it wants with it, though normally the back end's idea of
3049          an external reloc number is stored in this field.  */
3050       unsigned int type;
3051
3052       /* The size of the item to be relocated in bytes.  */
3053       unsigned int size:4;
3054
3055       /* The number of bits in the field to be relocated.  This is used
3056          when doing overflow checking.  */
3057       unsigned int bitsize:7;
3058
3059       /* The value the final relocation is shifted right by.  This drops
3060          unwanted data from the relocation.  */
3061       unsigned int rightshift:6;
3062
3063       /* The bit position of the reloc value in the destination.
3064          The relocated value is left shifted by this amount.  */
3065       unsigned int bitpos:6;
3066
3067       /* What type of overflow error should be checked for when
3068          relocating.  */
3069       ENUM_BITFIELD (complain_overflow) complain_on_overflow:2;
3070
3071       /* The relocation value should be negated before applying.  */
3072       unsigned int negate:1;
3073
3074       /* The relocation is relative to the item being relocated.  */
3075       unsigned int pc_relative:1;
3076
3077       /* Some formats record a relocation addend in the section contents
3078          rather than with the relocation.  For ELF formats this is the
3079          distinction between USE_REL and USE_RELA (though the code checks
3080          for USE_REL == 1/0).  The value of this field is TRUE if the
3081          addend is recorded with the section contents; when performing a
3082          partial link (ld -r) the section contents (the data) will be
3083          modified.  The value of this field is FALSE if addends are
3084          recorded with the relocation (in arelent.addend); when performing
3085          a partial link the relocation will be modified.
3086          All relocations for all ELF USE_RELA targets should set this field
3087          to FALSE (values of TRUE should be looked on with suspicion).
3088          However, the converse is not true: not all relocations of all ELF
3089          USE_REL targets set this field to TRUE.  Why this is so is peculiar
3090          to each particular target.  For relocs that aren't used in partial
3091          links (e.g. GOT stuff) it doesn't matter what this is set to.  */
3092       unsigned int partial_inplace:1;
3093
3094       /* When some formats create PC relative instructions, they leave
3095          the value of the pc of the place being relocated in the offset
3096          slot of the instruction, so that a PC relative relocation can
3097          be made just by adding in an ordinary offset (e.g., sun3 a.out).
3098          Some formats leave the displacement part of an instruction
3099          empty (e.g., ELF); this flag signals the fact.  */
3100       unsigned int pcrel_offset:1;
3101
3102       /* Whether bfd_install_relocation should just install the addend,
3103          or should follow the practice of some older object formats and
3104          install a value including the symbol.  */
3105       unsigned int install_addend:1;
3106
3107       /* src_mask selects the part of the instruction (or data) to be used
3108          in the relocation sum.  If the target relocations don't have an
3109          addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
3110          dst_mask to extract the addend from the section contents.  If
3111          relocations do have an addend in the reloc, eg. ELF USE_RELA, this
3112          field should normally be zero.  Non-zero values for ELF USE_RELA
3113          targets should be viewed with suspicion as normally the value in
3114          the dst_mask part of the section contents should be ignored.  */
3115       bfd_vma src_mask;
3116
3117       /* dst_mask selects which parts of the instruction (or data) are
3118          replaced with a relocated value.  */
3119       bfd_vma dst_mask;
3120
3121       /* If this field is non null, then the supplied function is
3122          called rather than the normal function.  This allows really
3123          strange relocation methods to be accommodated.  */
3124       bfd_reloc_status_type (*special_function)
3125         (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
3126          bfd *, char **);
3127
3128       /* The textual name of the relocation type.  */
3129       const char *name;
3130     };
3131
3132
31332.10.1.3 ���The HOWTO Macro���
3134..........................
3135
3136The HOWTO macro fills in a reloc_howto_type (a typedef for const struct
3137reloc_howto_struct).
3138     #define HOWTO_INSTALL_ADDEND 0
3139     #define HOWTO_RSIZE(sz) ((sz) < 0 ? -(sz) : (sz))
3140     #define HOWTO(type, right, size, bits, pcrel, left, ovf, func, name,   \
3141                   inplace, src_mask, dst_mask, pcrel_off)                  \
3142       { (unsigned) type, HOWTO_RSIZE (size), bits, right, left, ovf,       \
3143         size < 0, pcrel, inplace, pcrel_off, HOWTO_INSTALL_ADDEND,         \
3144         src_mask, dst_mask, func, name }
3145
3146   This is used to fill in an empty howto entry in an array.
3147     #define EMPTY_HOWTO(C) \
3148       HOWTO ((C), 0, 1, 0, false, 0, complain_overflow_dont, NULL, \
3149              NULL, false, 0, 0, false)
3150
3151     static inline unsigned int
3152     bfd_get_reloc_size (reloc_howto_type *howto)
3153     {
3154       return howto->size;
3155     }
3156
3157
31582.10.1.4 ���arelent_chain���
3159........................
3160
3161How relocs are tied together in an ���asection���:
3162     typedef struct relent_chain
3163     {
3164       arelent relent;
3165       struct relent_chain *next;
3166     }
3167     arelent_chain;
3168
3169
31702.10.1.5 ���bfd_check_overflow���
3171.............................
3172
3173 -- Function: bfd_reloc_status_type bfd_check_overflow (enum
3174          complain_overflow how, unsigned int bitsize, unsigned int
3175          rightshift, unsigned int addrsize, bfd_vma relocation);
3176     Perform overflow checking on RELOCATION which has BITSIZE
3177     significant bits and will be shifted right by RIGHTSHIFT bits, on a
3178     machine with addresses containing ADDRSIZE significant bits.  The
3179     result is either of ���bfd_reloc_ok��� or ���bfd_reloc_overflow���.
3180
31812.10.1.6 ���bfd_reloc_offset_in_range���
3182....................................
3183
3184 -- Function: bool bfd_reloc_offset_in_range (reloc_howto_type *howto,
3185          bfd *abfd, asection *section, bfd_size_type offset);
3186     Returns TRUE if the reloc described by HOWTO can be applied at
3187     OFFSET octets in SECTION.
3188
31892.10.1.7 ���bfd_perform_relocation���
3190.................................
3191
3192 -- Function: bfd_reloc_status_type bfd_perform_relocation (bfd *abfd,
3193          arelent *reloc_entry, void *data, asection *input_section, bfd
3194          *output_bfd, char **error_message);
3195     If OUTPUT_BFD is supplied to this function, the generated image
3196     will be relocatable; the relocations are copied to the output file
3197     after they have been changed to reflect the new state of the world.
3198     There are two ways of reflecting the results of partial linkage in
3199     an output file: by modifying the output data in place, and by
3200     modifying the relocation record.  Some native formats (e.g., basic
3201     a.out and basic coff) have no way of specifying an addend in the
3202     relocation type, so the addend has to go in the output data.  This
3203     is no big deal since in these formats the output data slot will
3204     always be big enough for the addend.  Complex reloc types with
3205     addends were invented to solve just this problem.  The
3206     ERROR_MESSAGE argument is set to an error message if this return
3207     ���bfd_reloc_dangerous���.
3208
32092.10.1.8 ���bfd_install_relocation���
3210.................................
3211
3212 -- Function: bfd_reloc_status_type bfd_install_relocation (bfd *abfd,
3213          arelent *reloc_entry, void *data, bfd_vma data_start, asection
3214          *input_section, char **error_message);
3215     This looks remarkably like ���bfd_perform_relocation���, except it does
3216     not expect that the section contents have been filled in.  I.e.,
3217     it���s suitable for use when creating, rather than applying a
3218     relocation.
3219
3220     For now, this function should be considered reserved for the
3221     assembler.
3222
3223
3224File: bfd.info,  Node: howto manager,  Prev: typedef arelent,  Up: Relocations
3225
32262.10.2 The howto manager
3227------------------------
3228
3229When an application wants to create a relocation, but doesn���t know what
3230the target machine might call it, it can find out by using this bit of
3231code.
3232
32332.10.2.1 ���bfd_reloc_code_real_type���
3234...................................
3235
3236The insides of a reloc code.  The idea is that, eventually, there will
3237be one enumerator for every type of relocation we ever do.  Pass one of
3238these values to ���bfd_reloc_type_lookup���, and it���ll return a howto
3239pointer.
3240
3241   This does mean that the application must determine the correct
3242enumerator value; you can���t get a howto pointer from a random set of
3243attributes.
3244
3245   Here are the possible values for ���enum bfd_reloc_code_real���:
3246
3247 -- : BFD_RELOC_64
3248 -- : BFD_RELOC_32
3249 -- : BFD_RELOC_26
3250 -- : BFD_RELOC_24
3251 -- : BFD_RELOC_16
3252 -- : BFD_RELOC_14
3253 -- : BFD_RELOC_8
3254     Basic absolute relocations of N bits.
3255 -- : BFD_RELOC_64_PCREL
3256 -- : BFD_RELOC_32_PCREL
3257 -- : BFD_RELOC_24_PCREL
3258 -- : BFD_RELOC_16_PCREL
3259 -- : BFD_RELOC_12_PCREL
3260 -- : BFD_RELOC_8_PCREL
3261     PC-relative relocations.  Sometimes these are relative to the
3262     address of the relocation itself; sometimes they are relative to
3263     the start of the section containing the relocation.  It depends on
3264     the specific target.
3265 -- : BFD_RELOC_32_SECREL
3266 -- : BFD_RELOC_16_SECIDX
3267     Section relative relocations.  Some targets need this for DWARF2.
3268 -- : BFD_RELOC_32_GOT_PCREL
3269 -- : BFD_RELOC_16_GOT_PCREL
3270 -- : BFD_RELOC_8_GOT_PCREL
3271 -- : BFD_RELOC_32_GOTOFF
3272 -- : BFD_RELOC_16_GOTOFF
3273 -- : BFD_RELOC_LO16_GOTOFF
3274 -- : BFD_RELOC_HI16_GOTOFF
3275 -- : BFD_RELOC_HI16_S_GOTOFF
3276 -- : BFD_RELOC_8_GOTOFF
3277 -- : BFD_RELOC_64_PLT_PCREL
3278 -- : BFD_RELOC_32_PLT_PCREL
3279 -- : BFD_RELOC_24_PLT_PCREL
3280 -- : BFD_RELOC_16_PLT_PCREL
3281 -- : BFD_RELOC_8_PLT_PCREL
3282 -- : BFD_RELOC_64_PLTOFF
3283 -- : BFD_RELOC_32_PLTOFF
3284 -- : BFD_RELOC_16_PLTOFF
3285 -- : BFD_RELOC_LO16_PLTOFF
3286 -- : BFD_RELOC_HI16_PLTOFF
3287 -- : BFD_RELOC_HI16_S_PLTOFF
3288 -- : BFD_RELOC_8_PLTOFF
3289     For ELF.
3290 -- : BFD_RELOC_SIZE32
3291 -- : BFD_RELOC_SIZE64
3292     Size relocations.
3293 -- : BFD_RELOC_68K_GLOB_DAT
3294 -- : BFD_RELOC_68K_JMP_SLOT
3295 -- : BFD_RELOC_68K_RELATIVE
3296 -- : BFD_RELOC_68K_TLS_GD32
3297 -- : BFD_RELOC_68K_TLS_GD16
3298 -- : BFD_RELOC_68K_TLS_GD8
3299 -- : BFD_RELOC_68K_TLS_LDM32
3300 -- : BFD_RELOC_68K_TLS_LDM16
3301 -- : BFD_RELOC_68K_TLS_LDM8
3302 -- : BFD_RELOC_68K_TLS_LDO32
3303 -- : BFD_RELOC_68K_TLS_LDO16
3304 -- : BFD_RELOC_68K_TLS_LDO8
3305 -- : BFD_RELOC_68K_TLS_IE32
3306 -- : BFD_RELOC_68K_TLS_IE16
3307 -- : BFD_RELOC_68K_TLS_IE8
3308 -- : BFD_RELOC_68K_TLS_LE32
3309 -- : BFD_RELOC_68K_TLS_LE16
3310 -- : BFD_RELOC_68K_TLS_LE8
3311     Relocations used by 68K ELF.
3312 -- : BFD_RELOC_32_BASEREL
3313 -- : BFD_RELOC_16_BASEREL
3314 -- : BFD_RELOC_LO16_BASEREL
3315 -- : BFD_RELOC_HI16_BASEREL
3316 -- : BFD_RELOC_HI16_S_BASEREL
3317 -- : BFD_RELOC_8_BASEREL
3318 -- : BFD_RELOC_RVA
3319     Linkage-table relative.
3320 -- : BFD_RELOC_8_FFnn
3321     Absolute 8-bit relocation, but used to form an address like 0xFFnn.
3322 -- : BFD_RELOC_32_PCREL_S2
3323 -- : BFD_RELOC_16_PCREL_S2
3324 -- : BFD_RELOC_23_PCREL_S2
3325     These PC-relative relocations are stored as word displacements ���
3326     i.e., byte displacements shifted right two bits.  The 30-bit word
3327     displacement (<<32_PCREL_S2>> ��� 32 bits, shifted 2) is used on the
3328     SPARC. (SPARC tools generally refer to this as <<WDISP30>>.)  The
3329     signed 16-bit displacement is used on the MIPS, and the 23-bit
3330     displacement is used on the Alpha.
3331 -- : BFD_RELOC_HI22
3332 -- : BFD_RELOC_LO10
3333     High 22 bits and low 10 bits of 32-bit value, placed into lower
3334     bits of the target word.  These are used on the SPARC.
3335 -- : BFD_RELOC_GPREL16
3336 -- : BFD_RELOC_GPREL32
3337     For systems that allocate a Global Pointer register, these are
3338     displacements off that register.  These relocation types are
3339     handled specially, because the value the register will have is
3340     decided relatively late.
3341 -- : BFD_RELOC_NONE
3342 -- : BFD_RELOC_SPARC_WDISP22
3343 -- : BFD_RELOC_SPARC22
3344 -- : BFD_RELOC_SPARC13
3345 -- : BFD_RELOC_SPARC_GOT10
3346 -- : BFD_RELOC_SPARC_GOT13
3347 -- : BFD_RELOC_SPARC_GOT22
3348 -- : BFD_RELOC_SPARC_PC10
3349 -- : BFD_RELOC_SPARC_PC22
3350 -- : BFD_RELOC_SPARC_WPLT30
3351 -- : BFD_RELOC_SPARC_COPY
3352 -- : BFD_RELOC_SPARC_GLOB_DAT
3353 -- : BFD_RELOC_SPARC_JMP_SLOT
3354 -- : BFD_RELOC_SPARC_RELATIVE
3355 -- : BFD_RELOC_SPARC_UA16
3356 -- : BFD_RELOC_SPARC_UA32
3357 -- : BFD_RELOC_SPARC_UA64
3358 -- : BFD_RELOC_SPARC_GOTDATA_HIX22
3359 -- : BFD_RELOC_SPARC_GOTDATA_LOX10
3360 -- : BFD_RELOC_SPARC_GOTDATA_OP_HIX22
3361 -- : BFD_RELOC_SPARC_GOTDATA_OP_LOX10
3362 -- : BFD_RELOC_SPARC_GOTDATA_OP
3363 -- : BFD_RELOC_SPARC_JMP_IREL
3364 -- : BFD_RELOC_SPARC_IRELATIVE
3365     SPARC ELF relocations.  There is probably some overlap with other
3366     relocation types already defined.
3367 -- : BFD_RELOC_SPARC_BASE13
3368 -- : BFD_RELOC_SPARC_BASE22
3369     I think these are specific to SPARC a.out (e.g., Sun 4).
3370 -- : BFD_RELOC_SPARC_64
3371 -- : BFD_RELOC_SPARC_10
3372 -- : BFD_RELOC_SPARC_11
3373 -- : BFD_RELOC_SPARC_OLO10
3374 -- : BFD_RELOC_SPARC_HH22
3375 -- : BFD_RELOC_SPARC_HM10
3376 -- : BFD_RELOC_SPARC_LM22
3377 -- : BFD_RELOC_SPARC_PC_HH22
3378 -- : BFD_RELOC_SPARC_PC_HM10
3379 -- : BFD_RELOC_SPARC_PC_LM22
3380 -- : BFD_RELOC_SPARC_WDISP16
3381 -- : BFD_RELOC_SPARC_WDISP19
3382 -- : BFD_RELOC_SPARC_7
3383 -- : BFD_RELOC_SPARC_6
3384 -- : BFD_RELOC_SPARC_5
3385 -- : BFD_RELOC_SPARC_DISP64
3386 -- : BFD_RELOC_SPARC_PLT32
3387 -- : BFD_RELOC_SPARC_PLT64
3388 -- : BFD_RELOC_SPARC_HIX22
3389 -- : BFD_RELOC_SPARC_LOX10
3390 -- : BFD_RELOC_SPARC_H44
3391 -- : BFD_RELOC_SPARC_M44
3392 -- : BFD_RELOC_SPARC_L44
3393 -- : BFD_RELOC_SPARC_REGISTER
3394 -- : BFD_RELOC_SPARC_H34
3395 -- : BFD_RELOC_SPARC_SIZE32
3396 -- : BFD_RELOC_SPARC_SIZE64
3397 -- : BFD_RELOC_SPARC_WDISP10
3398     SPARC64 relocations.
3399 -- : BFD_RELOC_SPARC_REV32
3400     SPARC little endian relocation.
3401 -- : BFD_RELOC_SPARC_TLS_GD_HI22
3402 -- : BFD_RELOC_SPARC_TLS_GD_LO10
3403 -- : BFD_RELOC_SPARC_TLS_GD_ADD
3404 -- : BFD_RELOC_SPARC_TLS_GD_CALL
3405 -- : BFD_RELOC_SPARC_TLS_LDM_HI22
3406 -- : BFD_RELOC_SPARC_TLS_LDM_LO10
3407 -- : BFD_RELOC_SPARC_TLS_LDM_ADD
3408 -- : BFD_RELOC_SPARC_TLS_LDM_CALL
3409 -- : BFD_RELOC_SPARC_TLS_LDO_HIX22
3410 -- : BFD_RELOC_SPARC_TLS_LDO_LOX10
3411 -- : BFD_RELOC_SPARC_TLS_LDO_ADD
3412 -- : BFD_RELOC_SPARC_TLS_IE_HI22
3413 -- : BFD_RELOC_SPARC_TLS_IE_LO10
3414 -- : BFD_RELOC_SPARC_TLS_IE_LD
3415 -- : BFD_RELOC_SPARC_TLS_IE_LDX
3416 -- : BFD_RELOC_SPARC_TLS_IE_ADD
3417 -- : BFD_RELOC_SPARC_TLS_LE_HIX22
3418 -- : BFD_RELOC_SPARC_TLS_LE_LOX10
3419 -- : BFD_RELOC_SPARC_TLS_DTPMOD32
3420 -- : BFD_RELOC_SPARC_TLS_DTPMOD64
3421 -- : BFD_RELOC_SPARC_TLS_DTPOFF32
3422 -- : BFD_RELOC_SPARC_TLS_DTPOFF64
3423 -- : BFD_RELOC_SPARC_TLS_TPOFF32
3424 -- : BFD_RELOC_SPARC_TLS_TPOFF64
3425     SPARC TLS relocations.
3426 -- : BFD_RELOC_SPU_IMM7
3427 -- : BFD_RELOC_SPU_IMM8
3428 -- : BFD_RELOC_SPU_IMM10
3429 -- : BFD_RELOC_SPU_IMM10W
3430 -- : BFD_RELOC_SPU_IMM16
3431 -- : BFD_RELOC_SPU_IMM16W
3432 -- : BFD_RELOC_SPU_IMM18
3433 -- : BFD_RELOC_SPU_PCREL9a
3434 -- : BFD_RELOC_SPU_PCREL9b
3435 -- : BFD_RELOC_SPU_PCREL16
3436 -- : BFD_RELOC_SPU_LO16
3437 -- : BFD_RELOC_SPU_HI16
3438 -- : BFD_RELOC_SPU_PPU32
3439 -- : BFD_RELOC_SPU_PPU64
3440 -- : BFD_RELOC_SPU_ADD_PIC
3441     SPU Relocations.
3442 -- : BFD_RELOC_ALPHA_GPDISP_HI16
3443     Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
3444     "addend" in some special way.  For GPDISP_HI16 ("gpdisp")
3445     relocations, the symbol is ignored when writing; when reading, it
3446     will be the absolute section symbol.  The addend is the
3447     displacement in bytes of the "lda" instruction from the "ldah"
3448     instruction (which is at the address of this reloc).
3449 -- : BFD_RELOC_ALPHA_GPDISP_LO16
3450     For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
3451     with GPDISP_HI16 relocs.  The addend is ignored when writing the
3452     relocations out, and is filled in with the file���s GP value on
3453     reading, for convenience.
3454 -- : BFD_RELOC_ALPHA_GPDISP
3455     The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
3456     relocation except that there is no accompanying GPDISP_LO16
3457     relocation.
3458 -- : BFD_RELOC_ALPHA_LITERAL
3459 -- : BFD_RELOC_ALPHA_ELF_LITERAL
3460 -- : BFD_RELOC_ALPHA_LITUSE
3461     The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
3462     the assembler turns it into a LDQ instruction to load the address
3463     of the symbol, and then fills in a register in the real
3464     instruction.
3465
3466     The LITERAL reloc, at the LDQ instruction, refers to the .lita
3467     section symbol.  The addend is ignored when writing, but is filled
3468     in with the file���s GP value on reading, for convenience, as with
3469     the GPDISP_LO16 reloc.
3470
3471     The ELF_LITERAL reloc is somewhere between 16_GOTOFF and
3472     GPDISP_LO16.  It should refer to the symbol to be referenced, as
3473     with 16_GOTOFF, but it generates output not based on the position
3474     within the .got section, but relative to the GP value chosen for
3475     the file during the final link stage.
3476
3477     The LITUSE reloc, on the instruction using the loaded address,
3478     gives information to the linker that it might be able to use to
3479     optimize away some literal section references.  The symbol is
3480     ignored (read as the absolute section symbol), and the "addend"
3481     indicates the type of instruction using the register: 1 - "memory"
3482     fmt insn 2 - byte-manipulation (byte offset reg) 3 - jsr (target of
3483     branch)
3484 -- : BFD_RELOC_ALPHA_HINT
3485     The HINT relocation indicates a value that should be filled into
3486     the "hint" field of a jmp/jsr/ret instruction, for possible branch-
3487     prediction logic which may be provided on some processors.
3488 -- : BFD_RELOC_ALPHA_LINKAGE
3489     The LINKAGE relocation outputs a linkage pair in the object file,
3490     which is filled by the linker.
3491 -- : BFD_RELOC_ALPHA_CODEADDR
3492     The CODEADDR relocation outputs a STO_CA in the object file, which
3493     is filled by the linker.
3494 -- : BFD_RELOC_ALPHA_GPREL_HI16
3495 -- : BFD_RELOC_ALPHA_GPREL_LO16
3496     The GPREL_HI/LO relocations together form a 32-bit offset from the
3497     GP register.
3498 -- : BFD_RELOC_ALPHA_BRSGP
3499     Like BFD_RELOC_23_PCREL_S2, except that the source and target must
3500     share a common GP, and the target address is adjusted for
3501     STO_ALPHA_STD_GPLOAD.
3502 -- : BFD_RELOC_ALPHA_NOP
3503     The NOP relocation outputs a NOP if the longword displacement
3504     between two procedure entry points is < 2^21.
3505 -- : BFD_RELOC_ALPHA_BSR
3506     The BSR relocation outputs a BSR if the longword displacement
3507     between two procedure entry points is < 2^21.
3508 -- : BFD_RELOC_ALPHA_LDA
3509     The LDA relocation outputs a LDA if the longword displacement
3510     between two procedure entry points is < 2^16.
3511 -- : BFD_RELOC_ALPHA_BOH
3512     The BOH relocation outputs a BSR if the longword displacement
3513     between two procedure entry points is < 2^21, or else a hint.
3514 -- : BFD_RELOC_ALPHA_TLSGD
3515 -- : BFD_RELOC_ALPHA_TLSLDM
3516 -- : BFD_RELOC_ALPHA_DTPMOD64
3517 -- : BFD_RELOC_ALPHA_GOTDTPREL16
3518 -- : BFD_RELOC_ALPHA_DTPREL64
3519 -- : BFD_RELOC_ALPHA_DTPREL_HI16
3520 -- : BFD_RELOC_ALPHA_DTPREL_LO16
3521 -- : BFD_RELOC_ALPHA_DTPREL16
3522 -- : BFD_RELOC_ALPHA_GOTTPREL16
3523 -- : BFD_RELOC_ALPHA_TPREL64
3524 -- : BFD_RELOC_ALPHA_TPREL_HI16
3525 -- : BFD_RELOC_ALPHA_TPREL_LO16
3526 -- : BFD_RELOC_ALPHA_TPREL16
3527     Alpha thread-local storage relocations.
3528 -- : BFD_RELOC_MIPS_JMP
3529 -- : BFD_RELOC_MICROMIPS_JMP
3530     The MIPS jump instruction.
3531 -- : BFD_RELOC_MIPS16_JMP
3532     The MIPS16 jump instruction.
3533 -- : BFD_RELOC_MIPS16_GPREL
3534     MIPS16 GP relative reloc.
3535 -- : BFD_RELOC_HI16
3536     High 16 bits of 32-bit value; simple reloc.
3537 -- : BFD_RELOC_HI16_S
3538     High 16 bits of 32-bit value but the low 16 bits will be sign
3539     extended and added to form the final result.  If the low 16 bits
3540     form a negative number, we need to add one to the high value to
3541     compensate for the borrow when the low bits are added.
3542 -- : BFD_RELOC_LO16
3543     Low 16 bits.
3544 -- : BFD_RELOC_HI16_PCREL
3545     High 16 bits of 32-bit pc-relative value.
3546 -- : BFD_RELOC_HI16_S_PCREL
3547     High 16 bits of 32-bit pc-relative value, adjusted.
3548 -- : BFD_RELOC_LO16_PCREL
3549     Low 16 bits of pc-relative value.
3550 -- : BFD_RELOC_MIPS16_GOT16
3551 -- : BFD_RELOC_MIPS16_CALL16
3552     Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
3553     16-bit immediate fields.
3554 -- : BFD_RELOC_MIPS16_HI16
3555     MIPS16 high 16 bits of 32-bit value.
3556 -- : BFD_RELOC_MIPS16_HI16_S
3557     MIPS16 high 16 bits of 32-bit value but the low 16 bits will be
3558     sign extended and added to form the final result.  If the low 16
3559     bits form a negative number, we need to add one to the high value
3560     to compensate for the borrow when the low bits are added.
3561 -- : BFD_RELOC_MIPS16_LO16
3562     MIPS16 low 16 bits.
3563 -- : BFD_RELOC_MIPS16_TLS_GD
3564 -- : BFD_RELOC_MIPS16_TLS_LDM
3565 -- : BFD_RELOC_MIPS16_TLS_DTPREL_HI16
3566 -- : BFD_RELOC_MIPS16_TLS_DTPREL_LO16
3567 -- : BFD_RELOC_MIPS16_TLS_GOTTPREL
3568 -- : BFD_RELOC_MIPS16_TLS_TPREL_HI16
3569 -- : BFD_RELOC_MIPS16_TLS_TPREL_LO16
3570     MIPS16 TLS relocations.
3571 -- : BFD_RELOC_MIPS_LITERAL
3572 -- : BFD_RELOC_MICROMIPS_LITERAL
3573     Relocation against a MIPS literal section.
3574 -- : BFD_RELOC_MICROMIPS_7_PCREL_S1
3575 -- : BFD_RELOC_MICROMIPS_10_PCREL_S1
3576 -- : BFD_RELOC_MICROMIPS_16_PCREL_S1
3577     microMIPS PC-relative relocations.
3578 -- : BFD_RELOC_MIPS16_16_PCREL_S1
3579     MIPS16 PC-relative relocation.
3580 -- : BFD_RELOC_MIPS_21_PCREL_S2
3581 -- : BFD_RELOC_MIPS_26_PCREL_S2
3582 -- : BFD_RELOC_MIPS_18_PCREL_S3
3583 -- : BFD_RELOC_MIPS_19_PCREL_S2
3584     MIPS PC-relative relocations.
3585 -- : BFD_RELOC_MICROMIPS_GPREL16
3586 -- : BFD_RELOC_MICROMIPS_HI16
3587 -- : BFD_RELOC_MICROMIPS_HI16_S
3588 -- : BFD_RELOC_MICROMIPS_LO16
3589     microMIPS versions of generic BFD relocs.
3590 -- : BFD_RELOC_MIPS_GOT16
3591 -- : BFD_RELOC_MICROMIPS_GOT16
3592 -- : BFD_RELOC_MIPS_CALL16
3593 -- : BFD_RELOC_MICROMIPS_CALL16
3594 -- : BFD_RELOC_MIPS_GOT_HI16
3595 -- : BFD_RELOC_MICROMIPS_GOT_HI16
3596 -- : BFD_RELOC_MIPS_GOT_LO16
3597 -- : BFD_RELOC_MICROMIPS_GOT_LO16
3598 -- : BFD_RELOC_MIPS_CALL_HI16
3599 -- : BFD_RELOC_MICROMIPS_CALL_HI16
3600 -- : BFD_RELOC_MIPS_CALL_LO16
3601 -- : BFD_RELOC_MICROMIPS_CALL_LO16
3602 -- : BFD_RELOC_MIPS_SUB
3603 -- : BFD_RELOC_MICROMIPS_SUB
3604 -- : BFD_RELOC_MIPS_GOT_PAGE
3605 -- : BFD_RELOC_MICROMIPS_GOT_PAGE
3606 -- : BFD_RELOC_MIPS_GOT_OFST
3607 -- : BFD_RELOC_MICROMIPS_GOT_OFST
3608 -- : BFD_RELOC_MIPS_GOT_DISP
3609 -- : BFD_RELOC_MICROMIPS_GOT_DISP
3610 -- : BFD_RELOC_MIPS_SHIFT5
3611 -- : BFD_RELOC_MIPS_SHIFT6
3612 -- : BFD_RELOC_MIPS_INSERT_A
3613 -- : BFD_RELOC_MIPS_INSERT_B
3614 -- : BFD_RELOC_MIPS_DELETE
3615 -- : BFD_RELOC_MIPS_HIGHEST
3616 -- : BFD_RELOC_MICROMIPS_HIGHEST
3617 -- : BFD_RELOC_MIPS_HIGHER
3618 -- : BFD_RELOC_MICROMIPS_HIGHER
3619 -- : BFD_RELOC_MIPS_SCN_DISP
3620 -- : BFD_RELOC_MICROMIPS_SCN_DISP
3621 -- : BFD_RELOC_MIPS_16
3622 -- : BFD_RELOC_MIPS_RELGOT
3623 -- : BFD_RELOC_MIPS_JALR
3624 -- : BFD_RELOC_MICROMIPS_JALR
3625 -- : BFD_RELOC_MIPS_TLS_DTPMOD32
3626 -- : BFD_RELOC_MIPS_TLS_DTPREL32
3627 -- : BFD_RELOC_MIPS_TLS_DTPMOD64
3628 -- : BFD_RELOC_MIPS_TLS_DTPREL64
3629 -- : BFD_RELOC_MIPS_TLS_GD
3630 -- : BFD_RELOC_MICROMIPS_TLS_GD
3631 -- : BFD_RELOC_MIPS_TLS_LDM
3632 -- : BFD_RELOC_MICROMIPS_TLS_LDM
3633 -- : BFD_RELOC_MIPS_TLS_DTPREL_HI16
3634 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16
3635 -- : BFD_RELOC_MIPS_TLS_DTPREL_LO16
3636 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16
3637 -- : BFD_RELOC_MIPS_TLS_GOTTPREL
3638 -- : BFD_RELOC_MICROMIPS_TLS_GOTTPREL
3639 -- : BFD_RELOC_MIPS_TLS_TPREL32
3640 -- : BFD_RELOC_MIPS_TLS_TPREL64
3641 -- : BFD_RELOC_MIPS_TLS_TPREL_HI16
3642 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_HI16
3643 -- : BFD_RELOC_MIPS_TLS_TPREL_LO16
3644 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_LO16
3645 -- : BFD_RELOC_MIPS_EH
3646     MIPS ELF relocations.
3647 -- : BFD_RELOC_MIPS_COPY
3648 -- : BFD_RELOC_MIPS_JUMP_SLOT
3649     MIPS ELF relocations (VxWorks and PLT extensions).
3650 -- : BFD_RELOC_MOXIE_10_PCREL
3651     Moxie ELF relocations.
3652 -- : BFD_RELOC_FT32_10
3653 -- : BFD_RELOC_FT32_20
3654 -- : BFD_RELOC_FT32_17
3655 -- : BFD_RELOC_FT32_18
3656 -- : BFD_RELOC_FT32_RELAX
3657 -- : BFD_RELOC_FT32_SC0
3658 -- : BFD_RELOC_FT32_SC1
3659 -- : BFD_RELOC_FT32_15
3660 -- : BFD_RELOC_FT32_DIFF32
3661     FT32 ELF relocations.
3662 -- : BFD_RELOC_FRV_LABEL16
3663 -- : BFD_RELOC_FRV_LABEL24
3664 -- : BFD_RELOC_FRV_LO16
3665 -- : BFD_RELOC_FRV_HI16
3666 -- : BFD_RELOC_FRV_GPREL12
3667 -- : BFD_RELOC_FRV_GPRELU12
3668 -- : BFD_RELOC_FRV_GPREL32
3669 -- : BFD_RELOC_FRV_GPRELHI
3670 -- : BFD_RELOC_FRV_GPRELLO
3671 -- : BFD_RELOC_FRV_GOT12
3672 -- : BFD_RELOC_FRV_GOTHI
3673 -- : BFD_RELOC_FRV_GOTLO
3674 -- : BFD_RELOC_FRV_FUNCDESC
3675 -- : BFD_RELOC_FRV_FUNCDESC_GOT12
3676 -- : BFD_RELOC_FRV_FUNCDESC_GOTHI
3677 -- : BFD_RELOC_FRV_FUNCDESC_GOTLO
3678 -- : BFD_RELOC_FRV_FUNCDESC_VALUE
3679 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFF12
3680 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFHI
3681 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFLO
3682 -- : BFD_RELOC_FRV_GOTOFF12
3683 -- : BFD_RELOC_FRV_GOTOFFHI
3684 -- : BFD_RELOC_FRV_GOTOFFLO
3685 -- : BFD_RELOC_FRV_GETTLSOFF
3686 -- : BFD_RELOC_FRV_TLSDESC_VALUE
3687 -- : BFD_RELOC_FRV_GOTTLSDESC12
3688 -- : BFD_RELOC_FRV_GOTTLSDESCHI
3689 -- : BFD_RELOC_FRV_GOTTLSDESCLO
3690 -- : BFD_RELOC_FRV_TLSMOFF12
3691 -- : BFD_RELOC_FRV_TLSMOFFHI
3692 -- : BFD_RELOC_FRV_TLSMOFFLO
3693 -- : BFD_RELOC_FRV_GOTTLSOFF12
3694 -- : BFD_RELOC_FRV_GOTTLSOFFHI
3695 -- : BFD_RELOC_FRV_GOTTLSOFFLO
3696 -- : BFD_RELOC_FRV_TLSOFF
3697 -- : BFD_RELOC_FRV_TLSDESC_RELAX
3698 -- : BFD_RELOC_FRV_GETTLSOFF_RELAX
3699 -- : BFD_RELOC_FRV_TLSOFF_RELAX
3700 -- : BFD_RELOC_FRV_TLSMOFF
3701     Fujitsu Frv Relocations.
3702 -- : BFD_RELOC_MN10300_GOTOFF24
3703     This is a 24bit GOT-relative reloc for the mn10300.
3704 -- : BFD_RELOC_MN10300_GOT32
3705     This is a 32bit GOT-relative reloc for the mn10300, offset by two
3706     bytes in the instruction.
3707 -- : BFD_RELOC_MN10300_GOT24
3708     This is a 24bit GOT-relative reloc for the mn10300, offset by two
3709     bytes in the instruction.
3710 -- : BFD_RELOC_MN10300_GOT16
3711     This is a 16bit GOT-relative reloc for the mn10300, offset by two
3712     bytes in the instruction.
3713 -- : BFD_RELOC_MN10300_COPY
3714     Copy symbol at runtime.
3715 -- : BFD_RELOC_MN10300_GLOB_DAT
3716     Create GOT entry.
3717 -- : BFD_RELOC_MN10300_JMP_SLOT
3718     Create PLT entry.
3719 -- : BFD_RELOC_MN10300_RELATIVE
3720     Adjust by program base.
3721 -- : BFD_RELOC_MN10300_SYM_DIFF
3722     Together with another reloc targeted at the same location, allows
3723     for a value that is the difference of two symbols in the same
3724     section.
3725 -- : BFD_RELOC_MN10300_ALIGN
3726     The addend of this reloc is an alignment power that must be
3727     honoured at the offset���s location, regardless of linker relaxation.
3728 -- : BFD_RELOC_MN10300_TLS_GD
3729 -- : BFD_RELOC_MN10300_TLS_LD
3730 -- : BFD_RELOC_MN10300_TLS_LDO
3731 -- : BFD_RELOC_MN10300_TLS_GOTIE
3732 -- : BFD_RELOC_MN10300_TLS_IE
3733 -- : BFD_RELOC_MN10300_TLS_LE
3734 -- : BFD_RELOC_MN10300_TLS_DTPMOD
3735 -- : BFD_RELOC_MN10300_TLS_DTPOFF
3736 -- : BFD_RELOC_MN10300_TLS_TPOFF
3737     Various TLS-related relocations.
3738 -- : BFD_RELOC_MN10300_32_PCREL
3739     This is a 32bit pcrel reloc for the mn10300, offset by two bytes in
3740     the instruction.
3741 -- : BFD_RELOC_MN10300_16_PCREL
3742     This is a 16bit pcrel reloc for the mn10300, offset by two bytes in
3743     the instruction.
3744 -- : BFD_RELOC_386_GOT32
3745 -- : BFD_RELOC_386_PLT32
3746 -- : BFD_RELOC_386_COPY
3747 -- : BFD_RELOC_386_GLOB_DAT
3748 -- : BFD_RELOC_386_JUMP_SLOT
3749 -- : BFD_RELOC_386_RELATIVE
3750 -- : BFD_RELOC_386_GOTOFF
3751 -- : BFD_RELOC_386_GOTPC
3752 -- : BFD_RELOC_386_TLS_TPOFF
3753 -- : BFD_RELOC_386_TLS_IE
3754 -- : BFD_RELOC_386_TLS_GOTIE
3755 -- : BFD_RELOC_386_TLS_LE
3756 -- : BFD_RELOC_386_TLS_GD
3757 -- : BFD_RELOC_386_TLS_LDM
3758 -- : BFD_RELOC_386_TLS_LDO_32
3759 -- : BFD_RELOC_386_TLS_IE_32
3760 -- : BFD_RELOC_386_TLS_LE_32
3761 -- : BFD_RELOC_386_TLS_DTPMOD32
3762 -- : BFD_RELOC_386_TLS_DTPOFF32
3763 -- : BFD_RELOC_386_TLS_TPOFF32
3764 -- : BFD_RELOC_386_TLS_GOTDESC
3765 -- : BFD_RELOC_386_TLS_DESC_CALL
3766 -- : BFD_RELOC_386_TLS_DESC
3767 -- : BFD_RELOC_386_IRELATIVE
3768 -- : BFD_RELOC_386_GOT32X
3769     i386/elf relocations.
3770 -- : BFD_RELOC_X86_64_GOT32
3771 -- : BFD_RELOC_X86_64_PLT32
3772 -- : BFD_RELOC_X86_64_COPY
3773 -- : BFD_RELOC_X86_64_GLOB_DAT
3774 -- : BFD_RELOC_X86_64_JUMP_SLOT
3775 -- : BFD_RELOC_X86_64_RELATIVE
3776 -- : BFD_RELOC_X86_64_GOTPCREL
3777 -- : BFD_RELOC_X86_64_32S
3778 -- : BFD_RELOC_X86_64_DTPMOD64
3779 -- : BFD_RELOC_X86_64_DTPOFF64
3780 -- : BFD_RELOC_X86_64_TPOFF64
3781 -- : BFD_RELOC_X86_64_TLSGD
3782 -- : BFD_RELOC_X86_64_TLSLD
3783 -- : BFD_RELOC_X86_64_DTPOFF32
3784 -- : BFD_RELOC_X86_64_GOTTPOFF
3785 -- : BFD_RELOC_X86_64_TPOFF32
3786 -- : BFD_RELOC_X86_64_GOTOFF64
3787 -- : BFD_RELOC_X86_64_GOTPC32
3788 -- : BFD_RELOC_X86_64_GOT64
3789 -- : BFD_RELOC_X86_64_GOTPCREL64
3790 -- : BFD_RELOC_X86_64_GOTPC64
3791 -- : BFD_RELOC_X86_64_GOTPLT64
3792 -- : BFD_RELOC_X86_64_PLTOFF64
3793 -- : BFD_RELOC_X86_64_GOTPC32_TLSDESC
3794 -- : BFD_RELOC_X86_64_TLSDESC_CALL
3795 -- : BFD_RELOC_X86_64_TLSDESC
3796 -- : BFD_RELOC_X86_64_IRELATIVE
3797 -- : BFD_RELOC_X86_64_PC32_BND
3798 -- : BFD_RELOC_X86_64_PLT32_BND
3799 -- : BFD_RELOC_X86_64_GOTPCRELX
3800 -- : BFD_RELOC_X86_64_REX_GOTPCRELX
3801 -- : BFD_RELOC_X86_64_CODE_4_GOTPCRELX
3802 -- : BFD_RELOC_X86_64_CODE_4_GOTTPOFF
3803 -- : BFD_RELOC_X86_64_CODE_4_GOTPC32_TLSDESC
3804     x86-64/elf relocations.
3805 -- : BFD_RELOC_NS32K_IMM_8
3806 -- : BFD_RELOC_NS32K_IMM_16
3807 -- : BFD_RELOC_NS32K_IMM_32
3808 -- : BFD_RELOC_NS32K_IMM_8_PCREL
3809 -- : BFD_RELOC_NS32K_IMM_16_PCREL
3810 -- : BFD_RELOC_NS32K_IMM_32_PCREL
3811 -- : BFD_RELOC_NS32K_DISP_8
3812 -- : BFD_RELOC_NS32K_DISP_16
3813 -- : BFD_RELOC_NS32K_DISP_32
3814 -- : BFD_RELOC_NS32K_DISP_8_PCREL
3815 -- : BFD_RELOC_NS32K_DISP_16_PCREL
3816 -- : BFD_RELOC_NS32K_DISP_32_PCREL
3817     ns32k relocations.
3818 -- : BFD_RELOC_PDP11_DISP_8_PCREL
3819 -- : BFD_RELOC_PDP11_DISP_6_PCREL
3820     PDP11 relocations.
3821 -- : BFD_RELOC_PJ_CODE_HI16
3822 -- : BFD_RELOC_PJ_CODE_LO16
3823 -- : BFD_RELOC_PJ_CODE_DIR16
3824 -- : BFD_RELOC_PJ_CODE_DIR32
3825 -- : BFD_RELOC_PJ_CODE_REL16
3826 -- : BFD_RELOC_PJ_CODE_REL32
3827     Picojava relocs.  Not all of these appear in object files.
3828 -- : BFD_RELOC_PPC_B26
3829 -- : BFD_RELOC_PPC_BA26
3830 -- : BFD_RELOC_PPC_TOC16
3831 -- : BFD_RELOC_PPC_TOC16_LO
3832 -- : BFD_RELOC_PPC_TOC16_HI
3833 -- : BFD_RELOC_PPC_B16
3834 -- : BFD_RELOC_PPC_B16_BRTAKEN
3835 -- : BFD_RELOC_PPC_B16_BRNTAKEN
3836 -- : BFD_RELOC_PPC_BA16
3837 -- : BFD_RELOC_PPC_BA16_BRTAKEN
3838 -- : BFD_RELOC_PPC_BA16_BRNTAKEN
3839 -- : BFD_RELOC_PPC_COPY
3840 -- : BFD_RELOC_PPC_GLOB_DAT
3841 -- : BFD_RELOC_PPC_JMP_SLOT
3842 -- : BFD_RELOC_PPC_RELATIVE
3843 -- : BFD_RELOC_PPC_LOCAL24PC
3844 -- : BFD_RELOC_PPC_EMB_NADDR32
3845 -- : BFD_RELOC_PPC_EMB_NADDR16
3846 -- : BFD_RELOC_PPC_EMB_NADDR16_LO
3847 -- : BFD_RELOC_PPC_EMB_NADDR16_HI
3848 -- : BFD_RELOC_PPC_EMB_NADDR16_HA
3849 -- : BFD_RELOC_PPC_EMB_SDAI16
3850 -- : BFD_RELOC_PPC_EMB_SDA2I16
3851 -- : BFD_RELOC_PPC_EMB_SDA2REL
3852 -- : BFD_RELOC_PPC_EMB_SDA21
3853 -- : BFD_RELOC_PPC_EMB_MRKREF
3854 -- : BFD_RELOC_PPC_EMB_RELSEC16
3855 -- : BFD_RELOC_PPC_EMB_RELST_LO
3856 -- : BFD_RELOC_PPC_EMB_RELST_HI
3857 -- : BFD_RELOC_PPC_EMB_RELST_HA
3858 -- : BFD_RELOC_PPC_EMB_BIT_FLD
3859 -- : BFD_RELOC_PPC_EMB_RELSDA
3860 -- : BFD_RELOC_PPC_VLE_REL8
3861 -- : BFD_RELOC_PPC_VLE_REL15
3862 -- : BFD_RELOC_PPC_VLE_REL24
3863 -- : BFD_RELOC_PPC_VLE_LO16A
3864 -- : BFD_RELOC_PPC_VLE_LO16D
3865 -- : BFD_RELOC_PPC_VLE_HI16A
3866 -- : BFD_RELOC_PPC_VLE_HI16D
3867 -- : BFD_RELOC_PPC_VLE_HA16A
3868 -- : BFD_RELOC_PPC_VLE_HA16D
3869 -- : BFD_RELOC_PPC_VLE_SDA21
3870 -- : BFD_RELOC_PPC_VLE_SDA21_LO
3871 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16A
3872 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16D
3873 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16A
3874 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16D
3875 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16A
3876 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16D
3877 -- : BFD_RELOC_PPC_16DX_HA
3878 -- : BFD_RELOC_PPC_REL16DX_HA
3879 -- : BFD_RELOC_PPC_NEG
3880 -- : BFD_RELOC_PPC64_HIGHER
3881 -- : BFD_RELOC_PPC64_HIGHER_S
3882 -- : BFD_RELOC_PPC64_HIGHEST
3883 -- : BFD_RELOC_PPC64_HIGHEST_S
3884 -- : BFD_RELOC_PPC64_TOC16_LO
3885 -- : BFD_RELOC_PPC64_TOC16_HI
3886 -- : BFD_RELOC_PPC64_TOC16_HA
3887 -- : BFD_RELOC_PPC64_TOC
3888 -- : BFD_RELOC_PPC64_PLTGOT16
3889 -- : BFD_RELOC_PPC64_PLTGOT16_LO
3890 -- : BFD_RELOC_PPC64_PLTGOT16_HI
3891 -- : BFD_RELOC_PPC64_PLTGOT16_HA
3892 -- : BFD_RELOC_PPC64_ADDR16_DS
3893 -- : BFD_RELOC_PPC64_ADDR16_LO_DS
3894 -- : BFD_RELOC_PPC64_GOT16_DS
3895 -- : BFD_RELOC_PPC64_GOT16_LO_DS
3896 -- : BFD_RELOC_PPC64_PLT16_LO_DS
3897 -- : BFD_RELOC_PPC64_SECTOFF_DS
3898 -- : BFD_RELOC_PPC64_SECTOFF_LO_DS
3899 -- : BFD_RELOC_PPC64_TOC16_DS
3900 -- : BFD_RELOC_PPC64_TOC16_LO_DS
3901 -- : BFD_RELOC_PPC64_PLTGOT16_DS
3902 -- : BFD_RELOC_PPC64_PLTGOT16_LO_DS
3903 -- : BFD_RELOC_PPC64_ADDR16_HIGH
3904 -- : BFD_RELOC_PPC64_ADDR16_HIGHA
3905 -- : BFD_RELOC_PPC64_REL16_HIGH
3906 -- : BFD_RELOC_PPC64_REL16_HIGHA
3907 -- : BFD_RELOC_PPC64_REL16_HIGHER
3908 -- : BFD_RELOC_PPC64_REL16_HIGHERA
3909 -- : BFD_RELOC_PPC64_REL16_HIGHEST
3910 -- : BFD_RELOC_PPC64_REL16_HIGHESTA
3911 -- : BFD_RELOC_PPC64_ADDR64_LOCAL
3912 -- : BFD_RELOC_PPC64_ENTRY
3913 -- : BFD_RELOC_PPC64_REL24_NOTOC
3914 -- : BFD_RELOC_PPC64_REL24_P9NOTOC
3915 -- : BFD_RELOC_PPC64_D34
3916 -- : BFD_RELOC_PPC64_D34_LO
3917 -- : BFD_RELOC_PPC64_D34_HI30
3918 -- : BFD_RELOC_PPC64_D34_HA30
3919 -- : BFD_RELOC_PPC64_PCREL34
3920 -- : BFD_RELOC_PPC64_GOT_PCREL34
3921 -- : BFD_RELOC_PPC64_PLT_PCREL34
3922 -- : BFD_RELOC_PPC64_ADDR16_HIGHER34
3923 -- : BFD_RELOC_PPC64_ADDR16_HIGHERA34
3924 -- : BFD_RELOC_PPC64_ADDR16_HIGHEST34
3925 -- : BFD_RELOC_PPC64_ADDR16_HIGHESTA34
3926 -- : BFD_RELOC_PPC64_REL16_HIGHER34
3927 -- : BFD_RELOC_PPC64_REL16_HIGHERA34
3928 -- : BFD_RELOC_PPC64_REL16_HIGHEST34
3929 -- : BFD_RELOC_PPC64_REL16_HIGHESTA34
3930 -- : BFD_RELOC_PPC64_D28
3931 -- : BFD_RELOC_PPC64_PCREL28
3932     Power(rs6000) and PowerPC relocations.
3933 -- : BFD_RELOC_PPC_TLS
3934 -- : BFD_RELOC_PPC_TLSGD
3935 -- : BFD_RELOC_PPC_TLSLD
3936 -- : BFD_RELOC_PPC_TLSLE
3937 -- : BFD_RELOC_PPC_TLSIE
3938 -- : BFD_RELOC_PPC_TLSM
3939 -- : BFD_RELOC_PPC_TLSML
3940 -- : BFD_RELOC_PPC_DTPMOD
3941 -- : BFD_RELOC_PPC_TPREL16
3942 -- : BFD_RELOC_PPC_TPREL16_LO
3943 -- : BFD_RELOC_PPC_TPREL16_HI
3944 -- : BFD_RELOC_PPC_TPREL16_HA
3945 -- : BFD_RELOC_PPC_TPREL
3946 -- : BFD_RELOC_PPC_DTPREL16
3947 -- : BFD_RELOC_PPC_DTPREL16_LO
3948 -- : BFD_RELOC_PPC_DTPREL16_HI
3949 -- : BFD_RELOC_PPC_DTPREL16_HA
3950 -- : BFD_RELOC_PPC_DTPREL
3951 -- : BFD_RELOC_PPC_GOT_TLSGD16
3952 -- : BFD_RELOC_PPC_GOT_TLSGD16_LO
3953 -- : BFD_RELOC_PPC_GOT_TLSGD16_HI
3954 -- : BFD_RELOC_PPC_GOT_TLSGD16_HA
3955 -- : BFD_RELOC_PPC_GOT_TLSLD16
3956 -- : BFD_RELOC_PPC_GOT_TLSLD16_LO
3957 -- : BFD_RELOC_PPC_GOT_TLSLD16_HI
3958 -- : BFD_RELOC_PPC_GOT_TLSLD16_HA
3959 -- : BFD_RELOC_PPC_GOT_TPREL16
3960 -- : BFD_RELOC_PPC_GOT_TPREL16_LO
3961 -- : BFD_RELOC_PPC_GOT_TPREL16_HI
3962 -- : BFD_RELOC_PPC_GOT_TPREL16_HA
3963 -- : BFD_RELOC_PPC_GOT_DTPREL16
3964 -- : BFD_RELOC_PPC_GOT_DTPREL16_LO
3965 -- : BFD_RELOC_PPC_GOT_DTPREL16_HI
3966 -- : BFD_RELOC_PPC_GOT_DTPREL16_HA
3967 -- : BFD_RELOC_PPC64_TLSGD
3968 -- : BFD_RELOC_PPC64_TLSLD
3969 -- : BFD_RELOC_PPC64_TLSLE
3970 -- : BFD_RELOC_PPC64_TLSIE
3971 -- : BFD_RELOC_PPC64_TLSM
3972 -- : BFD_RELOC_PPC64_TLSML
3973 -- : BFD_RELOC_PPC64_TPREL16_DS
3974 -- : BFD_RELOC_PPC64_TPREL16_LO_DS
3975 -- : BFD_RELOC_PPC64_TPREL16_HIGH
3976 -- : BFD_RELOC_PPC64_TPREL16_HIGHA
3977 -- : BFD_RELOC_PPC64_TPREL16_HIGHER
3978 -- : BFD_RELOC_PPC64_TPREL16_HIGHERA
3979 -- : BFD_RELOC_PPC64_TPREL16_HIGHEST
3980 -- : BFD_RELOC_PPC64_TPREL16_HIGHESTA
3981 -- : BFD_RELOC_PPC64_DTPREL16_DS
3982 -- : BFD_RELOC_PPC64_DTPREL16_LO_DS
3983 -- : BFD_RELOC_PPC64_DTPREL16_HIGH
3984 -- : BFD_RELOC_PPC64_DTPREL16_HIGHA
3985 -- : BFD_RELOC_PPC64_DTPREL16_HIGHER
3986 -- : BFD_RELOC_PPC64_DTPREL16_HIGHERA
3987 -- : BFD_RELOC_PPC64_DTPREL16_HIGHEST
3988 -- : BFD_RELOC_PPC64_DTPREL16_HIGHESTA
3989 -- : BFD_RELOC_PPC64_TPREL34
3990 -- : BFD_RELOC_PPC64_DTPREL34
3991 -- : BFD_RELOC_PPC64_GOT_TLSGD_PCREL34
3992 -- : BFD_RELOC_PPC64_GOT_TLSLD_PCREL34
3993 -- : BFD_RELOC_PPC64_GOT_TPREL_PCREL34
3994 -- : BFD_RELOC_PPC64_GOT_DTPREL_PCREL34
3995 -- : BFD_RELOC_PPC64_TLS_PCREL
3996     PowerPC and PowerPC64 thread-local storage relocations.
3997 -- : BFD_RELOC_I370_D12
3998     IBM 370/390 relocations.
3999 -- : BFD_RELOC_CTOR
4000     The type of reloc used to build a constructor table - at the moment
4001     probably a 32 bit wide absolute relocation, but the target can
4002     choose.  It generally does map to one of the other relocation
4003     types.
4004 -- : BFD_RELOC_ARM_PCREL_BRANCH
4005     ARM 26 bit pc-relative branch.  The lowest two bits must be zero
4006     and are not stored in the instruction.
4007 -- : BFD_RELOC_ARM_PCREL_BLX
4008     ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
4009     not stored in the instruction.  The 2nd lowest bit comes from a 1
4010     bit field in the instruction.
4011 -- : BFD_RELOC_THUMB_PCREL_BLX
4012     Thumb 22 bit pc-relative branch.  The lowest bit must be zero and
4013     is not stored in the instruction.  The 2nd lowest bit comes from a
4014     1 bit field in the instruction.
4015 -- : BFD_RELOC_ARM_PCREL_CALL
4016     ARM 26-bit pc-relative branch for an unconditional BL or BLX
4017     instruction.
4018 -- : BFD_RELOC_ARM_PCREL_JUMP
4019     ARM 26-bit pc-relative branch for B or conditional BL instruction.
4020 -- : BFD_RELOC_THUMB_PCREL_BRANCH5
4021     ARM 5-bit pc-relative branch for Branch Future instructions.
4022 -- : BFD_RELOC_THUMB_PCREL_BFCSEL
4023     ARM 6-bit pc-relative branch for BFCSEL instruction.
4024 -- : BFD_RELOC_ARM_THUMB_BF17
4025     ARM 17-bit pc-relative branch for Branch Future instructions.
4026 -- : BFD_RELOC_ARM_THUMB_BF13
4027     ARM 13-bit pc-relative branch for BFCSEL instruction.
4028 -- : BFD_RELOC_ARM_THUMB_BF19
4029     ARM 19-bit pc-relative branch for Branch Future Link instruction.
4030 -- : BFD_RELOC_ARM_THUMB_LOOP12
4031     ARM 12-bit pc-relative branch for Low Overhead Loop instructions.
4032 -- : BFD_RELOC_THUMB_PCREL_BRANCH7
4033 -- : BFD_RELOC_THUMB_PCREL_BRANCH9
4034 -- : BFD_RELOC_THUMB_PCREL_BRANCH12
4035 -- : BFD_RELOC_THUMB_PCREL_BRANCH20
4036 -- : BFD_RELOC_THUMB_PCREL_BRANCH23
4037 -- : BFD_RELOC_THUMB_PCREL_BRANCH25
4038     Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.  The
4039     lowest bit must be zero and is not stored in the instruction.  Note
4040     that the corresponding ELF R_ARM_THM_JUMPnn constant has an "nn"
4041     one smaller in all cases.  Note further that BRANCH23 corresponds
4042     to R_ARM_THM_CALL.
4043 -- : BFD_RELOC_ARM_OFFSET_IMM
4044     12-bit immediate offset, used in ARM-format ldr and str
4045     instructions.
4046 -- : BFD_RELOC_ARM_THUMB_OFFSET
4047     5-bit immediate offset, used in Thumb-format ldr and str
4048     instructions.
4049 -- : BFD_RELOC_ARM_TARGET1
4050     Pc-relative or absolute relocation depending on target.  Used for
4051     entries in .init_array sections.
4052 -- : BFD_RELOC_ARM_ROSEGREL32
4053     Read-only segment base relative address.
4054 -- : BFD_RELOC_ARM_SBREL32
4055     Data segment base relative address.
4056 -- : BFD_RELOC_ARM_TARGET2
4057     This reloc is used for references to RTTI data from exception
4058     handling tables.  The actual definition depends on the target.  It
4059     may be a pc-relative or some form of GOT-indirect relocation.
4060 -- : BFD_RELOC_ARM_PREL31
4061     31-bit PC relative address.
4062 -- : BFD_RELOC_ARM_MOVW
4063 -- : BFD_RELOC_ARM_MOVT
4064 -- : BFD_RELOC_ARM_MOVW_PCREL
4065 -- : BFD_RELOC_ARM_MOVT_PCREL
4066 -- : BFD_RELOC_ARM_THUMB_MOVW
4067 -- : BFD_RELOC_ARM_THUMB_MOVT
4068 -- : BFD_RELOC_ARM_THUMB_MOVW_PCREL
4069 -- : BFD_RELOC_ARM_THUMB_MOVT_PCREL
4070     Low and High halfword relocations for MOVW and MOVT instructions.
4071 -- : BFD_RELOC_ARM_GOTFUNCDESC
4072 -- : BFD_RELOC_ARM_GOTOFFFUNCDESC
4073 -- : BFD_RELOC_ARM_FUNCDESC
4074 -- : BFD_RELOC_ARM_FUNCDESC_VALUE
4075 -- : BFD_RELOC_ARM_TLS_GD32_FDPIC
4076 -- : BFD_RELOC_ARM_TLS_LDM32_FDPIC
4077 -- : BFD_RELOC_ARM_TLS_IE32_FDPIC
4078     ARM FDPIC specific relocations.
4079 -- : BFD_RELOC_ARM_JUMP_SLOT
4080 -- : BFD_RELOC_ARM_GLOB_DAT
4081 -- : BFD_RELOC_ARM_GOT32
4082 -- : BFD_RELOC_ARM_PLT32
4083 -- : BFD_RELOC_ARM_RELATIVE
4084 -- : BFD_RELOC_ARM_GOTOFF
4085 -- : BFD_RELOC_ARM_GOTPC
4086 -- : BFD_RELOC_ARM_GOT_PREL
4087     Relocations for setting up GOTs and PLTs for shared libraries.
4088 -- : BFD_RELOC_ARM_TLS_GD32
4089 -- : BFD_RELOC_ARM_TLS_LDO32
4090 -- : BFD_RELOC_ARM_TLS_LDM32
4091 -- : BFD_RELOC_ARM_TLS_DTPOFF32
4092 -- : BFD_RELOC_ARM_TLS_DTPMOD32
4093 -- : BFD_RELOC_ARM_TLS_TPOFF32
4094 -- : BFD_RELOC_ARM_TLS_IE32
4095 -- : BFD_RELOC_ARM_TLS_LE32
4096 -- : BFD_RELOC_ARM_TLS_GOTDESC
4097 -- : BFD_RELOC_ARM_TLS_CALL
4098 -- : BFD_RELOC_ARM_THM_TLS_CALL
4099 -- : BFD_RELOC_ARM_TLS_DESCSEQ
4100 -- : BFD_RELOC_ARM_THM_TLS_DESCSEQ
4101 -- : BFD_RELOC_ARM_TLS_DESC
4102     ARM thread-local storage relocations.
4103 -- : BFD_RELOC_ARM_ALU_PC_G0_NC
4104 -- : BFD_RELOC_ARM_ALU_PC_G0
4105 -- : BFD_RELOC_ARM_ALU_PC_G1_NC
4106 -- : BFD_RELOC_ARM_ALU_PC_G1
4107 -- : BFD_RELOC_ARM_ALU_PC_G2
4108 -- : BFD_RELOC_ARM_LDR_PC_G0
4109 -- : BFD_RELOC_ARM_LDR_PC_G1
4110 -- : BFD_RELOC_ARM_LDR_PC_G2
4111 -- : BFD_RELOC_ARM_LDRS_PC_G0
4112 -- : BFD_RELOC_ARM_LDRS_PC_G1
4113 -- : BFD_RELOC_ARM_LDRS_PC_G2
4114 -- : BFD_RELOC_ARM_LDC_PC_G0
4115 -- : BFD_RELOC_ARM_LDC_PC_G1
4116 -- : BFD_RELOC_ARM_LDC_PC_G2
4117 -- : BFD_RELOC_ARM_ALU_SB_G0_NC
4118 -- : BFD_RELOC_ARM_ALU_SB_G0
4119 -- : BFD_RELOC_ARM_ALU_SB_G1_NC
4120 -- : BFD_RELOC_ARM_ALU_SB_G1
4121 -- : BFD_RELOC_ARM_ALU_SB_G2
4122 -- : BFD_RELOC_ARM_LDR_SB_G0
4123 -- : BFD_RELOC_ARM_LDR_SB_G1
4124 -- : BFD_RELOC_ARM_LDR_SB_G2
4125 -- : BFD_RELOC_ARM_LDRS_SB_G0
4126 -- : BFD_RELOC_ARM_LDRS_SB_G1
4127 -- : BFD_RELOC_ARM_LDRS_SB_G2
4128 -- : BFD_RELOC_ARM_LDC_SB_G0
4129 -- : BFD_RELOC_ARM_LDC_SB_G1
4130 -- : BFD_RELOC_ARM_LDC_SB_G2
4131     ARM group relocations.
4132 -- : BFD_RELOC_ARM_V4BX
4133     Annotation of BX instructions.
4134 -- : BFD_RELOC_ARM_IRELATIVE
4135     ARM support for STT_GNU_IFUNC.
4136 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC
4137 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC
4138 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC
4139 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC
4140     Thumb1 relocations to support execute-only code.
4141 -- : BFD_RELOC_ARM_IMMEDIATE
4142 -- : BFD_RELOC_ARM_ADRL_IMMEDIATE
4143 -- : BFD_RELOC_ARM_T32_IMMEDIATE
4144 -- : BFD_RELOC_ARM_T32_ADD_IMM
4145 -- : BFD_RELOC_ARM_T32_IMM12
4146 -- : BFD_RELOC_ARM_T32_ADD_PC12
4147 -- : BFD_RELOC_ARM_SHIFT_IMM
4148 -- : BFD_RELOC_ARM_SMC
4149 -- : BFD_RELOC_ARM_HVC
4150 -- : BFD_RELOC_ARM_SWI
4151 -- : BFD_RELOC_ARM_MULTI
4152 -- : BFD_RELOC_ARM_CP_OFF_IMM
4153 -- : BFD_RELOC_ARM_CP_OFF_IMM_S2
4154 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM
4155 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
4156 -- : BFD_RELOC_ARM_T32_VLDR_VSTR_OFF_IMM
4157 -- : BFD_RELOC_ARM_ADR_IMM
4158 -- : BFD_RELOC_ARM_LDR_IMM
4159 -- : BFD_RELOC_ARM_LITERAL
4160 -- : BFD_RELOC_ARM_IN_POOL
4161 -- : BFD_RELOC_ARM_OFFSET_IMM8
4162 -- : BFD_RELOC_ARM_T32_OFFSET_U8
4163 -- : BFD_RELOC_ARM_T32_OFFSET_IMM
4164 -- : BFD_RELOC_ARM_HWLITERAL
4165 -- : BFD_RELOC_ARM_THUMB_ADD
4166 -- : BFD_RELOC_ARM_THUMB_IMM
4167 -- : BFD_RELOC_ARM_THUMB_SHIFT
4168     These relocs are only used within the ARM assembler.  They are not
4169     (at present) written to any object files.
4170 -- : BFD_RELOC_SH_PCDISP8BY2
4171 -- : BFD_RELOC_SH_PCDISP12BY2
4172 -- : BFD_RELOC_SH_IMM3
4173 -- : BFD_RELOC_SH_IMM3U
4174 -- : BFD_RELOC_SH_DISP12
4175 -- : BFD_RELOC_SH_DISP12BY2
4176 -- : BFD_RELOC_SH_DISP12BY4
4177 -- : BFD_RELOC_SH_DISP12BY8
4178 -- : BFD_RELOC_SH_DISP20
4179 -- : BFD_RELOC_SH_DISP20BY8
4180 -- : BFD_RELOC_SH_IMM4
4181 -- : BFD_RELOC_SH_IMM4BY2
4182 -- : BFD_RELOC_SH_IMM4BY4
4183 -- : BFD_RELOC_SH_IMM8
4184 -- : BFD_RELOC_SH_IMM8BY2
4185 -- : BFD_RELOC_SH_IMM8BY4
4186 -- : BFD_RELOC_SH_PCRELIMM8BY2
4187 -- : BFD_RELOC_SH_PCRELIMM8BY4
4188 -- : BFD_RELOC_SH_SWITCH16
4189 -- : BFD_RELOC_SH_SWITCH32
4190 -- : BFD_RELOC_SH_USES
4191 -- : BFD_RELOC_SH_COUNT
4192 -- : BFD_RELOC_SH_ALIGN
4193 -- : BFD_RELOC_SH_CODE
4194 -- : BFD_RELOC_SH_DATA
4195 -- : BFD_RELOC_SH_LABEL
4196 -- : BFD_RELOC_SH_LOOP_START
4197 -- : BFD_RELOC_SH_LOOP_END
4198 -- : BFD_RELOC_SH_COPY
4199 -- : BFD_RELOC_SH_GLOB_DAT
4200 -- : BFD_RELOC_SH_JMP_SLOT
4201 -- : BFD_RELOC_SH_RELATIVE
4202 -- : BFD_RELOC_SH_GOTPC
4203 -- : BFD_RELOC_SH_GOT_LOW16
4204 -- : BFD_RELOC_SH_GOT_MEDLOW16
4205 -- : BFD_RELOC_SH_GOT_MEDHI16
4206 -- : BFD_RELOC_SH_GOT_HI16
4207 -- : BFD_RELOC_SH_GOTPLT_LOW16
4208 -- : BFD_RELOC_SH_GOTPLT_MEDLOW16
4209 -- : BFD_RELOC_SH_GOTPLT_MEDHI16
4210 -- : BFD_RELOC_SH_GOTPLT_HI16
4211 -- : BFD_RELOC_SH_PLT_LOW16
4212 -- : BFD_RELOC_SH_PLT_MEDLOW16
4213 -- : BFD_RELOC_SH_PLT_MEDHI16
4214 -- : BFD_RELOC_SH_PLT_HI16
4215 -- : BFD_RELOC_SH_GOTOFF_LOW16
4216 -- : BFD_RELOC_SH_GOTOFF_MEDLOW16
4217 -- : BFD_RELOC_SH_GOTOFF_MEDHI16
4218 -- : BFD_RELOC_SH_GOTOFF_HI16
4219 -- : BFD_RELOC_SH_GOTPC_LOW16
4220 -- : BFD_RELOC_SH_GOTPC_MEDLOW16
4221 -- : BFD_RELOC_SH_GOTPC_MEDHI16
4222 -- : BFD_RELOC_SH_GOTPC_HI16
4223 -- : BFD_RELOC_SH_COPY64
4224 -- : BFD_RELOC_SH_GLOB_DAT64
4225 -- : BFD_RELOC_SH_JMP_SLOT64
4226 -- : BFD_RELOC_SH_RELATIVE64
4227 -- : BFD_RELOC_SH_GOT10BY4
4228 -- : BFD_RELOC_SH_GOT10BY8
4229 -- : BFD_RELOC_SH_GOTPLT10BY4
4230 -- : BFD_RELOC_SH_GOTPLT10BY8
4231 -- : BFD_RELOC_SH_GOTPLT32
4232 -- : BFD_RELOC_SH_SHMEDIA_CODE
4233 -- : BFD_RELOC_SH_IMMU5
4234 -- : BFD_RELOC_SH_IMMS6
4235 -- : BFD_RELOC_SH_IMMS6BY32
4236 -- : BFD_RELOC_SH_IMMU6
4237 -- : BFD_RELOC_SH_IMMS10
4238 -- : BFD_RELOC_SH_IMMS10BY2
4239 -- : BFD_RELOC_SH_IMMS10BY4
4240 -- : BFD_RELOC_SH_IMMS10BY8
4241 -- : BFD_RELOC_SH_IMMS16
4242 -- : BFD_RELOC_SH_IMMU16
4243 -- : BFD_RELOC_SH_IMM_LOW16
4244 -- : BFD_RELOC_SH_IMM_LOW16_PCREL
4245 -- : BFD_RELOC_SH_IMM_MEDLOW16
4246 -- : BFD_RELOC_SH_IMM_MEDLOW16_PCREL
4247 -- : BFD_RELOC_SH_IMM_MEDHI16
4248 -- : BFD_RELOC_SH_IMM_MEDHI16_PCREL
4249 -- : BFD_RELOC_SH_IMM_HI16
4250 -- : BFD_RELOC_SH_IMM_HI16_PCREL
4251 -- : BFD_RELOC_SH_PT_16
4252 -- : BFD_RELOC_SH_TLS_GD_32
4253 -- : BFD_RELOC_SH_TLS_LD_32
4254 -- : BFD_RELOC_SH_TLS_LDO_32
4255 -- : BFD_RELOC_SH_TLS_IE_32
4256 -- : BFD_RELOC_SH_TLS_LE_32
4257 -- : BFD_RELOC_SH_TLS_DTPMOD32
4258 -- : BFD_RELOC_SH_TLS_DTPOFF32
4259 -- : BFD_RELOC_SH_TLS_TPOFF32
4260 -- : BFD_RELOC_SH_GOT20
4261 -- : BFD_RELOC_SH_GOTOFF20
4262 -- : BFD_RELOC_SH_GOTFUNCDESC
4263 -- : BFD_RELOC_SH_GOTFUNCDESC20
4264 -- : BFD_RELOC_SH_GOTOFFFUNCDESC
4265 -- : BFD_RELOC_SH_GOTOFFFUNCDESC20
4266 -- : BFD_RELOC_SH_FUNCDESC
4267     Renesas / SuperH SH relocs.  Not all of these appear in object
4268     files.
4269 -- : BFD_RELOC_ARC_NONE
4270 -- : BFD_RELOC_ARC_8
4271 -- : BFD_RELOC_ARC_16
4272 -- : BFD_RELOC_ARC_24
4273 -- : BFD_RELOC_ARC_32
4274 -- : BFD_RELOC_ARC_N8
4275 -- : BFD_RELOC_ARC_N16
4276 -- : BFD_RELOC_ARC_N24
4277 -- : BFD_RELOC_ARC_N32
4278 -- : BFD_RELOC_ARC_SDA
4279 -- : BFD_RELOC_ARC_SECTOFF
4280 -- : BFD_RELOC_ARC_S21H_PCREL
4281 -- : BFD_RELOC_ARC_S21W_PCREL
4282 -- : BFD_RELOC_ARC_S25H_PCREL
4283 -- : BFD_RELOC_ARC_S25W_PCREL
4284 -- : BFD_RELOC_ARC_SDA32
4285 -- : BFD_RELOC_ARC_SDA_LDST
4286 -- : BFD_RELOC_ARC_SDA_LDST1
4287 -- : BFD_RELOC_ARC_SDA_LDST2
4288 -- : BFD_RELOC_ARC_SDA16_LD
4289 -- : BFD_RELOC_ARC_SDA16_LD1
4290 -- : BFD_RELOC_ARC_SDA16_LD2
4291 -- : BFD_RELOC_ARC_S13_PCREL
4292 -- : BFD_RELOC_ARC_W
4293 -- : BFD_RELOC_ARC_32_ME
4294 -- : BFD_RELOC_ARC_32_ME_S
4295 -- : BFD_RELOC_ARC_N32_ME
4296 -- : BFD_RELOC_ARC_SECTOFF_ME
4297 -- : BFD_RELOC_ARC_SDA32_ME
4298 -- : BFD_RELOC_ARC_W_ME
4299 -- : BFD_RELOC_AC_SECTOFF_U8
4300 -- : BFD_RELOC_AC_SECTOFF_U8_1
4301 -- : BFD_RELOC_AC_SECTOFF_U8_2
4302 -- : BFD_RELOC_AC_SECTOFF_S9
4303 -- : BFD_RELOC_AC_SECTOFF_S9_1
4304 -- : BFD_RELOC_AC_SECTOFF_S9_2
4305 -- : BFD_RELOC_ARC_SECTOFF_ME_1
4306 -- : BFD_RELOC_ARC_SECTOFF_ME_2
4307 -- : BFD_RELOC_ARC_SECTOFF_1
4308 -- : BFD_RELOC_ARC_SECTOFF_2
4309 -- : BFD_RELOC_ARC_SDA_12
4310 -- : BFD_RELOC_ARC_SDA16_ST2
4311 -- : BFD_RELOC_ARC_32_PCREL
4312 -- : BFD_RELOC_ARC_PC32
4313 -- : BFD_RELOC_ARC_GOT32
4314 -- : BFD_RELOC_ARC_GOTPC32
4315 -- : BFD_RELOC_ARC_PLT32
4316 -- : BFD_RELOC_ARC_COPY
4317 -- : BFD_RELOC_ARC_GLOB_DAT
4318 -- : BFD_RELOC_ARC_JMP_SLOT
4319 -- : BFD_RELOC_ARC_RELATIVE
4320 -- : BFD_RELOC_ARC_GOTOFF
4321 -- : BFD_RELOC_ARC_GOTPC
4322 -- : BFD_RELOC_ARC_S21W_PCREL_PLT
4323 -- : BFD_RELOC_ARC_S25H_PCREL_PLT
4324 -- : BFD_RELOC_ARC_TLS_DTPMOD
4325 -- : BFD_RELOC_ARC_TLS_TPOFF
4326 -- : BFD_RELOC_ARC_TLS_GD_GOT
4327 -- : BFD_RELOC_ARC_TLS_GD_LD
4328 -- : BFD_RELOC_ARC_TLS_GD_CALL
4329 -- : BFD_RELOC_ARC_TLS_IE_GOT
4330 -- : BFD_RELOC_ARC_TLS_DTPOFF
4331 -- : BFD_RELOC_ARC_TLS_DTPOFF_S9
4332 -- : BFD_RELOC_ARC_TLS_LE_S9
4333 -- : BFD_RELOC_ARC_TLS_LE_32
4334 -- : BFD_RELOC_ARC_S25W_PCREL_PLT
4335 -- : BFD_RELOC_ARC_S21H_PCREL_PLT
4336 -- : BFD_RELOC_ARC_NPS_CMEM16
4337 -- : BFD_RELOC_ARC_JLI_SECTOFF
4338     ARC relocs.
4339 -- : BFD_RELOC_BFIN_16_IMM
4340     ADI Blackfin 16 bit immediate absolute reloc.
4341 -- : BFD_RELOC_BFIN_16_HIGH
4342     ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
4343 -- : BFD_RELOC_BFIN_4_PCREL
4344     ADI Blackfin ���a��� part of LSETUP.
4345 -- : BFD_RELOC_BFIN_5_PCREL
4346     ADI Blackfin.
4347 -- : BFD_RELOC_BFIN_16_LOW
4348     ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
4349 -- : BFD_RELOC_BFIN_10_PCREL
4350     ADI Blackfin.
4351 -- : BFD_RELOC_BFIN_11_PCREL
4352     ADI Blackfin ���b��� part of LSETUP.
4353 -- : BFD_RELOC_BFIN_12_PCREL_JUMP
4354     ADI Blackfin.
4355 -- : BFD_RELOC_BFIN_12_PCREL_JUMP_S
4356     ADI Blackfin Short jump, pcrel.
4357 -- : BFD_RELOC_BFIN_24_PCREL_CALL_X
4358     ADI Blackfin Call.x not implemented.
4359 -- : BFD_RELOC_BFIN_24_PCREL_JUMP_L
4360     ADI Blackfin Long Jump pcrel.
4361 -- : BFD_RELOC_BFIN_GOT17M4
4362 -- : BFD_RELOC_BFIN_GOTHI
4363 -- : BFD_RELOC_BFIN_GOTLO
4364 -- : BFD_RELOC_BFIN_FUNCDESC
4365 -- : BFD_RELOC_BFIN_FUNCDESC_GOT17M4
4366 -- : BFD_RELOC_BFIN_FUNCDESC_GOTHI
4367 -- : BFD_RELOC_BFIN_FUNCDESC_GOTLO
4368 -- : BFD_RELOC_BFIN_FUNCDESC_VALUE
4369 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
4370 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
4371 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
4372 -- : BFD_RELOC_BFIN_GOTOFF17M4
4373 -- : BFD_RELOC_BFIN_GOTOFFHI
4374 -- : BFD_RELOC_BFIN_GOTOFFLO
4375     ADI Blackfin FD-PIC relocations.
4376 -- : BFD_RELOC_BFIN_GOT
4377     ADI Blackfin GOT relocation.
4378 -- : BFD_RELOC_BFIN_PLTPC
4379     ADI Blackfin PLTPC relocation.
4380 -- : BFD_ARELOC_BFIN_PUSH
4381     ADI Blackfin arithmetic relocation.
4382 -- : BFD_ARELOC_BFIN_CONST
4383     ADI Blackfin arithmetic relocation.
4384 -- : BFD_ARELOC_BFIN_ADD
4385     ADI Blackfin arithmetic relocation.
4386 -- : BFD_ARELOC_BFIN_SUB
4387     ADI Blackfin arithmetic relocation.
4388 -- : BFD_ARELOC_BFIN_MULT
4389     ADI Blackfin arithmetic relocation.
4390 -- : BFD_ARELOC_BFIN_DIV
4391     ADI Blackfin arithmetic relocation.
4392 -- : BFD_ARELOC_BFIN_MOD
4393     ADI Blackfin arithmetic relocation.
4394 -- : BFD_ARELOC_BFIN_LSHIFT
4395     ADI Blackfin arithmetic relocation.
4396 -- : BFD_ARELOC_BFIN_RSHIFT
4397     ADI Blackfin arithmetic relocation.
4398 -- : BFD_ARELOC_BFIN_AND
4399     ADI Blackfin arithmetic relocation.
4400 -- : BFD_ARELOC_BFIN_OR
4401     ADI Blackfin arithmetic relocation.
4402 -- : BFD_ARELOC_BFIN_XOR
4403     ADI Blackfin arithmetic relocation.
4404 -- : BFD_ARELOC_BFIN_LAND
4405     ADI Blackfin arithmetic relocation.
4406 -- : BFD_ARELOC_BFIN_LOR
4407     ADI Blackfin arithmetic relocation.
4408 -- : BFD_ARELOC_BFIN_LEN
4409     ADI Blackfin arithmetic relocation.
4410 -- : BFD_ARELOC_BFIN_NEG
4411     ADI Blackfin arithmetic relocation.
4412 -- : BFD_ARELOC_BFIN_COMP
4413     ADI Blackfin arithmetic relocation.
4414 -- : BFD_ARELOC_BFIN_PAGE
4415     ADI Blackfin arithmetic relocation.
4416 -- : BFD_ARELOC_BFIN_HWPAGE
4417     ADI Blackfin arithmetic relocation.
4418 -- : BFD_ARELOC_BFIN_ADDR
4419     ADI Blackfin arithmetic relocation.
4420 -- : BFD_RELOC_D10V_10_PCREL_R
4421     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4422     bits assumed to be 0.
4423 -- : BFD_RELOC_D10V_10_PCREL_L
4424     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4425     bits assumed to be 0.  This is the same as the previous reloc
4426     except it is in the left container, i.e., shifted left 15 bits.
4427 -- : BFD_RELOC_D10V_18
4428     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4429 -- : BFD_RELOC_D10V_18_PCREL
4430     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4431 -- : BFD_RELOC_D30V_6
4432     Mitsubishi D30V relocs.  This is a 6-bit absolute reloc.
4433 -- : BFD_RELOC_D30V_9_PCREL
4434     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4435     be 0.
4436 -- : BFD_RELOC_D30V_9_PCREL_R
4437     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4438     be 0.  Same as the previous reloc but on the right side of the
4439     container.
4440 -- : BFD_RELOC_D30V_15
4441     This is a 12-bit absolute reloc with the right 3 bitsassumed to be
4442     0.
4443 -- : BFD_RELOC_D30V_15_PCREL
4444     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4445     be 0.
4446 -- : BFD_RELOC_D30V_15_PCREL_R
4447     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4448     be 0.  Same as the previous reloc but on the right side of the
4449     container.
4450 -- : BFD_RELOC_D30V_21
4451     This is an 18-bit absolute reloc with the right 3 bits assumed to
4452     be 0.
4453 -- : BFD_RELOC_D30V_21_PCREL
4454     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4455     to be 0.
4456 -- : BFD_RELOC_D30V_21_PCREL_R
4457     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4458     to be 0.  Same as the previous reloc but on the right side of the
4459     container.
4460 -- : BFD_RELOC_D30V_32
4461     This is a 32-bit absolute reloc.
4462 -- : BFD_RELOC_D30V_32_PCREL
4463     This is a 32-bit pc-relative reloc.
4464 -- : BFD_RELOC_DLX_HI16_S
4465 -- : BFD_RELOC_DLX_LO16
4466 -- : BFD_RELOC_DLX_JMP26
4467     DLX relocs.
4468 -- : BFD_RELOC_M32C_HI8
4469 -- : BFD_RELOC_M32C_RL_JUMP
4470 -- : BFD_RELOC_M32C_RL_1ADDR
4471 -- : BFD_RELOC_M32C_RL_2ADDR
4472     Renesas M16C/M32C Relocations.
4473 -- : BFD_RELOC_M32R_24
4474     Renesas M32R (formerly Mitsubishi M32R) relocs.  This is a 24 bit
4475     absolute address.
4476 -- : BFD_RELOC_M32R_10_PCREL
4477     This is a 10-bit pc-relative reloc with the right 2 bits assumed to
4478     be 0.
4479 -- : BFD_RELOC_M32R_18_PCREL
4480     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4481 -- : BFD_RELOC_M32R_26_PCREL
4482     This is a 26-bit reloc with the right 2 bits assumed to be 0.
4483 -- : BFD_RELOC_M32R_HI16_ULO
4484     This is a 16-bit reloc containing the high 16 bits of an address
4485     used when the lower 16 bits are treated as unsigned.
4486 -- : BFD_RELOC_M32R_HI16_SLO
4487     This is a 16-bit reloc containing the high 16 bits of an address
4488     used when the lower 16 bits are treated as signed.
4489 -- : BFD_RELOC_M32R_LO16
4490     This is a 16-bit reloc containing the lower 16 bits of an address.
4491 -- : BFD_RELOC_M32R_SDA16
4492     This is a 16-bit reloc containing the small data area offset for
4493     use in add3, load, and store instructions.
4494 -- : BFD_RELOC_M32R_GOT24
4495 -- : BFD_RELOC_M32R_26_PLTREL
4496 -- : BFD_RELOC_M32R_COPY
4497 -- : BFD_RELOC_M32R_GLOB_DAT
4498 -- : BFD_RELOC_M32R_JMP_SLOT
4499 -- : BFD_RELOC_M32R_RELATIVE
4500 -- : BFD_RELOC_M32R_GOTOFF
4501 -- : BFD_RELOC_M32R_GOTOFF_HI_ULO
4502 -- : BFD_RELOC_M32R_GOTOFF_HI_SLO
4503 -- : BFD_RELOC_M32R_GOTOFF_LO
4504 -- : BFD_RELOC_M32R_GOTPC24
4505 -- : BFD_RELOC_M32R_GOT16_HI_ULO
4506 -- : BFD_RELOC_M32R_GOT16_HI_SLO
4507 -- : BFD_RELOC_M32R_GOT16_LO
4508 -- : BFD_RELOC_M32R_GOTPC_HI_ULO
4509 -- : BFD_RELOC_M32R_GOTPC_HI_SLO
4510 -- : BFD_RELOC_M32R_GOTPC_LO
4511     For PIC.
4512 -- : BFD_RELOC_NDS32_20
4513     NDS32 relocs.  This is a 20 bit absolute address.
4514 -- : BFD_RELOC_NDS32_9_PCREL
4515     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4516     be 0.
4517 -- : BFD_RELOC_NDS32_WORD_9_PCREL
4518     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4519     be 0.
4520 -- : BFD_RELOC_NDS32_15_PCREL
4521     This is an 15-bit reloc with the right 1 bit assumed to be 0.
4522 -- : BFD_RELOC_NDS32_17_PCREL
4523     This is an 17-bit reloc with the right 1 bit assumed to be 0.
4524 -- : BFD_RELOC_NDS32_25_PCREL
4525     This is a 25-bit reloc with the right 1 bit assumed to be 0.
4526 -- : BFD_RELOC_NDS32_HI20
4527     This is a 20-bit reloc containing the high 20 bits of an address
4528     used with the lower 12 bits.
4529 -- : BFD_RELOC_NDS32_LO12S3
4530     This is a 12-bit reloc containing the lower 12 bits of an address
4531     then shift right by 3.  This is used with ldi,sdi.
4532 -- : BFD_RELOC_NDS32_LO12S2
4533     This is a 12-bit reloc containing the lower 12 bits of an address
4534     then shift left by 2.  This is used with lwi,swi.
4535 -- : BFD_RELOC_NDS32_LO12S1
4536     This is a 12-bit reloc containing the lower 12 bits of an address
4537     then shift left by 1.  This is used with lhi,shi.
4538 -- : BFD_RELOC_NDS32_LO12S0
4539     This is a 12-bit reloc containing the lower 12 bits of an address
4540     then shift left by 0.  This is used with lbisbi.
4541 -- : BFD_RELOC_NDS32_LO12S0_ORI
4542     This is a 12-bit reloc containing the lower 12 bits of an address
4543     then shift left by 0.  This is only used with branch relaxations.
4544 -- : BFD_RELOC_NDS32_SDA15S3
4545     This is a 15-bit reloc containing the small data area 18-bit signed
4546     offset and shift left by 3 for use in ldi, sdi.
4547 -- : BFD_RELOC_NDS32_SDA15S2
4548     This is a 15-bit reloc containing the small data area 17-bit signed
4549     offset and shift left by 2 for use in lwi, swi.
4550 -- : BFD_RELOC_NDS32_SDA15S1
4551     This is a 15-bit reloc containing the small data area 16-bit signed
4552     offset and shift left by 1 for use in lhi, shi.
4553 -- : BFD_RELOC_NDS32_SDA15S0
4554     This is a 15-bit reloc containing the small data area 15-bit signed
4555     offset and shift left by 0 for use in lbi, sbi.
4556 -- : BFD_RELOC_NDS32_SDA16S3
4557     This is a 16-bit reloc containing the small data area 16-bit signed
4558     offset and shift left by 3.
4559 -- : BFD_RELOC_NDS32_SDA17S2
4560     This is a 17-bit reloc containing the small data area 17-bit signed
4561     offset and shift left by 2 for use in lwi.gp, swi.gp.
4562 -- : BFD_RELOC_NDS32_SDA18S1
4563     This is a 18-bit reloc containing the small data area 18-bit signed
4564     offset and shift left by 1 for use in lhi.gp, shi.gp.
4565 -- : BFD_RELOC_NDS32_SDA19S0
4566     This is a 19-bit reloc containing the small data area 19-bit signed
4567     offset and shift left by 0 for use in lbi.gp, sbi.gp.
4568 -- : BFD_RELOC_NDS32_GOT20
4569 -- : BFD_RELOC_NDS32_9_PLTREL
4570 -- : BFD_RELOC_NDS32_25_PLTREL
4571 -- : BFD_RELOC_NDS32_COPY
4572 -- : BFD_RELOC_NDS32_GLOB_DAT
4573 -- : BFD_RELOC_NDS32_JMP_SLOT
4574 -- : BFD_RELOC_NDS32_RELATIVE
4575 -- : BFD_RELOC_NDS32_GOTOFF
4576 -- : BFD_RELOC_NDS32_GOTOFF_HI20
4577 -- : BFD_RELOC_NDS32_GOTOFF_LO12
4578 -- : BFD_RELOC_NDS32_GOTPC20
4579 -- : BFD_RELOC_NDS32_GOT_HI20
4580 -- : BFD_RELOC_NDS32_GOT_LO12
4581 -- : BFD_RELOC_NDS32_GOTPC_HI20
4582 -- : BFD_RELOC_NDS32_GOTPC_LO12
4583     For PIC.
4584 -- : BFD_RELOC_NDS32_INSN16
4585 -- : BFD_RELOC_NDS32_LABEL
4586 -- : BFD_RELOC_NDS32_LONGCALL1
4587 -- : BFD_RELOC_NDS32_LONGCALL2
4588 -- : BFD_RELOC_NDS32_LONGCALL3
4589 -- : BFD_RELOC_NDS32_LONGJUMP1
4590 -- : BFD_RELOC_NDS32_LONGJUMP2
4591 -- : BFD_RELOC_NDS32_LONGJUMP3
4592 -- : BFD_RELOC_NDS32_LOADSTORE
4593 -- : BFD_RELOC_NDS32_9_FIXED
4594 -- : BFD_RELOC_NDS32_15_FIXED
4595 -- : BFD_RELOC_NDS32_17_FIXED
4596 -- : BFD_RELOC_NDS32_25_FIXED
4597 -- : BFD_RELOC_NDS32_LONGCALL4
4598 -- : BFD_RELOC_NDS32_LONGCALL5
4599 -- : BFD_RELOC_NDS32_LONGCALL6
4600 -- : BFD_RELOC_NDS32_LONGJUMP4
4601 -- : BFD_RELOC_NDS32_LONGJUMP5
4602 -- : BFD_RELOC_NDS32_LONGJUMP6
4603 -- : BFD_RELOC_NDS32_LONGJUMP7
4604     For relax.
4605 -- : BFD_RELOC_NDS32_PLTREL_HI20
4606 -- : BFD_RELOC_NDS32_PLTREL_LO12
4607 -- : BFD_RELOC_NDS32_PLT_GOTREL_HI20
4608 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO12
4609     For PIC.
4610 -- : BFD_RELOC_NDS32_SDA12S2_DP
4611 -- : BFD_RELOC_NDS32_SDA12S2_SP
4612 -- : BFD_RELOC_NDS32_LO12S2_DP
4613 -- : BFD_RELOC_NDS32_LO12S2_SP
4614     For floating point.
4615 -- : BFD_RELOC_NDS32_DWARF2_OP1
4616 -- : BFD_RELOC_NDS32_DWARF2_OP2
4617 -- : BFD_RELOC_NDS32_DWARF2_LEB
4618     For dwarf2 debug_line.
4619 -- : BFD_RELOC_NDS32_UPDATE_TA
4620     For eliminating 16-bit instructions.
4621 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO20
4622 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO15
4623 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO19
4624 -- : BFD_RELOC_NDS32_GOT_LO15
4625 -- : BFD_RELOC_NDS32_GOT_LO19
4626 -- : BFD_RELOC_NDS32_GOTOFF_LO15
4627 -- : BFD_RELOC_NDS32_GOTOFF_LO19
4628 -- : BFD_RELOC_NDS32_GOT15S2
4629 -- : BFD_RELOC_NDS32_GOT17S2
4630     For PIC object relaxation.
4631 -- : BFD_RELOC_NDS32_5
4632     NDS32 relocs.  This is a 5 bit absolute address.
4633 -- : BFD_RELOC_NDS32_10_UPCREL
4634     This is a 10-bit unsigned pc-relative reloc with the right 1 bit
4635     assumed to be 0.
4636 -- : BFD_RELOC_NDS32_SDA_FP7U2_RELA
4637     If fp were omitted, fp can used as another gp.
4638 -- : BFD_RELOC_NDS32_RELAX_ENTRY
4639 -- : BFD_RELOC_NDS32_GOT_SUFF
4640 -- : BFD_RELOC_NDS32_GOTOFF_SUFF
4641 -- : BFD_RELOC_NDS32_PLT_GOT_SUFF
4642 -- : BFD_RELOC_NDS32_MULCALL_SUFF
4643 -- : BFD_RELOC_NDS32_PTR
4644 -- : BFD_RELOC_NDS32_PTR_COUNT
4645 -- : BFD_RELOC_NDS32_PTR_RESOLVED
4646 -- : BFD_RELOC_NDS32_PLTBLOCK
4647 -- : BFD_RELOC_NDS32_RELAX_REGION_BEGIN
4648 -- : BFD_RELOC_NDS32_RELAX_REGION_END
4649 -- : BFD_RELOC_NDS32_MINUEND
4650 -- : BFD_RELOC_NDS32_SUBTRAHEND
4651 -- : BFD_RELOC_NDS32_DIFF8
4652 -- : BFD_RELOC_NDS32_DIFF16
4653 -- : BFD_RELOC_NDS32_DIFF32
4654 -- : BFD_RELOC_NDS32_DIFF_ULEB128
4655 -- : BFD_RELOC_NDS32_EMPTY
4656     Relaxation relative relocation types.
4657 -- : BFD_RELOC_NDS32_25_ABS
4658     This is a 25 bit absolute address.
4659 -- : BFD_RELOC_NDS32_DATA
4660 -- : BFD_RELOC_NDS32_TRAN
4661 -- : BFD_RELOC_NDS32_17IFC_PCREL
4662 -- : BFD_RELOC_NDS32_10IFCU_PCREL
4663     For ex9 and ifc using.
4664 -- : BFD_RELOC_NDS32_TPOFF
4665 -- : BFD_RELOC_NDS32_GOTTPOFF
4666 -- : BFD_RELOC_NDS32_TLS_LE_HI20
4667 -- : BFD_RELOC_NDS32_TLS_LE_LO12
4668 -- : BFD_RELOC_NDS32_TLS_LE_20
4669 -- : BFD_RELOC_NDS32_TLS_LE_15S0
4670 -- : BFD_RELOC_NDS32_TLS_LE_15S1
4671 -- : BFD_RELOC_NDS32_TLS_LE_15S2
4672 -- : BFD_RELOC_NDS32_TLS_LE_ADD
4673 -- : BFD_RELOC_NDS32_TLS_LE_LS
4674 -- : BFD_RELOC_NDS32_TLS_IE_HI20
4675 -- : BFD_RELOC_NDS32_TLS_IE_LO12
4676 -- : BFD_RELOC_NDS32_TLS_IE_LO12S2
4677 -- : BFD_RELOC_NDS32_TLS_IEGP_HI20
4678 -- : BFD_RELOC_NDS32_TLS_IEGP_LO12
4679 -- : BFD_RELOC_NDS32_TLS_IEGP_LO12S2
4680 -- : BFD_RELOC_NDS32_TLS_IEGP_LW
4681 -- : BFD_RELOC_NDS32_TLS_DESC
4682 -- : BFD_RELOC_NDS32_TLS_DESC_HI20
4683 -- : BFD_RELOC_NDS32_TLS_DESC_LO12
4684 -- : BFD_RELOC_NDS32_TLS_DESC_20
4685 -- : BFD_RELOC_NDS32_TLS_DESC_SDA17S2
4686 -- : BFD_RELOC_NDS32_TLS_DESC_ADD
4687 -- : BFD_RELOC_NDS32_TLS_DESC_FUNC
4688 -- : BFD_RELOC_NDS32_TLS_DESC_CALL
4689 -- : BFD_RELOC_NDS32_TLS_DESC_MEM
4690 -- : BFD_RELOC_NDS32_REMOVE
4691 -- : BFD_RELOC_NDS32_GROUP
4692     For TLS.
4693 -- : BFD_RELOC_NDS32_LSI
4694     For floating load store relaxation.
4695 -- : BFD_RELOC_V850_9_PCREL
4696     This is a 9-bit reloc.
4697 -- : BFD_RELOC_V850_22_PCREL
4698     This is a 22-bit reloc.
4699 -- : BFD_RELOC_V850_SDA_16_16_OFFSET
4700     This is a 16 bit offset from the short data area pointer.
4701 -- : BFD_RELOC_V850_SDA_15_16_OFFSET
4702     This is a 16 bit offset (of which only 15 bits are used) from the
4703     short data area pointer.
4704 -- : BFD_RELOC_V850_ZDA_16_16_OFFSET
4705     This is a 16 bit offset from the zero data area pointer.
4706 -- : BFD_RELOC_V850_ZDA_15_16_OFFSET
4707     This is a 16 bit offset (of which only 15 bits are used) from the
4708     zero data area pointer.
4709 -- : BFD_RELOC_V850_TDA_6_8_OFFSET
4710     This is an 8 bit offset (of which only 6 bits are used) from the
4711     tiny data area pointer.
4712 -- : BFD_RELOC_V850_TDA_7_8_OFFSET
4713     This is an 8bit offset (of which only 7 bits are used) from the
4714     tiny data area pointer.
4715 -- : BFD_RELOC_V850_TDA_7_7_OFFSET
4716     This is a 7 bit offset from the tiny data area pointer.
4717 -- : BFD_RELOC_V850_TDA_16_16_OFFSET
4718     This is a 16 bit offset from the tiny data area pointer.
4719 -- : BFD_RELOC_V850_TDA_4_5_OFFSET
4720     This is a 5 bit offset (of which only 4 bits are used) from the
4721     tiny data area pointer.
4722 -- : BFD_RELOC_V850_TDA_4_4_OFFSET
4723     This is a 4 bit offset from the tiny data area pointer.
4724 -- : BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
4725     This is a 16 bit offset from the short data area pointer, with the
4726     bits placed non-contiguously in the instruction.
4727 -- : BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
4728     This is a 16 bit offset from the zero data area pointer, with the
4729     bits placed non-contiguously in the instruction.
4730 -- : BFD_RELOC_V850_CALLT_6_7_OFFSET
4731     This is a 6 bit offset from the call table base pointer.
4732 -- : BFD_RELOC_V850_CALLT_16_16_OFFSET
4733     This is a 16 bit offset from the call table base pointer.
4734 -- : BFD_RELOC_V850_LONGCALL
4735     Used for relaxing indirect function calls.
4736 -- : BFD_RELOC_V850_LONGJUMP
4737     Used for relaxing indirect jumps.
4738 -- : BFD_RELOC_V850_ALIGN
4739     Used to maintain alignment whilst relaxing.
4740 -- : BFD_RELOC_V850_LO16_SPLIT_OFFSET
4741     This is a variation of BFD_RELOC_LO16 that can be used in v850e
4742     ld.bu instructions.
4743 -- : BFD_RELOC_V850_16_PCREL
4744     This is a 16-bit reloc.
4745 -- : BFD_RELOC_V850_17_PCREL
4746     This is a 17-bit reloc.
4747 -- : BFD_RELOC_V850_23
4748     This is a 23-bit reloc.
4749 -- : BFD_RELOC_V850_32_PCREL
4750     This is a 32-bit reloc.
4751 -- : BFD_RELOC_V850_32_ABS
4752     This is a 32-bit reloc.
4753 -- : BFD_RELOC_V850_16_SPLIT_OFFSET
4754     This is a 16-bit reloc.
4755 -- : BFD_RELOC_V850_16_S1
4756     This is a 16-bit reloc.
4757 -- : BFD_RELOC_V850_LO16_S1
4758     Low 16 bits.  16 bit shifted by 1.
4759 -- : BFD_RELOC_V850_CALLT_15_16_OFFSET
4760     This is a 16 bit offset from the call table base pointer.
4761 -- : BFD_RELOC_V850_32_GOTPCREL
4762 -- : BFD_RELOC_V850_16_GOT
4763 -- : BFD_RELOC_V850_32_GOT
4764 -- : BFD_RELOC_V850_22_PLT_PCREL
4765 -- : BFD_RELOC_V850_32_PLT_PCREL
4766 -- : BFD_RELOC_V850_COPY
4767 -- : BFD_RELOC_V850_GLOB_DAT
4768 -- : BFD_RELOC_V850_JMP_SLOT
4769 -- : BFD_RELOC_V850_RELATIVE
4770 -- : BFD_RELOC_V850_16_GOTOFF
4771 -- : BFD_RELOC_V850_32_GOTOFF
4772     DSO relocations.
4773 -- : BFD_RELOC_V850_CODE
4774     Start code.
4775 -- : BFD_RELOC_V850_DATA
4776     Start data in text.
4777 -- : BFD_RELOC_TIC30_LDP
4778     This is a 8bit DP reloc for the tms320c30, where the most
4779     significant 8 bits of a 24 bit word are placed into the least
4780     significant 8 bits of the opcode.
4781 -- : BFD_RELOC_TIC54X_PARTLS7
4782     This is a 7bit reloc for the tms320c54x, where the least
4783     significant 7 bits of a 16 bit word are placed into the least
4784     significant 7 bits of the opcode.
4785 -- : BFD_RELOC_TIC54X_PARTMS9
4786     This is a 9bit DP reloc for the tms320c54x, where the most
4787     significant 9 bits of a 16 bit word are placed into the least
4788     significant 9 bits of the opcode.
4789 -- : BFD_RELOC_TIC54X_23
4790     This is an extended address 23-bit reloc for the tms320c54x.
4791 -- : BFD_RELOC_TIC54X_16_OF_23
4792     This is a 16-bit reloc for the tms320c54x, where the least
4793     significant 16 bits of a 23-bit extended address are placed into
4794     the opcode.
4795 -- : BFD_RELOC_TIC54X_MS7_OF_23
4796     This is a reloc for the tms320c54x, where the most significant 7
4797     bits of a 23-bit extended address are placed into the opcode.
4798 -- : BFD_RELOC_C6000_PCR_S21
4799 -- : BFD_RELOC_C6000_PCR_S12
4800 -- : BFD_RELOC_C6000_PCR_S10
4801 -- : BFD_RELOC_C6000_PCR_S7
4802 -- : BFD_RELOC_C6000_ABS_S16
4803 -- : BFD_RELOC_C6000_ABS_L16
4804 -- : BFD_RELOC_C6000_ABS_H16
4805 -- : BFD_RELOC_C6000_SBR_U15_B
4806 -- : BFD_RELOC_C6000_SBR_U15_H
4807 -- : BFD_RELOC_C6000_SBR_U15_W
4808 -- : BFD_RELOC_C6000_SBR_S16
4809 -- : BFD_RELOC_C6000_SBR_L16_B
4810 -- : BFD_RELOC_C6000_SBR_L16_H
4811 -- : BFD_RELOC_C6000_SBR_L16_W
4812 -- : BFD_RELOC_C6000_SBR_H16_B
4813 -- : BFD_RELOC_C6000_SBR_H16_H
4814 -- : BFD_RELOC_C6000_SBR_H16_W
4815 -- : BFD_RELOC_C6000_SBR_GOT_U15_W
4816 -- : BFD_RELOC_C6000_SBR_GOT_L16_W
4817 -- : BFD_RELOC_C6000_SBR_GOT_H16_W
4818 -- : BFD_RELOC_C6000_DSBT_INDEX
4819 -- : BFD_RELOC_C6000_PREL31
4820 -- : BFD_RELOC_C6000_COPY
4821 -- : BFD_RELOC_C6000_JUMP_SLOT
4822 -- : BFD_RELOC_C6000_EHTYPE
4823 -- : BFD_RELOC_C6000_PCR_H16
4824 -- : BFD_RELOC_C6000_PCR_L16
4825 -- : BFD_RELOC_C6000_ALIGN
4826 -- : BFD_RELOC_C6000_FPHEAD
4827 -- : BFD_RELOC_C6000_NOCMP
4828     TMS320C6000 relocations.
4829 -- : BFD_RELOC_FR30_48
4830     This is a 48 bit reloc for the FR30 that stores 32 bits.
4831 -- : BFD_RELOC_FR30_20
4832     This is a 32 bit reloc for the FR30 that stores 20 bits split up
4833     into two sections.
4834 -- : BFD_RELOC_FR30_6_IN_4
4835     This is a 16 bit reloc for the FR30 that stores a 6 bit word offset
4836     in 4 bits.
4837 -- : BFD_RELOC_FR30_8_IN_8
4838     This is a 16 bit reloc for the FR30 that stores an 8 bit byte
4839     offset into 8 bits.
4840 -- : BFD_RELOC_FR30_9_IN_8
4841     This is a 16 bit reloc for the FR30 that stores a 9 bit short
4842     offset into 8 bits.
4843 -- : BFD_RELOC_FR30_10_IN_8
4844     This is a 16 bit reloc for the FR30 that stores a 10 bit word
4845     offset into 8 bits.
4846 -- : BFD_RELOC_FR30_9_PCREL
4847     This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
4848     short offset into 8 bits.
4849 -- : BFD_RELOC_FR30_12_PCREL
4850     This is a 16 bit reloc for the FR30 that stores a 12 bit pc
4851     relative short offset into 11 bits.
4852 -- : BFD_RELOC_MCORE_PCREL_IMM8BY4
4853 -- : BFD_RELOC_MCORE_PCREL_IMM11BY2
4854 -- : BFD_RELOC_MCORE_PCREL_IMM4BY2
4855 -- : BFD_RELOC_MCORE_PCREL_32
4856 -- : BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
4857 -- : BFD_RELOC_MCORE_RVA
4858     Motorola Mcore relocations.
4859 -- : BFD_RELOC_MEP_8
4860 -- : BFD_RELOC_MEP_16
4861 -- : BFD_RELOC_MEP_32
4862 -- : BFD_RELOC_MEP_PCREL8A2
4863 -- : BFD_RELOC_MEP_PCREL12A2
4864 -- : BFD_RELOC_MEP_PCREL17A2
4865 -- : BFD_RELOC_MEP_PCREL24A2
4866 -- : BFD_RELOC_MEP_PCABS24A2
4867 -- : BFD_RELOC_MEP_LOW16
4868 -- : BFD_RELOC_MEP_HI16U
4869 -- : BFD_RELOC_MEP_HI16S
4870 -- : BFD_RELOC_MEP_GPREL
4871 -- : BFD_RELOC_MEP_TPREL
4872 -- : BFD_RELOC_MEP_TPREL7
4873 -- : BFD_RELOC_MEP_TPREL7A2
4874 -- : BFD_RELOC_MEP_TPREL7A4
4875 -- : BFD_RELOC_MEP_UIMM24
4876 -- : BFD_RELOC_MEP_ADDR24A4
4877 -- : BFD_RELOC_MEP_GNU_VTINHERIT
4878 -- : BFD_RELOC_MEP_GNU_VTENTRY
4879     Toshiba Media Processor Relocations.
4880 -- : BFD_RELOC_METAG_HIADDR16
4881 -- : BFD_RELOC_METAG_LOADDR16
4882 -- : BFD_RELOC_METAG_RELBRANCH
4883 -- : BFD_RELOC_METAG_GETSETOFF
4884 -- : BFD_RELOC_METAG_HIOG
4885 -- : BFD_RELOC_METAG_LOOG
4886 -- : BFD_RELOC_METAG_REL8
4887 -- : BFD_RELOC_METAG_REL16
4888 -- : BFD_RELOC_METAG_HI16_GOTOFF
4889 -- : BFD_RELOC_METAG_LO16_GOTOFF
4890 -- : BFD_RELOC_METAG_GETSET_GOTOFF
4891 -- : BFD_RELOC_METAG_GETSET_GOT
4892 -- : BFD_RELOC_METAG_HI16_GOTPC
4893 -- : BFD_RELOC_METAG_LO16_GOTPC
4894 -- : BFD_RELOC_METAG_HI16_PLT
4895 -- : BFD_RELOC_METAG_LO16_PLT
4896 -- : BFD_RELOC_METAG_RELBRANCH_PLT
4897 -- : BFD_RELOC_METAG_GOTOFF
4898 -- : BFD_RELOC_METAG_PLT
4899 -- : BFD_RELOC_METAG_COPY
4900 -- : BFD_RELOC_METAG_JMP_SLOT
4901 -- : BFD_RELOC_METAG_RELATIVE
4902 -- : BFD_RELOC_METAG_GLOB_DAT
4903 -- : BFD_RELOC_METAG_TLS_GD
4904 -- : BFD_RELOC_METAG_TLS_LDM
4905 -- : BFD_RELOC_METAG_TLS_LDO_HI16
4906 -- : BFD_RELOC_METAG_TLS_LDO_LO16
4907 -- : BFD_RELOC_METAG_TLS_LDO
4908 -- : BFD_RELOC_METAG_TLS_IE
4909 -- : BFD_RELOC_METAG_TLS_IENONPIC
4910 -- : BFD_RELOC_METAG_TLS_IENONPIC_HI16
4911 -- : BFD_RELOC_METAG_TLS_IENONPIC_LO16
4912 -- : BFD_RELOC_METAG_TLS_TPOFF
4913 -- : BFD_RELOC_METAG_TLS_DTPMOD
4914 -- : BFD_RELOC_METAG_TLS_DTPOFF
4915 -- : BFD_RELOC_METAG_TLS_LE
4916 -- : BFD_RELOC_METAG_TLS_LE_HI16
4917 -- : BFD_RELOC_METAG_TLS_LE_LO16
4918     Imagination Technologies Meta relocations.
4919 -- : BFD_RELOC_MMIX_GETA
4920 -- : BFD_RELOC_MMIX_GETA_1
4921 -- : BFD_RELOC_MMIX_GETA_2
4922 -- : BFD_RELOC_MMIX_GETA_3
4923     These are relocations for the GETA instruction.
4924 -- : BFD_RELOC_MMIX_CBRANCH
4925 -- : BFD_RELOC_MMIX_CBRANCH_J
4926 -- : BFD_RELOC_MMIX_CBRANCH_1
4927 -- : BFD_RELOC_MMIX_CBRANCH_2
4928 -- : BFD_RELOC_MMIX_CBRANCH_3
4929     These are relocations for a conditional branch instruction.
4930 -- : BFD_RELOC_MMIX_PUSHJ
4931 -- : BFD_RELOC_MMIX_PUSHJ_1
4932 -- : BFD_RELOC_MMIX_PUSHJ_2
4933 -- : BFD_RELOC_MMIX_PUSHJ_3
4934 -- : BFD_RELOC_MMIX_PUSHJ_STUBBABLE
4935     These are relocations for the PUSHJ instruction.
4936 -- : BFD_RELOC_MMIX_JMP
4937 -- : BFD_RELOC_MMIX_JMP_1
4938 -- : BFD_RELOC_MMIX_JMP_2
4939 -- : BFD_RELOC_MMIX_JMP_3
4940     These are relocations for the JMP instruction.
4941 -- : BFD_RELOC_MMIX_ADDR19
4942     This is a relocation for a relative address as in a GETA
4943     instruction or a branch.
4944 -- : BFD_RELOC_MMIX_ADDR27
4945     This is a relocation for a relative address as in a JMP
4946     instruction.
4947 -- : BFD_RELOC_MMIX_REG_OR_BYTE
4948     This is a relocation for an instruction field that may be a general
4949     register or a value 0..255.
4950 -- : BFD_RELOC_MMIX_REG
4951     This is a relocation for an instruction field that may be a general
4952     register.
4953 -- : BFD_RELOC_MMIX_BASE_PLUS_OFFSET
4954     This is a relocation for two instruction fields holding a register
4955     and an offset, the equivalent of the relocation.
4956 -- : BFD_RELOC_MMIX_LOCAL
4957     This relocation is an assertion that the expression is not
4958     allocated as a global register.  It does not modify contents.
4959 -- : BFD_RELOC_AVR_7_PCREL
4960     This is a 16 bit reloc for the AVR that stores 8 bit pc relative
4961     short offset into 7 bits.
4962 -- : BFD_RELOC_AVR_13_PCREL
4963     This is a 16 bit reloc for the AVR that stores 13 bit pc relative
4964     short offset into 12 bits.
4965 -- : BFD_RELOC_AVR_16_PM
4966     This is a 16 bit reloc for the AVR that stores 17 bit value
4967     (usually program memory address) into 16 bits.
4968 -- : BFD_RELOC_AVR_LO8_LDI
4969     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
4970     data memory address) into 8 bit immediate value of LDI insn.
4971 -- : BFD_RELOC_AVR_HI8_LDI
4972     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
4973     bit of data memory address) into 8 bit immediate value of LDI insn.
4974 -- : BFD_RELOC_AVR_HH8_LDI
4975     This is a 16 bit reloc for the AVR that stores 8 bit value (most
4976     high 8 bit of program memory address) into 8 bit immediate value of
4977     LDI insn.
4978 -- : BFD_RELOC_AVR_MS8_LDI
4979     This is a 16 bit reloc for the AVR that stores 8 bit value (most
4980     high 8 bit of 32 bit value) into 8 bit immediate value of LDI insn.
4981 -- : BFD_RELOC_AVR_LO8_LDI_NEG
4982     This is a 16 bit reloc for the AVR that stores negated 8 bit value
4983     (usually data memory address) into 8 bit immediate value of SUBI
4984     insn.
4985 -- : BFD_RELOC_AVR_HI8_LDI_NEG
4986     This is a 16 bit reloc for the AVR that stores negated 8 bit value
4987     (high 8 bit of data memory address) into 8 bit immediate value of
4988     SUBI insn.
4989 -- : BFD_RELOC_AVR_HH8_LDI_NEG
4990     This is a 16 bit reloc for the AVR that stores negated 8 bit value
4991     (most high 8 bit of program memory address) into 8 bit immediate
4992     value of LDI or SUBI insn.
4993 -- : BFD_RELOC_AVR_MS8_LDI_NEG
4994     This is a 16 bit reloc for the AVR that stores negated 8 bit value
4995     (msb of 32 bit value) into 8 bit immediate value of LDI insn.
4996 -- : BFD_RELOC_AVR_LO8_LDI_PM
4997     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
4998     command address) into 8 bit immediate value of LDI insn.
4999 -- : BFD_RELOC_AVR_LO8_LDI_GS
5000     This is a 16 bit reloc for the AVR that stores 8 bit value (command
5001     address) into 8 bit immediate value of LDI insn.  If the address is
5002     beyond the 128k boundary, the linker inserts a jump stub for this
5003     reloc in the lower 128k.
5004 -- : BFD_RELOC_AVR_HI8_LDI_PM
5005     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5006     bit of command address) into 8 bit immediate value of LDI insn.
5007 -- : BFD_RELOC_AVR_HI8_LDI_GS
5008     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5009     bit of command address) into 8 bit immediate value of LDI insn.  If
5010     the address is beyond the 128k boundary, the linker inserts a jump
5011     stub for this reloc below 128k.
5012 -- : BFD_RELOC_AVR_HH8_LDI_PM
5013     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5014     high 8 bit of command address) into 8 bit immediate value of LDI
5015     insn.
5016 -- : BFD_RELOC_AVR_LO8_LDI_PM_NEG
5017     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5018     (usually command address) into 8 bit immediate value of SUBI insn.
5019 -- : BFD_RELOC_AVR_HI8_LDI_PM_NEG
5020     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5021     (high 8 bit of 16 bit command address) into 8 bit immediate value
5022     of SUBI insn.
5023 -- : BFD_RELOC_AVR_HH8_LDI_PM_NEG
5024     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5025     (high 6 bit of 22 bit command address) into 8 bit immediate value
5026     of SUBI insn.
5027 -- : BFD_RELOC_AVR_CALL
5028     This is a 32 bit reloc for the AVR that stores 23 bit value into 22
5029     bits.
5030 -- : BFD_RELOC_AVR_LDI
5031     This is a 16 bit reloc for the AVR that stores all needed bits for
5032     absolute addressing with ldi with overflow check to linktime.
5033 -- : BFD_RELOC_AVR_6
5034     This is a 6 bit reloc for the AVR that stores offset for ldd/std
5035     instructions.
5036 -- : BFD_RELOC_AVR_6_ADIW
5037     This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
5038     instructions.
5039 -- : BFD_RELOC_AVR_8_LO
5040     This is a 8 bit reloc for the AVR that stores bits 0..7 of a symbol
5041     in .byte lo8(symbol).
5042 -- : BFD_RELOC_AVR_8_HI
5043     This is a 8 bit reloc for the AVR that stores bits 8..15 of a
5044     symbol in .byte hi8(symbol).
5045 -- : BFD_RELOC_AVR_8_HLO
5046     This is a 8 bit reloc for the AVR that stores bits 16..23 of a
5047     symbol in .byte hlo8(symbol).
5048 -- : BFD_RELOC_AVR_DIFF8
5049 -- : BFD_RELOC_AVR_DIFF16
5050 -- : BFD_RELOC_AVR_DIFF32
5051     AVR relocations to mark the difference of two local symbols.  These
5052     are only needed to support linker relaxation and can be ignored
5053     when not relaxing.  The field is set to the value of the difference
5054     assuming no relaxation.  The relocation encodes the position of the
5055     second symbol so the linker can determine whether to adjust the
5056     field value.
5057 -- : BFD_RELOC_AVR_LDS_STS_16
5058     This is a 7 bit reloc for the AVR that stores SRAM address for
5059     16bit lds and sts instructions supported only tiny core.
5060 -- : BFD_RELOC_AVR_PORT6
5061     This is a 6 bit reloc for the AVR that stores an I/O register
5062     number for the IN and OUT instructions.
5063 -- : BFD_RELOC_AVR_PORT5
5064     This is a 5 bit reloc for the AVR that stores an I/O register
5065     number for the SBIC, SBIS, SBI and CBI instructions.
5066 -- : BFD_RELOC_RISCV_HI20
5067 -- : BFD_RELOC_RISCV_PCREL_HI20
5068 -- : BFD_RELOC_RISCV_PCREL_LO12_I
5069 -- : BFD_RELOC_RISCV_PCREL_LO12_S
5070 -- : BFD_RELOC_RISCV_LO12_I
5071 -- : BFD_RELOC_RISCV_LO12_S
5072 -- : BFD_RELOC_RISCV_GPREL12_I
5073 -- : BFD_RELOC_RISCV_GPREL12_S
5074 -- : BFD_RELOC_RISCV_TPREL_HI20
5075 -- : BFD_RELOC_RISCV_TPREL_LO12_I
5076 -- : BFD_RELOC_RISCV_TPREL_LO12_S
5077 -- : BFD_RELOC_RISCV_TPREL_ADD
5078 -- : BFD_RELOC_RISCV_CALL
5079 -- : BFD_RELOC_RISCV_CALL_PLT
5080 -- : BFD_RELOC_RISCV_ADD8
5081 -- : BFD_RELOC_RISCV_ADD16
5082 -- : BFD_RELOC_RISCV_ADD32
5083 -- : BFD_RELOC_RISCV_ADD64
5084 -- : BFD_RELOC_RISCV_SUB8
5085 -- : BFD_RELOC_RISCV_SUB16
5086 -- : BFD_RELOC_RISCV_SUB32
5087 -- : BFD_RELOC_RISCV_SUB64
5088 -- : BFD_RELOC_RISCV_GOT_HI20
5089 -- : BFD_RELOC_RISCV_TLS_GOT_HI20
5090 -- : BFD_RELOC_RISCV_TLS_GD_HI20
5091 -- : BFD_RELOC_RISCV_JMP
5092 -- : BFD_RELOC_RISCV_TLS_DTPMOD32
5093 -- : BFD_RELOC_RISCV_TLS_DTPREL32
5094 -- : BFD_RELOC_RISCV_TLS_DTPMOD64
5095 -- : BFD_RELOC_RISCV_TLS_DTPREL64
5096 -- : BFD_RELOC_RISCV_TLS_TPREL32
5097 -- : BFD_RELOC_RISCV_TLS_TPREL64
5098 -- : BFD_RELOC_RISCV_ALIGN
5099 -- : BFD_RELOC_RISCV_RVC_BRANCH
5100 -- : BFD_RELOC_RISCV_RVC_JUMP
5101 -- : BFD_RELOC_RISCV_RELAX
5102 -- : BFD_RELOC_RISCV_CFA
5103 -- : BFD_RELOC_RISCV_SUB6
5104 -- : BFD_RELOC_RISCV_SET6
5105 -- : BFD_RELOC_RISCV_SET8
5106 -- : BFD_RELOC_RISCV_SET16
5107 -- : BFD_RELOC_RISCV_SET32
5108 -- : BFD_RELOC_RISCV_32_PCREL
5109 -- : BFD_RELOC_RISCV_SET_ULEB128
5110 -- : BFD_RELOC_RISCV_SUB_ULEB128
5111     RISC-V relocations.
5112 -- : BFD_RELOC_RL78_NEG8
5113 -- : BFD_RELOC_RL78_NEG16
5114 -- : BFD_RELOC_RL78_NEG24
5115 -- : BFD_RELOC_RL78_NEG32
5116 -- : BFD_RELOC_RL78_16_OP
5117 -- : BFD_RELOC_RL78_24_OP
5118 -- : BFD_RELOC_RL78_32_OP
5119 -- : BFD_RELOC_RL78_8U
5120 -- : BFD_RELOC_RL78_16U
5121 -- : BFD_RELOC_RL78_24U
5122 -- : BFD_RELOC_RL78_DIR3U_PCREL
5123 -- : BFD_RELOC_RL78_DIFF
5124 -- : BFD_RELOC_RL78_GPRELB
5125 -- : BFD_RELOC_RL78_GPRELW
5126 -- : BFD_RELOC_RL78_GPRELL
5127 -- : BFD_RELOC_RL78_SYM
5128 -- : BFD_RELOC_RL78_OP_SUBTRACT
5129 -- : BFD_RELOC_RL78_OP_NEG
5130 -- : BFD_RELOC_RL78_OP_AND
5131 -- : BFD_RELOC_RL78_OP_SHRA
5132 -- : BFD_RELOC_RL78_ABS8
5133 -- : BFD_RELOC_RL78_ABS16
5134 -- : BFD_RELOC_RL78_ABS16_REV
5135 -- : BFD_RELOC_RL78_ABS32
5136 -- : BFD_RELOC_RL78_ABS32_REV
5137 -- : BFD_RELOC_RL78_ABS16U
5138 -- : BFD_RELOC_RL78_ABS16UW
5139 -- : BFD_RELOC_RL78_ABS16UL
5140 -- : BFD_RELOC_RL78_RELAX
5141 -- : BFD_RELOC_RL78_HI16
5142 -- : BFD_RELOC_RL78_HI8
5143 -- : BFD_RELOC_RL78_LO16
5144 -- : BFD_RELOC_RL78_CODE
5145 -- : BFD_RELOC_RL78_SADDR
5146     Renesas RL78 Relocations.
5147 -- : BFD_RELOC_RX_NEG8
5148 -- : BFD_RELOC_RX_NEG16
5149 -- : BFD_RELOC_RX_NEG24
5150 -- : BFD_RELOC_RX_NEG32
5151 -- : BFD_RELOC_RX_16_OP
5152 -- : BFD_RELOC_RX_24_OP
5153 -- : BFD_RELOC_RX_32_OP
5154 -- : BFD_RELOC_RX_8U
5155 -- : BFD_RELOC_RX_16U
5156 -- : BFD_RELOC_RX_24U
5157 -- : BFD_RELOC_RX_DIR3U_PCREL
5158 -- : BFD_RELOC_RX_DIFF
5159 -- : BFD_RELOC_RX_GPRELB
5160 -- : BFD_RELOC_RX_GPRELW
5161 -- : BFD_RELOC_RX_GPRELL
5162 -- : BFD_RELOC_RX_SYM
5163 -- : BFD_RELOC_RX_OP_SUBTRACT
5164 -- : BFD_RELOC_RX_OP_NEG
5165 -- : BFD_RELOC_RX_ABS8
5166 -- : BFD_RELOC_RX_ABS16
5167 -- : BFD_RELOC_RX_ABS16_REV
5168 -- : BFD_RELOC_RX_ABS32
5169 -- : BFD_RELOC_RX_ABS32_REV
5170 -- : BFD_RELOC_RX_ABS16U
5171 -- : BFD_RELOC_RX_ABS16UW
5172 -- : BFD_RELOC_RX_ABS16UL
5173 -- : BFD_RELOC_RX_RELAX
5174     Renesas RX Relocations.
5175 -- : BFD_RELOC_390_12
5176     Direct 12 bit.
5177 -- : BFD_RELOC_390_GOT12
5178     12 bit GOT offset.
5179 -- : BFD_RELOC_390_PLT32
5180     32 bit PC relative PLT address.
5181 -- : BFD_RELOC_390_COPY
5182     Copy symbol at runtime.
5183 -- : BFD_RELOC_390_GLOB_DAT
5184     Create GOT entry.
5185 -- : BFD_RELOC_390_JMP_SLOT
5186     Create PLT entry.
5187 -- : BFD_RELOC_390_RELATIVE
5188     Adjust by program base.
5189 -- : BFD_RELOC_390_GOTPC
5190     32 bit PC relative offset to GOT.
5191 -- : BFD_RELOC_390_GOT16
5192     16 bit GOT offset.
5193 -- : BFD_RELOC_390_PC12DBL
5194     PC relative 12 bit shifted by 1.
5195 -- : BFD_RELOC_390_PLT12DBL
5196     12 bit PC rel.  PLT shifted by 1.
5197 -- : BFD_RELOC_390_PC16DBL
5198     PC relative 16 bit shifted by 1.
5199 -- : BFD_RELOC_390_PLT16DBL
5200     16 bit PC rel.  PLT shifted by 1.
5201 -- : BFD_RELOC_390_PC24DBL
5202     PC relative 24 bit shifted by 1.
5203 -- : BFD_RELOC_390_PLT24DBL
5204     24 bit PC rel.  PLT shifted by 1.
5205 -- : BFD_RELOC_390_PC32DBL
5206     PC relative 32 bit shifted by 1.
5207 -- : BFD_RELOC_390_PLT32DBL
5208     32 bit PC rel.  PLT shifted by 1.
5209 -- : BFD_RELOC_390_GOTPCDBL
5210     32 bit PC rel.  GOT shifted by 1.
5211 -- : BFD_RELOC_390_GOT64
5212     64 bit GOT offset.
5213 -- : BFD_RELOC_390_PLT64
5214     64 bit PC relative PLT address.
5215 -- : BFD_RELOC_390_GOTENT
5216     32 bit rel.  offset to GOT entry.
5217 -- : BFD_RELOC_390_GOTOFF64
5218     64 bit offset to GOT.
5219 -- : BFD_RELOC_390_GOTPLT12
5220     12-bit offset to symbol-entry within GOT, with PLT handling.
5221 -- : BFD_RELOC_390_GOTPLT16
5222     16-bit offset to symbol-entry within GOT, with PLT handling.
5223 -- : BFD_RELOC_390_GOTPLT32
5224     32-bit offset to symbol-entry within GOT, with PLT handling.
5225 -- : BFD_RELOC_390_GOTPLT64
5226     64-bit offset to symbol-entry within GOT, with PLT handling.
5227 -- : BFD_RELOC_390_GOTPLTENT
5228     32-bit rel.  offset to symbol-entry within GOT, with PLT handling.
5229 -- : BFD_RELOC_390_PLTOFF16
5230     16-bit rel.  offset from the GOT to a PLT entry.
5231 -- : BFD_RELOC_390_PLTOFF32
5232     32-bit rel.  offset from the GOT to a PLT entry.
5233 -- : BFD_RELOC_390_PLTOFF64
5234     64-bit rel.  offset from the GOT to a PLT entry.
5235 -- : BFD_RELOC_390_TLS_LOAD
5236 -- : BFD_RELOC_390_TLS_GDCALL
5237 -- : BFD_RELOC_390_TLS_LDCALL
5238 -- : BFD_RELOC_390_TLS_GD32
5239 -- : BFD_RELOC_390_TLS_GD64
5240 -- : BFD_RELOC_390_TLS_GOTIE12
5241 -- : BFD_RELOC_390_TLS_GOTIE32
5242 -- : BFD_RELOC_390_TLS_GOTIE64
5243 -- : BFD_RELOC_390_TLS_LDM32
5244 -- : BFD_RELOC_390_TLS_LDM64
5245 -- : BFD_RELOC_390_TLS_IE32
5246 -- : BFD_RELOC_390_TLS_IE64
5247 -- : BFD_RELOC_390_TLS_IEENT
5248 -- : BFD_RELOC_390_TLS_LE32
5249 -- : BFD_RELOC_390_TLS_LE64
5250 -- : BFD_RELOC_390_TLS_LDO32
5251 -- : BFD_RELOC_390_TLS_LDO64
5252 -- : BFD_RELOC_390_TLS_DTPMOD
5253 -- : BFD_RELOC_390_TLS_DTPOFF
5254 -- : BFD_RELOC_390_TLS_TPOFF
5255     s390 tls relocations.
5256 -- : BFD_RELOC_390_20
5257 -- : BFD_RELOC_390_GOT20
5258 -- : BFD_RELOC_390_GOTPLT20
5259 -- : BFD_RELOC_390_TLS_GOTIE20
5260     Long displacement extension.
5261 -- : BFD_RELOC_390_IRELATIVE
5262     STT_GNU_IFUNC relocation.
5263 -- : BFD_RELOC_SCORE_GPREL15
5264     Score relocations.  Low 16 bit for load/store.
5265 -- : BFD_RELOC_SCORE_DUMMY2
5266 -- : BFD_RELOC_SCORE_JMP
5267     This is a 24-bit reloc with the right 1 bit assumed to be 0.
5268 -- : BFD_RELOC_SCORE_BRANCH
5269     This is a 19-bit reloc with the right 1 bit assumed to be 0.
5270 -- : BFD_RELOC_SCORE_IMM30
5271     This is a 32-bit reloc for 48-bit instructions.
5272 -- : BFD_RELOC_SCORE_IMM32
5273     This is a 32-bit reloc for 48-bit instructions.
5274 -- : BFD_RELOC_SCORE16_JMP
5275     This is a 11-bit reloc with the right 1 bit assumed to be 0.
5276 -- : BFD_RELOC_SCORE16_BRANCH
5277     This is a 8-bit reloc with the right 1 bit assumed to be 0.
5278 -- : BFD_RELOC_SCORE_BCMP
5279     This is a 9-bit reloc with the right 1 bit assumed to be 0.
5280 -- : BFD_RELOC_SCORE_GOT15
5281 -- : BFD_RELOC_SCORE_GOT_LO16
5282 -- : BFD_RELOC_SCORE_CALL15
5283 -- : BFD_RELOC_SCORE_DUMMY_HI16
5284     Undocumented Score relocs.
5285 -- : BFD_RELOC_IP2K_FR9
5286     Scenix IP2K - 9-bit register number / data address.
5287 -- : BFD_RELOC_IP2K_BANK
5288     Scenix IP2K - 4-bit register/data bank number.
5289 -- : BFD_RELOC_IP2K_ADDR16CJP
5290     Scenix IP2K - low 13 bits of instruction word address.
5291 -- : BFD_RELOC_IP2K_PAGE3
5292     Scenix IP2K - high 3 bits of instruction word address.
5293 -- : BFD_RELOC_IP2K_LO8DATA
5294 -- : BFD_RELOC_IP2K_HI8DATA
5295 -- : BFD_RELOC_IP2K_EX8DATA
5296     Scenix IP2K - ext/low/high 8 bits of data address.
5297 -- : BFD_RELOC_IP2K_LO8INSN
5298 -- : BFD_RELOC_IP2K_HI8INSN
5299     Scenix IP2K - low/high 8 bits of instruction word address.
5300 -- : BFD_RELOC_IP2K_PC_SKIP
5301     Scenix IP2K - even/odd PC modifier to modify snb pcl.0.
5302 -- : BFD_RELOC_IP2K_TEXT
5303     Scenix IP2K - 16 bit word address in text section.
5304 -- : BFD_RELOC_IP2K_FR_OFFSET
5305     Scenix IP2K - 7-bit sp or dp offset.
5306 -- : BFD_RELOC_VPE4KMATH_DATA
5307 -- : BFD_RELOC_VPE4KMATH_INSN
5308     Scenix VPE4K coprocessor - data/insn-space addressing.
5309 -- : BFD_RELOC_VTABLE_INHERIT
5310 -- : BFD_RELOC_VTABLE_ENTRY
5311     These two relocations are used by the linker to determine which of
5312     the entries in a C++ virtual function table are actually used.
5313     When the ���gc-sections option is given, the linker will zero out the
5314     entries that are not used, so that the code for those functions
5315     need not be included in the output.
5316
5317     VTABLE_INHERIT is a zero-space relocation used to describe to the
5318     linker the inheritance tree of a C++ virtual function table.  The
5319     relocation���s symbol should be the parent class��� vtable, and the
5320     relocation should be located at the child vtable.
5321
5322     VTABLE_ENTRY is a zero-space relocation that describes the use of a
5323     virtual function table entry.  The reloc���s symbol should refer to
5324     the table of the class mentioned in the code.  Off of that base, an
5325     offset describes the entry that is being used.  For Rela hosts,
5326     this offset is stored in the reloc���s addend.  For Rel hosts, we are
5327     forced to put this offset in the reloc���s section offset.
5328 -- : BFD_RELOC_IA64_IMM14
5329 -- : BFD_RELOC_IA64_IMM22
5330 -- : BFD_RELOC_IA64_IMM64
5331 -- : BFD_RELOC_IA64_DIR32MSB
5332 -- : BFD_RELOC_IA64_DIR32LSB
5333 -- : BFD_RELOC_IA64_DIR64MSB
5334 -- : BFD_RELOC_IA64_DIR64LSB
5335 -- : BFD_RELOC_IA64_GPREL22
5336 -- : BFD_RELOC_IA64_GPREL64I
5337 -- : BFD_RELOC_IA64_GPREL32MSB
5338 -- : BFD_RELOC_IA64_GPREL32LSB
5339 -- : BFD_RELOC_IA64_GPREL64MSB
5340 -- : BFD_RELOC_IA64_GPREL64LSB
5341 -- : BFD_RELOC_IA64_LTOFF22
5342 -- : BFD_RELOC_IA64_LTOFF64I
5343 -- : BFD_RELOC_IA64_PLTOFF22
5344 -- : BFD_RELOC_IA64_PLTOFF64I
5345 -- : BFD_RELOC_IA64_PLTOFF64MSB
5346 -- : BFD_RELOC_IA64_PLTOFF64LSB
5347 -- : BFD_RELOC_IA64_FPTR64I
5348 -- : BFD_RELOC_IA64_FPTR32MSB
5349 -- : BFD_RELOC_IA64_FPTR32LSB
5350 -- : BFD_RELOC_IA64_FPTR64MSB
5351 -- : BFD_RELOC_IA64_FPTR64LSB
5352 -- : BFD_RELOC_IA64_PCREL21B
5353 -- : BFD_RELOC_IA64_PCREL21BI
5354 -- : BFD_RELOC_IA64_PCREL21M
5355 -- : BFD_RELOC_IA64_PCREL21F
5356 -- : BFD_RELOC_IA64_PCREL22
5357 -- : BFD_RELOC_IA64_PCREL60B
5358 -- : BFD_RELOC_IA64_PCREL64I
5359 -- : BFD_RELOC_IA64_PCREL32MSB
5360 -- : BFD_RELOC_IA64_PCREL32LSB
5361 -- : BFD_RELOC_IA64_PCREL64MSB
5362 -- : BFD_RELOC_IA64_PCREL64LSB
5363 -- : BFD_RELOC_IA64_LTOFF_FPTR22
5364 -- : BFD_RELOC_IA64_LTOFF_FPTR64I
5365 -- : BFD_RELOC_IA64_LTOFF_FPTR32MSB
5366 -- : BFD_RELOC_IA64_LTOFF_FPTR32LSB
5367 -- : BFD_RELOC_IA64_LTOFF_FPTR64MSB
5368 -- : BFD_RELOC_IA64_LTOFF_FPTR64LSB
5369 -- : BFD_RELOC_IA64_SEGREL32MSB
5370 -- : BFD_RELOC_IA64_SEGREL32LSB
5371 -- : BFD_RELOC_IA64_SEGREL64MSB
5372 -- : BFD_RELOC_IA64_SEGREL64LSB
5373 -- : BFD_RELOC_IA64_SECREL32MSB
5374 -- : BFD_RELOC_IA64_SECREL32LSB
5375 -- : BFD_RELOC_IA64_SECREL64MSB
5376 -- : BFD_RELOC_IA64_SECREL64LSB
5377 -- : BFD_RELOC_IA64_REL32MSB
5378 -- : BFD_RELOC_IA64_REL32LSB
5379 -- : BFD_RELOC_IA64_REL64MSB
5380 -- : BFD_RELOC_IA64_REL64LSB
5381 -- : BFD_RELOC_IA64_LTV32MSB
5382 -- : BFD_RELOC_IA64_LTV32LSB
5383 -- : BFD_RELOC_IA64_LTV64MSB
5384 -- : BFD_RELOC_IA64_LTV64LSB
5385 -- : BFD_RELOC_IA64_IPLTMSB
5386 -- : BFD_RELOC_IA64_IPLTLSB
5387 -- : BFD_RELOC_IA64_COPY
5388 -- : BFD_RELOC_IA64_LTOFF22X
5389 -- : BFD_RELOC_IA64_LDXMOV
5390 -- : BFD_RELOC_IA64_TPREL14
5391 -- : BFD_RELOC_IA64_TPREL22
5392 -- : BFD_RELOC_IA64_TPREL64I
5393 -- : BFD_RELOC_IA64_TPREL64MSB
5394 -- : BFD_RELOC_IA64_TPREL64LSB
5395 -- : BFD_RELOC_IA64_LTOFF_TPREL22
5396 -- : BFD_RELOC_IA64_DTPMOD64MSB
5397 -- : BFD_RELOC_IA64_DTPMOD64LSB
5398 -- : BFD_RELOC_IA64_LTOFF_DTPMOD22
5399 -- : BFD_RELOC_IA64_DTPREL14
5400 -- : BFD_RELOC_IA64_DTPREL22
5401 -- : BFD_RELOC_IA64_DTPREL64I
5402 -- : BFD_RELOC_IA64_DTPREL32MSB
5403 -- : BFD_RELOC_IA64_DTPREL32LSB
5404 -- : BFD_RELOC_IA64_DTPREL64MSB
5405 -- : BFD_RELOC_IA64_DTPREL64LSB
5406 -- : BFD_RELOC_IA64_LTOFF_DTPREL22
5407     Intel IA64 Relocations.
5408 -- : BFD_RELOC_M68HC11_HI8
5409     Motorola 68HC11 reloc.  This is the 8 bit high part of an absolute
5410     address.
5411 -- : BFD_RELOC_M68HC11_LO8
5412     Motorola 68HC11 reloc.  This is the 8 bit low part of an absolute
5413     address.
5414 -- : BFD_RELOC_M68HC11_3B
5415     Motorola 68HC11 reloc.  This is the 3 bit of a value.
5416 -- : BFD_RELOC_M68HC11_RL_JUMP
5417     Motorola 68HC11 reloc.  This reloc marks the beginning of a
5418     jump/call instruction.  It is used for linker relaxation to
5419     correctly identify beginning of instruction and change some
5420     branches to use PC-relative addressing mode.
5421 -- : BFD_RELOC_M68HC11_RL_GROUP
5422     Motorola 68HC11 reloc.  This reloc marks a group of several
5423     instructions that gcc generates and for which the linker relaxation
5424     pass can modify and/or remove some of them.
5425 -- : BFD_RELOC_M68HC11_LO16
5426     Motorola 68HC11 reloc.  This is the 16-bit lower part of an
5427     address.  It is used for ���call��� instruction to specify the symbol
5428     address without any special transformation (due to memory bank
5429     window).
5430 -- : BFD_RELOC_M68HC11_PAGE
5431     Motorola 68HC11 reloc.  This is a 8-bit reloc that specifies the
5432     page number of an address.  It is used by ���call��� instruction to
5433     specify the page number of the symbol.
5434 -- : BFD_RELOC_M68HC11_24
5435     Motorola 68HC11 reloc.  This is a 24-bit reloc that represents the
5436     address with a 16-bit value and a 8-bit page number.  The symbol
5437     address is transformed to follow the 16K memory bank of 68HC12
5438     (seen as mapped in the window).
5439 -- : BFD_RELOC_M68HC12_5B
5440     Motorola 68HC12 reloc.  This is the 5 bits of a value.
5441 -- : BFD_RELOC_XGATE_RL_JUMP
5442     Freescale XGATE reloc.  This reloc marks the beginning of a bra/jal
5443     instruction.
5444 -- : BFD_RELOC_XGATE_RL_GROUP
5445     Freescale XGATE reloc.  This reloc marks a group of several
5446     instructions that gcc generates and for which the linker relaxation
5447     pass can modify and/or remove some of them.
5448 -- : BFD_RELOC_XGATE_LO16
5449     Freescale XGATE reloc.  This is the 16-bit lower part of an
5450     address.  It is used for the ���16-bit��� instructions.
5451 -- : BFD_RELOC_XGATE_GPAGE
5452     Freescale XGATE reloc.
5453 -- : BFD_RELOC_XGATE_24
5454     Freescale XGATE reloc.
5455 -- : BFD_RELOC_XGATE_PCREL_9
5456     Freescale XGATE reloc.  This is a 9-bit pc-relative reloc.
5457 -- : BFD_RELOC_XGATE_PCREL_10
5458     Freescale XGATE reloc.  This is a 10-bit pc-relative reloc.
5459 -- : BFD_RELOC_XGATE_IMM8_LO
5460     Freescale XGATE reloc.  This is the 16-bit lower part of an
5461     address.  It is used for the ���16-bit��� instructions.
5462 -- : BFD_RELOC_XGATE_IMM8_HI
5463     Freescale XGATE reloc.  This is the 16-bit higher part of an
5464     address.  It is used for the ���16-bit��� instructions.
5465 -- : BFD_RELOC_XGATE_IMM3
5466     Freescale XGATE reloc.  This is a 3-bit pc-relative reloc.
5467 -- : BFD_RELOC_XGATE_IMM4
5468     Freescale XGATE reloc.  This is a 4-bit pc-relative reloc.
5469 -- : BFD_RELOC_XGATE_IMM5
5470     Freescale XGATE reloc.  This is a 5-bit pc-relative reloc.
5471 -- : BFD_RELOC_M68HC12_9B
5472     Motorola 68HC12 reloc.  This is the 9 bits of a value.
5473 -- : BFD_RELOC_M68HC12_16B
5474     Motorola 68HC12 reloc.  This is the 16 bits of a value.
5475 -- : BFD_RELOC_M68HC12_9_PCREL
5476     Motorola 68HC12/XGATE reloc.  This is a PCREL9 branch.
5477 -- : BFD_RELOC_M68HC12_10_PCREL
5478     Motorola 68HC12/XGATE reloc.  This is a PCREL10 branch.
5479 -- : BFD_RELOC_M68HC12_LO8XG
5480     Motorola 68HC12/XGATE reloc.  This is the 8 bit low part of an
5481     absolute address and immediately precedes a matching HI8XG part.
5482 -- : BFD_RELOC_M68HC12_HI8XG
5483     Motorola 68HC12/XGATE reloc.  This is the 8 bit high part of an
5484     absolute address and immediately follows a matching LO8XG part.
5485 -- : BFD_RELOC_S12Z_15_PCREL
5486     Freescale S12Z reloc.  This is a 15 bit relative address.  If the
5487     most significant bits are all zero then it may be truncated to 8
5488     bits.
5489 -- : BFD_RELOC_CR16_NUM8
5490 -- : BFD_RELOC_CR16_NUM16
5491 -- : BFD_RELOC_CR16_NUM32
5492 -- : BFD_RELOC_CR16_NUM32a
5493 -- : BFD_RELOC_CR16_REGREL0
5494 -- : BFD_RELOC_CR16_REGREL4
5495 -- : BFD_RELOC_CR16_REGREL4a
5496 -- : BFD_RELOC_CR16_REGREL14
5497 -- : BFD_RELOC_CR16_REGREL14a
5498 -- : BFD_RELOC_CR16_REGREL16
5499 -- : BFD_RELOC_CR16_REGREL20
5500 -- : BFD_RELOC_CR16_REGREL20a
5501 -- : BFD_RELOC_CR16_ABS20
5502 -- : BFD_RELOC_CR16_ABS24
5503 -- : BFD_RELOC_CR16_IMM4
5504 -- : BFD_RELOC_CR16_IMM8
5505 -- : BFD_RELOC_CR16_IMM16
5506 -- : BFD_RELOC_CR16_IMM20
5507 -- : BFD_RELOC_CR16_IMM24
5508 -- : BFD_RELOC_CR16_IMM32
5509 -- : BFD_RELOC_CR16_IMM32a
5510 -- : BFD_RELOC_CR16_DISP4
5511 -- : BFD_RELOC_CR16_DISP8
5512 -- : BFD_RELOC_CR16_DISP16
5513 -- : BFD_RELOC_CR16_DISP20
5514 -- : BFD_RELOC_CR16_DISP24
5515 -- : BFD_RELOC_CR16_DISP24a
5516 -- : BFD_RELOC_CR16_SWITCH8
5517 -- : BFD_RELOC_CR16_SWITCH16
5518 -- : BFD_RELOC_CR16_SWITCH32
5519 -- : BFD_RELOC_CR16_GOT_REGREL20
5520 -- : BFD_RELOC_CR16_GOTC_REGREL20
5521 -- : BFD_RELOC_CR16_GLOB_DAT
5522     NS CR16 Relocations.
5523 -- : BFD_RELOC_CRX_REL4
5524 -- : BFD_RELOC_CRX_REL8
5525 -- : BFD_RELOC_CRX_REL8_CMP
5526 -- : BFD_RELOC_CRX_REL16
5527 -- : BFD_RELOC_CRX_REL24
5528 -- : BFD_RELOC_CRX_REL32
5529 -- : BFD_RELOC_CRX_REGREL12
5530 -- : BFD_RELOC_CRX_REGREL22
5531 -- : BFD_RELOC_CRX_REGREL28
5532 -- : BFD_RELOC_CRX_REGREL32
5533 -- : BFD_RELOC_CRX_ABS16
5534 -- : BFD_RELOC_CRX_ABS32
5535 -- : BFD_RELOC_CRX_NUM8
5536 -- : BFD_RELOC_CRX_NUM16
5537 -- : BFD_RELOC_CRX_NUM32
5538 -- : BFD_RELOC_CRX_IMM16
5539 -- : BFD_RELOC_CRX_IMM32
5540 -- : BFD_RELOC_CRX_SWITCH8
5541 -- : BFD_RELOC_CRX_SWITCH16
5542 -- : BFD_RELOC_CRX_SWITCH32
5543     NS CRX Relocations.
5544 -- : BFD_RELOC_CRIS_BDISP8
5545 -- : BFD_RELOC_CRIS_UNSIGNED_5
5546 -- : BFD_RELOC_CRIS_SIGNED_6
5547 -- : BFD_RELOC_CRIS_UNSIGNED_6
5548 -- : BFD_RELOC_CRIS_SIGNED_8
5549 -- : BFD_RELOC_CRIS_UNSIGNED_8
5550 -- : BFD_RELOC_CRIS_SIGNED_16
5551 -- : BFD_RELOC_CRIS_UNSIGNED_16
5552 -- : BFD_RELOC_CRIS_LAPCQ_OFFSET
5553 -- : BFD_RELOC_CRIS_UNSIGNED_4
5554     These relocs are only used within the CRIS assembler.  They are not
5555     (at present) written to any object files.
5556 -- : BFD_RELOC_CRIS_COPY
5557 -- : BFD_RELOC_CRIS_GLOB_DAT
5558 -- : BFD_RELOC_CRIS_JUMP_SLOT
5559 -- : BFD_RELOC_CRIS_RELATIVE
5560     Relocs used in ELF shared libraries for CRIS.
5561 -- : BFD_RELOC_CRIS_32_GOT
5562     32-bit offset to symbol-entry within GOT.
5563 -- : BFD_RELOC_CRIS_16_GOT
5564     16-bit offset to symbol-entry within GOT.
5565 -- : BFD_RELOC_CRIS_32_GOTPLT
5566     32-bit offset to symbol-entry within GOT, with PLT handling.
5567 -- : BFD_RELOC_CRIS_16_GOTPLT
5568     16-bit offset to symbol-entry within GOT, with PLT handling.
5569 -- : BFD_RELOC_CRIS_32_GOTREL
5570     32-bit offset to symbol, relative to GOT.
5571 -- : BFD_RELOC_CRIS_32_PLT_GOTREL
5572     32-bit offset to symbol with PLT entry, relative to GOT.
5573 -- : BFD_RELOC_CRIS_32_PLT_PCREL
5574     32-bit offset to symbol with PLT entry, relative to this
5575     relocation.
5576 -- : BFD_RELOC_CRIS_32_GOT_GD
5577 -- : BFD_RELOC_CRIS_16_GOT_GD
5578 -- : BFD_RELOC_CRIS_32_GD
5579 -- : BFD_RELOC_CRIS_DTP
5580 -- : BFD_RELOC_CRIS_32_DTPREL
5581 -- : BFD_RELOC_CRIS_16_DTPREL
5582 -- : BFD_RELOC_CRIS_32_GOT_TPREL
5583 -- : BFD_RELOC_CRIS_16_GOT_TPREL
5584 -- : BFD_RELOC_CRIS_32_TPREL
5585 -- : BFD_RELOC_CRIS_16_TPREL
5586 -- : BFD_RELOC_CRIS_DTPMOD
5587 -- : BFD_RELOC_CRIS_32_IE
5588     Relocs used in TLS code for CRIS.
5589 -- : BFD_RELOC_OR1K_REL_26
5590 -- : BFD_RELOC_OR1K_SLO16
5591 -- : BFD_RELOC_OR1K_PCREL_PG21
5592 -- : BFD_RELOC_OR1K_LO13
5593 -- : BFD_RELOC_OR1K_SLO13
5594 -- : BFD_RELOC_OR1K_GOTPC_HI16
5595 -- : BFD_RELOC_OR1K_GOTPC_LO16
5596 -- : BFD_RELOC_OR1K_GOT_AHI16
5597 -- : BFD_RELOC_OR1K_GOT16
5598 -- : BFD_RELOC_OR1K_GOT_PG21
5599 -- : BFD_RELOC_OR1K_GOT_LO13
5600 -- : BFD_RELOC_OR1K_PLT26
5601 -- : BFD_RELOC_OR1K_PLTA26
5602 -- : BFD_RELOC_OR1K_GOTOFF_SLO16
5603 -- : BFD_RELOC_OR1K_COPY
5604 -- : BFD_RELOC_OR1K_GLOB_DAT
5605 -- : BFD_RELOC_OR1K_JMP_SLOT
5606 -- : BFD_RELOC_OR1K_RELATIVE
5607 -- : BFD_RELOC_OR1K_TLS_GD_HI16
5608 -- : BFD_RELOC_OR1K_TLS_GD_LO16
5609 -- : BFD_RELOC_OR1K_TLS_GD_PG21
5610 -- : BFD_RELOC_OR1K_TLS_GD_LO13
5611 -- : BFD_RELOC_OR1K_TLS_LDM_HI16
5612 -- : BFD_RELOC_OR1K_TLS_LDM_LO16
5613 -- : BFD_RELOC_OR1K_TLS_LDM_PG21
5614 -- : BFD_RELOC_OR1K_TLS_LDM_LO13
5615 -- : BFD_RELOC_OR1K_TLS_LDO_HI16
5616 -- : BFD_RELOC_OR1K_TLS_LDO_LO16
5617 -- : BFD_RELOC_OR1K_TLS_IE_HI16
5618 -- : BFD_RELOC_OR1K_TLS_IE_AHI16
5619 -- : BFD_RELOC_OR1K_TLS_IE_LO16
5620 -- : BFD_RELOC_OR1K_TLS_IE_PG21
5621 -- : BFD_RELOC_OR1K_TLS_IE_LO13
5622 -- : BFD_RELOC_OR1K_TLS_LE_HI16
5623 -- : BFD_RELOC_OR1K_TLS_LE_AHI16
5624 -- : BFD_RELOC_OR1K_TLS_LE_LO16
5625 -- : BFD_RELOC_OR1K_TLS_LE_SLO16
5626 -- : BFD_RELOC_OR1K_TLS_TPOFF
5627 -- : BFD_RELOC_OR1K_TLS_DTPOFF
5628 -- : BFD_RELOC_OR1K_TLS_DTPMOD
5629     OpenRISC 1000 Relocations.
5630 -- : BFD_RELOC_H8_DIR16A8
5631 -- : BFD_RELOC_H8_DIR16R8
5632 -- : BFD_RELOC_H8_DIR24A8
5633 -- : BFD_RELOC_H8_DIR24R8
5634 -- : BFD_RELOC_H8_DIR32A16
5635 -- : BFD_RELOC_H8_DISP32A16
5636     H8 elf Relocations.
5637 -- : BFD_RELOC_XSTORMY16_REL_12
5638 -- : BFD_RELOC_XSTORMY16_12
5639 -- : BFD_RELOC_XSTORMY16_24
5640 -- : BFD_RELOC_XSTORMY16_FPTR16
5641     Sony Xstormy16 Relocations.
5642 -- : BFD_RELOC_RELC
5643     Self-describing complex relocations.
5644 -- : BFD_RELOC_VAX_GLOB_DAT
5645 -- : BFD_RELOC_VAX_JMP_SLOT
5646 -- : BFD_RELOC_VAX_RELATIVE
5647     Relocations used by VAX ELF.
5648 -- : BFD_RELOC_MT_PC16
5649     Morpho MT - 16 bit immediate relocation.
5650 -- : BFD_RELOC_MT_HI16
5651     Morpho MT - Hi 16 bits of an address.
5652 -- : BFD_RELOC_MT_LO16
5653     Morpho MT - Low 16 bits of an address.
5654 -- : BFD_RELOC_MT_GNU_VTINHERIT
5655     Morpho MT - Used to tell the linker which vtable entries are used.
5656 -- : BFD_RELOC_MT_GNU_VTENTRY
5657     Morpho MT - Used to tell the linker which vtable entries are used.
5658 -- : BFD_RELOC_MT_PCINSN8
5659     Morpho MT - 8 bit immediate relocation.
5660 -- : BFD_RELOC_MSP430_10_PCREL
5661 -- : BFD_RELOC_MSP430_16_PCREL
5662 -- : BFD_RELOC_MSP430_16
5663 -- : BFD_RELOC_MSP430_16_PCREL_BYTE
5664 -- : BFD_RELOC_MSP430_16_BYTE
5665 -- : BFD_RELOC_MSP430_2X_PCREL
5666 -- : BFD_RELOC_MSP430_RL_PCREL
5667 -- : BFD_RELOC_MSP430_ABS8
5668 -- : BFD_RELOC_MSP430X_PCR20_EXT_SRC
5669 -- : BFD_RELOC_MSP430X_PCR20_EXT_DST
5670 -- : BFD_RELOC_MSP430X_PCR20_EXT_ODST
5671 -- : BFD_RELOC_MSP430X_ABS20_EXT_SRC
5672 -- : BFD_RELOC_MSP430X_ABS20_EXT_DST
5673 -- : BFD_RELOC_MSP430X_ABS20_EXT_ODST
5674 -- : BFD_RELOC_MSP430X_ABS20_ADR_SRC
5675 -- : BFD_RELOC_MSP430X_ABS20_ADR_DST
5676 -- : BFD_RELOC_MSP430X_PCR16
5677 -- : BFD_RELOC_MSP430X_PCR20_CALL
5678 -- : BFD_RELOC_MSP430X_ABS16
5679 -- : BFD_RELOC_MSP430_ABS_HI16
5680 -- : BFD_RELOC_MSP430_PREL31
5681 -- : BFD_RELOC_MSP430_SYM_DIFF
5682 -- : BFD_RELOC_MSP430_SET_ULEB128
5683 -- : BFD_RELOC_MSP430_SUB_ULEB128
5684     msp430 specific relocation codes.
5685 -- : BFD_RELOC_NIOS2_S16
5686 -- : BFD_RELOC_NIOS2_U16
5687 -- : BFD_RELOC_NIOS2_CALL26
5688 -- : BFD_RELOC_NIOS2_IMM5
5689 -- : BFD_RELOC_NIOS2_CACHE_OPX
5690 -- : BFD_RELOC_NIOS2_IMM6
5691 -- : BFD_RELOC_NIOS2_IMM8
5692 -- : BFD_RELOC_NIOS2_HI16
5693 -- : BFD_RELOC_NIOS2_LO16
5694 -- : BFD_RELOC_NIOS2_HIADJ16
5695 -- : BFD_RELOC_NIOS2_GPREL
5696 -- : BFD_RELOC_NIOS2_UJMP
5697 -- : BFD_RELOC_NIOS2_CJMP
5698 -- : BFD_RELOC_NIOS2_CALLR
5699 -- : BFD_RELOC_NIOS2_ALIGN
5700 -- : BFD_RELOC_NIOS2_GOT16
5701 -- : BFD_RELOC_NIOS2_CALL16
5702 -- : BFD_RELOC_NIOS2_GOTOFF_LO
5703 -- : BFD_RELOC_NIOS2_GOTOFF_HA
5704 -- : BFD_RELOC_NIOS2_PCREL_LO
5705 -- : BFD_RELOC_NIOS2_PCREL_HA
5706 -- : BFD_RELOC_NIOS2_TLS_GD16
5707 -- : BFD_RELOC_NIOS2_TLS_LDM16
5708 -- : BFD_RELOC_NIOS2_TLS_LDO16
5709 -- : BFD_RELOC_NIOS2_TLS_IE16
5710 -- : BFD_RELOC_NIOS2_TLS_LE16
5711 -- : BFD_RELOC_NIOS2_TLS_DTPMOD
5712 -- : BFD_RELOC_NIOS2_TLS_DTPREL
5713 -- : BFD_RELOC_NIOS2_TLS_TPREL
5714 -- : BFD_RELOC_NIOS2_COPY
5715 -- : BFD_RELOC_NIOS2_GLOB_DAT
5716 -- : BFD_RELOC_NIOS2_JUMP_SLOT
5717 -- : BFD_RELOC_NIOS2_RELATIVE
5718 -- : BFD_RELOC_NIOS2_GOTOFF
5719 -- : BFD_RELOC_NIOS2_CALL26_NOAT
5720 -- : BFD_RELOC_NIOS2_GOT_LO
5721 -- : BFD_RELOC_NIOS2_GOT_HA
5722 -- : BFD_RELOC_NIOS2_CALL_LO
5723 -- : BFD_RELOC_NIOS2_CALL_HA
5724 -- : BFD_RELOC_NIOS2_R2_S12
5725 -- : BFD_RELOC_NIOS2_R2_I10_1_PCREL
5726 -- : BFD_RELOC_NIOS2_R2_T1I7_1_PCREL
5727 -- : BFD_RELOC_NIOS2_R2_T1I7_2
5728 -- : BFD_RELOC_NIOS2_R2_T2I4
5729 -- : BFD_RELOC_NIOS2_R2_T2I4_1
5730 -- : BFD_RELOC_NIOS2_R2_T2I4_2
5731 -- : BFD_RELOC_NIOS2_R2_X1I7_2
5732 -- : BFD_RELOC_NIOS2_R2_X2L5
5733 -- : BFD_RELOC_NIOS2_R2_F1I5_2
5734 -- : BFD_RELOC_NIOS2_R2_L5I4X1
5735 -- : BFD_RELOC_NIOS2_R2_T1X1I6
5736 -- : BFD_RELOC_NIOS2_R2_T1X1I6_2
5737     Relocations used by the Altera Nios II core.
5738 -- : BFD_RELOC_PRU_U16
5739     PRU LDI 16-bit unsigned data-memory relocation.
5740 -- : BFD_RELOC_PRU_U16_PMEMIMM
5741     PRU LDI 16-bit unsigned instruction-memory relocation.
5742 -- : BFD_RELOC_PRU_LDI32
5743     PRU relocation for two consecutive LDI load instructions that load
5744     a 32 bit value into a register.  If the higher bits are all zero,
5745     then the second instruction may be relaxed.
5746 -- : BFD_RELOC_PRU_S10_PCREL
5747     PRU QBBx 10-bit signed PC-relative relocation.
5748 -- : BFD_RELOC_PRU_U8_PCREL
5749     PRU 8-bit unsigned relocation used for the LOOP instruction.
5750 -- : BFD_RELOC_PRU_32_PMEM
5751 -- : BFD_RELOC_PRU_16_PMEM
5752     PRU Program Memory relocations.  Used to convert from byte
5753     addressing to 32-bit word addressing.
5754 -- : BFD_RELOC_PRU_GNU_DIFF8
5755 -- : BFD_RELOC_PRU_GNU_DIFF16
5756 -- : BFD_RELOC_PRU_GNU_DIFF32
5757 -- : BFD_RELOC_PRU_GNU_DIFF16_PMEM
5758 -- : BFD_RELOC_PRU_GNU_DIFF32_PMEM
5759     PRU relocations to mark the difference of two local symbols.  These
5760     are only needed to support linker relaxation and can be ignored
5761     when not relaxing.  The field is set to the value of the difference
5762     assuming no relaxation.  The relocation encodes the position of the
5763     second symbol so the linker can determine whether to adjust the
5764     field value.  The PMEM variants encode the word difference, instead
5765     of byte difference between symbols.
5766 -- : BFD_RELOC_IQ2000_OFFSET_16
5767 -- : BFD_RELOC_IQ2000_OFFSET_21
5768 -- : BFD_RELOC_IQ2000_UHI16
5769     IQ2000 Relocations.
5770 -- : BFD_RELOC_XTENSA_RTLD
5771     Special Xtensa relocation used only by PLT entries in ELF shared
5772     objects to indicate that the runtime linker should set the value to
5773     one of its own internal functions or data structures.
5774 -- : BFD_RELOC_XTENSA_GLOB_DAT
5775 -- : BFD_RELOC_XTENSA_JMP_SLOT
5776 -- : BFD_RELOC_XTENSA_RELATIVE
5777     Xtensa relocations for ELF shared objects.
5778 -- : BFD_RELOC_XTENSA_PLT
5779     Xtensa relocation used in ELF object files for symbols that may
5780     require PLT entries.  Otherwise, this is just a generic 32-bit
5781     relocation.
5782 -- : BFD_RELOC_XTENSA_DIFF8
5783 -- : BFD_RELOC_XTENSA_DIFF16
5784 -- : BFD_RELOC_XTENSA_DIFF32
5785     Xtensa relocations for backward compatibility.  These have been
5786     replaced by BFD_RELOC_XTENSA_PDIFF and BFD_RELOC_XTENSA_NDIFF.
5787     Xtensa relocations to mark the difference of two local symbols.
5788     These are only needed to support linker relaxation and can be
5789     ignored when not relaxing.  The field is set to the value of the
5790     difference assuming no relaxation.  The relocation encodes the
5791     position of the first symbol so the linker can determine whether to
5792     adjust the field value.
5793 -- : BFD_RELOC_XTENSA_SLOT0_OP
5794 -- : BFD_RELOC_XTENSA_SLOT1_OP
5795 -- : BFD_RELOC_XTENSA_SLOT2_OP
5796 -- : BFD_RELOC_XTENSA_SLOT3_OP
5797 -- : BFD_RELOC_XTENSA_SLOT4_OP
5798 -- : BFD_RELOC_XTENSA_SLOT5_OP
5799 -- : BFD_RELOC_XTENSA_SLOT6_OP
5800 -- : BFD_RELOC_XTENSA_SLOT7_OP
5801 -- : BFD_RELOC_XTENSA_SLOT8_OP
5802 -- : BFD_RELOC_XTENSA_SLOT9_OP
5803 -- : BFD_RELOC_XTENSA_SLOT10_OP
5804 -- : BFD_RELOC_XTENSA_SLOT11_OP
5805 -- : BFD_RELOC_XTENSA_SLOT12_OP
5806 -- : BFD_RELOC_XTENSA_SLOT13_OP
5807 -- : BFD_RELOC_XTENSA_SLOT14_OP
5808     Generic Xtensa relocations for instruction operands.  Only the slot
5809     number is encoded in the relocation.  The relocation applies to the
5810     last PC-relative immediate operand, or if there are no PC-relative
5811     immediates, to the last immediate operand.
5812 -- : BFD_RELOC_XTENSA_SLOT0_ALT
5813 -- : BFD_RELOC_XTENSA_SLOT1_ALT
5814 -- : BFD_RELOC_XTENSA_SLOT2_ALT
5815 -- : BFD_RELOC_XTENSA_SLOT3_ALT
5816 -- : BFD_RELOC_XTENSA_SLOT4_ALT
5817 -- : BFD_RELOC_XTENSA_SLOT5_ALT
5818 -- : BFD_RELOC_XTENSA_SLOT6_ALT
5819 -- : BFD_RELOC_XTENSA_SLOT7_ALT
5820 -- : BFD_RELOC_XTENSA_SLOT8_ALT
5821 -- : BFD_RELOC_XTENSA_SLOT9_ALT
5822 -- : BFD_RELOC_XTENSA_SLOT10_ALT
5823 -- : BFD_RELOC_XTENSA_SLOT11_ALT
5824 -- : BFD_RELOC_XTENSA_SLOT12_ALT
5825 -- : BFD_RELOC_XTENSA_SLOT13_ALT
5826 -- : BFD_RELOC_XTENSA_SLOT14_ALT
5827     Alternate Xtensa relocations.  Only the slot is encoded in the
5828     relocation.  The meaning of these relocations is opcode-specific.
5829 -- : BFD_RELOC_XTENSA_OP0
5830 -- : BFD_RELOC_XTENSA_OP1
5831 -- : BFD_RELOC_XTENSA_OP2
5832     Xtensa relocations for backward compatibility.  These have all been
5833     replaced by BFD_RELOC_XTENSA_SLOT0_OP.
5834 -- : BFD_RELOC_XTENSA_ASM_EXPAND
5835     Xtensa relocation to mark that the assembler expanded the
5836     instructions from an original target.  The expansion size is
5837     encoded in the reloc size.
5838 -- : BFD_RELOC_XTENSA_ASM_SIMPLIFY
5839     Xtensa relocation to mark that the linker should simplify
5840     assembler-expanded instructions.  This is commonly used internally
5841     by the linker after analysis of a BFD_RELOC_XTENSA_ASM_EXPAND.
5842 -- : BFD_RELOC_XTENSA_TLSDESC_FN
5843 -- : BFD_RELOC_XTENSA_TLSDESC_ARG
5844 -- : BFD_RELOC_XTENSA_TLS_DTPOFF
5845 -- : BFD_RELOC_XTENSA_TLS_TPOFF
5846 -- : BFD_RELOC_XTENSA_TLS_FUNC
5847 -- : BFD_RELOC_XTENSA_TLS_ARG
5848 -- : BFD_RELOC_XTENSA_TLS_CALL
5849     Xtensa TLS relocations.
5850 -- : BFD_RELOC_XTENSA_PDIFF8
5851 -- : BFD_RELOC_XTENSA_PDIFF16
5852 -- : BFD_RELOC_XTENSA_PDIFF32
5853 -- : BFD_RELOC_XTENSA_NDIFF8
5854 -- : BFD_RELOC_XTENSA_NDIFF16
5855 -- : BFD_RELOC_XTENSA_NDIFF32
5856     Xtensa relocations to mark the difference of two local symbols.
5857     These are only needed to support linker relaxation and can be
5858     ignored when not relaxing.  The field is set to the value of the
5859     difference assuming no relaxation.  The relocation encodes the
5860     position of the subtracted symbol so the linker can determine
5861     whether to adjust the field value.  PDIFF relocations are used for
5862     positive differences, NDIFF relocations are used for negative
5863     differences.  The difference value is treated as unsigned with
5864     these relocation types, giving full 8/16 value ranges.
5865 -- : BFD_RELOC_Z80_DISP8
5866     8 bit signed offset in (ix+d) or (iy+d).
5867 -- : BFD_RELOC_Z80_BYTE0
5868     First 8 bits of multibyte (32, 24 or 16 bit) value.
5869 -- : BFD_RELOC_Z80_BYTE1
5870     Second 8 bits of multibyte (32, 24 or 16 bit) value.
5871 -- : BFD_RELOC_Z80_BYTE2
5872     Third 8 bits of multibyte (32 or 24 bit) value.
5873 -- : BFD_RELOC_Z80_BYTE3
5874     Fourth 8 bits of multibyte (32 bit) value.
5875 -- : BFD_RELOC_Z80_WORD0
5876     Lowest 16 bits of multibyte (32 or 24 bit) value.
5877 -- : BFD_RELOC_Z80_WORD1
5878     Highest 16 bits of multibyte (32 or 24 bit) value.
5879 -- : BFD_RELOC_Z80_16_BE
5880     Like BFD_RELOC_16 but big-endian.
5881 -- : BFD_RELOC_Z8K_DISP7
5882     DJNZ offset.
5883 -- : BFD_RELOC_Z8K_CALLR
5884     CALR offset.
5885 -- : BFD_RELOC_Z8K_IMM4L
5886     4 bit value.
5887 -- : BFD_RELOC_LM32_CALL
5888 -- : BFD_RELOC_LM32_BRANCH
5889 -- : BFD_RELOC_LM32_16_GOT
5890 -- : BFD_RELOC_LM32_GOTOFF_HI16
5891 -- : BFD_RELOC_LM32_GOTOFF_LO16
5892 -- : BFD_RELOC_LM32_COPY
5893 -- : BFD_RELOC_LM32_GLOB_DAT
5894 -- : BFD_RELOC_LM32_JMP_SLOT
5895 -- : BFD_RELOC_LM32_RELATIVE
5896     Lattice Mico32 relocations.
5897 -- : BFD_RELOC_MACH_O_SECTDIFF
5898     Difference between two section addreses.  Must be followed by a
5899     BFD_RELOC_MACH_O_PAIR.
5900 -- : BFD_RELOC_MACH_O_LOCAL_SECTDIFF
5901     Like BFD_RELOC_MACH_O_SECTDIFF but with a local symbol.
5902 -- : BFD_RELOC_MACH_O_PAIR
5903     Pair of relocation.  Contains the first symbol.
5904 -- : BFD_RELOC_MACH_O_SUBTRACTOR32
5905     Symbol will be substracted.  Must be followed by a BFD_RELOC_32.
5906 -- : BFD_RELOC_MACH_O_SUBTRACTOR64
5907     Symbol will be substracted.  Must be followed by a BFD_RELOC_64.
5908 -- : BFD_RELOC_MACH_O_X86_64_BRANCH32
5909 -- : BFD_RELOC_MACH_O_X86_64_BRANCH8
5910     PCREL relocations.  They are marked as branch to create PLT entry
5911     if required.
5912 -- : BFD_RELOC_MACH_O_X86_64_GOT
5913     Used when referencing a GOT entry.
5914 -- : BFD_RELOC_MACH_O_X86_64_GOT_LOAD
5915     Used when loading a GOT entry with movq.  It is specially marked so
5916     that the linker could optimize the movq to a leaq if possible.
5917 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_1
5918     Same as BFD_RELOC_32_PCREL but with an implicit -1 addend.
5919 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_2
5920     Same as BFD_RELOC_32_PCREL but with an implicit -2 addend.
5921 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_4
5922     Same as BFD_RELOC_32_PCREL but with an implicit -4 addend.
5923 -- : BFD_RELOC_MACH_O_X86_64_TLV
5924     Used when referencing a TLV entry.
5925 -- : BFD_RELOC_MACH_O_ARM64_ADDEND
5926     Addend for PAGE or PAGEOFF.
5927 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21
5928     Relative offset to page of GOT slot.
5929 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12
5930     Relative offset within page of GOT slot.
5931 -- : BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT
5932     Address of a GOT entry.
5933 -- : BFD_RELOC_MICROBLAZE_32_LO
5934     This is a 32 bit reloc for the microblaze that stores the low 16
5935     bits of a value.
5936 -- : BFD_RELOC_MICROBLAZE_32_LO_PCREL
5937     This is a 32 bit pc-relative reloc for the microblaze that stores
5938     the low 16 bits of a value.
5939 -- : BFD_RELOC_MICROBLAZE_32_ROSDA
5940     This is a 32 bit reloc for the microblaze that stores a value
5941     relative to the read-only small data area anchor.
5942 -- : BFD_RELOC_MICROBLAZE_32_RWSDA
5943     This is a 32 bit reloc for the microblaze that stores a value
5944     relative to the read-write small data area anchor.
5945 -- : BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM
5946     This is a 32 bit reloc for the microblaze to handle expressions of
5947     the form "Symbol Op Symbol".
5948 -- : BFD_RELOC_MICROBLAZE_32_NONE
5949     This is a 32 bit reloc that stores the 32 bit pc relative value in
5950     two words (with an imm instruction).  No relocation is done here -
5951     only used for relaxing.
5952 -- : BFD_RELOC_MICROBLAZE_64_NONE
5953     This is a 64 bit reloc that stores the 32 bit pc relative value in
5954     two words (with an imm instruction).  No relocation is done here -
5955     only used for relaxing.
5956 -- : BFD_RELOC_MICROBLAZE_64_GOTPC
5957     This is a 64 bit reloc that stores the 32 bit pc relative value in
5958     two words (with an imm instruction).  The relocation is PC-relative
5959     GOT offset.
5960 -- : BFD_RELOC_MICROBLAZE_64_GOT
5961     This is a 64 bit reloc that stores the 32 bit pc relative value in
5962     two words (with an imm instruction).  The relocation is GOT offset.
5963 -- : BFD_RELOC_MICROBLAZE_64_PLT
5964     This is a 64 bit reloc that stores the 32 bit pc relative value in
5965     two words (with an imm instruction).  The relocation is PC-relative
5966     offset into PLT.
5967 -- : BFD_RELOC_MICROBLAZE_64_GOTOFF
5968     This is a 64 bit reloc that stores the 32 bit GOT relative value in
5969     two words (with an imm instruction).  The relocation is relative
5970     offset from _GLOBAL_OFFSET_TABLE_.
5971 -- : BFD_RELOC_MICROBLAZE_32_GOTOFF
5972     This is a 32 bit reloc that stores the 32 bit GOT relative value in
5973     a word.  The relocation is relative offset from
5974     _GLOBAL_OFFSET_TABLE_.
5975 -- : BFD_RELOC_MICROBLAZE_COPY
5976     This is used to tell the dynamic linker to copy the value out of
5977     the dynamic object into the runtime process image.
5978 -- : BFD_RELOC_MICROBLAZE_64_TLS
5979     Unused Reloc.
5980 -- : BFD_RELOC_MICROBLAZE_64_TLSGD
5981     This is a 64 bit reloc that stores the 32 bit GOT relative value of
5982     the GOT TLS GD info entry in two words (with an imm instruction).
5983     The relocation is GOT offset.
5984 -- : BFD_RELOC_MICROBLAZE_64_TLSLD
5985     This is a 64 bit reloc that stores the 32 bit GOT relative value of
5986     the GOT TLS LD info entry in two words (with an imm instruction).
5987     The relocation is GOT offset.
5988 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPMOD
5989     This is a 32 bit reloc that stores the Module ID to GOT(n).
5990 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPREL
5991     This is a 32 bit reloc that stores TLS offset to GOT(n+1).
5992 -- : BFD_RELOC_MICROBLAZE_64_TLSDTPREL
5993     This is a 32 bit reloc for storing TLS offset to two words (uses
5994     imm instruction).
5995 -- : BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL
5996     This is a 64 bit reloc that stores 32-bit thread pointer relative
5997     offset to two words (uses imm instruction).
5998 -- : BFD_RELOC_MICROBLAZE_64_TLSTPREL
5999     This is a 64 bit reloc that stores 32-bit thread pointer relative
6000     offset to two words (uses imm instruction).
6001 -- : BFD_RELOC_MICROBLAZE_64_TEXTPCREL
6002     This is a 64 bit reloc that stores the 32 bit pc relative value in
6003     two words (with an imm instruction).  The relocation is PC-relative
6004     offset from start of TEXT.
6005 -- : BFD_RELOC_MICROBLAZE_64_TEXTREL
6006     This is a 64 bit reloc that stores the 32 bit offset value in two
6007     words (with an imm instruction).  The relocation is relative offset
6008     from start of TEXT.
6009 -- : BFD_RELOC_KVX_RELOC_START
6010     KVX pseudo relocation code to mark the start of the KVX relocation
6011     enumerators.  N.B. the order of the enumerators is important as
6012     several tables in the KVX bfd backend are indexed by these
6013     enumerators; make sure they are all synced.
6014 -- : BFD_RELOC_KVX_NONE
6015     KVX null relocation code.
6016 -- : BFD_RELOC_KVX_16
6017 -- : BFD_RELOC_KVX_32
6018 -- : BFD_RELOC_KVX_64
6019 -- : BFD_RELOC_KVX_S16_PCREL
6020 -- : BFD_RELOC_KVX_PCREL17
6021 -- : BFD_RELOC_KVX_PCREL27
6022 -- : BFD_RELOC_KVX_32_PCREL
6023 -- : BFD_RELOC_KVX_S37_PCREL_LO10
6024 -- : BFD_RELOC_KVX_S37_PCREL_UP27
6025 -- : BFD_RELOC_KVX_S43_PCREL_LO10
6026 -- : BFD_RELOC_KVX_S43_PCREL_UP27
6027 -- : BFD_RELOC_KVX_S43_PCREL_EX6
6028 -- : BFD_RELOC_KVX_S64_PCREL_LO10
6029 -- : BFD_RELOC_KVX_S64_PCREL_UP27
6030 -- : BFD_RELOC_KVX_S64_PCREL_EX27
6031 -- : BFD_RELOC_KVX_64_PCREL
6032 -- : BFD_RELOC_KVX_S16
6033 -- : BFD_RELOC_KVX_S32_LO5
6034 -- : BFD_RELOC_KVX_S32_UP27
6035 -- : BFD_RELOC_KVX_S37_LO10
6036 -- : BFD_RELOC_KVX_S37_UP27
6037 -- : BFD_RELOC_KVX_S37_GOTOFF_LO10
6038 -- : BFD_RELOC_KVX_S37_GOTOFF_UP27
6039 -- : BFD_RELOC_KVX_S43_GOTOFF_LO10
6040 -- : BFD_RELOC_KVX_S43_GOTOFF_UP27
6041 -- : BFD_RELOC_KVX_S43_GOTOFF_EX6
6042 -- : BFD_RELOC_KVX_32_GOTOFF
6043 -- : BFD_RELOC_KVX_64_GOTOFF
6044 -- : BFD_RELOC_KVX_32_GOT
6045 -- : BFD_RELOC_KVX_S37_GOT_LO10
6046 -- : BFD_RELOC_KVX_S37_GOT_UP27
6047 -- : BFD_RELOC_KVX_S43_GOT_LO10
6048 -- : BFD_RELOC_KVX_S43_GOT_UP27
6049 -- : BFD_RELOC_KVX_S43_GOT_EX6
6050 -- : BFD_RELOC_KVX_64_GOT
6051 -- : BFD_RELOC_KVX_GLOB_DAT
6052 -- : BFD_RELOC_KVX_COPY
6053 -- : BFD_RELOC_KVX_JMP_SLOT
6054 -- : BFD_RELOC_KVX_RELATIVE
6055 -- : BFD_RELOC_KVX_S43_LO10
6056 -- : BFD_RELOC_KVX_S43_UP27
6057 -- : BFD_RELOC_KVX_S43_EX6
6058 -- : BFD_RELOC_KVX_S64_LO10
6059 -- : BFD_RELOC_KVX_S64_UP27
6060 -- : BFD_RELOC_KVX_S64_EX27
6061 -- : BFD_RELOC_KVX_S37_GOTADDR_LO10
6062 -- : BFD_RELOC_KVX_S37_GOTADDR_UP27
6063 -- : BFD_RELOC_KVX_S43_GOTADDR_LO10
6064 -- : BFD_RELOC_KVX_S43_GOTADDR_UP27
6065 -- : BFD_RELOC_KVX_S43_GOTADDR_EX6
6066 -- : BFD_RELOC_KVX_S64_GOTADDR_LO10
6067 -- : BFD_RELOC_KVX_S64_GOTADDR_UP27
6068 -- : BFD_RELOC_KVX_S64_GOTADDR_EX27
6069 -- : BFD_RELOC_KVX_64_DTPMOD
6070 -- : BFD_RELOC_KVX_64_DTPOFF
6071 -- : BFD_RELOC_KVX_S37_TLS_DTPOFF_LO10
6072 -- : BFD_RELOC_KVX_S37_TLS_DTPOFF_UP27
6073 -- : BFD_RELOC_KVX_S43_TLS_DTPOFF_LO10
6074 -- : BFD_RELOC_KVX_S43_TLS_DTPOFF_UP27
6075 -- : BFD_RELOC_KVX_S43_TLS_DTPOFF_EX6
6076 -- : BFD_RELOC_KVX_S37_TLS_GD_LO10
6077 -- : BFD_RELOC_KVX_S37_TLS_GD_UP27
6078 -- : BFD_RELOC_KVX_S43_TLS_GD_LO10
6079 -- : BFD_RELOC_KVX_S43_TLS_GD_UP27
6080 -- : BFD_RELOC_KVX_S43_TLS_GD_EX6
6081 -- : BFD_RELOC_KVX_S37_TLS_LD_LO10
6082 -- : BFD_RELOC_KVX_S37_TLS_LD_UP27
6083 -- : BFD_RELOC_KVX_S43_TLS_LD_LO10
6084 -- : BFD_RELOC_KVX_S43_TLS_LD_UP27
6085 -- : BFD_RELOC_KVX_S43_TLS_LD_EX6
6086 -- : BFD_RELOC_KVX_64_TPOFF
6087 -- : BFD_RELOC_KVX_S37_TLS_IE_LO10
6088 -- : BFD_RELOC_KVX_S37_TLS_IE_UP27
6089 -- : BFD_RELOC_KVX_S43_TLS_IE_LO10
6090 -- : BFD_RELOC_KVX_S43_TLS_IE_UP27
6091 -- : BFD_RELOC_KVX_S43_TLS_IE_EX6
6092 -- : BFD_RELOC_KVX_S37_TLS_LE_LO10
6093 -- : BFD_RELOC_KVX_S37_TLS_LE_UP27
6094 -- : BFD_RELOC_KVX_S43_TLS_LE_LO10
6095 -- : BFD_RELOC_KVX_S43_TLS_LE_UP27
6096 -- : BFD_RELOC_KVX_S43_TLS_LE_EX6
6097 -- : BFD_RELOC_KVX_8
6098     KVX Relocations.
6099 -- : BFD_RELOC_KVX_RELOC_END
6100     KVX pseudo relocation code to mark the end of the KVX relocation
6101     enumerators that have direct mapping to ELF reloc codes.  There are
6102     a few more enumerators after this one; those are mainly used by the
6103     KVX assembler for the internal fixup or to select one of the above
6104     enumerators.
6105 -- : BFD_RELOC_AARCH64_RELOC_START
6106     AArch64 pseudo relocation code to mark the start of the AArch64
6107     relocation enumerators.  N.B. the order of the enumerators is
6108     important as several tables in the AArch64 bfd backend are indexed
6109     by these enumerators; make sure they are all synced.
6110 -- : BFD_RELOC_AARCH64_NULL
6111     Deprecated AArch64 null relocation code.
6112 -- : BFD_RELOC_AARCH64_NONE
6113     AArch64 null relocation code.
6114 -- : BFD_RELOC_AARCH64_64
6115 -- : BFD_RELOC_AARCH64_32
6116 -- : BFD_RELOC_AARCH64_16
6117     Basic absolute relocations of N bits.  These are equivalent to
6118     BFD_RELOC_N and they were added to assist the indexing of the howto
6119     table.
6120 -- : BFD_RELOC_AARCH64_64_PCREL
6121 -- : BFD_RELOC_AARCH64_32_PCREL
6122 -- : BFD_RELOC_AARCH64_16_PCREL
6123     PC-relative relocations.  These are equivalent to BFD_RELOC_N_PCREL
6124     and they were added to assist the indexing of the howto table.
6125 -- : BFD_RELOC_AARCH64_MOVW_G0
6126     AArch64 MOV[NZK] instruction with most significant bits 0 to 15 of
6127     an unsigned address/value.
6128 -- : BFD_RELOC_AARCH64_MOVW_G0_NC
6129     AArch64 MOV[NZK] instruction with less significant bits 0 to 15 of
6130     an address/value.  No overflow checking.
6131 -- : BFD_RELOC_AARCH64_MOVW_G1
6132     AArch64 MOV[NZK] instruction with most significant bits 16 to 31 of
6133     an unsigned address/value.
6134 -- : BFD_RELOC_AARCH64_MOVW_G1_NC
6135     AArch64 MOV[NZK] instruction with less significant bits 16 to 31 of
6136     an address/value.  No overflow checking.
6137 -- : BFD_RELOC_AARCH64_MOVW_G2
6138     AArch64 MOV[NZK] instruction with most significant bits 32 to 47 of
6139     an unsigned address/value.
6140 -- : BFD_RELOC_AARCH64_MOVW_G2_NC
6141     AArch64 MOV[NZK] instruction with less significant bits 32 to 47 of
6142     an address/value.  No overflow checking.
6143 -- : BFD_RELOC_AARCH64_MOVW_G3
6144     AArch64 MOV[NZK] instruction with most signficant bits 48 to 64 of
6145     a signed or unsigned address/value.
6146 -- : BFD_RELOC_AARCH64_MOVW_G0_S
6147     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6148     signed value.  Changes instruction to MOVZ or MOVN depending on the
6149     value���s sign.
6150 -- : BFD_RELOC_AARCH64_MOVW_G1_S
6151     AArch64 MOV[NZ] instruction with most significant bits 16 to 31 of
6152     a signed value.  Changes instruction to MOVZ or MOVN depending on
6153     the value���s sign.
6154 -- : BFD_RELOC_AARCH64_MOVW_G2_S
6155     AArch64 MOV[NZ] instruction with most significant bits 32 to 47 of
6156     a signed value.  Changes instruction to MOVZ or MOVN depending on
6157     the value���s sign.
6158 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0
6159     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6160     signed value.  Changes instruction to MOVZ or MOVN depending on the
6161     value���s sign.
6162 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0_NC
6163     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6164     signed value.  Changes instruction to MOVZ or MOVN depending on the
6165     value���s sign.
6166 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1
6167     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6168     signed value.
6169 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1_NC
6170     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6171     signed value.
6172 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2
6173     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6174     signed value.
6175 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2_NC
6176     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6177     signed value.
6178 -- : BFD_RELOC_AARCH64_MOVW_PREL_G3
6179     AArch64 MOVK instruction with most significant bits 47 to 63 of a
6180     signed value.
6181 -- : BFD_RELOC_AARCH64_LD_LO19_PCREL
6182     AArch64 Load Literal instruction, holding a 19 bit pc-relative word
6183     offset.  The lowest two bits must be zero and are not stored in the
6184     instruction, giving a 21 bit signed byte offset.
6185 -- : BFD_RELOC_AARCH64_ADR_LO21_PCREL
6186     AArch64 ADR instruction, holding a simple 21 bit pc-relative byte
6187     offset.
6188 -- : BFD_RELOC_AARCH64_ADR_HI21_PCREL
6189     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6190     offset, giving a 4KB aligned page base address.
6191 -- : BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL
6192     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6193     offset, giving a 4KB aligned page base address, but with no
6194     overflow checking.
6195 -- : BFD_RELOC_AARCH64_ADD_LO12
6196     AArch64 ADD immediate instruction, holding bits 0 to 11 of the
6197     address.  Used in conjunction with
6198     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6199 -- : BFD_RELOC_AARCH64_LDST8_LO12
6200     AArch64 8-bit load/store instruction, holding bits 0 to 11 of the
6201     address.  Used in conjunction with
6202     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6203 -- : BFD_RELOC_AARCH64_TSTBR14
6204     AArch64 14 bit pc-relative test bit and branch.  The lowest two
6205     bits must be zero and are not stored in the instruction, giving a
6206     16 bit signed byte offset.
6207 -- : BFD_RELOC_AARCH64_BRANCH19
6208     AArch64 19 bit pc-relative conditional branch and compare & branch.
6209     The lowest two bits must be zero and are not stored in the
6210     instruction, giving a 21 bit signed byte offset.
6211 -- : BFD_RELOC_AARCH64_JUMP26
6212     AArch64 26 bit pc-relative unconditional branch.  The lowest two
6213     bits must be zero and are not stored in the instruction, giving a
6214     28 bit signed byte offset.
6215 -- : BFD_RELOC_AARCH64_CALL26
6216     AArch64 26 bit pc-relative unconditional branch and link.  The
6217     lowest two bits must be zero and are not stored in the instruction,
6218     giving a 28 bit signed byte offset.
6219 -- : BFD_RELOC_AARCH64_LDST16_LO12
6220     AArch64 16-bit load/store instruction, holding bits 0 to 11 of the
6221     address.  Used in conjunction with
6222     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6223 -- : BFD_RELOC_AARCH64_LDST32_LO12
6224     AArch64 32-bit load/store instruction, holding bits 0 to 11 of the
6225     address.  Used in conjunction with
6226     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6227 -- : BFD_RELOC_AARCH64_LDST64_LO12
6228     AArch64 64-bit load/store instruction, holding bits 0 to 11 of the
6229     address.  Used in conjunction with
6230     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6231 -- : BFD_RELOC_AARCH64_LDST128_LO12
6232     AArch64 128-bit load/store instruction, holding bits 0 to 11 of the
6233     address.  Used in conjunction with
6234     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6235 -- : BFD_RELOC_AARCH64_GOT_LD_PREL19
6236     AArch64 Load Literal instruction, holding a 19 bit PC relative word
6237     offset of the global offset table entry for a symbol.  The lowest
6238     two bits must be zero and are not stored in the instruction, giving
6239     a 21 bit signed byte offset.  This relocation type requires signed
6240     overflow checking.
6241 -- : BFD_RELOC_AARCH64_ADR_GOT_PAGE
6242     Get to the page base of the global offset table entry for a symbol
6243     as part of an ADRP instruction using a 21 bit PC relative value.
6244     Used in conjunction with BFD_RELOC_AARCH64_LD64_GOT_LO12_NC.
6245 -- : BFD_RELOC_AARCH64_LD64_GOT_LO12_NC
6246     Unsigned 12 bit byte offset for 64 bit load/store from the page of
6247     the GOT entry for this symbol.  Used in conjunction with
6248     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in LP64 ABI only.
6249 -- : BFD_RELOC_AARCH64_LD32_GOT_LO12_NC
6250     Unsigned 12 bit byte offset for 32 bit load/store from the page of
6251     the GOT entry for this symbol.  Used in conjunction with
6252     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in ILP32 ABI only.
6253 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC
6254     Unsigned 16 bit byte offset for 64 bit load/store from the GOT
6255     entry for this symbol.  Valid in LP64 ABI only.
6256 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G1
6257     Unsigned 16 bit byte higher offset for 64 bit load/store from the
6258     GOT entry for this symbol.  Valid in LP64 ABI only.
6259 -- : BFD_RELOC_AARCH64_LD64_GOTOFF_LO15
6260     Unsigned 15 bit byte offset for 64 bit load/store from the page of
6261     the GOT entry for this symbol.  Valid in LP64 ABI only.
6262 -- : BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14
6263     Scaled 14 bit byte offset to the page base of the global offset
6264     table.
6265 -- : BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15
6266     Scaled 15 bit byte offset to the page base of the global offset
6267     table.
6268 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21
6269     Get to the page base of the global offset table entry for a symbols
6270     tls_index structure as part of an adrp instruction using a 21 bit
6271     PC relative value.  Used in conjunction with
6272     BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC.
6273 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PREL21
6274     AArch64 TLS General Dynamic.
6275 -- : BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC
6276     Unsigned 12 bit byte offset to global offset table entry for a
6277     symbol���s tls_index structure.  Used in conjunction with
6278     BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21.
6279 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC
6280     AArch64 TLS General Dynamic relocation.
6281 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G1
6282     AArch64 TLS General Dynamic relocation.
6283 -- : BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21
6284     AArch64 TLS INITIAL EXEC relocation.
6285 -- : BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC
6286     AArch64 TLS INITIAL EXEC relocation.
6287 -- : BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC
6288     AArch64 TLS INITIAL EXEC relocation.
6289 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19
6290     AArch64 TLS INITIAL EXEC relocation.
6291 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC
6292     AArch64 TLS INITIAL EXEC relocation.
6293 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1
6294     AArch64 TLS INITIAL EXEC relocation.
6295 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12
6296     bit[23:12] of byte offset to module TLS base address.
6297 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12
6298     Unsigned 12 bit byte offset to module TLS base address.
6299 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC
6300     No overflow check version of
6301     BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12.
6302 -- : BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC
6303     Unsigned 12 bit byte offset to global offset table entry for a
6304     symbol���s tls_index structure.  Used in conjunction with
6305     BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21.
6306 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21
6307     GOT entry page address for AArch64 TLS Local Dynamic, used with
6308     ADRP instruction.
6309 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PREL21
6310     GOT entry address for AArch64 TLS Local Dynamic, used with ADR
6311     instruction.
6312 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12
6313     bit[11:1] of byte offset to module TLS base address, encoded in
6314     ldst instructions.
6315 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC
6316     Similar to BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12, but no
6317     overflow check.
6318 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12
6319     bit[11:2] of byte offset to module TLS base address, encoded in
6320     ldst instructions.
6321 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC
6322     Similar to BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12, but no
6323     overflow check.
6324 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12
6325     bit[11:3] of byte offset to module TLS base address, encoded in
6326     ldst instructions.
6327 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC
6328     Similar to BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12, but no
6329     overflow check.
6330 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12
6331     bit[11:0] of byte offset to module TLS base address, encoded in
6332     ldst instructions.
6333 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC
6334     Similar to BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12, but no
6335     overflow check.
6336 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6337     bit[15:0] of byte offset to module TLS base address.
6338 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC
6339     No overflow check version of
6340     BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0.
6341 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6342     bit[31:16] of byte offset to module TLS base address.
6343 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC
6344     No overflow check version of
6345     BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1.
6346 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2
6347     bit[47:32] of byte offset to module TLS base address.
6348 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2
6349     AArch64 TLS LOCAL EXEC relocation.
6350 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1
6351     AArch64 TLS LOCAL EXEC relocation.
6352 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC
6353     AArch64 TLS LOCAL EXEC relocation.
6354 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0
6355     AArch64 TLS LOCAL EXEC relocation.
6356 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC
6357     AArch64 TLS LOCAL EXEC relocation.
6358 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12
6359     AArch64 TLS LOCAL EXEC relocation.
6360 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12
6361     AArch64 TLS LOCAL EXEC relocation.
6362 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC
6363     AArch64 TLS LOCAL EXEC relocation.
6364 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12
6365     bit[11:1] of byte offset to module TLS base address, encoded in
6366     ldst instructions.
6367 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC
6368     Similar to BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12, but no
6369     overflow check.
6370 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12
6371     bit[11:2] of byte offset to module TLS base address, encoded in
6372     ldst instructions.
6373 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC
6374     Similar to BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12, but no
6375     overflow check.
6376 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12
6377     bit[11:3] of byte offset to module TLS base address, encoded in
6378     ldst instructions.
6379 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC
6380     Similar to BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12, but no
6381     overflow check.
6382 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12
6383     bit[11:0] of byte offset to module TLS base address, encoded in
6384     ldst instructions.
6385 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC
6386     Similar to BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12, but no
6387     overflow check.
6388 -- : BFD_RELOC_AARCH64_TLSDESC_LD_PREL19
6389 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21
6390 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21
6391 -- : BFD_RELOC_AARCH64_TLSDESC_LD64_LO12
6392 -- : BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC
6393 -- : BFD_RELOC_AARCH64_TLSDESC_ADD_LO12
6394 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G1
6395 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC
6396 -- : BFD_RELOC_AARCH64_TLSDESC_LDR
6397 -- : BFD_RELOC_AARCH64_TLSDESC_ADD
6398 -- : BFD_RELOC_AARCH64_TLSDESC_CALL
6399     AArch64 TLS DESC relocations.
6400 -- : BFD_RELOC_AARCH64_COPY
6401 -- : BFD_RELOC_AARCH64_GLOB_DAT
6402 -- : BFD_RELOC_AARCH64_JUMP_SLOT
6403 -- : BFD_RELOC_AARCH64_RELATIVE
6404     AArch64 DSO relocations.
6405 -- : BFD_RELOC_AARCH64_TLS_DTPMOD
6406 -- : BFD_RELOC_AARCH64_TLS_DTPREL
6407 -- : BFD_RELOC_AARCH64_TLS_TPREL
6408 -- : BFD_RELOC_AARCH64_TLSDESC
6409     AArch64 TLS relocations.
6410 -- : BFD_RELOC_AARCH64_IRELATIVE
6411     AArch64 support for STT_GNU_IFUNC.
6412 -- : BFD_RELOC_AARCH64_RELOC_END
6413     AArch64 pseudo relocation code to mark the end of the AArch64
6414     relocation enumerators that have direct mapping to ELF reloc codes.
6415     There are a few more enumerators after this one; those are mainly
6416     used by the AArch64 assembler for the internal fixup or to select
6417     one of the above enumerators.
6418 -- : BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP
6419     AArch64 pseudo relocation code to be used internally by the AArch64
6420     assembler and not (currently) written to any object files.
6421 -- : BFD_RELOC_AARCH64_LDST_LO12
6422     AArch64 unspecified load/store instruction, holding bits 0 to 11 of
6423     the address.  Used in conjunction with
6424     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6425 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12
6426     AArch64 pseudo relocation code for TLS local dynamic mode.  It���s to
6427     be used internally by the AArch64 assembler and not (currently)
6428     written to any object files.
6429 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC
6430     Similar to BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12, but no
6431     overflow check.
6432 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12
6433     AArch64 pseudo relocation code for TLS local exec mode.  It���s to be
6434     used internally by the AArch64 assembler and not (currently)
6435     written to any object files.
6436 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC
6437     Similar to BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12, but no overflow
6438     check.
6439 -- : BFD_RELOC_AARCH64_LD_GOT_LO12_NC
6440     AArch64 pseudo relocation code to be used internally by the AArch64
6441     assembler and not (currently) written to any object files.
6442 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC
6443     AArch64 pseudo relocation code to be used internally by the AArch64
6444     assembler and not (currently) written to any object files.
6445 -- : BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC
6446     AArch64 pseudo relocation code to be used internally by the AArch64
6447     assembler and not (currently) written to any object files.
6448 -- : BFD_RELOC_TILEPRO_COPY
6449 -- : BFD_RELOC_TILEPRO_GLOB_DAT
6450 -- : BFD_RELOC_TILEPRO_JMP_SLOT
6451 -- : BFD_RELOC_TILEPRO_RELATIVE
6452 -- : BFD_RELOC_TILEPRO_BROFF_X1
6453 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1
6454 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT
6455 -- : BFD_RELOC_TILEPRO_IMM8_X0
6456 -- : BFD_RELOC_TILEPRO_IMM8_Y0
6457 -- : BFD_RELOC_TILEPRO_IMM8_X1
6458 -- : BFD_RELOC_TILEPRO_IMM8_Y1
6459 -- : BFD_RELOC_TILEPRO_DEST_IMM8_X1
6460 -- : BFD_RELOC_TILEPRO_MT_IMM15_X1
6461 -- : BFD_RELOC_TILEPRO_MF_IMM15_X1
6462 -- : BFD_RELOC_TILEPRO_IMM16_X0
6463 -- : BFD_RELOC_TILEPRO_IMM16_X1
6464 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO
6465 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO
6466 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI
6467 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI
6468 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA
6469 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA
6470 -- : BFD_RELOC_TILEPRO_IMM16_X0_PCREL
6471 -- : BFD_RELOC_TILEPRO_IMM16_X1_PCREL
6472 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL
6473 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL
6474 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL
6475 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL
6476 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL
6477 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL
6478 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT
6479 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT
6480 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO
6481 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO
6482 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI
6483 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI
6484 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA
6485 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA
6486 -- : BFD_RELOC_TILEPRO_MMSTART_X0
6487 -- : BFD_RELOC_TILEPRO_MMEND_X0
6488 -- : BFD_RELOC_TILEPRO_MMSTART_X1
6489 -- : BFD_RELOC_TILEPRO_MMEND_X1
6490 -- : BFD_RELOC_TILEPRO_SHAMT_X0
6491 -- : BFD_RELOC_TILEPRO_SHAMT_X1
6492 -- : BFD_RELOC_TILEPRO_SHAMT_Y0
6493 -- : BFD_RELOC_TILEPRO_SHAMT_Y1
6494 -- : BFD_RELOC_TILEPRO_TLS_GD_CALL
6495 -- : BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD
6496 -- : BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD
6497 -- : BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD
6498 -- : BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD
6499 -- : BFD_RELOC_TILEPRO_TLS_IE_LOAD
6500 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD
6501 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD
6502 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO
6503 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO
6504 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI
6505 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI
6506 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA
6507 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA
6508 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE
6509 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE
6510 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO
6511 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO
6512 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI
6513 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI
6514 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA
6515 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA
6516 -- : BFD_RELOC_TILEPRO_TLS_DTPMOD32
6517 -- : BFD_RELOC_TILEPRO_TLS_DTPOFF32
6518 -- : BFD_RELOC_TILEPRO_TLS_TPOFF32
6519 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE
6520 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE
6521 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO
6522 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO
6523 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI
6524 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI
6525 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA
6526 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA
6527     Tilera TILEPro Relocations.
6528 -- : BFD_RELOC_TILEGX_HW0
6529 -- : BFD_RELOC_TILEGX_HW1
6530 -- : BFD_RELOC_TILEGX_HW2
6531 -- : BFD_RELOC_TILEGX_HW3
6532 -- : BFD_RELOC_TILEGX_HW0_LAST
6533 -- : BFD_RELOC_TILEGX_HW1_LAST
6534 -- : BFD_RELOC_TILEGX_HW2_LAST
6535 -- : BFD_RELOC_TILEGX_COPY
6536 -- : BFD_RELOC_TILEGX_GLOB_DAT
6537 -- : BFD_RELOC_TILEGX_JMP_SLOT
6538 -- : BFD_RELOC_TILEGX_RELATIVE
6539 -- : BFD_RELOC_TILEGX_BROFF_X1
6540 -- : BFD_RELOC_TILEGX_JUMPOFF_X1
6541 -- : BFD_RELOC_TILEGX_JUMPOFF_X1_PLT
6542 -- : BFD_RELOC_TILEGX_IMM8_X0
6543 -- : BFD_RELOC_TILEGX_IMM8_Y0
6544 -- : BFD_RELOC_TILEGX_IMM8_X1
6545 -- : BFD_RELOC_TILEGX_IMM8_Y1
6546 -- : BFD_RELOC_TILEGX_DEST_IMM8_X1
6547 -- : BFD_RELOC_TILEGX_MT_IMM14_X1
6548 -- : BFD_RELOC_TILEGX_MF_IMM14_X1
6549 -- : BFD_RELOC_TILEGX_MMSTART_X0
6550 -- : BFD_RELOC_TILEGX_MMEND_X0
6551 -- : BFD_RELOC_TILEGX_SHAMT_X0
6552 -- : BFD_RELOC_TILEGX_SHAMT_X1
6553 -- : BFD_RELOC_TILEGX_SHAMT_Y0
6554 -- : BFD_RELOC_TILEGX_SHAMT_Y1
6555 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0
6556 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0
6557 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1
6558 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1
6559 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2
6560 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2
6561 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3
6562 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3
6563 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST
6564 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST
6565 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST
6566 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST
6567 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST
6568 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST
6569 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL
6570 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL
6571 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL
6572 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL
6573 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL
6574 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL
6575 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL
6576 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL
6577 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL
6578 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL
6579 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL
6580 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL
6581 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL
6582 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL
6583 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT
6584 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT
6585 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL
6586 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL
6587 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL
6588 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL
6589 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL
6590 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL
6591 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT
6592 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT
6593 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT
6594 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT
6595 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL
6596 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL
6597 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD
6598 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD
6599 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE
6600 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE
6601 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE
6602 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE
6603 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE
6604 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE
6605 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD
6606 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD
6607 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD
6608 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD
6609 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE
6610 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE
6611 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL
6612 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL
6613 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL
6614 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL
6615 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL
6616 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL
6617 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE
6618 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE
6619 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE
6620 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE
6621 -- : BFD_RELOC_TILEGX_TLS_DTPMOD64
6622 -- : BFD_RELOC_TILEGX_TLS_DTPOFF64
6623 -- : BFD_RELOC_TILEGX_TLS_TPOFF64
6624 -- : BFD_RELOC_TILEGX_TLS_DTPMOD32
6625 -- : BFD_RELOC_TILEGX_TLS_DTPOFF32
6626 -- : BFD_RELOC_TILEGX_TLS_TPOFF32
6627 -- : BFD_RELOC_TILEGX_TLS_GD_CALL
6628 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD
6629 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD
6630 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD
6631 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD
6632 -- : BFD_RELOC_TILEGX_TLS_IE_LOAD
6633 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD
6634 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD
6635 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD
6636 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD
6637     Tilera TILE-Gx Relocations.
6638 -- : BFD_RELOC_BPF_64
6639 -- : BFD_RELOC_BPF_DISP32
6640 -- : BFD_RELOC_BPF_DISPCALL32
6641 -- : BFD_RELOC_BPF_DISP16
6642     Linux eBPF relocations.
6643 -- : BFD_RELOC_EPIPHANY_SIMM8
6644     Adapteva EPIPHANY - 8 bit signed pc-relative displacement.
6645 -- : BFD_RELOC_EPIPHANY_SIMM24
6646     Adapteva EPIPHANY - 24 bit signed pc-relative displacement.
6647 -- : BFD_RELOC_EPIPHANY_HIGH
6648     Adapteva EPIPHANY - 16 most-significant bits of absolute address.
6649 -- : BFD_RELOC_EPIPHANY_LOW
6650     Adapteva EPIPHANY - 16 least-significant bits of absolute address.
6651 -- : BFD_RELOC_EPIPHANY_SIMM11
6652     Adapteva EPIPHANY - 11 bit signed number - add/sub immediate.
6653 -- : BFD_RELOC_EPIPHANY_IMM11
6654     Adapteva EPIPHANY - 11 bit sign-magnitude number (ld/st
6655     displacement).
6656 -- : BFD_RELOC_EPIPHANY_IMM8
6657     Adapteva EPIPHANY - 8 bit immediate for 16 bit mov instruction.
6658 -- : BFD_RELOC_VISIUM_HI16
6659 -- : BFD_RELOC_VISIUM_LO16
6660 -- : BFD_RELOC_VISIUM_IM16
6661 -- : BFD_RELOC_VISIUM_REL16
6662 -- : BFD_RELOC_VISIUM_HI16_PCREL
6663 -- : BFD_RELOC_VISIUM_LO16_PCREL
6664 -- : BFD_RELOC_VISIUM_IM16_PCREL
6665     Visium Relocations.
6666 -- : BFD_RELOC_WASM32_LEB128
6667 -- : BFD_RELOC_WASM32_LEB128_GOT
6668 -- : BFD_RELOC_WASM32_LEB128_GOT_CODE
6669 -- : BFD_RELOC_WASM32_LEB128_PLT
6670 -- : BFD_RELOC_WASM32_PLT_INDEX
6671 -- : BFD_RELOC_WASM32_ABS32_CODE
6672 -- : BFD_RELOC_WASM32_COPY
6673 -- : BFD_RELOC_WASM32_CODE_POINTER
6674 -- : BFD_RELOC_WASM32_INDEX
6675 -- : BFD_RELOC_WASM32_PLT_SIG
6676     WebAssembly relocations.
6677 -- : BFD_RELOC_CKCORE_NONE
6678 -- : BFD_RELOC_CKCORE_ADDR32
6679 -- : BFD_RELOC_CKCORE_PCREL_IMM8BY4
6680 -- : BFD_RELOC_CKCORE_PCREL_IMM11BY2
6681 -- : BFD_RELOC_CKCORE_PCREL_IMM4BY2
6682 -- : BFD_RELOC_CKCORE_PCREL32
6683 -- : BFD_RELOC_CKCORE_PCREL_JSR_IMM11BY2
6684 -- : BFD_RELOC_CKCORE_GNU_VTINHERIT
6685 -- : BFD_RELOC_CKCORE_GNU_VTENTRY
6686 -- : BFD_RELOC_CKCORE_RELATIVE
6687 -- : BFD_RELOC_CKCORE_COPY
6688 -- : BFD_RELOC_CKCORE_GLOB_DAT
6689 -- : BFD_RELOC_CKCORE_JUMP_SLOT
6690 -- : BFD_RELOC_CKCORE_GOTOFF
6691 -- : BFD_RELOC_CKCORE_GOTPC
6692 -- : BFD_RELOC_CKCORE_GOT32
6693 -- : BFD_RELOC_CKCORE_PLT32
6694 -- : BFD_RELOC_CKCORE_ADDRGOT
6695 -- : BFD_RELOC_CKCORE_ADDRPLT
6696 -- : BFD_RELOC_CKCORE_PCREL_IMM26BY2
6697 -- : BFD_RELOC_CKCORE_PCREL_IMM16BY2
6698 -- : BFD_RELOC_CKCORE_PCREL_IMM16BY4
6699 -- : BFD_RELOC_CKCORE_PCREL_IMM10BY2
6700 -- : BFD_RELOC_CKCORE_PCREL_IMM10BY4
6701 -- : BFD_RELOC_CKCORE_ADDR_HI16
6702 -- : BFD_RELOC_CKCORE_ADDR_LO16
6703 -- : BFD_RELOC_CKCORE_GOTPC_HI16
6704 -- : BFD_RELOC_CKCORE_GOTPC_LO16
6705 -- : BFD_RELOC_CKCORE_GOTOFF_HI16
6706 -- : BFD_RELOC_CKCORE_GOTOFF_LO16
6707 -- : BFD_RELOC_CKCORE_GOT12
6708 -- : BFD_RELOC_CKCORE_GOT_HI16
6709 -- : BFD_RELOC_CKCORE_GOT_LO16
6710 -- : BFD_RELOC_CKCORE_PLT12
6711 -- : BFD_RELOC_CKCORE_PLT_HI16
6712 -- : BFD_RELOC_CKCORE_PLT_LO16
6713 -- : BFD_RELOC_CKCORE_ADDRGOT_HI16
6714 -- : BFD_RELOC_CKCORE_ADDRGOT_LO16
6715 -- : BFD_RELOC_CKCORE_ADDRPLT_HI16
6716 -- : BFD_RELOC_CKCORE_ADDRPLT_LO16
6717 -- : BFD_RELOC_CKCORE_PCREL_JSR_IMM26BY2
6718 -- : BFD_RELOC_CKCORE_TOFFSET_LO16
6719 -- : BFD_RELOC_CKCORE_DOFFSET_LO16
6720 -- : BFD_RELOC_CKCORE_PCREL_IMM18BY2
6721 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18
6722 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18BY2
6723 -- : BFD_RELOC_CKCORE_DOFFSET_IMM18BY4
6724 -- : BFD_RELOC_CKCORE_GOTOFF_IMM18
6725 -- : BFD_RELOC_CKCORE_GOT_IMM18BY4
6726 -- : BFD_RELOC_CKCORE_PLT_IMM18BY4
6727 -- : BFD_RELOC_CKCORE_PCREL_IMM7BY4
6728 -- : BFD_RELOC_CKCORE_TLS_LE32
6729 -- : BFD_RELOC_CKCORE_TLS_IE32
6730 -- : BFD_RELOC_CKCORE_TLS_GD32
6731 -- : BFD_RELOC_CKCORE_TLS_LDM32
6732 -- : BFD_RELOC_CKCORE_TLS_LDO32
6733 -- : BFD_RELOC_CKCORE_TLS_DTPMOD32
6734 -- : BFD_RELOC_CKCORE_TLS_DTPOFF32
6735 -- : BFD_RELOC_CKCORE_TLS_TPOFF32
6736 -- : BFD_RELOC_CKCORE_PCREL_FLRW_IMM8BY4
6737 -- : BFD_RELOC_CKCORE_NOJSRI
6738 -- : BFD_RELOC_CKCORE_CALLGRAPH
6739 -- : BFD_RELOC_CKCORE_IRELATIVE
6740 -- : BFD_RELOC_CKCORE_PCREL_BLOOP_IMM4BY4
6741 -- : BFD_RELOC_CKCORE_PCREL_BLOOP_IMM12BY4
6742     C-SKY relocations.
6743 -- : BFD_RELOC_S12Z_OPR
6744     S12Z relocations.
6745 -- : BFD_RELOC_LARCH_TLS_DTPMOD32
6746 -- : BFD_RELOC_LARCH_TLS_DTPREL32
6747 -- : BFD_RELOC_LARCH_TLS_DTPMOD64
6748 -- : BFD_RELOC_LARCH_TLS_DTPREL64
6749 -- : BFD_RELOC_LARCH_TLS_TPREL32
6750 -- : BFD_RELOC_LARCH_TLS_TPREL64
6751 -- : BFD_RELOC_LARCH_TLS_DESC32
6752 -- : BFD_RELOC_LARCH_TLS_DESC64
6753 -- : BFD_RELOC_LARCH_MARK_LA
6754 -- : BFD_RELOC_LARCH_MARK_PCREL
6755 -- : BFD_RELOC_LARCH_SOP_PUSH_PCREL
6756 -- : BFD_RELOC_LARCH_SOP_PUSH_ABSOLUTE
6757 -- : BFD_RELOC_LARCH_SOP_PUSH_DUP
6758 -- : BFD_RELOC_LARCH_SOP_PUSH_GPREL
6759 -- : BFD_RELOC_LARCH_SOP_PUSH_TLS_TPREL
6760 -- : BFD_RELOC_LARCH_SOP_PUSH_TLS_GOT
6761 -- : BFD_RELOC_LARCH_SOP_PUSH_TLS_GD
6762 -- : BFD_RELOC_LARCH_SOP_PUSH_PLT_PCREL
6763 -- : BFD_RELOC_LARCH_SOP_ASSERT
6764 -- : BFD_RELOC_LARCH_SOP_NOT
6765 -- : BFD_RELOC_LARCH_SOP_SUB
6766 -- : BFD_RELOC_LARCH_SOP_SL
6767 -- : BFD_RELOC_LARCH_SOP_SR
6768 -- : BFD_RELOC_LARCH_SOP_ADD
6769 -- : BFD_RELOC_LARCH_SOP_AND
6770 -- : BFD_RELOC_LARCH_SOP_IF_ELSE
6771 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_5
6772 -- : BFD_RELOC_LARCH_SOP_POP_32_U_10_12
6773 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_12
6774 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_16
6775 -- : BFD_RELOC_LARCH_SOP_POP_32_S_10_16_S2
6776 -- : BFD_RELOC_LARCH_SOP_POP_32_S_5_20
6777 -- : BFD_RELOC_LARCH_SOP_POP_32_S_0_5_10_16_S2
6778 -- : BFD_RELOC_LARCH_SOP_POP_32_S_0_10_10_16_S2
6779 -- : BFD_RELOC_LARCH_SOP_POP_32_U
6780 -- : BFD_RELOC_LARCH_ADD8
6781 -- : BFD_RELOC_LARCH_ADD16
6782 -- : BFD_RELOC_LARCH_ADD24
6783 -- : BFD_RELOC_LARCH_ADD32
6784 -- : BFD_RELOC_LARCH_ADD64
6785 -- : BFD_RELOC_LARCH_SUB8
6786 -- : BFD_RELOC_LARCH_SUB16
6787 -- : BFD_RELOC_LARCH_SUB24
6788 -- : BFD_RELOC_LARCH_SUB32
6789 -- : BFD_RELOC_LARCH_SUB64
6790 -- : BFD_RELOC_LARCH_B16
6791 -- : BFD_RELOC_LARCH_B21
6792 -- : BFD_RELOC_LARCH_B26
6793 -- : BFD_RELOC_LARCH_ABS_HI20
6794 -- : BFD_RELOC_LARCH_ABS_LO12
6795 -- : BFD_RELOC_LARCH_ABS64_LO20
6796 -- : BFD_RELOC_LARCH_ABS64_HI12
6797 -- : BFD_RELOC_LARCH_PCALA_HI20
6798 -- : BFD_RELOC_LARCH_PCALA_LO12
6799 -- : BFD_RELOC_LARCH_PCALA64_LO20
6800 -- : BFD_RELOC_LARCH_PCALA64_HI12
6801 -- : BFD_RELOC_LARCH_GOT_PC_HI20
6802 -- : BFD_RELOC_LARCH_GOT_PC_LO12
6803 -- : BFD_RELOC_LARCH_GOT64_PC_LO20
6804 -- : BFD_RELOC_LARCH_GOT64_PC_HI12
6805 -- : BFD_RELOC_LARCH_GOT_HI20
6806 -- : BFD_RELOC_LARCH_GOT_LO12
6807 -- : BFD_RELOC_LARCH_GOT64_LO20
6808 -- : BFD_RELOC_LARCH_GOT64_HI12
6809 -- : BFD_RELOC_LARCH_TLS_LE_HI20
6810 -- : BFD_RELOC_LARCH_TLS_LE_LO12
6811 -- : BFD_RELOC_LARCH_TLS_LE64_LO20
6812 -- : BFD_RELOC_LARCH_TLS_LE64_HI12
6813 -- : BFD_RELOC_LARCH_TLS_IE_PC_HI20
6814 -- : BFD_RELOC_LARCH_TLS_IE_PC_LO12
6815 -- : BFD_RELOC_LARCH_TLS_IE64_PC_LO20
6816 -- : BFD_RELOC_LARCH_TLS_IE64_PC_HI12
6817 -- : BFD_RELOC_LARCH_TLS_IE_HI20
6818 -- : BFD_RELOC_LARCH_TLS_IE_LO12
6819 -- : BFD_RELOC_LARCH_TLS_IE64_LO20
6820 -- : BFD_RELOC_LARCH_TLS_IE64_HI12
6821 -- : BFD_RELOC_LARCH_TLS_LD_PC_HI20
6822 -- : BFD_RELOC_LARCH_TLS_LD_HI20
6823 -- : BFD_RELOC_LARCH_TLS_GD_PC_HI20
6824 -- : BFD_RELOC_LARCH_TLS_GD_HI20
6825 -- : BFD_RELOC_LARCH_32_PCREL
6826 -- : BFD_RELOC_LARCH_RELAX
6827 -- : BFD_RELOC_LARCH_DELETE
6828 -- : BFD_RELOC_LARCH_ALIGN
6829 -- : BFD_RELOC_LARCH_PCREL20_S2
6830 -- : BFD_RELOC_LARCH_CFA
6831 -- : BFD_RELOC_LARCH_ADD6
6832 -- : BFD_RELOC_LARCH_SUB6
6833 -- : BFD_RELOC_LARCH_ADD_ULEB128
6834 -- : BFD_RELOC_LARCH_SUB_ULEB128
6835 -- : BFD_RELOC_LARCH_64_PCREL
6836 -- : BFD_RELOC_LARCH_CALL36
6837 -- : BFD_RELOC_LARCH_TLS_DESC_PC_HI20
6838 -- : BFD_RELOC_LARCH_TLS_DESC_PC_LO12
6839 -- : BFD_RELOC_LARCH_TLS_DESC64_PC_LO20
6840 -- : BFD_RELOC_LARCH_TLS_DESC64_PC_HI12
6841 -- : BFD_RELOC_LARCH_TLS_DESC_HI20
6842 -- : BFD_RELOC_LARCH_TLS_DESC_LO12
6843 -- : BFD_RELOC_LARCH_TLS_DESC64_LO20
6844 -- : BFD_RELOC_LARCH_TLS_DESC64_HI12
6845 -- : BFD_RELOC_LARCH_TLS_DESC_LD
6846 -- : BFD_RELOC_LARCH_TLS_DESC_CALL
6847 -- : BFD_RELOC_LARCH_TLS_LE_HI20_R
6848 -- : BFD_RELOC_LARCH_TLS_LE_ADD_R
6849 -- : BFD_RELOC_LARCH_TLS_LE_LO12_R
6850 -- : BFD_RELOC_LARCH_TLS_LD_PCREL20_S2
6851 -- : BFD_RELOC_LARCH_TLS_GD_PCREL20_S2
6852 -- : BFD_RELOC_LARCH_TLS_DESC_PCREL20_S2
6853     LARCH relocations.
6854
6855     typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
6856
6857
68582.10.2.2 ���bfd_reloc_type_lookup���
6859................................
6860
6861 -- Function: reloc_howto_type *bfd_reloc_type_lookup (bfd *abfd,
6862          bfd_reloc_code_real_type code); reloc_howto_type
6863          *bfd_reloc_name_lookup (bfd *abfd, const char *reloc_name);
6864     Return a pointer to a howto structure which, when invoked, will
6865     perform the relocation CODE on data from the architecture noted.
6866
68672.10.2.3 ���bfd_default_reloc_type_lookup���
6868........................................
6869
6870 -- Function: reloc_howto_type *bfd_default_reloc_type_lookup (bfd
6871          *abfd, bfd_reloc_code_real_type code);
6872     Provides a default relocation lookup routine for any architecture.
6873
68742.10.2.4 ���bfd_get_reloc_code_name���
6875..................................
6876
6877 -- Function: const char *bfd_get_reloc_code_name
6878          (bfd_reloc_code_real_type code);
6879     Provides a printable name for the supplied relocation code.  Useful
6880     mainly for printing error messages.
6881
68822.10.2.5 ���bfd_generic_relax_section���
6883....................................
6884
6885 -- Function: bool bfd_generic_relax_section (bfd *abfd, asection
6886          *section, struct bfd_link_info *, bool *);
6887     Provides default handling for relaxing for back ends which don���t do
6888     relaxing.
6889
68902.10.2.6 ���bfd_generic_gc_sections���
6891..................................
6892
6893 -- Function: bool bfd_generic_gc_sections (bfd *, struct bfd_link_info
6894          *);
6895     Provides default handling for relaxing for back ends which don���t do
6896     section gc ��� i.e., does nothing.
6897
68982.10.2.7 ���bfd_generic_lookup_section_flags���
6899...........................................
6900
6901 -- Function: bool bfd_generic_lookup_section_flags (struct
6902          bfd_link_info *, struct flag_info *, asection *);
6903     Provides default handling for section flags lookup ��� i.e., does
6904     nothing.  Returns FALSE if the section should be omitted, otherwise
6905     TRUE.
6906
69072.10.2.8 ���bfd_generic_merge_sections���
6908.....................................
6909
6910 -- Function: bool bfd_generic_merge_sections (bfd *, struct
6911          bfd_link_info *);
6912     Provides default handling for SEC_MERGE section merging for back
6913     ends which don���t have SEC_MERGE support ��� i.e., does nothing.
6914
69152.10.2.9 ���bfd_generic_get_relocated_section_contents���
6916.....................................................
6917
6918 -- Function: bfd_byte *bfd_generic_get_relocated_section_contents (bfd
6919          *abfd, struct bfd_link_info *link_info, struct bfd_link_order
6920          *link_order, bfd_byte *data, bool relocatable, asymbol
6921          **symbols);
6922     Provides default handling of relocation effort for back ends which
6923     can���t be bothered to do it efficiently.
6924
69252.10.2.10 ���_bfd_generic_set_reloc���
6926..................................
6927
6928 -- Function: void _bfd_generic_set_reloc (bfd *abfd, sec_ptr section,
6929          arelent **relptr, unsigned int count);
6930     Installs a new set of internal relocations in SECTION.
6931
69322.10.2.11 ���_bfd_unrecognized_reloc���
6933...................................
6934
6935 -- Function: bool _bfd_unrecognized_reloc (bfd * abfd, sec_ptr section,
6936          unsigned int r_type);
6937     Reports an unrecognized reloc.  Written as a function in order to
6938     reduce code duplication.  Returns FALSE so that it can be called
6939     from a return statement.
6940
6941
6942File: bfd.info,  Node: Core Files,  Next: Targets,  Prev: Relocations,  Up: BFD front end
6943
69442.11 Core files
6945===============
6946
69472.11.1 Core file functions
6948--------------------------
6949
6950These are functions pertaining to core files.
6951
69522.11.1.1 ���bfd_core_file_failing_command���
6953........................................
6954
6955 -- Function: const char *bfd_core_file_failing_command (bfd *abfd);
6956     Return a read-only string explaining which program was running when
6957     it failed and produced the core file ABFD.
6958
69592.11.1.2 ���bfd_core_file_failing_signal���
6960.......................................
6961
6962 -- Function: int bfd_core_file_failing_signal (bfd *abfd);
6963     Returns the signal number which caused the core dump which
6964     generated the file the BFD ABFD is attached to.
6965
69662.11.1.3 ���bfd_core_file_pid���
6967............................
6968
6969 -- Function: int bfd_core_file_pid (bfd *abfd);
6970     Returns the PID of the process the core dump the BFD ABFD is
6971     attached to was generated from.
6972
69732.11.1.4 ���core_file_matches_executable_p���
6974.........................................
6975
6976 -- Function: bool core_file_matches_executable_p (bfd *core_bfd, bfd
6977          *exec_bfd);
6978     Return ���TRUE��� if the core file attached to CORE_BFD was generated
6979     by a run of the executable file attached to EXEC_BFD, ���FALSE���
6980     otherwise.
6981
69822.11.1.5 ���generic_core_file_matches_executable_p���
6983.................................................
6984
6985 -- Function: bool generic_core_file_matches_executable_p (bfd
6986          *core_bfd, bfd *exec_bfd);
6987     Return TRUE if the core file attached to CORE_BFD was generated by
6988     a run of the executable file attached to EXEC_BFD.  The match is
6989     based on executable basenames only.
6990
6991     Note: When not able to determine the core file failing command or
6992     the executable name, we still return TRUE even though we���re not
6993     sure that core file and executable match.  This is to avoid
6994     generating a false warning in situations where we really don���t know
6995     whether they match or not.
6996
6997
6998File: bfd.info,  Node: Targets,  Next: Architectures,  Prev: Core Files,  Up: BFD front end
6999
70002.12 Targets
7001============
7002
7003Each port of BFD to a different machine requires the creation of a
7004target back end.  All the back end provides to the root part of BFD is a
7005structure containing pointers to functions which perform certain low
7006level operations on files.  BFD translates the applications���s requests
7007through a pointer into calls to the back end routines.
7008
7009   When a file is opened with ���bfd_openr���, its format and target are
7010unknown.  BFD uses various mechanisms to determine how to interpret the
7011file.  The operations performed are:
7012
7013   ��� Create a BFD by calling the internal routine ���_bfd_new_bfd���, then
7014     call ���bfd_find_target��� with the target string supplied to
7015     ���bfd_openr��� and the new BFD pointer.
7016
7017   ��� If a null target string was provided to ���bfd_find_target���, look up
7018     the environment variable ���GNUTARGET��� and use that as the target
7019     string.
7020
7021   ��� If the target string is still ���NULL���, or the target string is
7022     ���default���, then use the first item in the target vector as the
7023     target type, and set ���target_defaulted��� in the BFD to cause
7024     ���bfd_check_format��� to loop through all the targets.  *Note
7025     bfd_target::.  *Note Formats::.
7026
7027   ��� Otherwise, inspect the elements in the target vector one by one,
7028     until a match on target name is found.  When found, use it.
7029
7030   ��� Otherwise return the error ���bfd_error_invalid_target��� to
7031     ���bfd_openr���.
7032
7033   ��� ���bfd_openr��� attempts to open the file using ���bfd_open_file���, and
7034     returns the BFD.
7035   Once the BFD has been opened and the target selected, the file format
7036may be determined.  This is done by calling ���bfd_check_format��� on the
7037BFD with a suggested format.  If ���target_defaulted��� has been set, each
7038possible target type is tried to see if it recognizes the specified
7039format.  ���bfd_check_format��� returns ���TRUE��� when the caller guesses
7040right.
7041* Menu:
7042
7043* bfd_target::
7044
7045
7046File: bfd.info,  Node: bfd_target,  Prev: Targets,  Up: Targets
7047
70482.12.1 bfd_target
7049-----------------
7050
7051This structure contains everything that BFD knows about a target.  It
7052includes things like its byte order, name, and which routines to call to
7053do various operations.
7054
7055   Every BFD points to a target structure with its ���xvec��� member.
7056
7057   The macros below are used to dispatch to functions through the
7058���bfd_target��� vector.  They are used in a number of macros further down
7059in ���bfd.h���, and are also used when calling various routines by hand
7060inside the BFD implementation.  The ARGLIST argument must be
7061parenthesized; it contains all the arguments to the called function.
7062
7063   They make the documentation (more) unpleasant to read, so if someone
7064wants to fix this and not break the above, please do.
7065     #define BFD_SEND(bfd, message, arglist) \
7066       ((*((bfd)->xvec->message)) arglist)
7067
7068     #ifdef DEBUG_BFD_SEND
7069     #undef BFD_SEND
7070     #define BFD_SEND(bfd, message, arglist) \
7071       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7072         ((*((bfd)->xvec->message)) arglist) : \
7073         (bfd_assert (__FILE__,__LINE__), NULL))
7074     #endif
7075   For operations which index on the BFD format:
7076     #define BFD_SEND_FMT(bfd, message, arglist) \
7077       (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
7078
7079     #ifdef DEBUG_BFD_SEND
7080     #undef BFD_SEND_FMT
7081     #define BFD_SEND_FMT(bfd, message, arglist) \
7082       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7083        (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
7084        (bfd_assert (__FILE__,__LINE__), NULL))
7085     #endif
7086
7087     /* Defined to TRUE if unused section symbol should be kept.  */
7088     #ifndef TARGET_KEEP_UNUSED_SECTION_SYMBOLS
7089     #define TARGET_KEEP_UNUSED_SECTION_SYMBOLS true
7090     #endif
7091
7092   This is the structure which defines the type of BFD this is.  The
7093���xvec��� member of the struct ���bfd��� itself points here.  Each module that
7094implements access to a different target under BFD, defines one of these.
7095
7096   FIXME, these names should be rationalised with the names of the entry
7097points which call them.  Too bad we can���t have one macro to define them
7098both!
7099
7100     typedef struct bfd_target
7101     {
7102       /* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  */
7103       const char *name;
7104
7105      /* The "flavour" of a back end is a general indication about
7106         the contents of a file.  */
7107       enum bfd_flavour flavour;
7108
7109       /* The order of bytes within the data area of a file.  */
7110       enum bfd_endian byteorder;
7111
7112      /* The order of bytes within the header parts of a file.  */
7113       enum bfd_endian header_byteorder;
7114
7115       /* A mask of all the flags which an executable may have set -
7116          from the set BFD_NO_FLAGS, HAS_RELOC, ...D_PAGED.  */
7117       flagword object_flags;
7118
7119      /* A mask of all the flags which a section may have set - from
7120         the set SEC_NO_FLAGS, SEC_ALLOC, ...SET_NEVER_LOAD.  */
7121       flagword section_flags;
7122
7123      /* The character normally found at the front of a symbol.
7124         (if any), perhaps `_'.  */
7125       char symbol_leading_char;
7126
7127      /* The pad character for file names within an archive header.  */
7128       char ar_pad_char;
7129
7130       /* The maximum number of characters in an archive header.  */
7131       unsigned char ar_max_namelen;
7132
7133       /* How well this target matches, used to select between various
7134          possible targets when more than one target matches.  */
7135       unsigned char match_priority;
7136
7137      /* TRUE if unused section symbols should be kept.  */
7138       bool keep_unused_section_symbols;
7139
7140       /* Entries for byte swapping for data. These are different from the
7141          other entry points, since they don't take a BFD as the first argument.
7142          Certain other handlers could do the same.  */
7143       uint64_t       (*bfd_getx64) (const void *);
7144       int64_t        (*bfd_getx_signed_64) (const void *);
7145       void           (*bfd_putx64) (uint64_t, void *);
7146       bfd_vma        (*bfd_getx32) (const void *);
7147       bfd_signed_vma (*bfd_getx_signed_32) (const void *);
7148       void           (*bfd_putx32) (bfd_vma, void *);
7149       bfd_vma        (*bfd_getx16) (const void *);
7150       bfd_signed_vma (*bfd_getx_signed_16) (const void *);
7151       void           (*bfd_putx16) (bfd_vma, void *);
7152
7153       /* Byte swapping for the headers.  */
7154       uint64_t       (*bfd_h_getx64) (const void *);
7155       int64_t        (*bfd_h_getx_signed_64) (const void *);
7156       void           (*bfd_h_putx64) (uint64_t, void *);
7157       bfd_vma        (*bfd_h_getx32) (const void *);
7158       bfd_signed_vma (*bfd_h_getx_signed_32) (const void *);
7159       void           (*bfd_h_putx32) (bfd_vma, void *);
7160       bfd_vma        (*bfd_h_getx16) (const void *);
7161       bfd_signed_vma (*bfd_h_getx_signed_16) (const void *);
7162       void           (*bfd_h_putx16) (bfd_vma, void *);
7163
7164       /* Format dependent routines: these are vectors of entry points
7165          within the target vector structure, one for each format to check.  */
7166
7167       /* Check the format of a file being read.  Return a bfd_cleanup on
7168          success or zero on failure.  */
7169       bfd_cleanup (*_bfd_check_format[bfd_type_end]) (bfd *);
7170
7171       /* Set the format of a file being written.  */
7172       bool (*_bfd_set_format[bfd_type_end]) (bfd *);
7173
7174       /* Write cached information into a file being written, at bfd_close.  */
7175       bool (*_bfd_write_contents[bfd_type_end]) (bfd *);
7176
7177   The general target vector.  These vectors are initialized using the
7178BFD_JUMP_TABLE macros.
7179       /* Generic entry points.  */
7180     #define BFD_JUMP_TABLE_GENERIC(NAME) \
7181       NAME##_close_and_cleanup, \
7182       NAME##_bfd_free_cached_info, \
7183       NAME##_new_section_hook, \
7184       NAME##_get_section_contents, \
7185       NAME##_get_section_contents_in_window
7186
7187       /* Called when the BFD is being closed to do any necessary cleanup.  */
7188       bool (*_close_and_cleanup) (bfd *);
7189       /* Ask the BFD to free all cached information.  */
7190       bool (*_bfd_free_cached_info) (bfd *);
7191       /* Called when a new section is created.  */
7192       bool (*_new_section_hook) (bfd *, sec_ptr);
7193       /* Read the contents of a section.  */
7194       bool (*_bfd_get_section_contents) (bfd *, sec_ptr, void *, file_ptr,
7195                                          bfd_size_type);
7196       bool (*_bfd_get_section_contents_in_window) (bfd *, sec_ptr, bfd_window *,
7197                                                    file_ptr, bfd_size_type);
7198
7199       /* Entry points to copy private data.  */
7200     #define BFD_JUMP_TABLE_COPY(NAME) \
7201       NAME##_bfd_copy_private_bfd_data, \
7202       NAME##_bfd_merge_private_bfd_data, \
7203       _bfd_generic_init_private_section_data, \
7204       NAME##_bfd_copy_private_section_data, \
7205       NAME##_bfd_copy_private_symbol_data, \
7206       NAME##_bfd_copy_private_header_data, \
7207       NAME##_bfd_set_private_flags, \
7208       NAME##_bfd_print_private_bfd_data
7209
7210       /* Called to copy BFD general private data from one object file
7211          to another.  */
7212       bool (*_bfd_copy_private_bfd_data) (bfd *, bfd *);
7213       /* Called to merge BFD general private data from one object file
7214          to a common output file when linking.  */
7215       bool (*_bfd_merge_private_bfd_data) (bfd *, struct bfd_link_info *);
7216       /* Called to initialize BFD private section data from one object file
7217          to another.  */
7218     #define bfd_init_private_section_data(ibfd, isec, obfd, osec, link_info) \
7219            BFD_SEND (obfd, _bfd_init_private_section_data, \
7220                      (ibfd, isec, obfd, osec, link_info))
7221       bool (*_bfd_init_private_section_data) (bfd *, sec_ptr, bfd *, sec_ptr,
7222                                               struct bfd_link_info *);
7223       /* Called to copy BFD private section data from one object file
7224          to another.  */
7225       bool (*_bfd_copy_private_section_data) (bfd *, sec_ptr, bfd *, sec_ptr);
7226       /* Called to copy BFD private symbol data from one symbol
7227          to another.  */
7228       bool (*_bfd_copy_private_symbol_data) (bfd *, asymbol *,
7229                                              bfd *, asymbol *);
7230       /* Called to copy BFD private header data from one object file
7231          to another.  */
7232       bool (*_bfd_copy_private_header_data) (bfd *, bfd *);
7233       /* Called to set private backend flags.  */
7234       bool (*_bfd_set_private_flags) (bfd *, flagword);
7235
7236       /* Called to print private BFD data.  */
7237       bool (*_bfd_print_private_bfd_data) (bfd *, void *);
7238
7239       /* Core file entry points.  */
7240     #define BFD_JUMP_TABLE_CORE(NAME) \
7241       NAME##_core_file_failing_command, \
7242       NAME##_core_file_failing_signal, \
7243       NAME##_core_file_matches_executable_p, \
7244       NAME##_core_file_pid
7245
7246       char *(*_core_file_failing_command) (bfd *);
7247       int   (*_core_file_failing_signal) (bfd *);
7248       bool  (*_core_file_matches_executable_p) (bfd *, bfd *);
7249       int   (*_core_file_pid) (bfd *);
7250
7251       /* Archive entry points.  */
7252     #define BFD_JUMP_TABLE_ARCHIVE(NAME) \
7253       NAME##_slurp_armap, \
7254       NAME##_slurp_extended_name_table, \
7255       NAME##_construct_extended_name_table, \
7256       NAME##_truncate_arname, \
7257       NAME##_write_armap, \
7258       NAME##_read_ar_hdr, \
7259       NAME##_write_ar_hdr, \
7260       NAME##_openr_next_archived_file, \
7261       NAME##_get_elt_at_index, \
7262       NAME##_generic_stat_arch_elt, \
7263       NAME##_update_armap_timestamp
7264
7265       bool (*_bfd_slurp_armap) (bfd *);
7266       bool (*_bfd_slurp_extended_name_table) (bfd *);
7267       bool (*_bfd_construct_extended_name_table) (bfd *, char **,
7268                                                   bfd_size_type *,
7269                                                   const char **);
7270       void (*_bfd_truncate_arname) (bfd *, const char *, char *);
7271       bool (*write_armap) (bfd *, unsigned, struct orl *, unsigned, int);
7272       void *(*_bfd_read_ar_hdr_fn) (bfd *);
7273       bool (*_bfd_write_ar_hdr_fn) (bfd *, bfd *);
7274       bfd *(*openr_next_archived_file) (bfd *, bfd *);
7275     #define bfd_get_elt_at_index(b,i) \
7276            BFD_SEND (b, _bfd_get_elt_at_index, (b,i))
7277       bfd *(*_bfd_get_elt_at_index) (bfd *, symindex);
7278       int  (*_bfd_stat_arch_elt) (bfd *, struct stat *);
7279       bool (*_bfd_update_armap_timestamp) (bfd *);
7280
7281       /* Entry points used for symbols.  */
7282     #define BFD_JUMP_TABLE_SYMBOLS(NAME) \
7283       NAME##_get_symtab_upper_bound, \
7284       NAME##_canonicalize_symtab, \
7285       NAME##_make_empty_symbol, \
7286       NAME##_print_symbol, \
7287       NAME##_get_symbol_info, \
7288       NAME##_get_symbol_version_string, \
7289       NAME##_bfd_is_local_label_name, \
7290       NAME##_bfd_is_target_special_symbol, \
7291       NAME##_get_lineno, \
7292       NAME##_find_nearest_line, \
7293       NAME##_find_nearest_line_with_alt, \
7294       NAME##_find_line, \
7295       NAME##_find_inliner_info, \
7296       NAME##_bfd_make_debug_symbol, \
7297       NAME##_read_minisymbols, \
7298       NAME##_minisymbol_to_symbol
7299
7300       long (*_bfd_get_symtab_upper_bound) (bfd *);
7301       long (*_bfd_canonicalize_symtab) (bfd *, struct bfd_symbol **);
7302       struct bfd_symbol *
7303            (*_bfd_make_empty_symbol) (bfd *);
7304       void (*_bfd_print_symbol) (bfd *, void *, struct bfd_symbol *,
7305                                  bfd_print_symbol_type);
7306     #define bfd_print_symbol(b,p,s,e) \
7307            BFD_SEND (b, _bfd_print_symbol, (b,p,s,e))
7308       void  (*_bfd_get_symbol_info) (bfd *, struct bfd_symbol *, symbol_info *);
7309     #define bfd_get_symbol_info(b,p,e) \
7310            BFD_SEND (b, _bfd_get_symbol_info, (b,p,e))
7311       const char *
7312            (*_bfd_get_symbol_version_string) (bfd *, struct bfd_symbol *,
7313                                               bool, bool *);
7314     #define bfd_get_symbol_version_string(b,s,p,h) \
7315            BFD_SEND (b, _bfd_get_symbol_version_string, (b,s,p,h))
7316       bool (*_bfd_is_local_label_name) (bfd *, const char *);
7317       bool (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
7318       alent *
7319            (*_get_lineno) (bfd *, struct bfd_symbol *);
7320       bool (*_bfd_find_nearest_line) (bfd *, struct bfd_symbol **,
7321                                       struct bfd_section *, bfd_vma,
7322                                       const char **, const char **,
7323                                       unsigned int *, unsigned int *);
7324       bool (*_bfd_find_nearest_line_with_alt) (bfd *, const char *,
7325                                                struct bfd_symbol **,
7326                                                struct bfd_section *, bfd_vma,
7327                                                const char **, const char **,
7328                                                unsigned int *, unsigned int *);
7329       bool (*_bfd_find_line) (bfd *, struct bfd_symbol **,
7330                               struct bfd_symbol *, const char **,
7331                               unsigned int *);
7332       bool (*_bfd_find_inliner_info)
7333         (bfd *, const char **, const char **, unsigned int *);
7334      /* Back-door to allow format-aware applications to create debug symbols
7335         while using BFD for everything else.  Currently used by the assembler
7336         when creating COFF files.  */
7337       asymbol *
7338            (*_bfd_make_debug_symbol) (bfd *);
7339     #define bfd_read_minisymbols(b, d, m, s) \
7340            BFD_SEND (b, _read_minisymbols, (b, d, m, s))
7341       long (*_read_minisymbols) (bfd *, bool, void **, unsigned int *);
7342     #define bfd_minisymbol_to_symbol(b, d, m, f) \
7343            BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
7344       asymbol *
7345            (*_minisymbol_to_symbol) (bfd *, bool, const void *, asymbol *);
7346
7347       /* Routines for relocs.  */
7348     #define BFD_JUMP_TABLE_RELOCS(NAME) \
7349       NAME##_get_reloc_upper_bound, \
7350       NAME##_canonicalize_reloc, \
7351       NAME##_set_reloc, \
7352       NAME##_bfd_reloc_type_lookup, \
7353       NAME##_bfd_reloc_name_lookup
7354
7355       long (*_get_reloc_upper_bound) (bfd *, sec_ptr);
7356       long (*_bfd_canonicalize_reloc) (bfd *, sec_ptr, arelent **,
7357                                        struct bfd_symbol **);
7358       void (*_bfd_set_reloc) (bfd *, sec_ptr, arelent **, unsigned int);
7359       /* See documentation on reloc types.  */
7360       reloc_howto_type *
7361            (*reloc_type_lookup) (bfd *, bfd_reloc_code_real_type);
7362       reloc_howto_type *
7363            (*reloc_name_lookup) (bfd *, const char *);
7364
7365       /* Routines used when writing an object file.  */
7366     #define BFD_JUMP_TABLE_WRITE(NAME) \
7367       NAME##_set_arch_mach, \
7368       NAME##_set_section_contents
7369
7370       bool (*_bfd_set_arch_mach) (bfd *, enum bfd_architecture,
7371                                          unsigned long);
7372       bool (*_bfd_set_section_contents) (bfd *, sec_ptr, const void *,
7373                                          file_ptr, bfd_size_type);
7374
7375       /* Routines used by the linker.  */
7376     #define BFD_JUMP_TABLE_LINK(NAME) \
7377       NAME##_sizeof_headers, \
7378       NAME##_bfd_get_relocated_section_contents, \
7379       NAME##_bfd_relax_section, \
7380       NAME##_bfd_link_hash_table_create, \
7381       NAME##_bfd_link_add_symbols, \
7382       NAME##_bfd_link_just_syms, \
7383       NAME##_bfd_copy_link_hash_symbol_type, \
7384       NAME##_bfd_final_link, \
7385       NAME##_bfd_link_split_section, \
7386       NAME##_bfd_link_check_relocs, \
7387       NAME##_bfd_gc_sections, \
7388       NAME##_bfd_lookup_section_flags, \
7389       NAME##_bfd_merge_sections, \
7390       NAME##_bfd_is_group_section, \
7391       NAME##_bfd_group_name, \
7392       NAME##_bfd_discard_group, \
7393       NAME##_section_already_linked, \
7394       NAME##_bfd_define_common_symbol, \
7395       NAME##_bfd_link_hide_symbol, \
7396       NAME##_bfd_define_start_stop
7397
7398       int  (*_bfd_sizeof_headers) (bfd *, struct bfd_link_info *);
7399       bfd_byte *
7400            (*_bfd_get_relocated_section_contents) (bfd *,
7401                                                    struct bfd_link_info *,
7402                                                    struct bfd_link_order *,
7403                                                    bfd_byte *, bool,
7404                                                    struct bfd_symbol **);
7405
7406       bool (*_bfd_relax_section) (bfd *, struct bfd_section *,
7407                                   struct bfd_link_info *, bool *);
7408
7409       /* Create a hash table for the linker.  Different backends store
7410          different information in this table.  */
7411       struct bfd_link_hash_table *
7412            (*_bfd_link_hash_table_create) (bfd *);
7413
7414       /* Add symbols from this object file into the hash table.  */
7415       bool (*_bfd_link_add_symbols) (bfd *, struct bfd_link_info *);
7416
7417       /* Indicate that we are only retrieving symbol values from this section.  */
7418       void (*_bfd_link_just_syms) (asection *, struct bfd_link_info *);
7419
7420       /* Copy the symbol type and other attributes for a linker script
7421          assignment of one symbol to another.  */
7422     #define bfd_copy_link_hash_symbol_type(b, t, f) \
7423            BFD_SEND (b, _bfd_copy_link_hash_symbol_type, (b, t, f))
7424       void (*_bfd_copy_link_hash_symbol_type) (bfd *,
7425                                                struct bfd_link_hash_entry *,
7426                                                struct bfd_link_hash_entry *);
7427
7428       /* Do a link based on the link_order structures attached to each
7429          section of the BFD.  */
7430       bool (*_bfd_final_link) (bfd *, struct bfd_link_info *);
7431
7432       /* Should this section be split up into smaller pieces during linking.  */
7433       bool (*_bfd_link_split_section) (bfd *, struct bfd_section *);
7434
7435       /* Check the relocations in the bfd for validity.  */
7436       bool (* _bfd_link_check_relocs)(bfd *, struct bfd_link_info *);
7437
7438       /* Remove sections that are not referenced from the output.  */
7439       bool (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
7440
7441       /* Sets the bitmask of allowed and disallowed section flags.  */
7442       bool (*_bfd_lookup_section_flags) (struct bfd_link_info *,
7443                                          struct flag_info *, asection *);
7444
7445       /* Attempt to merge SEC_MERGE sections.  */
7446       bool (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
7447
7448       /* Is this section a member of a group?  */
7449       bool (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
7450
7451       /* The group name, if section is a member of a group.  */
7452       const char *(*_bfd_group_name) (bfd *, const struct bfd_section *);
7453
7454       /* Discard members of a group.  */
7455       bool (*_bfd_discard_group) (bfd *, struct bfd_section *);
7456
7457       /* Check if SEC has been already linked during a reloceatable or
7458          final link.  */
7459       bool (*_section_already_linked) (bfd *, asection *,
7460                                        struct bfd_link_info *);
7461
7462       /* Define a common symbol.  */
7463       bool (*_bfd_define_common_symbol) (bfd *, struct bfd_link_info *,
7464                                          struct bfd_link_hash_entry *);
7465
7466       /* Hide a symbol.  */
7467       void (*_bfd_link_hide_symbol) (bfd *, struct bfd_link_info *,
7468                                      struct bfd_link_hash_entry *);
7469
7470       /* Define a __start, __stop, .startof. or .sizeof. symbol.  */
7471       struct bfd_link_hash_entry *
7472            (*_bfd_define_start_stop) (struct bfd_link_info *, const char *,
7473                                       asection *);
7474
7475       /* Routines to handle dynamic symbols and relocs.  */
7476     #define BFD_JUMP_TABLE_DYNAMIC(NAME) \
7477       NAME##_get_dynamic_symtab_upper_bound, \
7478       NAME##_canonicalize_dynamic_symtab, \
7479       NAME##_get_synthetic_symtab, \
7480       NAME##_get_dynamic_reloc_upper_bound, \
7481       NAME##_canonicalize_dynamic_reloc
7482
7483       /* Get the amount of memory required to hold the dynamic symbols.  */
7484       long (*_bfd_get_dynamic_symtab_upper_bound) (bfd *);
7485       /* Read in the dynamic symbols.  */
7486       long (*_bfd_canonicalize_dynamic_symtab) (bfd *, struct bfd_symbol **);
7487       /* Create synthetized symbols.  */
7488       long (*_bfd_get_synthetic_symtab) (bfd *, long, struct bfd_symbol **,
7489                                          long, struct bfd_symbol **,
7490                                          struct bfd_symbol **);
7491       /* Get the amount of memory required to hold the dynamic relocs.  */
7492       long (*_bfd_get_dynamic_reloc_upper_bound) (bfd *);
7493       /* Read in the dynamic relocs.  */
7494       long (*_bfd_canonicalize_dynamic_reloc) (bfd *, arelent **,
7495                                                struct bfd_symbol **);
7496
7497   A pointer to an alternative bfd_target in case the current one is not
7498satisfactory.  This can happen when the target cpu supports both big and
7499little endian code, and target chosen by the linker has the wrong
7500endianness.  The function open_output() in ld/ldlang.c uses this field
7501to find an alternative output format that is suitable.
7502       /* Opposite endian version of this target.  */
7503       const struct bfd_target *alternative_target;
7504
7505       /* Data for use by back-end routines, which isn't
7506          generic enough to belong in this structure.  */
7507       const void *backend_data;
7508
7509     } bfd_target;
7510
7511     static inline const char *
7512     bfd_get_target (const bfd *abfd)
7513     {
7514       return abfd->xvec->name;
7515     }
7516
7517     static inline enum bfd_flavour
7518     bfd_get_flavour (const bfd *abfd)
7519     {
7520       return abfd->xvec->flavour;
7521     }
7522
7523     static inline flagword
7524     bfd_applicable_file_flags (const bfd *abfd)
7525     {
7526       return abfd->xvec->object_flags;
7527     }
7528
7529     static inline bool
7530     bfd_family_coff (const bfd *abfd)
7531     {
7532       return (bfd_get_flavour (abfd) == bfd_target_coff_flavour
7533               || bfd_get_flavour (abfd) == bfd_target_xcoff_flavour);
7534     }
7535
7536     static inline bool
7537     bfd_big_endian (const bfd *abfd)
7538     {
7539       return abfd->xvec->byteorder == BFD_ENDIAN_BIG;
7540     }
7541     static inline bool
7542     bfd_little_endian (const bfd *abfd)
7543     {
7544       return abfd->xvec->byteorder == BFD_ENDIAN_LITTLE;
7545     }
7546
7547     static inline bool
7548     bfd_header_big_endian (const bfd *abfd)
7549     {
7550       return abfd->xvec->header_byteorder == BFD_ENDIAN_BIG;
7551     }
7552
7553     static inline bool
7554     bfd_header_little_endian (const bfd *abfd)
7555     {
7556       return abfd->xvec->header_byteorder == BFD_ENDIAN_LITTLE;
7557     }
7558
7559     static inline flagword
7560     bfd_applicable_section_flags (const bfd *abfd)
7561     {
7562       return abfd->xvec->section_flags;
7563     }
7564
7565     static inline char
7566     bfd_get_symbol_leading_char (const bfd *abfd)
7567     {
7568       return abfd->xvec->symbol_leading_char;
7569     }
7570
7571     static inline enum bfd_flavour
7572     bfd_asymbol_flavour (const asymbol *sy)
7573     {
7574       if ((sy->flags & BSF_SYNTHETIC) != 0)
7575         return bfd_target_unknown_flavour;
7576       return sy->the_bfd->xvec->flavour;
7577     }
7578
7579     static inline bool
7580     bfd_keep_unused_section_symbols (const bfd *abfd)
7581     {
7582       return abfd->xvec->keep_unused_section_symbols;
7583     }
7584
7585
75862.12.1.1 ���_bfd_per_xvec_warn���
7587.............................
7588
7589 -- Function: struct per_xvec_message **_bfd_per_xvec_warn (const
7590          bfd_target *, size_t);
7591     Return a location for the given target xvec to use for warnings
7592     specific to that target.  If TARG is NULL, returns the array of
7593     per_xvec_message pointers, otherwise if ALLOC is zero, returns a
7594     pointer to a pointer to the list of messages for TARG, otherwise
7595     (both TARG and ALLOC non-zero), allocates a new per_xvec_message
7596     with space for a string of ALLOC bytes and returns a pointer to a
7597     pointer to it.  May return a pointer to a NULL pointer on
7598     allocation failure.
7599
76002.12.1.2 ���bfd_set_default_target���
7601.................................
7602
7603 -- Function: bool bfd_set_default_target (const char *name);
7604     Set the default target vector to use when recognizing a BFD. This
7605     takes the name of the target, which may be a BFD target name or a
7606     configuration triplet.
7607
76082.12.1.3 ���bfd_find_target���
7609..........................
7610
7611 -- Function: const bfd_target *bfd_find_target (const char
7612          *target_name, bfd *abfd);
7613     Return a pointer to the transfer vector for the object target named
7614     TARGET_NAME.  If TARGET_NAME is ���NULL���, choose the one in the
7615     environment variable ���GNUTARGET���; if that is null or not defined,
7616     then choose the first entry in the target list.  Passing in the
7617     string "default" or setting the environment variable to "default"
7618     will cause the first entry in the target list to be returned, and
7619     "target_defaulted" will be set in the BFD if ABFD isn���t ���NULL���.
7620     This causes ���bfd_check_format��� to loop over all the targets to find
7621     the one that matches the file being read.
7622
76232.12.1.4 ���bfd_get_target_info���
7624..............................
7625
7626 -- Function: const bfd_target *bfd_get_target_info (const char
7627          *target_name, bfd *abfd, bool *is_bigendian, int
7628          *underscoring, const char **def_target_arch);
7629     Return a pointer to the transfer vector for the object target named
7630     TARGET_NAME.  If TARGET_NAME is ���NULL���, choose the one in the
7631     environment variable ���GNUTARGET���; if that is null or not defined,
7632     then choose the first entry in the target list.  Passing in the
7633     string "default" or setting the environment variable to "default"
7634     will cause the first entry in the target list to be returned, and
7635     "target_defaulted" will be set in the BFD if ABFD isn���t ���NULL���.
7636     This causes ���bfd_check_format��� to loop over all the targets to find
7637     the one that matches the file being read.  If IS_BIGENDIAN is not
7638     ���NULL���, then set this value to target���s endian mode.  True for
7639     big-endian, FALSE for little-endian or for invalid target.  If
7640     UNDERSCORING is not ���NULL���, then set this value to target���s
7641     underscoring mode.  Zero for none-underscoring, -1 for invalid
7642     target, else the value of target vector���s symbol underscoring.  If
7643     DEF_TARGET_ARCH is not ���NULL���, then set it to the architecture
7644     string specified by the target_name.
7645
76462.12.1.5 ���bfd_target_list���
7647..........................
7648
7649 -- Function: const char ** bfd_target_list (void);
7650     Return a freshly malloced NULL-terminated vector of the names of
7651     all the valid BFD targets.  Do not modify the names.
7652
76532.12.1.6 ���bfd_iterate_over_targets���
7654...................................
7655
7656 -- Function: const bfd_target *bfd_iterate_over_targets (int (*func)
7657          (const bfd_target *, void *), void *data);
7658     Call FUNC for each target in the list of BFD target vectors,
7659     passing DATA to FUNC.  Stop iterating if FUNC returns a non-zero
7660     result, and return that target vector.  Return NULL if FUNC always
7661     returns zero.
7662
76632.12.1.7 ���bfd_flavour_name���
7664...........................
7665
7666 -- Function: const char *bfd_flavour_name (enum bfd_flavour flavour);
7667     Return the string form of FLAVOUR.
7668
7669
7670File: bfd.info,  Node: Architectures,  Next: Opening and Closing,  Prev: Targets,  Up: BFD front end
7671
76722.13 Architectures
7673==================
7674
7675BFD keeps one atom in a BFD describing the architecture of the data
7676attached to the BFD: a pointer to a ���bfd_arch_info_type���.
7677
7678   Pointers to structures can be requested independently of a BFD so
7679that an architecture���s information can be interrogated without access to
7680an open BFD.
7681
7682   The architecture information is provided by each architecture
7683package.  The set of default architectures is selected by the macro
7684���SELECT_ARCHITECTURES���.  This is normally set up in the
7685���config/TARGET.mt��� file of your choice.  If the name is not defined,
7686then all the architectures supported are included.
7687
7688   When BFD starts up, all the architectures are called with an
7689initialize method.  It is up to the architecture back end to insert as
7690many items into the list of architectures as it wants to; generally this
7691would be one for each machine and one for the default case (an item with
7692a machine field of 0).
7693
7694   BFD���s idea of an architecture is implemented in ���archures.c���.
7695
76962.13.1 bfd_architecture
7697-----------------------
7698
7699This enum gives the object file���s CPU architecture, in a global
7700sense���i.e., what processor family does it belong to?  Another field
7701indicates which processor within the family is in use.  The machine
7702gives a number which distinguishes different versions of the
7703architecture, containing, for example, 68020 for Motorola 68020.
7704     enum bfd_architecture
7705     {
7706       bfd_arch_unknown,   /* File arch not known.  */
7707       bfd_arch_obscure,   /* Arch known, not one of these.  */
7708       bfd_arch_m68k,      /* Motorola 68xxx.  */
7709     #define bfd_mach_m68000                1
7710     #define bfd_mach_m68008                2
7711     #define bfd_mach_m68010                3
7712     #define bfd_mach_m68020                4
7713     #define bfd_mach_m68030                5
7714     #define bfd_mach_m68040                6
7715     #define bfd_mach_m68060                7
7716     #define bfd_mach_cpu32                 8
7717     #define bfd_mach_fido                  9
7718     #define bfd_mach_mcf_isa_a_nodiv       10
7719     #define bfd_mach_mcf_isa_a             11
7720     #define bfd_mach_mcf_isa_a_mac         12
7721     #define bfd_mach_mcf_isa_a_emac        13
7722     #define bfd_mach_mcf_isa_aplus         14
7723     #define bfd_mach_mcf_isa_aplus_mac     15
7724     #define bfd_mach_mcf_isa_aplus_emac    16
7725     #define bfd_mach_mcf_isa_b_nousp       17
7726     #define bfd_mach_mcf_isa_b_nousp_mac   18
7727     #define bfd_mach_mcf_isa_b_nousp_emac  19
7728     #define bfd_mach_mcf_isa_b             20
7729     #define bfd_mach_mcf_isa_b_mac         21
7730     #define bfd_mach_mcf_isa_b_emac        22
7731     #define bfd_mach_mcf_isa_b_float       23
7732     #define bfd_mach_mcf_isa_b_float_mac   24
7733     #define bfd_mach_mcf_isa_b_float_emac  25
7734     #define bfd_mach_mcf_isa_c             26
7735     #define bfd_mach_mcf_isa_c_mac         27
7736     #define bfd_mach_mcf_isa_c_emac        28
7737     #define bfd_mach_mcf_isa_c_nodiv       29
7738     #define bfd_mach_mcf_isa_c_nodiv_mac   30
7739     #define bfd_mach_mcf_isa_c_nodiv_emac  31
7740       bfd_arch_vax,       /* DEC Vax.  */
7741
7742       bfd_arch_or1k,      /* OpenRISC 1000.  */
7743     #define bfd_mach_or1k          1
7744     #define bfd_mach_or1knd        2
7745
7746       bfd_arch_sparc,     /* SPARC.  */
7747     #define bfd_mach_sparc                 1
7748     /* The difference between v8plus and v9 is that v9 is a true 64 bit env.  */
7749     #define bfd_mach_sparc_sparclet        2
7750     #define bfd_mach_sparc_sparclite       3
7751     #define bfd_mach_sparc_v8plus          4
7752     #define bfd_mach_sparc_v8plusa         5 /* with ultrasparc add'ns.  */
7753     #define bfd_mach_sparc_sparclite_le    6
7754     #define bfd_mach_sparc_v9              7
7755     #define bfd_mach_sparc_v9a             8 /* with ultrasparc add'ns.  */
7756     #define bfd_mach_sparc_v8plusb         9 /* with cheetah add'ns.  */
7757     #define bfd_mach_sparc_v9b             10 /* with cheetah add'ns.  */
7758     #define bfd_mach_sparc_v8plusc         11 /* with UA2005 and T1 add'ns.  */
7759     #define bfd_mach_sparc_v9c             12 /* with UA2005 and T1 add'ns.  */
7760     #define bfd_mach_sparc_v8plusd         13 /* with UA2007 and T3 add'ns.  */
7761     #define bfd_mach_sparc_v9d             14 /* with UA2007 and T3 add'ns.  */
7762     #define bfd_mach_sparc_v8pluse         15 /* with OSA2001 and T4 add'ns (no IMA).  */
7763     #define bfd_mach_sparc_v9e             16 /* with OSA2001 and T4 add'ns (no IMA).  */
7764     #define bfd_mach_sparc_v8plusv         17 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
7765     #define bfd_mach_sparc_v9v             18 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
7766     #define bfd_mach_sparc_v8plusm         19 /* with OSA2015 and M7 add'ns.  */
7767     #define bfd_mach_sparc_v9m             20 /* with OSA2015 and M7 add'ns.  */
7768     #define bfd_mach_sparc_v8plusm8        21 /* with OSA2017 and M8 add'ns.  */
7769     #define bfd_mach_sparc_v9m8            22 /* with OSA2017 and M8 add'ns.  */
7770     /* Nonzero if MACH has the v9 instruction set.  */
7771     #define bfd_mach_sparc_v9_p(mach) \
7772       ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9m8 \
7773        && (mach) != bfd_mach_sparc_sparclite_le)
7774     /* Nonzero if MACH is a 64 bit sparc architecture.  */
7775     #define bfd_mach_sparc_64bit_p(mach) \
7776       ((mach) >= bfd_mach_sparc_v9 \
7777        && (mach) != bfd_mach_sparc_v8plusb \
7778        && (mach) != bfd_mach_sparc_v8plusc \
7779        && (mach) != bfd_mach_sparc_v8plusd \
7780        && (mach) != bfd_mach_sparc_v8pluse \
7781        && (mach) != bfd_mach_sparc_v8plusv \
7782        && (mach) != bfd_mach_sparc_v8plusm \
7783        && (mach) != bfd_mach_sparc_v8plusm8)
7784       bfd_arch_spu,       /* PowerPC SPU.  */
7785     #define bfd_mach_spu           256
7786       bfd_arch_mips,      /* MIPS Rxxxx.  */
7787     #define bfd_mach_mips3000              3000
7788     #define bfd_mach_mips3900              3900
7789     #define bfd_mach_mips4000              4000
7790     #define bfd_mach_mips4010              4010
7791     #define bfd_mach_mips4100              4100
7792     #define bfd_mach_mips4111              4111
7793     #define bfd_mach_mips4120              4120
7794     #define bfd_mach_mips4300              4300
7795     #define bfd_mach_mips4400              4400
7796     #define bfd_mach_mips4600              4600
7797     #define bfd_mach_mips4650              4650
7798     #define bfd_mach_mips5000              5000
7799     #define bfd_mach_mips5400              5400
7800     #define bfd_mach_mips5500              5500
7801     #define bfd_mach_mips5900              5900
7802     #define bfd_mach_mips6000              6000
7803     #define bfd_mach_mips7000              7000
7804     #define bfd_mach_mips8000              8000
7805     #define bfd_mach_mips9000              9000
7806     #define bfd_mach_mips10000             10000
7807     #define bfd_mach_mips12000             12000
7808     #define bfd_mach_mips14000             14000
7809     #define bfd_mach_mips16000             16000
7810     #define bfd_mach_mips16                16
7811     #define bfd_mach_mips5                 5
7812     #define bfd_mach_mips_allegrex         10111431 /* octal 'AL', 31.  */
7813     #define bfd_mach_mips_loongson_2e      3001
7814     #define bfd_mach_mips_loongson_2f      3002
7815     #define bfd_mach_mips_gs464            3003
7816     #define bfd_mach_mips_gs464e           3004
7817     #define bfd_mach_mips_gs264e           3005
7818     #define bfd_mach_mips_sb1              12310201 /* octal 'SB', 01.  */
7819     #define bfd_mach_mips_octeon           6501
7820     #define bfd_mach_mips_octeonp          6601
7821     #define bfd_mach_mips_octeon2          6502
7822     #define bfd_mach_mips_octeon3          6503
7823     #define bfd_mach_mips_xlr              887682   /* decimal 'XLR'.  */
7824     #define bfd_mach_mips_interaptiv_mr2   736550   /* decimal 'IA2'.  */
7825     #define bfd_mach_mipsisa32             32
7826     #define bfd_mach_mipsisa32r2           33
7827     #define bfd_mach_mipsisa32r3           34
7828     #define bfd_mach_mipsisa32r5           36
7829     #define bfd_mach_mipsisa32r6           37
7830     #define bfd_mach_mipsisa64             64
7831     #define bfd_mach_mipsisa64r2           65
7832     #define bfd_mach_mipsisa64r3           66
7833     #define bfd_mach_mipsisa64r5           68
7834     #define bfd_mach_mipsisa64r6           69
7835     #define bfd_mach_mips_micromips        96
7836       bfd_arch_i386,      /* Intel 386.  */
7837     #define bfd_mach_i386_intel_syntax     (1 << 0)
7838     #define bfd_mach_i386_i8086            (1 << 1)
7839     #define bfd_mach_i386_i386             (1 << 2)
7840     #define bfd_mach_x86_64                (1 << 3)
7841     #define bfd_mach_x64_32                (1 << 4)
7842     #define bfd_mach_i386_i386_intel_syntax (bfd_mach_i386_i386 | bfd_mach_i386_intel_syntax)
7843     #define bfd_mach_x86_64_intel_syntax   (bfd_mach_x86_64 | bfd_mach_i386_intel_syntax)
7844     #define bfd_mach_x64_32_intel_syntax   (bfd_mach_x64_32 | bfd_mach_i386_intel_syntax)
7845       bfd_arch_iamcu,     /* Intel MCU.  */
7846     #define bfd_mach_iamcu                 (1 << 8)
7847     #define bfd_mach_i386_iamcu            (bfd_mach_i386_i386 | bfd_mach_iamcu)
7848     #define bfd_mach_i386_iamcu_intel_syntax (bfd_mach_i386_iamcu | bfd_mach_i386_intel_syntax)
7849       bfd_arch_romp,      /* IBM ROMP PC/RT.  */
7850       bfd_arch_convex,    /* Convex.  */
7851       bfd_arch_m98k,      /* Motorola 98xxx.  */
7852       bfd_arch_pyramid,   /* Pyramid Technology.  */
7853       bfd_arch_h8300,     /* Renesas H8/300 (formerly Hitachi H8/300).  */
7854     #define bfd_mach_h8300         1
7855     #define bfd_mach_h8300h        2
7856     #define bfd_mach_h8300s        3
7857     #define bfd_mach_h8300hn       4
7858     #define bfd_mach_h8300sn       5
7859     #define bfd_mach_h8300sx       6
7860     #define bfd_mach_h8300sxn      7
7861       bfd_arch_pdp11,     /* DEC PDP-11.  */
7862       bfd_arch_powerpc,   /* PowerPC.  */
7863     #define bfd_mach_ppc           32
7864     #define bfd_mach_ppc64         64
7865     #define bfd_mach_ppc_403       403
7866     #define bfd_mach_ppc_403gc     4030
7867     #define bfd_mach_ppc_405       405
7868     #define bfd_mach_ppc_505       505
7869     #define bfd_mach_ppc_601       601
7870     #define bfd_mach_ppc_602       602
7871     #define bfd_mach_ppc_603       603
7872     #define bfd_mach_ppc_ec603e    6031
7873     #define bfd_mach_ppc_604       604
7874     #define bfd_mach_ppc_620       620
7875     #define bfd_mach_ppc_630       630
7876     #define bfd_mach_ppc_750       750
7877     #define bfd_mach_ppc_860       860
7878     #define bfd_mach_ppc_a35       35
7879     #define bfd_mach_ppc_rs64ii    642
7880     #define bfd_mach_ppc_rs64iii   643
7881     #define bfd_mach_ppc_7400      7400
7882     #define bfd_mach_ppc_e500      500
7883     #define bfd_mach_ppc_e500mc    5001
7884     #define bfd_mach_ppc_e500mc64  5005
7885     #define bfd_mach_ppc_e5500     5006
7886     #define bfd_mach_ppc_e6500     5007
7887     #define bfd_mach_ppc_titan     83
7888     #define bfd_mach_ppc_vle       84
7889       bfd_arch_rs6000,    /* IBM RS/6000.  */
7890     #define bfd_mach_rs6k          6000
7891     #define bfd_mach_rs6k_rs1      6001
7892     #define bfd_mach_rs6k_rsc      6003
7893     #define bfd_mach_rs6k_rs2      6002
7894       bfd_arch_hppa,      /* HP PA RISC.  */
7895     #define bfd_mach_hppa10        10
7896     #define bfd_mach_hppa11        11
7897     #define bfd_mach_hppa20        20
7898     #define bfd_mach_hppa20w       25
7899       bfd_arch_d10v,      /* Mitsubishi D10V.  */
7900     #define bfd_mach_d10v          1
7901     #define bfd_mach_d10v_ts2      2
7902     #define bfd_mach_d10v_ts3      3
7903       bfd_arch_d30v,      /* Mitsubishi D30V.  */
7904       bfd_arch_dlx,       /* DLX.  */
7905       bfd_arch_m68hc11,   /* Motorola 68HC11.  */
7906       bfd_arch_m68hc12,   /* Motorola 68HC12.  */
7907     #define bfd_mach_m6812_default 0
7908     #define bfd_mach_m6812         1
7909     #define bfd_mach_m6812s        2
7910       bfd_arch_m9s12x,    /* Freescale S12X.  */
7911       bfd_arch_m9s12xg,   /* Freescale XGATE.  */
7912       bfd_arch_s12z,    /* Freescale S12Z.  */
7913     #define bfd_mach_s12z_default 0
7914       bfd_arch_z8k,       /* Zilog Z8000.  */
7915     #define bfd_mach_z8001         1
7916     #define bfd_mach_z8002         2
7917       bfd_arch_sh,        /* Renesas / SuperH SH (formerly Hitachi SH).  */
7918     #define bfd_mach_sh                            1
7919     #define bfd_mach_sh2                           0x20
7920     #define bfd_mach_sh_dsp                        0x2d
7921     #define bfd_mach_sh2a                          0x2a
7922     #define bfd_mach_sh2a_nofpu                    0x2b
7923     #define bfd_mach_sh2a_nofpu_or_sh4_nommu_nofpu 0x2a1
7924     #define bfd_mach_sh2a_nofpu_or_sh3_nommu       0x2a2
7925     #define bfd_mach_sh2a_or_sh4                   0x2a3
7926     #define bfd_mach_sh2a_or_sh3e                  0x2a4
7927     #define bfd_mach_sh2e                          0x2e
7928     #define bfd_mach_sh3                           0x30
7929     #define bfd_mach_sh3_nommu                     0x31
7930     #define bfd_mach_sh3_dsp                       0x3d
7931     #define bfd_mach_sh3e                          0x3e
7932     #define bfd_mach_sh4                           0x40
7933     #define bfd_mach_sh4_nofpu                     0x41
7934     #define bfd_mach_sh4_nommu_nofpu               0x42
7935     #define bfd_mach_sh4a                          0x4a
7936     #define bfd_mach_sh4a_nofpu                    0x4b
7937     #define bfd_mach_sh4al_dsp                     0x4d
7938       bfd_arch_alpha,     /* Dec Alpha.  */
7939     #define bfd_mach_alpha_ev4     0x10
7940     #define bfd_mach_alpha_ev5     0x20
7941     #define bfd_mach_alpha_ev6     0x30
7942       bfd_arch_arm,       /* Advanced Risc Machines ARM.  */
7943     #define bfd_mach_arm_unknown   0
7944     #define bfd_mach_arm_2         1
7945     #define bfd_mach_arm_2a        2
7946     #define bfd_mach_arm_3         3
7947     #define bfd_mach_arm_3M        4
7948     #define bfd_mach_arm_4         5
7949     #define bfd_mach_arm_4T        6
7950     #define bfd_mach_arm_5         7
7951     #define bfd_mach_arm_5T        8
7952     #define bfd_mach_arm_5TE       9
7953     #define bfd_mach_arm_XScale    10
7954     #define bfd_mach_arm_ep9312    11
7955     #define bfd_mach_arm_iWMMXt    12
7956     #define bfd_mach_arm_iWMMXt2   13
7957     #define bfd_mach_arm_5TEJ      14
7958     #define bfd_mach_arm_6         15
7959     #define bfd_mach_arm_6KZ       16
7960     #define bfd_mach_arm_6T2       17
7961     #define bfd_mach_arm_6K        18
7962     #define bfd_mach_arm_7         19
7963     #define bfd_mach_arm_6M        20
7964     #define bfd_mach_arm_6SM       21
7965     #define bfd_mach_arm_7EM       22
7966     #define bfd_mach_arm_8         23
7967     #define bfd_mach_arm_8R        24
7968     #define bfd_mach_arm_8M_BASE   25
7969     #define bfd_mach_arm_8M_MAIN   26
7970     #define bfd_mach_arm_8_1M_MAIN 27
7971     #define bfd_mach_arm_9         28
7972       bfd_arch_nds32,     /* Andes NDS32.  */
7973     #define bfd_mach_n1            1
7974     #define bfd_mach_n1h           2
7975     #define bfd_mach_n1h_v2        3
7976     #define bfd_mach_n1h_v3        4
7977     #define bfd_mach_n1h_v3m       5
7978       bfd_arch_ns32k,     /* National Semiconductors ns32000.  */
7979       bfd_arch_tic30,     /* Texas Instruments TMS320C30.  */
7980       bfd_arch_tic4x,     /* Texas Instruments TMS320C3X/4X.  */
7981     #define bfd_mach_tic3x         30
7982     #define bfd_mach_tic4x         40
7983       bfd_arch_tic54x,    /* Texas Instruments TMS320C54X.  */
7984       bfd_arch_tic6x,     /* Texas Instruments TMS320C6X.  */
7985       bfd_arch_v850,      /* NEC V850.  */
7986       bfd_arch_v850_rh850,/* NEC V850 (using RH850 ABI).  */
7987     #define bfd_mach_v850          1
7988     #define bfd_mach_v850e         'E'
7989     #define bfd_mach_v850e1        '1'
7990     #define bfd_mach_v850e2        0x4532
7991     #define bfd_mach_v850e2v3      0x45325633
7992     #define bfd_mach_v850e3v5      0x45335635 /* ('E'|'3'|'V'|'5').  */
7993       bfd_arch_arc,       /* ARC Cores.  */
7994     #define bfd_mach_arc_a4        0
7995     #define bfd_mach_arc_a5        1
7996     #define bfd_mach_arc_arc600    2
7997     #define bfd_mach_arc_arc601    4
7998     #define bfd_mach_arc_arc700    3
7999     #define bfd_mach_arc_arcv2     5
8000      bfd_arch_m32c,       /* Renesas M16C/M32C.  */
8001     #define bfd_mach_m16c          0x75
8002     #define bfd_mach_m32c          0x78
8003       bfd_arch_m32r,      /* Renesas M32R (formerly Mitsubishi M32R/D).  */
8004     #define bfd_mach_m32r          1 /* For backwards compatibility.  */
8005     #define bfd_mach_m32rx         'x'
8006     #define bfd_mach_m32r2         '2'
8007       bfd_arch_mn10200,   /* Matsushita MN10200.  */
8008       bfd_arch_mn10300,   /* Matsushita MN10300.  */
8009     #define bfd_mach_mn10300       300
8010     #define bfd_mach_am33          330
8011     #define bfd_mach_am33_2        332
8012       bfd_arch_fr30,
8013     #define bfd_mach_fr30          0x46523330
8014       bfd_arch_frv,
8015     #define bfd_mach_frv           1
8016     #define bfd_mach_frvsimple     2
8017     #define bfd_mach_fr300         300
8018     #define bfd_mach_fr400         400
8019     #define bfd_mach_fr450         450
8020     #define bfd_mach_frvtomcat     499     /* fr500 prototype.  */
8021     #define bfd_mach_fr500         500
8022     #define bfd_mach_fr550         550
8023       bfd_arch_moxie,     /* The moxie processor.  */
8024     #define bfd_mach_moxie         1
8025       bfd_arch_ft32,      /* The ft32 processor.  */
8026     #define bfd_mach_ft32          1
8027     #define bfd_mach_ft32b         2
8028       bfd_arch_mcore,
8029       bfd_arch_mep,
8030     #define bfd_mach_mep           1
8031     #define bfd_mach_mep_h1        0x6831
8032     #define bfd_mach_mep_c5        0x6335
8033       bfd_arch_metag,
8034     #define bfd_mach_metag         1
8035       bfd_arch_ia64,      /* HP/Intel ia64.  */
8036     #define bfd_mach_ia64_elf64    64
8037     #define bfd_mach_ia64_elf32    32
8038       bfd_arch_ip2k,      /* Ubicom IP2K microcontrollers. */
8039     #define bfd_mach_ip2022        1
8040     #define bfd_mach_ip2022ext     2
8041      bfd_arch_iq2000,     /* Vitesse IQ2000.  */
8042     #define bfd_mach_iq2000        1
8043     #define bfd_mach_iq10          2
8044       bfd_arch_bpf,       /* Linux eBPF.  */
8045     #define bfd_mach_bpf           1
8046     #define bfd_mach_xbpf          2
8047       bfd_arch_epiphany,  /* Adapteva EPIPHANY.  */
8048     #define bfd_mach_epiphany16    1
8049     #define bfd_mach_epiphany32    2
8050       bfd_arch_mt,
8051     #define bfd_mach_ms1           1
8052     #define bfd_mach_mrisc2        2
8053     #define bfd_mach_ms2           3
8054       bfd_arch_pj,
8055       bfd_arch_avr,       /* Atmel AVR microcontrollers.  */
8056     #define bfd_mach_avr1          1
8057     #define bfd_mach_avr2          2
8058     #define bfd_mach_avr25         25
8059     #define bfd_mach_avr3          3
8060     #define bfd_mach_avr31         31
8061     #define bfd_mach_avr35         35
8062     #define bfd_mach_avr4          4
8063     #define bfd_mach_avr5          5
8064     #define bfd_mach_avr51         51
8065     #define bfd_mach_avr6          6
8066     #define bfd_mach_avrtiny       100
8067     #define bfd_mach_avrxmega1     101
8068     #define bfd_mach_avrxmega2     102
8069     #define bfd_mach_avrxmega3     103
8070     #define bfd_mach_avrxmega4     104
8071     #define bfd_mach_avrxmega5     105
8072     #define bfd_mach_avrxmega6     106
8073     #define bfd_mach_avrxmega7     107
8074       bfd_arch_bfin,      /* ADI Blackfin.  */
8075     #define bfd_mach_bfin          1
8076       bfd_arch_cr16,      /* National Semiconductor CompactRISC (ie CR16).  */
8077     #define bfd_mach_cr16          1
8078       bfd_arch_crx,       /*  National Semiconductor CRX.  */
8079     #define bfd_mach_crx           1
8080       bfd_arch_cris,      /* Axis CRIS.  */
8081     #define bfd_mach_cris_v0_v10   255
8082     #define bfd_mach_cris_v32      32
8083     #define bfd_mach_cris_v10_v32  1032
8084       bfd_arch_riscv,
8085     #define bfd_mach_riscv32       132
8086     #define bfd_mach_riscv64       164
8087       bfd_arch_rl78,
8088     #define bfd_mach_rl78          0x75
8089       bfd_arch_rx,        /* Renesas RX.  */
8090     #define bfd_mach_rx            0x75
8091     #define bfd_mach_rx_v2         0x76
8092     #define bfd_mach_rx_v3         0x77
8093       bfd_arch_s390,      /* IBM s390.  */
8094     #define bfd_mach_s390_31       31
8095     #define bfd_mach_s390_64       64
8096       bfd_arch_score,     /* Sunplus score.  */
8097     #define bfd_mach_score3        3
8098     #define bfd_mach_score7        7
8099       bfd_arch_mmix,      /* Donald Knuth's educational processor.  */
8100       bfd_arch_xstormy16,
8101     #define bfd_mach_xstormy16     1
8102       bfd_arch_msp430,    /* Texas Instruments MSP430 architecture.  */
8103     #define bfd_mach_msp11         11
8104     #define bfd_mach_msp110        110
8105     #define bfd_mach_msp12         12
8106     #define bfd_mach_msp13         13
8107     #define bfd_mach_msp14         14
8108     #define bfd_mach_msp15         15
8109     #define bfd_mach_msp16         16
8110     #define bfd_mach_msp20         20
8111     #define bfd_mach_msp21         21
8112     #define bfd_mach_msp22         22
8113     #define bfd_mach_msp23         23
8114     #define bfd_mach_msp24         24
8115     #define bfd_mach_msp26         26
8116     #define bfd_mach_msp31         31
8117     #define bfd_mach_msp32         32
8118     #define bfd_mach_msp33         33
8119     #define bfd_mach_msp41         41
8120     #define bfd_mach_msp42         42
8121     #define bfd_mach_msp43         43
8122     #define bfd_mach_msp44         44
8123     #define bfd_mach_msp430x       45
8124     #define bfd_mach_msp46         46
8125     #define bfd_mach_msp47         47
8126     #define bfd_mach_msp54         54
8127       bfd_arch_xgate,     /* Freescale XGATE.  */
8128     #define bfd_mach_xgate         1
8129       bfd_arch_xtensa,    /* Tensilica's Xtensa cores.  */
8130     #define bfd_mach_xtensa        1
8131       bfd_arch_z80,
8132     /* Zilog Z80 without undocumented opcodes.  */
8133     #define bfd_mach_z80strict     1
8134     /* Zilog Z180: successor with additional instructions, but without
8135      halves of ix and iy.  */
8136     #define bfd_mach_z180          2
8137     /* Zilog Z80 with ixl, ixh, iyl, and iyh.  */
8138     #define bfd_mach_z80           3
8139     /* Zilog eZ80 (successor of Z80 & Z180) in Z80 (16-bit address) mode.  */
8140     #define bfd_mach_ez80_z80      4
8141     /* Zilog eZ80 (successor of Z80 & Z180) in ADL (24-bit address) mode.  */
8142     #define bfd_mach_ez80_adl      5
8143     /* Z80N */
8144     #define bfd_mach_z80n          6
8145     /* Zilog Z80 with all undocumented instructions.  */
8146     #define bfd_mach_z80full       7
8147     /* GameBoy Z80 (reduced instruction set).  */
8148     #define bfd_mach_gbz80         8
8149     /* ASCII R800: successor with multiplication.  */
8150     #define bfd_mach_r800          11
8151       bfd_arch_lm32,      /* Lattice Mico32.  */
8152     #define bfd_mach_lm32          1
8153       bfd_arch_microblaze,/* Xilinx MicroBlaze.  */
8154       bfd_arch_kvx,        /* Kalray VLIW core of the MPPA processor family */
8155     #define bfd_mach_kv3_unknown       0
8156     #define bfd_mach_kv3_1             1
8157     #define bfd_mach_kv3_1_64          2
8158     #define bfd_mach_kv3_1_usr         3
8159     #define bfd_mach_kv3_2             4
8160     #define bfd_mach_kv3_2_64          5
8161     #define bfd_mach_kv3_2_usr         6
8162     #define bfd_mach_kv4_1             7
8163     #define bfd_mach_kv4_1_64          8
8164     #define bfd_mach_kv4_1_usr         9
8165       bfd_arch_tilepro,   /* Tilera TILEPro.  */
8166       bfd_arch_tilegx,    /* Tilera TILE-Gx.  */
8167     #define bfd_mach_tilepro       1
8168     #define bfd_mach_tilegx        1
8169     #define bfd_mach_tilegx32      2
8170       bfd_arch_aarch64,   /* AArch64.  */
8171     #define bfd_mach_aarch64 0
8172     #define bfd_mach_aarch64_8R    1
8173     #define bfd_mach_aarch64_ilp32 32
8174     #define bfd_mach_aarch64_llp64 64
8175       bfd_arch_nios2,     /* Nios II.  */
8176     #define bfd_mach_nios2         0
8177     #define bfd_mach_nios2r1       1
8178     #define bfd_mach_nios2r2       2
8179       bfd_arch_visium,    /* Visium.  */
8180     #define bfd_mach_visium        1
8181       bfd_arch_wasm32,    /* WebAssembly.  */
8182     #define bfd_mach_wasm32        1
8183       bfd_arch_pru,       /* PRU.  */
8184     #define bfd_mach_pru           0
8185       bfd_arch_nfp,       /* Netronome Flow Processor */
8186     #define bfd_mach_nfp3200       0x3200
8187     #define bfd_mach_nfp6000       0x6000
8188       bfd_arch_csky,      /* C-SKY.  */
8189     #define bfd_mach_ck_unknown    0
8190     #define bfd_mach_ck510         1
8191     #define bfd_mach_ck610         2
8192     #define bfd_mach_ck801         3
8193     #define bfd_mach_ck802         4
8194     #define bfd_mach_ck803         5
8195     #define bfd_mach_ck807         6
8196     #define bfd_mach_ck810         7
8197     #define bfd_mach_ck860         8
8198       bfd_arch_loongarch,       /* LoongArch */
8199     #define bfd_mach_loongarch32   1
8200     #define bfd_mach_loongarch64   2
8201       bfd_arch_amdgcn,     /* AMDGCN */
8202     #define bfd_mach_amdgcn_unknown 0x000
8203     #define bfd_mach_amdgcn_gfx900  0x02c
8204     #define bfd_mach_amdgcn_gfx904  0x02e
8205     #define bfd_mach_amdgcn_gfx906  0x02f
8206     #define bfd_mach_amdgcn_gfx908  0x030
8207     #define bfd_mach_amdgcn_gfx90a  0x03f
8208     #define bfd_mach_amdgcn_gfx1010 0x033
8209     #define bfd_mach_amdgcn_gfx1011 0x034
8210     #define bfd_mach_amdgcn_gfx1012 0x035
8211     #define bfd_mach_amdgcn_gfx1030 0x036
8212     #define bfd_mach_amdgcn_gfx1031 0x037
8213     #define bfd_mach_amdgcn_gfx1032 0x038
8214     #define bfd_mach_amdgcn_gfx1100 0x041
8215     #define bfd_mach_amdgcn_gfx1101 0x046
8216     #define bfd_mach_amdgcn_gfx1102 0x047
8217       bfd_arch_last
8218       };
8219
82202.13.2 bfd_arch_info
8221--------------------
8222
8223This structure contains information on architectures for use within BFD.
8224
8225     typedef struct bfd_arch_info
8226     {
8227       int bits_per_word;
8228       int bits_per_address;
8229       int bits_per_byte;
8230       enum bfd_architecture arch;
8231       unsigned long mach;
8232       const char *arch_name;
8233       const char *printable_name;
8234       unsigned int section_align_power;
8235       /* TRUE if this is the default machine for the architecture.
8236          The default arch should be the first entry for an arch so that
8237          all the entries for that arch can be accessed via next.  */
8238       bool the_default;
8239       const struct bfd_arch_info * (*compatible) (const struct bfd_arch_info *,
8240                                                   const struct bfd_arch_info *);
8241
8242       bool (*scan) (const struct bfd_arch_info *, const char *);
8243
8244       /* Allocate via bfd_malloc and return a fill buffer of size COUNT.  If
8245          IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8246          TRUE, the buffer contains code.  */
8247       void *(*fill) (bfd_size_type count, bool is_bigendian, bool code);
8248
8249       const struct bfd_arch_info *next;
8250
8251       /* On some architectures the offset for a relocation can point into
8252          the middle of an instruction.  This field specifies the maximum
8253          offset such a relocation can have (in octets).  This affects the
8254          behaviour of the disassembler, since a value greater than zero
8255          means that it may need to disassemble an instruction twice, once
8256          to get its length and then a second time to display it.  If the
8257          value is negative then this has to be done for every single
8258          instruction, regardless of the offset of the reloc.  */
8259       signed int max_reloc_offset_into_insn;
8260     }
8261     bfd_arch_info_type;
8262
8263
82642.13.2.1 ���bfd_printable_name���
8265.............................
8266
8267 -- Function: const char *bfd_printable_name (bfd *abfd);
8268     Return a printable string representing the architecture and machine
8269     from the pointer to the architecture info structure.
8270
82712.13.2.2 ���bfd_scan_arch���
8272........................
8273
8274 -- Function: const bfd_arch_info_type *bfd_scan_arch (const char
8275          *string);
8276     Figure out if BFD supports any cpu which could be described with
8277     the name STRING.  Return a pointer to an ���arch_info��� structure if a
8278     machine is found, otherwise NULL.
8279
82802.13.2.3 ���bfd_arch_list���
8281........................
8282
8283 -- Function: const char **bfd_arch_list (void);
8284     Return a freshly malloced NULL-terminated vector of the names of
8285     all the valid BFD architectures.  Do not modify the names.
8286
82872.13.2.4 ���bfd_arch_get_compatible���
8288..................................
8289
8290 -- Function: const bfd_arch_info_type *bfd_arch_get_compatible (const
8291          bfd *abfd, const bfd *bbfd, bool accept_unknowns);
8292     Determine whether two BFDs��� architectures and machine types are
8293     compatible.  Calculates the lowest common denominator between the
8294     two architectures and machine types implied by the BFDs and returns
8295     a pointer to an ���arch_info��� structure describing the compatible
8296     machine.
8297
82982.13.2.5 ���bfd_default_arch_struct���
8299..................................
8300
8301The ���bfd_default_arch_struct��� is an item of ���bfd_arch_info_type��� which
8302has been initialized to a fairly generic state.  A BFD starts life by
8303pointing to this structure, until the correct back end has determined
8304the real architecture of the file.
8305     extern const bfd_arch_info_type bfd_default_arch_struct;
8306
8307
83082.13.2.6 ���bfd_set_arch_info���
8309............................
8310
8311 -- Function: void bfd_set_arch_info (bfd *abfd, const
8312          bfd_arch_info_type *arg);
8313     Set the architecture info of ABFD to ARG.
8314
83152.13.2.7 ���bfd_default_set_arch_mach���
8316....................................
8317
8318 -- Function: bool bfd_default_set_arch_mach (bfd *abfd, enum
8319          bfd_architecture arch, unsigned long mach);
8320     Set the architecture and machine type in BFD ABFD to ARCH and MACH.
8321     Find the correct pointer to a structure and insert it into the
8322     ���arch_info��� pointer.
8323
83242.13.2.8 ���bfd_get_arch���
8325.......................
8326
8327 -- Function: enum bfd_architecture bfd_get_arch (const bfd *abfd);
8328     Return the enumerated type which describes the BFD ABFD���s
8329     architecture.
8330
83312.13.2.9 ���bfd_get_mach���
8332.......................
8333
8334 -- Function: unsigned long bfd_get_mach (const bfd *abfd);
8335     Return the long type which describes the BFD ABFD���s machine.
8336
83372.13.2.10 ���bfd_arch_bits_per_byte���
8338..................................
8339
8340 -- Function: unsigned int bfd_arch_bits_per_byte (const bfd *abfd);
8341     Return the number of bits in one of the BFD ABFD���s architecture���s
8342     bytes.
8343
83442.13.2.11 ���bfd_arch_bits_per_address���
8345.....................................
8346
8347 -- Function: unsigned int bfd_arch_bits_per_address (const bfd *abfd);
8348     Return the number of bits in one of the BFD ABFD���s architecture���s
8349     addresses.
8350
83512.13.2.12 ���bfd_default_compatible���
8352..................................
8353
8354 -- Function: const bfd_arch_info_type *bfd_default_compatible (const
8355          bfd_arch_info_type *a, const bfd_arch_info_type *b);
8356     The default function for testing for compatibility.
8357
83582.13.2.13 ���bfd_default_scan���
8359............................
8360
8361 -- Function: bool bfd_default_scan (const struct bfd_arch_info *info,
8362          const char *string);
8363     The default function for working out whether this is an
8364     architecture hit and a machine hit.
8365
83662.13.2.14 ���bfd_get_arch_info���
8367.............................
8368
8369 -- Function: const bfd_arch_info_type *bfd_get_arch_info (bfd *abfd);
8370     Return the architecture info struct in ABFD.
8371
83722.13.2.15 ���bfd_lookup_arch���
8373...........................
8374
8375 -- Function: const bfd_arch_info_type *bfd_lookup_arch (enum
8376          bfd_architecture arch, unsigned long machine);
8377     Look for the architecture info structure which matches the
8378     arguments ARCH and MACHINE.  A machine of 0 matches the
8379     machine/architecture structure which marks itself as the default.
8380
83812.13.2.16 ���bfd_printable_arch_mach���
8382...................................
8383
8384 -- Function: const char *bfd_printable_arch_mach (enum bfd_architecture
8385          arch, unsigned long machine);
8386     Return a printable string representing the architecture and machine
8387     type.
8388
8389     This routine is depreciated.
8390
83912.13.2.17 ���bfd_octets_per_byte���
8392...............................
8393
8394 -- Function: unsigned int bfd_octets_per_byte (const bfd *abfd, const
8395          asection *sec);
8396     Return the number of octets (8-bit quantities) per target byte
8397     (minimum addressable unit).  In most cases, this will be one, but
8398     some DSP targets have 16, 32, or even 48 bits per byte.
8399
84002.13.2.18 ���bfd_arch_mach_octets_per_byte���
8401.........................................
8402
8403 -- Function: unsigned int bfd_arch_mach_octets_per_byte (enum
8404          bfd_architecture arch, unsigned long machine);
8405     See bfd_octets_per_byte.
8406
8407     This routine is provided for those cases where a bfd * is not
8408     available
8409
84102.13.2.19 ���bfd_arch_default_fill���
8411.................................
8412
8413 -- Function: void *bfd_arch_default_fill (bfd_size_type count, bool
8414          is_bigendian, bool code);
8415     Allocate via bfd_malloc and return a fill buffer of size COUNT. If
8416     IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8417     TRUE, the buffer contains code.
8418
8419
8420File: bfd.info,  Node: Opening and Closing,  Next: Internal,  Prev: Architectures,  Up: BFD front end
8421
84222.14 Opening and closing BFDs
8423=============================
8424
84252.14.1 Functions for opening and closing
8426----------------------------------------
8427
84282.14.1.1 ���_bfd_new_bfd���
8429.......................
8430
8431 -- Function: bfd *_bfd_new_bfd (void);
8432     Return a new BFD. All BFD���s are allocated through this routine.
8433
84342.14.1.2 ���_bfd_new_bfd_contained_in���
8435....................................
8436
8437 -- Function: bfd *_bfd_new_bfd_contained_in (bfd *);
8438     Allocate a new BFD as a member of archive OBFD.
8439
84402.14.1.3 ���_bfd_free_cached_info���
8441................................
8442
8443 -- Function: bool _bfd_free_cached_info (bfd *);
8444     Free objalloc memory.
8445
84462.14.1.4 ���bfd_fopen���
8447....................
8448
8449 -- Function: bfd *bfd_fopen (const char *filename, const char *target,
8450          const char *mode, int fd);
8451     Open the file FILENAME with the target TARGET.  Return a pointer to
8452     the created BFD. If FD is not -1, then ���fdopen��� is used to open the
8453     file; otherwise, ���fopen��� is used.  MODE is passed directly to
8454     ���fopen��� or ���fdopen���.
8455
8456     Calls ���bfd_find_target���, so TARGET is interpreted as by that
8457     function.
8458
8459     The new BFD is marked as cacheable iff FD is -1.
8460
8461     If ���NULL��� is returned then an error has occured.  Possible errors
8462     are ���bfd_error_no_memory���, ���bfd_error_invalid_target��� or
8463     ���system_call��� error.
8464
8465     On error, FD is always closed.
8466
8467     A copy of the FILENAME argument is stored in the newly created BFD.
8468     It can be accessed via the bfd_get_filename() macro.
8469
84702.14.1.5 ���bfd_openr���
8471....................
8472
8473 -- Function: bfd *bfd_openr (const char *filename, const char *target);
8474     Open the file FILENAME (using ���fopen���) with the target TARGET.
8475     Return a pointer to the created BFD.
8476
8477     Calls ���bfd_find_target���, so TARGET is interpreted as by that
8478     function.
8479
8480     If ���NULL��� is returned then an error has occured.  Possible errors
8481     are ���bfd_error_no_memory���, ���bfd_error_invalid_target��� or
8482     ���system_call��� error.
8483
8484     A copy of the FILENAME argument is stored in the newly created BFD.
8485     It can be accessed via the bfd_get_filename() macro.
8486
84872.14.1.6 ���bfd_fdopenr���
8488......................
8489
8490 -- Function: bfd *bfd_fdopenr (const char *filename, const char
8491          *target, int fd);
8492     ���bfd_fdopenr��� is to ���bfd_fopenr��� much like ���fdopen��� is to ���fopen���.
8493     It opens a BFD on a file already described by the FD supplied.
8494
8495     When the file is later ���bfd_close���d, the file descriptor will be
8496     closed.  If the caller desires that this file descriptor be cached
8497     by BFD (opened as needed, closed as needed to free descriptors for
8498     other opens), with the supplied FD used as an initial file
8499     descriptor (but subject to closure at any time), call
8500     bfd_set_cacheable(bfd, 1) on the returned BFD. The default is to
8501     assume no caching; the file descriptor will remain open until
8502     ���bfd_close���, and will not be affected by BFD operations on other
8503     files.
8504
8505     Possible errors are ���bfd_error_no_memory���,
8506     ���bfd_error_invalid_target��� and ���bfd_error_system_call���.
8507
8508     On error, FD is closed.
8509
8510     A copy of the FILENAME argument is stored in the newly created BFD.
8511     It can be accessed via the bfd_get_filename() macro.
8512
85132.14.1.7 ���bfd_fdopenw���
8514......................
8515
8516 -- Function: bfd *bfd_fdopenw (const char *filename, const char
8517          *target, int fd);
8518     ���bfd_fdopenw��� is exactly like ���bfd_fdopenr��� with the exception that
8519     the resulting BFD is suitable for output.
8520
85212.14.1.8 ���bfd_openstreamr���
8522..........................
8523
8524 -- Function: bfd *bfd_openstreamr (const char * filename, const char *
8525          target, void * stream);
8526     Open a BFD for read access on an existing stdio stream.  When the
8527     BFD is passed to ���bfd_close���, the stream will be closed.
8528
8529     A copy of the FILENAME argument is stored in the newly created BFD.
8530     It can be accessed via the bfd_get_filename() macro.
8531
85322.14.1.9 ���bfd_openr_iovec���
8533..........................
8534
8535 -- Function: bfd *bfd_openr_iovec (const char *filename, const char
8536          *target, void *(*open_func) (struct bfd *nbfd, void
8537          *open_closure), void *open_closure, file_ptr (*pread_func)
8538          (struct bfd *nbfd, void *stream, void *buf, file_ptr nbytes,
8539          file_ptr offset), int (*close_func) (struct bfd *nbfd, void
8540          *stream), int (*stat_func) (struct bfd *abfd, void *stream,
8541          struct stat *sb));
8542     Create and return a BFD backed by a read-only STREAM.  The STREAM
8543     is created using OPEN_FUNC, accessed using PREAD_FUNC and destroyed
8544     using CLOSE_FUNC.
8545
8546     Calls ���bfd_find_target���, so TARGET is interpreted as by that
8547     function.
8548
8549     Calls OPEN_FUNC (which can call ���bfd_zalloc��� and
8550     ���bfd_get_filename���) to obtain the read-only stream backing the BFD.
8551     OPEN_FUNC either succeeds returning the non-���NULL��� STREAM, or fails
8552     returning ���NULL��� (setting ���bfd_error���).
8553
8554     Calls PREAD_FUNC to request NBYTES of data from STREAM starting at
8555     OFFSET (e.g., via a call to ���bfd_read���).  PREAD_FUNC either
8556     succeeds returning the number of bytes read (which can be less than
8557     NBYTES when end-of-file), or fails returning -1 (setting
8558     ���bfd_error���).
8559
8560     Calls CLOSE_FUNC when the BFD is later closed using ���bfd_close���.
8561     CLOSE_FUNC either succeeds returning 0, or fails returning -1
8562     (setting ���bfd_error���).
8563
8564     Calls STAT_FUNC to fill in a stat structure for bfd_stat,
8565     bfd_get_size, and bfd_get_mtime calls.  STAT_FUNC returns 0 on
8566     success, or returns -1 on failure (setting ���bfd_error���).
8567
8568     If ���bfd_openr_iovec��� returns ���NULL��� then an error has occurred.
8569     Possible errors are ���bfd_error_no_memory���,
8570     ���bfd_error_invalid_target��� and ���bfd_error_system_call���.
8571
8572     A copy of the FILENAME argument is stored in the newly created BFD.
8573     It can be accessed via the bfd_get_filename() macro.
8574
85752.14.1.10 ���bfd_openw���
8576.....................
8577
8578 -- Function: bfd *bfd_openw (const char *filename, const char *target);
8579     Create a BFD, associated with file FILENAME, using the file format
8580     TARGET, and return a pointer to it.
8581
8582     Possible errors are ���bfd_error_system_call���, ���bfd_error_no_memory���,
8583     ���bfd_error_invalid_target���.
8584
8585     A copy of the FILENAME argument is stored in the newly created BFD.
8586     It can be accessed via the bfd_get_filename() macro.
8587
85882.14.1.11 ���bfd_elf_bfd_from_remote_memory���
8589..........................................
8590
8591 -- Function: bfd *bfd_elf_bfd_from_remote_memory (bfd *templ, bfd_vma
8592          ehdr_vma, bfd_size_type size, bfd_vma *loadbasep, int
8593          (*target_read_memory) (bfd_vma vma, bfd_byte *myaddr,
8594          bfd_size_type len));
8595     Create a new BFD as if by bfd_openr.  Rather than opening a file,
8596     reconstruct an ELF file by reading the segments out of remote
8597     memory based on the ELF file header at EHDR_VMA and the ELF program
8598     headers it points to.  If non-zero, SIZE is the known extent of the
8599     object.  If not null, *LOADBASEP is filled in with the difference
8600     between the VMAs from which the segments were read, and the VMAs
8601     the file headers (and hence BFD���s idea of each section���s VMA) put
8602     them at.
8603
8604     The function TARGET_READ_MEMORY is called to copy LEN bytes from
8605     the remote memory at target address VMA into the local buffer at
8606     MYADDR; it should return zero on success or an errno code on
8607     failure.  TEMPL must be a BFD for an ELF target with the word size
8608     and byte order found in the remote memory.
8609
86102.14.1.12 ���bfd_close���
8611.....................
8612
8613 -- Function: bool bfd_close (bfd *abfd);
8614     Close a BFD. If the BFD was open for writing, then pending
8615     operations are completed and the file written out and closed.  If
8616     the created file is executable, then ���chmod��� is called to mark it
8617     as such.
8618
8619     All memory attached to the BFD is released.
8620
8621     The file descriptor associated with the BFD is closed (even if it
8622     was passed in to BFD by ���bfd_fdopenr���).
8623
8624     ���TRUE��� is returned if all is ok, otherwise ���FALSE���.
8625
86262.14.1.13 ���bfd_close_all_done���
8627..............................
8628
8629 -- Function: bool bfd_close_all_done (bfd *);
8630     Close a BFD. Differs from ���bfd_close��� since it does not complete
8631     any pending operations.  This routine would be used if the
8632     application had just used BFD for swapping and didn���t want to use
8633     any of the writing code.
8634
8635     If the created file is executable, then ���chmod��� is called to mark
8636     it as such.
8637
8638     All memory attached to the BFD is released.
8639
8640     ���TRUE��� is returned if all is ok, otherwise ���FALSE���.
8641
86422.14.1.14 ���bfd_create���
8643......................
8644
8645 -- Function: bfd *bfd_create (const char *filename, bfd *templ);
8646     Create a new BFD in the manner of ���bfd_openw���, but without opening
8647     a file.  The new BFD takes the target from the target used by
8648     TEMPL.  The format is always set to ���bfd_object���.
8649
8650     A copy of the FILENAME argument is stored in the newly created BFD.
8651     It can be accessed via the bfd_get_filename() macro.
8652
86532.14.1.15 ���bfd_make_writable���
8654.............................
8655
8656 -- Function: bool bfd_make_writable (bfd *abfd);
8657     Takes a BFD as created by ���bfd_create��� and converts it into one
8658     like as returned by ���bfd_openw���.  It does this by converting the
8659     BFD to BFD_IN_MEMORY. It���s assumed that you will call
8660     ���bfd_make_readable��� on this bfd later.
8661
8662     ���TRUE��� is returned if all is ok, otherwise ���FALSE���.
8663
86642.14.1.16 ���bfd_make_readable���
8665.............................
8666
8667 -- Function: bool bfd_make_readable (bfd *abfd);
8668     Takes a BFD as created by ���bfd_create��� and ���bfd_make_writable��� and
8669     converts it into one like as returned by ���bfd_openr���.  It does this
8670     by writing the contents out to the memory buffer, then reversing
8671     the direction.
8672
8673     ���TRUE��� is returned if all is ok, otherwise ���FALSE���.
8674
86752.14.1.17 ���bfd_calc_gnu_debuglink_crc32���
8676........................................
8677
8678 -- Function: uint32_t bfd_calc_gnu_debuglink_crc32 (uint32_t crc, const
8679          bfd_byte *buf, bfd_size_type len);
8680     Computes a CRC value as used in the .gnu_debuglink section.
8681     Advances the previously computed CRC value by computing and adding
8682     in the crc32 for LEN bytes of BUF.
8683
8684     Return the updated CRC32 value.
8685
86862.14.1.18 ���bfd_get_debug_link_info���
8687...................................
8688
8689 -- Function: char *bfd_get_debug_link_info (bfd *abfd, uint32_t
8690          *crc32_out);
8691     Extracts the filename and CRC32 value for any separate debug
8692     information file associated with ABFD.
8693
8694     Returns the filename of the associated debug information file, or
8695     NULL if there is no such file.  If the filename was found then the
8696     contents of CRC32_OUT are updated to hold the corresponding CRC32
8697     value for the file.
8698
8699     The returned filename is allocated with ���malloc���; freeing it is the
8700     responsibility of the caller.
8701
87022.14.1.19 ���bfd_get_alt_debug_link_info���
8703.......................................
8704
8705 -- Function: char *bfd_get_alt_debug_link_info (bfd * abfd,
8706          bfd_size_type *buildid_len, bfd_byte **buildid_out);
8707     Fetch the filename and BuildID value for any alternate debuginfo
8708     associated with ABFD.  Return NULL if no such info found, otherwise
8709     return filename and update BUILDID_LEN and BUILDID_OUT.  The
8710     returned filename and build_id are allocated with ���malloc���; freeing
8711     them is the responsibility of the caller.
8712
87132.14.1.20 ���bfd_follow_gnu_debuglink���
8714....................................
8715
8716 -- Function: char *bfd_follow_gnu_debuglink (bfd *abfd, const char
8717          *dir);
8718     Takes a BFD and searches it for a .gnu_debuglink section.  If this
8719     section is found, it examines the section for the name and checksum
8720     of a ���.debug��� file containing auxiliary debugging information.  It
8721     then searches the filesystem for this .debug file in some standard
8722     locations, including the directory tree rooted at DIR, and if found
8723     returns the full filename.
8724
8725     If DIR is NULL, the search will take place starting at the current
8726     directory.
8727
8728     Returns ���NULL��� on any errors or failure to locate the .debug file,
8729     otherwise a pointer to a heap-allocated string containing the
8730     filename.  The caller is responsible for freeing this string.
8731
87322.14.1.21 ���bfd_follow_gnu_debugaltlink���
8733.......................................
8734
8735 -- Function: char *bfd_follow_gnu_debugaltlink (bfd *abfd, const char
8736          *dir);
8737     Takes a BFD and searches it for a .gnu_debugaltlink section.  If
8738     this section is found, it examines the section for the name of a
8739     file containing auxiliary debugging information.  It then searches
8740     the filesystem for this file in a set of standard locations,
8741     including the directory tree rooted at DIR, and if found returns
8742     the full filename.
8743
8744     If DIR is NULL, the search will take place starting at the current
8745     directory.
8746
8747     Returns ���NULL��� on any errors or failure to locate the debug file,
8748     otherwise a pointer to a heap-allocated string containing the
8749     filename.  The caller is responsible for freeing this string.
8750
87512.14.1.22 ���bfd_create_gnu_debuglink_section���
8752............................................
8753
8754 -- Function: struct bfd_section *bfd_create_gnu_debuglink_section (bfd
8755          *abfd, const char *filename);
8756     Takes a BFD and adds a .gnu_debuglink section to it.  The section
8757     is sized to be big enough to contain a link to the specified
8758     FILENAME.
8759
8760     A pointer to the new section is returned if all is ok.  Otherwise
8761     ���NULL��� is returned and bfd_error is set.
8762
87632.14.1.23 ���bfd_fill_in_gnu_debuglink_section���
8764.............................................
8765
8766 -- Function: bool bfd_fill_in_gnu_debuglink_section (bfd *abfd, struct
8767          bfd_section *sect, const char *filename);
8768     Takes a BFD and containing a .gnu_debuglink section SECT and fills
8769     in the contents of the section to contain a link to the specified
8770     FILENAME.  The filename should be absolute or relative to the
8771     current directory.
8772
8773     ���TRUE��� is returned if all is ok.  Otherwise ���FALSE��� is returned and
8774     bfd_error is set.
8775
87762.14.1.24 ���bfd_follow_build_id_debuglink���
8777.........................................
8778
8779 -- Function: char *bfd_follow_build_id_debuglink (bfd *abfd, const char
8780          *dir);
8781     Takes ABFD and searches it for a .note.gnu.build-id section.  If
8782     this section is found, it extracts the value of the NT_GNU_BUILD_ID
8783     note, which should be a hexadecimal value NNNN+NN (for 32+ hex
8784     digits).  It then searches the filesystem for a file named
8785     .BUILD-ID/NN/NN+NN.DEBUG in a set of standard locations, including
8786     the directory tree rooted at DIR.  The filename of the first
8787     matching file to be found is returned.  A matching file should
8788     contain a .note.gnu.build-id section with the same NNNN+NN note as
8789     ABFD, although this check is currently not implemented.
8790
8791     If DIR is NULL, the search will take place starting at the current
8792     directory.
8793
8794     Returns ���NULL��� on any errors or failure to locate the debug file,
8795     otherwise a pointer to a heap-allocated string containing the
8796     filename.  The caller is responsible for freeing this string.
8797
87982.14.1.25 ���bfd_set_filename���
8799............................
8800
8801 -- Function: const char *bfd_set_filename (bfd *abfd, const char
8802          *filename);
8803     Set the filename of ABFD, copying the FILENAME parameter to
8804     bfd_alloc���d memory owned by ABFD.  Returns a pointer the newly
8805     allocated name, or NULL if the allocation failed.
8806
8807
8808File: bfd.info,  Node: Internal,  Next: File Caching,  Prev: Opening and Closing,  Up: BFD front end
8809
88102.15 Implementation details
8811===========================
8812
88132.15.1 Internal functions
8814-------------------------
8815
8816These routines are used within BFD. They are not intended for export,
8817but are documented here for completeness.
8818
88192.15.1.1 ���bfd_malloc���
8820.....................
8821
8822 -- Function: void *bfd_malloc (bfd_size_type *size*);
8823     Returns a pointer to an allocated block of memory that is at least
8824     SIZE bytes long.  If SIZE is 0 then it will be treated as if it
8825     were 1.  If SIZE is too big then NULL will be returned.  Returns
8826     NULL upon error and sets bfd_error.
8827
88282.15.1.2 ���bfd_realloc���
8829......................
8830
8831 -- Function: void *bfd_realloc (void **mem*, bfd_size_type *size*);
8832     Returns a pointer to an allocated block of memory that is at least
8833     SIZE bytes long.  If SIZE is 0 then it will be treated as if it
8834     were 1.  If SIZE is too big then NULL will be returned.  If MEM is
8835     not NULL then it must point to an allocated block of memory.  If
8836     this block is large enough then MEM may be used as the return value
8837     for this function, but this is not guaranteed.
8838
8839     If MEM is not returned then the first N bytes in the returned block
8840     will be identical to the first N bytes in region pointed to by MEM,
8841     where N is the lessor of SIZE and the length of the region of
8842     memory currently addressed by MEM.
8843
8844     Returns NULL upon error and sets bfd_error.
8845
88462.15.1.3 ���bfd_realloc_or_free���
8847..............................
8848
8849 -- Function: void *bfd_realloc_or_free (void **mem*, bfd_size_type
8850          *size*);
8851     Returns a pointer to an allocated block of memory that is at least
8852     SIZE bytes long.  If SIZE is 0 then no memory will be allocated,
8853     MEM will be freed, and NULL will be returned.  This will not cause
8854     bfd_error to be set.
8855
8856     If SIZE is too big then NULL will be returned and bfd_error will be
8857     set.  If MEM is not NULL then it must point to an allocated block
8858     of memory.  If this block is large enough then MEM may be used as
8859     the return value for this function, but this is not guaranteed.
8860
8861     If MEM is not returned then the first N bytes in the returned block
8862     will be identical to the first N bytes in region pointed to by MEM,
8863     where N is the lessor of SIZE and the length of the region of
8864     memory currently addressed by MEM.
8865
88662.15.1.4 ���bfd_zmalloc���
8867......................
8868
8869 -- Function: void *bfd_zmalloc (bfd_size_type *size*);
8870     Returns a pointer to an allocated block of memory that is at least
8871     SIZE bytes long.  If SIZE is 0 then it will be treated as if it
8872     were 1.  If SIZE is too big then NULL will be returned.  Returns
8873     NULL upon error and sets bfd_error.
8874
8875     If NULL is not returned then the allocated block of memory will
8876     have been cleared.
8877
88782.15.1.5 ���bfd_alloc���
8879....................
8880
8881 -- Function: void *bfd_alloc (bfd *abfd, bfd_size_type wanted);
8882     Allocate a block of WANTED bytes of memory attached to ���abfd��� and
8883     return a pointer to it.
8884
88852.15.1.6 ���bfd_zalloc���
8886.....................
8887
8888 -- Function: void *bfd_zalloc (bfd *abfd, bfd_size_type wanted);
8889     Allocate a block of WANTED bytes of zeroed memory attached to
8890     ���abfd��� and return a pointer to it.
8891
88922.15.1.7 ���bfd_release���
8893......................
8894
8895 -- Function: void bfd_release (bfd *, void *);
8896     Free a block allocated for a BFD. Note: Also frees all more
8897     recently allocated blocks!
8898
88992.15.1.8 ���bfd_write_bigendian_4byte_int���
8900........................................
8901
8902 -- Function: bool bfd_write_bigendian_4byte_int (bfd *, unsigned int);
8903     Write a 4 byte integer I to the output BFD ABFD, in big endian
8904     order regardless of what else is going on.  This is useful in
8905     archives.
8906
89072.15.1.9 ���bfd_put_size���
8908.......................
8909
89102.15.1.10 ���bfd_get_size���
8911........................
8912
8913These macros as used for reading and writing raw data in sections; each
8914access (except for bytes) is vectored through the target format of the
8915BFD and mangled accordingly.  The mangling performs any necessary endian
8916translations and removes alignment restrictions.  Note that types
8917accepted and returned by these macros are identical so they can be
8918swapped around in macros���for example, ���libaout.h��� defines ���GET_WORD��� to
8919either ���bfd_get_32��� or ���bfd_get_64���.
8920
8921   In the put routines, VAL must be a ���bfd_vma���.  If we are on a system
8922without prototypes, the caller is responsible for making sure that is
8923true, with a cast if necessary.  We don���t cast them in the macro
8924definitions because that would prevent ���lint��� or ���gcc -Wall��� from
8925detecting sins such as passing a pointer.  To detect calling these with
8926less than a ���bfd_vma���, use ���gcc -Wconversion��� on a host with 64 bit
8927���bfd_vma������s.
8928
8929     /* Byte swapping macros for user section data.  */
8930
8931     #define bfd_put_8(abfd, val, ptr) \
8932       ((void) (*((bfd_byte *) (ptr)) = (val) & 0xff))
8933     #define bfd_put_signed_8 \
8934       bfd_put_8
8935     #define bfd_get_8(abfd, ptr) \
8936       ((bfd_vma) *(const bfd_byte *) (ptr) & 0xff)
8937     #define bfd_get_signed_8(abfd, ptr) \
8938       ((((bfd_signed_vma) *(const bfd_byte *) (ptr) & 0xff) ^ 0x80) - 0x80)
8939
8940     #define bfd_put_16(abfd, val, ptr) \
8941       BFD_SEND (abfd, bfd_putx16, ((val),(ptr)))
8942     #define bfd_put_signed_16 \
8943       bfd_put_16
8944     #define bfd_get_16(abfd, ptr) \
8945       BFD_SEND (abfd, bfd_getx16, (ptr))
8946     #define bfd_get_signed_16(abfd, ptr) \
8947       BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
8948
8949     #define bfd_put_24(abfd, val, ptr) \
8950       do                                   \
8951         if (bfd_big_endian (abfd))         \
8952           bfd_putb24 ((val), (ptr));       \
8953         else                               \
8954           bfd_putl24 ((val), (ptr));       \
8955       while (0)
8956
8957     bfd_vma bfd_getb24 (const void *p);
8958     bfd_vma bfd_getl24 (const void *p);
8959
8960     #define bfd_get_24(abfd, ptr) \
8961       (bfd_big_endian (abfd) ? bfd_getb24 (ptr) : bfd_getl24 (ptr))
8962
8963     #define bfd_put_32(abfd, val, ptr) \
8964       BFD_SEND (abfd, bfd_putx32, ((val),(ptr)))
8965     #define bfd_put_signed_32 \
8966       bfd_put_32
8967     #define bfd_get_32(abfd, ptr) \
8968       BFD_SEND (abfd, bfd_getx32, (ptr))
8969     #define bfd_get_signed_32(abfd, ptr) \
8970       BFD_SEND (abfd, bfd_getx_signed_32, (ptr))
8971
8972     #define bfd_put_64(abfd, val, ptr) \
8973       BFD_SEND (abfd, bfd_putx64, ((val), (ptr)))
8974     #define bfd_put_signed_64 \
8975       bfd_put_64
8976     #define bfd_get_64(abfd, ptr) \
8977       BFD_SEND (abfd, bfd_getx64, (ptr))
8978     #define bfd_get_signed_64(abfd, ptr) \
8979       BFD_SEND (abfd, bfd_getx_signed_64, (ptr))
8980
8981     #define bfd_get(bits, abfd, ptr)                       \
8982       ((bits) == 8 ? bfd_get_8 (abfd, ptr)                 \
8983        : (bits) == 16 ? bfd_get_16 (abfd, ptr)             \
8984        : (bits) == 32 ? bfd_get_32 (abfd, ptr)             \
8985        : (bits) == 64 ? bfd_get_64 (abfd, ptr)             \
8986        : (abort (), (bfd_vma) - 1))
8987
8988     #define bfd_put(bits, abfd, val, ptr)                  \
8989       ((bits) == 8 ? bfd_put_8  (abfd, val, ptr)           \
8990        : (bits) == 16 ? bfd_put_16 (abfd, val, ptr)        \
8991        : (bits) == 32 ? bfd_put_32 (abfd, val, ptr)        \
8992        : (bits) == 64 ? bfd_put_64 (abfd, val, ptr)        \
8993        : (abort (), (void) 0))
8994
8995
89962.15.1.11 ���bfd_h_put_size���
8997..........................
8998
8999These macros have the same function as their ���bfd_get_x��� brethren,
9000except that they are used for removing information for the header
9001records of object files.  Believe it or not, some object files keep
9002their header records in big endian order and their data in little endian
9003order.
9004
9005     /* Byte swapping macros for file header data.  */
9006
9007     #define bfd_h_put_8(abfd, val, ptr) \
9008       bfd_put_8 (abfd, val, ptr)
9009     #define bfd_h_put_signed_8(abfd, val, ptr) \
9010       bfd_put_8 (abfd, val, ptr)
9011     #define bfd_h_get_8(abfd, ptr) \
9012       bfd_get_8 (abfd, ptr)
9013     #define bfd_h_get_signed_8(abfd, ptr) \
9014       bfd_get_signed_8 (abfd, ptr)
9015
9016     #define bfd_h_put_16(abfd, val, ptr) \
9017       BFD_SEND (abfd, bfd_h_putx16, (val, ptr))
9018     #define bfd_h_put_signed_16 \
9019       bfd_h_put_16
9020     #define bfd_h_get_16(abfd, ptr) \
9021       BFD_SEND (abfd, bfd_h_getx16, (ptr))
9022     #define bfd_h_get_signed_16(abfd, ptr) \
9023       BFD_SEND (abfd, bfd_h_getx_signed_16, (ptr))
9024
9025     #define bfd_h_put_32(abfd, val, ptr) \
9026       BFD_SEND (abfd, bfd_h_putx32, (val, ptr))
9027     #define bfd_h_put_signed_32 \
9028       bfd_h_put_32
9029     #define bfd_h_get_32(abfd, ptr) \
9030       BFD_SEND (abfd, bfd_h_getx32, (ptr))
9031     #define bfd_h_get_signed_32(abfd, ptr) \
9032       BFD_SEND (abfd, bfd_h_getx_signed_32, (ptr))
9033
9034     #define bfd_h_put_64(abfd, val, ptr) \
9035       BFD_SEND (abfd, bfd_h_putx64, (val, ptr))
9036     #define bfd_h_put_signed_64 \
9037       bfd_h_put_64
9038     #define bfd_h_get_64(abfd, ptr) \
9039       BFD_SEND (abfd, bfd_h_getx64, (ptr))
9040     #define bfd_h_get_signed_64(abfd, ptr) \
9041       BFD_SEND (abfd, bfd_h_getx_signed_64, (ptr))
9042
9043     /* Aliases for the above, which should eventually go away.  */
9044
9045     #define H_PUT_64  bfd_h_put_64
9046     #define H_PUT_32  bfd_h_put_32
9047     #define H_PUT_16  bfd_h_put_16
9048     #define H_PUT_8   bfd_h_put_8
9049     #define H_PUT_S64 bfd_h_put_signed_64
9050     #define H_PUT_S32 bfd_h_put_signed_32
9051     #define H_PUT_S16 bfd_h_put_signed_16
9052     #define H_PUT_S8  bfd_h_put_signed_8
9053     #define H_GET_64  bfd_h_get_64
9054     #define H_GET_32  bfd_h_get_32
9055     #define H_GET_16  bfd_h_get_16
9056     #define H_GET_8   bfd_h_get_8
9057     #define H_GET_S64 bfd_h_get_signed_64
9058     #define H_GET_S32 bfd_h_get_signed_32
9059     #define H_GET_S16 bfd_h_get_signed_16
9060     #define H_GET_S8  bfd_h_get_signed_8
9061
9062
9063
90642.15.1.12 ���Byte swapping routines.���
9065...................................
9066
9067 -- Function: uint64_t bfd_getb64 (const void *); uint64_t bfd_getl64
9068          (const void *); int64_t bfd_getb_signed_64 (const void *);
9069          int64_t bfd_getl_signed_64 (const void *); bfd_vma bfd_getb32
9070          (const void *); bfd_vma bfd_getl32 (const void *);
9071          bfd_signed_vma bfd_getb_signed_32 (const void *);
9072          bfd_signed_vma bfd_getl_signed_32 (const void *); bfd_vma
9073          bfd_getb16 (const void *); bfd_vma bfd_getl16 (const void *);
9074          bfd_signed_vma bfd_getb_signed_16 (const void *);
9075          bfd_signed_vma bfd_getl_signed_16 (const void *); void
9076          bfd_putb64 (uint64_t, void *); void bfd_putl64 (uint64_t, void
9077          *); void bfd_putb32 (bfd_vma, void *); void bfd_putl32
9078          (bfd_vma, void *); void bfd_putb24 (bfd_vma, void *); void
9079          bfd_putl24 (bfd_vma, void *); void bfd_putb16 (bfd_vma, void
9080          *); void bfd_putl16 (bfd_vma, void *); uint64_t bfd_get_bits
9081          (const void *, int, bool); void bfd_put_bits (uint64_t, void
9082          *, int, bool);
9083     Read and write integers in a particular endian order.  getb and
9084     putb functions handle big-endian, getl and putl handle
9085     little-endian.  bfd_get_bits and bfd_put_bits specify big-endian by
9086     passing TRUE in the last parameter, little-endian by passing FALSE.
9087
90882.15.1.13 ���bfd_log2���
9089....................
9090
9091 -- Function: unsigned int bfd_log2 (bfd_vma x);
9092     Return the log base 2 of the value supplied, rounded up.  E.g., an
9093     X of 1025 returns 11.  A X of 0 returns 0.
9094
9095
9096File: bfd.info,  Node: File Caching,  Next: Linker Functions,  Prev: Internal,  Up: BFD front end
9097
90982.16 File caching
9099=================
9100
9101The file caching mechanism is embedded within BFD and allows the
9102application to open as many BFDs as it wants without regard to the
9103underlying operating system���s file descriptor limit (often as low as 20
9104open files).  The module in ���cache.c��� maintains a least recently used
9105list of ���bfd_cache_max_open��� files, and exports the name
9106���bfd_cache_lookup���, which runs around and makes sure that the required
9107BFD is open.  If not, then it chooses a file to close, closes it and
9108opens the one wanted, returning its file handle.
9109
91102.16.1 Caching functions
9111------------------------
9112
91132.16.1.1 ���bfd_cache_init���
9114.........................
9115
9116 -- Function: bool bfd_cache_init (bfd *abfd);
9117     Add a newly opened BFD to the cache.
9118
91192.16.1.2 ���bfd_cache_close���
9120..........................
9121
9122 -- Function: bool bfd_cache_close (bfd *abfd);
9123     Remove the BFD ABFD from the cache.  If the attached file is open,
9124     then close it too.
9125
9126     ���FALSE��� is returned if closing the file fails, ���TRUE��� is returned
9127     if all is well.
9128
91292.16.1.3 ���bfd_cache_close_all���
9130..............................
9131
9132 -- Function: bool bfd_cache_close_all (void);
9133     Remove all BFDs from the cache.  If the attached file is open, then
9134     close it too.  Note - despite its name this function will close a
9135     BFD even if it is not marked as being cacheable, ie even if
9136     bfd_get_cacheable() returns false.
9137
9138     ���FALSE��� is returned if closing one of the file fails, ���TRUE��� is
9139     returned if all is well.
9140
91412.16.1.4 ���bfd_cache_size���
9142.........................
9143
9144 -- Function: unsigned bfd_cache_size (void);
9145     Return the number of open files in the cache.
9146
91472.16.1.5 ���bfd_open_file���
9148........................
9149
9150 -- Function: FILE* bfd_open_file (bfd *abfd);
9151     Call the OS to open a file for ABFD.  Return the ���FILE *��� (possibly
9152     ���NULL���) that results from this operation.  Set up the BFD so that
9153     future accesses know the file is open.  If the ���FILE *��� returned is
9154     ���NULL���, then it won���t have been put in the cache, so it won���t have
9155     to be removed from it.
9156
9157
9158File: bfd.info,  Node: Linker Functions,  Next: Hash Tables,  Prev: File Caching,  Up: BFD front end
9159
91602.17 Linker Functions
9161=====================
9162
9163The linker uses three special entry points in the BFD target vector.  It
9164is not necessary to write special routines for these entry points when
9165creating a new BFD back end, since generic versions are provided.
9166However, writing them can speed up linking and make it use significantly
9167less runtime memory.
9168
9169   The first routine creates a hash table used by the other routines.
9170The second routine adds the symbols from an object file to the hash
9171table.  The third routine takes all the object files and links them
9172together to create the output file.  These routines are designed so that
9173the linker proper does not need to know anything about the symbols in
9174the object files that it is linking.  The linker merely arranges the
9175sections as directed by the linker script and lets BFD handle the
9176details of symbols and relocs.
9177
9178   The second routine and third routines are passed a pointer to a
9179���struct bfd_link_info��� structure (defined in ���bfdlink.h���) which holds
9180information relevant to the link, including the linker hash table (which
9181was created by the first routine) and a set of callback functions to the
9182linker proper.
9183
9184   The generic linker routines are in ���linker.c���, and use the header
9185file ���genlink.h���.  As of this writing, the only back ends which have
9186implemented versions of these routines are a.out (in ���aoutx.h���) and
9187ECOFF (in ���ecoff.c���).  The a.out routines are used as examples
9188throughout this section.
9189
9190* Menu:
9191
9192* Creating a Linker Hash Table::
9193* Adding Symbols to the Hash Table::
9194* Performing the Final Link::
9195
9196
9197File: bfd.info,  Node: Creating a Linker Hash Table,  Next: Adding Symbols to the Hash Table,  Prev: Linker Functions,  Up: Linker Functions
9198
91992.17.1 Creating a linker hash table
9200-----------------------------------
9201
9202The linker routines must create a hash table, which must be derived from
9203���struct bfd_link_hash_table��� described in ���bfdlink.c���.  *Note Hash
9204Tables::, for information on how to create a derived hash table.  This
9205entry point is called using the target vector of the linker output file.
9206
9207   The ���_bfd_link_hash_table_create��� entry point must allocate and
9208initialize an instance of the desired hash table.  If the back end does
9209not require any additional information to be stored with the entries in
9210the hash table, the entry point may simply create a ���struct
9211bfd_link_hash_table���.  Most likely, however, some additional information
9212will be needed.
9213
9214   For example, with each entry in the hash table the a.out linker keeps
9215the index the symbol has in the final output file (this index number is
9216used so that when doing a relocatable link the symbol index used in the
9217output file can be quickly filled in when copying over a reloc).  The
9218a.out linker code defines the required structures and functions for a
9219hash table derived from ���struct bfd_link_hash_table���.  The a.out linker
9220hash table is created by the function
9221���NAME(aout,link_hash_table_create)���; it simply allocates space for the
9222hash table, initializes it, and returns a pointer to it.
9223
9224   When writing the linker routines for a new back end, you will
9225generally not know exactly which fields will be required until you have
9226finished.  You should simply create a new hash table which defines no
9227additional fields, and then simply add fields as they become necessary.
9228
9229
9230File: bfd.info,  Node: Adding Symbols to the Hash Table,  Next: Performing the Final Link,  Prev: Creating a Linker Hash Table,  Up: Linker Functions
9231
92322.17.2 Adding symbols to the hash table
9233---------------------------------------
9234
9235The linker proper will call the ���_bfd_link_add_symbols��� entry point for
9236each object file or archive which is to be linked (typically these are
9237the files named on the command line, but some may also come from the
9238linker script).  The entry point is responsible for examining the file.
9239For an object file, BFD must add any relevant symbol information to the
9240hash table.  For an archive, BFD must determine which elements of the
9241archive should be used and adding them to the link.
9242
9243   The a.out version of this entry point is
9244���NAME(aout,link_add_symbols)���.
9245
9246* Menu:
9247
9248* Differing file formats::
9249* Adding symbols from an object file::
9250* Adding symbols from an archive::
9251
9252
9253File: 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
9254
92552.17.2.1 Differing file formats
9256...............................
9257
9258Normally all the files involved in a link will be of the same format,
9259but it is also possible to link together different format object files,
9260and the back end must support that.  The ���_bfd_link_add_symbols��� entry
9261point is called via the target vector of the file to be added.  This has
9262an important consequence: the function may not assume that the hash
9263table is the type created by the corresponding
9264���_bfd_link_hash_table_create��� vector.  All the ���_bfd_link_add_symbols���
9265function can assume about the hash table is that it is derived from
9266���struct bfd_link_hash_table���.
9267
9268   Sometimes the ���_bfd_link_add_symbols��� function must store some
9269information in the hash table entry to be used by the ���_bfd_final_link���
9270function.  In such a case the output bfd xvec must be checked to make
9271sure that the hash table was created by an object file of the same
9272format.
9273
9274   The ���_bfd_final_link��� routine must be prepared to handle a hash entry
9275without any extra information added by the ���_bfd_link_add_symbols���
9276function.  A hash entry without extra information will also occur when
9277the linker script directs the linker to create a symbol.  Note that,
9278regardless of how a hash table entry is added, all the fields will be
9279initialized to some sort of null value by the hash table entry
9280initialization function.
9281
9282   See ���ecoff_link_add_externals��� for an example of how to check the
9283output bfd before saving information (in this case, the ECOFF external
9284symbol debugging information) in a hash table entry.
9285
9286
9287File: 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
9288
92892.17.2.2 Adding symbols from an object file
9290...........................................
9291
9292When the ���_bfd_link_add_symbols��� routine is passed an object file, it
9293must add all externally visible symbols in that object file to the hash
9294table.  The actual work of adding the symbol to the hash table is
9295normally handled by the function ���_bfd_generic_link_add_one_symbol���.
9296The ���_bfd_link_add_symbols��� routine is responsible for reading all the
9297symbols from the object file and passing the correct information to
9298���_bfd_generic_link_add_one_symbol���.
9299
9300   The ���_bfd_link_add_symbols��� routine should not use
9301���bfd_canonicalize_symtab��� to read the symbols.  The point of providing
9302this routine is to avoid the overhead of converting the symbols into
9303generic ���asymbol��� structures.
9304
9305   ���_bfd_generic_link_add_one_symbol��� handles the details of combining
9306common symbols, warning about multiple definitions, and so forth.  It
9307takes arguments which describe the symbol to add, notably symbol flags,
9308a section, and an offset.  The symbol flags include such things as
9309���BSF_WEAK��� or ���BSF_INDIRECT���.  The section is a section in the object
9310file, or something like ���bfd_und_section_ptr��� for an undefined symbol or
9311���bfd_com_section_ptr��� for a common symbol.
9312
9313   If the ���_bfd_final_link��� routine is also going to need to read the
9314symbol information, the ���_bfd_link_add_symbols��� routine should save it
9315somewhere attached to the object file BFD. However, the information
9316should only be saved if the ���keep_memory��� field of the ���info��� argument
9317is TRUE, so that the ���-no-keep-memory��� linker switch is effective.
9318
9319   The a.out function which adds symbols from an object file is
9320���aout_link_add_object_symbols���, and most of the interesting work is in
9321���aout_link_add_symbols���.  The latter saves pointers to the hash tables
9322entries created by ���_bfd_generic_link_add_one_symbol��� indexed by symbol
9323number, so that the ���_bfd_final_link��� routine does not have to call the
9324hash table lookup routine to locate the entry.
9325
9326
9327File: bfd.info,  Node: Adding symbols from an archive,  Prev: Adding symbols from an object file,  Up: Adding Symbols to the Hash Table
9328
93292.17.2.3 Adding symbols from an archive
9330.......................................
9331
9332When the ���_bfd_link_add_symbols��� routine is passed an archive, it must
9333look through the symbols defined by the archive and decide which
9334elements of the archive should be included in the link.  For each such
9335element it must call the ���add_archive_element��� linker callback, and it
9336must add the symbols from the object file to the linker hash table.
9337(The callback may in fact indicate that a replacement BFD should be
9338used, in which case the symbols from that BFD should be added to the
9339linker hash table instead.)
9340
9341   In most cases the work of looking through the symbols in the archive
9342should be done by the ���_bfd_generic_link_add_archive_symbols��� function.
9343���_bfd_generic_link_add_archive_symbols��� is passed a function to call to
9344make the final decision about adding an archive element to the link and
9345to do the actual work of adding the symbols to the linker hash table.
9346If the element is to be included, the ���add_archive_element��� linker
9347callback routine must be called with the element as an argument, and the
9348element���s symbols must be added to the linker hash table just as though
9349the element had itself been passed to the ���_bfd_link_add_symbols���
9350function.
9351
9352   When the a.out ���_bfd_link_add_symbols��� function receives an archive,
9353it calls ���_bfd_generic_link_add_archive_symbols��� passing
9354���aout_link_check_archive_element��� as the function argument.
9355���aout_link_check_archive_element��� calls ���aout_link_check_ar_symbols���.
9356If the latter decides to add the element (an element is only added if it
9357provides a real, non-common, definition for a previously undefined or
9358common symbol) it calls the ���add_archive_element��� callback and then
9359���aout_link_check_archive_element��� calls ���aout_link_add_symbols��� to
9360actually add the symbols to the linker hash table - possibly those of a
9361substitute BFD, if the ���add_archive_element��� callback avails itself of
9362that option.
9363
9364   The ECOFF back end is unusual in that it does not normally call
9365���_bfd_generic_link_add_archive_symbols���, because ECOFF archives already
9366contain a hash table of symbols.  The ECOFF back end searches the
9367archive itself to avoid the overhead of creating a new hash table.
9368
9369
9370File: bfd.info,  Node: Performing the Final Link,  Prev: Adding Symbols to the Hash Table,  Up: Linker Functions
9371
93722.17.3 Performing the final link
9373--------------------------------
9374
9375When all the input files have been processed, the linker calls the
9376���_bfd_final_link��� entry point of the output BFD. This routine is
9377responsible for producing the final output file, which has several
9378aspects.  It must relocate the contents of the input sections and copy
9379the data into the output sections.  It must build an output symbol table
9380including any local symbols from the input files and the global symbols
9381from the hash table.  When producing relocatable output, it must modify
9382the input relocs and write them into the output file.  There may also be
9383object format dependent work to be done.
9384
9385   The linker will also call the ���write_object_contents��� entry point
9386when the BFD is closed.  The two entry points must work together in
9387order to produce the correct output file.
9388
9389   The details of how this works are inevitably dependent upon the
9390specific object file format.  The a.out ���_bfd_final_link��� routine is
9391���NAME(aout,final_link)���.
9392
9393* Menu:
9394
9395* Information provided by the linker::
9396* Relocating the section contents::
9397* Writing the symbol table::
9398
9399
9400File: bfd.info,  Node: Information provided by the linker,  Next: Relocating the section contents,  Prev: Performing the Final Link,  Up: Performing the Final Link
9401
94022.17.3.1 Information provided by the linker
9403...........................................
9404
9405Before the linker calls the ���_bfd_final_link��� entry point, it sets up
9406some data structures for the function to use.
9407
9408   The ���input_bfds��� field of the ���bfd_link_info��� structure will point to
9409a list of all the input files included in the link.  These files are
9410linked through the ���link.next��� field of the ���bfd��� structure.
9411
9412   Each section in the output file will have a list of ���link_order���
9413structures attached to the ���map_head.link_order��� field (the ���link_order���
9414structure is defined in ���bfdlink.h���).  These structures describe how to
9415create the contents of the output section in terms of the contents of
9416various input sections, fill constants, and, eventually, other types of
9417information.  They also describe relocs that must be created by the BFD
9418backend, but do not correspond to any input file; this is used to
9419support -Ur, which builds constructors while generating a relocatable
9420object file.
9421
9422
9423File: bfd.info,  Node: Relocating the section contents,  Next: Writing the symbol table,  Prev: Information provided by the linker,  Up: Performing the Final Link
9424
94252.17.3.2 Relocating the section contents
9426........................................
9427
9428The ���_bfd_final_link��� function should look through the ���link_order���
9429structures attached to each section of the output file.  Each
9430���link_order��� structure should either be handled specially, or it should
9431be passed to the function ���_bfd_default_link_order��� which will do the
9432right thing (���_bfd_default_link_order��� is defined in ���linker.c���).
9433
9434   For efficiency, a ���link_order��� of type ���bfd_indirect_link_order���
9435whose associated section belongs to a BFD of the same format as the
9436output BFD must be handled specially.  This type of ���link_order���
9437describes part of an output section in terms of a section belonging to
9438one of the input files.  The ���_bfd_final_link��� function should read the
9439contents of the section and any associated relocs, apply the relocs to
9440the section contents, and write out the modified section contents.  If
9441performing a relocatable link, the relocs themselves must also be
9442modified and written out.
9443
9444   The functions ���_bfd_relocate_contents��� and ���_bfd_final_link_relocate���
9445provide some general support for performing the actual relocations,
9446notably overflow checking.  Their arguments include information about
9447the symbol the relocation is against and a ���reloc_howto_type��� argument
9448which describes the relocation to perform.  These functions are defined
9449in ���reloc.c���.
9450
9451   The a.out function which handles reading, relocating, and writing
9452section contents is ���aout_link_input_section���.  The actual relocation is
9453done in ���aout_link_input_section_std��� and ���aout_link_input_section_ext���.
9454
9455
9456File: bfd.info,  Node: Writing the symbol table,  Prev: Relocating the section contents,  Up: Performing the Final Link
9457
94582.17.3.3 Writing the symbol table
9459.................................
9460
9461The ���_bfd_final_link��� function must gather all the symbols in the input
9462files and write them out.  It must also write out all the symbols in the
9463global hash table.  This must be controlled by the ���strip��� and ���discard���
9464fields of the ���bfd_link_info��� structure.
9465
9466   The local symbols of the input files will not have been entered into
9467the linker hash table.  The ���_bfd_final_link��� routine must consider each
9468input file and include the symbols in the output file.  It may be
9469convenient to do this when looking through the ���link_order��� structures,
9470or it may be done by stepping through the ���input_bfds��� list.
9471
9472   The ���_bfd_final_link��� routine must also traverse the global hash
9473table to gather all the externally visible symbols.  It is possible that
9474most of the externally visible symbols may be written out when
9475considering the symbols of each input file, but it is still necessary to
9476traverse the hash table since the linker script may have defined some
9477symbols that are not in any of the input files.
9478
9479   The ���strip��� field of the ���bfd_link_info��� structure controls which
9480symbols are written out.  The possible values are listed in ���bfdlink.h���.
9481If the value is ���strip_some���, then the ���keep_hash��� field of the
9482���bfd_link_info��� structure is a hash table of symbols to keep; each
9483symbol should be looked up in this hash table, and only symbols which
9484are present should be included in the output file.
9485
9486   If the ���strip��� field of the ���bfd_link_info��� structure permits local
9487symbols to be written out, the ���discard��� field is used to further
9488controls which local symbols are included in the output file.  If the
9489value is ���discard_l���, then all local symbols which begin with a certain
9490prefix are discarded; this is controlled by the
9491���bfd_is_local_label_name��� entry point.
9492
9493   The a.out backend handles symbols by calling
9494���aout_link_write_symbols��� on each input BFD and then traversing the
9495global hash table with the function ���aout_link_write_other_symbol���.  It
9496builds a string table while writing out the symbols, which is written to
9497the output file at the end of ���NAME(aout,final_link)���.
9498
94992.17.3.4 ���bfd_link_split_section���
9500.................................
9501
9502 -- Function: bool bfd_link_split_section (bfd *abfd, asection *sec);
9503     Return nonzero if SEC should be split during a reloceatable or
9504     final link.
9505          #define bfd_link_split_section(abfd, sec) \
9506                 BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
9507
9508
95092.17.3.5 ���bfd_section_already_linked���
9510.....................................
9511
9512 -- Function: bool bfd_section_already_linked (bfd *abfd, asection *sec,
9513          struct bfd_link_info *info);
9514     Check if DATA has been already linked during a reloceatable or
9515     final link.  Return TRUE if it has.
9516          #define bfd_section_already_linked(abfd, sec, info) \
9517                 BFD_SEND (abfd, _section_already_linked, (abfd, sec, info))
9518
9519
95202.17.3.6 ���bfd_generic_define_common_symbol���
9521...........................................
9522
9523 -- Function: bool bfd_generic_define_common_symbol (bfd *output_bfd,
9524          struct bfd_link_info *info, struct bfd_link_hash_entry *h);
9525     Convert common symbol H into a defined symbol.  Return TRUE on
9526     success and FALSE on failure.
9527          #define bfd_define_common_symbol(output_bfd, info, h) \
9528                 BFD_SEND (output_bfd, _bfd_define_common_symbol, (output_bfd, info, h))
9529
9530
95312.17.3.7 ���_bfd_generic_link_hide_symbol���
9532........................................
9533
9534 -- Function: void _bfd_generic_link_hide_symbol (bfd *output_bfd,
9535          struct bfd_link_info *info, struct bfd_link_hash_entry *h);
9536     Hide symbol H.  This is an internal function.  It should not be
9537     called from outside the BFD library.
9538          #define bfd_link_hide_symbol(output_bfd, info, h) \
9539                 BFD_SEND (output_bfd, _bfd_link_hide_symbol, (output_bfd, info, h))
9540
9541
95422.17.3.8 ���bfd_generic_define_start_stop���
9543........................................
9544
9545 -- Function: struct bfd_link_hash_entry *bfd_generic_define_start_stop
9546          (struct bfd_link_info *info, const char *symbol, asection
9547          *sec);
9548     Define a __start, __stop, .startof.  or .sizeof.  symbol.  Return
9549     the symbol or NULL if no such undefined symbol exists.
9550          #define bfd_define_start_stop(output_bfd, info, symbol, sec) \
9551                 BFD_SEND (output_bfd, _bfd_define_start_stop, (info, symbol, sec))
9552
9553
95542.17.3.9 ���bfd_find_version_for_sym���
9555...................................
9556
9557 -- Function: struct bfd_elf_version_tree * bfd_find_version_for_sym
9558          (struct bfd_elf_version_tree *verdefs, const char *sym_name,
9559          bool *hide);
9560     Search an elf version script tree for symbol versioning info and
9561     export / don���t-export status for a given symbol.  Return non-NULL
9562     on success and NULL on failure; also sets the output ���hide��� boolean
9563     parameter.
9564
95652.17.3.10 ���bfd_hide_sym_by_version���
9566...................................
9567
9568 -- Function: bool bfd_hide_sym_by_version (struct bfd_elf_version_tree
9569          *verdefs, const char *sym_name);
9570     Search an elf version script tree for symbol versioning info for a
9571     given symbol.  Return TRUE if the symbol is hidden.
9572
95732.17.3.11 ���bfd_link_check_relocs���
9574.................................
9575
9576 -- Function: bool bfd_link_check_relocs (bfd *abfd, struct
9577          bfd_link_info *info);
9578     Checks the relocs in ABFD for validity.  Does not execute the
9579     relocs.  Return TRUE if everything is OK, FALSE otherwise.  This is
9580     the external entry point to this code.
9581
95822.17.3.12 ���_bfd_generic_link_check_relocs���
9583..........................................
9584
9585 -- Function: bool _bfd_generic_link_check_relocs (bfd *abfd, struct
9586          bfd_link_info *info);
9587     Stub function for targets that do not implement reloc checking.
9588     Return TRUE. This is an internal function.  It should not be called
9589     from outside the BFD library.
9590
95912.17.3.13 ���bfd_merge_private_bfd_data���
9592......................................
9593
9594 -- Function: bool bfd_merge_private_bfd_data (bfd *ibfd, struct
9595          bfd_link_info *info);
9596     Merge private BFD information from the BFD IBFD to the the output
9597     file BFD when linking.  Return ���TRUE��� on success, ���FALSE��� on error.
9598     Possible error returns are:
9599
9600        ��� ���bfd_error_no_memory��� - Not enough memory exists to create
9601          private data for OBFD.
9602          #define bfd_merge_private_bfd_data(ibfd, info) \
9603                 BFD_SEND ((info)->output_bfd, _bfd_merge_private_bfd_data, \
9604                           (ibfd, info))
9605
9606
96072.17.3.14 ���_bfd_generic_verify_endian_match���
9608............................................
9609
9610 -- Function: bool _bfd_generic_verify_endian_match (bfd *ibfd, struct
9611          bfd_link_info *info);
9612     Can be used from / for bfd_merge_private_bfd_data to check that
9613     endianness matches between input and output file.  Returns TRUE for
9614     a match, otherwise returns FALSE and emits an error.
9615
9616
9617File: bfd.info,  Node: Hash Tables,  Prev: Linker Functions,  Up: BFD front end
9618
96192.18 Hash Tables
9620================
9621
9622BFD provides a simple set of hash table functions.  Routines are
9623provided to initialize a hash table, to free a hash table, to look up a
9624string in a hash table and optionally create an entry for it, and to
9625traverse a hash table.  There is currently no routine to delete an
9626string from a hash table.
9627
9628   The basic hash table does not permit any data to be stored with a
9629string.  However, a hash table is designed to present a base class from
9630which other types of hash tables may be derived.  These derived types
9631may store additional information with the string.  Hash tables were
9632implemented in this way, rather than simply providing a data pointer in
9633a hash table entry, because they were designed for use by the linker
9634back ends.  The linker may create thousands of hash table entries, and
9635the overhead of allocating private data and storing and following
9636pointers becomes noticeable.
9637
9638   The basic hash table code is in ���hash.c���.
9639
9640* Menu:
9641
9642* Creating and Freeing a Hash Table::
9643* Looking Up or Entering a String::
9644* Traversing a Hash Table::
9645* Deriving a New Hash Table Type::
9646
9647
9648File: bfd.info,  Node: Creating and Freeing a Hash Table,  Next: Looking Up or Entering a String,  Prev: Hash Tables,  Up: Hash Tables
9649
96502.18.1 Creating and freeing a hash table
9651----------------------------------------
9652
9653To create a hash table, create an instance of a ���struct bfd_hash_table���
9654(defined in ���bfd.h���) and call ���bfd_hash_table_init��� (if you know
9655approximately how many entries you will need, the function
9656���bfd_hash_table_init_n���, which takes a SIZE argument, may be used).
9657���bfd_hash_table_init��� returns ���FALSE��� if some sort of error occurs.
9658
9659   The function ���bfd_hash_table_init��� take as an argument a function to
9660use to create new entries.  For a basic hash table, use the function
9661���bfd_hash_newfunc���.  *Note Deriving a New Hash Table Type::, for why you
9662would want to use a different value for this argument.
9663
9664   ���bfd_hash_table_init��� will create an objalloc which will be used to
9665allocate new entries.  You may allocate memory on this objalloc using
9666���bfd_hash_allocate���.
9667
9668   Use ���bfd_hash_table_free��� to free up all the memory that has been
9669allocated for a hash table.  This will not free up the ���struct
9670bfd_hash_table��� itself, which you must provide.
9671
9672   Use ���bfd_hash_set_default_size��� to set the default size of hash table
9673to use.
9674
9675
9676File: bfd.info,  Node: Looking Up or Entering a String,  Next: Traversing a Hash Table,  Prev: Creating and Freeing a Hash Table,  Up: Hash Tables
9677
96782.18.2 Looking up or entering a string
9679--------------------------------------
9680
9681The function ���bfd_hash_lookup��� is used both to look up a string in the
9682hash table and to create a new entry.
9683
9684   If the CREATE argument is ���FALSE���, ���bfd_hash_lookup��� will look up a
9685string.  If the string is found, it will returns a pointer to a ���struct
9686bfd_hash_entry���.  If the string is not found in the table
9687���bfd_hash_lookup��� will return ���NULL���.  You should not modify any of the
9688fields in the returns ���struct bfd_hash_entry���.
9689
9690   If the CREATE argument is ���TRUE���, the string will be entered into the
9691hash table if it is not already there.  Either way a pointer to a
9692���struct bfd_hash_entry��� will be returned, either to the existing
9693structure or to a newly created one.  In this case, a ���NULL��� return
9694means that an error occurred.
9695
9696   If the CREATE argument is ���TRUE���, and a new entry is created, the
9697COPY argument is used to decide whether to copy the string onto the hash
9698table objalloc or not.  If COPY is passed as ���FALSE���, you must be
9699careful not to deallocate or modify the string as long as the hash table
9700exists.
9701
9702
9703File: bfd.info,  Node: Traversing a Hash Table,  Next: Deriving a New Hash Table Type,  Prev: Looking Up or Entering a String,  Up: Hash Tables
9704
97052.18.3 Traversing a hash table
9706------------------------------
9707
9708The function ���bfd_hash_traverse��� may be used to traverse a hash table,
9709calling a function on each element.  The traversal is done in a random
9710order.
9711
9712   ���bfd_hash_traverse��� takes as arguments a function and a generic ���void
9713*��� pointer.  The function is called with a hash table entry (a ���struct
9714bfd_hash_entry *���) and the generic pointer passed to
9715���bfd_hash_traverse���.  The function must return a ���boolean��� value, which
9716indicates whether to continue traversing the hash table.  If the
9717function returns ���FALSE���, ���bfd_hash_traverse��� will stop the traversal
9718and return immediately.
9719
9720
9721File: bfd.info,  Node: Deriving a New Hash Table Type,  Prev: Traversing a Hash Table,  Up: Hash Tables
9722
97232.18.4 Deriving a new hash table type
9724-------------------------------------
9725
9726Many uses of hash tables want to store additional information which each
9727entry in the hash table.  Some also find it convenient to store
9728additional information with the hash table itself.  This may be done
9729using a derived hash table.
9730
9731   Since C is not an object oriented language, creating a derived hash
9732table requires sticking together some boilerplate routines with a few
9733differences specific to the type of hash table you want to create.
9734
9735   An example of a derived hash table is the linker hash table.  The
9736structures for this are defined in ���bfdlink.h���.  The functions are in
9737���linker.c���.
9738
9739   You may also derive a hash table from an already derived hash table.
9740For example, the a.out linker backend code uses a hash table derived
9741from the linker hash table.
9742
9743* Menu:
9744
9745* Define the Derived Structures::
9746* Write the Derived Creation Routine::
9747* Write Other Derived Routines::
9748
9749
9750File: 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
9751
97522.18.4.1 Define the derived structures
9753......................................
9754
9755You must define a structure for an entry in the hash table, and a
9756structure for the hash table itself.
9757
9758   The first field in the structure for an entry in the hash table must
9759be of the type used for an entry in the hash table you are deriving
9760from.  If you are deriving from a basic hash table this is ���struct
9761bfd_hash_entry���, which is defined in ���bfd.h���.  The first field in the
9762structure for the hash table itself must be of the type of the hash
9763table you are deriving from itself.  If you are deriving from a basic
9764hash table, this is ���struct bfd_hash_table���.
9765
9766   For example, the linker hash table defines ���struct
9767bfd_link_hash_entry��� (in ���bfdlink.h���).  The first field, ���root���, is of
9768type ���struct bfd_hash_entry���.  Similarly, the first field in ���struct
9769bfd_link_hash_table���, ���table���, is of type ���struct bfd_hash_table���.
9770
9771
9772File: 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
9773
97742.18.4.2 Write the derived creation routine
9775...........................................
9776
9777You must write a routine which will create and initialize an entry in
9778the hash table.  This routine is passed as the function argument to
9779���bfd_hash_table_init���.
9780
9781   In order to permit other hash tables to be derived from the hash
9782table you are creating, this routine must be written in a standard way.
9783
9784   The first argument to the creation routine is a pointer to a hash
9785table entry.  This may be ���NULL���, in which case the routine should
9786allocate the right amount of space.  Otherwise the space has already
9787been allocated by a hash table type derived from this one.
9788
9789   After allocating space, the creation routine must call the creation
9790routine of the hash table type it is derived from, passing in a pointer
9791to the space it just allocated.  This will initialize any fields used by
9792the base hash table.
9793
9794   Finally the creation routine must initialize any local fields for the
9795new hash table type.
9796
9797   Here is a boilerplate example of a creation routine.  FUNCTION_NAME
9798is the name of the routine.  ENTRY_TYPE is the type of an entry in the
9799hash table you are creating.  BASE_NEWFUNC is the name of the creation
9800routine of the hash table type your hash table is derived from.
9801
9802     struct bfd_hash_entry *
9803     FUNCTION_NAME (struct bfd_hash_entry *entry,
9804                          struct bfd_hash_table *table,
9805                          const char *string)
9806     {
9807       struct ENTRY_TYPE *ret = (ENTRY_TYPE *) entry;
9808
9809      /* Allocate the structure if it has not already been allocated by a
9810         derived class.  */
9811       if (ret == NULL)
9812         {
9813           ret = bfd_hash_allocate (table, sizeof (* ret));
9814           if (ret == NULL)
9815             return NULL;
9816         }
9817
9818      /* Call the allocation method of the base class.  */
9819       ret = ((ENTRY_TYPE *)
9820              BASE_NEWFUNC ((struct bfd_hash_entry *) ret, table, string));
9821
9822      /* Initialize the local fields here.  */
9823
9824       return (struct bfd_hash_entry *) ret;
9825     }
9826   The creation routine for the linker hash table, which is in
9827���linker.c���, looks just like this example.  FUNCTION_NAME is
9828���_bfd_link_hash_newfunc���.  ENTRY_TYPE is ���struct bfd_link_hash_entry���.
9829BASE_NEWFUNC is ���bfd_hash_newfunc���, the creation routine for a basic
9830hash table.
9831
9832   ���_bfd_link_hash_newfunc��� also initializes the local fields in a
9833linker hash table entry: ���type���, ���written��� and ���next���.
9834
9835
9836File: bfd.info,  Node: Write Other Derived Routines,  Prev: Write the Derived Creation Routine,  Up: Deriving a New Hash Table Type
9837
98382.18.4.3 Write other derived routines
9839.....................................
9840
9841You will want to write other routines for your new hash table, as well.
9842
9843   You will want an initialization routine which calls the
9844initialization routine of the hash table you are deriving from and
9845initializes any other local fields.  For the linker hash table, this is
9846���_bfd_link_hash_table_init��� in ���linker.c���.
9847
9848   You will want a lookup routine which calls the lookup routine of the
9849hash table you are deriving from and casts the result.  The linker hash
9850table uses ���bfd_link_hash_lookup��� in ���linker.c��� (this actually takes an
9851additional argument which it uses to decide how to return the looked up
9852value).
9853
9854   You may want a traversal routine.  This should just call the
9855traversal routine of the hash table you are deriving from with
9856appropriate casts.  The linker hash table uses ���bfd_link_hash_traverse���
9857in ���linker.c���.
9858
9859   These routines may simply be defined as macros.  For example, the
9860a.out backend linker hash table, which is derived from the linker hash
9861table, uses macros for the lookup and traversal routines.  These are
9862���aout_link_hash_lookup��� and ���aout_link_hash_traverse��� in aoutx.h.
9863
98642.18.4.4 ���bfd_hash_table_init_n���
9865................................
9866
9867 -- Function: bool bfd_hash_table_init_n (struct bfd_hash_table *,
9868          struct bfd_hash_entry *(* *newfunc*) (struct bfd_hash_entry *,
9869          struct bfd_hash_table *, const char *), unsigned int
9870          *entsize*, unsigned int *size*);
9871     Create a new hash table, given a number of entries.
9872
98732.18.4.5 ���bfd_hash_table_init���
9874..............................
9875
9876 -- Function: bool bfd_hash_table_init (struct bfd_hash_table *, struct
9877          bfd_hash_entry *(* *newfunc*) (struct bfd_hash_entry *, struct
9878          bfd_hash_table *, const char *), unsigned int *entsize*);
9879     Create a new hash table with the default number of entries.
9880
98812.18.4.6 ���bfd_hash_table_free���
9882..............................
9883
9884 -- Function: void bfd_hash_table_free (struct bfd_hash_table *);
9885     Free a hash table.
9886
98872.18.4.7 ���bfd_hash_lookup���
9888..........................
9889
9890 -- Function: struct bfd_hash_entry *bfd_hash_lookup (struct
9891          bfd_hash_table *, const char *, bool *create*, bool *copy*);
9892     Look up a string in a hash table.
9893
98942.18.4.8 ���bfd_hash_insert���
9895..........................
9896
9897 -- Function: struct bfd_hash_entry *bfd_hash_insert (struct
9898          bfd_hash_table *, const char *, unsigned long *hash*);
9899     Insert an entry in a hash table.
9900
99012.18.4.9 ���bfd_hash_rename���
9902..........................
9903
9904 -- Function: void bfd_hash_rename (struct bfd_hash_table *, const char
9905          *, struct bfd_hash_entry *);
9906     Rename an entry in a hash table.
9907
99082.18.4.10 ���bfd_hash_replace���
9909............................
9910
9911 -- Function: void bfd_hash_replace (struct bfd_hash_table *, struct
9912          bfd_hash_entry * *old*, struct bfd_hash_entry * *new*);
9913     Replace an entry in a hash table.
9914
99152.18.4.11 ���bfd_hash_allocate���
9916.............................
9917
9918 -- Function: void *bfd_hash_allocate (struct bfd_hash_table *, unsigned
9919          int *size*);
9920     Allocate space in a hash table.
9921
99222.18.4.12 ���bfd_hash_newfunc���
9923............................
9924
9925 -- Function: struct bfd_hash_entry *bfd_hash_newfunc (struct
9926          bfd_hash_entry *, struct bfd_hash_table *, const char *);
9927     Base method for creating a new hash table entry.
9928
99292.18.4.13 ���bfd_hash_traverse���
9930.............................
9931
9932 -- Function: void bfd_hash_traverse (struct bfd_hash_table *, bool (*)
9933          (struct bfd_hash_entry *, void *), void *);
9934     Traverse a hash table.
9935
99362.18.4.14 ���bfd_hash_set_default_size���
9937.....................................
9938
9939 -- Function: unsigned int bfd_hash_set_default_size (unsigned int);
9940     Set hash table default size.
9941
99422.18.4.15 ���_bfd_stringtab_init���
9943...............................
9944
9945 -- Function: struct bfd_strtab_hash *_bfd_stringtab_init (void);
9946     Create a new strtab.
9947
99482.18.4.16 ���_bfd_xcoff_stringtab_init���
9949.....................................
9950
9951 -- Function: struct bfd_strtab_hash *_bfd_xcoff_stringtab_init (bool
9952          *isxcoff64*);
9953     Create a new strtab in which the strings are output in the format
9954     used in the XCOFF .debug section: a two byte length precedes each
9955     string.
9956
99572.18.4.17 ���_bfd_stringtab_free���
9958...............................
9959
9960 -- Function: void _bfd_stringtab_free (struct bfd_strtab_hash *);
9961     Free a strtab.
9962
99632.18.4.18 ���_bfd_stringtab_add���
9964..............................
9965
9966 -- Function: bfd_size_type _bfd_stringtab_add (struct bfd_strtab_hash
9967          *, const char *, bool *hash*, bool *copy*);
9968     Get the index of a string in a strtab, adding it if it is not
9969     already present.  If HASH is FALSE, we don���t really use the hash
9970     table, and we don���t eliminate duplicate strings.  If COPY is true
9971     then store a copy of STR if creating a new entry.
9972
99732.18.4.19 ���_bfd_stringtab_size���
9974...............................
9975
9976 -- Function: bfd_size_type _bfd_stringtab_size (struct bfd_strtab_hash
9977          *);
9978     Get the number of bytes in a strtab.
9979
99802.18.4.20 ���_bfd_stringtab_emit���
9981...............................
9982
9983 -- Function: bool _bfd_stringtab_emit (bfd *, struct bfd_strtab_hash
9984          *);
9985     Write out a strtab.  ABFD must already be at the right location in
9986     the file.
9987
9988
9989File: bfd.info,  Node: BFD back ends,  Next: GNU Free Documentation License,  Prev: BFD front end,  Up: Top
9990
99913 BFD back ends
9992***************
9993
9994* Menu:
9995
9996* What to Put Where::
9997* aout ::	a.out backends
9998* coff ::	coff backends
9999* elf  ::	elf backends
10000* mmo  ::	mmo backend
10001
10002
10003File: bfd.info,  Node: What to Put Where,  Next: aout,  Prev: BFD back ends,  Up: BFD back ends
10004
100053.1 What to Put Where
10006=====================
10007
10008All of BFD lives in one directory.
10009
10010
10011File: bfd.info,  Node: aout,  Next: coff,  Prev: What to Put Where,  Up: BFD back ends
10012
100133.2 a.out backends
10014==================
10015
10016BFD supports a number of different flavours of a.out format, though the
10017major differences are only the sizes of the structures on disk, and the
10018shape of the relocation information.
10019
10020   The support is split into a basic support file ���aoutx.h��� and other
10021files which derive functions from the base.  One derivation file is
10022���aoutf1.h��� (for a.out flavour 1), and adds to the basic a.out functions
10023support for sun3, sun4, and 386 a.out files, to create a target jump
10024vector for a specific target.
10025
10026   This information is further split out into more specific files for
10027each machine, including ���sunos.c��� for sun3 and sun4, and ���demo64.c��� for
10028a demonstration of a 64 bit a.out format.
10029
10030   The base file ���aoutx.h��� defines general mechanisms for reading and
10031writing records to and from disk and various other methods which BFD
10032requires.  It is included by ���aout32.c��� and ���aout64.c��� to form the names
10033���aout_32_swap_exec_header_in���, ���aout_64_swap_exec_header_in���, etc.
10034
10035   As an example, this is what goes on to make the back end for a sun4,
10036from ���aout32.c���:
10037
10038            #define ARCH_SIZE 32
10039            #include "aoutx.h"
10040
10041   Which exports names:
10042
10043            ...
10044            aout_32_canonicalize_reloc
10045            aout_32_find_nearest_line
10046            aout_32_get_lineno
10047            aout_32_get_reloc_upper_bound
10048            ...
10049
10050   from ���sunos.c���:
10051
10052            #define TARGET_NAME "a.out-sunos-big"
10053            #define VECNAME    sparc_aout_sunos_be_vec
10054            #include "aoutf1.h"
10055
10056   requires all the names from ���aout32.c���, and produces the jump vector
10057
10058            sparc_aout_sunos_be_vec
10059
10060   The file ���host-aout.c��� is a special case.  It is for a large set of
10061hosts that use ���more or less standard��� a.out files, and for which
10062cross-debugging is not interesting.  It uses the standard 32-bit a.out
10063support routines, but determines the file offsets and addresses of the
10064text, data, and BSS sections, the machine architecture and machine type,
10065and the entry point address, in a host-dependent manner.  Once these
10066values have been determined, generic code is used to handle the object
10067file.
10068
10069   When porting it to run on a new system, you must supply:
10070
10071             HOST_PAGE_SIZE
10072             HOST_SEGMENT_SIZE
10073             HOST_MACHINE_ARCH       (optional)
10074             HOST_MACHINE_MACHINE    (optional)
10075             HOST_TEXT_START_ADDR
10076             HOST_STACK_END_ADDR
10077
10078   in the file ���../include/sys/h-XXX.h��� (for your host).  These values,
10079plus the structures and macros defined in ���a.out.h��� on your host system,
10080will produce a BFD target that will access ordinary a.out files on your
10081host.  To configure a new machine to use ���host-aout.c���, specify:
10082
10083            TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec
10084            TDEPFILES= host-aout.o trad-core.o
10085
10086   in the ���config/XXX.mt��� file, and modify ���configure.ac��� to use the
10087���XXX.mt��� file (by setting "���bfd_target=XXX���") when your configuration is
10088selected.
10089
100903.2.1 Relocations
10091-----------------
10092
10093The file ���aoutx.h��� provides for both the _standard_ and _extended_ forms
10094of a.out relocation records.
10095
10096   The standard records contain only an address, a symbol index, and a
10097type field.  The extended records also have a full integer for an
10098addend.
10099
101003.2.2 Internal entry points
10101---------------------------
10102
10103���aoutx.h��� exports several routines for accessing the contents of an
10104a.out file, which are gathered and exported in turn by various format
10105specific files (eg sunos.c).
10106
101073.2.2.1 ���aout_SIZE_swap_exec_header_in���
10108.......................................
10109
10110 -- Function: void aout_SIZE_swap_exec_header_in, (bfd *abfd, struct
10111          external_exec *bytes, struct internal_exec *execp);
10112     Swap the information in an executable header RAW_BYTES taken from a
10113     raw byte stream memory image into the internal exec header
10114     structure EXECP.
10115
101163.2.2.2 ���aout_SIZE_swap_exec_header_out���
10117........................................
10118
10119 -- Function: void aout_SIZE_swap_exec_header_out (bfd *abfd, struct
10120          internal_exec *execp, struct external_exec *raw_bytes);
10121     Swap the information in an internal exec header structure EXECP
10122     into the buffer RAW_BYTES ready for writing to disk.
10123
101243.2.2.3 ���aout_SIZE_some_aout_object_p���
10125......................................
10126
10127 -- Function: bfd_cleanup aout_SIZE_some_aout_object_p (bfd *abfd,
10128          struct internal_exec *execp, bfd_cleanup
10129          (*callback_to_real_object_p) (bfd *));
10130     Some a.out variant thinks that the file open in ABFD checking is an
10131     a.out file.  Do some more checking, and set up for access if it
10132     really is.  Call back to the calling environment���s "finish up"
10133     function just before returning, to handle any last-minute setup.
10134
101353.2.2.4 ���aout_SIZE_mkobject���
10136............................
10137
10138 -- Function: bool aout_SIZE_mkobject, (bfd *abfd);
10139     Initialize BFD ABFD for use with a.out files.
10140
101413.2.2.5 ���aout_SIZE_machine_type���
10142................................
10143
10144 -- Function: enum machine_type aout_SIZE_machine_type (enum
10145          bfd_architecture arch, unsigned long machine, bool *unknown);
10146     Keep track of machine architecture and machine type for a.out���s.
10147     Return the ���machine_type��� for a particular architecture and
10148     machine, or ���M_UNKNOWN��� if that exact architecture and machine
10149     can���t be represented in a.out format.
10150
10151     If the architecture is understood, machine type 0 (default) is
10152     always understood.
10153
101543.2.2.6 ���aout_SIZE_set_arch_mach���
10155.................................
10156
10157 -- Function: bool aout_SIZE_set_arch_mach, (bfd *, enum
10158          bfd_architecture arch, unsigned long machine);
10159     Set the architecture and the machine of the BFD ABFD to the values
10160     ARCH and MACHINE.  Verify that ABFD���s format can support the
10161     architecture required.
10162
101633.2.2.7 ���aout_SIZE_new_section_hook���
10164....................................
10165
10166 -- Function: bool aout_SIZE_new_section_hook, (bfd *abfd, asection
10167          *newsect);
10168     Called by the BFD in response to a ���bfd_make_section��� request.
10169
10170
10171File: bfd.info,  Node: coff,  Next: elf,  Prev: aout,  Up: BFD back ends
10172
101733.3 coff backends
10174=================
10175
10176BFD supports a number of different flavours of coff format.  The major
10177differences between formats are the sizes and alignments of fields in
10178structures on disk, and the occasional extra field.
10179
10180   Coff in all its varieties is implemented with a few common files and
10181a number of implementation specific files.  For example, the i386 coff
10182format is implemented in the file ���coff-i386.c���.  This file ���#include���s
10183���coff/i386.h��� which defines the external structure of the coff format
10184for the i386, and ���coff/internal.h��� which defines the internal
10185structure.  ���coff-i386.c��� also defines the relocations used by the i386
10186coff format *Note Relocations::.
10187
101883.3.1 Porting to a new version of coff
10189--------------------------------------
10190
10191The recommended method is to select from the existing implementations
10192the version of coff which is most like the one you want to use.  For
10193example, we���ll say that i386 coff is the one you select, and that your
10194coff flavour is called foo.  Copy ���i386coff.c��� to ���foocoff.c���, copy
10195���../include/coff/i386.h��� to ���../include/coff/foo.h���, and add the lines
10196to ���targets.c��� and ���Makefile.in��� so that your new back end is used.
10197Alter the shapes of the structures in ���../include/coff/foo.h��� so that
10198they match what you need.  You will probably also have to add ���#ifdef���s
10199to the code in ���coff/internal.h��� and ���coffcode.h��� if your version of
10200coff is too wild.
10201
10202   You can verify that your new BFD backend works quite simply by
10203building ���objdump��� from the ���binutils��� directory, and making sure that
10204its version of what���s going on and your host system���s idea (assuming it
10205has the pretty standard coff dump utility, usually called ���att-dump��� or
10206just ���dump���) are the same.  Then clean up your code, and send what
10207you���ve done to Cygnus.  Then your stuff will be in the next release, and
10208you won���t have to keep integrating it.
10209
102103.3.2 How the coff backend works
10211--------------------------------
10212
102133.3.2.1 File layout
10214...................
10215
10216The Coff backend is split into generic routines that are applicable to
10217any Coff target and routines that are specific to a particular target.
10218The target-specific routines are further split into ones which are
10219basically the same for all Coff targets except that they use the
10220external symbol format or use different values for certain constants.
10221
10222   The generic routines are in ���coffgen.c���.  These routines work for any
10223Coff target.  They use some hooks into the target specific code; the
10224hooks are in a ���bfd_coff_backend_data��� structure, one of which exists
10225for each target.
10226
10227   The essentially similar target-specific routines are in ���coffcode.h���.
10228This header file includes executable C code.  The various Coff targets
10229first include the appropriate Coff header file, make any special defines
10230that are needed, and then include ���coffcode.h���.
10231
10232   Some of the Coff targets then also have additional routines in the
10233target source file itself.
10234
102353.3.2.2 Coff long section names
10236...............................
10237
10238In the standard Coff object format, section names are limited to the
10239eight bytes available in the ���s_name��� field of the ���SCNHDR��� section
10240header structure.  The format requires the field to be NUL-padded, but
10241not necessarily NUL-terminated, so the longest section names permitted
10242are a full eight characters.
10243
10244   The Microsoft PE variants of the Coff object file format add an
10245extension to support the use of long section names.  This extension is
10246defined in section 4 of the Microsoft PE/COFF specification (rev 8.1).
10247If a section name is too long to fit into the section header���s ���s_name���
10248field, it is instead placed into the string table, and the ���s_name���
10249field is filled with a slash ("/") followed by the ASCII decimal
10250representation of the offset of the full name relative to the string
10251table base.
10252
10253   Note that this implies that the extension can only be used in object
10254files, as executables do not contain a string table.  The standard
10255specifies that long section names from objects emitted into executable
10256images are to be truncated.
10257
10258   However, as a GNU extension, BFD can generate executable images that
10259contain a string table and long section names.  This would appear to be
10260technically valid, as the standard only says that Coff debugging
10261information is deprecated, not forbidden, and in practice it works,
10262although some tools that parse PE files expecting the MS standard format
10263may become confused; ���PEview��� is one known example.
10264
10265   The functionality is supported in BFD by code implemented under the
10266control of the macro ���COFF_LONG_SECTION_NAMES���.  If not defined, the
10267format does not support long section names in any way.  If defined, it
10268is used to initialise a flag, ���_bfd_coff_long_section_names���, and a hook
10269function pointer, ���_bfd_coff_set_long_section_names���, in the Coff
10270backend data structure.  The flag controls the generation of long
10271section names in output BFDs at runtime; if it is false, as it will be
10272by default when generating an executable image, long section names are
10273truncated; if true, the long section names extension is employed.  The
10274hook points to a function that allows the value of a copy of the flag in
10275coff object tdata to be altered at runtime, on formats that support long
10276section names at all; on other formats it points to a stub that returns
10277an error indication.
10278
10279   With input BFDs, the flag is set according to whether any long
10280section names are detected while reading the section headers.  For a
10281completely new BFD, the flag is set to the default for the target
10282format.  This information can be used by a client of the BFD library
10283when deciding what output format to generate, and means that a BFD that
10284is opened for read and subsequently converted to a writeable BFD and
10285modified in-place will retain whatever format it had on input.
10286
10287   If ���COFF_LONG_SECTION_NAMES��� is simply defined (blank), or is defined
10288to the value "1", then long section names are enabled by default; if it
10289is defined to the value zero, they are disabled by default (but still
10290accepted in input BFDs).  The header ���coffcode.h��� defines a macro,
10291���COFF_DEFAULT_LONG_SECTION_NAMES���, which is used in the backends to
10292initialise the backend data structure fields appropriately; see the
10293comments for further detail.
10294
102953.3.2.3 Bit twiddling
10296.....................
10297
10298Each flavour of coff supported in BFD has its own header file describing
10299the external layout of the structures.  There is also an internal
10300description of the coff layout, in ���coff/internal.h���.  A major function
10301of the coff backend is swapping the bytes and twiddling the bits to
10302translate the external form of the structures into the normal internal
10303form.  This is all performed in the ���bfd_swap���_thing_direction routines.
10304Some elements are different sizes between different versions of coff; it
10305is the duty of the coff version specific include file to override the
10306definitions of various packing routines in ���coffcode.h���.  E.g., the size
10307of line number entry in coff is sometimes 16 bits, and sometimes 32
10308bits.  ���#define���ing ���PUT_LNSZ_LNNO��� and ���GET_LNSZ_LNNO��� will select the
10309correct one.  No doubt, some day someone will find a version of coff
10310which has a varying field size not catered to at the moment.  To port
10311BFD, that person will have to add more ���#defines���.  Three of the bit
10312twiddling routines are exported to ���gdb���; ���coff_swap_aux_in���,
10313���coff_swap_sym_in��� and ���coff_swap_lineno_in���.  ���GDB��� reads the symbol
10314table on its own, but uses BFD to fix things up.  More of the bit
10315twiddlers are exported for ���gas���; ���coff_swap_aux_out���,
10316���coff_swap_sym_out���, ���coff_swap_lineno_out���, ���coff_swap_reloc_out���,
10317���coff_swap_filehdr_out���, ���coff_swap_aouthdr_out���,
10318���coff_swap_scnhdr_out���.  ���Gas��� currently keeps track of all the symbol
10319table and reloc drudgery itself, thereby saving the internal BFD
10320overhead, but uses BFD to swap things on the way out, making cross ports
10321much safer.  Doing so also allows BFD (and thus the linker) to use the
10322same header files as ���gas���, which makes one avenue to disaster
10323disappear.
10324
103253.3.2.4 Symbol reading
10326......................
10327
10328The simple canonical form for symbols used by BFD is not rich enough to
10329keep all the information available in a coff symbol table.  The back end
10330gets around this problem by keeping the original symbol table around,
10331"behind the scenes".
10332
10333   When a symbol table is requested (through a call to
10334���bfd_canonicalize_symtab���), a request gets through to
10335���coff_get_normalized_symtab���.  This reads the symbol table from the coff
10336file and swaps all the structures inside into the internal form.  It
10337also fixes up all the pointers in the table (represented in the file by
10338offsets from the first symbol in the table) into physical pointers to
10339elements in the new internal table.  This involves some work since the
10340meanings of fields change depending upon context: a field that is a
10341pointer to another structure in the symbol table at one moment may be
10342the size in bytes of a structure at the next.  Another pass is made over
10343the table.  All symbols which mark file names (���C_FILE��� symbols) are
10344modified so that the internal string points to the value in the auxent
10345(the real filename) rather than the normal text associated with the
10346symbol (���".file"���).
10347
10348   At this time the symbol names are moved around.  Coff stores all
10349symbols less than nine characters long physically within the symbol
10350table; longer strings are kept at the end of the file in the string
10351table.  This pass moves all strings into memory and replaces them with
10352pointers to the strings.
10353
10354   The symbol table is massaged once again, this time to create the
10355canonical table used by the BFD application.  Each symbol is inspected
10356in turn, and a decision made (using the ���sclass��� field) about the
10357various flags to set in the ���asymbol���.  *Note Symbols::.  The generated
10358canonical table shares strings with the hidden internal symbol table.
10359
10360   Any linenumbers are read from the coff file too, and attached to the
10361symbols which own the functions the linenumbers belong to.
10362
103633.3.2.5 Symbol writing
10364......................
10365
10366Writing a symbol to a coff file which didn���t come from a coff file will
10367lose any debugging information.  The ���asymbol��� structure remembers the
10368BFD from which the symbol was taken, and on output the back end makes
10369sure that the same destination target as source target is present.
10370
10371   When the symbols have come from a coff file then all the debugging
10372information is preserved.
10373
10374   Symbol tables are provided for writing to the back end in a vector of
10375pointers to pointers.  This allows applications like the linker to
10376accumulate and output large symbol tables without having to do too much
10377byte copying.
10378
10379   This function runs through the provided symbol table and patches each
10380symbol marked as a file place holder (���C_FILE���) to point to the next
10381file place holder in the list.  It also marks each ���offset��� field in the
10382list with the offset from the first symbol of the current symbol.
10383
10384   Another function of this procedure is to turn the canonical value
10385form of BFD into the form used by coff.  Internally, BFD expects symbol
10386values to be offsets from a section base; so a symbol physically at
103870x120, but in a section starting at 0x100, would have the value 0x20.
10388Coff expects symbols to contain their final value, so symbols have their
10389values changed at this point to reflect their sum with their owning
10390section.  This transformation uses the ���output_section��� field of the
10391���asymbol������s ���asection��� *Note Sections::.
10392
10393   ��� ���coff_mangle_symbols���
10394   This routine runs though the provided symbol table and uses the
10395offsets generated by the previous pass and the pointers generated when
10396the symbol table was read in to create the structured hierarchy required
10397by coff.  It changes each pointer to a symbol into the index into the
10398symbol table of the asymbol.
10399
10400   ��� ���coff_write_symbols���
10401   This routine runs through the symbol table and patches up the symbols
10402from their internal form into the coff way, calls the bit twiddlers, and
10403writes out the table to the file.
10404
104053.3.2.6 ���coff_symbol_type���
10406..........................
10407
10408The hidden information for an ���asymbol��� is described in a
10409���combined_entry_type���:
10410
10411     typedef struct coff_ptr_struct
10412     {
10413       /* Remembers the offset from the first symbol in the file for
10414          this symbol.  Generated by coff_renumber_symbols.  */
10415       unsigned int offset;
10416
10417       /* Selects between the elements of the union below.  */
10418       unsigned int is_sym : 1;
10419
10420       /* Selects between the elements of the x_sym.x_tagndx union.  If set,
10421          p is valid and the field will be renumbered.  */
10422       unsigned int fix_tag : 1;
10423
10424       /* Selects between the elements of the x_sym.x_fcnary.x_fcn.x_endndx
10425          union.  If set, p is valid and the field will be renumbered.  */
10426       unsigned int fix_end : 1;
10427
10428       /* Selects between the elements of the x_csect.x_scnlen union.  If set,
10429          p is valid and the field will be renumbered.  */
10430       unsigned int fix_scnlen : 1;
10431
10432       /* If set, u.syment.n_value contains a pointer to a symbol.  The final
10433          value will be the offset field.  Used for XCOFF C_BSTAT symbols.  */
10434       unsigned int fix_value : 1;
10435
10436       /* If set, u.syment.n_value is an index into the line number entries.
10437          Used for XCOFF C_BINCL/C_EINCL symbols.  */
10438       unsigned int fix_line : 1;
10439
10440       /* The container for the symbol structure as read and translated
10441          from the file.  */
10442       union
10443       {
10444         union internal_auxent auxent;
10445         struct internal_syment syment;
10446       } u;
10447
10448      /* An extra pointer which can used by format based on COFF (like XCOFF)
10449         to provide extra information to their backend.  */
10450      void *extrap;
10451     } combined_entry_type;
10452
10453     /* Each canonical asymbol really looks like this: */
10454
10455     typedef struct coff_symbol_struct
10456     {
10457       /* The actual symbol which the rest of BFD works with */
10458       asymbol symbol;
10459
10460       /* A pointer to the hidden information for this symbol */
10461       combined_entry_type *native;
10462
10463       /* A pointer to the linenumber information for this symbol */
10464       struct lineno_cache_entry *lineno;
10465
10466       /* Have the line numbers been relocated yet ? */
10467       bool done_lineno;
10468     } coff_symbol_type;
10469
10470
104713.3.2.7 ���bfd_coff_backend_data���
10472...............................
10473
10474     typedef struct
10475     {
10476       void (*_bfd_coff_swap_aux_in)
10477         (bfd *, void *, int, int, int, int, void *);
10478
10479       void (*_bfd_coff_swap_sym_in)
10480         (bfd *, void *, void *);
10481
10482       void (*_bfd_coff_swap_lineno_in)
10483         (bfd *, void *, void *);
10484
10485       unsigned int (*_bfd_coff_swap_aux_out)
10486         (bfd *, void *, int, int, int, int, void *);
10487
10488       unsigned int (*_bfd_coff_swap_sym_out)
10489         (bfd *, void *, void *);
10490
10491       unsigned int (*_bfd_coff_swap_lineno_out)
10492         (bfd *, void *, void *);
10493
10494       unsigned int (*_bfd_coff_swap_reloc_out)
10495         (bfd *, void *, void *);
10496
10497       unsigned int (*_bfd_coff_swap_filehdr_out)
10498         (bfd *, void *, void *);
10499
10500       unsigned int (*_bfd_coff_swap_aouthdr_out)
10501         (bfd *, void *, void *);
10502
10503       unsigned int (*_bfd_coff_swap_scnhdr_out)
10504         (bfd *, void *, void *);
10505
10506       unsigned int _bfd_filhsz;
10507       unsigned int _bfd_aoutsz;
10508       unsigned int _bfd_scnhsz;
10509       unsigned int _bfd_symesz;
10510       unsigned int _bfd_auxesz;
10511       unsigned int _bfd_relsz;
10512       unsigned int _bfd_linesz;
10513       unsigned int _bfd_filnmlen;
10514       bool _bfd_coff_long_filenames;
10515
10516       bool _bfd_coff_long_section_names;
10517       bool (*_bfd_coff_set_long_section_names)
10518         (bfd *, int);
10519
10520       unsigned int _bfd_coff_default_section_alignment_power;
10521       bool _bfd_coff_force_symnames_in_strings;
10522       unsigned int _bfd_coff_debug_string_prefix_length;
10523       unsigned int _bfd_coff_max_nscns;
10524
10525       void (*_bfd_coff_swap_filehdr_in)
10526         (bfd *, void *, void *);
10527
10528       void (*_bfd_coff_swap_aouthdr_in)
10529         (bfd *, void *, void *);
10530
10531       void (*_bfd_coff_swap_scnhdr_in)
10532         (bfd *, void *, void *);
10533
10534       void (*_bfd_coff_swap_reloc_in)
10535         (bfd *abfd, void *, void *);
10536
10537       bool (*_bfd_coff_bad_format_hook)
10538         (bfd *, void *);
10539
10540       bool (*_bfd_coff_set_arch_mach_hook)
10541         (bfd *, void *);
10542
10543       void * (*_bfd_coff_mkobject_hook)
10544         (bfd *, void *, void *);
10545
10546       bool (*_bfd_styp_to_sec_flags_hook)
10547         (bfd *, void *, const char *, asection *, flagword *);
10548
10549       void (*_bfd_set_alignment_hook)
10550         (bfd *, asection *, void *);
10551
10552       bool (*_bfd_coff_slurp_symbol_table)
10553         (bfd *);
10554
10555       bool (*_bfd_coff_symname_in_debug)
10556         (bfd *, struct internal_syment *);
10557
10558       bool (*_bfd_coff_pointerize_aux_hook)
10559         (bfd *, combined_entry_type *, combined_entry_type *,
10560          unsigned int, combined_entry_type *);
10561
10562       bool (*_bfd_coff_print_aux)
10563         (bfd *, FILE *, combined_entry_type *, combined_entry_type *,
10564          combined_entry_type *, unsigned int);
10565
10566       bool (*_bfd_coff_reloc16_extra_cases)
10567         (bfd *, struct bfd_link_info *, struct bfd_link_order *, arelent *,
10568          bfd_byte *, size_t *, size_t *);
10569
10570       int (*_bfd_coff_reloc16_estimate)
10571         (bfd *, asection *, arelent *, unsigned int,
10572          struct bfd_link_info *);
10573
10574       enum coff_symbol_classification (*_bfd_coff_classify_symbol)
10575         (bfd *, struct internal_syment *);
10576
10577       bool (*_bfd_coff_compute_section_file_positions)
10578         (bfd *);
10579
10580       bool (*_bfd_coff_start_final_link)
10581         (bfd *, struct bfd_link_info *);
10582
10583       bool (*_bfd_coff_relocate_section)
10584         (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
10585          struct internal_reloc *, struct internal_syment *, asection **);
10586
10587       reloc_howto_type *(*_bfd_coff_rtype_to_howto)
10588         (bfd *, asection *, struct internal_reloc *,
10589          struct coff_link_hash_entry *, struct internal_syment *, bfd_vma *);
10590
10591       bool (*_bfd_coff_adjust_symndx)
10592         (bfd *, struct bfd_link_info *, bfd *, asection *,
10593          struct internal_reloc *, bool *);
10594
10595       bool (*_bfd_coff_link_add_one_symbol)
10596         (struct bfd_link_info *, bfd *, const char *, flagword,
10597          asection *, bfd_vma, const char *, bool, bool,
10598          struct bfd_link_hash_entry **);
10599
10600       bool (*_bfd_coff_link_output_has_begun)
10601         (bfd *, struct coff_final_link_info *);
10602
10603       bool (*_bfd_coff_final_link_postscript)
10604         (bfd *, struct coff_final_link_info *);
10605
10606       bool (*_bfd_coff_print_pdata)
10607         (bfd *, void *);
10608
10609     } bfd_coff_backend_data;
10610
10611
106123.3.2.8 Writing relocations
10613...........................
10614
10615To write relocations, the back end steps though the canonical relocation
10616table and create an ���internal_reloc���.  The symbol index to use is
10617removed from the ���offset��� field in the symbol table supplied.  The
10618address comes directly from the sum of the section base address and the
10619relocation offset; the type is dug directly from the howto field.  Then
10620the ���internal_reloc��� is swapped into the shape of an ���external_reloc���
10621and written out to disk.
10622
106233.3.2.9 Reading linenumbers
10624...........................
10625
10626Creating the linenumber table is done by reading in the entire coff
10627linenumber table, and creating another table for internal use.
10628
10629   A coff linenumber table is structured so that each function is marked
10630as having a line number of 0.  Each line within the function is an
10631offset from the first line in the function.  The base of the line number
10632information for the table is stored in the symbol associated with the
10633function.
10634
10635   Note: The PE format uses line number 0 for a flag indicating a new
10636source file.
10637
10638   The information is copied from the external to the internal table,
10639and each symbol which marks a function is marked by pointing its...
10640
10641   How does this work ?
10642
106433.3.2.10 Reading relocations
10644............................
10645
10646Coff relocations are easily transformed into the internal BFD form
10647(���arelent���).
10648
10649   Reading a coff relocation table is done in the following stages:
10650
10651   ��� Read the entire coff relocation table into memory.
10652
10653   ��� Process each relocation in turn; first swap it from the external to
10654     the internal form.
10655
10656   ��� Turn the symbol referenced in the relocation���s symbol index into a
10657     pointer into the canonical symbol table.  This table is the same as
10658     the one returned by a call to ���bfd_canonicalize_symtab���.  The back
10659     end will call that routine and save the result if a
10660     canonicalization hasn���t been done.
10661
10662   ��� The reloc index is turned into a pointer to a howto structure, in a
10663     back end specific way.  For instance, the 386 uses the ���r_type��� to
10664     directly produce an index into a howto table vector.
10665
10666   ��� Note that ���arelent.addend��� for COFF is often not what most people
10667     understand as a relocation addend, but rather an adjustment to the
10668     relocation addend stored in section contents of relocatable object
10669     files.  The value found in section contents may also be confusing,
10670     depending on both symbol value and addend somewhat similar to the
10671     field value for a final-linked object.  See ���CALC_ADDEND���.
10672
10673
10674File: bfd.info,  Node: elf,  Next: mmo,  Prev: coff,  Up: BFD back ends
10675
106763.4 ELF backends
10677================
10678
10679BFD support for ELF formats is being worked on.  Currently, the best
10680supported back ends are for sparc and i386 (running svr4 or Solaris 2).
10681
10682   Documentation of the internals of the support code still needs to be
10683written.  The code is changing quickly enough that we haven���t bothered
10684yet.
10685
10686
10687File: bfd.info,  Node: mmo,  Prev: elf,  Up: BFD back ends
10688
106893.5 mmo backend
10690===============
10691
10692The mmo object format is used exclusively together with Professor Donald
10693E. Knuth���s educational 64-bit processor MMIX. The simulator ���mmix��� which
10694is available at <http://mmix.cs.hm.edu/src/index.html> understands this
10695format.  That package also includes a combined assembler and linker
10696called ���mmixal���.  The mmo format has no advantages feature-wise compared
10697to e.g.  ELF. It is a simple non-relocatable object format with no
10698support for archives or debugging information, except for symbol value
10699information and line numbers (which is not yet implemented in BFD). See
10700<http://mmix.cs.hm.edu/> for more information about MMIX. The ELF format
10701is used for intermediate object files in the BFD implementation.
10702
10703* Menu:
10704
10705* File layout::
10706* Symbol-table::
10707* mmo section mapping::
10708
10709
10710File: bfd.info,  Node: File layout,  Next: Symbol-table,  Prev: mmo,  Up: mmo
10711
107123.5.1 File layout
10713-----------------
10714
10715The mmo file contents is not partitioned into named sections as with
10716e.g. ELF. Memory areas is formed by specifying the location of the data
10717that follows.  Only the memory area ���0x0000...00��� to ���0x01ff...ff��� is
10718executable, so it is used for code (and constants) and the area
10719���0x2000...00��� to ���0x20ff...ff��� is used for writable data.  *Note mmo
10720section mapping::.
10721
10722   There is provision for specifying ���special data��� of 65536 different
10723types.  We use type 80 (decimal), arbitrarily chosen the same as the ELF
10724���e_machine��� number for MMIX, filling it with section information
10725normally found in ELF objects.  *Note mmo section mapping::.
10726
10727   Contents is entered as 32-bit words, xor:ed over previous contents,
10728always zero-initialized.  A word that starts with the byte ���0x98��� forms
10729a command called a ���lopcode���, where the next byte distinguished between
10730the thirteen lopcodes.  The two remaining bytes, called the ���Y��� and ���Z���
10731fields, or the ���YZ��� field (a 16-bit big-endian number), are used for
10732various purposes different for each lopcode.  As documented in
10733<http://mmix.cs.hm.edu/doc/mmixal.pdf>, the lopcodes are:
10734
10735���lop_quote���
10736     0x98000001.  The next word is contents, regardless of whether it
10737     starts with 0x98 or not.
10738
10739���lop_loc���
10740     0x9801YYZZ, where ���Z��� is 1 or 2.  This is a location directive,
10741     setting the location for the next data to the next 32-bit word (for
10742     Z = 1) or 64-bit word (for Z = 2), plus Y * 2^56.  Normally ���Y��� is
10743     0 for the text segment and 2 for the data segment.  Beware that the
10744     low bits of non- tetrabyte-aligned values are silently discarded
10745     when being automatically incremented and when storing contents (in
10746     contrast to e.g.  its use as current location when followed by
10747     lop_fixo et al before the next possibly-quoted tetrabyte contents).
10748
10749���lop_skip���
10750     0x9802YYZZ. Increase the current location by ���YZ��� bytes.
10751
10752���lop_fixo���
10753     0x9803YYZZ, where ���Z��� is 1 or 2.  Store the current location as 64
10754     bits into the location pointed to by the next 32-bit (Z = 1) or
10755     64-bit (Z = 2) word, plus Y * 2^56.
10756
10757���lop_fixr���
10758     0x9804YYZZ. ���YZ��� is stored into the current location plus 2 - 4 *
10759     YZ.
10760
10761���lop_fixrx���
10762     0x980500ZZ. ���Z��� is 16 or 24.  A value ���L��� derived from the
10763     following 32-bit word are used in a manner similar to ���YZ��� in
10764     lop_fixr: it is xor:ed into the current location minus 4 * L. The
10765     first byte of the word is 0 or 1.  If it is 1, then L = (LOWEST 24
10766     BITS OF WORD) - 2^Z, if 0, then L = (LOWEST 24 BITS OF WORD).
10767
10768���lop_file���
10769     0x9806YYZZ. ���Y��� is the file number, ���Z��� is count of 32-bit words.
10770     Set the file number to ���Y��� and the line counter to 0.  The next Z *
10771     4 bytes contain the file name, padded with zeros if the count is
10772     not a multiple of four.  The same ���Y��� may occur multiple times, but
10773     ���Z��� must be 0 for all but the first occurrence.
10774
10775���lop_line���
10776     0x9807YYZZ. ���YZ��� is the line number.  Together with lop_file, it
10777     forms the source location for the next 32-bit word.  Note that for
10778     each non-lopcode 32-bit word, line numbers are assumed incremented
10779     by one.
10780
10781���lop_spec���
10782     0x9808YYZZ. ���YZ��� is the type number.  Data until the next lopcode
10783     other than lop_quote forms special data of type ���YZ���.  *Note mmo
10784     section mapping::.
10785
10786     Other types than 80, (or type 80 with a content that does not
10787     parse) is stored in sections named ���.MMIX.spec_data.N��� where N is
10788     the ���YZ���-type.  The flags for such a sections say not to allocate
10789     or load the data.  The vma is 0.  Contents of multiple occurrences
10790     of special data N is concatenated to the data of the previous
10791     lop_spec Ns.  The location in data or code at which the lop_spec
10792     occurred is lost.
10793
10794���lop_pre���
10795     0x980901ZZ. The first lopcode in a file.  The ���Z��� field forms the
10796     length of header information in 32-bit words, where the first word
10797     tells the time in seconds since ���00:00:00 GMT Jan 1 1970���.
10798
10799���lop_post���
10800     0x980a00ZZ. Z > 32.  This lopcode follows after all
10801     content-generating lopcodes in a program.  The ���Z��� field denotes
10802     the value of ���rG��� at the beginning of the program.  The following
10803     256 - Z big-endian 64-bit words are loaded into global registers
10804     ���$G��� ... ���$255���.
10805
10806���lop_stab���
10807     0x980b0000.  The next-to-last lopcode in a program.  Must follow
10808     immediately after the lop_post lopcode and its data.  After this
10809     lopcode follows all symbols in a compressed format (*note
10810     Symbol-table::).
10811
10812���lop_end���
10813     0x980cYYZZ. The last lopcode in a program.  It must follow the
10814     lop_stab lopcode and its data.  The ���YZ��� field contains the number
10815     of 32-bit words of symbol table information after the preceding
10816     lop_stab lopcode.
10817
10818   Note that the lopcode "fixups"; ���lop_fixr���, ���lop_fixrx��� and
10819���lop_fixo��� are not generated by BFD, but are handled.  They are
10820generated by ���mmixal���.
10821
10822   This trivial one-label, one-instruction file:
10823
10824      :Main TRAP 1,2,3
10825
10826   can be represented this way in mmo:
10827
10828      0x98090101 - lop_pre, one 32-bit word with timestamp.
10829      <timestamp>
10830      0x98010002 - lop_loc, text segment, using a 64-bit address.
10831                   Note that mmixal does not emit this for the file above.
10832      0x00000000 - Address, high 32 bits.
10833      0x00000000 - Address, low 32 bits.
10834      0x98060002 - lop_file, 2 32-bit words for file-name.
10835      0x74657374 - "test"
10836      0x2e730000 - ".s\0\0"
10837      0x98070001 - lop_line, line 1.
10838      0x00010203 - TRAP 1,2,3
10839      0x980a00ff - lop_post, setting $255 to 0.
10840      0x00000000
10841      0x00000000
10842      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
10843      0x203a4040   *Note Symbol-table::.
10844      0x10404020
10845      0x4d206120
10846      0x69016e00
10847      0x81000000
10848      0x980c0005 - lop_end; symbol table contained five 32-bit words.
10849
10850
10851File: bfd.info,  Node: Symbol-table,  Next: mmo section mapping,  Prev: File layout,  Up: mmo
10852
108533.5.2 Symbol table format
10854-------------------------
10855
10856From mmixal.w (or really, the generated mmixal.tex) in the MMIXware
10857package which also contains the ���mmix��� simulator: ���Symbols are stored
10858and retrieved by means of a ���ternary search trie���, following ideas of
10859Bentley and Sedgewick.  (See ACM���SIAM Symp. on Discrete Algorithms ���8���
10860(1997), 360���369; R.Sedgewick, ���Algorithms in C��� (Reading, Mass.
10861Addison���Wesley, 1998), ���15.4���.)  Each trie node stores a character, and
10862there are branches to subtries for the cases where a given character is
10863less than, equal to, or greater than the character in the trie.  There
10864also is a pointer to a symbol table entry if a symbol ends at the
10865current node.���
10866
10867   So it���s a tree encoded as a stream of bytes.  The stream of bytes
10868acts on a single virtual global symbol, adding and removing characters
10869and signalling complete symbol points.  Here, we read the stream and
10870create symbols at the completion points.
10871
10872   First, there���s a control byte ���m���.  If any of the listed bits in ���m���
10873is nonzero, we execute what stands at the right, in the listed order:
10874
10875      (MMO3_LEFT)
10876      0x40 - Traverse left trie.
10877             (Read a new command byte and recurse.)
10878
10879      (MMO3_SYMBITS)
10880      0x2f - Read the next byte as a character and store it in the
10881             current character position; increment character position.
10882             Test the bits of m:
10883
10884             (MMO3_WCHAR)
10885             0x80 - The character is 16-bit (so read another byte,
10886                    merge into current character.
10887
10888             (MMO3_TYPEBITS)
10889             0xf  - We have a complete symbol; parse the type, value
10890                    and serial number and do what should be done
10891                    with a symbol.  The type and length information
10892                    is in j = (m & 0xf).
10893
10894                    (MMO3_REGQUAL_BITS)
10895                    j == 0xf: A register variable.  The following
10896                              byte tells which register.
10897                    j <= 8:   An absolute symbol.  Read j bytes as the
10898                              big-endian number the symbol equals.
10899                              A j = 2 with two zero bytes denotes an
10900                              unknown symbol.
10901                    j > 8:    As with j <= 8, but add (0x20 << 56)
10902                              to the value in the following j - 8
10903                              bytes.
10904
10905                    Then comes the serial number, as a variant of
10906                    uleb128, but better named ubeb128:
10907                    Read bytes and shift the previous value left 7
10908                    (multiply by 128).  Add in the new byte, repeat
10909                    until a byte has bit 7 set.  The serial number
10910                    is the computed value minus 128.
10911
10912             (MMO3_MIDDLE)
10913             0x20 - Traverse middle trie.  (Read a new command byte
10914                    and recurse.)  Decrement character position.
10915
10916      (MMO3_RIGHT)
10917      0x10 - Traverse right trie.  (Read a new command byte and
10918             recurse.)
10919
10920   Let���s look again at the ���lop_stab��� for the trivial file (*note File
10921layout::).
10922
10923      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
10924      0x203a4040
10925      0x10404020
10926      0x4d206120
10927      0x69016e00
10928      0x81000000
10929
10930   This forms the trivial trie (note that the path between ���:��� and ���M���
10931is redundant):
10932
10933      203a     ":"
10934      40       /
10935      40      /
10936      10      \
10937      40      /
10938      40     /
10939      204d  "M"
10940      2061  "a"
10941      2069  "i"
10942      016e  "n" is the last character in a full symbol, and
10943            with a value represented in one byte.
10944      00    The value is 0.
10945      81    The serial number is 1.
10946
10947
10948File: bfd.info,  Node: mmo section mapping,  Prev: Symbol-table,  Up: mmo
10949
109503.5.3 mmo section mapping
10951-------------------------
10952
10953The implementation in BFD uses special data type 80 (decimal) to
10954encapsulate and describe named sections, containing e.g. debug
10955information.  If needed, any datum in the encapsulation will be quoted
10956using lop_quote.  First comes a 32-bit word holding the number of 32-bit
10957words containing the zero-terminated zero-padded segment name.  After
10958the name there���s a 32-bit word holding flags describing the section
10959type.  Then comes a 64-bit big-endian word with the section length (in
10960bytes), then another with the section start address.  Depending on the
10961type of section, the contents might follow, zero-padded to 32-bit
10962boundary.  For a loadable section (such as data or code), the contents
10963might follow at some later point, not necessarily immediately, as a
10964lop_loc with the same start address as in the section description,
10965followed by the contents.  This in effect forms a descriptor that must
10966be emitted before the actual contents.  Sections described this way must
10967not overlap.
10968
10969   For areas that don���t have such descriptors, synthetic sections are
10970formed by BFD. Consecutive contents in the two memory areas
10971���0x0000...00��� to ���0x01ff...ff��� and ���0x2000...00��� to ���0x20ff...ff��� are
10972entered in sections named ���.text��� and ���.data��� respectively.  If an area
10973is not otherwise described, but would together with a neighboring lower
10974area be less than ���0x40000000��� bytes long, it is joined with the lower
10975area and the gap is zero-filled.  For other cases, a new section is
10976formed, named ���.MMIX.sec.N���.  Here, N is a number, a running count
10977through the mmo file, starting at 0.
10978
10979   A loadable section specified as:
10980
10981      .section secname,"ax"
10982      TETRA 1,2,3,4,-1,-2009
10983      BYTE 80
10984
10985   and linked to address ���0x4���, is represented by the sequence:
10986
10987      0x98080050 - lop_spec 80
10988      0x00000002 - two 32-bit words for the section name
10989      0x7365636e - "secn"
10990      0x616d6500 - "ame\0"
10991      0x00000033 - flags CODE, READONLY, LOAD, ALLOC
10992      0x00000000 - high 32 bits of section length
10993      0x0000001c - section length is 28 bytes; 6 * 4 + 1 + alignment to 32 bits
10994      0x00000000 - high 32 bits of section address
10995      0x00000004 - section address is 4
10996      0x98010002 - 64 bits with address of following data
10997      0x00000000 - high 32 bits of address
10998      0x00000004 - low 32 bits: data starts at address 4
10999      0x00000001 - 1
11000      0x00000002 - 2
11001      0x00000003 - 3
11002      0x00000004 - 4
11003      0xffffffff - -1
11004      0xfffff827 - -2009
11005      0x50000000 - 80 as a byte, padded with zeros.
11006
11007   Note that the lop_spec wrapping does not include the section
11008contents.  Compare this to a non-loaded section specified as:
11009
11010      .section thirdsec
11011      TETRA 200001,100002
11012      BYTE 38,40
11013
11014   This, when linked to address ���0x200000000000001c���, is represented by:
11015
11016      0x98080050 - lop_spec 80
11017      0x00000002 - two 32-bit words for the section name
11018      0x7365636e - "thir"
11019      0x616d6500 - "dsec"
11020      0x00000010 - flag READONLY
11021      0x00000000 - high 32 bits of section length
11022      0x0000000c - section length is 12 bytes; 2 * 4 + 2 + alignment to 32 bits
11023      0x20000000 - high 32 bits of address
11024      0x0000001c - low 32 bits of address 0x200000000000001c
11025      0x00030d41 - 200001
11026      0x000186a2 - 100002
11027      0x26280000 - 38, 40 as bytes, padded with zeros
11028
11029   For the latter example, the section contents must not be loaded in
11030memory, and is therefore specified as part of the special data.  The
11031address is usually unimportant but might provide information for e.g.
11032the DWARF 2 debugging format.
11033
11034
11035File: bfd.info,  Node: GNU Free Documentation License,  Next: BFD Index,  Prev: BFD back ends,  Up: Top
11036
11037                     Version 1.3, 3 November 2008
11038
11039     Copyright �� 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
11040     <http://fsf.org/>
11041
11042     Everyone is permitted to copy and distribute verbatim copies
11043     of this license document, but changing it is not allowed.
11044
11045  0. PREAMBLE
11046
11047     The purpose of this License is to make a manual, textbook, or other
11048     functional and useful document ���free��� in the sense of freedom: to
11049     assure everyone the effective freedom to copy and redistribute it,
11050     with or without modifying it, either commercially or
11051     noncommercially.  Secondarily, this License preserves for the
11052     author and publisher a way to get credit for their work, while not
11053     being considered responsible for modifications made by others.
11054
11055     This License is a kind of ���copyleft���, which means that derivative
11056     works of the document must themselves be free in the same sense.
11057     It complements the GNU General Public License, which is a copyleft
11058     license designed for free software.
11059
11060     We have designed this License in order to use it for manuals for
11061     free software, because free software needs free documentation: a
11062     free program should come with manuals providing the same freedoms
11063     that the software does.  But this License is not limited to
11064     software manuals; it can be used for any textual work, regardless
11065     of subject matter or whether it is published as a printed book.  We
11066     recommend this License principally for works whose purpose is
11067     instruction or reference.
11068
11069  1. APPLICABILITY AND DEFINITIONS
11070
11071     This License applies to any manual or other work, in any medium,
11072     that contains a notice placed by the copyright holder saying it can
11073     be distributed under the terms of this License.  Such a notice
11074     grants a world-wide, royalty-free license, unlimited in duration,
11075     to use that work under the conditions stated herein.  The
11076     ���Document���, below, refers to any such manual or work.  Any member
11077     of the public is a licensee, and is addressed as ���you���.  You accept
11078     the license if you copy, modify or distribute the work in a way
11079     requiring permission under copyright law.
11080
11081     A ���Modified Version��� of the Document means any work containing the
11082     Document or a portion of it, either copied verbatim, or with
11083     modifications and/or translated into another language.
11084
11085     A ���Secondary Section��� is a named appendix or a front-matter section
11086     of the Document that deals exclusively with the relationship of the
11087     publishers or authors of the Document to the Document���s overall
11088     subject (or to related matters) and contains nothing that could
11089     fall directly within that overall subject.  (Thus, if the Document
11090     is in part a textbook of mathematics, a Secondary Section may not
11091     explain any mathematics.)  The relationship could be a matter of
11092     historical connection with the subject or with related matters, or
11093     of legal, commercial, philosophical, ethical or political position
11094     regarding them.
11095
11096     The ���Invariant Sections��� are certain Secondary Sections whose
11097     titles are designated, as being those of Invariant Sections, in the
11098     notice that says that the Document is released under this License.
11099     If a section does not fit the above definition of Secondary then it
11100     is not allowed to be designated as Invariant.  The Document may
11101     contain zero Invariant Sections.  If the Document does not identify
11102     any Invariant Sections then there are none.
11103
11104     The ���Cover Texts��� are certain short passages of text that are
11105     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
11106     that says that the Document is released under this License.  A
11107     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
11108     be at most 25 words.
11109
11110     A ���Transparent��� copy of the Document means a machine-readable copy,
11111     represented in a format whose specification is available to the
11112     general public, that is suitable for revising the document
11113     straightforwardly with generic text editors or (for images composed
11114     of pixels) generic paint programs or (for drawings) some widely
11115     available drawing editor, and that is suitable for input to text
11116     formatters or for automatic translation to a variety of formats
11117     suitable for input to text formatters.  A copy made in an otherwise
11118     Transparent file format whose markup, or absence of markup, has
11119     been arranged to thwart or discourage subsequent modification by
11120     readers is not Transparent.  An image format is not Transparent if
11121     used for any substantial amount of text.  A copy that is not
11122     ���Transparent��� is called ���Opaque���.
11123
11124     Examples of suitable formats for Transparent copies include plain
11125     ASCII without markup, Texinfo input format, LaTeX input format,
11126     SGML or XML using a publicly available DTD, and standard-conforming
11127     simple HTML, PostScript or PDF designed for human modification.
11128     Examples of transparent image formats include PNG, XCF and JPG.
11129     Opaque formats include proprietary formats that can be read and
11130     edited only by proprietary word processors, SGML or XML for which
11131     the DTD and/or processing tools are not generally available, and
11132     the machine-generated HTML, PostScript or PDF produced by some word
11133     processors for output purposes only.
11134
11135     The ���Title Page��� means, for a printed book, the title page itself,
11136     plus such following pages as are needed to hold, legibly, the
11137     material this License requires to appear in the title page.  For
11138     works in formats which do not have any title page as such, ���Title
11139     Page��� means the text near the most prominent appearance of the
11140     work���s title, preceding the beginning of the body of the text.
11141
11142     The ���publisher��� means any person or entity that distributes copies
11143     of the Document to the public.
11144
11145     A section ���Entitled XYZ��� means a named subunit of the Document
11146     whose title either is precisely XYZ or contains XYZ in parentheses
11147     following text that translates XYZ in another language.  (Here XYZ
11148     stands for a specific section name mentioned below, such as
11149     ���Acknowledgements���, ���Dedications���, ���Endorsements���, or ���History���.)
11150     To ���Preserve the Title��� of such a section when you modify the
11151     Document means that it remains a section ���Entitled XYZ��� according
11152     to this definition.
11153
11154     The Document may include Warranty Disclaimers next to the notice
11155     which states that this License applies to the Document.  These
11156     Warranty Disclaimers are considered to be included by reference in
11157     this License, but only as regards disclaiming warranties: any other
11158     implication that these Warranty Disclaimers may have is void and
11159     has no effect on the meaning of this License.
11160
11161  2. VERBATIM COPYING
11162
11163     You may copy and distribute the Document in any medium, either
11164     commercially or noncommercially, provided that this License, the
11165     copyright notices, and the license notice saying this License
11166     applies to the Document are reproduced in all copies, and that you
11167     add no other conditions whatsoever to those of this License.  You
11168     may not use technical measures to obstruct or control the reading
11169     or further copying of the copies you make or distribute.  However,
11170     you may accept compensation in exchange for copies.  If you
11171     distribute a large enough number of copies you must also follow the
11172     conditions in section 3.
11173
11174     You may also lend copies, under the same conditions stated above,
11175     and you may publicly display copies.
11176
11177  3. COPYING IN QUANTITY
11178
11179     If you publish printed copies (or copies in media that commonly
11180     have printed covers) of the Document, numbering more than 100, and
11181     the Document���s license notice requires Cover Texts, you must
11182     enclose the copies in covers that carry, clearly and legibly, all
11183     these Cover Texts: Front-Cover Texts on the front cover, and
11184     Back-Cover Texts on the back cover.  Both covers must also clearly
11185     and legibly identify you as the publisher of these copies.  The
11186     front cover must present the full title with all words of the title
11187     equally prominent and visible.  You may add other material on the
11188     covers in addition.  Copying with changes limited to the covers, as
11189     long as they preserve the title of the Document and satisfy these
11190     conditions, can be treated as verbatim copying in other respects.
11191
11192     If the required texts for either cover are too voluminous to fit
11193     legibly, you should put the first ones listed (as many as fit
11194     reasonably) on the actual cover, and continue the rest onto
11195     adjacent pages.
11196
11197     If you publish or distribute Opaque copies of the Document
11198     numbering more than 100, you must either include a machine-readable
11199     Transparent copy along with each Opaque copy, or state in or with
11200     each Opaque copy a computer-network location from which the general
11201     network-using public has access to download using public-standard
11202     network protocols a complete Transparent copy of the Document, free
11203     of added material.  If you use the latter option, you must take
11204     reasonably prudent steps, when you begin distribution of Opaque
11205     copies in quantity, to ensure that this Transparent copy will
11206     remain thus accessible at the stated location until at least one
11207     year after the last time you distribute an Opaque copy (directly or
11208     through your agents or retailers) of that edition to the public.
11209
11210     It is requested, but not required, that you contact the authors of
11211     the Document well before redistributing any large number of copies,
11212     to give them a chance to provide you with an updated version of the
11213     Document.
11214
11215  4. MODIFICATIONS
11216
11217     You may copy and distribute a Modified Version of the Document
11218     under the conditions of sections 2 and 3 above, provided that you
11219     release the Modified Version under precisely this License, with the
11220     Modified Version filling the role of the Document, thus licensing
11221     distribution and modification of the Modified Version to whoever
11222     possesses a copy of it.  In addition, you must do these things in
11223     the Modified Version:
11224
11225       A. Use in the Title Page (and on the covers, if any) a title
11226          distinct from that of the Document, and from those of previous
11227          versions (which should, if there were any, be listed in the
11228          History section of the Document).  You may use the same title
11229          as a previous version if the original publisher of that
11230          version gives permission.
11231
11232       B. List on the Title Page, as authors, one or more persons or
11233          entities responsible for authorship of the modifications in
11234          the Modified Version, together with at least five of the
11235          principal authors of the Document (all of its principal
11236          authors, if it has fewer than five), unless they release you
11237          from this requirement.
11238
11239       C. State on the Title page the name of the publisher of the
11240          Modified Version, as the publisher.
11241
11242       D. Preserve all the copyright notices of the Document.
11243
11244       E. Add an appropriate copyright notice for your modifications
11245          adjacent to the other copyright notices.
11246
11247       F. Include, immediately after the copyright notices, a license
11248          notice giving the public permission to use the Modified
11249          Version under the terms of this License, in the form shown in
11250          the Addendum below.
11251
11252       G. Preserve in that license notice the full lists of Invariant
11253          Sections and required Cover Texts given in the Document���s
11254          license notice.
11255
11256       H. Include an unaltered copy of this License.
11257
11258       I. Preserve the section Entitled ���History���, Preserve its Title,
11259          and add to it an item stating at least the title, year, new
11260          authors, and publisher of the Modified Version as given on the
11261          Title Page.  If there is no section Entitled ���History��� in the
11262          Document, create one stating the title, year, authors, and
11263          publisher of the Document as given on its Title Page, then add
11264          an item describing the Modified Version as stated in the
11265          previous sentence.
11266
11267       J. Preserve the network location, if any, given in the Document
11268          for public access to a Transparent copy of the Document, and
11269          likewise the network locations given in the Document for
11270          previous versions it was based on.  These may be placed in the
11271          ���History��� section.  You may omit a network location for a work
11272          that was published at least four years before the Document
11273          itself, or if the original publisher of the version it refers
11274          to gives permission.
11275
11276       K. For any section Entitled ���Acknowledgements��� or ���Dedications���,
11277          Preserve the Title of the section, and preserve in the section
11278          all the substance and tone of each of the contributor
11279          acknowledgements and/or dedications given therein.
11280
11281       L. Preserve all the Invariant Sections of the Document, unaltered
11282          in their text and in their titles.  Section numbers or the
11283          equivalent are not considered part of the section titles.
11284
11285       M. Delete any section Entitled ���Endorsements���.  Such a section
11286          may not be included in the Modified Version.
11287
11288       N. Do not retitle any existing section to be Entitled
11289          ���Endorsements��� or to conflict in title with any Invariant
11290          Section.
11291
11292       O. Preserve any Warranty Disclaimers.
11293
11294     If the Modified Version includes new front-matter sections or
11295     appendices that qualify as Secondary Sections and contain no
11296     material copied from the Document, you may at your option designate
11297     some or all of these sections as invariant.  To do this, add their
11298     titles to the list of Invariant Sections in the Modified Version���s
11299     license notice.  These titles must be distinct from any other
11300     section titles.
11301
11302     You may add a section Entitled ���Endorsements���, provided it contains
11303     nothing but endorsements of your Modified Version by various
11304     parties���for example, statements of peer review or that the text has
11305     been approved by an organization as the authoritative definition of
11306     a standard.
11307
11308     You may add a passage of up to five words as a Front-Cover Text,
11309     and a passage of up to 25 words as a Back-Cover Text, to the end of
11310     the list of Cover Texts in the Modified Version.  Only one passage
11311     of Front-Cover Text and one of Back-Cover Text may be added by (or
11312     through arrangements made by) any one entity.  If the Document
11313     already includes a cover text for the same cover, previously added
11314     by you or by arrangement made by the same entity you are acting on
11315     behalf of, you may not add another; but you may replace the old
11316     one, on explicit permission from the previous publisher that added
11317     the old one.
11318
11319     The author(s) and publisher(s) of the Document do not by this
11320     License give permission to use their names for publicity for or to
11321     assert or imply endorsement of any Modified Version.
11322
11323  5. COMBINING DOCUMENTS
11324
11325     You may combine the Document with other documents released under
11326     this License, under the terms defined in section 4 above for
11327     modified versions, provided that you include in the combination all
11328     of the Invariant Sections of all of the original documents,
11329     unmodified, and list them all as Invariant Sections of your
11330     combined work in its license notice, and that you preserve all
11331     their Warranty Disclaimers.
11332
11333     The combined work need only contain one copy of this License, and
11334     multiple identical Invariant Sections may be replaced with a single
11335     copy.  If there are multiple Invariant Sections with the same name
11336     but different contents, make the title of each such section unique
11337     by adding at the end of it, in parentheses, the name of the
11338     original author or publisher of that section if known, or else a
11339     unique number.  Make the same adjustment to the section titles in
11340     the list of Invariant Sections in the license notice of the
11341     combined work.
11342
11343     In the combination, you must combine any sections Entitled
11344     ���History��� in the various original documents, forming one section
11345     Entitled ���History���; likewise combine any sections Entitled
11346     ���Acknowledgements���, and any sections Entitled ���Dedications���.  You
11347     must delete all sections Entitled ���Endorsements.���
11348
11349  6. COLLECTIONS OF DOCUMENTS
11350
11351     You may make a collection consisting of the Document and other
11352     documents released under this License, and replace the individual
11353     copies of this License in the various documents with a single copy
11354     that is included in the collection, provided that you follow the
11355     rules of this License for verbatim copying of each of the documents
11356     in all other respects.
11357
11358     You may extract a single document from such a collection, and
11359     distribute it individually under this License, provided you insert
11360     a copy of this License into the extracted document, and follow this
11361     License in all other respects regarding verbatim copying of that
11362     document.
11363
11364  7. AGGREGATION WITH INDEPENDENT WORKS
11365
11366     A compilation of the Document or its derivatives with other
11367     separate and independent documents or works, in or on a volume of a
11368     storage or distribution medium, is called an ���aggregate��� if the
11369     copyright resulting from the compilation is not used to limit the
11370     legal rights of the compilation���s users beyond what the individual
11371     works permit.  When the Document is included in an aggregate, this
11372     License does not apply to the other works in the aggregate which
11373     are not themselves derivative works of the Document.
11374
11375     If the Cover Text requirement of section 3 is applicable to these
11376     copies of the Document, then if the Document is less than one half
11377     of the entire aggregate, the Document���s Cover Texts may be placed
11378     on covers that bracket the Document within the aggregate, or the
11379     electronic equivalent of covers if the Document is in electronic
11380     form.  Otherwise they must appear on printed covers that bracket
11381     the whole aggregate.
11382
11383  8. TRANSLATION
11384
11385     Translation is considered a kind of modification, so you may
11386     distribute translations of the Document under the terms of section
11387     4.  Replacing Invariant Sections with translations requires special
11388     permission from their copyright holders, but you may include
11389     translations of some or all Invariant Sections in addition to the
11390     original versions of these Invariant Sections.  You may include a
11391     translation of this License, and all the license notices in the
11392     Document, and any Warranty Disclaimers, provided that you also
11393     include the original English version of this License and the
11394     original versions of those notices and disclaimers.  In case of a
11395     disagreement between the translation and the original version of
11396     this License or a notice or disclaimer, the original version will
11397     prevail.
11398
11399     If a section in the Document is Entitled ���Acknowledgements���,
11400     ���Dedications���, or ���History���, the requirement (section 4) to
11401     Preserve its Title (section 1) will typically require changing the
11402     actual title.
11403
11404  9. TERMINATION
11405
11406     You may not copy, modify, sublicense, or distribute the Document
11407     except as expressly provided under this License.  Any attempt
11408     otherwise to copy, modify, sublicense, or distribute it is void,
11409     and will automatically terminate your rights under this License.
11410
11411     However, if you cease all violation of this License, then your
11412     license from a particular copyright holder is reinstated (a)
11413     provisionally, unless and until the copyright holder explicitly and
11414     finally terminates your license, and (b) permanently, if the
11415     copyright holder fails to notify you of the violation by some
11416     reasonable means prior to 60 days after the cessation.
11417
11418     Moreover, your license from a particular copyright holder is
11419     reinstated permanently if the copyright holder notifies you of the
11420     violation by some reasonable means, this is the first time you have
11421     received notice of violation of this License (for any work) from
11422     that copyright holder, and you cure the violation prior to 30 days
11423     after your receipt of the notice.
11424
11425     Termination of your rights under this section does not terminate
11426     the licenses of parties who have received copies or rights from you
11427     under this License.  If your rights have been terminated and not
11428     permanently reinstated, receipt of a copy of some or all of the
11429     same material does not give you any rights to use it.
11430
11431  10. FUTURE REVISIONS OF THIS LICENSE
11432
11433     The Free Software Foundation may publish new, revised versions of
11434     the GNU Free Documentation License from time to time.  Such new
11435     versions will be similar in spirit to the present version, but may
11436     differ in detail to address new problems or concerns.  See
11437     <http://www.gnu.org/copyleft/>.
11438
11439     Each version of the License is given a distinguishing version
11440     number.  If the Document specifies that a particular numbered
11441     version of this License ���or any later version��� applies to it, you
11442     have the option of following the terms and conditions either of
11443     that specified version or of any later version that has been
11444     published (not as a draft) by the Free Software Foundation.  If the
11445     Document does not specify a version number of this License, you may
11446     choose any version ever published (not as a draft) by the Free
11447     Software Foundation.  If the Document specifies that a proxy can
11448     decide which future versions of this License can be used, that
11449     proxy���s public statement of acceptance of a version permanently
11450     authorizes you to choose that version for the Document.
11451
11452  11. RELICENSING
11453
11454     ���Massive Multiauthor Collaboration Site��� (or ���MMC Site���) means any
11455     World Wide Web server that publishes copyrightable works and also
11456     provides prominent facilities for anybody to edit those works.  A
11457     public wiki that anybody can edit is an example of such a server.
11458     A ���Massive Multiauthor Collaboration��� (or ���MMC���) contained in the
11459     site means any set of copyrightable works thus published on the MMC
11460     site.
11461
11462     ���CC-BY-SA��� means the Creative Commons Attribution-Share Alike 3.0
11463     license published by Creative Commons Corporation, a not-for-profit
11464     corporation with a principal place of business in San Francisco,
11465     California, as well as future copyleft versions of that license
11466     published by that same organization.
11467
11468     ���Incorporate��� means to publish or republish a Document, in whole or
11469     in part, as part of another Document.
11470
11471     An MMC is ���eligible for relicensing��� if it is licensed under this
11472     License, and if all works that were first published under this
11473     License somewhere other than this MMC, and subsequently
11474     incorporated in whole or in part into the MMC, (1) had no cover
11475     texts or invariant sections, and (2) were thus incorporated prior
11476     to November 1, 2008.
11477
11478     The operator of an MMC Site may republish an MMC contained in the
11479     site under CC-BY-SA on the same site at any time before August 1,
11480     2009, provided the MMC is eligible for relicensing.
11481
11482ADDENDUM: How to use this License for your documents
11483====================================================
11484
11485To use this License in a document you have written, include a copy of
11486the License in the document and put the following copyright and license
11487notices just after the title page:
11488
11489       Copyright (C)  YEAR  YOUR NAME.
11490       Permission is granted to copy, distribute and/or modify this document
11491       under the terms of the GNU Free Documentation License, Version 1.3
11492       or any later version published by the Free Software Foundation;
11493       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
11494       Texts.  A copy of the license is included in the section entitled ``GNU
11495       Free Documentation License''.
11496
11497   If you have Invariant Sections, Front-Cover Texts and Back-Cover
11498Texts, replace the ���with...Texts.��� line with this:
11499
11500         with the Invariant Sections being LIST THEIR TITLES, with
11501         the Front-Cover Texts being LIST, and with the Back-Cover Texts
11502         being LIST.
11503
11504   If you have Invariant Sections without Cover Texts, or some other
11505combination of the three, merge those two alternatives to suit the
11506situation.
11507
11508   If your document contains nontrivial examples of program code, we
11509recommend releasing these examples in parallel under your choice of free
11510software license, such as the GNU General Public License, to permit
11511their use in free software.
11512
11513
11514File: bfd.info,  Node: BFD Index,  Prev: GNU Free Documentation License,  Up: Top
11515
11516BFD Index
11517*********
11518
11519[index]
11520* Menu:
11521
11522* *bfd_alloc:                            Internal.           (line   74)
11523* *bfd_arch_default_fill:                Architectures.      (line  744)
11524* *bfd_asprintf:                         Error reporting.    (line  102)
11525* *bfd_create:                           Opening and Closing.
11526                                                             (line  226)
11527* *bfd_default_reloc_type_lookup:        howto manager.      (line 3647)
11528* *bfd_demangle:                         Miscellaneous.      (line  321)
11529* *bfd_elf_bfd_from_remote_memory:       Opening and Closing.
11530                                                             (line  172)
11531* *bfd_fdopenr:                          Opening and Closing.
11532                                                             (line   71)
11533* *bfd_fdopenw:                          Opening and Closing.
11534                                                             (line   97)
11535* *bfd_follow_build_id_debuglink:        Opening and Closing.
11536                                                             (line  360)
11537* *bfd_follow_gnu_debugaltlink:          Opening and Closing.
11538                                                             (line  316)
11539* *bfd_follow_gnu_debuglink:             Opening and Closing.
11540                                                             (line  297)
11541* *bfd_fopen:                            Opening and Closing.
11542                                                             (line   30)
11543* *bfd_generic_get_relocated_section_contents: howto manager.
11544                                                             (line 3695)
11545* *bfd_get_alt_debug_link_info:          Opening and Closing.
11546                                                             (line  286)
11547* *bfd_get_debug_link_info:              Opening and Closing.
11548                                                             (line  270)
11549* *bfd_get_linker_section:               section prototypes. (line   37)
11550* *bfd_get_next_section_by_name:         section prototypes. (line   26)
11551* *bfd_get_relocated_section_contents:   Miscellaneous.      (line  273)
11552* *bfd_get_section_by_name:              section prototypes. (line   18)
11553* *bfd_get_section_by_name_if:           section prototypes. (line   45)
11554* *bfd_get_unique_section_name:          section prototypes. (line   60)
11555* *bfd_hash_allocate:                    Write Other Derived Routines.
11556                                                             (line   83)
11557* *bfd_make_section:                     section prototypes. (line  132)
11558* *bfd_make_section_anyway:              section prototypes. (line  106)
11559* *bfd_make_section_anyway_with_flags:   section prototypes. (line   90)
11560* *bfd_make_section_old_way:             section prototypes. (line   71)
11561* *bfd_make_section_with_flags:          section prototypes. (line  121)
11562* *bfd_malloc:                           Internal.           (line   15)
11563* *bfd_mmap:                             Miscellaneous.      (line  459)
11564* *bfd_openr:                            Opening and Closing.
11565                                                             (line   54)
11566* *bfd_openr_iovec:                      Opening and Closing.
11567                                                             (line  116)
11568* *bfd_openr_next_archived_file:         Archives.           (line   83)
11569* *bfd_openstreamr:                      Opening and Closing.
11570                                                             (line  105)
11571* *bfd_openw:                            Opening and Closing.
11572                                                             (line  159)
11573* *bfd_realloc:                          Internal.           (line   24)
11574* *bfd_realloc_or_free:                  Internal.           (line   42)
11575* *bfd_reloc_type_lookup:                howto manager.      (line 3638)
11576* *bfd_sections_find_if:                 section prototypes. (line  178)
11577* *bfd_zalloc:                           Internal.           (line   81)
11578* *bfd_zmalloc:                          Internal.           (line   62)
11579* *_bfd_generic_make_empty_symbol:       symbol handling functions.
11580                                                             (line   91)
11581* *_bfd_new_bfd:                         Opening and Closing.
11582                                                             (line   12)
11583* *_bfd_new_bfd_contained_in:            Opening and Closing.
11584                                                             (line   18)
11585* _bfd_clear_error_data:                 Error reporting.    (line   92)
11586* _bfd_clear_error_data <1>:             Error reporting.    (line   96)
11587* _bfd_error_handler:                    Error reporting.    (line  120)
11588* _bfd_error_handler <1>:                Error reporting.    (line  125)
11589* _bfd_final_link_relocate:              Relocating the section contents.
11590                                                             (line   22)
11591* _bfd_free_cached_info:                 Opening and Closing.
11592                                                             (line   20)
11593* _bfd_free_cached_info <1>:             Opening and Closing.
11594                                                             (line   24)
11595* _bfd_generic_link_add_archive_symbols: Adding symbols from an archive.
11596                                                             (line   15)
11597* _bfd_generic_link_add_one_symbol:      Adding symbols from an object file.
11598                                                             (line   19)
11599* _bfd_generic_link_check_relocs:        Writing the symbol table.
11600                                                             (line  126)
11601* _bfd_generic_link_check_relocs <1>:    Writing the symbol table.
11602                                                             (line  130)
11603* _bfd_generic_link_hide_symbol:         Writing the symbol table.
11604                                                             (line   75)
11605* _bfd_generic_link_hide_symbol <1>:     Writing the symbol table.
11606                                                             (line   79)
11607* _bfd_generic_make_empty_symbol:        symbol handling functions.
11608                                                             (line   87)
11609* _bfd_generic_set_reloc:                howto manager.      (line 3701)
11610* _bfd_generic_set_reloc <1>:            howto manager.      (line 3705)
11611* _bfd_generic_verify_endian_match:      Writing the symbol table.
11612                                                             (line  151)
11613* _bfd_generic_verify_endian_match <1>:  Writing the symbol table.
11614                                                             (line  155)
11615* _bfd_get_error_program_name:           Error reporting.    (line  159)
11616* _bfd_link_add_symbols in target vector: Adding Symbols to the Hash Table.
11617                                                             (line    6)
11618* _bfd_link_final_link in target vector: Performing the Final Link.
11619                                                             (line    6)
11620* _bfd_link_hash_table_create in target vector: Creating a Linker Hash Table.
11621                                                             (line    6)
11622* _bfd_new_bfd:                          Opening and Closing.
11623                                                             (line    8)
11624* _bfd_new_bfd_contained_in:             Opening and Closing.
11625                                                             (line   14)
11626* _bfd_per_xvec_warn:                    bfd_target.         (line  539)
11627* _bfd_relocate_contents:                Relocating the section contents.
11628                                                             (line   22)
11629* _bfd_section_size_insane:              section prototypes. (line  283)
11630* _bfd_section_size_insane <1>:          section prototypes. (line  287)
11631* _bfd_set_error_handler_caching:        Error reporting.    (line  143)
11632* _bfd_set_error_handler_caching <1>:    Error reporting.    (line  147)
11633* _bfd_stringtab_add:                    Write Other Derived Routines.
11634                                                             (line  127)
11635* _bfd_stringtab_add <1>:                Write Other Derived Routines.
11636                                                             (line  131)
11637* _bfd_stringtab_emit:                   Write Other Derived Routines.
11638                                                             (line  144)
11639* _bfd_stringtab_emit <1>:               Write Other Derived Routines.
11640                                                             (line  148)
11641* _bfd_stringtab_free:                   Write Other Derived Routines.
11642                                                             (line  121)
11643* _bfd_stringtab_free <1>:               Write Other Derived Routines.
11644                                                             (line  125)
11645* _bfd_stringtab_init:                   Write Other Derived Routines.
11646                                                             (line  106)
11647* _bfd_stringtab_size:                   Write Other Derived Routines.
11648                                                             (line  137)
11649* _bfd_stringtab_size <1>:               Write Other Derived Routines.
11650                                                             (line  141)
11651* _bfd_unrecognized_reloc:               howto manager.      (line 3708)
11652* _bfd_unrecognized_reloc <1>:           howto manager.      (line 3712)
11653* _bfd_xcoff_stringtab_init:             Write Other Derived Routines.
11654                                                             (line  112)
11655* aout_SIZE_machine_type:                aout.               (line  130)
11656* aout_SIZE_mkobject:                    aout.               (line  124)
11657* aout_SIZE_mkobject,:                   aout.               (line  128)
11658* aout_SIZE_new_section_hook:            aout.               (line  152)
11659* aout_SIZE_new_section_hook,:           aout.               (line  156)
11660* aout_SIZE_set_arch_mach:               aout.               (line  143)
11661* aout_SIZE_set_arch_mach,:              aout.               (line  147)
11662* aout_SIZE_some_aout_object_p:          aout.               (line  113)
11663* aout_SIZE_some_aout_object_p <1>:      aout.               (line  117)
11664* aout_SIZE_swap_exec_header_in:         aout.               (line   96)
11665* aout_SIZE_swap_exec_header_in,:        aout.               (line  100)
11666* aout_SIZE_swap_exec_header_out:        aout.               (line  105)
11667* aout_SIZE_swap_exec_header_out <1>:    aout.               (line  109)
11668* arelent_chain:                         typedef arelent.    (line  280)
11669* BFD:                                   Overview.           (line    6)
11670* BFD canonical format:                  Canonical format.   (line   11)
11671* bfd_alloc:                             Internal.           (line   70)
11672* bfd_alt_mach_code:                     Miscellaneous.      (line  295)
11673* bfd_alt_mach_code <1>:                 Miscellaneous.      (line  299)
11674* bfd_architecture:                      Architectures.      (line  658)
11675* bfd_arch_bits_per_address:             Architectures.      (line  674)
11676* bfd_arch_bits_per_byte:                Architectures.      (line  667)
11677* bfd_arch_default_fill:                 Architectures.      (line  740)
11678* bfd_arch_get_compatible:               Architectures.      (line  617)
11679* bfd_arch_info_type:                    Architectures.      (line  605)
11680* bfd_arch_info_type <1>:                Architectures.      (line  621)
11681* bfd_arch_info_type <2>:                Architectures.      (line  685)
11682* bfd_arch_info_type <3>:                Architectures.      (line  700)
11683* bfd_arch_info_type <4>:                Architectures.      (line  706)
11684* bfd_arch_list:                         Architectures.      (line  610)
11685* bfd_arch_mach_octets_per_byte:         Architectures.      (line  730)
11686* BFD_ARELOC_BFIN_ADD:                   howto manager.      (line 1161)
11687* BFD_ARELOC_BFIN_ADDR:                  howto manager.      (line 1195)
11688* BFD_ARELOC_BFIN_AND:                   howto manager.      (line 1175)
11689* BFD_ARELOC_BFIN_COMP:                  howto manager.      (line 1189)
11690* BFD_ARELOC_BFIN_CONST:                 howto manager.      (line 1159)
11691* BFD_ARELOC_BFIN_DIV:                   howto manager.      (line 1167)
11692* BFD_ARELOC_BFIN_HWPAGE:                howto manager.      (line 1193)
11693* BFD_ARELOC_BFIN_LAND:                  howto manager.      (line 1181)
11694* BFD_ARELOC_BFIN_LEN:                   howto manager.      (line 1185)
11695* BFD_ARELOC_BFIN_LOR:                   howto manager.      (line 1183)
11696* BFD_ARELOC_BFIN_LSHIFT:                howto manager.      (line 1171)
11697* BFD_ARELOC_BFIN_MOD:                   howto manager.      (line 1169)
11698* BFD_ARELOC_BFIN_MULT:                  howto manager.      (line 1165)
11699* BFD_ARELOC_BFIN_NEG:                   howto manager.      (line 1187)
11700* BFD_ARELOC_BFIN_OR:                    howto manager.      (line 1177)
11701* BFD_ARELOC_BFIN_PAGE:                  howto manager.      (line 1191)
11702* BFD_ARELOC_BFIN_PUSH:                  howto manager.      (line 1157)
11703* BFD_ARELOC_BFIN_RSHIFT:                howto manager.      (line 1173)
11704* BFD_ARELOC_BFIN_SUB:                   howto manager.      (line 1163)
11705* BFD_ARELOC_BFIN_XOR:                   howto manager.      (line 1179)
11706* bfd_asprintf:                          Error reporting.    (line   98)
11707* bfd_cache_close:                       File Caching.       (line   23)
11708* bfd_cache_close <1>:                   File Caching.       (line   27)
11709* bfd_cache_close_all:                   File Caching.       (line   33)
11710* bfd_cache_close_all <1>:               File Caching.       (line   37)
11711* bfd_cache_init:                        File Caching.       (line   17)
11712* bfd_cache_init <1>:                    File Caching.       (line   21)
11713* bfd_cache_size:                        File Caching.       (line   45)
11714* bfd_cache_size <1>:                    File Caching.       (line   49)
11715* bfd_calc_gnu_debuglink_crc32:          Opening and Closing.
11716                                                             (line  255)
11717* bfd_calc_gnu_debuglink_crc32 <1>:      Opening and Closing.
11718                                                             (line  259)
11719* bfd_canonicalize_reloc:                Miscellaneous.      (line   17)
11720* bfd_canonicalize_reloc <1>:            Miscellaneous.      (line   21)
11721* bfd_canonicalize_symtab:               symbol handling functions.
11722                                                             (line   47)
11723* bfd_check_format:                      Formats.            (line   20)
11724* bfd_check_format <1>:                  Formats.            (line   24)
11725* bfd_check_format_matches:              Formats.            (line   50)
11726* bfd_check_format_matches <1>:          Formats.            (line   54)
11727* bfd_check_overflow:                    typedef arelent.    (line  292)
11728* bfd_check_overflow <1>:                typedef arelent.    (line  296)
11729* bfd_close:                             Opening and Closing.
11730                                                             (line  190)
11731* bfd_close <1>:                         Opening and Closing.
11732                                                             (line  194)
11733* bfd_close_all_done:                    Opening and Closing.
11734                                                             (line  206)
11735* bfd_close_all_done <1>:                Opening and Closing.
11736                                                             (line  210)
11737* bfd_coff_backend_data:                 coff.               (line  299)
11738* bfd_copy_private_bfd_data:             Miscellaneous.      (line  139)
11739* bfd_copy_private_bfd_data <1>:         Miscellaneous.      (line  143)
11740* bfd_copy_private_header_data:          Miscellaneous.      (line  124)
11741* bfd_copy_private_header_data <1>:      Miscellaneous.      (line  128)
11742* bfd_copy_private_section_data:         section prototypes. (line  247)
11743* bfd_copy_private_section_data <1>:     section prototypes. (line  251)
11744* bfd_copy_private_symbol_data:          symbol handling functions.
11745                                                             (line  126)
11746* bfd_copy_private_symbol_data <1>:      symbol handling functions.
11747                                                             (line  130)
11748* bfd_core_file_failing_command:         Core Files.         (line   10)
11749* bfd_core_file_failing_signal:          Core Files.         (line   17)
11750* bfd_core_file_failing_signal <1>:      Core Files.         (line   21)
11751* bfd_core_file_pid:                     Core Files.         (line   24)
11752* bfd_core_file_pid <1>:                 Core Files.         (line   28)
11753* bfd_create:                            Opening and Closing.
11754                                                             (line  222)
11755* bfd_create_gnu_debuglink_section:      Opening and Closing.
11756                                                             (line  331)
11757* bfd_decode_symclass:                   symbol handling functions.
11758                                                             (line  104)
11759* bfd_decode_symclass <1>:               symbol handling functions.
11760                                                             (line  108)
11761* bfd_default_arch_struct:               Architectures.      (line  628)
11762* bfd_default_compatible:                Architectures.      (line  681)
11763* bfd_default_reloc_type_lookup:         howto manager.      (line 3643)
11764* bfd_default_scan:                      Architectures.      (line  688)
11765* bfd_default_scan <1>:                  Architectures.      (line  692)
11766* bfd_default_set_arch_mach:             Architectures.      (line  645)
11767* bfd_default_set_arch_mach <1>:         Architectures.      (line  649)
11768* bfd_demangle:                          Miscellaneous.      (line  317)
11769* bfd_elf_bfd_from_remote_memory:        Opening and Closing.
11770                                                             (line  168)
11771* bfd_elf_version_tree:                  Writing the symbol table.
11772                                                             (line  102)
11773* bfd_emul_get_commonpagesize:           Miscellaneous.      (line  311)
11774* bfd_emul_get_commonpagesize <1>:       Miscellaneous.      (line  315)
11775* bfd_emul_get_maxpagesize:              Miscellaneous.      (line  304)
11776* bfd_emul_get_maxpagesize <1>:          Miscellaneous.      (line  308)
11777* bfd_errmsg:                            Error reporting.    (line   75)
11778* bfd_fdopenr:                           Opening and Closing.
11779                                                             (line   67)
11780* bfd_fdopenw:                           Opening and Closing.
11781                                                             (line   93)
11782* bfd_fill_in_gnu_debuglink_section:     Opening and Closing.
11783                                                             (line  343)
11784* bfd_fill_in_gnu_debuglink_section <1>: Opening and Closing.
11785                                                             (line  347)
11786* bfd_find_target:                       bfd_target.         (line  562)
11787* bfd_find_version_for_sym:              Writing the symbol table.
11788                                                             (line   98)
11789* bfd_flavour_name:                      bfd_target.         (line  617)
11790* bfd_flush:                             Miscellaneous.      (line  388)
11791* bfd_flush <1>:                         Miscellaneous.      (line  392)
11792* bfd_follow_build_id_debuglink:         Opening and Closing.
11793                                                             (line  356)
11794* bfd_follow_gnu_debugaltlink:           Opening and Closing.
11795                                                             (line  312)
11796* bfd_follow_gnu_debuglink:              Opening and Closing.
11797                                                             (line  293)
11798* bfd_fopen:                             Opening and Closing.
11799                                                             (line   26)
11800* bfd_format_string:                     Formats.            (line   74)
11801* bfd_generic_define_common_symbol:      Writing the symbol table.
11802                                                             (line   64)
11803* bfd_generic_define_common_symbol <1>:  Writing the symbol table.
11804                                                             (line   68)
11805* bfd_generic_define_start_stop:         Writing the symbol table.
11806                                                             (line   86)
11807* bfd_generic_discard_group:             section prototypes. (line  276)
11808* bfd_generic_discard_group <1>:         section prototypes. (line  280)
11809* bfd_generic_gc_sections:               howto manager.      (line 3666)
11810* bfd_generic_gc_sections <1>:           howto manager.      (line 3670)
11811* bfd_generic_get_relocated_section_contents: howto manager. (line 3691)
11812* bfd_generic_group_name:                section prototypes. (line  269)
11813* bfd_generic_is_group_section:          section prototypes. (line  262)
11814* bfd_generic_is_group_section <1>:      section prototypes. (line  266)
11815* bfd_generic_lookup_section_flags:      howto manager.      (line 3674)
11816* bfd_generic_lookup_section_flags <1>:  howto manager.      (line 3678)
11817* bfd_generic_merge_sections:            howto manager.      (line 3683)
11818* bfd_generic_merge_sections <1>:        howto manager.      (line 3687)
11819* bfd_generic_relax_section:             howto manager.      (line 3658)
11820* bfd_generic_relax_section <1>:         howto manager.      (line 3662)
11821* bfd_getb64:                            Internal.           (line  260)
11822* bfd_get_alt_debug_link_info:           Opening and Closing.
11823                                                             (line  282)
11824* bfd_get_arch:                          Architectures.      (line  654)
11825* bfd_get_arch_info:                     Architectures.      (line  696)
11826* bfd_get_arch_size:                     Miscellaneous.      (line   58)
11827* bfd_get_arch_size <1>:                 Miscellaneous.      (line   62)
11828* bfd_get_current_time:                  Miscellaneous.      (line  465)
11829* bfd_get_current_time <1>:              Miscellaneous.      (line  469)
11830* bfd_get_debug_link_info:               Opening and Closing.
11831                                                             (line  266)
11832* bfd_get_error:                         Error reporting.    (line   50)
11833* bfd_get_error <1>:                     Error reporting.    (line   55)
11834* bfd_get_file_size:                     Miscellaneous.      (line  447)
11835* bfd_get_file_size <1>:                 Miscellaneous.      (line  451)
11836* bfd_get_gp_size:                       Miscellaneous.      (line   92)
11837* bfd_get_linker_section:                section prototypes. (line   33)
11838* bfd_get_mach:                          Architectures.      (line  661)
11839* bfd_get_mtime:                         Miscellaneous.      (line  410)
11840* bfd_get_mtime <1>:                     Miscellaneous.      (line  414)
11841* bfd_get_next_mapent:                   Archives.           (line   56)
11842* bfd_get_next_mapent <1>:               Archives.           (line   60)
11843* bfd_get_next_section_by_name:          section prototypes. (line   22)
11844* bfd_get_relocated_section_contents:    Miscellaneous.      (line  269)
11845* bfd_get_reloc_code_name:               howto manager.      (line 3650)
11846* bfd_get_reloc_upper_bound:             Miscellaneous.      (line    8)
11847* bfd_get_reloc_upper_bound <1>:         Miscellaneous.      (line   12)
11848* bfd_get_section_by_name:               section prototypes. (line   14)
11849* bfd_get_section_by_name_if:            section prototypes. (line   41)
11850* bfd_get_section_contents:              section prototypes. (line  223)
11851* bfd_get_section_contents <1>:          section prototypes. (line  227)
11852* bfd_get_sign_extend_vma:               Miscellaneous.      (line   70)
11853* bfd_get_sign_extend_vma <1>:           Miscellaneous.      (line   74)
11854* bfd_get_size:                          Miscellaneous.      (line  417)
11855* bfd_get_size <1>:                      Miscellaneous.      (line  421)
11856* bfd_get_size <2>:                      Internal.           (line  102)
11857* bfd_get_symtab_upper_bound:            symbol handling functions.
11858                                                             (line    5)
11859* bfd_get_target_info:                   bfd_target.         (line  577)
11860* bfd_get_unique_section_name:           section prototypes. (line   56)
11861* bfd_hash_allocate:                     Creating and Freeing a Hash Table.
11862                                                             (line   17)
11863* bfd_hash_allocate <1>:                 Write Other Derived Routines.
11864                                                             (line   79)
11865* bfd_hash_entry:                        Write Other Derived Routines.
11866                                                             (line   55)
11867* bfd_hash_entry <1>:                    Write Other Derived Routines.
11868                                                             (line   62)
11869* bfd_hash_entry <2>:                    Write Other Derived Routines.
11870                                                             (line   90)
11871* bfd_hash_insert:                       Write Other Derived Routines.
11872                                                             (line   58)
11873* bfd_hash_lookup:                       Looking Up or Entering a String.
11874                                                             (line    6)
11875* bfd_hash_lookup <1>:                   Write Other Derived Routines.
11876                                                             (line   51)
11877* bfd_hash_newfunc:                      Creating and Freeing a Hash Table.
11878                                                             (line   12)
11879* bfd_hash_newfunc <1>:                  Write Other Derived Routines.
11880                                                             (line   86)
11881* bfd_hash_rename:                       Write Other Derived Routines.
11882                                                             (line   65)
11883* bfd_hash_rename <1>:                   Write Other Derived Routines.
11884                                                             (line   69)
11885* bfd_hash_replace:                      Write Other Derived Routines.
11886                                                             (line   72)
11887* bfd_hash_replace <1>:                  Write Other Derived Routines.
11888                                                             (line   76)
11889* bfd_hash_set_default_size:             Creating and Freeing a Hash Table.
11890                                                             (line   25)
11891* bfd_hash_set_default_size <1>:         Write Other Derived Routines.
11892                                                             (line  100)
11893* bfd_hash_table_free:                   Creating and Freeing a Hash Table.
11894                                                             (line   21)
11895* bfd_hash_table_free <1>:               Write Other Derived Routines.
11896                                                             (line   45)
11897* bfd_hash_table_free <2>:               Write Other Derived Routines.
11898                                                             (line   49)
11899* bfd_hash_table_init:                   Creating and Freeing a Hash Table.
11900                                                             (line    6)
11901* bfd_hash_table_init <1>:               Write Other Derived Routines.
11902                                                             (line   37)
11903* bfd_hash_table_init <2>:               Write Other Derived Routines.
11904                                                             (line   41)
11905* bfd_hash_table_init_n:                 Creating and Freeing a Hash Table.
11906                                                             (line    6)
11907* bfd_hash_table_init_n <1>:             Write Other Derived Routines.
11908                                                             (line   28)
11909* bfd_hash_table_init_n <2>:             Write Other Derived Routines.
11910                                                             (line   32)
11911* bfd_hash_traverse:                     Traversing a Hash Table.
11912                                                             (line    6)
11913* bfd_hash_traverse <1>:                 Write Other Derived Routines.
11914                                                             (line   93)
11915* bfd_hash_traverse <2>:                 Write Other Derived Routines.
11916                                                             (line   97)
11917* bfd_hide_sym_by_version:               Writing the symbol table.
11918                                                             (line  109)
11919* bfd_hide_sym_by_version <1>:           Writing the symbol table.
11920                                                             (line  113)
11921* bfd_h_put_size:                        Internal.           (line  188)
11922* bfd_init:                              Initialization.     (line    3)
11923* bfd_install_relocation:                typedef arelent.    (line  331)
11924* bfd_install_relocation <1>:            typedef arelent.    (line  335)
11925* bfd_is_local_label:                    symbol handling functions.
11926                                                             (line   16)
11927* bfd_is_local_label <1>:                symbol handling functions.
11928                                                             (line   20)
11929* bfd_is_local_label_name:               symbol handling functions.
11930                                                             (line   23)
11931* bfd_is_local_label_name <1>:           symbol handling functions.
11932                                                             (line   27)
11933* bfd_is_target_special_symbol:          symbol handling functions.
11934                                                             (line   35)
11935* bfd_is_target_special_symbol <1>:      symbol handling functions.
11936                                                             (line   39)
11937* bfd_is_undefined_symclass:             symbol handling functions.
11938                                                             (line  111)
11939* bfd_is_undefined_symclass <1>:         symbol handling functions.
11940                                                             (line  115)
11941* bfd_iterate_over_targets:              bfd_target.         (line  607)
11942* bfd_link_check_relocs:                 Writing the symbol table.
11943                                                             (line  117)
11944* bfd_link_check_relocs <1>:             Writing the symbol table.
11945                                                             (line  121)
11946* bfd_link_hash_entry:                   Writing the symbol table.
11947                                                             (line   90)
11948* bfd_link_split_section:                Writing the symbol table.
11949                                                             (line   43)
11950* bfd_link_split_section <1>:            Writing the symbol table.
11951                                                             (line   47)
11952* bfd_lock:                              Threading.          (line   37)
11953* bfd_lock <1>:                          Threading.          (line   41)
11954* bfd_log2:                              Internal.           (line  280)
11955* bfd_lookup_arch:                       Architectures.      (line  702)
11956* bfd_make_debug_symbol:                 symbol handling functions.
11957                                                             (line   95)
11958* bfd_make_empty_symbol:                 symbol handling functions.
11959                                                             (line   73)
11960* bfd_make_readable:                     Opening and Closing.
11961                                                             (line  244)
11962* bfd_make_readable <1>:                 Opening and Closing.
11963                                                             (line  248)
11964* bfd_make_section:                      section prototypes. (line  128)
11965* bfd_make_section_anyway:               section prototypes. (line  102)
11966* bfd_make_section_anyway_with_flags:    section prototypes. (line   86)
11967* bfd_make_section_old_way:              section prototypes. (line   67)
11968* bfd_make_section_with_flags:           section prototypes. (line  117)
11969* bfd_make_writable:                     Opening and Closing.
11970                                                             (line  233)
11971* bfd_make_writable <1>:                 Opening and Closing.
11972                                                             (line  237)
11973* bfd_malloc:                            Internal.           (line   11)
11974* bfd_malloc_and_get_section:            section prototypes. (line  238)
11975* bfd_malloc_and_get_section <1>:        section prototypes. (line  242)
11976* bfd_map_over_sections:                 section prototypes. (line  156)
11977* bfd_map_over_sections <1>:             section prototypes. (line  160)
11978* bfd_merge_private_bfd_data:            Writing the symbol table.
11979                                                             (line  135)
11980* bfd_merge_private_bfd_data <1>:        Writing the symbol table.
11981                                                             (line  139)
11982* bfd_mmap:                              Miscellaneous.      (line  455)
11983* bfd_octets_per_byte:                   Architectures.      (line  721)
11984* bfd_openr:                             Opening and Closing.
11985                                                             (line   50)
11986* bfd_openr_iovec:                       Opening and Closing.
11987                                                             (line  112)
11988* bfd_openr_next_archived_file:          Archives.           (line   79)
11989* bfd_openstreamr:                       Opening and Closing.
11990                                                             (line  101)
11991* bfd_openw:                             Opening and Closing.
11992                                                             (line  155)
11993* bfd_open_file:                         File Caching.       (line   51)
11994* bfd_open_file <1>:                     File Caching.       (line   55)
11995* bfd_perform_relocation:                typedef arelent.    (line  311)
11996* bfd_perform_relocation <1>:            typedef arelent.    (line  315)
11997* bfd_perror:                            Error reporting.    (line   82)
11998* bfd_perror <1>:                        Error reporting.    (line   86)
11999* bfd_printable_arch_mach:               Architectures.      (line  711)
12000* bfd_printable_name:                    Architectures.      (line  594)
12001* bfd_print_symbol_vandf:                symbol handling functions.
12002                                                             (line   65)
12003* bfd_print_symbol_vandf <1>:            symbol handling functions.
12004                                                             (line   69)
12005* bfd_put_size:                          Internal.           (line   99)
12006* bfd_read:                              Miscellaneous.      (line  366)
12007* bfd_read <1>:                          Miscellaneous.      (line  370)
12008* bfd_realloc:                           Internal.           (line   20)
12009* bfd_realloc_or_free:                   Internal.           (line   38)
12010* bfd_record_phdr:                       Miscellaneous.      (line  279)
12011* bfd_record_phdr <1>:                   Miscellaneous.      (line  283)
12012* bfd_release:                           Internal.           (line   84)
12013* bfd_release <1>:                       Internal.           (line   88)
12014* BFD_RELOC_12_PCREL:                    howto manager.      (line   36)
12015* BFD_RELOC_14:                          howto manager.      (line   29)
12016* BFD_RELOC_16:                          howto manager.      (line   28)
12017* BFD_RELOC_16_BASEREL:                  howto manager.      (line   90)
12018* BFD_RELOC_16_GOTOFF:                   howto manager.      (line   49)
12019* BFD_RELOC_16_GOT_PCREL:                howto manager.      (line   46)
12020* BFD_RELOC_16_PCREL:                    howto manager.      (line   35)
12021* BFD_RELOC_16_PCREL_S2:                 howto manager.      (line  100)
12022* BFD_RELOC_16_PLTOFF:                   howto manager.      (line   61)
12023* BFD_RELOC_16_PLT_PCREL:                howto manager.      (line   57)
12024* BFD_RELOC_16_SECIDX:                   howto manager.      (line   43)
12025* BFD_RELOC_23_PCREL_S2:                 howto manager.      (line  101)
12026* BFD_RELOC_24:                          howto manager.      (line   27)
12027* BFD_RELOC_24_PCREL:                    howto manager.      (line   34)
12028* BFD_RELOC_24_PLT_PCREL:                howto manager.      (line   56)
12029* BFD_RELOC_26:                          howto manager.      (line   26)
12030* BFD_RELOC_32:                          howto manager.      (line   25)
12031* BFD_RELOC_32_BASEREL:                  howto manager.      (line   89)
12032* BFD_RELOC_32_GOTOFF:                   howto manager.      (line   48)
12033* BFD_RELOC_32_GOT_PCREL:                howto manager.      (line   45)
12034* BFD_RELOC_32_PCREL:                    howto manager.      (line   33)
12035* BFD_RELOC_32_PCREL_S2:                 howto manager.      (line   99)
12036* BFD_RELOC_32_PLTOFF:                   howto manager.      (line   60)
12037* BFD_RELOC_32_PLT_PCREL:                howto manager.      (line   55)
12038* BFD_RELOC_32_SECREL:                   howto manager.      (line   42)
12039* BFD_RELOC_386_COPY:                    howto manager.      (line  523)
12040* BFD_RELOC_386_GLOB_DAT:                howto manager.      (line  524)
12041* BFD_RELOC_386_GOT32:                   howto manager.      (line  521)
12042* BFD_RELOC_386_GOT32X:                  howto manager.      (line  545)
12043* BFD_RELOC_386_GOTOFF:                  howto manager.      (line  527)
12044* BFD_RELOC_386_GOTPC:                   howto manager.      (line  528)
12045* BFD_RELOC_386_IRELATIVE:               howto manager.      (line  544)
12046* BFD_RELOC_386_JUMP_SLOT:               howto manager.      (line  525)
12047* BFD_RELOC_386_PLT32:                   howto manager.      (line  522)
12048* BFD_RELOC_386_RELATIVE:                howto manager.      (line  526)
12049* BFD_RELOC_386_TLS_DESC:                howto manager.      (line  543)
12050* BFD_RELOC_386_TLS_DESC_CALL:           howto manager.      (line  542)
12051* BFD_RELOC_386_TLS_DTPMOD32:            howto manager.      (line  538)
12052* BFD_RELOC_386_TLS_DTPOFF32:            howto manager.      (line  539)
12053* BFD_RELOC_386_TLS_GD:                  howto manager.      (line  533)
12054* BFD_RELOC_386_TLS_GOTDESC:             howto manager.      (line  541)
12055* BFD_RELOC_386_TLS_GOTIE:               howto manager.      (line  531)
12056* BFD_RELOC_386_TLS_IE:                  howto manager.      (line  530)
12057* BFD_RELOC_386_TLS_IE_32:               howto manager.      (line  536)
12058* BFD_RELOC_386_TLS_LDM:                 howto manager.      (line  534)
12059* BFD_RELOC_386_TLS_LDO_32:              howto manager.      (line  535)
12060* BFD_RELOC_386_TLS_LE:                  howto manager.      (line  532)
12061* BFD_RELOC_386_TLS_LE_32:               howto manager.      (line  537)
12062* BFD_RELOC_386_TLS_TPOFF:               howto manager.      (line  529)
12063* BFD_RELOC_386_TLS_TPOFF32:             howto manager.      (line  540)
12064* BFD_RELOC_390_12:                      howto manager.      (line 1952)
12065* BFD_RELOC_390_20:                      howto manager.      (line 2033)
12066* BFD_RELOC_390_COPY:                    howto manager.      (line 1958)
12067* BFD_RELOC_390_GLOB_DAT:                howto manager.      (line 1960)
12068* BFD_RELOC_390_GOT12:                   howto manager.      (line 1954)
12069* BFD_RELOC_390_GOT16:                   howto manager.      (line 1968)
12070* BFD_RELOC_390_GOT20:                   howto manager.      (line 2034)
12071* BFD_RELOC_390_GOT64:                   howto manager.      (line 1988)
12072* BFD_RELOC_390_GOTENT:                  howto manager.      (line 1992)
12073* BFD_RELOC_390_GOTOFF64:                howto manager.      (line 1994)
12074* BFD_RELOC_390_GOTPC:                   howto manager.      (line 1966)
12075* BFD_RELOC_390_GOTPCDBL:                howto manager.      (line 1986)
12076* BFD_RELOC_390_GOTPLT12:                howto manager.      (line 1996)
12077* BFD_RELOC_390_GOTPLT16:                howto manager.      (line 1998)
12078* BFD_RELOC_390_GOTPLT20:                howto manager.      (line 2035)
12079* BFD_RELOC_390_GOTPLT32:                howto manager.      (line 2000)
12080* BFD_RELOC_390_GOTPLT64:                howto manager.      (line 2002)
12081* BFD_RELOC_390_GOTPLTENT:               howto manager.      (line 2004)
12082* BFD_RELOC_390_IRELATIVE:               howto manager.      (line 2038)
12083* BFD_RELOC_390_JMP_SLOT:                howto manager.      (line 1962)
12084* BFD_RELOC_390_PC12DBL:                 howto manager.      (line 1970)
12085* BFD_RELOC_390_PC16DBL:                 howto manager.      (line 1974)
12086* BFD_RELOC_390_PC24DBL:                 howto manager.      (line 1978)
12087* BFD_RELOC_390_PC32DBL:                 howto manager.      (line 1982)
12088* BFD_RELOC_390_PLT12DBL:                howto manager.      (line 1972)
12089* BFD_RELOC_390_PLT16DBL:                howto manager.      (line 1976)
12090* BFD_RELOC_390_PLT24DBL:                howto manager.      (line 1980)
12091* BFD_RELOC_390_PLT32:                   howto manager.      (line 1956)
12092* BFD_RELOC_390_PLT32DBL:                howto manager.      (line 1984)
12093* BFD_RELOC_390_PLT64:                   howto manager.      (line 1990)
12094* BFD_RELOC_390_PLTOFF16:                howto manager.      (line 2006)
12095* BFD_RELOC_390_PLTOFF32:                howto manager.      (line 2008)
12096* BFD_RELOC_390_PLTOFF64:                howto manager.      (line 2010)
12097* BFD_RELOC_390_RELATIVE:                howto manager.      (line 1964)
12098* BFD_RELOC_390_TLS_DTPMOD:              howto manager.      (line 2029)
12099* BFD_RELOC_390_TLS_DTPOFF:              howto manager.      (line 2030)
12100* BFD_RELOC_390_TLS_GD32:                howto manager.      (line 2015)
12101* BFD_RELOC_390_TLS_GD64:                howto manager.      (line 2016)
12102* BFD_RELOC_390_TLS_GDCALL:              howto manager.      (line 2013)
12103* BFD_RELOC_390_TLS_GOTIE12:             howto manager.      (line 2017)
12104* BFD_RELOC_390_TLS_GOTIE20:             howto manager.      (line 2036)
12105* BFD_RELOC_390_TLS_GOTIE32:             howto manager.      (line 2018)
12106* BFD_RELOC_390_TLS_GOTIE64:             howto manager.      (line 2019)
12107* BFD_RELOC_390_TLS_IE32:                howto manager.      (line 2022)
12108* BFD_RELOC_390_TLS_IE64:                howto manager.      (line 2023)
12109* BFD_RELOC_390_TLS_IEENT:               howto manager.      (line 2024)
12110* BFD_RELOC_390_TLS_LDCALL:              howto manager.      (line 2014)
12111* BFD_RELOC_390_TLS_LDM32:               howto manager.      (line 2020)
12112* BFD_RELOC_390_TLS_LDM64:               howto manager.      (line 2021)
12113* BFD_RELOC_390_TLS_LDO32:               howto manager.      (line 2027)
12114* BFD_RELOC_390_TLS_LDO64:               howto manager.      (line 2028)
12115* BFD_RELOC_390_TLS_LE32:                howto manager.      (line 2025)
12116* BFD_RELOC_390_TLS_LE64:                howto manager.      (line 2026)
12117* BFD_RELOC_390_TLS_LOAD:                howto manager.      (line 2012)
12118* BFD_RELOC_390_TLS_TPOFF:               howto manager.      (line 2031)
12119* BFD_RELOC_64:                          howto manager.      (line   24)
12120* BFD_RELOC_64_PCREL:                    howto manager.      (line   32)
12121* BFD_RELOC_64_PLTOFF:                   howto manager.      (line   59)
12122* BFD_RELOC_64_PLT_PCREL:                howto manager.      (line   54)
12123* BFD_RELOC_68K_GLOB_DAT:                howto manager.      (line   70)
12124* BFD_RELOC_68K_JMP_SLOT:                howto manager.      (line   71)
12125* BFD_RELOC_68K_RELATIVE:                howto manager.      (line   72)
12126* BFD_RELOC_68K_TLS_GD16:                howto manager.      (line   74)
12127* BFD_RELOC_68K_TLS_GD32:                howto manager.      (line   73)
12128* BFD_RELOC_68K_TLS_GD8:                 howto manager.      (line   75)
12129* BFD_RELOC_68K_TLS_IE16:                howto manager.      (line   83)
12130* BFD_RELOC_68K_TLS_IE32:                howto manager.      (line   82)
12131* BFD_RELOC_68K_TLS_IE8:                 howto manager.      (line   84)
12132* BFD_RELOC_68K_TLS_LDM16:               howto manager.      (line   77)
12133* BFD_RELOC_68K_TLS_LDM32:               howto manager.      (line   76)
12134* BFD_RELOC_68K_TLS_LDM8:                howto manager.      (line   78)
12135* BFD_RELOC_68K_TLS_LDO16:               howto manager.      (line   80)
12136* BFD_RELOC_68K_TLS_LDO32:               howto manager.      (line   79)
12137* BFD_RELOC_68K_TLS_LDO8:                howto manager.      (line   81)
12138* BFD_RELOC_68K_TLS_LE16:                howto manager.      (line   86)
12139* BFD_RELOC_68K_TLS_LE32:                howto manager.      (line   85)
12140* BFD_RELOC_68K_TLS_LE8:                 howto manager.      (line   87)
12141* BFD_RELOC_8:                           howto manager.      (line   30)
12142* BFD_RELOC_8_BASEREL:                   howto manager.      (line   94)
12143* BFD_RELOC_8_FFnn:                      howto manager.      (line   97)
12144* BFD_RELOC_8_GOTOFF:                    howto manager.      (line   53)
12145* BFD_RELOC_8_GOT_PCREL:                 howto manager.      (line   47)
12146* BFD_RELOC_8_PCREL:                     howto manager.      (line   37)
12147* BFD_RELOC_8_PLTOFF:                    howto manager.      (line   65)
12148* BFD_RELOC_8_PLT_PCREL:                 howto manager.      (line   58)
12149* BFD_RELOC_AARCH64_16:                  howto manager.      (line 2893)
12150* BFD_RELOC_AARCH64_16_PCREL:            howto manager.      (line 2899)
12151* BFD_RELOC_AARCH64_32:                  howto manager.      (line 2892)
12152* BFD_RELOC_AARCH64_32_PCREL:            howto manager.      (line 2898)
12153* BFD_RELOC_AARCH64_64:                  howto manager.      (line 2891)
12154* BFD_RELOC_AARCH64_64_PCREL:            howto manager.      (line 2897)
12155* BFD_RELOC_AARCH64_ADD_LO12:            howto manager.      (line 2972)
12156* BFD_RELOC_AARCH64_ADR_GOT_PAGE:        howto manager.      (line 3018)
12157* BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL:   howto manager.      (line 2968)
12158* BFD_RELOC_AARCH64_ADR_HI21_PCREL:      howto manager.      (line 2965)
12159* BFD_RELOC_AARCH64_ADR_LO21_PCREL:      howto manager.      (line 2962)
12160* BFD_RELOC_AARCH64_BRANCH19:            howto manager.      (line 2984)
12161* BFD_RELOC_AARCH64_CALL26:              howto manager.      (line 2992)
12162* BFD_RELOC_AARCH64_COPY:                howto manager.      (line 3177)
12163* BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP:  howto manager.      (line 3195)
12164* BFD_RELOC_AARCH64_GLOB_DAT:            howto manager.      (line 3178)
12165* BFD_RELOC_AARCH64_GOT_LD_PREL19:       howto manager.      (line 3012)
12166* BFD_RELOC_AARCH64_IRELATIVE:           howto manager.      (line 3187)
12167* BFD_RELOC_AARCH64_JUMP26:              howto manager.      (line 2988)
12168* BFD_RELOC_AARCH64_JUMP_SLOT:           howto manager.      (line 3179)
12169* BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14:   howto manager.      (line 3039)
12170* BFD_RELOC_AARCH64_LD32_GOT_LO12_NC:    howto manager.      (line 3026)
12171* BFD_RELOC_AARCH64_LD64_GOTOFF_LO15:    howto manager.      (line 3036)
12172* BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15:   howto manager.      (line 3042)
12173* BFD_RELOC_AARCH64_LD64_GOT_LO12_NC:    howto manager.      (line 3022)
12174* BFD_RELOC_AARCH64_LDST128_LO12:        howto manager.      (line 3008)
12175* BFD_RELOC_AARCH64_LDST16_LO12:         howto manager.      (line 2996)
12176* BFD_RELOC_AARCH64_LDST32_LO12:         howto manager.      (line 3000)
12177* BFD_RELOC_AARCH64_LDST64_LO12:         howto manager.      (line 3004)
12178* BFD_RELOC_AARCH64_LDST8_LO12:          howto manager.      (line 2976)
12179* BFD_RELOC_AARCH64_LDST_LO12:           howto manager.      (line 3198)
12180* BFD_RELOC_AARCH64_LD_GOT_LO12_NC:      howto manager.      (line 3216)
12181* BFD_RELOC_AARCH64_LD_LO19_PCREL:       howto manager.      (line 2958)
12182* BFD_RELOC_AARCH64_MOVW_G0:             howto manager.      (line 2902)
12183* BFD_RELOC_AARCH64_MOVW_G0_NC:          howto manager.      (line 2905)
12184* BFD_RELOC_AARCH64_MOVW_G0_S:           howto manager.      (line 2923)
12185* BFD_RELOC_AARCH64_MOVW_G1:             howto manager.      (line 2908)
12186* BFD_RELOC_AARCH64_MOVW_G1_NC:          howto manager.      (line 2911)
12187* BFD_RELOC_AARCH64_MOVW_G1_S:           howto manager.      (line 2927)
12188* BFD_RELOC_AARCH64_MOVW_G2:             howto manager.      (line 2914)
12189* BFD_RELOC_AARCH64_MOVW_G2_NC:          howto manager.      (line 2917)
12190* BFD_RELOC_AARCH64_MOVW_G2_S:           howto manager.      (line 2931)
12191* BFD_RELOC_AARCH64_MOVW_G3:             howto manager.      (line 2920)
12192* BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC:   howto manager.      (line 3030)
12193* BFD_RELOC_AARCH64_MOVW_GOTOFF_G1:      howto manager.      (line 3033)
12194* BFD_RELOC_AARCH64_MOVW_PREL_G0:        howto manager.      (line 2935)
12195* BFD_RELOC_AARCH64_MOVW_PREL_G0_NC:     howto manager.      (line 2939)
12196* BFD_RELOC_AARCH64_MOVW_PREL_G1:        howto manager.      (line 2943)
12197* BFD_RELOC_AARCH64_MOVW_PREL_G1_NC:     howto manager.      (line 2946)
12198* BFD_RELOC_AARCH64_MOVW_PREL_G2:        howto manager.      (line 2949)
12199* BFD_RELOC_AARCH64_MOVW_PREL_G2_NC:     howto manager.      (line 2952)
12200* BFD_RELOC_AARCH64_MOVW_PREL_G3:        howto manager.      (line 2955)
12201* BFD_RELOC_AARCH64_NONE:                howto manager.      (line 2889)
12202* BFD_RELOC_AARCH64_NULL:                howto manager.      (line 2887)
12203* BFD_RELOC_AARCH64_RELATIVE:            howto manager.      (line 3180)
12204* BFD_RELOC_AARCH64_RELOC_END:           howto manager.      (line 3189)
12205* BFD_RELOC_AARCH64_RELOC_START:         howto manager.      (line 2882)
12206* BFD_RELOC_AARCH64_TLSDESC:             howto manager.      (line 3185)
12207* BFD_RELOC_AARCH64_TLSDESC_ADD:         howto manager.      (line 3174)
12208* BFD_RELOC_AARCH64_TLSDESC_ADD_LO12:    howto manager.      (line 3170)
12209* BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21:  howto manager.      (line 3167)
12210* BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21:  howto manager.      (line 3166)
12211* BFD_RELOC_AARCH64_TLSDESC_CALL:        howto manager.      (line 3175)
12212* BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC: howto manager.     (line 3169)
12213* BFD_RELOC_AARCH64_TLSDESC_LD64_LO12:   howto manager.      (line 3168)
12214* BFD_RELOC_AARCH64_TLSDESC_LDR:         howto manager.      (line 3173)
12215* BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC:  howto manager.      (line 3222)
12216* BFD_RELOC_AARCH64_TLSDESC_LD_PREL19:   howto manager.      (line 3165)
12217* BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC:   howto manager.      (line 3172)
12218* BFD_RELOC_AARCH64_TLSDESC_OFF_G1:      howto manager.      (line 3171)
12219* BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC:   howto manager.      (line 3052)
12220* BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21:    howto manager.      (line 3045)
12221* BFD_RELOC_AARCH64_TLSGD_ADR_PREL21:    howto manager.      (line 3050)
12222* BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC:    howto manager.      (line 3056)
12223* BFD_RELOC_AARCH64_TLSGD_MOVW_G1:       howto manager.      (line 3058)
12224* BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21: howto manager.
12225                                                             (line 3060)
12226* BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC: howto manager.
12227                                                             (line 3064)
12228* BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC: howto manager.
12229                                                             (line 3062)
12230* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC: howto manager.
12231                                                             (line 3219)
12232* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19: howto manager. (line 3066)
12233* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC: howto manager.
12234                                                             (line 3068)
12235* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1: howto manager.   (line 3070)
12236* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12: howto manager.    (line 3072)
12237* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12: howto manager.    (line 3074)
12238* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC: howto manager. (line 3076)
12239* BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC:   howto manager.      (line 3079)
12240* BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21:    howto manager.      (line 3083)
12241* BFD_RELOC_AARCH64_TLSLD_ADR_PREL21:    howto manager.      (line 3086)
12242* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12: howto manager. (line 3089)
12243* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC: howto manager.
12244                                                             (line 3092)
12245* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12: howto manager. (line 3095)
12246* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC: howto manager.
12247                                                             (line 3098)
12248* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12: howto manager. (line 3101)
12249* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC: howto manager.
12250                                                             (line 3104)
12251* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12: howto manager.  (line 3107)
12252* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC: howto manager.
12253                                                             (line 3110)
12254* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12: howto manager.   (line 3202)
12255* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC: howto manager.
12256                                                             (line 3206)
12257* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0: howto manager.     (line 3113)
12258* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC: howto manager.  (line 3115)
12259* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1: howto manager.     (line 3118)
12260* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC: howto manager.  (line 3120)
12261* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2: howto manager.     (line 3123)
12262* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12: howto manager.     (line 3135)
12263* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12: howto manager.     (line 3137)
12264* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC: howto manager.  (line 3139)
12265* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12: howto manager.  (line 3141)
12266* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC: howto manager.
12267                                                             (line 3144)
12268* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12: howto manager.  (line 3147)
12269* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC: howto manager.
12270                                                             (line 3150)
12271* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12: howto manager.  (line 3153)
12272* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC: howto manager.
12273                                                             (line 3156)
12274* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12: howto manager.   (line 3159)
12275* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC: howto manager.
12276                                                             (line 3162)
12277* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12: howto manager.    (line 3209)
12278* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC: howto manager. (line 3213)
12279* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0: howto manager.      (line 3131)
12280* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC: howto manager.   (line 3133)
12281* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1: howto manager.      (line 3127)
12282* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC: howto manager.   (line 3129)
12283* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2: howto manager.      (line 3125)
12284* BFD_RELOC_AARCH64_TLS_DTPMOD:          howto manager.      (line 3182)
12285* BFD_RELOC_AARCH64_TLS_DTPREL:          howto manager.      (line 3183)
12286* BFD_RELOC_AARCH64_TLS_TPREL:           howto manager.      (line 3184)
12287* BFD_RELOC_AARCH64_TSTBR14:             howto manager.      (line 2980)
12288* BFD_RELOC_AC_SECTOFF_S9:               howto manager.      (line 1079)
12289* BFD_RELOC_AC_SECTOFF_S9_1:             howto manager.      (line 1080)
12290* BFD_RELOC_AC_SECTOFF_S9_2:             howto manager.      (line 1081)
12291* BFD_RELOC_AC_SECTOFF_U8:               howto manager.      (line 1076)
12292* BFD_RELOC_AC_SECTOFF_U8_1:             howto manager.      (line 1077)
12293* BFD_RELOC_AC_SECTOFF_U8_2:             howto manager.      (line 1078)
12294* BFD_RELOC_ALPHA_BOH:                   howto manager.      (line  288)
12295* BFD_RELOC_ALPHA_BRSGP:                 howto manager.      (line  275)
12296* BFD_RELOC_ALPHA_BSR:                   howto manager.      (line  282)
12297* BFD_RELOC_ALPHA_CODEADDR:              howto manager.      (line  268)
12298* BFD_RELOC_ALPHA_DTPMOD64:              howto manager.      (line  293)
12299* BFD_RELOC_ALPHA_DTPREL16:              howto manager.      (line  298)
12300* BFD_RELOC_ALPHA_DTPREL64:              howto manager.      (line  295)
12301* BFD_RELOC_ALPHA_DTPREL_HI16:           howto manager.      (line  296)
12302* BFD_RELOC_ALPHA_DTPREL_LO16:           howto manager.      (line  297)
12303* BFD_RELOC_ALPHA_ELF_LITERAL:           howto manager.      (line  236)
12304* BFD_RELOC_ALPHA_GOTDTPREL16:           howto manager.      (line  294)
12305* BFD_RELOC_ALPHA_GOTTPREL16:            howto manager.      (line  299)
12306* BFD_RELOC_ALPHA_GPDISP:                howto manager.      (line  231)
12307* BFD_RELOC_ALPHA_GPDISP_HI16:           howto manager.      (line  219)
12308* BFD_RELOC_ALPHA_GPDISP_LO16:           howto manager.      (line  226)
12309* BFD_RELOC_ALPHA_GPREL_HI16:            howto manager.      (line  271)
12310* BFD_RELOC_ALPHA_GPREL_LO16:            howto manager.      (line  272)
12311* BFD_RELOC_ALPHA_HINT:                  howto manager.      (line  261)
12312* BFD_RELOC_ALPHA_LDA:                   howto manager.      (line  285)
12313* BFD_RELOC_ALPHA_LINKAGE:               howto manager.      (line  265)
12314* BFD_RELOC_ALPHA_LITERAL:               howto manager.      (line  235)
12315* BFD_RELOC_ALPHA_LITUSE:                howto manager.      (line  237)
12316* BFD_RELOC_ALPHA_NOP:                   howto manager.      (line  279)
12317* BFD_RELOC_ALPHA_TLSGD:                 howto manager.      (line  291)
12318* BFD_RELOC_ALPHA_TLSLDM:                howto manager.      (line  292)
12319* BFD_RELOC_ALPHA_TPREL16:               howto manager.      (line  303)
12320* BFD_RELOC_ALPHA_TPREL64:               howto manager.      (line  300)
12321* BFD_RELOC_ALPHA_TPREL_HI16:            howto manager.      (line  301)
12322* BFD_RELOC_ALPHA_TPREL_LO16:            howto manager.      (line  302)
12323* BFD_RELOC_ARC_16:                      howto manager.      (line 1048)
12324* BFD_RELOC_ARC_24:                      howto manager.      (line 1049)
12325* BFD_RELOC_ARC_32:                      howto manager.      (line 1050)
12326* BFD_RELOC_ARC_32_ME:                   howto manager.      (line 1070)
12327* BFD_RELOC_ARC_32_ME_S:                 howto manager.      (line 1071)
12328* BFD_RELOC_ARC_32_PCREL:                howto manager.      (line 1088)
12329* BFD_RELOC_ARC_8:                       howto manager.      (line 1047)
12330* BFD_RELOC_ARC_COPY:                    howto manager.      (line 1093)
12331* BFD_RELOC_ARC_GLOB_DAT:                howto manager.      (line 1094)
12332* BFD_RELOC_ARC_GOT32:                   howto manager.      (line 1090)
12333* BFD_RELOC_ARC_GOTOFF:                  howto manager.      (line 1097)
12334* BFD_RELOC_ARC_GOTPC:                   howto manager.      (line 1098)
12335* BFD_RELOC_ARC_GOTPC32:                 howto manager.      (line 1091)
12336* BFD_RELOC_ARC_JLI_SECTOFF:             howto manager.      (line 1114)
12337* BFD_RELOC_ARC_JMP_SLOT:                howto manager.      (line 1095)
12338* BFD_RELOC_ARC_N16:                     howto manager.      (line 1052)
12339* BFD_RELOC_ARC_N24:                     howto manager.      (line 1053)
12340* BFD_RELOC_ARC_N32:                     howto manager.      (line 1054)
12341* BFD_RELOC_ARC_N32_ME:                  howto manager.      (line 1072)
12342* BFD_RELOC_ARC_N8:                      howto manager.      (line 1051)
12343* BFD_RELOC_ARC_NONE:                    howto manager.      (line 1046)
12344* BFD_RELOC_ARC_NPS_CMEM16:              howto manager.      (line 1113)
12345* BFD_RELOC_ARC_PC32:                    howto manager.      (line 1089)
12346* BFD_RELOC_ARC_PLT32:                   howto manager.      (line 1092)
12347* BFD_RELOC_ARC_RELATIVE:                howto manager.      (line 1096)
12348* BFD_RELOC_ARC_S13_PCREL:               howto manager.      (line 1068)
12349* BFD_RELOC_ARC_S21H_PCREL:              howto manager.      (line 1057)
12350* BFD_RELOC_ARC_S21H_PCREL_PLT:          howto manager.      (line 1112)
12351* BFD_RELOC_ARC_S21W_PCREL:              howto manager.      (line 1058)
12352* BFD_RELOC_ARC_S21W_PCREL_PLT:          howto manager.      (line 1099)
12353* BFD_RELOC_ARC_S25H_PCREL:              howto manager.      (line 1059)
12354* BFD_RELOC_ARC_S25H_PCREL_PLT:          howto manager.      (line 1100)
12355* BFD_RELOC_ARC_S25W_PCREL:              howto manager.      (line 1060)
12356* BFD_RELOC_ARC_S25W_PCREL_PLT:          howto manager.      (line 1111)
12357* BFD_RELOC_ARC_SDA:                     howto manager.      (line 1055)
12358* BFD_RELOC_ARC_SDA16_LD:                howto manager.      (line 1065)
12359* BFD_RELOC_ARC_SDA16_LD1:               howto manager.      (line 1066)
12360* BFD_RELOC_ARC_SDA16_LD2:               howto manager.      (line 1067)
12361* BFD_RELOC_ARC_SDA16_ST2:               howto manager.      (line 1087)
12362* BFD_RELOC_ARC_SDA32:                   howto manager.      (line 1061)
12363* BFD_RELOC_ARC_SDA32_ME:                howto manager.      (line 1074)
12364* BFD_RELOC_ARC_SDA_12:                  howto manager.      (line 1086)
12365* BFD_RELOC_ARC_SDA_LDST:                howto manager.      (line 1062)
12366* BFD_RELOC_ARC_SDA_LDST1:               howto manager.      (line 1063)
12367* BFD_RELOC_ARC_SDA_LDST2:               howto manager.      (line 1064)
12368* BFD_RELOC_ARC_SECTOFF:                 howto manager.      (line 1056)
12369* BFD_RELOC_ARC_SECTOFF_1:               howto manager.      (line 1084)
12370* BFD_RELOC_ARC_SECTOFF_2:               howto manager.      (line 1085)
12371* BFD_RELOC_ARC_SECTOFF_ME:              howto manager.      (line 1073)
12372* BFD_RELOC_ARC_SECTOFF_ME_1:            howto manager.      (line 1082)
12373* BFD_RELOC_ARC_SECTOFF_ME_2:            howto manager.      (line 1083)
12374* BFD_RELOC_ARC_TLS_DTPMOD:              howto manager.      (line 1101)
12375* BFD_RELOC_ARC_TLS_DTPOFF:              howto manager.      (line 1107)
12376* BFD_RELOC_ARC_TLS_DTPOFF_S9:           howto manager.      (line 1108)
12377* BFD_RELOC_ARC_TLS_GD_CALL:             howto manager.      (line 1105)
12378* BFD_RELOC_ARC_TLS_GD_GOT:              howto manager.      (line 1103)
12379* BFD_RELOC_ARC_TLS_GD_LD:               howto manager.      (line 1104)
12380* BFD_RELOC_ARC_TLS_IE_GOT:              howto manager.      (line 1106)
12381* BFD_RELOC_ARC_TLS_LE_32:               howto manager.      (line 1110)
12382* BFD_RELOC_ARC_TLS_LE_S9:               howto manager.      (line 1109)
12383* BFD_RELOC_ARC_TLS_TPOFF:               howto manager.      (line 1102)
12384* BFD_RELOC_ARC_W:                       howto manager.      (line 1069)
12385* BFD_RELOC_ARC_W_ME:                    howto manager.      (line 1075)
12386* BFD_RELOC_ARM_ADRL_IMMEDIATE:          howto manager.      (line  919)
12387* BFD_RELOC_ARM_ADR_IMM:                 howto manager.      (line  934)
12388* BFD_RELOC_ARM_ALU_PC_G0:               howto manager.      (line  881)
12389* BFD_RELOC_ARM_ALU_PC_G0_NC:            howto manager.      (line  880)
12390* BFD_RELOC_ARM_ALU_PC_G1:               howto manager.      (line  883)
12391* BFD_RELOC_ARM_ALU_PC_G1_NC:            howto manager.      (line  882)
12392* BFD_RELOC_ARM_ALU_PC_G2:               howto manager.      (line  884)
12393* BFD_RELOC_ARM_ALU_SB_G0:               howto manager.      (line  895)
12394* BFD_RELOC_ARM_ALU_SB_G0_NC:            howto manager.      (line  894)
12395* BFD_RELOC_ARM_ALU_SB_G1:               howto manager.      (line  897)
12396* BFD_RELOC_ARM_ALU_SB_G1_NC:            howto manager.      (line  896)
12397* BFD_RELOC_ARM_ALU_SB_G2:               howto manager.      (line  898)
12398* BFD_RELOC_ARM_CP_OFF_IMM:              howto manager.      (line  929)
12399* BFD_RELOC_ARM_CP_OFF_IMM_S2:           howto manager.      (line  930)
12400* BFD_RELOC_ARM_FUNCDESC:                howto manager.      (line  850)
12401* BFD_RELOC_ARM_FUNCDESC_VALUE:          howto manager.      (line  851)
12402* BFD_RELOC_ARM_GLOB_DAT:                howto manager.      (line  857)
12403* BFD_RELOC_ARM_GOT32:                   howto manager.      (line  858)
12404* BFD_RELOC_ARM_GOTFUNCDESC:             howto manager.      (line  848)
12405* BFD_RELOC_ARM_GOTOFF:                  howto manager.      (line  861)
12406* BFD_RELOC_ARM_GOTOFFFUNCDESC:          howto manager.      (line  849)
12407* BFD_RELOC_ARM_GOTPC:                   howto manager.      (line  862)
12408* BFD_RELOC_ARM_GOT_PREL:                howto manager.      (line  863)
12409* BFD_RELOC_ARM_HVC:                     howto manager.      (line  926)
12410* BFD_RELOC_ARM_HWLITERAL:               howto manager.      (line  941)
12411* BFD_RELOC_ARM_IMMEDIATE:               howto manager.      (line  918)
12412* BFD_RELOC_ARM_IN_POOL:                 howto manager.      (line  937)
12413* BFD_RELOC_ARM_IRELATIVE:               howto manager.      (line  911)
12414* BFD_RELOC_ARM_JUMP_SLOT:               howto manager.      (line  856)
12415* BFD_RELOC_ARM_LDC_PC_G0:               howto manager.      (line  891)
12416* BFD_RELOC_ARM_LDC_PC_G1:               howto manager.      (line  892)
12417* BFD_RELOC_ARM_LDC_PC_G2:               howto manager.      (line  893)
12418* BFD_RELOC_ARM_LDC_SB_G0:               howto manager.      (line  905)
12419* BFD_RELOC_ARM_LDC_SB_G1:               howto manager.      (line  906)
12420* BFD_RELOC_ARM_LDC_SB_G2:               howto manager.      (line  907)
12421* BFD_RELOC_ARM_LDRS_PC_G0:              howto manager.      (line  888)
12422* BFD_RELOC_ARM_LDRS_PC_G1:              howto manager.      (line  889)
12423* BFD_RELOC_ARM_LDRS_PC_G2:              howto manager.      (line  890)
12424* BFD_RELOC_ARM_LDRS_SB_G0:              howto manager.      (line  902)
12425* BFD_RELOC_ARM_LDRS_SB_G1:              howto manager.      (line  903)
12426* BFD_RELOC_ARM_LDRS_SB_G2:              howto manager.      (line  904)
12427* BFD_RELOC_ARM_LDR_IMM:                 howto manager.      (line  935)
12428* BFD_RELOC_ARM_LDR_PC_G0:               howto manager.      (line  885)
12429* BFD_RELOC_ARM_LDR_PC_G1:               howto manager.      (line  886)
12430* BFD_RELOC_ARM_LDR_PC_G2:               howto manager.      (line  887)
12431* BFD_RELOC_ARM_LDR_SB_G0:               howto manager.      (line  899)
12432* BFD_RELOC_ARM_LDR_SB_G1:               howto manager.      (line  900)
12433* BFD_RELOC_ARM_LDR_SB_G2:               howto manager.      (line  901)
12434* BFD_RELOC_ARM_LITERAL:                 howto manager.      (line  936)
12435* BFD_RELOC_ARM_MOVT:                    howto manager.      (line  840)
12436* BFD_RELOC_ARM_MOVT_PCREL:              howto manager.      (line  842)
12437* BFD_RELOC_ARM_MOVW:                    howto manager.      (line  839)
12438* BFD_RELOC_ARM_MOVW_PCREL:              howto manager.      (line  841)
12439* BFD_RELOC_ARM_MULTI:                   howto manager.      (line  928)
12440* BFD_RELOC_ARM_OFFSET_IMM:              howto manager.      (line  820)
12441* BFD_RELOC_ARM_OFFSET_IMM8:             howto manager.      (line  938)
12442* BFD_RELOC_ARM_PCREL_BLX:               howto manager.      (line  784)
12443* BFD_RELOC_ARM_PCREL_BRANCH:            howto manager.      (line  781)
12444* BFD_RELOC_ARM_PCREL_CALL:              howto manager.      (line  792)
12445* BFD_RELOC_ARM_PCREL_JUMP:              howto manager.      (line  795)
12446* BFD_RELOC_ARM_PLT32:                   howto manager.      (line  859)
12447* BFD_RELOC_ARM_PREL31:                  howto manager.      (line  837)
12448* BFD_RELOC_ARM_RELATIVE:                howto manager.      (line  860)
12449* BFD_RELOC_ARM_ROSEGREL32:              howto manager.      (line  829)
12450* BFD_RELOC_ARM_SBREL32:                 howto manager.      (line  831)
12451* BFD_RELOC_ARM_SHIFT_IMM:               howto manager.      (line  924)
12452* BFD_RELOC_ARM_SMC:                     howto manager.      (line  925)
12453* BFD_RELOC_ARM_SWI:                     howto manager.      (line  927)
12454* BFD_RELOC_ARM_T32_ADD_IMM:             howto manager.      (line  921)
12455* BFD_RELOC_ARM_T32_ADD_PC12:            howto manager.      (line  923)
12456* BFD_RELOC_ARM_T32_CP_OFF_IMM:          howto manager.      (line  931)
12457* BFD_RELOC_ARM_T32_CP_OFF_IMM_S2:       howto manager.      (line  932)
12458* BFD_RELOC_ARM_T32_IMM12:               howto manager.      (line  922)
12459* BFD_RELOC_ARM_T32_IMMEDIATE:           howto manager.      (line  920)
12460* BFD_RELOC_ARM_T32_OFFSET_IMM:          howto manager.      (line  940)
12461* BFD_RELOC_ARM_T32_OFFSET_U8:           howto manager.      (line  939)
12462* BFD_RELOC_ARM_T32_VLDR_VSTR_OFF_IMM:   howto manager.      (line  933)
12463* BFD_RELOC_ARM_TARGET1:                 howto manager.      (line  826)
12464* BFD_RELOC_ARM_TARGET2:                 howto manager.      (line  833)
12465* BFD_RELOC_ARM_THM_TLS_CALL:            howto manager.      (line  875)
12466* BFD_RELOC_ARM_THM_TLS_DESCSEQ:         howto manager.      (line  877)
12467* BFD_RELOC_ARM_THUMB_ADD:               howto manager.      (line  942)
12468* BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC:     howto manager.      (line  913)
12469* BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC:     howto manager.      (line  914)
12470* BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC:     howto manager.      (line  915)
12471* BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC:     howto manager.      (line  916)
12472* BFD_RELOC_ARM_THUMB_BF13:              howto manager.      (line  803)
12473* BFD_RELOC_ARM_THUMB_BF17:              howto manager.      (line  801)
12474* BFD_RELOC_ARM_THUMB_BF19:              howto manager.      (line  805)
12475* BFD_RELOC_ARM_THUMB_IMM:               howto manager.      (line  943)
12476* BFD_RELOC_ARM_THUMB_LOOP12:            howto manager.      (line  807)
12477* BFD_RELOC_ARM_THUMB_MOVT:              howto manager.      (line  844)
12478* BFD_RELOC_ARM_THUMB_MOVT_PCREL:        howto manager.      (line  846)
12479* BFD_RELOC_ARM_THUMB_MOVW:              howto manager.      (line  843)
12480* BFD_RELOC_ARM_THUMB_MOVW_PCREL:        howto manager.      (line  845)
12481* BFD_RELOC_ARM_THUMB_OFFSET:            howto manager.      (line  823)
12482* BFD_RELOC_ARM_THUMB_SHIFT:             howto manager.      (line  944)
12483* BFD_RELOC_ARM_TLS_CALL:                howto manager.      (line  874)
12484* BFD_RELOC_ARM_TLS_DESC:                howto manager.      (line  878)
12485* BFD_RELOC_ARM_TLS_DESCSEQ:             howto manager.      (line  876)
12486* BFD_RELOC_ARM_TLS_DTPMOD32:            howto manager.      (line  869)
12487* BFD_RELOC_ARM_TLS_DTPOFF32:            howto manager.      (line  868)
12488* BFD_RELOC_ARM_TLS_GD32:                howto manager.      (line  865)
12489* BFD_RELOC_ARM_TLS_GD32_FDPIC:          howto manager.      (line  852)
12490* BFD_RELOC_ARM_TLS_GOTDESC:             howto manager.      (line  873)
12491* BFD_RELOC_ARM_TLS_IE32:                howto manager.      (line  871)
12492* BFD_RELOC_ARM_TLS_IE32_FDPIC:          howto manager.      (line  854)
12493* BFD_RELOC_ARM_TLS_LDM32:               howto manager.      (line  867)
12494* BFD_RELOC_ARM_TLS_LDM32_FDPIC:         howto manager.      (line  853)
12495* BFD_RELOC_ARM_TLS_LDO32:               howto manager.      (line  866)
12496* BFD_RELOC_ARM_TLS_LE32:                howto manager.      (line  872)
12497* BFD_RELOC_ARM_TLS_TPOFF32:             howto manager.      (line  870)
12498* BFD_RELOC_ARM_V4BX:                    howto manager.      (line  909)
12499* BFD_RELOC_AVR_13_PCREL:                howto manager.      (line 1739)
12500* BFD_RELOC_AVR_16_PM:                   howto manager.      (line 1742)
12501* BFD_RELOC_AVR_6:                       howto manager.      (line 1810)
12502* BFD_RELOC_AVR_6_ADIW:                  howto manager.      (line 1813)
12503* BFD_RELOC_AVR_7_PCREL:                 howto manager.      (line 1736)
12504* BFD_RELOC_AVR_8_HI:                    howto manager.      (line 1819)
12505* BFD_RELOC_AVR_8_HLO:                   howto manager.      (line 1822)
12506* BFD_RELOC_AVR_8_LO:                    howto manager.      (line 1816)
12507* BFD_RELOC_AVR_CALL:                    howto manager.      (line 1804)
12508* BFD_RELOC_AVR_DIFF16:                  howto manager.      (line 1826)
12509* BFD_RELOC_AVR_DIFF32:                  howto manager.      (line 1827)
12510* BFD_RELOC_AVR_DIFF8:                   howto manager.      (line 1825)
12511* BFD_RELOC_AVR_HH8_LDI:                 howto manager.      (line 1751)
12512* BFD_RELOC_AVR_HH8_LDI_NEG:             howto manager.      (line 1766)
12513* BFD_RELOC_AVR_HH8_LDI_PM:              howto manager.      (line 1789)
12514* BFD_RELOC_AVR_HH8_LDI_PM_NEG:          howto manager.      (line 1800)
12515* BFD_RELOC_AVR_HI8_LDI:                 howto manager.      (line 1748)
12516* BFD_RELOC_AVR_HI8_LDI_GS:              howto manager.      (line 1784)
12517* BFD_RELOC_AVR_HI8_LDI_NEG:             howto manager.      (line 1762)
12518* BFD_RELOC_AVR_HI8_LDI_PM:              howto manager.      (line 1781)
12519* BFD_RELOC_AVR_HI8_LDI_PM_NEG:          howto manager.      (line 1796)
12520* BFD_RELOC_AVR_LDI:                     howto manager.      (line 1807)
12521* BFD_RELOC_AVR_LDS_STS_16:              howto manager.      (line 1834)
12522* BFD_RELOC_AVR_LO8_LDI:                 howto manager.      (line 1745)
12523* BFD_RELOC_AVR_LO8_LDI_GS:              howto manager.      (line 1776)
12524* BFD_RELOC_AVR_LO8_LDI_NEG:             howto manager.      (line 1758)
12525* BFD_RELOC_AVR_LO8_LDI_PM:              howto manager.      (line 1773)
12526* BFD_RELOC_AVR_LO8_LDI_PM_NEG:          howto manager.      (line 1793)
12527* BFD_RELOC_AVR_MS8_LDI:                 howto manager.      (line 1755)
12528* BFD_RELOC_AVR_MS8_LDI_NEG:             howto manager.      (line 1770)
12529* BFD_RELOC_AVR_PORT5:                   howto manager.      (line 1840)
12530* BFD_RELOC_AVR_PORT6:                   howto manager.      (line 1837)
12531* BFD_RELOC_BFIN_10_PCREL:               howto manager.      (line 1126)
12532* BFD_RELOC_BFIN_11_PCREL:               howto manager.      (line 1128)
12533* BFD_RELOC_BFIN_12_PCREL_JUMP:          howto manager.      (line 1130)
12534* BFD_RELOC_BFIN_12_PCREL_JUMP_S:        howto manager.      (line 1132)
12535* BFD_RELOC_BFIN_16_HIGH:                howto manager.      (line 1118)
12536* BFD_RELOC_BFIN_16_IMM:                 howto manager.      (line 1116)
12537* BFD_RELOC_BFIN_16_LOW:                 howto manager.      (line 1124)
12538* BFD_RELOC_BFIN_24_PCREL_CALL_X:        howto manager.      (line 1134)
12539* BFD_RELOC_BFIN_24_PCREL_JUMP_L:        howto manager.      (line 1136)
12540* BFD_RELOC_BFIN_4_PCREL:                howto manager.      (line 1120)
12541* BFD_RELOC_BFIN_5_PCREL:                howto manager.      (line 1122)
12542* BFD_RELOC_BFIN_FUNCDESC:               howto manager.      (line 1141)
12543* BFD_RELOC_BFIN_FUNCDESC_GOT17M4:       howto manager.      (line 1142)
12544* BFD_RELOC_BFIN_FUNCDESC_GOTHI:         howto manager.      (line 1143)
12545* BFD_RELOC_BFIN_FUNCDESC_GOTLO:         howto manager.      (line 1144)
12546* BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4:    howto manager.      (line 1146)
12547* BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI:      howto manager.      (line 1147)
12548* BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO:      howto manager.      (line 1148)
12549* BFD_RELOC_BFIN_FUNCDESC_VALUE:         howto manager.      (line 1145)
12550* BFD_RELOC_BFIN_GOT:                    howto manager.      (line 1153)
12551* BFD_RELOC_BFIN_GOT17M4:                howto manager.      (line 1138)
12552* BFD_RELOC_BFIN_GOTHI:                  howto manager.      (line 1139)
12553* BFD_RELOC_BFIN_GOTLO:                  howto manager.      (line 1140)
12554* BFD_RELOC_BFIN_GOTOFF17M4:             howto manager.      (line 1149)
12555* BFD_RELOC_BFIN_GOTOFFHI:               howto manager.      (line 1150)
12556* BFD_RELOC_BFIN_GOTOFFLO:               howto manager.      (line 1151)
12557* BFD_RELOC_BFIN_PLTPC:                  howto manager.      (line 1155)
12558* BFD_RELOC_BPF_64:                      howto manager.      (line 3415)
12559* BFD_RELOC_BPF_DISP16:                  howto manager.      (line 3418)
12560* BFD_RELOC_BPF_DISP32:                  howto manager.      (line 3416)
12561* BFD_RELOC_BPF_DISPCALL32:              howto manager.      (line 3417)
12562* BFD_RELOC_C6000_ABS_H16:               howto manager.      (line 1581)
12563* BFD_RELOC_C6000_ABS_L16:               howto manager.      (line 1580)
12564* BFD_RELOC_C6000_ABS_S16:               howto manager.      (line 1579)
12565* BFD_RELOC_C6000_ALIGN:                 howto manager.      (line 1602)
12566* BFD_RELOC_C6000_COPY:                  howto manager.      (line 1597)
12567* BFD_RELOC_C6000_DSBT_INDEX:            howto manager.      (line 1595)
12568* BFD_RELOC_C6000_EHTYPE:                howto manager.      (line 1599)
12569* BFD_RELOC_C6000_FPHEAD:                howto manager.      (line 1603)
12570* BFD_RELOC_C6000_JUMP_SLOT:             howto manager.      (line 1598)
12571* BFD_RELOC_C6000_NOCMP:                 howto manager.      (line 1604)
12572* BFD_RELOC_C6000_PCR_H16:               howto manager.      (line 1600)
12573* BFD_RELOC_C6000_PCR_L16:               howto manager.      (line 1601)
12574* BFD_RELOC_C6000_PCR_S10:               howto manager.      (line 1577)
12575* BFD_RELOC_C6000_PCR_S12:               howto manager.      (line 1576)
12576* BFD_RELOC_C6000_PCR_S21:               howto manager.      (line 1575)
12577* BFD_RELOC_C6000_PCR_S7:                howto manager.      (line 1578)
12578* BFD_RELOC_C6000_PREL31:                howto manager.      (line 1596)
12579* BFD_RELOC_C6000_SBR_GOT_H16_W:         howto manager.      (line 1594)
12580* BFD_RELOC_C6000_SBR_GOT_L16_W:         howto manager.      (line 1593)
12581* BFD_RELOC_C6000_SBR_GOT_U15_W:         howto manager.      (line 1592)
12582* BFD_RELOC_C6000_SBR_H16_B:             howto manager.      (line 1589)
12583* BFD_RELOC_C6000_SBR_H16_H:             howto manager.      (line 1590)
12584* BFD_RELOC_C6000_SBR_H16_W:             howto manager.      (line 1591)
12585* BFD_RELOC_C6000_SBR_L16_B:             howto manager.      (line 1586)
12586* BFD_RELOC_C6000_SBR_L16_H:             howto manager.      (line 1587)
12587* BFD_RELOC_C6000_SBR_L16_W:             howto manager.      (line 1588)
12588* BFD_RELOC_C6000_SBR_S16:               howto manager.      (line 1585)
12589* BFD_RELOC_C6000_SBR_U15_B:             howto manager.      (line 1582)
12590* BFD_RELOC_C6000_SBR_U15_H:             howto manager.      (line 1583)
12591* BFD_RELOC_C6000_SBR_U15_W:             howto manager.      (line 1584)
12592* BFD_RELOC_CKCORE_ADDR32:               howto manager.      (line 3455)
12593* BFD_RELOC_CKCORE_ADDRGOT:              howto manager.      (line 3471)
12594* BFD_RELOC_CKCORE_ADDRGOT_HI16:         howto manager.      (line 3490)
12595* BFD_RELOC_CKCORE_ADDRGOT_LO16:         howto manager.      (line 3491)
12596* BFD_RELOC_CKCORE_ADDRPLT:              howto manager.      (line 3472)
12597* BFD_RELOC_CKCORE_ADDRPLT_HI16:         howto manager.      (line 3492)
12598* BFD_RELOC_CKCORE_ADDRPLT_LO16:         howto manager.      (line 3493)
12599* BFD_RELOC_CKCORE_ADDR_HI16:            howto manager.      (line 3478)
12600* BFD_RELOC_CKCORE_ADDR_LO16:            howto manager.      (line 3479)
12601* BFD_RELOC_CKCORE_CALLGRAPH:            howto manager.      (line 3515)
12602* BFD_RELOC_CKCORE_COPY:                 howto manager.      (line 3464)
12603* BFD_RELOC_CKCORE_DOFFSET_IMM18:        howto manager.      (line 3498)
12604* BFD_RELOC_CKCORE_DOFFSET_IMM18BY2:     howto manager.      (line 3499)
12605* BFD_RELOC_CKCORE_DOFFSET_IMM18BY4:     howto manager.      (line 3500)
12606* BFD_RELOC_CKCORE_DOFFSET_LO16:         howto manager.      (line 3496)
12607* BFD_RELOC_CKCORE_GLOB_DAT:             howto manager.      (line 3465)
12608* BFD_RELOC_CKCORE_GNU_VTENTRY:          howto manager.      (line 3462)
12609* BFD_RELOC_CKCORE_GNU_VTINHERIT:        howto manager.      (line 3461)
12610* BFD_RELOC_CKCORE_GOT12:                howto manager.      (line 3484)
12611* BFD_RELOC_CKCORE_GOT32:                howto manager.      (line 3469)
12612* BFD_RELOC_CKCORE_GOTOFF:               howto manager.      (line 3467)
12613* BFD_RELOC_CKCORE_GOTOFF_HI16:          howto manager.      (line 3482)
12614* BFD_RELOC_CKCORE_GOTOFF_IMM18:         howto manager.      (line 3501)
12615* BFD_RELOC_CKCORE_GOTOFF_LO16:          howto manager.      (line 3483)
12616* BFD_RELOC_CKCORE_GOTPC:                howto manager.      (line 3468)
12617* BFD_RELOC_CKCORE_GOTPC_HI16:           howto manager.      (line 3480)
12618* BFD_RELOC_CKCORE_GOTPC_LO16:           howto manager.      (line 3481)
12619* BFD_RELOC_CKCORE_GOT_HI16:             howto manager.      (line 3485)
12620* BFD_RELOC_CKCORE_GOT_IMM18BY4:         howto manager.      (line 3502)
12621* BFD_RELOC_CKCORE_GOT_LO16:             howto manager.      (line 3486)
12622* BFD_RELOC_CKCORE_IRELATIVE:            howto manager.      (line 3516)
12623* BFD_RELOC_CKCORE_JUMP_SLOT:            howto manager.      (line 3466)
12624* BFD_RELOC_CKCORE_NOJSRI:               howto manager.      (line 3514)
12625* BFD_RELOC_CKCORE_NONE:                 howto manager.      (line 3454)
12626* BFD_RELOC_CKCORE_PCREL32:              howto manager.      (line 3459)
12627* BFD_RELOC_CKCORE_PCREL_BLOOP_IMM12BY4: howto manager.      (line 3518)
12628* BFD_RELOC_CKCORE_PCREL_BLOOP_IMM4BY4:  howto manager.      (line 3517)
12629* BFD_RELOC_CKCORE_PCREL_FLRW_IMM8BY4:   howto manager.      (line 3513)
12630* BFD_RELOC_CKCORE_PCREL_IMM10BY2:       howto manager.      (line 3476)
12631* BFD_RELOC_CKCORE_PCREL_IMM10BY4:       howto manager.      (line 3477)
12632* BFD_RELOC_CKCORE_PCREL_IMM11BY2:       howto manager.      (line 3457)
12633* BFD_RELOC_CKCORE_PCREL_IMM16BY2:       howto manager.      (line 3474)
12634* BFD_RELOC_CKCORE_PCREL_IMM16BY4:       howto manager.      (line 3475)
12635* BFD_RELOC_CKCORE_PCREL_IMM18BY2:       howto manager.      (line 3497)
12636* BFD_RELOC_CKCORE_PCREL_IMM26BY2:       howto manager.      (line 3473)
12637* BFD_RELOC_CKCORE_PCREL_IMM4BY2:        howto manager.      (line 3458)
12638* BFD_RELOC_CKCORE_PCREL_IMM7BY4:        howto manager.      (line 3504)
12639* BFD_RELOC_CKCORE_PCREL_IMM8BY4:        howto manager.      (line 3456)
12640* BFD_RELOC_CKCORE_PCREL_JSR_IMM11BY2:   howto manager.      (line 3460)
12641* BFD_RELOC_CKCORE_PCREL_JSR_IMM26BY2:   howto manager.      (line 3494)
12642* BFD_RELOC_CKCORE_PLT12:                howto manager.      (line 3487)
12643* BFD_RELOC_CKCORE_PLT32:                howto manager.      (line 3470)
12644* BFD_RELOC_CKCORE_PLT_HI16:             howto manager.      (line 3488)
12645* BFD_RELOC_CKCORE_PLT_IMM18BY4:         howto manager.      (line 3503)
12646* BFD_RELOC_CKCORE_PLT_LO16:             howto manager.      (line 3489)
12647* BFD_RELOC_CKCORE_RELATIVE:             howto manager.      (line 3463)
12648* BFD_RELOC_CKCORE_TLS_DTPMOD32:         howto manager.      (line 3510)
12649* BFD_RELOC_CKCORE_TLS_DTPOFF32:         howto manager.      (line 3511)
12650* BFD_RELOC_CKCORE_TLS_GD32:             howto manager.      (line 3507)
12651* BFD_RELOC_CKCORE_TLS_IE32:             howto manager.      (line 3506)
12652* BFD_RELOC_CKCORE_TLS_LDM32:            howto manager.      (line 3508)
12653* BFD_RELOC_CKCORE_TLS_LDO32:            howto manager.      (line 3509)
12654* BFD_RELOC_CKCORE_TLS_LE32:             howto manager.      (line 3505)
12655* BFD_RELOC_CKCORE_TLS_TPOFF32:          howto manager.      (line 3512)
12656* BFD_RELOC_CKCORE_TOFFSET_LO16:         howto manager.      (line 3495)
12657* bfd_reloc_code_real_type:              howto manager.      (line    9)
12658* BFD_RELOC_CR16_ABS20:                  howto manager.      (line 2278)
12659* BFD_RELOC_CR16_ABS24:                  howto manager.      (line 2279)
12660* BFD_RELOC_CR16_DISP16:                 howto manager.      (line 2289)
12661* BFD_RELOC_CR16_DISP20:                 howto manager.      (line 2290)
12662* BFD_RELOC_CR16_DISP24:                 howto manager.      (line 2291)
12663* BFD_RELOC_CR16_DISP24a:                howto manager.      (line 2292)
12664* BFD_RELOC_CR16_DISP4:                  howto manager.      (line 2287)
12665* BFD_RELOC_CR16_DISP8:                  howto manager.      (line 2288)
12666* BFD_RELOC_CR16_GLOB_DAT:               howto manager.      (line 2298)
12667* BFD_RELOC_CR16_GOTC_REGREL20:          howto manager.      (line 2297)
12668* BFD_RELOC_CR16_GOT_REGREL20:           howto manager.      (line 2296)
12669* BFD_RELOC_CR16_IMM16:                  howto manager.      (line 2282)
12670* BFD_RELOC_CR16_IMM20:                  howto manager.      (line 2283)
12671* BFD_RELOC_CR16_IMM24:                  howto manager.      (line 2284)
12672* BFD_RELOC_CR16_IMM32:                  howto manager.      (line 2285)
12673* BFD_RELOC_CR16_IMM32a:                 howto manager.      (line 2286)
12674* BFD_RELOC_CR16_IMM4:                   howto manager.      (line 2280)
12675* BFD_RELOC_CR16_IMM8:                   howto manager.      (line 2281)
12676* BFD_RELOC_CR16_NUM16:                  howto manager.      (line 2267)
12677* BFD_RELOC_CR16_NUM32:                  howto manager.      (line 2268)
12678* BFD_RELOC_CR16_NUM32a:                 howto manager.      (line 2269)
12679* BFD_RELOC_CR16_NUM8:                   howto manager.      (line 2266)
12680* BFD_RELOC_CR16_REGREL0:                howto manager.      (line 2270)
12681* BFD_RELOC_CR16_REGREL14:               howto manager.      (line 2273)
12682* BFD_RELOC_CR16_REGREL14a:              howto manager.      (line 2274)
12683* BFD_RELOC_CR16_REGREL16:               howto manager.      (line 2275)
12684* BFD_RELOC_CR16_REGREL20:               howto manager.      (line 2276)
12685* BFD_RELOC_CR16_REGREL20a:              howto manager.      (line 2277)
12686* BFD_RELOC_CR16_REGREL4:                howto manager.      (line 2271)
12687* BFD_RELOC_CR16_REGREL4a:               howto manager.      (line 2272)
12688* BFD_RELOC_CR16_SWITCH16:               howto manager.      (line 2294)
12689* BFD_RELOC_CR16_SWITCH32:               howto manager.      (line 2295)
12690* BFD_RELOC_CR16_SWITCH8:                howto manager.      (line 2293)
12691* BFD_RELOC_CRIS_16_DTPREL:              howto manager.      (line 2358)
12692* BFD_RELOC_CRIS_16_GOT:                 howto manager.      (line 2340)
12693* BFD_RELOC_CRIS_16_GOTPLT:              howto manager.      (line 2344)
12694* BFD_RELOC_CRIS_16_GOT_GD:              howto manager.      (line 2354)
12695* BFD_RELOC_CRIS_16_GOT_TPREL:           howto manager.      (line 2360)
12696* BFD_RELOC_CRIS_16_TPREL:               howto manager.      (line 2362)
12697* BFD_RELOC_CRIS_32_DTPREL:              howto manager.      (line 2357)
12698* BFD_RELOC_CRIS_32_GD:                  howto manager.      (line 2355)
12699* BFD_RELOC_CRIS_32_GOT:                 howto manager.      (line 2338)
12700* BFD_RELOC_CRIS_32_GOTPLT:              howto manager.      (line 2342)
12701* BFD_RELOC_CRIS_32_GOTREL:              howto manager.      (line 2346)
12702* BFD_RELOC_CRIS_32_GOT_GD:              howto manager.      (line 2353)
12703* BFD_RELOC_CRIS_32_GOT_TPREL:           howto manager.      (line 2359)
12704* BFD_RELOC_CRIS_32_IE:                  howto manager.      (line 2364)
12705* BFD_RELOC_CRIS_32_PLT_GOTREL:          howto manager.      (line 2348)
12706* BFD_RELOC_CRIS_32_PLT_PCREL:           howto manager.      (line 2350)
12707* BFD_RELOC_CRIS_32_TPREL:               howto manager.      (line 2361)
12708* BFD_RELOC_CRIS_BDISP8:                 howto manager.      (line 2321)
12709* BFD_RELOC_CRIS_COPY:                   howto manager.      (line 2333)
12710* BFD_RELOC_CRIS_DTP:                    howto manager.      (line 2356)
12711* BFD_RELOC_CRIS_DTPMOD:                 howto manager.      (line 2363)
12712* BFD_RELOC_CRIS_GLOB_DAT:               howto manager.      (line 2334)
12713* BFD_RELOC_CRIS_JUMP_SLOT:              howto manager.      (line 2335)
12714* BFD_RELOC_CRIS_LAPCQ_OFFSET:           howto manager.      (line 2329)
12715* BFD_RELOC_CRIS_RELATIVE:               howto manager.      (line 2336)
12716* BFD_RELOC_CRIS_SIGNED_16:              howto manager.      (line 2327)
12717* BFD_RELOC_CRIS_SIGNED_6:               howto manager.      (line 2323)
12718* BFD_RELOC_CRIS_SIGNED_8:               howto manager.      (line 2325)
12719* BFD_RELOC_CRIS_UNSIGNED_16:            howto manager.      (line 2328)
12720* BFD_RELOC_CRIS_UNSIGNED_4:             howto manager.      (line 2330)
12721* BFD_RELOC_CRIS_UNSIGNED_5:             howto manager.      (line 2322)
12722* BFD_RELOC_CRIS_UNSIGNED_6:             howto manager.      (line 2324)
12723* BFD_RELOC_CRIS_UNSIGNED_8:             howto manager.      (line 2326)
12724* BFD_RELOC_CRX_ABS16:                   howto manager.      (line 2310)
12725* BFD_RELOC_CRX_ABS32:                   howto manager.      (line 2311)
12726* BFD_RELOC_CRX_IMM16:                   howto manager.      (line 2315)
12727* BFD_RELOC_CRX_IMM32:                   howto manager.      (line 2316)
12728* BFD_RELOC_CRX_NUM16:                   howto manager.      (line 2313)
12729* BFD_RELOC_CRX_NUM32:                   howto manager.      (line 2314)
12730* BFD_RELOC_CRX_NUM8:                    howto manager.      (line 2312)
12731* BFD_RELOC_CRX_REGREL12:                howto manager.      (line 2306)
12732* BFD_RELOC_CRX_REGREL22:                howto manager.      (line 2307)
12733* BFD_RELOC_CRX_REGREL28:                howto manager.      (line 2308)
12734* BFD_RELOC_CRX_REGREL32:                howto manager.      (line 2309)
12735* BFD_RELOC_CRX_REL16:                   howto manager.      (line 2303)
12736* BFD_RELOC_CRX_REL24:                   howto manager.      (line 2304)
12737* BFD_RELOC_CRX_REL32:                   howto manager.      (line 2305)
12738* BFD_RELOC_CRX_REL4:                    howto manager.      (line 2300)
12739* BFD_RELOC_CRX_REL8:                    howto manager.      (line 2301)
12740* BFD_RELOC_CRX_REL8_CMP:                howto manager.      (line 2302)
12741* BFD_RELOC_CRX_SWITCH16:                howto manager.      (line 2318)
12742* BFD_RELOC_CRX_SWITCH32:                howto manager.      (line 2319)
12743* BFD_RELOC_CRX_SWITCH8:                 howto manager.      (line 2317)
12744* BFD_RELOC_CTOR:                        howto manager.      (line  776)
12745* BFD_RELOC_D10V_10_PCREL_L:             howto manager.      (line 1200)
12746* BFD_RELOC_D10V_10_PCREL_R:             howto manager.      (line 1197)
12747* BFD_RELOC_D10V_18:                     howto manager.      (line 1204)
12748* BFD_RELOC_D10V_18_PCREL:               howto manager.      (line 1206)
12749* BFD_RELOC_D30V_15:                     howto manager.      (line 1217)
12750* BFD_RELOC_D30V_15_PCREL:               howto manager.      (line 1220)
12751* BFD_RELOC_D30V_15_PCREL_R:             howto manager.      (line 1223)
12752* BFD_RELOC_D30V_21:                     howto manager.      (line 1227)
12753* BFD_RELOC_D30V_21_PCREL:               howto manager.      (line 1230)
12754* BFD_RELOC_D30V_21_PCREL_R:             howto manager.      (line 1233)
12755* BFD_RELOC_D30V_32:                     howto manager.      (line 1237)
12756* BFD_RELOC_D30V_32_PCREL:               howto manager.      (line 1239)
12757* BFD_RELOC_D30V_6:                      howto manager.      (line 1208)
12758* BFD_RELOC_D30V_9_PCREL:                howto manager.      (line 1210)
12759* BFD_RELOC_D30V_9_PCREL_R:              howto manager.      (line 1213)
12760* BFD_RELOC_DLX_HI16_S:                  howto manager.      (line 1241)
12761* BFD_RELOC_DLX_JMP26:                   howto manager.      (line 1243)
12762* BFD_RELOC_DLX_LO16:                    howto manager.      (line 1242)
12763* BFD_RELOC_EPIPHANY_HIGH:               howto manager.      (line 3424)
12764* BFD_RELOC_EPIPHANY_IMM11:              howto manager.      (line 3430)
12765* BFD_RELOC_EPIPHANY_IMM8:               howto manager.      (line 3433)
12766* BFD_RELOC_EPIPHANY_LOW:                howto manager.      (line 3426)
12767* BFD_RELOC_EPIPHANY_SIMM11:             howto manager.      (line 3428)
12768* BFD_RELOC_EPIPHANY_SIMM24:             howto manager.      (line 3422)
12769* BFD_RELOC_EPIPHANY_SIMM8:              howto manager.      (line 3420)
12770* BFD_RELOC_FR30_10_IN_8:                howto manager.      (line 1620)
12771* BFD_RELOC_FR30_12_PCREL:               howto manager.      (line 1626)
12772* BFD_RELOC_FR30_20:                     howto manager.      (line 1608)
12773* BFD_RELOC_FR30_48:                     howto manager.      (line 1606)
12774* BFD_RELOC_FR30_6_IN_4:                 howto manager.      (line 1611)
12775* BFD_RELOC_FR30_8_IN_8:                 howto manager.      (line 1614)
12776* BFD_RELOC_FR30_9_IN_8:                 howto manager.      (line 1617)
12777* BFD_RELOC_FR30_9_PCREL:                howto manager.      (line 1623)
12778* BFD_RELOC_FRV_FUNCDESC:                howto manager.      (line  451)
12779* BFD_RELOC_FRV_FUNCDESC_GOT12:          howto manager.      (line  452)
12780* BFD_RELOC_FRV_FUNCDESC_GOTHI:          howto manager.      (line  453)
12781* BFD_RELOC_FRV_FUNCDESC_GOTLO:          howto manager.      (line  454)
12782* BFD_RELOC_FRV_FUNCDESC_GOTOFF12:       howto manager.      (line  456)
12783* BFD_RELOC_FRV_FUNCDESC_GOTOFFHI:       howto manager.      (line  457)
12784* BFD_RELOC_FRV_FUNCDESC_GOTOFFLO:       howto manager.      (line  458)
12785* BFD_RELOC_FRV_FUNCDESC_VALUE:          howto manager.      (line  455)
12786* BFD_RELOC_FRV_GETTLSOFF:               howto manager.      (line  462)
12787* BFD_RELOC_FRV_GETTLSOFF_RELAX:         howto manager.      (line  475)
12788* BFD_RELOC_FRV_GOT12:                   howto manager.      (line  448)
12789* BFD_RELOC_FRV_GOTHI:                   howto manager.      (line  449)
12790* BFD_RELOC_FRV_GOTLO:                   howto manager.      (line  450)
12791* BFD_RELOC_FRV_GOTOFF12:                howto manager.      (line  459)
12792* BFD_RELOC_FRV_GOTOFFHI:                howto manager.      (line  460)
12793* BFD_RELOC_FRV_GOTOFFLO:                howto manager.      (line  461)
12794* BFD_RELOC_FRV_GOTTLSDESC12:            howto manager.      (line  464)
12795* BFD_RELOC_FRV_GOTTLSDESCHI:            howto manager.      (line  465)
12796* BFD_RELOC_FRV_GOTTLSDESCLO:            howto manager.      (line  466)
12797* BFD_RELOC_FRV_GOTTLSOFF12:             howto manager.      (line  470)
12798* BFD_RELOC_FRV_GOTTLSOFFHI:             howto manager.      (line  471)
12799* BFD_RELOC_FRV_GOTTLSOFFLO:             howto manager.      (line  472)
12800* BFD_RELOC_FRV_GPREL12:                 howto manager.      (line  443)
12801* BFD_RELOC_FRV_GPREL32:                 howto manager.      (line  445)
12802* BFD_RELOC_FRV_GPRELHI:                 howto manager.      (line  446)
12803* BFD_RELOC_FRV_GPRELLO:                 howto manager.      (line  447)
12804* BFD_RELOC_FRV_GPRELU12:                howto manager.      (line  444)
12805* BFD_RELOC_FRV_HI16:                    howto manager.      (line  442)
12806* BFD_RELOC_FRV_LABEL16:                 howto manager.      (line  439)
12807* BFD_RELOC_FRV_LABEL24:                 howto manager.      (line  440)
12808* BFD_RELOC_FRV_LO16:                    howto manager.      (line  441)
12809* BFD_RELOC_FRV_TLSDESC_RELAX:           howto manager.      (line  474)
12810* BFD_RELOC_FRV_TLSDESC_VALUE:           howto manager.      (line  463)
12811* BFD_RELOC_FRV_TLSMOFF:                 howto manager.      (line  477)
12812* BFD_RELOC_FRV_TLSMOFF12:               howto manager.      (line  467)
12813* BFD_RELOC_FRV_TLSMOFFHI:               howto manager.      (line  468)
12814* BFD_RELOC_FRV_TLSMOFFLO:               howto manager.      (line  469)
12815* BFD_RELOC_FRV_TLSOFF:                  howto manager.      (line  473)
12816* BFD_RELOC_FRV_TLSOFF_RELAX:            howto manager.      (line  476)
12817* BFD_RELOC_FT32_10:                     howto manager.      (line  429)
12818* BFD_RELOC_FT32_15:                     howto manager.      (line  436)
12819* BFD_RELOC_FT32_17:                     howto manager.      (line  431)
12820* BFD_RELOC_FT32_18:                     howto manager.      (line  432)
12821* BFD_RELOC_FT32_20:                     howto manager.      (line  430)
12822* BFD_RELOC_FT32_DIFF32:                 howto manager.      (line  437)
12823* BFD_RELOC_FT32_RELAX:                  howto manager.      (line  433)
12824* BFD_RELOC_FT32_SC0:                    howto manager.      (line  434)
12825* BFD_RELOC_FT32_SC1:                    howto manager.      (line  435)
12826* BFD_RELOC_GPREL16:                     howto manager.      (line  112)
12827* BFD_RELOC_GPREL32:                     howto manager.      (line  113)
12828* BFD_RELOC_H8_DIR16A8:                  howto manager.      (line 2407)
12829* BFD_RELOC_H8_DIR16R8:                  howto manager.      (line 2408)
12830* BFD_RELOC_H8_DIR24A8:                  howto manager.      (line 2409)
12831* BFD_RELOC_H8_DIR24R8:                  howto manager.      (line 2410)
12832* BFD_RELOC_H8_DIR32A16:                 howto manager.      (line 2411)
12833* BFD_RELOC_H8_DISP32A16:                howto manager.      (line 2412)
12834* BFD_RELOC_HI16:                        howto manager.      (line  312)
12835* BFD_RELOC_HI16_BASEREL:                howto manager.      (line   92)
12836* BFD_RELOC_HI16_GOTOFF:                 howto manager.      (line   51)
12837* BFD_RELOC_HI16_PCREL:                  howto manager.      (line  321)
12838* BFD_RELOC_HI16_PLTOFF:                 howto manager.      (line   63)
12839* BFD_RELOC_HI16_S:                      howto manager.      (line  314)
12840* BFD_RELOC_HI16_S_BASEREL:              howto manager.      (line   93)
12841* BFD_RELOC_HI16_S_GOTOFF:               howto manager.      (line   52)
12842* BFD_RELOC_HI16_S_PCREL:                howto manager.      (line  323)
12843* BFD_RELOC_HI16_S_PLTOFF:               howto manager.      (line   64)
12844* BFD_RELOC_HI22:                        howto manager.      (line  108)
12845* BFD_RELOC_I370_D12:                    howto manager.      (line  774)
12846* BFD_RELOC_IA64_COPY:                   howto manager.      (line 2164)
12847* BFD_RELOC_IA64_DIR32LSB:               howto manager.      (line 2109)
12848* BFD_RELOC_IA64_DIR32MSB:               howto manager.      (line 2108)
12849* BFD_RELOC_IA64_DIR64LSB:               howto manager.      (line 2111)
12850* BFD_RELOC_IA64_DIR64MSB:               howto manager.      (line 2110)
12851* BFD_RELOC_IA64_DTPMOD64LSB:            howto manager.      (line 2174)
12852* BFD_RELOC_IA64_DTPMOD64MSB:            howto manager.      (line 2173)
12853* BFD_RELOC_IA64_DTPREL14:               howto manager.      (line 2176)
12854* BFD_RELOC_IA64_DTPREL22:               howto manager.      (line 2177)
12855* BFD_RELOC_IA64_DTPREL32LSB:            howto manager.      (line 2180)
12856* BFD_RELOC_IA64_DTPREL32MSB:            howto manager.      (line 2179)
12857* BFD_RELOC_IA64_DTPREL64I:              howto manager.      (line 2178)
12858* BFD_RELOC_IA64_DTPREL64LSB:            howto manager.      (line 2182)
12859* BFD_RELOC_IA64_DTPREL64MSB:            howto manager.      (line 2181)
12860* BFD_RELOC_IA64_FPTR32LSB:              howto manager.      (line 2126)
12861* BFD_RELOC_IA64_FPTR32MSB:              howto manager.      (line 2125)
12862* BFD_RELOC_IA64_FPTR64I:                howto manager.      (line 2124)
12863* BFD_RELOC_IA64_FPTR64LSB:              howto manager.      (line 2128)
12864* BFD_RELOC_IA64_FPTR64MSB:              howto manager.      (line 2127)
12865* BFD_RELOC_IA64_GPREL22:                howto manager.      (line 2112)
12866* BFD_RELOC_IA64_GPREL32LSB:             howto manager.      (line 2115)
12867* BFD_RELOC_IA64_GPREL32MSB:             howto manager.      (line 2114)
12868* BFD_RELOC_IA64_GPREL64I:               howto manager.      (line 2113)
12869* BFD_RELOC_IA64_GPREL64LSB:             howto manager.      (line 2117)
12870* BFD_RELOC_IA64_GPREL64MSB:             howto manager.      (line 2116)
12871* BFD_RELOC_IA64_IMM14:                  howto manager.      (line 2105)
12872* BFD_RELOC_IA64_IMM22:                  howto manager.      (line 2106)
12873* BFD_RELOC_IA64_IMM64:                  howto manager.      (line 2107)
12874* BFD_RELOC_IA64_IPLTLSB:                howto manager.      (line 2163)
12875* BFD_RELOC_IA64_IPLTMSB:                howto manager.      (line 2162)
12876* BFD_RELOC_IA64_LDXMOV:                 howto manager.      (line 2166)
12877* BFD_RELOC_IA64_LTOFF22:                howto manager.      (line 2118)
12878* BFD_RELOC_IA64_LTOFF22X:               howto manager.      (line 2165)
12879* BFD_RELOC_IA64_LTOFF64I:               howto manager.      (line 2119)
12880* BFD_RELOC_IA64_LTOFF_DTPMOD22:         howto manager.      (line 2175)
12881* BFD_RELOC_IA64_LTOFF_DTPREL22:         howto manager.      (line 2183)
12882* BFD_RELOC_IA64_LTOFF_FPTR22:           howto manager.      (line 2140)
12883* BFD_RELOC_IA64_LTOFF_FPTR32LSB:        howto manager.      (line 2143)
12884* BFD_RELOC_IA64_LTOFF_FPTR32MSB:        howto manager.      (line 2142)
12885* BFD_RELOC_IA64_LTOFF_FPTR64I:          howto manager.      (line 2141)
12886* BFD_RELOC_IA64_LTOFF_FPTR64LSB:        howto manager.      (line 2145)
12887* BFD_RELOC_IA64_LTOFF_FPTR64MSB:        howto manager.      (line 2144)
12888* BFD_RELOC_IA64_LTOFF_TPREL22:          howto manager.      (line 2172)
12889* BFD_RELOC_IA64_LTV32LSB:               howto manager.      (line 2159)
12890* BFD_RELOC_IA64_LTV32MSB:               howto manager.      (line 2158)
12891* BFD_RELOC_IA64_LTV64LSB:               howto manager.      (line 2161)
12892* BFD_RELOC_IA64_LTV64MSB:               howto manager.      (line 2160)
12893* BFD_RELOC_IA64_PCREL21B:               howto manager.      (line 2129)
12894* BFD_RELOC_IA64_PCREL21BI:              howto manager.      (line 2130)
12895* BFD_RELOC_IA64_PCREL21F:               howto manager.      (line 2132)
12896* BFD_RELOC_IA64_PCREL21M:               howto manager.      (line 2131)
12897* BFD_RELOC_IA64_PCREL22:                howto manager.      (line 2133)
12898* BFD_RELOC_IA64_PCREL32LSB:             howto manager.      (line 2137)
12899* BFD_RELOC_IA64_PCREL32MSB:             howto manager.      (line 2136)
12900* BFD_RELOC_IA64_PCREL60B:               howto manager.      (line 2134)
12901* BFD_RELOC_IA64_PCREL64I:               howto manager.      (line 2135)
12902* BFD_RELOC_IA64_PCREL64LSB:             howto manager.      (line 2139)
12903* BFD_RELOC_IA64_PCREL64MSB:             howto manager.      (line 2138)
12904* BFD_RELOC_IA64_PLTOFF22:               howto manager.      (line 2120)
12905* BFD_RELOC_IA64_PLTOFF64I:              howto manager.      (line 2121)
12906* BFD_RELOC_IA64_PLTOFF64LSB:            howto manager.      (line 2123)
12907* BFD_RELOC_IA64_PLTOFF64MSB:            howto manager.      (line 2122)
12908* BFD_RELOC_IA64_REL32LSB:               howto manager.      (line 2155)
12909* BFD_RELOC_IA64_REL32MSB:               howto manager.      (line 2154)
12910* BFD_RELOC_IA64_REL64LSB:               howto manager.      (line 2157)
12911* BFD_RELOC_IA64_REL64MSB:               howto manager.      (line 2156)
12912* BFD_RELOC_IA64_SECREL32LSB:            howto manager.      (line 2151)
12913* BFD_RELOC_IA64_SECREL32MSB:            howto manager.      (line 2150)
12914* BFD_RELOC_IA64_SECREL64LSB:            howto manager.      (line 2153)
12915* BFD_RELOC_IA64_SECREL64MSB:            howto manager.      (line 2152)
12916* BFD_RELOC_IA64_SEGREL32LSB:            howto manager.      (line 2147)
12917* BFD_RELOC_IA64_SEGREL32MSB:            howto manager.      (line 2146)
12918* BFD_RELOC_IA64_SEGREL64LSB:            howto manager.      (line 2149)
12919* BFD_RELOC_IA64_SEGREL64MSB:            howto manager.      (line 2148)
12920* BFD_RELOC_IA64_TPREL14:                howto manager.      (line 2167)
12921* BFD_RELOC_IA64_TPREL22:                howto manager.      (line 2168)
12922* BFD_RELOC_IA64_TPREL64I:               howto manager.      (line 2169)
12923* BFD_RELOC_IA64_TPREL64LSB:             howto manager.      (line 2171)
12924* BFD_RELOC_IA64_TPREL64MSB:             howto manager.      (line 2170)
12925* BFD_RELOC_IP2K_ADDR16CJP:              howto manager.      (line 2066)
12926* BFD_RELOC_IP2K_BANK:                   howto manager.      (line 2064)
12927* BFD_RELOC_IP2K_EX8DATA:                howto manager.      (line 2072)
12928* BFD_RELOC_IP2K_FR9:                    howto manager.      (line 2062)
12929* BFD_RELOC_IP2K_FR_OFFSET:              howto manager.      (line 2081)
12930* BFD_RELOC_IP2K_HI8DATA:                howto manager.      (line 2071)
12931* BFD_RELOC_IP2K_HI8INSN:                howto manager.      (line 2075)
12932* BFD_RELOC_IP2K_LO8DATA:                howto manager.      (line 2070)
12933* BFD_RELOC_IP2K_LO8INSN:                howto manager.      (line 2074)
12934* BFD_RELOC_IP2K_PAGE3:                  howto manager.      (line 2068)
12935* BFD_RELOC_IP2K_PC_SKIP:                howto manager.      (line 2077)
12936* BFD_RELOC_IP2K_TEXT:                   howto manager.      (line 2079)
12937* BFD_RELOC_IQ2000_OFFSET_16:            howto manager.      (line 2543)
12938* BFD_RELOC_IQ2000_OFFSET_21:            howto manager.      (line 2544)
12939* BFD_RELOC_IQ2000_UHI16:                howto manager.      (line 2545)
12940* BFD_RELOC_KVX_16:                      howto manager.      (line 2793)
12941* BFD_RELOC_KVX_32:                      howto manager.      (line 2794)
12942* BFD_RELOC_KVX_32_GOT:                  howto manager.      (line 2821)
12943* BFD_RELOC_KVX_32_GOTOFF:               howto manager.      (line 2819)
12944* BFD_RELOC_KVX_32_PCREL:                howto manager.      (line 2799)
12945* BFD_RELOC_KVX_64:                      howto manager.      (line 2795)
12946* BFD_RELOC_KVX_64_DTPMOD:               howto manager.      (line 2846)
12947* BFD_RELOC_KVX_64_DTPOFF:               howto manager.      (line 2847)
12948* BFD_RELOC_KVX_64_GOT:                  howto manager.      (line 2827)
12949* BFD_RELOC_KVX_64_GOTOFF:               howto manager.      (line 2820)
12950* BFD_RELOC_KVX_64_PCREL:                howto manager.      (line 2808)
12951* BFD_RELOC_KVX_64_TPOFF:                howto manager.      (line 2863)
12952* BFD_RELOC_KVX_8:                       howto manager.      (line 2874)
12953* BFD_RELOC_KVX_COPY:                    howto manager.      (line 2829)
12954* BFD_RELOC_KVX_GLOB_DAT:                howto manager.      (line 2828)
12955* BFD_RELOC_KVX_JMP_SLOT:                howto manager.      (line 2830)
12956* BFD_RELOC_KVX_NONE:                    howto manager.      (line 2791)
12957* BFD_RELOC_KVX_PCREL17:                 howto manager.      (line 2797)
12958* BFD_RELOC_KVX_PCREL27:                 howto manager.      (line 2798)
12959* BFD_RELOC_KVX_RELATIVE:                howto manager.      (line 2831)
12960* BFD_RELOC_KVX_RELOC_END:               howto manager.      (line 2876)
12961* BFD_RELOC_KVX_RELOC_START:             howto manager.      (line 2786)
12962* BFD_RELOC_KVX_S16:                     howto manager.      (line 2809)
12963* BFD_RELOC_KVX_S16_PCREL:               howto manager.      (line 2796)
12964* BFD_RELOC_KVX_S32_LO5:                 howto manager.      (line 2810)
12965* BFD_RELOC_KVX_S32_UP27:                howto manager.      (line 2811)
12966* BFD_RELOC_KVX_S37_GOTADDR_LO10:        howto manager.      (line 2838)
12967* BFD_RELOC_KVX_S37_GOTADDR_UP27:        howto manager.      (line 2839)
12968* BFD_RELOC_KVX_S37_GOTOFF_LO10:         howto manager.      (line 2814)
12969* BFD_RELOC_KVX_S37_GOTOFF_UP27:         howto manager.      (line 2815)
12970* BFD_RELOC_KVX_S37_GOT_LO10:            howto manager.      (line 2822)
12971* BFD_RELOC_KVX_S37_GOT_UP27:            howto manager.      (line 2823)
12972* BFD_RELOC_KVX_S37_LO10:                howto manager.      (line 2812)
12973* BFD_RELOC_KVX_S37_PCREL_LO10:          howto manager.      (line 2800)
12974* BFD_RELOC_KVX_S37_PCREL_UP27:          howto manager.      (line 2801)
12975* BFD_RELOC_KVX_S37_TLS_DTPOFF_LO10:     howto manager.      (line 2848)
12976* BFD_RELOC_KVX_S37_TLS_DTPOFF_UP27:     howto manager.      (line 2849)
12977* BFD_RELOC_KVX_S37_TLS_GD_LO10:         howto manager.      (line 2853)
12978* BFD_RELOC_KVX_S37_TLS_GD_UP27:         howto manager.      (line 2854)
12979* BFD_RELOC_KVX_S37_TLS_IE_LO10:         howto manager.      (line 2864)
12980* BFD_RELOC_KVX_S37_TLS_IE_UP27:         howto manager.      (line 2865)
12981* BFD_RELOC_KVX_S37_TLS_LD_LO10:         howto manager.      (line 2858)
12982* BFD_RELOC_KVX_S37_TLS_LD_UP27:         howto manager.      (line 2859)
12983* BFD_RELOC_KVX_S37_TLS_LE_LO10:         howto manager.      (line 2869)
12984* BFD_RELOC_KVX_S37_TLS_LE_UP27:         howto manager.      (line 2870)
12985* BFD_RELOC_KVX_S37_UP27:                howto manager.      (line 2813)
12986* BFD_RELOC_KVX_S43_EX6:                 howto manager.      (line 2834)
12987* BFD_RELOC_KVX_S43_GOTADDR_EX6:         howto manager.      (line 2842)
12988* BFD_RELOC_KVX_S43_GOTADDR_LO10:        howto manager.      (line 2840)
12989* BFD_RELOC_KVX_S43_GOTADDR_UP27:        howto manager.      (line 2841)
12990* BFD_RELOC_KVX_S43_GOTOFF_EX6:          howto manager.      (line 2818)
12991* BFD_RELOC_KVX_S43_GOTOFF_LO10:         howto manager.      (line 2816)
12992* BFD_RELOC_KVX_S43_GOTOFF_UP27:         howto manager.      (line 2817)
12993* BFD_RELOC_KVX_S43_GOT_EX6:             howto manager.      (line 2826)
12994* BFD_RELOC_KVX_S43_GOT_LO10:            howto manager.      (line 2824)
12995* BFD_RELOC_KVX_S43_GOT_UP27:            howto manager.      (line 2825)
12996* BFD_RELOC_KVX_S43_LO10:                howto manager.      (line 2832)
12997* BFD_RELOC_KVX_S43_PCREL_EX6:           howto manager.      (line 2804)
12998* BFD_RELOC_KVX_S43_PCREL_LO10:          howto manager.      (line 2802)
12999* BFD_RELOC_KVX_S43_PCREL_UP27:          howto manager.      (line 2803)
13000* BFD_RELOC_KVX_S43_TLS_DTPOFF_EX6:      howto manager.      (line 2852)
13001* BFD_RELOC_KVX_S43_TLS_DTPOFF_LO10:     howto manager.      (line 2850)
13002* BFD_RELOC_KVX_S43_TLS_DTPOFF_UP27:     howto manager.      (line 2851)
13003* BFD_RELOC_KVX_S43_TLS_GD_EX6:          howto manager.      (line 2857)
13004* BFD_RELOC_KVX_S43_TLS_GD_LO10:         howto manager.      (line 2855)
13005* BFD_RELOC_KVX_S43_TLS_GD_UP27:         howto manager.      (line 2856)
13006* BFD_RELOC_KVX_S43_TLS_IE_EX6:          howto manager.      (line 2868)
13007* BFD_RELOC_KVX_S43_TLS_IE_LO10:         howto manager.      (line 2866)
13008* BFD_RELOC_KVX_S43_TLS_IE_UP27:         howto manager.      (line 2867)
13009* BFD_RELOC_KVX_S43_TLS_LD_EX6:          howto manager.      (line 2862)
13010* BFD_RELOC_KVX_S43_TLS_LD_LO10:         howto manager.      (line 2860)
13011* BFD_RELOC_KVX_S43_TLS_LD_UP27:         howto manager.      (line 2861)
13012* BFD_RELOC_KVX_S43_TLS_LE_EX6:          howto manager.      (line 2873)
13013* BFD_RELOC_KVX_S43_TLS_LE_LO10:         howto manager.      (line 2871)
13014* BFD_RELOC_KVX_S43_TLS_LE_UP27:         howto manager.      (line 2872)
13015* BFD_RELOC_KVX_S43_UP27:                howto manager.      (line 2833)
13016* BFD_RELOC_KVX_S64_EX27:                howto manager.      (line 2837)
13017* BFD_RELOC_KVX_S64_GOTADDR_EX27:        howto manager.      (line 2845)
13018* BFD_RELOC_KVX_S64_GOTADDR_LO10:        howto manager.      (line 2843)
13019* BFD_RELOC_KVX_S64_GOTADDR_UP27:        howto manager.      (line 2844)
13020* BFD_RELOC_KVX_S64_LO10:                howto manager.      (line 2835)
13021* BFD_RELOC_KVX_S64_PCREL_EX27:          howto manager.      (line 2807)
13022* BFD_RELOC_KVX_S64_PCREL_LO10:          howto manager.      (line 2805)
13023* BFD_RELOC_KVX_S64_PCREL_UP27:          howto manager.      (line 2806)
13024* BFD_RELOC_KVX_S64_UP27:                howto manager.      (line 2836)
13025* BFD_RELOC_LARCH_32_PCREL:              howto manager.      (line 3602)
13026* BFD_RELOC_LARCH_64_PCREL:              howto manager.      (line 3612)
13027* BFD_RELOC_LARCH_ABS64_HI12:            howto manager.      (line 3573)
13028* BFD_RELOC_LARCH_ABS64_LO20:            howto manager.      (line 3572)
13029* BFD_RELOC_LARCH_ABS_HI20:              howto manager.      (line 3570)
13030* BFD_RELOC_LARCH_ABS_LO12:              howto manager.      (line 3571)
13031* BFD_RELOC_LARCH_ADD16:                 howto manager.      (line 3558)
13032* BFD_RELOC_LARCH_ADD24:                 howto manager.      (line 3559)
13033* BFD_RELOC_LARCH_ADD32:                 howto manager.      (line 3560)
13034* BFD_RELOC_LARCH_ADD6:                  howto manager.      (line 3608)
13035* BFD_RELOC_LARCH_ADD64:                 howto manager.      (line 3561)
13036* BFD_RELOC_LARCH_ADD8:                  howto manager.      (line 3557)
13037* BFD_RELOC_LARCH_ADD_ULEB128:           howto manager.      (line 3610)
13038* BFD_RELOC_LARCH_ALIGN:                 howto manager.      (line 3605)
13039* BFD_RELOC_LARCH_B16:                   howto manager.      (line 3567)
13040* BFD_RELOC_LARCH_B21:                   howto manager.      (line 3568)
13041* BFD_RELOC_LARCH_B26:                   howto manager.      (line 3569)
13042* BFD_RELOC_LARCH_CALL36:                howto manager.      (line 3613)
13043* BFD_RELOC_LARCH_CFA:                   howto manager.      (line 3607)
13044* BFD_RELOC_LARCH_DELETE:                howto manager.      (line 3604)
13045* BFD_RELOC_LARCH_GOT64_HI12:            howto manager.      (line 3585)
13046* BFD_RELOC_LARCH_GOT64_LO20:            howto manager.      (line 3584)
13047* BFD_RELOC_LARCH_GOT64_PC_HI12:         howto manager.      (line 3581)
13048* BFD_RELOC_LARCH_GOT64_PC_LO20:         howto manager.      (line 3580)
13049* BFD_RELOC_LARCH_GOT_HI20:              howto manager.      (line 3582)
13050* BFD_RELOC_LARCH_GOT_LO12:              howto manager.      (line 3583)
13051* BFD_RELOC_LARCH_GOT_PC_HI20:           howto manager.      (line 3578)
13052* BFD_RELOC_LARCH_GOT_PC_LO12:           howto manager.      (line 3579)
13053* BFD_RELOC_LARCH_MARK_LA:               howto manager.      (line 3530)
13054* BFD_RELOC_LARCH_MARK_PCREL:            howto manager.      (line 3531)
13055* BFD_RELOC_LARCH_PCALA64_HI12:          howto manager.      (line 3577)
13056* BFD_RELOC_LARCH_PCALA64_LO20:          howto manager.      (line 3576)
13057* BFD_RELOC_LARCH_PCALA_HI20:            howto manager.      (line 3574)
13058* BFD_RELOC_LARCH_PCALA_LO12:            howto manager.      (line 3575)
13059* BFD_RELOC_LARCH_PCREL20_S2:            howto manager.      (line 3606)
13060* BFD_RELOC_LARCH_RELAX:                 howto manager.      (line 3603)
13061* BFD_RELOC_LARCH_SOP_ADD:               howto manager.      (line 3545)
13062* BFD_RELOC_LARCH_SOP_AND:               howto manager.      (line 3546)
13063* BFD_RELOC_LARCH_SOP_ASSERT:            howto manager.      (line 3540)
13064* BFD_RELOC_LARCH_SOP_IF_ELSE:           howto manager.      (line 3547)
13065* BFD_RELOC_LARCH_SOP_NOT:               howto manager.      (line 3541)
13066* BFD_RELOC_LARCH_SOP_POP_32_S_0_10_10_16_S2: howto manager. (line 3555)
13067* BFD_RELOC_LARCH_SOP_POP_32_S_0_5_10_16_S2: howto manager.  (line 3554)
13068* BFD_RELOC_LARCH_SOP_POP_32_S_10_12:    howto manager.      (line 3550)
13069* BFD_RELOC_LARCH_SOP_POP_32_S_10_16:    howto manager.      (line 3551)
13070* BFD_RELOC_LARCH_SOP_POP_32_S_10_16_S2: howto manager.      (line 3552)
13071* BFD_RELOC_LARCH_SOP_POP_32_S_10_5:     howto manager.      (line 3548)
13072* BFD_RELOC_LARCH_SOP_POP_32_S_5_20:     howto manager.      (line 3553)
13073* BFD_RELOC_LARCH_SOP_POP_32_U:          howto manager.      (line 3556)
13074* BFD_RELOC_LARCH_SOP_POP_32_U_10_12:    howto manager.      (line 3549)
13075* BFD_RELOC_LARCH_SOP_PUSH_ABSOLUTE:     howto manager.      (line 3533)
13076* BFD_RELOC_LARCH_SOP_PUSH_DUP:          howto manager.      (line 3534)
13077* BFD_RELOC_LARCH_SOP_PUSH_GPREL:        howto manager.      (line 3535)
13078* BFD_RELOC_LARCH_SOP_PUSH_PCREL:        howto manager.      (line 3532)
13079* BFD_RELOC_LARCH_SOP_PUSH_PLT_PCREL:    howto manager.      (line 3539)
13080* BFD_RELOC_LARCH_SOP_PUSH_TLS_GD:       howto manager.      (line 3538)
13081* BFD_RELOC_LARCH_SOP_PUSH_TLS_GOT:      howto manager.      (line 3537)
13082* BFD_RELOC_LARCH_SOP_PUSH_TLS_TPREL:    howto manager.      (line 3536)
13083* BFD_RELOC_LARCH_SOP_SL:                howto manager.      (line 3543)
13084* BFD_RELOC_LARCH_SOP_SR:                howto manager.      (line 3544)
13085* BFD_RELOC_LARCH_SOP_SUB:               howto manager.      (line 3542)
13086* BFD_RELOC_LARCH_SUB16:                 howto manager.      (line 3563)
13087* BFD_RELOC_LARCH_SUB24:                 howto manager.      (line 3564)
13088* BFD_RELOC_LARCH_SUB32:                 howto manager.      (line 3565)
13089* BFD_RELOC_LARCH_SUB6:                  howto manager.      (line 3609)
13090* BFD_RELOC_LARCH_SUB64:                 howto manager.      (line 3566)
13091* BFD_RELOC_LARCH_SUB8:                  howto manager.      (line 3562)
13092* BFD_RELOC_LARCH_SUB_ULEB128:           howto manager.      (line 3611)
13093* BFD_RELOC_LARCH_TLS_DESC32:            howto manager.      (line 3528)
13094* BFD_RELOC_LARCH_TLS_DESC64:            howto manager.      (line 3529)
13095* BFD_RELOC_LARCH_TLS_DESC64_HI12:       howto manager.      (line 3621)
13096* BFD_RELOC_LARCH_TLS_DESC64_LO20:       howto manager.      (line 3620)
13097* BFD_RELOC_LARCH_TLS_DESC64_PC_HI12:    howto manager.      (line 3617)
13098* BFD_RELOC_LARCH_TLS_DESC64_PC_LO20:    howto manager.      (line 3616)
13099* BFD_RELOC_LARCH_TLS_DESC_CALL:         howto manager.      (line 3623)
13100* BFD_RELOC_LARCH_TLS_DESC_HI20:         howto manager.      (line 3618)
13101* BFD_RELOC_LARCH_TLS_DESC_LD:           howto manager.      (line 3622)
13102* BFD_RELOC_LARCH_TLS_DESC_LO12:         howto manager.      (line 3619)
13103* BFD_RELOC_LARCH_TLS_DESC_PCREL20_S2:   howto manager.      (line 3629)
13104* BFD_RELOC_LARCH_TLS_DESC_PC_HI20:      howto manager.      (line 3614)
13105* BFD_RELOC_LARCH_TLS_DESC_PC_LO12:      howto manager.      (line 3615)
13106* BFD_RELOC_LARCH_TLS_DTPMOD32:          howto manager.      (line 3522)
13107* BFD_RELOC_LARCH_TLS_DTPMOD64:          howto manager.      (line 3524)
13108* BFD_RELOC_LARCH_TLS_DTPREL32:          howto manager.      (line 3523)
13109* BFD_RELOC_LARCH_TLS_DTPREL64:          howto manager.      (line 3525)
13110* BFD_RELOC_LARCH_TLS_GD_HI20:           howto manager.      (line 3601)
13111* BFD_RELOC_LARCH_TLS_GD_PCREL20_S2:     howto manager.      (line 3628)
13112* BFD_RELOC_LARCH_TLS_GD_PC_HI20:        howto manager.      (line 3600)
13113* BFD_RELOC_LARCH_TLS_IE64_HI12:         howto manager.      (line 3597)
13114* BFD_RELOC_LARCH_TLS_IE64_LO20:         howto manager.      (line 3596)
13115* BFD_RELOC_LARCH_TLS_IE64_PC_HI12:      howto manager.      (line 3593)
13116* BFD_RELOC_LARCH_TLS_IE64_PC_LO20:      howto manager.      (line 3592)
13117* BFD_RELOC_LARCH_TLS_IE_HI20:           howto manager.      (line 3594)
13118* BFD_RELOC_LARCH_TLS_IE_LO12:           howto manager.      (line 3595)
13119* BFD_RELOC_LARCH_TLS_IE_PC_HI20:        howto manager.      (line 3590)
13120* BFD_RELOC_LARCH_TLS_IE_PC_LO12:        howto manager.      (line 3591)
13121* BFD_RELOC_LARCH_TLS_LD_HI20:           howto manager.      (line 3599)
13122* BFD_RELOC_LARCH_TLS_LD_PCREL20_S2:     howto manager.      (line 3627)
13123* BFD_RELOC_LARCH_TLS_LD_PC_HI20:        howto manager.      (line 3598)
13124* BFD_RELOC_LARCH_TLS_LE64_HI12:         howto manager.      (line 3589)
13125* BFD_RELOC_LARCH_TLS_LE64_LO20:         howto manager.      (line 3588)
13126* BFD_RELOC_LARCH_TLS_LE_ADD_R:          howto manager.      (line 3625)
13127* BFD_RELOC_LARCH_TLS_LE_HI20:           howto manager.      (line 3586)
13128* BFD_RELOC_LARCH_TLS_LE_HI20_R:         howto manager.      (line 3624)
13129* BFD_RELOC_LARCH_TLS_LE_LO12:           howto manager.      (line 3587)
13130* BFD_RELOC_LARCH_TLS_LE_LO12_R:         howto manager.      (line 3626)
13131* BFD_RELOC_LARCH_TLS_TPREL32:           howto manager.      (line 3526)
13132* BFD_RELOC_LARCH_TLS_TPREL64:           howto manager.      (line 3527)
13133* BFD_RELOC_LM32_16_GOT:                 howto manager.      (line 2666)
13134* BFD_RELOC_LM32_BRANCH:                 howto manager.      (line 2665)
13135* BFD_RELOC_LM32_CALL:                   howto manager.      (line 2664)
13136* BFD_RELOC_LM32_COPY:                   howto manager.      (line 2669)
13137* BFD_RELOC_LM32_GLOB_DAT:               howto manager.      (line 2670)
13138* BFD_RELOC_LM32_GOTOFF_HI16:            howto manager.      (line 2667)
13139* BFD_RELOC_LM32_GOTOFF_LO16:            howto manager.      (line 2668)
13140* BFD_RELOC_LM32_JMP_SLOT:               howto manager.      (line 2671)
13141* BFD_RELOC_LM32_RELATIVE:               howto manager.      (line 2672)
13142* BFD_RELOC_LO10:                        howto manager.      (line  109)
13143* BFD_RELOC_LO16:                        howto manager.      (line  319)
13144* BFD_RELOC_LO16_BASEREL:                howto manager.      (line   91)
13145* BFD_RELOC_LO16_GOTOFF:                 howto manager.      (line   50)
13146* BFD_RELOC_LO16_PCREL:                  howto manager.      (line  325)
13147* BFD_RELOC_LO16_PLTOFF:                 howto manager.      (line   62)
13148* BFD_RELOC_M32C_HI8:                    howto manager.      (line 1245)
13149* BFD_RELOC_M32C_RL_1ADDR:               howto manager.      (line 1247)
13150* BFD_RELOC_M32C_RL_2ADDR:               howto manager.      (line 1248)
13151* BFD_RELOC_M32C_RL_JUMP:                howto manager.      (line 1246)
13152* BFD_RELOC_M32R_10_PCREL:               howto manager.      (line 1253)
13153* BFD_RELOC_M32R_18_PCREL:               howto manager.      (line 1256)
13154* BFD_RELOC_M32R_24:                     howto manager.      (line 1250)
13155* BFD_RELOC_M32R_26_PCREL:               howto manager.      (line 1258)
13156* BFD_RELOC_M32R_26_PLTREL:              howto manager.      (line 1272)
13157* BFD_RELOC_M32R_COPY:                   howto manager.      (line 1273)
13158* BFD_RELOC_M32R_GLOB_DAT:               howto manager.      (line 1274)
13159* BFD_RELOC_M32R_GOT16_HI_SLO:           howto manager.      (line 1283)
13160* BFD_RELOC_M32R_GOT16_HI_ULO:           howto manager.      (line 1282)
13161* BFD_RELOC_M32R_GOT16_LO:               howto manager.      (line 1284)
13162* BFD_RELOC_M32R_GOT24:                  howto manager.      (line 1271)
13163* BFD_RELOC_M32R_GOTOFF:                 howto manager.      (line 1277)
13164* BFD_RELOC_M32R_GOTOFF_HI_SLO:          howto manager.      (line 1279)
13165* BFD_RELOC_M32R_GOTOFF_HI_ULO:          howto manager.      (line 1278)
13166* BFD_RELOC_M32R_GOTOFF_LO:              howto manager.      (line 1280)
13167* BFD_RELOC_M32R_GOTPC24:                howto manager.      (line 1281)
13168* BFD_RELOC_M32R_GOTPC_HI_SLO:           howto manager.      (line 1286)
13169* BFD_RELOC_M32R_GOTPC_HI_ULO:           howto manager.      (line 1285)
13170* BFD_RELOC_M32R_GOTPC_LO:               howto manager.      (line 1287)
13171* BFD_RELOC_M32R_HI16_SLO:               howto manager.      (line 1263)
13172* BFD_RELOC_M32R_HI16_ULO:               howto manager.      (line 1260)
13173* BFD_RELOC_M32R_JMP_SLOT:               howto manager.      (line 1275)
13174* BFD_RELOC_M32R_LO16:                   howto manager.      (line 1266)
13175* BFD_RELOC_M32R_RELATIVE:               howto manager.      (line 1276)
13176* BFD_RELOC_M32R_SDA16:                  howto manager.      (line 1268)
13177* BFD_RELOC_M68HC11_24:                  howto manager.      (line 2211)
13178* BFD_RELOC_M68HC11_3B:                  howto manager.      (line 2191)
13179* BFD_RELOC_M68HC11_HI8:                 howto manager.      (line 2185)
13180* BFD_RELOC_M68HC11_LO16:                howto manager.      (line 2202)
13181* BFD_RELOC_M68HC11_LO8:                 howto manager.      (line 2188)
13182* BFD_RELOC_M68HC11_PAGE:                howto manager.      (line 2207)
13183* BFD_RELOC_M68HC11_RL_GROUP:            howto manager.      (line 2198)
13184* BFD_RELOC_M68HC11_RL_JUMP:             howto manager.      (line 2193)
13185* BFD_RELOC_M68HC12_10_PCREL:            howto manager.      (line 2254)
13186* BFD_RELOC_M68HC12_16B:                 howto manager.      (line 2250)
13187* BFD_RELOC_M68HC12_5B:                  howto manager.      (line 2216)
13188* BFD_RELOC_M68HC12_9B:                  howto manager.      (line 2248)
13189* BFD_RELOC_M68HC12_9_PCREL:             howto manager.      (line 2252)
13190* BFD_RELOC_M68HC12_HI8XG:               howto manager.      (line 2259)
13191* BFD_RELOC_M68HC12_LO8XG:               howto manager.      (line 2256)
13192* BFD_RELOC_MACH_O_ARM64_ADDEND:         howto manager.      (line 2702)
13193* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21: howto manager.     (line 2704)
13194* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12: howto manager.  (line 2706)
13195* BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT: howto manager.      (line 2708)
13196* BFD_RELOC_MACH_O_LOCAL_SECTDIFF:       howto manager.      (line 2677)
13197* BFD_RELOC_MACH_O_PAIR:                 howto manager.      (line 2679)
13198* BFD_RELOC_MACH_O_SECTDIFF:             howto manager.      (line 2674)
13199* BFD_RELOC_MACH_O_SUBTRACTOR32:         howto manager.      (line 2681)
13200* BFD_RELOC_MACH_O_SUBTRACTOR64:         howto manager.      (line 2683)
13201* BFD_RELOC_MACH_O_X86_64_BRANCH32:      howto manager.      (line 2685)
13202* BFD_RELOC_MACH_O_X86_64_BRANCH8:       howto manager.      (line 2686)
13203* BFD_RELOC_MACH_O_X86_64_GOT:           howto manager.      (line 2689)
13204* BFD_RELOC_MACH_O_X86_64_GOT_LOAD:      howto manager.      (line 2691)
13205* BFD_RELOC_MACH_O_X86_64_PCREL32_1:     howto manager.      (line 2694)
13206* BFD_RELOC_MACH_O_X86_64_PCREL32_2:     howto manager.      (line 2696)
13207* BFD_RELOC_MACH_O_X86_64_PCREL32_4:     howto manager.      (line 2698)
13208* BFD_RELOC_MACH_O_X86_64_TLV:           howto manager.      (line 2700)
13209* BFD_RELOC_MCORE_PCREL_32:              howto manager.      (line 1632)
13210* BFD_RELOC_MCORE_PCREL_IMM11BY2:        howto manager.      (line 1630)
13211* BFD_RELOC_MCORE_PCREL_IMM4BY2:         howto manager.      (line 1631)
13212* BFD_RELOC_MCORE_PCREL_IMM8BY4:         howto manager.      (line 1629)
13213* BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2:    howto manager.      (line 1633)
13214* BFD_RELOC_MCORE_RVA:                   howto manager.      (line 1634)
13215* BFD_RELOC_MEP_16:                      howto manager.      (line 1637)
13216* BFD_RELOC_MEP_32:                      howto manager.      (line 1638)
13217* BFD_RELOC_MEP_8:                       howto manager.      (line 1636)
13218* BFD_RELOC_MEP_ADDR24A4:                howto manager.      (line 1653)
13219* BFD_RELOC_MEP_GNU_VTENTRY:             howto manager.      (line 1655)
13220* BFD_RELOC_MEP_GNU_VTINHERIT:           howto manager.      (line 1654)
13221* BFD_RELOC_MEP_GPREL:                   howto manager.      (line 1647)
13222* BFD_RELOC_MEP_HI16S:                   howto manager.      (line 1646)
13223* BFD_RELOC_MEP_HI16U:                   howto manager.      (line 1645)
13224* BFD_RELOC_MEP_LOW16:                   howto manager.      (line 1644)
13225* BFD_RELOC_MEP_PCABS24A2:               howto manager.      (line 1643)
13226* BFD_RELOC_MEP_PCREL12A2:               howto manager.      (line 1640)
13227* BFD_RELOC_MEP_PCREL17A2:               howto manager.      (line 1641)
13228* BFD_RELOC_MEP_PCREL24A2:               howto manager.      (line 1642)
13229* BFD_RELOC_MEP_PCREL8A2:                howto manager.      (line 1639)
13230* BFD_RELOC_MEP_TPREL:                   howto manager.      (line 1648)
13231* BFD_RELOC_MEP_TPREL7:                  howto manager.      (line 1649)
13232* BFD_RELOC_MEP_TPREL7A2:                howto manager.      (line 1650)
13233* BFD_RELOC_MEP_TPREL7A4:                howto manager.      (line 1651)
13234* BFD_RELOC_MEP_UIMM24:                  howto manager.      (line 1652)
13235* BFD_RELOC_METAG_COPY:                  howto manager.      (line 1676)
13236* BFD_RELOC_METAG_GETSETOFF:             howto manager.      (line 1660)
13237* BFD_RELOC_METAG_GETSET_GOT:            howto manager.      (line 1668)
13238* BFD_RELOC_METAG_GETSET_GOTOFF:         howto manager.      (line 1667)
13239* BFD_RELOC_METAG_GLOB_DAT:              howto manager.      (line 1679)
13240* BFD_RELOC_METAG_GOTOFF:                howto manager.      (line 1674)
13241* BFD_RELOC_METAG_HI16_GOTOFF:           howto manager.      (line 1665)
13242* BFD_RELOC_METAG_HI16_GOTPC:            howto manager.      (line 1669)
13243* BFD_RELOC_METAG_HI16_PLT:              howto manager.      (line 1671)
13244* BFD_RELOC_METAG_HIADDR16:              howto manager.      (line 1657)
13245* BFD_RELOC_METAG_HIOG:                  howto manager.      (line 1661)
13246* BFD_RELOC_METAG_JMP_SLOT:              howto manager.      (line 1677)
13247* BFD_RELOC_METAG_LO16_GOTOFF:           howto manager.      (line 1666)
13248* BFD_RELOC_METAG_LO16_GOTPC:            howto manager.      (line 1670)
13249* BFD_RELOC_METAG_LO16_PLT:              howto manager.      (line 1672)
13250* BFD_RELOC_METAG_LOADDR16:              howto manager.      (line 1658)
13251* BFD_RELOC_METAG_LOOG:                  howto manager.      (line 1662)
13252* BFD_RELOC_METAG_PLT:                   howto manager.      (line 1675)
13253* BFD_RELOC_METAG_REL16:                 howto manager.      (line 1664)
13254* BFD_RELOC_METAG_REL8:                  howto manager.      (line 1663)
13255* BFD_RELOC_METAG_RELATIVE:              howto manager.      (line 1678)
13256* BFD_RELOC_METAG_RELBRANCH:             howto manager.      (line 1659)
13257* BFD_RELOC_METAG_RELBRANCH_PLT:         howto manager.      (line 1673)
13258* BFD_RELOC_METAG_TLS_DTPMOD:            howto manager.      (line 1690)
13259* BFD_RELOC_METAG_TLS_DTPOFF:            howto manager.      (line 1691)
13260* BFD_RELOC_METAG_TLS_GD:                howto manager.      (line 1680)
13261* BFD_RELOC_METAG_TLS_IE:                howto manager.      (line 1685)
13262* BFD_RELOC_METAG_TLS_IENONPIC:          howto manager.      (line 1686)
13263* BFD_RELOC_METAG_TLS_IENONPIC_HI16:     howto manager.      (line 1687)
13264* BFD_RELOC_METAG_TLS_IENONPIC_LO16:     howto manager.      (line 1688)
13265* BFD_RELOC_METAG_TLS_LDM:               howto manager.      (line 1681)
13266* BFD_RELOC_METAG_TLS_LDO:               howto manager.      (line 1684)
13267* BFD_RELOC_METAG_TLS_LDO_HI16:          howto manager.      (line 1682)
13268* BFD_RELOC_METAG_TLS_LDO_LO16:          howto manager.      (line 1683)
13269* BFD_RELOC_METAG_TLS_LE:                howto manager.      (line 1692)
13270* BFD_RELOC_METAG_TLS_LE_HI16:           howto manager.      (line 1693)
13271* BFD_RELOC_METAG_TLS_LE_LO16:           howto manager.      (line 1694)
13272* BFD_RELOC_METAG_TLS_TPOFF:             howto manager.      (line 1689)
13273* BFD_RELOC_MICROBLAZE_32_GOTOFF:        howto manager.      (line 2748)
13274* BFD_RELOC_MICROBLAZE_32_LO:            howto manager.      (line 2710)
13275* BFD_RELOC_MICROBLAZE_32_LO_PCREL:      howto manager.      (line 2713)
13276* BFD_RELOC_MICROBLAZE_32_NONE:          howto manager.      (line 2725)
13277* BFD_RELOC_MICROBLAZE_32_ROSDA:         howto manager.      (line 2716)
13278* BFD_RELOC_MICROBLAZE_32_RWSDA:         howto manager.      (line 2719)
13279* BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM:    howto manager.      (line 2722)
13280* BFD_RELOC_MICROBLAZE_32_TLSDTPMOD:     howto manager.      (line 2765)
13281* BFD_RELOC_MICROBLAZE_32_TLSDTPREL:     howto manager.      (line 2767)
13282* BFD_RELOC_MICROBLAZE_64_GOT:           howto manager.      (line 2737)
13283* BFD_RELOC_MICROBLAZE_64_GOTOFF:        howto manager.      (line 2744)
13284* BFD_RELOC_MICROBLAZE_64_GOTPC:         howto manager.      (line 2733)
13285* BFD_RELOC_MICROBLAZE_64_NONE:          howto manager.      (line 2729)
13286* BFD_RELOC_MICROBLAZE_64_PLT:           howto manager.      (line 2740)
13287* BFD_RELOC_MICROBLAZE_64_TEXTPCREL:     howto manager.      (line 2778)
13288* BFD_RELOC_MICROBLAZE_64_TEXTREL:       howto manager.      (line 2782)
13289* BFD_RELOC_MICROBLAZE_64_TLS:           howto manager.      (line 2755)
13290* BFD_RELOC_MICROBLAZE_64_TLSDTPREL:     howto manager.      (line 2769)
13291* BFD_RELOC_MICROBLAZE_64_TLSGD:         howto manager.      (line 2757)
13292* BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL:   howto manager.      (line 2772)
13293* BFD_RELOC_MICROBLAZE_64_TLSLD:         howto manager.      (line 2761)
13294* BFD_RELOC_MICROBLAZE_64_TLSTPREL:      howto manager.      (line 2775)
13295* BFD_RELOC_MICROBLAZE_COPY:             howto manager.      (line 2752)
13296* BFD_RELOC_MICROMIPS_10_PCREL_S1:       howto manager.      (line  352)
13297* BFD_RELOC_MICROMIPS_16_PCREL_S1:       howto manager.      (line  353)
13298* BFD_RELOC_MICROMIPS_7_PCREL_S1:        howto manager.      (line  351)
13299* BFD_RELOC_MICROMIPS_CALL16:            howto manager.      (line  370)
13300* BFD_RELOC_MICROMIPS_CALL_HI16:         howto manager.      (line  376)
13301* BFD_RELOC_MICROMIPS_CALL_LO16:         howto manager.      (line  378)
13302* BFD_RELOC_MICROMIPS_GOT16:             howto manager.      (line  368)
13303* BFD_RELOC_MICROMIPS_GOT_DISP:          howto manager.      (line  386)
13304* BFD_RELOC_MICROMIPS_GOT_HI16:          howto manager.      (line  372)
13305* BFD_RELOC_MICROMIPS_GOT_LO16:          howto manager.      (line  374)
13306* BFD_RELOC_MICROMIPS_GOT_OFST:          howto manager.      (line  384)
13307* BFD_RELOC_MICROMIPS_GOT_PAGE:          howto manager.      (line  382)
13308* BFD_RELOC_MICROMIPS_GPREL16:           howto manager.      (line  362)
13309* BFD_RELOC_MICROMIPS_HI16:              howto manager.      (line  363)
13310* BFD_RELOC_MICROMIPS_HI16_S:            howto manager.      (line  364)
13311* BFD_RELOC_MICROMIPS_HIGHER:            howto manager.      (line  395)
13312* BFD_RELOC_MICROMIPS_HIGHEST:           howto manager.      (line  393)
13313* BFD_RELOC_MICROMIPS_JALR:              howto manager.      (line  401)
13314* BFD_RELOC_MICROMIPS_JMP:               howto manager.      (line  306)
13315* BFD_RELOC_MICROMIPS_LITERAL:           howto manager.      (line  349)
13316* BFD_RELOC_MICROMIPS_LO16:              howto manager.      (line  365)
13317* BFD_RELOC_MICROMIPS_SCN_DISP:          howto manager.      (line  397)
13318* BFD_RELOC_MICROMIPS_SUB:               howto manager.      (line  380)
13319* BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16:   howto manager.      (line  411)
13320* BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16:   howto manager.      (line  413)
13321* BFD_RELOC_MICROMIPS_TLS_GD:            howto manager.      (line  407)
13322* BFD_RELOC_MICROMIPS_TLS_GOTTPREL:      howto manager.      (line  415)
13323* BFD_RELOC_MICROMIPS_TLS_LDM:           howto manager.      (line  409)
13324* BFD_RELOC_MICROMIPS_TLS_TPREL_HI16:    howto manager.      (line  419)
13325* BFD_RELOC_MICROMIPS_TLS_TPREL_LO16:    howto manager.      (line  421)
13326* BFD_RELOC_MIPS16_16_PCREL_S1:          howto manager.      (line  355)
13327* BFD_RELOC_MIPS16_CALL16:               howto manager.      (line  328)
13328* BFD_RELOC_MIPS16_GOT16:                howto manager.      (line  327)
13329* BFD_RELOC_MIPS16_GPREL:                howto manager.      (line  310)
13330* BFD_RELOC_MIPS16_HI16:                 howto manager.      (line  331)
13331* BFD_RELOC_MIPS16_HI16_S:               howto manager.      (line  333)
13332* BFD_RELOC_MIPS16_JMP:                  howto manager.      (line  308)
13333* BFD_RELOC_MIPS16_LO16:                 howto manager.      (line  338)
13334* BFD_RELOC_MIPS16_TLS_DTPREL_HI16:      howto manager.      (line  342)
13335* BFD_RELOC_MIPS16_TLS_DTPREL_LO16:      howto manager.      (line  343)
13336* BFD_RELOC_MIPS16_TLS_GD:               howto manager.      (line  340)
13337* BFD_RELOC_MIPS16_TLS_GOTTPREL:         howto manager.      (line  344)
13338* BFD_RELOC_MIPS16_TLS_LDM:              howto manager.      (line  341)
13339* BFD_RELOC_MIPS16_TLS_TPREL_HI16:       howto manager.      (line  345)
13340* BFD_RELOC_MIPS16_TLS_TPREL_LO16:       howto manager.      (line  346)
13341* BFD_RELOC_MIPS_16:                     howto manager.      (line  398)
13342* BFD_RELOC_MIPS_18_PCREL_S3:            howto manager.      (line  359)
13343* BFD_RELOC_MIPS_19_PCREL_S2:            howto manager.      (line  360)
13344* BFD_RELOC_MIPS_21_PCREL_S2:            howto manager.      (line  357)
13345* BFD_RELOC_MIPS_26_PCREL_S2:            howto manager.      (line  358)
13346* BFD_RELOC_MIPS_CALL16:                 howto manager.      (line  369)
13347* BFD_RELOC_MIPS_CALL_HI16:              howto manager.      (line  375)
13348* BFD_RELOC_MIPS_CALL_LO16:              howto manager.      (line  377)
13349* BFD_RELOC_MIPS_COPY:                   howto manager.      (line  424)
13350* BFD_RELOC_MIPS_DELETE:                 howto manager.      (line  391)
13351* BFD_RELOC_MIPS_EH:                     howto manager.      (line  422)
13352* BFD_RELOC_MIPS_GOT16:                  howto manager.      (line  367)
13353* BFD_RELOC_MIPS_GOT_DISP:               howto manager.      (line  385)
13354* BFD_RELOC_MIPS_GOT_HI16:               howto manager.      (line  371)
13355* BFD_RELOC_MIPS_GOT_LO16:               howto manager.      (line  373)
13356* BFD_RELOC_MIPS_GOT_OFST:               howto manager.      (line  383)
13357* BFD_RELOC_MIPS_GOT_PAGE:               howto manager.      (line  381)
13358* BFD_RELOC_MIPS_HIGHER:                 howto manager.      (line  394)
13359* BFD_RELOC_MIPS_HIGHEST:                howto manager.      (line  392)
13360* BFD_RELOC_MIPS_INSERT_A:               howto manager.      (line  389)
13361* BFD_RELOC_MIPS_INSERT_B:               howto manager.      (line  390)
13362* BFD_RELOC_MIPS_JALR:                   howto manager.      (line  400)
13363* BFD_RELOC_MIPS_JMP:                    howto manager.      (line  305)
13364* BFD_RELOC_MIPS_JUMP_SLOT:              howto manager.      (line  425)
13365* BFD_RELOC_MIPS_LITERAL:                howto manager.      (line  348)
13366* BFD_RELOC_MIPS_RELGOT:                 howto manager.      (line  399)
13367* BFD_RELOC_MIPS_SCN_DISP:               howto manager.      (line  396)
13368* BFD_RELOC_MIPS_SHIFT5:                 howto manager.      (line  387)
13369* BFD_RELOC_MIPS_SHIFT6:                 howto manager.      (line  388)
13370* BFD_RELOC_MIPS_SUB:                    howto manager.      (line  379)
13371* BFD_RELOC_MIPS_TLS_DTPMOD32:           howto manager.      (line  402)
13372* BFD_RELOC_MIPS_TLS_DTPMOD64:           howto manager.      (line  404)
13373* BFD_RELOC_MIPS_TLS_DTPREL32:           howto manager.      (line  403)
13374* BFD_RELOC_MIPS_TLS_DTPREL64:           howto manager.      (line  405)
13375* BFD_RELOC_MIPS_TLS_DTPREL_HI16:        howto manager.      (line  410)
13376* BFD_RELOC_MIPS_TLS_DTPREL_LO16:        howto manager.      (line  412)
13377* BFD_RELOC_MIPS_TLS_GD:                 howto manager.      (line  406)
13378* BFD_RELOC_MIPS_TLS_GOTTPREL:           howto manager.      (line  414)
13379* BFD_RELOC_MIPS_TLS_LDM:                howto manager.      (line  408)
13380* BFD_RELOC_MIPS_TLS_TPREL32:            howto manager.      (line  416)
13381* BFD_RELOC_MIPS_TLS_TPREL64:            howto manager.      (line  417)
13382* BFD_RELOC_MIPS_TLS_TPREL_HI16:         howto manager.      (line  418)
13383* BFD_RELOC_MIPS_TLS_TPREL_LO16:         howto manager.      (line  420)
13384* BFD_RELOC_MMIX_ADDR19:                 howto manager.      (line 1718)
13385* BFD_RELOC_MMIX_ADDR27:                 howto manager.      (line 1721)
13386* BFD_RELOC_MMIX_BASE_PLUS_OFFSET:       howto manager.      (line 1730)
13387* BFD_RELOC_MMIX_CBRANCH:                howto manager.      (line 1701)
13388* BFD_RELOC_MMIX_CBRANCH_1:              howto manager.      (line 1703)
13389* BFD_RELOC_MMIX_CBRANCH_2:              howto manager.      (line 1704)
13390* BFD_RELOC_MMIX_CBRANCH_3:              howto manager.      (line 1705)
13391* BFD_RELOC_MMIX_CBRANCH_J:              howto manager.      (line 1702)
13392* BFD_RELOC_MMIX_GETA:                   howto manager.      (line 1696)
13393* BFD_RELOC_MMIX_GETA_1:                 howto manager.      (line 1697)
13394* BFD_RELOC_MMIX_GETA_2:                 howto manager.      (line 1698)
13395* BFD_RELOC_MMIX_GETA_3:                 howto manager.      (line 1699)
13396* BFD_RELOC_MMIX_JMP:                    howto manager.      (line 1713)
13397* BFD_RELOC_MMIX_JMP_1:                  howto manager.      (line 1714)
13398* BFD_RELOC_MMIX_JMP_2:                  howto manager.      (line 1715)
13399* BFD_RELOC_MMIX_JMP_3:                  howto manager.      (line 1716)
13400* BFD_RELOC_MMIX_LOCAL:                  howto manager.      (line 1733)
13401* BFD_RELOC_MMIX_PUSHJ:                  howto manager.      (line 1707)
13402* BFD_RELOC_MMIX_PUSHJ_1:                howto manager.      (line 1708)
13403* BFD_RELOC_MMIX_PUSHJ_2:                howto manager.      (line 1709)
13404* BFD_RELOC_MMIX_PUSHJ_3:                howto manager.      (line 1710)
13405* BFD_RELOC_MMIX_PUSHJ_STUBBABLE:        howto manager.      (line 1711)
13406* BFD_RELOC_MMIX_REG:                    howto manager.      (line 1727)
13407* BFD_RELOC_MMIX_REG_OR_BYTE:            howto manager.      (line 1724)
13408* BFD_RELOC_MN10300_16_PCREL:            howto manager.      (line  518)
13409* BFD_RELOC_MN10300_32_PCREL:            howto manager.      (line  515)
13410* BFD_RELOC_MN10300_ALIGN:               howto manager.      (line  502)
13411* BFD_RELOC_MN10300_COPY:                howto manager.      (line  490)
13412* BFD_RELOC_MN10300_GLOB_DAT:            howto manager.      (line  492)
13413* BFD_RELOC_MN10300_GOT16:               howto manager.      (line  487)
13414* BFD_RELOC_MN10300_GOT24:               howto manager.      (line  484)
13415* BFD_RELOC_MN10300_GOT32:               howto manager.      (line  481)
13416* BFD_RELOC_MN10300_GOTOFF24:            howto manager.      (line  479)
13417* BFD_RELOC_MN10300_JMP_SLOT:            howto manager.      (line  494)
13418* BFD_RELOC_MN10300_RELATIVE:            howto manager.      (line  496)
13419* BFD_RELOC_MN10300_SYM_DIFF:            howto manager.      (line  498)
13420* BFD_RELOC_MN10300_TLS_DTPMOD:          howto manager.      (line  511)
13421* BFD_RELOC_MN10300_TLS_DTPOFF:          howto manager.      (line  512)
13422* BFD_RELOC_MN10300_TLS_GD:              howto manager.      (line  505)
13423* BFD_RELOC_MN10300_TLS_GOTIE:           howto manager.      (line  508)
13424* BFD_RELOC_MN10300_TLS_IE:              howto manager.      (line  509)
13425* BFD_RELOC_MN10300_TLS_LD:              howto manager.      (line  506)
13426* BFD_RELOC_MN10300_TLS_LDO:             howto manager.      (line  507)
13427* BFD_RELOC_MN10300_TLS_LE:              howto manager.      (line  510)
13428* BFD_RELOC_MN10300_TLS_TPOFF:           howto manager.      (line  513)
13429* BFD_RELOC_MOXIE_10_PCREL:              howto manager.      (line  427)
13430* BFD_RELOC_MSP430X_ABS16:               howto manager.      (line 2455)
13431* BFD_RELOC_MSP430X_ABS20_ADR_DST:       howto manager.      (line 2452)
13432* BFD_RELOC_MSP430X_ABS20_ADR_SRC:       howto manager.      (line 2451)
13433* BFD_RELOC_MSP430X_ABS20_EXT_DST:       howto manager.      (line 2449)
13434* BFD_RELOC_MSP430X_ABS20_EXT_ODST:      howto manager.      (line 2450)
13435* BFD_RELOC_MSP430X_ABS20_EXT_SRC:       howto manager.      (line 2448)
13436* BFD_RELOC_MSP430X_PCR16:               howto manager.      (line 2453)
13437* BFD_RELOC_MSP430X_PCR20_CALL:          howto manager.      (line 2454)
13438* BFD_RELOC_MSP430X_PCR20_EXT_DST:       howto manager.      (line 2446)
13439* BFD_RELOC_MSP430X_PCR20_EXT_ODST:      howto manager.      (line 2447)
13440* BFD_RELOC_MSP430X_PCR20_EXT_SRC:       howto manager.      (line 2445)
13441* BFD_RELOC_MSP430_10_PCREL:             howto manager.      (line 2437)
13442* BFD_RELOC_MSP430_16:                   howto manager.      (line 2439)
13443* BFD_RELOC_MSP430_16_BYTE:              howto manager.      (line 2441)
13444* BFD_RELOC_MSP430_16_PCREL:             howto manager.      (line 2438)
13445* BFD_RELOC_MSP430_16_PCREL_BYTE:        howto manager.      (line 2440)
13446* BFD_RELOC_MSP430_2X_PCREL:             howto manager.      (line 2442)
13447* BFD_RELOC_MSP430_ABS8:                 howto manager.      (line 2444)
13448* BFD_RELOC_MSP430_ABS_HI16:             howto manager.      (line 2456)
13449* BFD_RELOC_MSP430_PREL31:               howto manager.      (line 2457)
13450* BFD_RELOC_MSP430_RL_PCREL:             howto manager.      (line 2443)
13451* BFD_RELOC_MSP430_SET_ULEB128:          howto manager.      (line 2459)
13452* BFD_RELOC_MSP430_SUB_ULEB128:          howto manager.      (line 2460)
13453* BFD_RELOC_MSP430_SYM_DIFF:             howto manager.      (line 2458)
13454* BFD_RELOC_MT_GNU_VTENTRY:              howto manager.      (line 2433)
13455* BFD_RELOC_MT_GNU_VTINHERIT:            howto manager.      (line 2431)
13456* BFD_RELOC_MT_HI16:                     howto manager.      (line 2427)
13457* BFD_RELOC_MT_LO16:                     howto manager.      (line 2429)
13458* BFD_RELOC_MT_PC16:                     howto manager.      (line 2425)
13459* BFD_RELOC_MT_PCINSN8:                  howto manager.      (line 2435)
13460* BFD_RELOC_NDS32_10IFCU_PCREL:          howto manager.      (line 1439)
13461* BFD_RELOC_NDS32_10_UPCREL:             howto manager.      (line 1410)
13462* BFD_RELOC_NDS32_15_FIXED:              howto manager.      (line 1371)
13463* BFD_RELOC_NDS32_15_PCREL:              howto manager.      (line 1297)
13464* BFD_RELOC_NDS32_17IFC_PCREL:           howto manager.      (line 1438)
13465* BFD_RELOC_NDS32_17_FIXED:              howto manager.      (line 1372)
13466* BFD_RELOC_NDS32_17_PCREL:              howto manager.      (line 1299)
13467* BFD_RELOC_NDS32_20:                    howto manager.      (line 1289)
13468* BFD_RELOC_NDS32_25_ABS:                howto manager.      (line 1434)
13469* BFD_RELOC_NDS32_25_FIXED:              howto manager.      (line 1373)
13470* BFD_RELOC_NDS32_25_PCREL:              howto manager.      (line 1301)
13471* BFD_RELOC_NDS32_25_PLTREL:             howto manager.      (line 1347)
13472* BFD_RELOC_NDS32_5:                     howto manager.      (line 1408)
13473* BFD_RELOC_NDS32_9_FIXED:               howto manager.      (line 1370)
13474* BFD_RELOC_NDS32_9_PCREL:               howto manager.      (line 1291)
13475* BFD_RELOC_NDS32_9_PLTREL:              howto manager.      (line 1346)
13476* BFD_RELOC_NDS32_COPY:                  howto manager.      (line 1348)
13477* BFD_RELOC_NDS32_DATA:                  howto manager.      (line 1436)
13478* BFD_RELOC_NDS32_DIFF16:                howto manager.      (line 1429)
13479* BFD_RELOC_NDS32_DIFF32:                howto manager.      (line 1430)
13480* BFD_RELOC_NDS32_DIFF8:                 howto manager.      (line 1428)
13481* BFD_RELOC_NDS32_DIFF_ULEB128:          howto manager.      (line 1431)
13482* BFD_RELOC_NDS32_DWARF2_LEB:            howto manager.      (line 1394)
13483* BFD_RELOC_NDS32_DWARF2_OP1:            howto manager.      (line 1392)
13484* BFD_RELOC_NDS32_DWARF2_OP2:            howto manager.      (line 1393)
13485* BFD_RELOC_NDS32_EMPTY:                 howto manager.      (line 1432)
13486* BFD_RELOC_NDS32_GLOB_DAT:              howto manager.      (line 1349)
13487* BFD_RELOC_NDS32_GOT15S2:               howto manager.      (line 1405)
13488* BFD_RELOC_NDS32_GOT17S2:               howto manager.      (line 1406)
13489* BFD_RELOC_NDS32_GOT20:                 howto manager.      (line 1345)
13490* BFD_RELOC_NDS32_GOTOFF:                howto manager.      (line 1352)
13491* BFD_RELOC_NDS32_GOTOFF_HI20:           howto manager.      (line 1353)
13492* BFD_RELOC_NDS32_GOTOFF_LO12:           howto manager.      (line 1354)
13493* BFD_RELOC_NDS32_GOTOFF_LO15:           howto manager.      (line 1403)
13494* BFD_RELOC_NDS32_GOTOFF_LO19:           howto manager.      (line 1404)
13495* BFD_RELOC_NDS32_GOTOFF_SUFF:           howto manager.      (line 1417)
13496* BFD_RELOC_NDS32_GOTPC20:               howto manager.      (line 1355)
13497* BFD_RELOC_NDS32_GOTPC_HI20:            howto manager.      (line 1358)
13498* BFD_RELOC_NDS32_GOTPC_LO12:            howto manager.      (line 1359)
13499* BFD_RELOC_NDS32_GOTTPOFF:              howto manager.      (line 1442)
13500* BFD_RELOC_NDS32_GOT_HI20:              howto manager.      (line 1356)
13501* BFD_RELOC_NDS32_GOT_LO12:              howto manager.      (line 1357)
13502* BFD_RELOC_NDS32_GOT_LO15:              howto manager.      (line 1401)
13503* BFD_RELOC_NDS32_GOT_LO19:              howto manager.      (line 1402)
13504* BFD_RELOC_NDS32_GOT_SUFF:              howto manager.      (line 1416)
13505* BFD_RELOC_NDS32_GROUP:                 howto manager.      (line 1468)
13506* BFD_RELOC_NDS32_HI20:                  howto manager.      (line 1303)
13507* BFD_RELOC_NDS32_INSN16:                howto manager.      (line 1361)
13508* BFD_RELOC_NDS32_JMP_SLOT:              howto manager.      (line 1350)
13509* BFD_RELOC_NDS32_LABEL:                 howto manager.      (line 1362)
13510* BFD_RELOC_NDS32_LO12S0:                howto manager.      (line 1315)
13511* BFD_RELOC_NDS32_LO12S0_ORI:            howto manager.      (line 1318)
13512* BFD_RELOC_NDS32_LO12S1:                howto manager.      (line 1312)
13513* BFD_RELOC_NDS32_LO12S2:                howto manager.      (line 1309)
13514* BFD_RELOC_NDS32_LO12S2_DP:             howto manager.      (line 1389)
13515* BFD_RELOC_NDS32_LO12S2_SP:             howto manager.      (line 1390)
13516* BFD_RELOC_NDS32_LO12S3:                howto manager.      (line 1306)
13517* BFD_RELOC_NDS32_LOADSTORE:             howto manager.      (line 1369)
13518* BFD_RELOC_NDS32_LONGCALL1:             howto manager.      (line 1363)
13519* BFD_RELOC_NDS32_LONGCALL2:             howto manager.      (line 1364)
13520* BFD_RELOC_NDS32_LONGCALL3:             howto manager.      (line 1365)
13521* BFD_RELOC_NDS32_LONGCALL4:             howto manager.      (line 1374)
13522* BFD_RELOC_NDS32_LONGCALL5:             howto manager.      (line 1375)
13523* BFD_RELOC_NDS32_LONGCALL6:             howto manager.      (line 1376)
13524* BFD_RELOC_NDS32_LONGJUMP1:             howto manager.      (line 1366)
13525* BFD_RELOC_NDS32_LONGJUMP2:             howto manager.      (line 1367)
13526* BFD_RELOC_NDS32_LONGJUMP3:             howto manager.      (line 1368)
13527* BFD_RELOC_NDS32_LONGJUMP4:             howto manager.      (line 1377)
13528* BFD_RELOC_NDS32_LONGJUMP5:             howto manager.      (line 1378)
13529* BFD_RELOC_NDS32_LONGJUMP6:             howto manager.      (line 1379)
13530* BFD_RELOC_NDS32_LONGJUMP7:             howto manager.      (line 1380)
13531* BFD_RELOC_NDS32_LSI:                   howto manager.      (line 1470)
13532* BFD_RELOC_NDS32_MINUEND:               howto manager.      (line 1426)
13533* BFD_RELOC_NDS32_MULCALL_SUFF:          howto manager.      (line 1419)
13534* BFD_RELOC_NDS32_PLTBLOCK:              howto manager.      (line 1423)
13535* BFD_RELOC_NDS32_PLTREL_HI20:           howto manager.      (line 1382)
13536* BFD_RELOC_NDS32_PLTREL_LO12:           howto manager.      (line 1383)
13537* BFD_RELOC_NDS32_PLT_GOTREL_HI20:       howto manager.      (line 1384)
13538* BFD_RELOC_NDS32_PLT_GOTREL_LO12:       howto manager.      (line 1385)
13539* BFD_RELOC_NDS32_PLT_GOTREL_LO15:       howto manager.      (line 1399)
13540* BFD_RELOC_NDS32_PLT_GOTREL_LO19:       howto manager.      (line 1400)
13541* BFD_RELOC_NDS32_PLT_GOTREL_LO20:       howto manager.      (line 1398)
13542* BFD_RELOC_NDS32_PLT_GOT_SUFF:          howto manager.      (line 1418)
13543* BFD_RELOC_NDS32_PTR:                   howto manager.      (line 1420)
13544* BFD_RELOC_NDS32_PTR_COUNT:             howto manager.      (line 1421)
13545* BFD_RELOC_NDS32_PTR_RESOLVED:          howto manager.      (line 1422)
13546* BFD_RELOC_NDS32_RELATIVE:              howto manager.      (line 1351)
13547* BFD_RELOC_NDS32_RELAX_ENTRY:           howto manager.      (line 1415)
13548* BFD_RELOC_NDS32_RELAX_REGION_BEGIN:    howto manager.      (line 1424)
13549* BFD_RELOC_NDS32_RELAX_REGION_END:      howto manager.      (line 1425)
13550* BFD_RELOC_NDS32_REMOVE:                howto manager.      (line 1467)
13551* BFD_RELOC_NDS32_SDA12S2_DP:            howto manager.      (line 1387)
13552* BFD_RELOC_NDS32_SDA12S2_SP:            howto manager.      (line 1388)
13553* BFD_RELOC_NDS32_SDA15S0:               howto manager.      (line 1330)
13554* BFD_RELOC_NDS32_SDA15S1:               howto manager.      (line 1327)
13555* BFD_RELOC_NDS32_SDA15S2:               howto manager.      (line 1324)
13556* BFD_RELOC_NDS32_SDA15S3:               howto manager.      (line 1321)
13557* BFD_RELOC_NDS32_SDA16S3:               howto manager.      (line 1333)
13558* BFD_RELOC_NDS32_SDA17S2:               howto manager.      (line 1336)
13559* BFD_RELOC_NDS32_SDA18S1:               howto manager.      (line 1339)
13560* BFD_RELOC_NDS32_SDA19S0:               howto manager.      (line 1342)
13561* BFD_RELOC_NDS32_SDA_FP7U2_RELA:        howto manager.      (line 1413)
13562* BFD_RELOC_NDS32_SUBTRAHEND:            howto manager.      (line 1427)
13563* BFD_RELOC_NDS32_TLS_DESC:              howto manager.      (line 1458)
13564* BFD_RELOC_NDS32_TLS_DESC_20:           howto manager.      (line 1461)
13565* BFD_RELOC_NDS32_TLS_DESC_ADD:          howto manager.      (line 1463)
13566* BFD_RELOC_NDS32_TLS_DESC_CALL:         howto manager.      (line 1465)
13567* BFD_RELOC_NDS32_TLS_DESC_FUNC:         howto manager.      (line 1464)
13568* BFD_RELOC_NDS32_TLS_DESC_HI20:         howto manager.      (line 1459)
13569* BFD_RELOC_NDS32_TLS_DESC_LO12:         howto manager.      (line 1460)
13570* BFD_RELOC_NDS32_TLS_DESC_MEM:          howto manager.      (line 1466)
13571* BFD_RELOC_NDS32_TLS_DESC_SDA17S2:      howto manager.      (line 1462)
13572* BFD_RELOC_NDS32_TLS_IEGP_HI20:         howto manager.      (line 1454)
13573* BFD_RELOC_NDS32_TLS_IEGP_LO12:         howto manager.      (line 1455)
13574* BFD_RELOC_NDS32_TLS_IEGP_LO12S2:       howto manager.      (line 1456)
13575* BFD_RELOC_NDS32_TLS_IEGP_LW:           howto manager.      (line 1457)
13576* BFD_RELOC_NDS32_TLS_IE_HI20:           howto manager.      (line 1451)
13577* BFD_RELOC_NDS32_TLS_IE_LO12:           howto manager.      (line 1452)
13578* BFD_RELOC_NDS32_TLS_IE_LO12S2:         howto manager.      (line 1453)
13579* BFD_RELOC_NDS32_TLS_LE_15S0:           howto manager.      (line 1446)
13580* BFD_RELOC_NDS32_TLS_LE_15S1:           howto manager.      (line 1447)
13581* BFD_RELOC_NDS32_TLS_LE_15S2:           howto manager.      (line 1448)
13582* BFD_RELOC_NDS32_TLS_LE_20:             howto manager.      (line 1445)
13583* BFD_RELOC_NDS32_TLS_LE_ADD:            howto manager.      (line 1449)
13584* BFD_RELOC_NDS32_TLS_LE_HI20:           howto manager.      (line 1443)
13585* BFD_RELOC_NDS32_TLS_LE_LO12:           howto manager.      (line 1444)
13586* BFD_RELOC_NDS32_TLS_LE_LS:             howto manager.      (line 1450)
13587* BFD_RELOC_NDS32_TPOFF:                 howto manager.      (line 1441)
13588* BFD_RELOC_NDS32_TRAN:                  howto manager.      (line 1437)
13589* BFD_RELOC_NDS32_UPDATE_TA:             howto manager.      (line 1396)
13590* BFD_RELOC_NDS32_WORD_9_PCREL:          howto manager.      (line 1294)
13591* BFD_RELOC_NIOS2_ALIGN:                 howto manager.      (line 2476)
13592* BFD_RELOC_NIOS2_CACHE_OPX:             howto manager.      (line 2466)
13593* BFD_RELOC_NIOS2_CALL16:                howto manager.      (line 2478)
13594* BFD_RELOC_NIOS2_CALL26:                howto manager.      (line 2464)
13595* BFD_RELOC_NIOS2_CALL26_NOAT:           howto manager.      (line 2496)
13596* BFD_RELOC_NIOS2_CALLR:                 howto manager.      (line 2475)
13597* BFD_RELOC_NIOS2_CALL_HA:               howto manager.      (line 2500)
13598* BFD_RELOC_NIOS2_CALL_LO:               howto manager.      (line 2499)
13599* BFD_RELOC_NIOS2_CJMP:                  howto manager.      (line 2474)
13600* BFD_RELOC_NIOS2_COPY:                  howto manager.      (line 2491)
13601* BFD_RELOC_NIOS2_GLOB_DAT:              howto manager.      (line 2492)
13602* BFD_RELOC_NIOS2_GOT16:                 howto manager.      (line 2477)
13603* BFD_RELOC_NIOS2_GOTOFF:                howto manager.      (line 2495)
13604* BFD_RELOC_NIOS2_GOTOFF_HA:             howto manager.      (line 2480)
13605* BFD_RELOC_NIOS2_GOTOFF_LO:             howto manager.      (line 2479)
13606* BFD_RELOC_NIOS2_GOT_HA:                howto manager.      (line 2498)
13607* BFD_RELOC_NIOS2_GOT_LO:                howto manager.      (line 2497)
13608* BFD_RELOC_NIOS2_GPREL:                 howto manager.      (line 2472)
13609* BFD_RELOC_NIOS2_HI16:                  howto manager.      (line 2469)
13610* BFD_RELOC_NIOS2_HIADJ16:               howto manager.      (line 2471)
13611* BFD_RELOC_NIOS2_IMM5:                  howto manager.      (line 2465)
13612* BFD_RELOC_NIOS2_IMM6:                  howto manager.      (line 2467)
13613* BFD_RELOC_NIOS2_IMM8:                  howto manager.      (line 2468)
13614* BFD_RELOC_NIOS2_JUMP_SLOT:             howto manager.      (line 2493)
13615* BFD_RELOC_NIOS2_LO16:                  howto manager.      (line 2470)
13616* BFD_RELOC_NIOS2_PCREL_HA:              howto manager.      (line 2482)
13617* BFD_RELOC_NIOS2_PCREL_LO:              howto manager.      (line 2481)
13618* BFD_RELOC_NIOS2_R2_F1I5_2:             howto manager.      (line 2510)
13619* BFD_RELOC_NIOS2_R2_I10_1_PCREL:        howto manager.      (line 2502)
13620* BFD_RELOC_NIOS2_R2_L5I4X1:             howto manager.      (line 2511)
13621* BFD_RELOC_NIOS2_R2_S12:                howto manager.      (line 2501)
13622* BFD_RELOC_NIOS2_R2_T1I7_1_PCREL:       howto manager.      (line 2503)
13623* BFD_RELOC_NIOS2_R2_T1I7_2:             howto manager.      (line 2504)
13624* BFD_RELOC_NIOS2_R2_T1X1I6:             howto manager.      (line 2512)
13625* BFD_RELOC_NIOS2_R2_T1X1I6_2:           howto manager.      (line 2513)
13626* BFD_RELOC_NIOS2_R2_T2I4:               howto manager.      (line 2505)
13627* BFD_RELOC_NIOS2_R2_T2I4_1:             howto manager.      (line 2506)
13628* BFD_RELOC_NIOS2_R2_T2I4_2:             howto manager.      (line 2507)
13629* BFD_RELOC_NIOS2_R2_X1I7_2:             howto manager.      (line 2508)
13630* BFD_RELOC_NIOS2_R2_X2L5:               howto manager.      (line 2509)
13631* BFD_RELOC_NIOS2_RELATIVE:              howto manager.      (line 2494)
13632* BFD_RELOC_NIOS2_S16:                   howto manager.      (line 2462)
13633* BFD_RELOC_NIOS2_TLS_DTPMOD:            howto manager.      (line 2488)
13634* BFD_RELOC_NIOS2_TLS_DTPREL:            howto manager.      (line 2489)
13635* BFD_RELOC_NIOS2_TLS_GD16:              howto manager.      (line 2483)
13636* BFD_RELOC_NIOS2_TLS_IE16:              howto manager.      (line 2486)
13637* BFD_RELOC_NIOS2_TLS_LDM16:             howto manager.      (line 2484)
13638* BFD_RELOC_NIOS2_TLS_LDO16:             howto manager.      (line 2485)
13639* BFD_RELOC_NIOS2_TLS_LE16:              howto manager.      (line 2487)
13640* BFD_RELOC_NIOS2_TLS_TPREL:             howto manager.      (line 2490)
13641* BFD_RELOC_NIOS2_U16:                   howto manager.      (line 2463)
13642* BFD_RELOC_NIOS2_UJMP:                  howto manager.      (line 2473)
13643* BFD_RELOC_NONE:                        howto manager.      (line  118)
13644* BFD_RELOC_NS32K_DISP_16:               howto manager.      (line  589)
13645* BFD_RELOC_NS32K_DISP_16_PCREL:         howto manager.      (line  592)
13646* BFD_RELOC_NS32K_DISP_32:               howto manager.      (line  590)
13647* BFD_RELOC_NS32K_DISP_32_PCREL:         howto manager.      (line  593)
13648* BFD_RELOC_NS32K_DISP_8:                howto manager.      (line  588)
13649* BFD_RELOC_NS32K_DISP_8_PCREL:          howto manager.      (line  591)
13650* BFD_RELOC_NS32K_IMM_16:                howto manager.      (line  583)
13651* BFD_RELOC_NS32K_IMM_16_PCREL:          howto manager.      (line  586)
13652* BFD_RELOC_NS32K_IMM_32:                howto manager.      (line  584)
13653* BFD_RELOC_NS32K_IMM_32_PCREL:          howto manager.      (line  587)
13654* BFD_RELOC_NS32K_IMM_8:                 howto manager.      (line  582)
13655* BFD_RELOC_NS32K_IMM_8_PCREL:           howto manager.      (line  585)
13656* bfd_reloc_offset_in_range:             typedef arelent.    (line  303)
13657* bfd_reloc_offset_in_range <1>:         typedef arelent.    (line  307)
13658* BFD_RELOC_OR1K_COPY:                   howto manager.      (line 2380)
13659* BFD_RELOC_OR1K_GLOB_DAT:               howto manager.      (line 2381)
13660* BFD_RELOC_OR1K_GOT16:                  howto manager.      (line 2374)
13661* BFD_RELOC_OR1K_GOTOFF_SLO16:           howto manager.      (line 2379)
13662* BFD_RELOC_OR1K_GOTPC_HI16:             howto manager.      (line 2371)
13663* BFD_RELOC_OR1K_GOTPC_LO16:             howto manager.      (line 2372)
13664* BFD_RELOC_OR1K_GOT_AHI16:              howto manager.      (line 2373)
13665* BFD_RELOC_OR1K_GOT_LO13:               howto manager.      (line 2376)
13666* BFD_RELOC_OR1K_GOT_PG21:               howto manager.      (line 2375)
13667* BFD_RELOC_OR1K_JMP_SLOT:               howto manager.      (line 2382)
13668* BFD_RELOC_OR1K_LO13:                   howto manager.      (line 2369)
13669* BFD_RELOC_OR1K_PCREL_PG21:             howto manager.      (line 2368)
13670* BFD_RELOC_OR1K_PLT26:                  howto manager.      (line 2377)
13671* BFD_RELOC_OR1K_PLTA26:                 howto manager.      (line 2378)
13672* BFD_RELOC_OR1K_RELATIVE:               howto manager.      (line 2383)
13673* BFD_RELOC_OR1K_REL_26:                 howto manager.      (line 2366)
13674* BFD_RELOC_OR1K_SLO13:                  howto manager.      (line 2370)
13675* BFD_RELOC_OR1K_SLO16:                  howto manager.      (line 2367)
13676* BFD_RELOC_OR1K_TLS_DTPMOD:             howto manager.      (line 2405)
13677* BFD_RELOC_OR1K_TLS_DTPOFF:             howto manager.      (line 2404)
13678* BFD_RELOC_OR1K_TLS_GD_HI16:            howto manager.      (line 2384)
13679* BFD_RELOC_OR1K_TLS_GD_LO13:            howto manager.      (line 2387)
13680* BFD_RELOC_OR1K_TLS_GD_LO16:            howto manager.      (line 2385)
13681* BFD_RELOC_OR1K_TLS_GD_PG21:            howto manager.      (line 2386)
13682* BFD_RELOC_OR1K_TLS_IE_AHI16:           howto manager.      (line 2395)
13683* BFD_RELOC_OR1K_TLS_IE_HI16:            howto manager.      (line 2394)
13684* BFD_RELOC_OR1K_TLS_IE_LO13:            howto manager.      (line 2398)
13685* BFD_RELOC_OR1K_TLS_IE_LO16:            howto manager.      (line 2396)
13686* BFD_RELOC_OR1K_TLS_IE_PG21:            howto manager.      (line 2397)
13687* BFD_RELOC_OR1K_TLS_LDM_HI16:           howto manager.      (line 2388)
13688* BFD_RELOC_OR1K_TLS_LDM_LO13:           howto manager.      (line 2391)
13689* BFD_RELOC_OR1K_TLS_LDM_LO16:           howto manager.      (line 2389)
13690* BFD_RELOC_OR1K_TLS_LDM_PG21:           howto manager.      (line 2390)
13691* BFD_RELOC_OR1K_TLS_LDO_HI16:           howto manager.      (line 2392)
13692* BFD_RELOC_OR1K_TLS_LDO_LO16:           howto manager.      (line 2393)
13693* BFD_RELOC_OR1K_TLS_LE_AHI16:           howto manager.      (line 2400)
13694* BFD_RELOC_OR1K_TLS_LE_HI16:            howto manager.      (line 2399)
13695* BFD_RELOC_OR1K_TLS_LE_LO16:            howto manager.      (line 2401)
13696* BFD_RELOC_OR1K_TLS_LE_SLO16:           howto manager.      (line 2402)
13697* BFD_RELOC_OR1K_TLS_TPOFF:              howto manager.      (line 2403)
13698* BFD_RELOC_PDP11_DISP_6_PCREL:          howto manager.      (line  596)
13699* BFD_RELOC_PDP11_DISP_8_PCREL:          howto manager.      (line  595)
13700* BFD_RELOC_PJ_CODE_DIR16:               howto manager.      (line  600)
13701* BFD_RELOC_PJ_CODE_DIR32:               howto manager.      (line  601)
13702* BFD_RELOC_PJ_CODE_HI16:                howto manager.      (line  598)
13703* BFD_RELOC_PJ_CODE_LO16:                howto manager.      (line  599)
13704* BFD_RELOC_PJ_CODE_REL16:               howto manager.      (line  602)
13705* BFD_RELOC_PJ_CODE_REL32:               howto manager.      (line  603)
13706* BFD_RELOC_PPC64_ADDR16_DS:             howto manager.      (line  669)
13707* BFD_RELOC_PPC64_ADDR16_HIGH:           howto manager.      (line  680)
13708* BFD_RELOC_PPC64_ADDR16_HIGHA:          howto manager.      (line  681)
13709* BFD_RELOC_PPC64_ADDR16_HIGHER34:       howto manager.      (line  699)
13710* BFD_RELOC_PPC64_ADDR16_HIGHERA34:      howto manager.      (line  700)
13711* BFD_RELOC_PPC64_ADDR16_HIGHEST34:      howto manager.      (line  701)
13712* BFD_RELOC_PPC64_ADDR16_HIGHESTA34:     howto manager.      (line  702)
13713* BFD_RELOC_PPC64_ADDR16_LO_DS:          howto manager.      (line  670)
13714* BFD_RELOC_PPC64_ADDR64_LOCAL:          howto manager.      (line  688)
13715* BFD_RELOC_PPC64_D28:                   howto manager.      (line  707)
13716* BFD_RELOC_PPC64_D34:                   howto manager.      (line  692)
13717* BFD_RELOC_PPC64_D34_HA30:              howto manager.      (line  695)
13718* BFD_RELOC_PPC64_D34_HI30:              howto manager.      (line  694)
13719* BFD_RELOC_PPC64_D34_LO:                howto manager.      (line  693)
13720* BFD_RELOC_PPC64_DTPREL16_DS:           howto manager.      (line  758)
13721* BFD_RELOC_PPC64_DTPREL16_HIGH:         howto manager.      (line  760)
13722* BFD_RELOC_PPC64_DTPREL16_HIGHA:        howto manager.      (line  761)
13723* BFD_RELOC_PPC64_DTPREL16_HIGHER:       howto manager.      (line  762)
13724* BFD_RELOC_PPC64_DTPREL16_HIGHERA:      howto manager.      (line  763)
13725* BFD_RELOC_PPC64_DTPREL16_HIGHEST:      howto manager.      (line  764)
13726* BFD_RELOC_PPC64_DTPREL16_HIGHESTA:     howto manager.      (line  765)
13727* BFD_RELOC_PPC64_DTPREL16_LO_DS:        howto manager.      (line  759)
13728* BFD_RELOC_PPC64_DTPREL34:              howto manager.      (line  767)
13729* BFD_RELOC_PPC64_ENTRY:                 howto manager.      (line  689)
13730* BFD_RELOC_PPC64_GOT16_DS:              howto manager.      (line  671)
13731* BFD_RELOC_PPC64_GOT16_LO_DS:           howto manager.      (line  672)
13732* BFD_RELOC_PPC64_GOT_DTPREL_PCREL34:    howto manager.      (line  771)
13733* BFD_RELOC_PPC64_GOT_PCREL34:           howto manager.      (line  697)
13734* BFD_RELOC_PPC64_GOT_TLSGD_PCREL34:     howto manager.      (line  768)
13735* BFD_RELOC_PPC64_GOT_TLSLD_PCREL34:     howto manager.      (line  769)
13736* BFD_RELOC_PPC64_GOT_TPREL_PCREL34:     howto manager.      (line  770)
13737* BFD_RELOC_PPC64_HIGHER:                howto manager.      (line  657)
13738* BFD_RELOC_PPC64_HIGHER_S:              howto manager.      (line  658)
13739* BFD_RELOC_PPC64_HIGHEST:               howto manager.      (line  659)
13740* BFD_RELOC_PPC64_HIGHEST_S:             howto manager.      (line  660)
13741* BFD_RELOC_PPC64_PCREL28:               howto manager.      (line  708)
13742* BFD_RELOC_PPC64_PCREL34:               howto manager.      (line  696)
13743* BFD_RELOC_PPC64_PLT16_LO_DS:           howto manager.      (line  673)
13744* BFD_RELOC_PPC64_PLTGOT16:              howto manager.      (line  665)
13745* BFD_RELOC_PPC64_PLTGOT16_DS:           howto manager.      (line  678)
13746* BFD_RELOC_PPC64_PLTGOT16_HA:           howto manager.      (line  668)
13747* BFD_RELOC_PPC64_PLTGOT16_HI:           howto manager.      (line  667)
13748* BFD_RELOC_PPC64_PLTGOT16_LO:           howto manager.      (line  666)
13749* BFD_RELOC_PPC64_PLTGOT16_LO_DS:        howto manager.      (line  679)
13750* BFD_RELOC_PPC64_PLT_PCREL34:           howto manager.      (line  698)
13751* BFD_RELOC_PPC64_REL16_HIGH:            howto manager.      (line  682)
13752* BFD_RELOC_PPC64_REL16_HIGHA:           howto manager.      (line  683)
13753* BFD_RELOC_PPC64_REL16_HIGHER:          howto manager.      (line  684)
13754* BFD_RELOC_PPC64_REL16_HIGHER34:        howto manager.      (line  703)
13755* BFD_RELOC_PPC64_REL16_HIGHERA:         howto manager.      (line  685)
13756* BFD_RELOC_PPC64_REL16_HIGHERA34:       howto manager.      (line  704)
13757* BFD_RELOC_PPC64_REL16_HIGHEST:         howto manager.      (line  686)
13758* BFD_RELOC_PPC64_REL16_HIGHEST34:       howto manager.      (line  705)
13759* BFD_RELOC_PPC64_REL16_HIGHESTA:        howto manager.      (line  687)
13760* BFD_RELOC_PPC64_REL16_HIGHESTA34:      howto manager.      (line  706)
13761* BFD_RELOC_PPC64_REL24_NOTOC:           howto manager.      (line  690)
13762* BFD_RELOC_PPC64_REL24_P9NOTOC:         howto manager.      (line  691)
13763* BFD_RELOC_PPC64_SECTOFF_DS:            howto manager.      (line  674)
13764* BFD_RELOC_PPC64_SECTOFF_LO_DS:         howto manager.      (line  675)
13765* BFD_RELOC_PPC64_TLSGD:                 howto manager.      (line  744)
13766* BFD_RELOC_PPC64_TLSIE:                 howto manager.      (line  747)
13767* BFD_RELOC_PPC64_TLSLD:                 howto manager.      (line  745)
13768* BFD_RELOC_PPC64_TLSLE:                 howto manager.      (line  746)
13769* BFD_RELOC_PPC64_TLSM:                  howto manager.      (line  748)
13770* BFD_RELOC_PPC64_TLSML:                 howto manager.      (line  749)
13771* BFD_RELOC_PPC64_TLS_PCREL:             howto manager.      (line  772)
13772* BFD_RELOC_PPC64_TOC:                   howto manager.      (line  664)
13773* BFD_RELOC_PPC64_TOC16_DS:              howto manager.      (line  676)
13774* BFD_RELOC_PPC64_TOC16_HA:              howto manager.      (line  663)
13775* BFD_RELOC_PPC64_TOC16_HI:              howto manager.      (line  662)
13776* BFD_RELOC_PPC64_TOC16_LO:              howto manager.      (line  661)
13777* BFD_RELOC_PPC64_TOC16_LO_DS:           howto manager.      (line  677)
13778* BFD_RELOC_PPC64_TPREL16_DS:            howto manager.      (line  750)
13779* BFD_RELOC_PPC64_TPREL16_HIGH:          howto manager.      (line  752)
13780* BFD_RELOC_PPC64_TPREL16_HIGHA:         howto manager.      (line  753)
13781* BFD_RELOC_PPC64_TPREL16_HIGHER:        howto manager.      (line  754)
13782* BFD_RELOC_PPC64_TPREL16_HIGHERA:       howto manager.      (line  755)
13783* BFD_RELOC_PPC64_TPREL16_HIGHEST:       howto manager.      (line  756)
13784* BFD_RELOC_PPC64_TPREL16_HIGHESTA:      howto manager.      (line  757)
13785* BFD_RELOC_PPC64_TPREL16_LO_DS:         howto manager.      (line  751)
13786* BFD_RELOC_PPC64_TPREL34:               howto manager.      (line  766)
13787* BFD_RELOC_PPC_16DX_HA:                 howto manager.      (line  654)
13788* BFD_RELOC_PPC_B16:                     howto manager.      (line  610)
13789* BFD_RELOC_PPC_B16_BRNTAKEN:            howto manager.      (line  612)
13790* BFD_RELOC_PPC_B16_BRTAKEN:             howto manager.      (line  611)
13791* BFD_RELOC_PPC_B26:                     howto manager.      (line  605)
13792* BFD_RELOC_PPC_BA16:                    howto manager.      (line  613)
13793* BFD_RELOC_PPC_BA16_BRNTAKEN:           howto manager.      (line  615)
13794* BFD_RELOC_PPC_BA16_BRTAKEN:            howto manager.      (line  614)
13795* BFD_RELOC_PPC_BA26:                    howto manager.      (line  606)
13796* BFD_RELOC_PPC_COPY:                    howto manager.      (line  616)
13797* BFD_RELOC_PPC_DTPMOD:                  howto manager.      (line  717)
13798* BFD_RELOC_PPC_DTPREL:                  howto manager.      (line  727)
13799* BFD_RELOC_PPC_DTPREL16:                howto manager.      (line  723)
13800* BFD_RELOC_PPC_DTPREL16_HA:             howto manager.      (line  726)
13801* BFD_RELOC_PPC_DTPREL16_HI:             howto manager.      (line  725)
13802* BFD_RELOC_PPC_DTPREL16_LO:             howto manager.      (line  724)
13803* BFD_RELOC_PPC_EMB_BIT_FLD:             howto manager.      (line  635)
13804* BFD_RELOC_PPC_EMB_MRKREF:              howto manager.      (line  630)
13805* BFD_RELOC_PPC_EMB_NADDR16:             howto manager.      (line  622)
13806* BFD_RELOC_PPC_EMB_NADDR16_HA:          howto manager.      (line  625)
13807* BFD_RELOC_PPC_EMB_NADDR16_HI:          howto manager.      (line  624)
13808* BFD_RELOC_PPC_EMB_NADDR16_LO:          howto manager.      (line  623)
13809* BFD_RELOC_PPC_EMB_NADDR32:             howto manager.      (line  621)
13810* BFD_RELOC_PPC_EMB_RELSDA:              howto manager.      (line  636)
13811* BFD_RELOC_PPC_EMB_RELSEC16:            howto manager.      (line  631)
13812* BFD_RELOC_PPC_EMB_RELST_HA:            howto manager.      (line  634)
13813* BFD_RELOC_PPC_EMB_RELST_HI:            howto manager.      (line  633)
13814* BFD_RELOC_PPC_EMB_RELST_LO:            howto manager.      (line  632)
13815* BFD_RELOC_PPC_EMB_SDA21:               howto manager.      (line  629)
13816* BFD_RELOC_PPC_EMB_SDA2I16:             howto manager.      (line  627)
13817* BFD_RELOC_PPC_EMB_SDA2REL:             howto manager.      (line  628)
13818* BFD_RELOC_PPC_EMB_SDAI16:              howto manager.      (line  626)
13819* BFD_RELOC_PPC_GLOB_DAT:                howto manager.      (line  617)
13820* BFD_RELOC_PPC_GOT_DTPREL16:            howto manager.      (line  740)
13821* BFD_RELOC_PPC_GOT_DTPREL16_HA:         howto manager.      (line  743)
13822* BFD_RELOC_PPC_GOT_DTPREL16_HI:         howto manager.      (line  742)
13823* BFD_RELOC_PPC_GOT_DTPREL16_LO:         howto manager.      (line  741)
13824* BFD_RELOC_PPC_GOT_TLSGD16:             howto manager.      (line  728)
13825* BFD_RELOC_PPC_GOT_TLSGD16_HA:          howto manager.      (line  731)
13826* BFD_RELOC_PPC_GOT_TLSGD16_HI:          howto manager.      (line  730)
13827* BFD_RELOC_PPC_GOT_TLSGD16_LO:          howto manager.      (line  729)
13828* BFD_RELOC_PPC_GOT_TLSLD16:             howto manager.      (line  732)
13829* BFD_RELOC_PPC_GOT_TLSLD16_HA:          howto manager.      (line  735)
13830* BFD_RELOC_PPC_GOT_TLSLD16_HI:          howto manager.      (line  734)
13831* BFD_RELOC_PPC_GOT_TLSLD16_LO:          howto manager.      (line  733)
13832* BFD_RELOC_PPC_GOT_TPREL16:             howto manager.      (line  736)
13833* BFD_RELOC_PPC_GOT_TPREL16_HA:          howto manager.      (line  739)
13834* BFD_RELOC_PPC_GOT_TPREL16_HI:          howto manager.      (line  738)
13835* BFD_RELOC_PPC_GOT_TPREL16_LO:          howto manager.      (line  737)
13836* BFD_RELOC_PPC_JMP_SLOT:                howto manager.      (line  618)
13837* BFD_RELOC_PPC_LOCAL24PC:               howto manager.      (line  620)
13838* BFD_RELOC_PPC_NEG:                     howto manager.      (line  656)
13839* BFD_RELOC_PPC_REL16DX_HA:              howto manager.      (line  655)
13840* BFD_RELOC_PPC_RELATIVE:                howto manager.      (line  619)
13841* BFD_RELOC_PPC_TLS:                     howto manager.      (line  710)
13842* BFD_RELOC_PPC_TLSGD:                   howto manager.      (line  711)
13843* BFD_RELOC_PPC_TLSIE:                   howto manager.      (line  714)
13844* BFD_RELOC_PPC_TLSLD:                   howto manager.      (line  712)
13845* BFD_RELOC_PPC_TLSLE:                   howto manager.      (line  713)
13846* BFD_RELOC_PPC_TLSM:                    howto manager.      (line  715)
13847* BFD_RELOC_PPC_TLSML:                   howto manager.      (line  716)
13848* BFD_RELOC_PPC_TOC16:                   howto manager.      (line  607)
13849* BFD_RELOC_PPC_TOC16_HI:                howto manager.      (line  609)
13850* BFD_RELOC_PPC_TOC16_LO:                howto manager.      (line  608)
13851* BFD_RELOC_PPC_TPREL:                   howto manager.      (line  722)
13852* BFD_RELOC_PPC_TPREL16:                 howto manager.      (line  718)
13853* BFD_RELOC_PPC_TPREL16_HA:              howto manager.      (line  721)
13854* BFD_RELOC_PPC_TPREL16_HI:              howto manager.      (line  720)
13855* BFD_RELOC_PPC_TPREL16_LO:              howto manager.      (line  719)
13856* BFD_RELOC_PPC_VLE_HA16A:               howto manager.      (line  644)
13857* BFD_RELOC_PPC_VLE_HA16D:               howto manager.      (line  645)
13858* BFD_RELOC_PPC_VLE_HI16A:               howto manager.      (line  642)
13859* BFD_RELOC_PPC_VLE_HI16D:               howto manager.      (line  643)
13860* BFD_RELOC_PPC_VLE_LO16A:               howto manager.      (line  640)
13861* BFD_RELOC_PPC_VLE_LO16D:               howto manager.      (line  641)
13862* BFD_RELOC_PPC_VLE_REL15:               howto manager.      (line  638)
13863* BFD_RELOC_PPC_VLE_REL24:               howto manager.      (line  639)
13864* BFD_RELOC_PPC_VLE_REL8:                howto manager.      (line  637)
13865* BFD_RELOC_PPC_VLE_SDA21:               howto manager.      (line  646)
13866* BFD_RELOC_PPC_VLE_SDA21_LO:            howto manager.      (line  647)
13867* BFD_RELOC_PPC_VLE_SDAREL_HA16A:        howto manager.      (line  652)
13868* BFD_RELOC_PPC_VLE_SDAREL_HA16D:        howto manager.      (line  653)
13869* BFD_RELOC_PPC_VLE_SDAREL_HI16A:        howto manager.      (line  650)
13870* BFD_RELOC_PPC_VLE_SDAREL_HI16D:        howto manager.      (line  651)
13871* BFD_RELOC_PPC_VLE_SDAREL_LO16A:        howto manager.      (line  648)
13872* BFD_RELOC_PPC_VLE_SDAREL_LO16D:        howto manager.      (line  649)
13873* BFD_RELOC_PRU_16_PMEM:                 howto manager.      (line 2528)
13874* BFD_RELOC_PRU_32_PMEM:                 howto manager.      (line 2527)
13875* BFD_RELOC_PRU_GNU_DIFF16:              howto manager.      (line 2532)
13876* BFD_RELOC_PRU_GNU_DIFF16_PMEM:         howto manager.      (line 2534)
13877* BFD_RELOC_PRU_GNU_DIFF32:              howto manager.      (line 2533)
13878* BFD_RELOC_PRU_GNU_DIFF32_PMEM:         howto manager.      (line 2535)
13879* BFD_RELOC_PRU_GNU_DIFF8:               howto manager.      (line 2531)
13880* BFD_RELOC_PRU_LDI32:                   howto manager.      (line 2519)
13881* BFD_RELOC_PRU_S10_PCREL:               howto manager.      (line 2523)
13882* BFD_RELOC_PRU_U16:                     howto manager.      (line 2515)
13883* BFD_RELOC_PRU_U16_PMEMIMM:             howto manager.      (line 2517)
13884* BFD_RELOC_PRU_U8_PCREL:                howto manager.      (line 2525)
13885* BFD_RELOC_RELC:                        howto manager.      (line 2419)
13886* BFD_RELOC_RISCV_32_PCREL:              howto manager.      (line 1885)
13887* BFD_RELOC_RISCV_ADD16:                 howto manager.      (line 1858)
13888* BFD_RELOC_RISCV_ADD32:                 howto manager.      (line 1859)
13889* BFD_RELOC_RISCV_ADD64:                 howto manager.      (line 1860)
13890* BFD_RELOC_RISCV_ADD8:                  howto manager.      (line 1857)
13891* BFD_RELOC_RISCV_ALIGN:                 howto manager.      (line 1875)
13892* BFD_RELOC_RISCV_CALL:                  howto manager.      (line 1855)
13893* BFD_RELOC_RISCV_CALL_PLT:              howto manager.      (line 1856)
13894* BFD_RELOC_RISCV_CFA:                   howto manager.      (line 1879)
13895* BFD_RELOC_RISCV_GOT_HI20:              howto manager.      (line 1865)
13896* BFD_RELOC_RISCV_GPREL12_I:             howto manager.      (line 1849)
13897* BFD_RELOC_RISCV_GPREL12_S:             howto manager.      (line 1850)
13898* BFD_RELOC_RISCV_HI20:                  howto manager.      (line 1843)
13899* BFD_RELOC_RISCV_JMP:                   howto manager.      (line 1868)
13900* BFD_RELOC_RISCV_LO12_I:                howto manager.      (line 1847)
13901* BFD_RELOC_RISCV_LO12_S:                howto manager.      (line 1848)
13902* BFD_RELOC_RISCV_PCREL_HI20:            howto manager.      (line 1844)
13903* BFD_RELOC_RISCV_PCREL_LO12_I:          howto manager.      (line 1845)
13904* BFD_RELOC_RISCV_PCREL_LO12_S:          howto manager.      (line 1846)
13905* BFD_RELOC_RISCV_RELAX:                 howto manager.      (line 1878)
13906* BFD_RELOC_RISCV_RVC_BRANCH:            howto manager.      (line 1876)
13907* BFD_RELOC_RISCV_RVC_JUMP:              howto manager.      (line 1877)
13908* BFD_RELOC_RISCV_SET16:                 howto manager.      (line 1883)
13909* BFD_RELOC_RISCV_SET32:                 howto manager.      (line 1884)
13910* BFD_RELOC_RISCV_SET6:                  howto manager.      (line 1881)
13911* BFD_RELOC_RISCV_SET8:                  howto manager.      (line 1882)
13912* BFD_RELOC_RISCV_SET_ULEB128:           howto manager.      (line 1886)
13913* BFD_RELOC_RISCV_SUB16:                 howto manager.      (line 1862)
13914* BFD_RELOC_RISCV_SUB32:                 howto manager.      (line 1863)
13915* BFD_RELOC_RISCV_SUB6:                  howto manager.      (line 1880)
13916* BFD_RELOC_RISCV_SUB64:                 howto manager.      (line 1864)
13917* BFD_RELOC_RISCV_SUB8:                  howto manager.      (line 1861)
13918* BFD_RELOC_RISCV_SUB_ULEB128:           howto manager.      (line 1887)
13919* BFD_RELOC_RISCV_TLS_DTPMOD32:          howto manager.      (line 1869)
13920* BFD_RELOC_RISCV_TLS_DTPMOD64:          howto manager.      (line 1871)
13921* BFD_RELOC_RISCV_TLS_DTPREL32:          howto manager.      (line 1870)
13922* BFD_RELOC_RISCV_TLS_DTPREL64:          howto manager.      (line 1872)
13923* BFD_RELOC_RISCV_TLS_GD_HI20:           howto manager.      (line 1867)
13924* BFD_RELOC_RISCV_TLS_GOT_HI20:          howto manager.      (line 1866)
13925* BFD_RELOC_RISCV_TLS_TPREL32:           howto manager.      (line 1873)
13926* BFD_RELOC_RISCV_TLS_TPREL64:           howto manager.      (line 1874)
13927* BFD_RELOC_RISCV_TPREL_ADD:             howto manager.      (line 1854)
13928* BFD_RELOC_RISCV_TPREL_HI20:            howto manager.      (line 1851)
13929* BFD_RELOC_RISCV_TPREL_LO12_I:          howto manager.      (line 1852)
13930* BFD_RELOC_RISCV_TPREL_LO12_S:          howto manager.      (line 1853)
13931* BFD_RELOC_RL78_16U:                    howto manager.      (line 1897)
13932* BFD_RELOC_RL78_16_OP:                  howto manager.      (line 1893)
13933* BFD_RELOC_RL78_24U:                    howto manager.      (line 1898)
13934* BFD_RELOC_RL78_24_OP:                  howto manager.      (line 1894)
13935* BFD_RELOC_RL78_32_OP:                  howto manager.      (line 1895)
13936* BFD_RELOC_RL78_8U:                     howto manager.      (line 1896)
13937* BFD_RELOC_RL78_ABS16:                  howto manager.      (line 1910)
13938* BFD_RELOC_RL78_ABS16U:                 howto manager.      (line 1914)
13939* BFD_RELOC_RL78_ABS16UL:                howto manager.      (line 1916)
13940* BFD_RELOC_RL78_ABS16UW:                howto manager.      (line 1915)
13941* BFD_RELOC_RL78_ABS16_REV:              howto manager.      (line 1911)
13942* BFD_RELOC_RL78_ABS32:                  howto manager.      (line 1912)
13943* BFD_RELOC_RL78_ABS32_REV:              howto manager.      (line 1913)
13944* BFD_RELOC_RL78_ABS8:                   howto manager.      (line 1909)
13945* BFD_RELOC_RL78_CODE:                   howto manager.      (line 1921)
13946* BFD_RELOC_RL78_DIFF:                   howto manager.      (line 1900)
13947* BFD_RELOC_RL78_DIR3U_PCREL:            howto manager.      (line 1899)
13948* BFD_RELOC_RL78_GPRELB:                 howto manager.      (line 1901)
13949* BFD_RELOC_RL78_GPRELL:                 howto manager.      (line 1903)
13950* BFD_RELOC_RL78_GPRELW:                 howto manager.      (line 1902)
13951* BFD_RELOC_RL78_HI16:                   howto manager.      (line 1918)
13952* BFD_RELOC_RL78_HI8:                    howto manager.      (line 1919)
13953* BFD_RELOC_RL78_LO16:                   howto manager.      (line 1920)
13954* BFD_RELOC_RL78_NEG16:                  howto manager.      (line 1890)
13955* BFD_RELOC_RL78_NEG24:                  howto manager.      (line 1891)
13956* BFD_RELOC_RL78_NEG32:                  howto manager.      (line 1892)
13957* BFD_RELOC_RL78_NEG8:                   howto manager.      (line 1889)
13958* BFD_RELOC_RL78_OP_AND:                 howto manager.      (line 1907)
13959* BFD_RELOC_RL78_OP_NEG:                 howto manager.      (line 1906)
13960* BFD_RELOC_RL78_OP_SHRA:                howto manager.      (line 1908)
13961* BFD_RELOC_RL78_OP_SUBTRACT:            howto manager.      (line 1905)
13962* BFD_RELOC_RL78_RELAX:                  howto manager.      (line 1917)
13963* BFD_RELOC_RL78_SADDR:                  howto manager.      (line 1922)
13964* BFD_RELOC_RL78_SYM:                    howto manager.      (line 1904)
13965* BFD_RELOC_RVA:                         howto manager.      (line   95)
13966* BFD_RELOC_RX_16U:                      howto manager.      (line 1932)
13967* BFD_RELOC_RX_16_OP:                    howto manager.      (line 1928)
13968* BFD_RELOC_RX_24U:                      howto manager.      (line 1933)
13969* BFD_RELOC_RX_24_OP:                    howto manager.      (line 1929)
13970* BFD_RELOC_RX_32_OP:                    howto manager.      (line 1930)
13971* BFD_RELOC_RX_8U:                       howto manager.      (line 1931)
13972* BFD_RELOC_RX_ABS16:                    howto manager.      (line 1943)
13973* BFD_RELOC_RX_ABS16U:                   howto manager.      (line 1947)
13974* BFD_RELOC_RX_ABS16UL:                  howto manager.      (line 1949)
13975* BFD_RELOC_RX_ABS16UW:                  howto manager.      (line 1948)
13976* BFD_RELOC_RX_ABS16_REV:                howto manager.      (line 1944)
13977* BFD_RELOC_RX_ABS32:                    howto manager.      (line 1945)
13978* BFD_RELOC_RX_ABS32_REV:                howto manager.      (line 1946)
13979* BFD_RELOC_RX_ABS8:                     howto manager.      (line 1942)
13980* BFD_RELOC_RX_DIFF:                     howto manager.      (line 1935)
13981* BFD_RELOC_RX_DIR3U_PCREL:              howto manager.      (line 1934)
13982* BFD_RELOC_RX_GPRELB:                   howto manager.      (line 1936)
13983* BFD_RELOC_RX_GPRELL:                   howto manager.      (line 1938)
13984* BFD_RELOC_RX_GPRELW:                   howto manager.      (line 1937)
13985* BFD_RELOC_RX_NEG16:                    howto manager.      (line 1925)
13986* BFD_RELOC_RX_NEG24:                    howto manager.      (line 1926)
13987* BFD_RELOC_RX_NEG32:                    howto manager.      (line 1927)
13988* BFD_RELOC_RX_NEG8:                     howto manager.      (line 1924)
13989* BFD_RELOC_RX_OP_NEG:                   howto manager.      (line 1941)
13990* BFD_RELOC_RX_OP_SUBTRACT:              howto manager.      (line 1940)
13991* BFD_RELOC_RX_RELAX:                    howto manager.      (line 1950)
13992* BFD_RELOC_RX_SYM:                      howto manager.      (line 1939)
13993* BFD_RELOC_S12Z_15_PCREL:               howto manager.      (line 2262)
13994* BFD_RELOC_S12Z_OPR:                    howto manager.      (line 3520)
13995* BFD_RELOC_SCORE16_BRANCH:              howto manager.      (line 2053)
13996* BFD_RELOC_SCORE16_JMP:                 howto manager.      (line 2051)
13997* BFD_RELOC_SCORE_BCMP:                  howto manager.      (line 2055)
13998* BFD_RELOC_SCORE_BRANCH:                howto manager.      (line 2045)
13999* BFD_RELOC_SCORE_CALL15:                howto manager.      (line 2059)
14000* BFD_RELOC_SCORE_DUMMY2:                howto manager.      (line 2042)
14001* BFD_RELOC_SCORE_DUMMY_HI16:            howto manager.      (line 2060)
14002* BFD_RELOC_SCORE_GOT15:                 howto manager.      (line 2057)
14003* BFD_RELOC_SCORE_GOT_LO16:              howto manager.      (line 2058)
14004* BFD_RELOC_SCORE_GPREL15:               howto manager.      (line 2040)
14005* BFD_RELOC_SCORE_IMM30:                 howto manager.      (line 2047)
14006* BFD_RELOC_SCORE_IMM32:                 howto manager.      (line 2049)
14007* BFD_RELOC_SCORE_JMP:                   howto manager.      (line 2043)
14008* BFD_RELOC_SH_ALIGN:                    howto manager.      (line  969)
14009* BFD_RELOC_SH_CODE:                     howto manager.      (line  970)
14010* BFD_RELOC_SH_COPY:                     howto manager.      (line  975)
14011* BFD_RELOC_SH_COPY64:                   howto manager.      (line 1000)
14012* BFD_RELOC_SH_COUNT:                    howto manager.      (line  968)
14013* BFD_RELOC_SH_DATA:                     howto manager.      (line  971)
14014* BFD_RELOC_SH_DISP12:                   howto manager.      (line  951)
14015* BFD_RELOC_SH_DISP12BY2:                howto manager.      (line  952)
14016* BFD_RELOC_SH_DISP12BY4:                howto manager.      (line  953)
14017* BFD_RELOC_SH_DISP12BY8:                howto manager.      (line  954)
14018* BFD_RELOC_SH_DISP20:                   howto manager.      (line  955)
14019* BFD_RELOC_SH_DISP20BY8:                howto manager.      (line  956)
14020* BFD_RELOC_SH_FUNCDESC:                 howto manager.      (line 1043)
14021* BFD_RELOC_SH_GLOB_DAT:                 howto manager.      (line  976)
14022* BFD_RELOC_SH_GLOB_DAT64:               howto manager.      (line 1001)
14023* BFD_RELOC_SH_GOT10BY4:                 howto manager.      (line 1004)
14024* BFD_RELOC_SH_GOT10BY8:                 howto manager.      (line 1005)
14025* BFD_RELOC_SH_GOT20:                    howto manager.      (line 1037)
14026* BFD_RELOC_SH_GOTFUNCDESC:              howto manager.      (line 1039)
14027* BFD_RELOC_SH_GOTFUNCDESC20:            howto manager.      (line 1040)
14028* BFD_RELOC_SH_GOTOFF20:                 howto manager.      (line 1038)
14029* BFD_RELOC_SH_GOTOFFFUNCDESC:           howto manager.      (line 1041)
14030* BFD_RELOC_SH_GOTOFFFUNCDESC20:         howto manager.      (line 1042)
14031* BFD_RELOC_SH_GOTOFF_HI16:              howto manager.      (line  995)
14032* BFD_RELOC_SH_GOTOFF_LOW16:             howto manager.      (line  992)
14033* BFD_RELOC_SH_GOTOFF_MEDHI16:           howto manager.      (line  994)
14034* BFD_RELOC_SH_GOTOFF_MEDLOW16:          howto manager.      (line  993)
14035* BFD_RELOC_SH_GOTPC:                    howto manager.      (line  979)
14036* BFD_RELOC_SH_GOTPC_HI16:               howto manager.      (line  999)
14037* BFD_RELOC_SH_GOTPC_LOW16:              howto manager.      (line  996)
14038* BFD_RELOC_SH_GOTPC_MEDHI16:            howto manager.      (line  998)
14039* BFD_RELOC_SH_GOTPC_MEDLOW16:           howto manager.      (line  997)
14040* BFD_RELOC_SH_GOTPLT10BY4:              howto manager.      (line 1006)
14041* BFD_RELOC_SH_GOTPLT10BY8:              howto manager.      (line 1007)
14042* BFD_RELOC_SH_GOTPLT32:                 howto manager.      (line 1008)
14043* BFD_RELOC_SH_GOTPLT_HI16:              howto manager.      (line  987)
14044* BFD_RELOC_SH_GOTPLT_LOW16:             howto manager.      (line  984)
14045* BFD_RELOC_SH_GOTPLT_MEDHI16:           howto manager.      (line  986)
14046* BFD_RELOC_SH_GOTPLT_MEDLOW16:          howto manager.      (line  985)
14047* BFD_RELOC_SH_GOT_HI16:                 howto manager.      (line  983)
14048* BFD_RELOC_SH_GOT_LOW16:                howto manager.      (line  980)
14049* BFD_RELOC_SH_GOT_MEDHI16:              howto manager.      (line  982)
14050* BFD_RELOC_SH_GOT_MEDLOW16:             howto manager.      (line  981)
14051* BFD_RELOC_SH_IMM3:                     howto manager.      (line  949)
14052* BFD_RELOC_SH_IMM3U:                    howto manager.      (line  950)
14053* BFD_RELOC_SH_IMM4:                     howto manager.      (line  957)
14054* BFD_RELOC_SH_IMM4BY2:                  howto manager.      (line  958)
14055* BFD_RELOC_SH_IMM4BY4:                  howto manager.      (line  959)
14056* BFD_RELOC_SH_IMM8:                     howto manager.      (line  960)
14057* BFD_RELOC_SH_IMM8BY2:                  howto manager.      (line  961)
14058* BFD_RELOC_SH_IMM8BY4:                  howto manager.      (line  962)
14059* BFD_RELOC_SH_IMMS10:                   howto manager.      (line 1014)
14060* BFD_RELOC_SH_IMMS10BY2:                howto manager.      (line 1015)
14061* BFD_RELOC_SH_IMMS10BY4:                howto manager.      (line 1016)
14062* BFD_RELOC_SH_IMMS10BY8:                howto manager.      (line 1017)
14063* BFD_RELOC_SH_IMMS16:                   howto manager.      (line 1018)
14064* BFD_RELOC_SH_IMMS6:                    howto manager.      (line 1011)
14065* BFD_RELOC_SH_IMMS6BY32:                howto manager.      (line 1012)
14066* BFD_RELOC_SH_IMMU16:                   howto manager.      (line 1019)
14067* BFD_RELOC_SH_IMMU5:                    howto manager.      (line 1010)
14068* BFD_RELOC_SH_IMMU6:                    howto manager.      (line 1013)
14069* BFD_RELOC_SH_IMM_HI16:                 howto manager.      (line 1026)
14070* BFD_RELOC_SH_IMM_HI16_PCREL:           howto manager.      (line 1027)
14071* BFD_RELOC_SH_IMM_LOW16:                howto manager.      (line 1020)
14072* BFD_RELOC_SH_IMM_LOW16_PCREL:          howto manager.      (line 1021)
14073* BFD_RELOC_SH_IMM_MEDHI16:              howto manager.      (line 1024)
14074* BFD_RELOC_SH_IMM_MEDHI16_PCREL:        howto manager.      (line 1025)
14075* BFD_RELOC_SH_IMM_MEDLOW16:             howto manager.      (line 1022)
14076* BFD_RELOC_SH_IMM_MEDLOW16_PCREL:       howto manager.      (line 1023)
14077* BFD_RELOC_SH_JMP_SLOT:                 howto manager.      (line  977)
14078* BFD_RELOC_SH_JMP_SLOT64:               howto manager.      (line 1002)
14079* BFD_RELOC_SH_LABEL:                    howto manager.      (line  972)
14080* BFD_RELOC_SH_LOOP_END:                 howto manager.      (line  974)
14081* BFD_RELOC_SH_LOOP_START:               howto manager.      (line  973)
14082* BFD_RELOC_SH_PCDISP12BY2:              howto manager.      (line  948)
14083* BFD_RELOC_SH_PCDISP8BY2:               howto manager.      (line  947)
14084* BFD_RELOC_SH_PCRELIMM8BY2:             howto manager.      (line  963)
14085* BFD_RELOC_SH_PCRELIMM8BY4:             howto manager.      (line  964)
14086* BFD_RELOC_SH_PLT_HI16:                 howto manager.      (line  991)
14087* BFD_RELOC_SH_PLT_LOW16:                howto manager.      (line  988)
14088* BFD_RELOC_SH_PLT_MEDHI16:              howto manager.      (line  990)
14089* BFD_RELOC_SH_PLT_MEDLOW16:             howto manager.      (line  989)
14090* BFD_RELOC_SH_PT_16:                    howto manager.      (line 1028)
14091* BFD_RELOC_SH_RELATIVE:                 howto manager.      (line  978)
14092* BFD_RELOC_SH_RELATIVE64:               howto manager.      (line 1003)
14093* BFD_RELOC_SH_SHMEDIA_CODE:             howto manager.      (line 1009)
14094* BFD_RELOC_SH_SWITCH16:                 howto manager.      (line  965)
14095* BFD_RELOC_SH_SWITCH32:                 howto manager.      (line  966)
14096* BFD_RELOC_SH_TLS_DTPMOD32:             howto manager.      (line 1034)
14097* BFD_RELOC_SH_TLS_DTPOFF32:             howto manager.      (line 1035)
14098* BFD_RELOC_SH_TLS_GD_32:                howto manager.      (line 1029)
14099* BFD_RELOC_SH_TLS_IE_32:                howto manager.      (line 1032)
14100* BFD_RELOC_SH_TLS_LDO_32:               howto manager.      (line 1031)
14101* BFD_RELOC_SH_TLS_LD_32:                howto manager.      (line 1030)
14102* BFD_RELOC_SH_TLS_LE_32:                howto manager.      (line 1033)
14103* BFD_RELOC_SH_TLS_TPOFF32:              howto manager.      (line 1036)
14104* BFD_RELOC_SH_USES:                     howto manager.      (line  967)
14105* BFD_RELOC_SIZE32:                      howto manager.      (line   67)
14106* BFD_RELOC_SIZE64:                      howto manager.      (line   68)
14107* BFD_RELOC_SPARC13:                     howto manager.      (line  121)
14108* BFD_RELOC_SPARC22:                     howto manager.      (line  120)
14109* BFD_RELOC_SPARC_10:                    howto manager.      (line  148)
14110* BFD_RELOC_SPARC_11:                    howto manager.      (line  149)
14111* BFD_RELOC_SPARC_5:                     howto manager.      (line  161)
14112* BFD_RELOC_SPARC_6:                     howto manager.      (line  160)
14113* BFD_RELOC_SPARC_64:                    howto manager.      (line  147)
14114* BFD_RELOC_SPARC_7:                     howto manager.      (line  159)
14115* BFD_RELOC_SPARC_BASE13:                howto manager.      (line  144)
14116* BFD_RELOC_SPARC_BASE22:                howto manager.      (line  145)
14117* BFD_RELOC_SPARC_COPY:                  howto manager.      (line  128)
14118* BFD_RELOC_SPARC_DISP64:                howto manager.      (line  162)
14119* BFD_RELOC_SPARC_GLOB_DAT:              howto manager.      (line  129)
14120* BFD_RELOC_SPARC_GOT10:                 howto manager.      (line  122)
14121* BFD_RELOC_SPARC_GOT13:                 howto manager.      (line  123)
14122* BFD_RELOC_SPARC_GOT22:                 howto manager.      (line  124)
14123* BFD_RELOC_SPARC_GOTDATA_HIX22:         howto manager.      (line  135)
14124* BFD_RELOC_SPARC_GOTDATA_LOX10:         howto manager.      (line  136)
14125* BFD_RELOC_SPARC_GOTDATA_OP:            howto manager.      (line  139)
14126* BFD_RELOC_SPARC_GOTDATA_OP_HIX22:      howto manager.      (line  137)
14127* BFD_RELOC_SPARC_GOTDATA_OP_LOX10:      howto manager.      (line  138)
14128* BFD_RELOC_SPARC_H34:                   howto manager.      (line  171)
14129* BFD_RELOC_SPARC_H44:                   howto manager.      (line  167)
14130* BFD_RELOC_SPARC_HH22:                  howto manager.      (line  151)
14131* BFD_RELOC_SPARC_HIX22:                 howto manager.      (line  165)
14132* BFD_RELOC_SPARC_HM10:                  howto manager.      (line  152)
14133* BFD_RELOC_SPARC_IRELATIVE:             howto manager.      (line  141)
14134* BFD_RELOC_SPARC_JMP_IREL:              howto manager.      (line  140)
14135* BFD_RELOC_SPARC_JMP_SLOT:              howto manager.      (line  130)
14136* BFD_RELOC_SPARC_L44:                   howto manager.      (line  169)
14137* BFD_RELOC_SPARC_LM22:                  howto manager.      (line  153)
14138* BFD_RELOC_SPARC_LOX10:                 howto manager.      (line  166)
14139* BFD_RELOC_SPARC_M44:                   howto manager.      (line  168)
14140* BFD_RELOC_SPARC_OLO10:                 howto manager.      (line  150)
14141* BFD_RELOC_SPARC_PC10:                  howto manager.      (line  125)
14142* BFD_RELOC_SPARC_PC22:                  howto manager.      (line  126)
14143* BFD_RELOC_SPARC_PC_HH22:               howto manager.      (line  154)
14144* BFD_RELOC_SPARC_PC_HM10:               howto manager.      (line  155)
14145* BFD_RELOC_SPARC_PC_LM22:               howto manager.      (line  156)
14146* BFD_RELOC_SPARC_PLT32:                 howto manager.      (line  163)
14147* BFD_RELOC_SPARC_PLT64:                 howto manager.      (line  164)
14148* BFD_RELOC_SPARC_REGISTER:              howto manager.      (line  170)
14149* BFD_RELOC_SPARC_RELATIVE:              howto manager.      (line  131)
14150* BFD_RELOC_SPARC_REV32:                 howto manager.      (line  176)
14151* BFD_RELOC_SPARC_SIZE32:                howto manager.      (line  172)
14152* BFD_RELOC_SPARC_SIZE64:                howto manager.      (line  173)
14153* BFD_RELOC_SPARC_TLS_DTPMOD32:          howto manager.      (line  196)
14154* BFD_RELOC_SPARC_TLS_DTPMOD64:          howto manager.      (line  197)
14155* BFD_RELOC_SPARC_TLS_DTPOFF32:          howto manager.      (line  198)
14156* BFD_RELOC_SPARC_TLS_DTPOFF64:          howto manager.      (line  199)
14157* BFD_RELOC_SPARC_TLS_GD_ADD:            howto manager.      (line  180)
14158* BFD_RELOC_SPARC_TLS_GD_CALL:           howto manager.      (line  181)
14159* BFD_RELOC_SPARC_TLS_GD_HI22:           howto manager.      (line  178)
14160* BFD_RELOC_SPARC_TLS_GD_LO10:           howto manager.      (line  179)
14161* BFD_RELOC_SPARC_TLS_IE_ADD:            howto manager.      (line  193)
14162* BFD_RELOC_SPARC_TLS_IE_HI22:           howto manager.      (line  189)
14163* BFD_RELOC_SPARC_TLS_IE_LD:             howto manager.      (line  191)
14164* BFD_RELOC_SPARC_TLS_IE_LDX:            howto manager.      (line  192)
14165* BFD_RELOC_SPARC_TLS_IE_LO10:           howto manager.      (line  190)
14166* BFD_RELOC_SPARC_TLS_LDM_ADD:           howto manager.      (line  184)
14167* BFD_RELOC_SPARC_TLS_LDM_CALL:          howto manager.      (line  185)
14168* BFD_RELOC_SPARC_TLS_LDM_HI22:          howto manager.      (line  182)
14169* BFD_RELOC_SPARC_TLS_LDM_LO10:          howto manager.      (line  183)
14170* BFD_RELOC_SPARC_TLS_LDO_ADD:           howto manager.      (line  188)
14171* BFD_RELOC_SPARC_TLS_LDO_HIX22:         howto manager.      (line  186)
14172* BFD_RELOC_SPARC_TLS_LDO_LOX10:         howto manager.      (line  187)
14173* BFD_RELOC_SPARC_TLS_LE_HIX22:          howto manager.      (line  194)
14174* BFD_RELOC_SPARC_TLS_LE_LOX10:          howto manager.      (line  195)
14175* BFD_RELOC_SPARC_TLS_TPOFF32:           howto manager.      (line  200)
14176* BFD_RELOC_SPARC_TLS_TPOFF64:           howto manager.      (line  201)
14177* BFD_RELOC_SPARC_UA16:                  howto manager.      (line  132)
14178* BFD_RELOC_SPARC_UA32:                  howto manager.      (line  133)
14179* BFD_RELOC_SPARC_UA64:                  howto manager.      (line  134)
14180* BFD_RELOC_SPARC_WDISP10:               howto manager.      (line  174)
14181* BFD_RELOC_SPARC_WDISP16:               howto manager.      (line  157)
14182* BFD_RELOC_SPARC_WDISP19:               howto manager.      (line  158)
14183* BFD_RELOC_SPARC_WDISP22:               howto manager.      (line  119)
14184* BFD_RELOC_SPARC_WPLT30:                howto manager.      (line  127)
14185* BFD_RELOC_SPU_ADD_PIC:                 howto manager.      (line  217)
14186* BFD_RELOC_SPU_HI16:                    howto manager.      (line  214)
14187* BFD_RELOC_SPU_IMM10:                   howto manager.      (line  205)
14188* BFD_RELOC_SPU_IMM10W:                  howto manager.      (line  206)
14189* BFD_RELOC_SPU_IMM16:                   howto manager.      (line  207)
14190* BFD_RELOC_SPU_IMM16W:                  howto manager.      (line  208)
14191* BFD_RELOC_SPU_IMM18:                   howto manager.      (line  209)
14192* BFD_RELOC_SPU_IMM7:                    howto manager.      (line  203)
14193* BFD_RELOC_SPU_IMM8:                    howto manager.      (line  204)
14194* BFD_RELOC_SPU_LO16:                    howto manager.      (line  213)
14195* BFD_RELOC_SPU_PCREL16:                 howto manager.      (line  212)
14196* BFD_RELOC_SPU_PCREL9a:                 howto manager.      (line  210)
14197* BFD_RELOC_SPU_PCREL9b:                 howto manager.      (line  211)
14198* BFD_RELOC_SPU_PPU32:                   howto manager.      (line  215)
14199* BFD_RELOC_SPU_PPU64:                   howto manager.      (line  216)
14200* BFD_RELOC_THUMB_PCREL_BFCSEL:          howto manager.      (line  799)
14201* BFD_RELOC_THUMB_PCREL_BLX:             howto manager.      (line  788)
14202* BFD_RELOC_THUMB_PCREL_BRANCH12:        howto manager.      (line  811)
14203* BFD_RELOC_THUMB_PCREL_BRANCH20:        howto manager.      (line  812)
14204* BFD_RELOC_THUMB_PCREL_BRANCH23:        howto manager.      (line  813)
14205* BFD_RELOC_THUMB_PCREL_BRANCH25:        howto manager.      (line  814)
14206* BFD_RELOC_THUMB_PCREL_BRANCH5:         howto manager.      (line  797)
14207* BFD_RELOC_THUMB_PCREL_BRANCH7:         howto manager.      (line  809)
14208* BFD_RELOC_THUMB_PCREL_BRANCH9:         howto manager.      (line  810)
14209* BFD_RELOC_TIC30_LDP:                   howto manager.      (line 1554)
14210* BFD_RELOC_TIC54X_16_OF_23:             howto manager.      (line 1568)
14211* BFD_RELOC_TIC54X_23:                   howto manager.      (line 1566)
14212* BFD_RELOC_TIC54X_MS7_OF_23:            howto manager.      (line 1572)
14213* BFD_RELOC_TIC54X_PARTLS7:              howto manager.      (line 1558)
14214* BFD_RELOC_TIC54X_PARTMS9:              howto manager.      (line 1562)
14215* BFD_RELOC_TILEGX_BROFF_X1:             howto manager.      (line 3316)
14216* BFD_RELOC_TILEGX_COPY:                 howto manager.      (line 3312)
14217* BFD_RELOC_TILEGX_DEST_IMM8_X1:         howto manager.      (line 3323)
14218* BFD_RELOC_TILEGX_GLOB_DAT:             howto manager.      (line 3313)
14219* BFD_RELOC_TILEGX_HW0:                  howto manager.      (line 3305)
14220* BFD_RELOC_TILEGX_HW0_LAST:             howto manager.      (line 3309)
14221* BFD_RELOC_TILEGX_HW1:                  howto manager.      (line 3306)
14222* BFD_RELOC_TILEGX_HW1_LAST:             howto manager.      (line 3310)
14223* BFD_RELOC_TILEGX_HW2:                  howto manager.      (line 3307)
14224* BFD_RELOC_TILEGX_HW2_LAST:             howto manager.      (line 3311)
14225* BFD_RELOC_TILEGX_HW3:                  howto manager.      (line 3308)
14226* BFD_RELOC_TILEGX_IMM16_X0_HW0:         howto manager.      (line 3332)
14227* BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT:     howto manager.      (line 3360)
14228* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST:    howto manager.      (line 3340)
14229* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT: howto manager.     (line 3368)
14230* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL: howto manager.   (line 3354)
14231* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL: howto manager.
14232                                                             (line 3388)
14233* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD: howto manager.  (line 3382)
14234* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE: howto manager.  (line 3394)
14235* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE: howto manager.  (line 3378)
14236* BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL:   howto manager.      (line 3346)
14237* BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL: howto manager.    (line 3362)
14238* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD:  howto manager.      (line 3374)
14239* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE:  howto manager.      (line 3386)
14240* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE:  howto manager.      (line 3376)
14241* BFD_RELOC_TILEGX_IMM16_X0_HW1:         howto manager.      (line 3334)
14242* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST:    howto manager.      (line 3342)
14243* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT: howto manager.     (line 3370)
14244* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL: howto manager.   (line 3356)
14245* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL: howto manager.
14246                                                             (line 3390)
14247* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD: howto manager.  (line 3384)
14248* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE: howto manager.  (line 3396)
14249* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE: howto manager.  (line 3380)
14250* BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL:   howto manager.      (line 3348)
14251* BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL: howto manager.    (line 3364)
14252* BFD_RELOC_TILEGX_IMM16_X0_HW2:         howto manager.      (line 3336)
14253* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST:    howto manager.      (line 3344)
14254* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL: howto manager.   (line 3358)
14255* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL: howto manager.
14256                                                             (line 3392)
14257* BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL:   howto manager.      (line 3350)
14258* BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL: howto manager.    (line 3366)
14259* BFD_RELOC_TILEGX_IMM16_X0_HW3:         howto manager.      (line 3338)
14260* BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL:   howto manager.      (line 3352)
14261* BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL: howto manager.    (line 3372)
14262* BFD_RELOC_TILEGX_IMM16_X1_HW0:         howto manager.      (line 3333)
14263* BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT:     howto manager.      (line 3361)
14264* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST:    howto manager.      (line 3341)
14265* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT: howto manager.     (line 3369)
14266* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL: howto manager.   (line 3355)
14267* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL: howto manager.
14268                                                             (line 3389)
14269* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD: howto manager.  (line 3383)
14270* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE: howto manager.  (line 3395)
14271* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE: howto manager.  (line 3379)
14272* BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL:   howto manager.      (line 3347)
14273* BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL: howto manager.    (line 3363)
14274* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD:  howto manager.      (line 3375)
14275* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE:  howto manager.      (line 3387)
14276* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE:  howto manager.      (line 3377)
14277* BFD_RELOC_TILEGX_IMM16_X1_HW1:         howto manager.      (line 3335)
14278* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST:    howto manager.      (line 3343)
14279* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT: howto manager.     (line 3371)
14280* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL: howto manager.   (line 3357)
14281* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL: howto manager.
14282                                                             (line 3391)
14283* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD: howto manager.  (line 3385)
14284* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE: howto manager.  (line 3397)
14285* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE: howto manager.  (line 3381)
14286* BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL:   howto manager.      (line 3349)
14287* BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL: howto manager.    (line 3365)
14288* BFD_RELOC_TILEGX_IMM16_X1_HW2:         howto manager.      (line 3337)
14289* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST:    howto manager.      (line 3345)
14290* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL: howto manager.   (line 3359)
14291* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL: howto manager.
14292                                                             (line 3393)
14293* BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL:   howto manager.      (line 3351)
14294* BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL: howto manager.    (line 3367)
14295* BFD_RELOC_TILEGX_IMM16_X1_HW3:         howto manager.      (line 3339)
14296* BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL:   howto manager.      (line 3353)
14297* BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL: howto manager.    (line 3373)
14298* BFD_RELOC_TILEGX_IMM8_X0:              howto manager.      (line 3319)
14299* BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD:      howto manager.      (line 3410)
14300* BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD:   howto manager.      (line 3405)
14301* BFD_RELOC_TILEGX_IMM8_X1:              howto manager.      (line 3321)
14302* BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD:      howto manager.      (line 3411)
14303* BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD:   howto manager.      (line 3406)
14304* BFD_RELOC_TILEGX_IMM8_Y0:              howto manager.      (line 3320)
14305* BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD:      howto manager.      (line 3412)
14306* BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD:   howto manager.      (line 3407)
14307* BFD_RELOC_TILEGX_IMM8_Y1:              howto manager.      (line 3322)
14308* BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD:      howto manager.      (line 3413)
14309* BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD:   howto manager.      (line 3408)
14310* BFD_RELOC_TILEGX_JMP_SLOT:             howto manager.      (line 3314)
14311* BFD_RELOC_TILEGX_JUMPOFF_X1:           howto manager.      (line 3317)
14312* BFD_RELOC_TILEGX_JUMPOFF_X1_PLT:       howto manager.      (line 3318)
14313* BFD_RELOC_TILEGX_MF_IMM14_X1:          howto manager.      (line 3325)
14314* BFD_RELOC_TILEGX_MMEND_X0:             howto manager.      (line 3327)
14315* BFD_RELOC_TILEGX_MMSTART_X0:           howto manager.      (line 3326)
14316* BFD_RELOC_TILEGX_MT_IMM14_X1:          howto manager.      (line 3324)
14317* BFD_RELOC_TILEGX_RELATIVE:             howto manager.      (line 3315)
14318* BFD_RELOC_TILEGX_SHAMT_X0:             howto manager.      (line 3328)
14319* BFD_RELOC_TILEGX_SHAMT_X1:             howto manager.      (line 3329)
14320* BFD_RELOC_TILEGX_SHAMT_Y0:             howto manager.      (line 3330)
14321* BFD_RELOC_TILEGX_SHAMT_Y1:             howto manager.      (line 3331)
14322* BFD_RELOC_TILEGX_TLS_DTPMOD32:         howto manager.      (line 3401)
14323* BFD_RELOC_TILEGX_TLS_DTPMOD64:         howto manager.      (line 3398)
14324* BFD_RELOC_TILEGX_TLS_DTPOFF32:         howto manager.      (line 3402)
14325* BFD_RELOC_TILEGX_TLS_DTPOFF64:         howto manager.      (line 3399)
14326* BFD_RELOC_TILEGX_TLS_GD_CALL:          howto manager.      (line 3404)
14327* BFD_RELOC_TILEGX_TLS_IE_LOAD:          howto manager.      (line 3409)
14328* BFD_RELOC_TILEGX_TLS_TPOFF32:          howto manager.      (line 3403)
14329* BFD_RELOC_TILEGX_TLS_TPOFF64:          howto manager.      (line 3400)
14330* BFD_RELOC_TILEPRO_BROFF_X1:            howto manager.      (line 3229)
14331* BFD_RELOC_TILEPRO_COPY:                howto manager.      (line 3225)
14332* BFD_RELOC_TILEPRO_DEST_IMM8_X1:        howto manager.      (line 3236)
14333* BFD_RELOC_TILEPRO_GLOB_DAT:            howto manager.      (line 3226)
14334* BFD_RELOC_TILEPRO_IMM16_X0:            howto manager.      (line 3239)
14335* BFD_RELOC_TILEPRO_IMM16_X0_GOT:        howto manager.      (line 3255)
14336* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA:     howto manager.      (line 3261)
14337* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI:     howto manager.      (line 3259)
14338* BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO:     howto manager.      (line 3257)
14339* BFD_RELOC_TILEPRO_IMM16_X0_HA:         howto manager.      (line 3245)
14340* BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL:   howto manager.      (line 3253)
14341* BFD_RELOC_TILEPRO_IMM16_X0_HI:         howto manager.      (line 3243)
14342* BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL:   howto manager.      (line 3251)
14343* BFD_RELOC_TILEPRO_IMM16_X0_LO:         howto manager.      (line 3241)
14344* BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL:   howto manager.      (line 3249)
14345* BFD_RELOC_TILEPRO_IMM16_X0_PCREL:      howto manager.      (line 3247)
14346* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD:     howto manager.      (line 3277)
14347* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA:  howto manager.      (line 3283)
14348* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI:  howto manager.      (line 3281)
14349* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO:  howto manager.      (line 3279)
14350* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE:     howto manager.      (line 3285)
14351* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA:  howto manager.      (line 3291)
14352* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI:  howto manager.      (line 3289)
14353* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO:  howto manager.      (line 3287)
14354* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE:     howto manager.      (line 3296)
14355* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA:  howto manager.      (line 3302)
14356* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI:  howto manager.      (line 3300)
14357* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO:  howto manager.      (line 3298)
14358* BFD_RELOC_TILEPRO_IMM16_X1:            howto manager.      (line 3240)
14359* BFD_RELOC_TILEPRO_IMM16_X1_GOT:        howto manager.      (line 3256)
14360* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA:     howto manager.      (line 3262)
14361* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI:     howto manager.      (line 3260)
14362* BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO:     howto manager.      (line 3258)
14363* BFD_RELOC_TILEPRO_IMM16_X1_HA:         howto manager.      (line 3246)
14364* BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL:   howto manager.      (line 3254)
14365* BFD_RELOC_TILEPRO_IMM16_X1_HI:         howto manager.      (line 3244)
14366* BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL:   howto manager.      (line 3252)
14367* BFD_RELOC_TILEPRO_IMM16_X1_LO:         howto manager.      (line 3242)
14368* BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL:   howto manager.      (line 3250)
14369* BFD_RELOC_TILEPRO_IMM16_X1_PCREL:      howto manager.      (line 3248)
14370* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD:     howto manager.      (line 3278)
14371* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA:  howto manager.      (line 3284)
14372* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI:  howto manager.      (line 3282)
14373* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO:  howto manager.      (line 3280)
14374* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE:     howto manager.      (line 3286)
14375* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA:  howto manager.      (line 3292)
14376* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI:  howto manager.      (line 3290)
14377* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO:  howto manager.      (line 3288)
14378* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE:     howto manager.      (line 3297)
14379* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA:  howto manager.      (line 3303)
14380* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI:  howto manager.      (line 3301)
14381* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO:  howto manager.      (line 3299)
14382* BFD_RELOC_TILEPRO_IMM8_X0:             howto manager.      (line 3232)
14383* BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD:  howto manager.      (line 3272)
14384* BFD_RELOC_TILEPRO_IMM8_X1:             howto manager.      (line 3234)
14385* BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD:  howto manager.      (line 3273)
14386* BFD_RELOC_TILEPRO_IMM8_Y0:             howto manager.      (line 3233)
14387* BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD:  howto manager.      (line 3274)
14388* BFD_RELOC_TILEPRO_IMM8_Y1:             howto manager.      (line 3235)
14389* BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD:  howto manager.      (line 3275)
14390* BFD_RELOC_TILEPRO_JMP_SLOT:            howto manager.      (line 3227)
14391* BFD_RELOC_TILEPRO_JOFFLONG_X1:         howto manager.      (line 3230)
14392* BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT:     howto manager.      (line 3231)
14393* BFD_RELOC_TILEPRO_MF_IMM15_X1:         howto manager.      (line 3238)
14394* BFD_RELOC_TILEPRO_MMEND_X0:            howto manager.      (line 3264)
14395* BFD_RELOC_TILEPRO_MMEND_X1:            howto manager.      (line 3266)
14396* BFD_RELOC_TILEPRO_MMSTART_X0:          howto manager.      (line 3263)
14397* BFD_RELOC_TILEPRO_MMSTART_X1:          howto manager.      (line 3265)
14398* BFD_RELOC_TILEPRO_MT_IMM15_X1:         howto manager.      (line 3237)
14399* BFD_RELOC_TILEPRO_RELATIVE:            howto manager.      (line 3228)
14400* BFD_RELOC_TILEPRO_SHAMT_X0:            howto manager.      (line 3267)
14401* BFD_RELOC_TILEPRO_SHAMT_X1:            howto manager.      (line 3268)
14402* BFD_RELOC_TILEPRO_SHAMT_Y0:            howto manager.      (line 3269)
14403* BFD_RELOC_TILEPRO_SHAMT_Y1:            howto manager.      (line 3270)
14404* BFD_RELOC_TILEPRO_TLS_DTPMOD32:        howto manager.      (line 3293)
14405* BFD_RELOC_TILEPRO_TLS_DTPOFF32:        howto manager.      (line 3294)
14406* BFD_RELOC_TILEPRO_TLS_GD_CALL:         howto manager.      (line 3271)
14407* BFD_RELOC_TILEPRO_TLS_IE_LOAD:         howto manager.      (line 3276)
14408* BFD_RELOC_TILEPRO_TLS_TPOFF32:         howto manager.      (line 3295)
14409* bfd_reloc_type_lookup:                 howto manager.      (line 3633)
14410* BFD_RELOC_V850_16_GOT:                 howto manager.      (line 1539)
14411* BFD_RELOC_V850_16_GOTOFF:              howto manager.      (line 1547)
14412* BFD_RELOC_V850_16_PCREL:               howto manager.      (line 1520)
14413* BFD_RELOC_V850_16_S1:                  howto manager.      (line 1532)
14414* BFD_RELOC_V850_16_SPLIT_OFFSET:        howto manager.      (line 1530)
14415* BFD_RELOC_V850_17_PCREL:               howto manager.      (line 1522)
14416* BFD_RELOC_V850_22_PCREL:               howto manager.      (line 1474)
14417* BFD_RELOC_V850_22_PLT_PCREL:           howto manager.      (line 1541)
14418* BFD_RELOC_V850_23:                     howto manager.      (line 1524)
14419* BFD_RELOC_V850_32_ABS:                 howto manager.      (line 1528)
14420* BFD_RELOC_V850_32_GOT:                 howto manager.      (line 1540)
14421* BFD_RELOC_V850_32_GOTOFF:              howto manager.      (line 1548)
14422* BFD_RELOC_V850_32_GOTPCREL:            howto manager.      (line 1538)
14423* BFD_RELOC_V850_32_PCREL:               howto manager.      (line 1526)
14424* BFD_RELOC_V850_32_PLT_PCREL:           howto manager.      (line 1542)
14425* BFD_RELOC_V850_9_PCREL:                howto manager.      (line 1472)
14426* BFD_RELOC_V850_ALIGN:                  howto manager.      (line 1515)
14427* BFD_RELOC_V850_CALLT_15_16_OFFSET:     howto manager.      (line 1536)
14428* BFD_RELOC_V850_CALLT_16_16_OFFSET:     howto manager.      (line 1509)
14429* BFD_RELOC_V850_CALLT_6_7_OFFSET:       howto manager.      (line 1507)
14430* BFD_RELOC_V850_CODE:                   howto manager.      (line 1550)
14431* BFD_RELOC_V850_COPY:                   howto manager.      (line 1543)
14432* BFD_RELOC_V850_DATA:                   howto manager.      (line 1552)
14433* BFD_RELOC_V850_GLOB_DAT:               howto manager.      (line 1544)
14434* BFD_RELOC_V850_JMP_SLOT:               howto manager.      (line 1545)
14435* BFD_RELOC_V850_LO16_S1:                howto manager.      (line 1534)
14436* BFD_RELOC_V850_LO16_SPLIT_OFFSET:      howto manager.      (line 1517)
14437* BFD_RELOC_V850_LONGCALL:               howto manager.      (line 1511)
14438* BFD_RELOC_V850_LONGJUMP:               howto manager.      (line 1513)
14439* BFD_RELOC_V850_RELATIVE:               howto manager.      (line 1546)
14440* BFD_RELOC_V850_SDA_15_16_OFFSET:       howto manager.      (line 1478)
14441* BFD_RELOC_V850_SDA_16_16_OFFSET:       howto manager.      (line 1476)
14442* BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET: howto manager.      (line 1501)
14443* BFD_RELOC_V850_TDA_16_16_OFFSET:       howto manager.      (line 1494)
14444* BFD_RELOC_V850_TDA_4_4_OFFSET:         howto manager.      (line 1499)
14445* BFD_RELOC_V850_TDA_4_5_OFFSET:         howto manager.      (line 1496)
14446* BFD_RELOC_V850_TDA_6_8_OFFSET:         howto manager.      (line 1486)
14447* BFD_RELOC_V850_TDA_7_7_OFFSET:         howto manager.      (line 1492)
14448* BFD_RELOC_V850_TDA_7_8_OFFSET:         howto manager.      (line 1489)
14449* BFD_RELOC_V850_ZDA_15_16_OFFSET:       howto manager.      (line 1483)
14450* BFD_RELOC_V850_ZDA_16_16_OFFSET:       howto manager.      (line 1481)
14451* BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET: howto manager.      (line 1504)
14452* BFD_RELOC_VAX_GLOB_DAT:                howto manager.      (line 2421)
14453* BFD_RELOC_VAX_JMP_SLOT:                howto manager.      (line 2422)
14454* BFD_RELOC_VAX_RELATIVE:                howto manager.      (line 2423)
14455* BFD_RELOC_VISIUM_HI16:                 howto manager.      (line 3435)
14456* BFD_RELOC_VISIUM_HI16_PCREL:           howto manager.      (line 3439)
14457* BFD_RELOC_VISIUM_IM16:                 howto manager.      (line 3437)
14458* BFD_RELOC_VISIUM_IM16_PCREL:           howto manager.      (line 3441)
14459* BFD_RELOC_VISIUM_LO16:                 howto manager.      (line 3436)
14460* BFD_RELOC_VISIUM_LO16_PCREL:           howto manager.      (line 3440)
14461* BFD_RELOC_VISIUM_REL16:                howto manager.      (line 3438)
14462* BFD_RELOC_VPE4KMATH_DATA:              howto manager.      (line 2083)
14463* BFD_RELOC_VPE4KMATH_INSN:              howto manager.      (line 2084)
14464* BFD_RELOC_VTABLE_ENTRY:                howto manager.      (line 2087)
14465* BFD_RELOC_VTABLE_INHERIT:              howto manager.      (line 2086)
14466* BFD_RELOC_WASM32_ABS32_CODE:           howto manager.      (line 3448)
14467* BFD_RELOC_WASM32_CODE_POINTER:         howto manager.      (line 3450)
14468* BFD_RELOC_WASM32_COPY:                 howto manager.      (line 3449)
14469* BFD_RELOC_WASM32_INDEX:                howto manager.      (line 3451)
14470* BFD_RELOC_WASM32_LEB128:               howto manager.      (line 3443)
14471* BFD_RELOC_WASM32_LEB128_GOT:           howto manager.      (line 3444)
14472* BFD_RELOC_WASM32_LEB128_GOT_CODE:      howto manager.      (line 3445)
14473* BFD_RELOC_WASM32_LEB128_PLT:           howto manager.      (line 3446)
14474* BFD_RELOC_WASM32_PLT_INDEX:            howto manager.      (line 3447)
14475* BFD_RELOC_WASM32_PLT_SIG:              howto manager.      (line 3452)
14476* BFD_RELOC_X86_64_32S:                  howto manager.      (line  554)
14477* BFD_RELOC_X86_64_CODE_4_GOTPC32_TLSDESC: howto manager.    (line  580)
14478* BFD_RELOC_X86_64_CODE_4_GOTPCRELX:     howto manager.      (line  578)
14479* BFD_RELOC_X86_64_CODE_4_GOTTPOFF:      howto manager.      (line  579)
14480* BFD_RELOC_X86_64_COPY:                 howto manager.      (line  549)
14481* BFD_RELOC_X86_64_DTPMOD64:             howto manager.      (line  555)
14482* BFD_RELOC_X86_64_DTPOFF32:             howto manager.      (line  560)
14483* BFD_RELOC_X86_64_DTPOFF64:             howto manager.      (line  556)
14484* BFD_RELOC_X86_64_GLOB_DAT:             howto manager.      (line  550)
14485* BFD_RELOC_X86_64_GOT32:                howto manager.      (line  547)
14486* BFD_RELOC_X86_64_GOT64:                howto manager.      (line  565)
14487* BFD_RELOC_X86_64_GOTOFF64:             howto manager.      (line  563)
14488* BFD_RELOC_X86_64_GOTPC32:              howto manager.      (line  564)
14489* BFD_RELOC_X86_64_GOTPC32_TLSDESC:      howto manager.      (line  570)
14490* BFD_RELOC_X86_64_GOTPC64:              howto manager.      (line  567)
14491* BFD_RELOC_X86_64_GOTPCREL:             howto manager.      (line  553)
14492* BFD_RELOC_X86_64_GOTPCREL64:           howto manager.      (line  566)
14493* BFD_RELOC_X86_64_GOTPCRELX:            howto manager.      (line  576)
14494* BFD_RELOC_X86_64_GOTPLT64:             howto manager.      (line  568)
14495* BFD_RELOC_X86_64_GOTTPOFF:             howto manager.      (line  561)
14496* BFD_RELOC_X86_64_IRELATIVE:            howto manager.      (line  573)
14497* BFD_RELOC_X86_64_JUMP_SLOT:            howto manager.      (line  551)
14498* BFD_RELOC_X86_64_PC32_BND:             howto manager.      (line  574)
14499* BFD_RELOC_X86_64_PLT32:                howto manager.      (line  548)
14500* BFD_RELOC_X86_64_PLT32_BND:            howto manager.      (line  575)
14501* BFD_RELOC_X86_64_PLTOFF64:             howto manager.      (line  569)
14502* BFD_RELOC_X86_64_RELATIVE:             howto manager.      (line  552)
14503* BFD_RELOC_X86_64_REX_GOTPCRELX:        howto manager.      (line  577)
14504* BFD_RELOC_X86_64_TLSDESC:              howto manager.      (line  572)
14505* BFD_RELOC_X86_64_TLSDESC_CALL:         howto manager.      (line  571)
14506* BFD_RELOC_X86_64_TLSGD:                howto manager.      (line  558)
14507* BFD_RELOC_X86_64_TLSLD:                howto manager.      (line  559)
14508* BFD_RELOC_X86_64_TPOFF32:              howto manager.      (line  562)
14509* BFD_RELOC_X86_64_TPOFF64:              howto manager.      (line  557)
14510* BFD_RELOC_XGATE_24:                    howto manager.      (line 2230)
14511* BFD_RELOC_XGATE_GPAGE:                 howto manager.      (line 2228)
14512* BFD_RELOC_XGATE_IMM3:                  howto manager.      (line 2242)
14513* BFD_RELOC_XGATE_IMM4:                  howto manager.      (line 2244)
14514* BFD_RELOC_XGATE_IMM5:                  howto manager.      (line 2246)
14515* BFD_RELOC_XGATE_IMM8_HI:               howto manager.      (line 2239)
14516* BFD_RELOC_XGATE_IMM8_LO:               howto manager.      (line 2236)
14517* BFD_RELOC_XGATE_LO16:                  howto manager.      (line 2225)
14518* BFD_RELOC_XGATE_PCREL_10:              howto manager.      (line 2234)
14519* BFD_RELOC_XGATE_PCREL_9:               howto manager.      (line 2232)
14520* BFD_RELOC_XGATE_RL_GROUP:              howto manager.      (line 2221)
14521* BFD_RELOC_XGATE_RL_JUMP:               howto manager.      (line 2218)
14522* BFD_RELOC_XSTORMY16_12:                howto manager.      (line 2415)
14523* BFD_RELOC_XSTORMY16_24:                howto manager.      (line 2416)
14524* BFD_RELOC_XSTORMY16_FPTR16:            howto manager.      (line 2417)
14525* BFD_RELOC_XSTORMY16_REL_12:            howto manager.      (line 2414)
14526* BFD_RELOC_XTENSA_ASM_EXPAND:           howto manager.      (line 2611)
14527* BFD_RELOC_XTENSA_ASM_SIMPLIFY:         howto manager.      (line 2615)
14528* BFD_RELOC_XTENSA_DIFF16:               howto manager.      (line 2560)
14529* BFD_RELOC_XTENSA_DIFF32:               howto manager.      (line 2561)
14530* BFD_RELOC_XTENSA_DIFF8:                howto manager.      (line 2559)
14531* BFD_RELOC_XTENSA_GLOB_DAT:             howto manager.      (line 2551)
14532* BFD_RELOC_XTENSA_JMP_SLOT:             howto manager.      (line 2552)
14533* BFD_RELOC_XTENSA_NDIFF16:              howto manager.      (line 2631)
14534* BFD_RELOC_XTENSA_NDIFF32:              howto manager.      (line 2632)
14535* BFD_RELOC_XTENSA_NDIFF8:               howto manager.      (line 2630)
14536* BFD_RELOC_XTENSA_OP0:                  howto manager.      (line 2606)
14537* BFD_RELOC_XTENSA_OP1:                  howto manager.      (line 2607)
14538* BFD_RELOC_XTENSA_OP2:                  howto manager.      (line 2608)
14539* BFD_RELOC_XTENSA_PDIFF16:              howto manager.      (line 2628)
14540* BFD_RELOC_XTENSA_PDIFF32:              howto manager.      (line 2629)
14541* BFD_RELOC_XTENSA_PDIFF8:               howto manager.      (line 2627)
14542* BFD_RELOC_XTENSA_PLT:                  howto manager.      (line 2555)
14543* BFD_RELOC_XTENSA_RELATIVE:             howto manager.      (line 2553)
14544* BFD_RELOC_XTENSA_RTLD:                 howto manager.      (line 2547)
14545* BFD_RELOC_XTENSA_SLOT0_ALT:            howto manager.      (line 2589)
14546* BFD_RELOC_XTENSA_SLOT0_OP:             howto manager.      (line 2570)
14547* BFD_RELOC_XTENSA_SLOT10_ALT:           howto manager.      (line 2599)
14548* BFD_RELOC_XTENSA_SLOT10_OP:            howto manager.      (line 2580)
14549* BFD_RELOC_XTENSA_SLOT11_ALT:           howto manager.      (line 2600)
14550* BFD_RELOC_XTENSA_SLOT11_OP:            howto manager.      (line 2581)
14551* BFD_RELOC_XTENSA_SLOT12_ALT:           howto manager.      (line 2601)
14552* BFD_RELOC_XTENSA_SLOT12_OP:            howto manager.      (line 2582)
14553* BFD_RELOC_XTENSA_SLOT13_ALT:           howto manager.      (line 2602)
14554* BFD_RELOC_XTENSA_SLOT13_OP:            howto manager.      (line 2583)
14555* BFD_RELOC_XTENSA_SLOT14_ALT:           howto manager.      (line 2603)
14556* BFD_RELOC_XTENSA_SLOT14_OP:            howto manager.      (line 2584)
14557* BFD_RELOC_XTENSA_SLOT1_ALT:            howto manager.      (line 2590)
14558* BFD_RELOC_XTENSA_SLOT1_OP:             howto manager.      (line 2571)
14559* BFD_RELOC_XTENSA_SLOT2_ALT:            howto manager.      (line 2591)
14560* BFD_RELOC_XTENSA_SLOT2_OP:             howto manager.      (line 2572)
14561* BFD_RELOC_XTENSA_SLOT3_ALT:            howto manager.      (line 2592)
14562* BFD_RELOC_XTENSA_SLOT3_OP:             howto manager.      (line 2573)
14563* BFD_RELOC_XTENSA_SLOT4_ALT:            howto manager.      (line 2593)
14564* BFD_RELOC_XTENSA_SLOT4_OP:             howto manager.      (line 2574)
14565* BFD_RELOC_XTENSA_SLOT5_ALT:            howto manager.      (line 2594)
14566* BFD_RELOC_XTENSA_SLOT5_OP:             howto manager.      (line 2575)
14567* BFD_RELOC_XTENSA_SLOT6_ALT:            howto manager.      (line 2595)
14568* BFD_RELOC_XTENSA_SLOT6_OP:             howto manager.      (line 2576)
14569* BFD_RELOC_XTENSA_SLOT7_ALT:            howto manager.      (line 2596)
14570* BFD_RELOC_XTENSA_SLOT7_OP:             howto manager.      (line 2577)
14571* BFD_RELOC_XTENSA_SLOT8_ALT:            howto manager.      (line 2597)
14572* BFD_RELOC_XTENSA_SLOT8_OP:             howto manager.      (line 2578)
14573* BFD_RELOC_XTENSA_SLOT9_ALT:            howto manager.      (line 2598)
14574* BFD_RELOC_XTENSA_SLOT9_OP:             howto manager.      (line 2579)
14575* BFD_RELOC_XTENSA_TLSDESC_ARG:          howto manager.      (line 2620)
14576* BFD_RELOC_XTENSA_TLSDESC_FN:           howto manager.      (line 2619)
14577* BFD_RELOC_XTENSA_TLS_ARG:              howto manager.      (line 2624)
14578* BFD_RELOC_XTENSA_TLS_CALL:             howto manager.      (line 2625)
14579* BFD_RELOC_XTENSA_TLS_DTPOFF:           howto manager.      (line 2621)
14580* BFD_RELOC_XTENSA_TLS_FUNC:             howto manager.      (line 2623)
14581* BFD_RELOC_XTENSA_TLS_TPOFF:            howto manager.      (line 2622)
14582* BFD_RELOC_Z80_16_BE:                   howto manager.      (line 2656)
14583* BFD_RELOC_Z80_BYTE0:                   howto manager.      (line 2644)
14584* BFD_RELOC_Z80_BYTE1:                   howto manager.      (line 2646)
14585* BFD_RELOC_Z80_BYTE2:                   howto manager.      (line 2648)
14586* BFD_RELOC_Z80_BYTE3:                   howto manager.      (line 2650)
14587* BFD_RELOC_Z80_DISP8:                   howto manager.      (line 2642)
14588* BFD_RELOC_Z80_WORD0:                   howto manager.      (line 2652)
14589* BFD_RELOC_Z80_WORD1:                   howto manager.      (line 2654)
14590* BFD_RELOC_Z8K_CALLR:                   howto manager.      (line 2660)
14591* BFD_RELOC_Z8K_DISP7:                   howto manager.      (line 2658)
14592* BFD_RELOC_Z8K_IMM4L:                   howto manager.      (line 2662)
14593* bfd_rename_section:                    section prototypes. (line  149)
14594* bfd_rename_section <1>:                section prototypes. (line  153)
14595* bfd_scan_arch:                         Architectures.      (line  601)
14596* bfd_scan_vma:                          Miscellaneous.      (line  115)
14597* bfd_scan_vma <1>:                      Miscellaneous.      (line  119)
14598* bfd_section:                           Opening and Closing.
14599                                                             (line  335)
14600* bfd_sections_find_if:                  section prototypes. (line  174)
14601* bfd_section_already_linked:            Writing the symbol table.
14602                                                             (line   53)
14603* bfd_section_already_linked <1>:        Writing the symbol table.
14604                                                             (line   57)
14605* bfd_section_list_clear:                section prototypes. (line    7)
14606* bfd_section_list_clear <1>:            section prototypes. (line   11)
14607* bfd_seek:                              Miscellaneous.      (line  402)
14608* bfd_seek <1>:                          Miscellaneous.      (line  406)
14609* bfd_set_archive_head:                  Archives.           (line   72)
14610* bfd_set_archive_head <1>:              Archives.           (line   76)
14611* bfd_set_arch_info:                     Architectures.      (line  638)
14612* bfd_set_arch_info <1>:                 Architectures.      (line  642)
14613* bfd_set_assert_handler:                Error reporting.    (line  180)
14614* bfd_set_assert_handler <1>:            Error reporting.    (line  185)
14615* bfd_set_default_target:                bfd_target.         (line  554)
14616* bfd_set_default_target <1>:            bfd_target.         (line  558)
14617* bfd_set_error:                         Error reporting.    (line   57)
14618* bfd_set_error <1>:                     Error reporting.    (line   61)
14619* bfd_set_error_handler:                 Error reporting.    (line  136)
14620* bfd_set_error_handler <1>:             Error reporting.    (line  140)
14621* bfd_set_error_program_name:            Error reporting.    (line  151)
14622* bfd_set_error_program_name <1>:        Error reporting.    (line  155)
14623* bfd_set_filename:                      Opening and Closing.
14624                                                             (line  378)
14625* bfd_set_file_flags:                    Miscellaneous.      (line   41)
14626* bfd_set_file_flags <1>:                Miscellaneous.      (line   45)
14627* bfd_set_format:                        Formats.            (line   65)
14628* bfd_set_format <1>:                    Formats.            (line   69)
14629* bfd_set_gp_size:                       Miscellaneous.      (line  100)
14630* bfd_set_gp_size <1>:                   Miscellaneous.      (line  104)
14631* bfd_set_gp_value:                      Miscellaneous.      (line  108)
14632* bfd_set_gp_value <1>:                  Miscellaneous.      (line  112)
14633* bfd_set_input_error:                   Error reporting.    (line   66)
14634* bfd_set_input_error <1>:               Error reporting.    (line   70)
14635* bfd_set_private_flags:                 Miscellaneous.      (line  153)
14636* bfd_set_private_flags <1>:             Miscellaneous.      (line  157)
14637* bfd_set_reloc:                         Miscellaneous.      (line   31)
14638* bfd_set_reloc <1>:                     Miscellaneous.      (line   35)
14639* bfd_set_section_contents:              section prototypes. (line  201)
14640* bfd_set_section_contents <1>:          section prototypes. (line  205)
14641* bfd_set_section_flags:                 section prototypes. (line  137)
14642* bfd_set_section_flags <1>:             section prototypes. (line  141)
14643* bfd_set_section_size:                  section prototypes. (line  188)
14644* bfd_set_section_size <1>:              section prototypes. (line  192)
14645* bfd_set_start_address:                 Miscellaneous.      (line   84)
14646* bfd_set_start_address <1>:             Miscellaneous.      (line   88)
14647* bfd_set_symtab:                        symbol handling functions.
14648                                                             (line   57)
14649* bfd_set_symtab <1>:                    symbol handling functions.
14650                                                             (line   61)
14651* bfd_sprintf_vma:                       Miscellaneous.      (line  287)
14652* bfd_sprintf_vma <1>:                   Miscellaneous.      (line  291)
14653* bfd_stat:                              Miscellaneous.      (line  394)
14654* bfd_stat <1>:                          Miscellaneous.      (line  398)
14655* bfd_strtab_hash:                       Write Other Derived Routines.
14656                                                             (line  110)
14657* bfd_strtab_hash <1>:                   Write Other Derived Routines.
14658                                                             (line  116)
14659* bfd_symbol_info:                       symbol handling functions.
14660                                                             (line  119)
14661* bfd_symbol_info <1>:                   symbol handling functions.
14662                                                             (line  123)
14663* bfd_target:                            bfd_target.         (line  566)
14664* bfd_target <1>:                        bfd_target.         (line  581)
14665* bfd_target <2>:                        bfd_target.         (line  611)
14666* bfd_target_list:                       bfd_target.         (line  600)
14667* bfd_tell:                              Miscellaneous.      (line  382)
14668* bfd_tell <1>:                          Miscellaneous.      (line  386)
14669* bfd_thread_cleanup:                    Threading.          (line   28)
14670* bfd_thread_cleanup <1>:                Threading.          (line   32)
14671* bfd_thread_init:                       Threading.          (line   15)
14672* bfd_thread_init <1>:                   Threading.          (line   20)
14673* bfd_unlock:                            Threading.          (line   44)
14674* bfd_unlock <1>:                        Threading.          (line   48)
14675* bfd_write:                             Miscellaneous.      (line  374)
14676* bfd_write <1>:                         Miscellaneous.      (line  378)
14677* bfd_write_bigendian_4byte_int:         Internal.           (line   91)
14678* bfd_write_bigendian_4byte_int <1>:     Internal.           (line   95)
14679* bfd_zalloc:                            Internal.           (line   77)
14680* bfd_zmalloc:                           Internal.           (line   58)
14681* Byte swapping routines.:               Internal.           (line  256)
14682* char:                                  Error reporting.    (line   79)
14683* char <1>:                              Error reporting.    (line  163)
14684* char <2>:                              section prototypes. (line  273)
14685* char <3>:                              Formats.            (line   78)
14686* char <4>:                              howto manager.      (line 3654)
14687* char <5>:                              Core Files.         (line   14)
14688* char <6>:                              bfd_target.         (line  604)
14689* char <7>:                              bfd_target.         (line  621)
14690* char <8>:                              Architectures.      (line  598)
14691* char <9>:                              Architectures.      (line  614)
14692* char <10>:                             Architectures.      (line  715)
14693* char <11>:                             Opening and Closing.
14694                                                             (line  382)
14695* coff_symbol_type:                      coff.               (line  234)
14696* core_file_matches_executable_p:        Core Files.         (line   31)
14697* core_file_matches_executable_p <1>:    Core Files.         (line   35)
14698* generic_core_file_matches_executable_p: Core Files.        (line   40)
14699* generic_core_file_matches_executable_p <1>: Core Files.    (line   44)
14700* Hash tables:                           Hash Tables.        (line    6)
14701* int:                                   Initialization.     (line    6)
14702* int <1>:                               Miscellaneous.      (line   96)
14703* int <2>:                               Architectures.      (line  671)
14704* int <3>:                               Architectures.      (line  678)
14705* int <4>:                               Architectures.      (line  725)
14706* int <5>:                               Architectures.      (line  734)
14707* int <6>:                               Internal.           (line  284)
14708* int <7>:                               Write Other Derived Routines.
14709                                                             (line  104)
14710* internal object-file format:           Canonical format.   (line   11)
14711* Linker:                                Linker Functions.   (line    6)
14712* long:                                  Architectures.      (line  665)
14713* machine_type:                          aout.               (line  134)
14714* Other functions:                       Miscellaneous.      (line  165)
14715* per_xvec_message:                      bfd_target.         (line  544)
14716* struct bfd_iovec:                      Miscellaneous.      (line  327)
14717* target vector (_bfd_final_link):       Performing the Final Link.
14718                                                             (line    6)
14719* target vector (_bfd_link_add_symbols): Adding Symbols to the Hash Table.
14720                                                             (line    6)
14721* target vector (_bfd_link_hash_table_create): Creating a Linker Hash Table.
14722                                                             (line    6)
14723* The HOWTO Macro:                       typedef arelent.    (line  254)
14724* what is it?:                           Overview.           (line    6)
14725
14726
14727
14728Tag Table:
14729Node: Top1068
14730Node: Overview1404
14731Node: History2466
14732Node: How It Works3433
14733Node: What BFD Version 2 Can Do5010
14734Node: BFD information loss6333
14735Node: Canonical format8902
14736Node: BFD front end13262
14737Node: typedef bfd13700
14738Node: Error reporting27112
14739Node: Initialization33657
14740Node: Threading34192
14741Node: Miscellaneous36087
14742Node: Memory Usage55610
14743Node: Sections56855
14744Node: Section Input57340
14745Node: Section Output58573
14746Node: typedef asection61100
14747Node: section prototypes78381
14748Node: Symbols89956
14749Node: Reading Symbols91577
14750Node: Writing Symbols92685
14751Node: Mini Symbols94453
14752Node: typedef asymbol95455
14753Node: symbol handling functions101665
14754Node: Archives106977
14755Node: Formats111197
14756Node: Relocations114344
14757Node: typedef arelent115079
14758Node: howto manager129082
14759Node: Core Files269641
14760Node: Targets271674
14761Node: bfd_target273721
14762Node: Architectures300600
14763Node: Opening and Closing333184
14764Node: Internal349207
14765Node: File Caching360651
14766Node: Linker Functions362894
14767Node: Creating a Linker Hash Table364592
14768Node: Adding Symbols to the Hash Table366355
14769Node: Differing file formats367263
14770Node: Adding symbols from an object file369024
14771Node: Adding symbols from an archive371258
14772Node: Performing the Final Link373670
14773Node: Information provided by the linker374927
14774Node: Relocating the section contents376117
14775Node: Writing the symbol table377937
14776Node: Hash Tables385180
14777Node: Creating and Freeing a Hash Table386382
14778Node: Looking Up or Entering a String387684
14779Node: Traversing a Hash Table388985
14780Node: Deriving a New Hash Table Type389806
14781Node: Define the Derived Structures390880
14782Node: Write the Derived Creation Routine392001
14783Node: Write Other Derived Routines394652
14784Node: BFD back ends400181
14785Node: What to Put Where400451
14786Node: aout400631
14787Node: coff406856
14788Node: elf428365
14789Node: mmo428768
14790Node: File layout429648
14791Node: Symbol-table435773
14792Node: mmo section mapping439592
14793Node: GNU Free Documentation License443290
14794Node: BFD Index468557
14795
14796End Tag Table
14797
14798
14799Local Variables:
14800coding: utf-8
14801End:
14802